org.gnu.gdk

Class GC


public class GC
extends GObject

All drawing operations in GDK take a GC argument. A graphics context encapsulates information about the way things are drawn, such as the foreground color or line width. By using graphics context, the number of arguments to each drawing call is reduced, and communication overhead is minimized.

Field Summary

Fields inherited from class org.gnu.glib.GObject

eventsInitialized

Constructor Summary

GC(Window window)
GC(Handle handle)

Method Summary

void
copy(GC source)
Copy the set of values (settings) from another graphics context.
protected static void
gdk_gc_copy(Handle dstGC, Handle srcGC)
protected static Handle
gdk_gc_get_colormap(Handle gc)
protected static Handle
gdk_gc_get_screen(Handle gc)
protected static int
gdk_gc_get_type()
protected static Handle
gdk_gc_new(Handle drawable)
protected static void
gdk_gc_offset(Handle gc, int xOffset, int yOffset)
protected static void
gdk_gc_set_background(Handle gc, Handle color)
protected static void
gdk_gc_set_clip_mask(Handle gc, Handle mask)
protected static void
gdk_gc_set_clip_origin(Handle gc, int x, int y)
protected static void
gdk_gc_set_clip_rectangle(Handle gc, Handle rectangle)
protected static void
gdk_gc_set_clip_region(Handle gc, Handle region)
protected static void
gdk_gc_set_colormap(Handle gc, Handle colormap)
protected static void
gdk_gc_set_dashes(Handle gc, int dashOffset, int[] dashList, int n)
protected static void
gdk_gc_set_exposures(Handle gc, boolean exposures)
protected static void
gdk_gc_set_fill(Handle gc, int fill)
protected static void
gdk_gc_set_foreground(Handle gc, Handle color)
protected static void
gdk_gc_set_function(Handle gc, int function)
protected static void
gdk_gc_set_line_attributes(Handle gc, int lineWidth, int lineStyle, int capStyle, int joinStyle)
protected static void
gdk_gc_set_rgb_bg_color(Handle gc, Handle color)
protected static void
gdk_gc_set_rgb_fg_color(Handle gc, Handle color)
protected static void
gdk_gc_set_stipple(Handle gc, Handle stipple)
protected static void
gdk_gc_set_subwindow(Handle gc, int mode)
protected static void
gdk_gc_set_tile(Handle gc, Handle tile)
protected static void
gdk_gc_set_ts_origin(Handle gc, int x, int y)
int
getClipXOrigin()
Getst he x origin of the clip mask.
protected static int
getClipXOrigin(Handle obj)
int
getClipYOrigin()
Gets the y origin of the clip mask.
protected static int
getClipYOrigin(Handle obj)
Colormap
getColormap()
Gets the colormap, if it exists.
static GC
getDefaultGC(Drawable d)
Screen
getScreen()
int
getTsXOrigin()
Gets the x origin of the tile or stipple.
protected static int
getTsXOrigin(Handle obj)
int
getTsYOrigin()
Gets the y origin of the tile or stipple.
protected static int
getTsYOrigin(Handle obj)
void
offset(int xOffset, int yOffset)
Offset attributes such as the clip and tile-stipple origins of the GC so that drawing at X - x_offset, y - y_offset with the offset GC has the same effect as drawing at x, y with the original GC.
void
setBackground(Color color)
Sets the background color for the graphics context.
void
setClipMask(Bitmap mask)
Sets the clip mask for a graphics context from a bitmap.
void
setClipOrigin(int x, int y)
Sets the origin of the clip mask.
void
setClipRectangle(Rectangle rect)
Sets the clip mask for a graphics context from a rectangle.
void
setClipRegion(Region reg)
Sets the clip mask for a graphics context from a region.
void
setColormap(Colormap colormap)
Sets the colormap to the given colormap.
void
setDashes(int dashOffset, int[] dashList)
Sets the way dashed-lines are drawn.
void
setExposures(boolean exposures)
Sets whether copying non-visible portions of a drawable using this graphics context generate exposure events for the corresponding regions of the destination drawable.
void
setFillMode(Fill mode)
Sets the fill mode for the graphic context.
void
setForeground(Color color)
Sets the foreground color for the graphics context.
void
setFunction(Function func)
Determines how the current pixel values and the pixel values being drawn are combined to produce the final pixel values.
void
setLineAttributes(int lineWidth, LineStyle lineStyle, CapStyle capStyle, JoinStyle joinStyle)
Sets various attributes of how lines are drawn.
void
setOrigin(int x, int y)
Sets the origin when using tiles or stipples with the GC.
void
setRGBBackground(Color color)
Sets the background color using an unallocated color.
void
setRGBForeground(Color color)
Sets the foreground color using an unallocated color.
void
setStipple(Pixmap stipple)
Sets the stipple bitmap for a graphics context.
void
setSubwindow(SubwindowMode mode)
Sets how drawing with this GC on a window will affect child windows.
void
setTile(Pixmap tile)
Sets the tile pixmap for the graphics context.

