gnu.x11.Colormap Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of escher Show documentation
Show all versions of escher Show documentation
Escher is a collection of libraries for X Window System written purely in Java.
The newest version!
package gnu.x11;
/** X colormap. */
public class Colormap extends Resource {
/**
* Predefined colormap.
*
* @see Window#NONE
*/
public static final Colormap COPY_FROM_PARENT = new Colormap (0);
/** Predefined. */
public Colormap (int id) {
super (id);
}
/** Create. */
public Colormap (Display display) {
super (display);
}
/** Intern. */
public Colormap (Display display, int id) {
super (display, id);
}
public static final int NONE = 0;
public static final int ALL = 1;
// opcode 78 - create colormap
/**
* Creates a colormap of the specified visual type for the screen on which
* the window resides. The visual type must be supported by the screen
* (or a Match error results). The initial values of the colormap entries
* are undefined for classes GrayScale, PseudoColor and DirectColor. For
* StaticGray, StaticColor and TrueColor alloc must be specified
* as NONE (or a Match error results). For the other classes,
* if alloc is NONE the colormap initially has no allocated
* entries, and clients can allocate entries. If alloc is ALL,
* then the entire colormap is allocated writable. The initial values of all
* allocated entries are undefined. For GrayScale and PseudoColor, the effect
* is as if an AllocColorCells request returned all pixel values from zero to
* N − 1, where N is the colormap-entries value in the specified visual.
* For DirectColor, the effect is as if an AllocColorPlanes request returned
* a pixel value of zero and red-mask, green-mask, and blue-mask values
* containing the same bits as the corresponding masks in the specified
* visual. However, in all cases, none of these entries can be freed with
* FreeColors.
*
* @param window the window for which the colormap is allocated
* @param visual the visual type
* @param alloc one of {@link #NONE}, {@link #ALL}, see above for explanation
*
* @see XCreateColormap
*/
public Colormap (Window window, int visual_id, int alloc) {
super (window.display);
RequestOutputStream o = display.out;
synchronized (o) {
o.begin_request (78, alloc, 4);
o.write_int32 (id);
o.write_int32 (window.id);
o.write_int32 (visual_id);
o.send ();
}
}
// opcode 79 - free colormap
/**
* @see XFreeColormap
*/
public void free () {
RequestOutputStream o = display.out;
synchronized (o) {
o.begin_request (78, 0, 2);
o.write_int32 (id);
o.send ();
}
}
// opcode 80 - copy colormap and free
public Colormap copy_and_free (int new_id) {
Colormap new_map = new Colormap (display, new_id);
RequestOutputStream o = display.out;
synchronized (o) {
o.begin_request (80, 0, 3);
o.write_int32 (new_id);
o.write_int32 (id);
o.send ();
}
return new_map;
}
// opcode 81 - install colormap
/**
* @see XInstallColormap
*/
public void install () {
RequestOutputStream o = display.out;
synchronized (o) {
o.begin_request (81, 0, 3);
o.write_int32 (id);
o.send ();
}
}
// opcode 82 - uninstall colormap
/**
* @see XUninstallColormap
*/
public void uninstall () {
RequestOutputStream o = display.out;
synchronized (o) {
o.begin_request (82, 0, 3);
o.write_int32 (id);
o.send ();
}
}
public static Object intern (Display display, int id) {
Object value = display.resources.get (new Integer (id));
if (value != null) return value;
return new Colormap (display, id);
}
// opcode 84 - alloc color
/**
* Allocates a read-only colormap entry corresponding to the closest RGB
* values provided by the hardware. It also returns the pixel and RGB values
* actually used. Multiple clients requesting the same effective RGB values
* can be assigned the same read-only entry, allowing entries to be shared.
*
* The return value carries the pixel value as {@link Color#pixel} and
* the RGB value as {@link Color#exact}.
*
* @param red the red component
* @param green the green component
* @param blue the blue component
*
* @return the closest pixel and RGB value of the requested entry
*
* @see XAllocColor
*/
public Color alloc_color (int red, int green, int blue) {
RequestOutputStream o = display.out;
Color c;
synchronized (o) {
o.begin_request (84, 0, 4);
o.write_int32 (id);
o.write_int16 (red);
o.write_int16 (green);
o.write_int16 (blue);
o.skip (2);
ResponseInputStream i = display.in;
synchronized (i) {
i.read_reply (o);
i.skip (8);
int r = i.read_int16 ();
int g = i.read_int16 ();
int b = i.read_int16 ();
i.skip (2);
int p = i.read_int32 ();
i.skip (12);
c = new Color(p);
c.exact = new RGB (r, g, b);
}
}
return c;
}
// opcode 85 - alloc named color
/**
* Looks up the named color with respect to the screen associated with the
* colormap. Then it does an AllocColor on the colormap. The name should
* use ISO Latin-1 encoding, and uppercase and lowercase do not matter. The
* exact RGB values specify the true values for the color, and the
* visual values specify the values actually used in the colormap.
*
* @param name the name of the color
*
* @return the allocated color
*
* @see XAllocNamedColor
*/
public Color alloc_named_color (String name) {
RequestOutputStream o = display.out;
int n = name.length ();
int p = RequestOutputStream.pad (n);
Color c;
synchronized (o) {
o.begin_request (85, 0, 3 + (n + p) / 4);
o.write_int32 (id);
o.write_int16 (n);
o.skip (2);
o.write_string8 (name);
o.skip (p);
ResponseInputStream i = display.in;
synchronized (i) {
i.read_reply (o);
i.skip (8);
int pixel = i.read_int32 ();
int er = i.read_int16 ();
int eg = i.read_int16 ();
int eb = i.read_int16 ();
int vr = i.read_int16 ();
int vg = i.read_int16 ();
int vb = i.read_int16 ();
i.skip (8);
c = new Color (pixel);
c.exact = new RGB (er, eg, eb);
c.visual = new RGB (vr, vg, vb);
}
}
return c;
}
/**
* Reply of {@link #alloc_color_cells(boolean, int, int)}.
*/
// FIXME: Improve API somehow here.
public static class ColorCellsReply {
public int [] pixels;
public int [] masks;
ColorCellsReply (int [] p, int [] m) {
pixels = p;
masks = m;
}
}
// opcode 86 - alloc color cells
/**
* @see XAllocColorCells
*/
public ColorCellsReply alloc_color_cells (boolean contiguous,
int color_count, int plane_count) {
RequestOutputStream o = display.out;
ColorCellsReply r;
synchronized (o) {
o.begin_request (86, contiguous ? 1 : 0, 3);
o.write_int32 (id);
o.write_int16 (color_count);
o.write_int16 (plane_count);
ResponseInputStream i = display.in;
synchronized (i) {
i.read_reply (o);
i.skip (8);
int n = i.read_int16 ();
int m = i.read_int16 ();
i.skip (20);
int [] pixels = new int [n];
for (int j = 0; j < n; j++)
pixels [j] = i.read_int32 ();
int [] masks = new int [m];
for (int j = 0; j < m; j++)
masks [j] = i.read_int32 ();
r = new ColorCellsReply (pixels, masks);
}
}
return r;
}
/**
* Reply for {@link Colormap#alloc_planes(boolean, int, int, int, int)}.
*/
public class ColorPlaneReply {
public int red_mask;
public int green_mask;
public int blue_mask;
public int [] pixels;
ColorPlaneReply (int rm, int gm, int bm, int [] px) {
red_mask = rm;
green_mask = rm;
blue_mask = bm;
pixels = px;
}
}
// opcode 87 - alloc color planes
/**
* @see XAllocColorPlanes
*/
public ColorPlaneReply alloc_planes (boolean contiguous, int color_count,
int red_count, int green_count,
int blue_count) {
RequestOutputStream o = display.out;
ColorPlaneReply r;
synchronized (o) {
o.begin_request (87, contiguous ? 1 : 0, 4);
o.write_int32 (id);
o.write_int16 (color_count);
o.write_int16 (red_count);
o.write_int16 (green_count);
o.write_int16 (blue_count);
ResponseInputStream i = display.in;
synchronized (i) {
i.read_reply (o);
i.skip (8);
int n = i.read_int16 ();
i.skip (2);
int rm = i.read_int32 ();
int gm = i.read_int32 ();
int bm = i.read_int32 ();
i.skip (8);
int [] px = new int [n];
for (int j = 0; j < n; j++)
px [j] = i.read_int32 ();
r = new ColorPlaneReply (rm, gm, bm, px);
}
}
return r;
}
// opcode 88 - free colors
/**
* @see XFreeColors
*/
public void free_colors (int [] pixels, int plane_mask) {
int n = pixels.length;
RequestOutputStream o = display.out;
synchronized (o) {
o.begin_request (88, 0, 3 + n);
o.write_int32 (id);
o.write_int32 (plane_mask);
for (int i = 0; i < pixels.length; i++)
o.write_int32 (pixels [i]);
o.send ();
}
}
/**
* Used in {@link Colormap#store_colors()}.
*/
public static class ColorItem {
public int pixel;
public int red;
public int green;
public int blue;
public boolean do_red;
public boolean do_green;
public boolean do_blue;
public ColorItem (int pixel, int red, int green, int blue,
boolean do_red, boolean do_green, boolean do_blue) {
this.pixel = pixel;
this.red = red;
this.green = green;
this.blue = blue;
this.do_red = do_red;
this.do_green = do_green;
this.do_blue = do_blue;
}
void write (RequestOutputStream o) {
o.write_int32 (pixel);
o.write_int16 (red);
o.write_int16 (green);
o.write_int16 (blue);
int do_colors = ( do_red ? 0x01 : 0 )
| ( do_green ? 0x02 : 0)
| (do_blue ? 0x04 : 0);
o.write_int8 (do_colors);
o.skip (1);
}
}
// opcode 89 - store colors
/**
* @see XStoreColors
*/
public void store_colors (ColorItem[] items) {
int n = items.length;
RequestOutputStream o = display.out;
synchronized (o) {
o.begin_request (89, 0, 3 + 2 * n);
o.write_int32 (id);
for (int i = 0; i < n; i++)
items [i].write (o);
o.send ();
}
}
// opcode 90 - store named color
/**
* @see XStoreNamedColor
*/
public void store_named_color (int pixel, String name, boolean do_reds,
boolean do_greens, boolean do_blues) {
int do_color = 0;
if (do_reds) do_color |= 0x01;
if (do_greens) do_color |= 0x02;
if (do_blues) do_color |= 0x04;
int n = name.length ();
int p = RequestOutputStream.pad (n);
RequestOutputStream o = display.out;
synchronized (o) {
o.begin_request (90, do_color, 4 + (n + p) / 4);
o.write_int32 (id);
o.write_int32 (pixel);
o.write_int16 (n);
o.skip (2);
o.write_string8 (name);
o.skip (p);
o.send ();
}
}
// opcode 91 - query colors
/**
* Returns the hardware specific color values stored in this colormap
* for the specified pixels. The values returned for an unallocated entry
* are undefined.
*
* @param pixels the pixels for which to return the color values
*
* @return the hardware specific color values of this colormap
*
* @see XQueryColors
*/
public RGB [] colors (int [] pixels) {
RequestOutputStream o = display.out;
int n = pixels.length;
RGB [] rgbs;
synchronized (o) {
o.begin_request (91, 0, 2 + n);
o.write_int32 (id);
for (int j = 0; j < n; j++)
o.write_int32 (pixels [j]);
ResponseInputStream i = display.in;
synchronized (i) {
i.read_reply (o);
i.skip (8);
int len = i.read_int16 ();
rgbs = new RGB [len];
i.skip (22);
for (int j = 0; j < len; j++) {
int r = i.read_int16 ();
int g = i.read_int16 ();
int b = i.read_int16 ();
i.skip (2);
rgbs [j] = new RGB (r, g, b);
}
}
}
return rgbs;
}
// opcode 92 - lookup color
/**
* Looks up the name of a color with respect to the screen associated with
* this colormap, and returns both the exact color values and the closest
* values provided by the hardware with respect to the visual type of this
* colormap. The name should use the ISO Latin-1 encoding, and uppercase and
* lowercase do not matter.
*
* @param name the color name to lookup
*
* @return the color
*
* @see XLookupColor
*/
public Color lookup_color (String name) {
int n = name.length ();
int p = RequestOutputStream.pad (n);
RequestOutputStream o = display.out;
Color c;
synchronized (o) {
o.begin_request (92, 0, 3 + (n + p) / 4);
o.write_int32 (id);
o.write_int16 (n);
o.skip (2);
o.write_string8 (name);
o.skip (p);
ResponseInputStream i = display.in;
synchronized (i) {
i.read_reply (o);
i.skip (8);
int er = i.read_int16 ();
int eg = i.read_int16 ();
int eb = i.read_int16 ();
int vr = i.read_int16 ();
int vg = i.read_int16 ();
int vb = i.read_int16 ();
i.skip (12);
c = new Color (0);
c.exact = new RGB (er, eg, eb);
c.visual = new RGB (vr, vg, vb);
}
}
return c;
}
/**
* @see #alloc_color(int, int, int)
*/
public Color alloc_color (RGB rgb) {
return alloc_color (rgb.red, rgb.green, rgb.blue);
}
/**
* @see #alloc_color(RGB)
*/
public Color alloc_color8 (int red8, int green8, int blue8) {
return alloc_color (RGB.rgb8 (red8, green8, blue8));
}
/**
* @see #alloc_color(int, int, int)
*/
public Color alloc_random_color (java.util.Random random) {
return alloc_color (random.nextInt () & 0xffff,
random.nextInt () & 0xffff,
random.nextInt () & 0xffff);
}
/**
* @see #alloc_color(int, int, int)
*/
public Color alloc_random_rainbow_color (java.util.Random random) {
int hue = random.nextInt (360);
return alloc_color (RGB.hsv (hue, 1, 1));
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy