/* Copyright (C) 2000 Free Software Foundation This file is part of libgcj. This software is copyrighted work licensed under the terms of the Libgcj License. Please consult the file "LIBGCJ_LICENSE" for details. */ package gnu.gcj.xlib; import gnu.gcj.RawData; /** * A visual determines how a color is encoded into a pixel/bitfield * value. It does not determine how the pixel/bitfield value is * encoded into the image data. * * This class encapsulates all three Xlib representations of a * visual. * * * * int: visual id. * * Visual: opaque data structure used by a lot of Xlib functions. * * VisualInfo: transparent data structure that binds the visual to * a certain screen and depth. * * * * Implementation note: This class does not examine nor manipulate * the Visual structure, since the X manual says the structure is * opaque, and that XVisualInfo should be used instead. * * @author Rolf W. Rasmussen */ public final class Visual { public static final int VC_STATIC_GRAY = 0, VC_GRAY_SCALE = 1, VC_STATIC_COLOR = 2, VC_PSEUDO_COLOR = 3, VC_TRUE_COLOR = 4, VC_DIRECT_COLOR = 5; protected static final int MASK_ID = 1 MASK_SCREEN = 1 MASK_DEPTH = 1 MASK_CLASS = 1 MASK_RED = 1 MASK_GREEN = 1 MASK_BLUE = 1 MASK_COLORMAP_SIZE = 1 MASK_BITS_PER_RGB = 1 protected static final int MASK_ALL = MASK_ID | MASK_SCREEN | MASK_DEPTH | MASK_CLASS | MASK_RED | MASK_GREEN | MASK_BLUE | MASK_COLORMAP_SIZE | MASK_BITS_PER_RGB; private static final int MASK_VISUAL_STRUCTURE = 1 Display display; RawData xVisualInfo; int infoMask; Screen screen; Visual(RawData structure, Screen screen, int depth ) { this.display = screen.getDisplay(); this.screen = screen; init(structure, depth); } Visual(Display display, RawData structure, int depth ) { this.display = display; init(structure, depth); } protected native void init(RawData structure, int depth); protected native void finalize(); /** * * Returns the a reference to the visual structure. This method has * package accessibility since the data visual structure is only * useful for direct Xlib calls. * * @return a pointer to the visual structure. */ native RawData getVisualStructure(); // These methods only make sense if the visual is decomposed: public native int getRedMask(); public native int getGreenMask(); public native int getBlueMask(); public native int getScreenNumber(); public native int getDepth(); public Screen getScreen() { if (screen == null) screen = new Screen(display, getScreenNumber()); return screen; } public native int getVisualClass(); public boolean hasRGBSubfields() { switch (getVisualClass()) { case VC_TRUE_COLOR: case VC_DIRECT_COLOR: return true; default: return false; } } protected native void ensureXVisualInfo(int requiredMask); public String toString() { int missingInfo = ~infoMask; boolean hasSubfieldInfo = (missingInfo & (MASK_CLASS|MASK_RED|MASK_GREEN|MASK_BLUE)) == 0; boolean hasDepth = (missingInfo & MASK_DEPTH) == 0; return getClass().getName() + "[" + (hasDepth ? "depth=" + getDepth() : "") + (hasRGBSubfields() ? (", redMask=" + Integer.toHexString(getRedMask()) + ", greenMask=" + Integer.toHexString(getGreenMask()) + ", blueMask=" + Integer.toHexString(getBlueMask())) : ", no-subfields") + ", class=" + getVisualClass() + "]"; } }