Methods inherited from class org.gnu.glib.GObject

addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addEventHandler, addListener, equals, freezeNotify, getBooleanProperty, getData, getData, getDoubleProperty, getEventListenerClass, getEventType, getFloatProperty, getGObjectFromHandle, getHandle, getIntFromHandle, getIntProperty, getJavaObjectProperty, getLongProperty, getNullHandle, getPixbufProperty, getProperty, getStringFromHandle, getStringProperty, hasProperty, hashCode, instantiateJGObjectFromGType, notify, removeEventHandler, removeListener, retrieveGObject, setBooleanProperty, setData, setData, setDoubleProperty, setFloatProperty, setHandle, setIntProperty, setJavaObjectProperty, setLongProperty, setPixbufProperty, setProperty, setStringProperty, thawNotify

Constructor Details

GC

public GC(Window window)


GC

public GC(Handle handle)

Method Details

copy

public void copy(GC source)
Copy the set of values (settings) from another graphics context.

Parameters:
source - the source graphics context.


gdk_gc_copy

protected static final void gdk_gc_copy(Handle dstGC,
                                        Handle srcGC)


gdk_gc_get_colormap

protected static final Handle gdk_gc_get_colormap(Handle gc)


gdk_gc_get_screen

protected static final Handle gdk_gc_get_screen(Handle gc)


gdk_gc_get_type

protected static final int gdk_gc_get_type()


gdk_gc_new

protected static final Handle gdk_gc_new(Handle drawable)


gdk_gc_offset

protected static final void gdk_gc_offset(Handle gc,
                                          int xOffset,
                                          int yOffset)


gdk_gc_set_background

protected static final void gdk_gc_set_background(Handle gc,
                                                  Handle color)


gdk_gc_set_clip_mask

protected static final void gdk_gc_set_clip_mask(Handle gc,
                                                 Handle mask)


gdk_gc_set_clip_origin

protected static final void gdk_gc_set_clip_origin(Handle gc,
                                                   int x,
                                                   int y)


gdk_gc_set_clip_rectangle

protected static final void gdk_gc_set_clip_rectangle(Handle gc,
                                                      Handle rectangle)


gdk_gc_set_clip_region

protected static final void gdk_gc_set_clip_region(Handle gc,
                                                   Handle region)


gdk_gc_set_colormap

protected static final void gdk_gc_set_colormap(Handle gc,
                                                Handle colormap)


gdk_gc_set_dashes

protected static final void gdk_gc_set_dashes(Handle gc,
                                              int dashOffset,
                                              int[] dashList,
                                              int n)


gdk_gc_set_exposures

protected static final void gdk_gc_set_exposures(Handle gc,
                                                 boolean exposures)


gdk_gc_set_fill

protected static final void gdk_gc_set_fill(Handle gc,
                                            int fill)


gdk_gc_set_foreground

protected static final void gdk_gc_set_foreground(Handle gc,
                                                  Handle color)


gdk_gc_set_function

protected static final void gdk_gc_set_function(Handle gc,
                                                int function)


gdk_gc_set_line_attributes

protected static final void gdk_gc_set_line_attributes(Handle gc,
                                                       int lineWidth,
                                                       int lineStyle,
                                                       int capStyle,
                                                       int joinStyle)


gdk_gc_set_rgb_bg_color

protected static final void gdk_gc_set_rgb_bg_color(Handle gc,
                                                    Handle color)


gdk_gc_set_rgb_fg_color

protected static final void gdk_gc_set_rgb_fg_color(Handle gc,
                                                    Handle color)


gdk_gc_set_stipple

protected static final void gdk_gc_set_stipple(Handle gc,
                                               Handle stipple)


gdk_gc_set_subwindow

protected static final void gdk_gc_set_subwindow(Handle gc,
                                                 int mode)


gdk_gc_set_tile

protected static final void gdk_gc_set_tile(Handle gc,
                                            Handle tile)


gdk_gc_set_ts_origin

protected static final void gdk_gc_set_ts_origin(Handle gc,
                                                 int x,
                                                 int y)


getClipXOrigin

public int getClipXOrigin()
Getst he x origin of the clip mask.


getClipXOrigin

protected static final int getClipXOrigin(Handle obj)


getClipYOrigin

public int getClipYOrigin()
Gets the y origin of the clip mask.


getClipYOrigin

protected static final int getClipYOrigin(Handle obj)


getColormap

public Colormap getColormap()
Gets the colormap, if it exists. A GC will have a colormap if the drawable for which it was created has a colormap, or if a colormap was set explicitely with setColormap().


getDefaultGC

public static GC getDefaultGC(Drawable d)


getScreen

public Screen getScreen()


getTsXOrigin

public int getTsXOrigin()
Gets the x origin of the tile or stipple.


getTsXOrigin

protected static final int getTsXOrigin(Handle obj)


getTsYOrigin

public int getTsYOrigin()
Gets the y origin of the tile or stipple.


getTsYOrigin

protected static final int getTsYOrigin(Handle obj)


offset

public void offset(int xOffset,
                   int yOffset)
Offset attributes such as the clip and tile-stipple origins of the GC so that drawing at X - x_offset, y - y_offset with the offset GC has the same effect as drawing at x, y with the original GC.

Parameters:
xOffset - amount by which to offset the GC in the X direction
yOffset - amount by which to offset the GC in the Y direction


setBackground

public void setBackground(Color color)
Sets the background color for the graphics context.


setClipMask

public void setClipMask(Bitmap mask)
Sets the clip mask for a graphics context from a bitmap.


setClipOrigin

public void setClipOrigin(int x,
                          int y)
Sets the origin of the clip mask. The coordinates are interpreted relative to the upper-left cornor of the destination drawable of the current operation.


setClipRectangle

public void setClipRectangle(Rectangle rect)
Sets the clip mask for a graphics context from a rectangle.


setClipRegion

public void setClipRegion(Region reg)
Sets the clip mask for a graphics context from a region.


setColormap

public void setColormap(Colormap colormap)
Sets the colormap to the given colormap. The depth of the colormap's visual must match the depth of the drawable for which the GC was created.


setDashes

public void setDashes(int dashOffset,
                      int[] dashList)
Sets the way dashed-lines are drawn. Lines will be drawn with alternating on and off segments of the lengths specified in dash_list. The manner in which the on and off segments are drawn is determined by the line style.

Parameters:
dashOffset - the phase of the pattern for the dashed line-style you want to see
dashList - the dash-list for the dashed line-style you want to set.

See Also:
setLineAttributes(int,LineStyle,CapStyle,JoinStyle)


setExposures

public void setExposures(boolean exposures)
Sets whether copying non-visible portions of a drawable using this graphics context generate exposure events for the corresponding regions of the destination drawable.

See Also:
Drawable.drawDrawable


setFillMode

public void setFillMode(Fill mode)
Sets the fill mode for the graphic context.


setForeground

public void setForeground(Color color)
Sets the foreground color for the graphics context.


setFunction

public void setFunction(Function func)
Determines how the current pixel values and the pixel values being drawn are combined to produce the final pixel values.


setLineAttributes

public void setLineAttributes(int lineWidth,
                              LineStyle lineStyle,
                              CapStyle capStyle,
                              JoinStyle joinStyle)
Sets various attributes of how lines are drawn. See the corresponding members of GdkGCValues for full explanations of the arguments.

Parameters:
lineWidth - the width of lines.
lineStyle - the dash-style for lines.
capStyle - the manner in which the ends of lines are drawn.
joinStyle - the manner in which lines are joined together.


setOrigin

public void setOrigin(int x,
                      int y)
Sets the origin when using tiles or stipples with the GC. The tile or stipple will be aligned such that the upper left cornor of the tile or stipple will coincide with this point.


setRGBBackground

public void setRGBBackground(Color color)
Sets the background color using an unallocated color. The pixel value for the color will be determined using GdkRGB. If the colormap has not previously been initialized for GdkRGB, then for pseudo-color colormaps (colormaps with a small modifiable number of colors), a colorcube will be allocated in the colormap.

Calling this function for a GC without a colormap is an error.


setRGBForeground

public void setRGBForeground(Color color)
Sets the foreground color using an unallocated color. The pixel value for the color will be determined using GdkRGB. If the colormap has not previously been initialized for GdkRGB, then for pseudo-color colormaps (colormaps with a small modifiable number of colors), a colorcube will be allocated in the colormap.

Calling this function for a GC without a colormap is an error.


setStipple

public void setStipple(Pixmap stipple)
Sets the stipple bitmap for a graphics context. The stipple will only be used if the fill mode is STIPPLED or OPAQUE_STIPPLED.


setSubwindow

public void setSubwindow(SubwindowMode mode)
Sets how drawing with this GC on a window will affect child windows.


setTile

public void setTile(Pixmap tile)
Sets the tile pixmap for the graphics context. This will only be used if the fill mode is TILED.