All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.eclipse.swt.graphics.GC Maven / Gradle / Ivy

The newest version!
/*******************************************************************************
 * Copyright (c) 2000, 2022 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.swt.graphics;

import java.util.*;

import org.eclipse.swt.*;
import org.eclipse.swt.internal.*;
import org.eclipse.swt.internal.cairo.*;
import org.eclipse.swt.internal.gtk.*;

/**
 * Class GC is where all of the drawing capabilities that are
 * supported by SWT are located. Instances are used to draw on either an
 * Image, a Control, or directly on a Display.
 * 
*
Styles:
*
LEFT_TO_RIGHT, RIGHT_TO_LEFT
*
* *

* The SWT drawing coordinate system is the two-dimensional space with the origin * (0,0) at the top left corner of the drawing area and with (x,y) values increasing * to the right and downward respectively. *

* *

* The result of drawing on an image that was created with an indexed * palette using a color that is not in the palette is platform specific. * Some platforms will match to the nearest color while other will draw * the color itself. This happens because the allocated image might use * a direct palette on platforms that do not support indexed palette. *

* *

* Application code must explicitly invoke the GC.dispose() * method to release the operating system resources managed by each instance * when those instances are no longer required. This is particularly * important on Windows95 and Windows98 where the operating system has a limited * number of device contexts available. *

* *

* Note: Only one of LEFT_TO_RIGHT and RIGHT_TO_LEFT may be specified. *

* * @see org.eclipse.swt.events.PaintEvent * @see GC snippets * @see SWT Examples: GraphicsExample, PaintExample * @see Sample code and further information */ public final class GC extends Resource { /** * the handle to the OS device context * (Warning: This field is platform dependent) *

* IMPORTANT: This field is not part of the SWT * public API. It is marked public only so that it can be shared * within the packages provided by SWT. It is not available on all * platforms and should never be accessed from application code. *

* * @noreference This field is not intended to be referenced by clients. */ public long handle; Drawable drawable; GCData data; /** * The current Cairo matrix, which positions widgets in the shell. * Client transformations come on top of this matrix. */ private double[] cairoTransformationMatrix; /** * Tracks the last transformation with which {@link #setTransform(Transform)} was called, * so that we can answer clients of {@link #getTransform(Transform)}. */ private double[] currentTransform; /** * Original clipping set on this GC */ private Rectangle clipping; final static int FOREGROUND = 1 << 0; final static int BACKGROUND = 1 << 1; final static int FONT = 1 << 2; final static int LINE_STYLE = 1 << 3; final static int LINE_CAP = 1 << 4; final static int LINE_JOIN = 1 << 5; final static int LINE_WIDTH = 1 << 6; final static int LINE_MITERLIMIT = 1 << 7; final static int BACKGROUND_BG = 1 << 8; final static int DRAW_OFFSET = 1 << 9; final static int DRAW = FOREGROUND | LINE_WIDTH | LINE_STYLE | LINE_CAP | LINE_JOIN | LINE_MITERLIMIT | DRAW_OFFSET; final static int FILL = BACKGROUND; static final float[] LINE_DOT = new float[]{1, 1}; static final float[] LINE_DASH = new float[]{3, 1}; static final float[] LINE_DASHDOT = new float[]{3, 1, 1, 1}; static final float[] LINE_DASHDOTDOT = new float[]{3, 1, 1, 1, 1, 1}; static final float[] LINE_DOT_ZERO = new float[]{3, 3}; static final float[] LINE_DASH_ZERO = new float[]{18, 6}; static final float[] LINE_DASHDOT_ZERO = new float[]{9, 6, 3, 6}; static final float[] LINE_DASHDOTDOT_ZERO = new float[]{9, 3, 3, 3, 3, 3}; GC() { } /** * Constructs a new instance of this class which has been * configured to draw on the specified drawable. Sets the * foreground color, background color and font in the GC * to match those in the drawable. *

* You must dispose the graphics context when it is no longer required. *

* @param drawable the drawable to draw on * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the drawable is null
  • *
  • ERROR_NULL_ARGUMENT - if there is no current device
  • *
  • ERROR_INVALID_ARGUMENT * - if the drawable is an image that is not a bitmap or an icon * - if the drawable is an image or printer that is already selected * into another graphics context
  • *
* @exception SWTError
    *
  • ERROR_NO_HANDLES if a handle could not be obtained for GC creation
  • *
  • ERROR_THREAD_INVALID_ACCESS if not called from the thread that created the drawable
  • *
* @see #dispose() */ public GC(Drawable drawable) { this(drawable, 0); } /** * Constructs a new instance of this class which has been * configured to draw on the specified drawable. Sets the * foreground color, background color and font in the GC * to match those in the drawable. *

* You must dispose the graphics context when it is no longer required. *

* * @param drawable the drawable to draw on * @param style the style of GC to construct * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the drawable is null
  • *
  • ERROR_NULL_ARGUMENT - if there is no current device
  • *
  • ERROR_INVALID_ARGUMENT * - if the drawable is an image that is not a bitmap or an icon * - if the drawable is an image or printer that is already selected * into another graphics context
  • *
* @exception SWTError
    *
  • ERROR_NO_HANDLES if a handle could not be obtained for GC creation
  • *
  • ERROR_THREAD_INVALID_ACCESS if not called from the thread that created the drawable
  • *
* * @see #dispose() * * @since 2.1.2 */ public GC(Drawable drawable, int style) { if (drawable == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); GCData data = new GCData(); data.style = checkStyle(style); Device device = data.device; if (device == null) device = Device.getDevice(); if (device == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); this.device = data.device = device; long gdkGC = drawable.internal_new_GC(data); init(drawable, data, gdkGC); init(); } /** * Ensure that the style specified is either LEFT_TO_RIGHT or RIGHT_TO_LEFT. * * @param style the SWT style bit string * @return If only one style is specified, it is return unmodified. If both styles are specified, returns LEFT_TO_RIGHT */ int checkStyle(int style) { if ((style & SWT.LEFT_TO_RIGHT) != 0) style &= ~SWT.RIGHT_TO_LEFT; return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT); } static void addCairoString(long cairo, String string, float x, float y, Font font) { byte[] buffer = Converter.wcsToMbcs(string, true); long layout = OS.pango_cairo_create_layout(cairo); if (layout == 0) SWT.error(SWT.ERROR_NO_HANDLES); OS.pango_layout_set_text(layout, buffer, -1); OS.pango_layout_set_font_description(layout, font.handle); double[] currentX = new double[1], currentY = new double[1]; Cairo.cairo_get_current_point(cairo, currentX, currentY); if (currentX[0] != x || currentY[0] != y) { Cairo.cairo_move_to(cairo, x, y); } OS.pango_cairo_layout_path(cairo, layout); OS.g_object_unref(layout); } /** * Convenience method that applies a region to the Control using cairo_clip. * * @param cairo the cairo context to apply the region to */ void cairoClipRegion (long cairo) { if (cairo == 0) return; GdkRectangle rect = new GdkRectangle (); GDK.gdk_cairo_get_clip_rectangle (cairo, rect); cairo_rectangle_int_t cairoRect = new cairo_rectangle_int_t (); cairoRect.convertFromGdkRectangle(rect); long regionHandle = data.regionSet; long actualRegion = Cairo.cairo_region_create_rectangle(cairoRect); Cairo.cairo_region_subtract(actualRegion, regionHandle); GDK.gdk_cairo_region(cairo, actualRegion); Cairo.cairo_clip(cairo); Cairo.cairo_paint(cairo); } /** * Invokes platform specific functionality to wrap a graphics context. *

* IMPORTANT: This method is not part of the public * API for GC. It is marked public only so that it * can be shared within the packages provided by SWT. It is not * available on all platforms, and should never be called from * application code. *

* * @param handle the handle to the OS device context * @param data the data for the receiver. * * @return a new GC * * @noreference This method is not intended to be referenced by clients. */ public static GC gtk_new(long handle, GCData data) { GC gc = new GC(); gc.device = data.device; gc.init(null, data, handle); return gc; } /** * Invokes platform specific functionality to allocate a new graphics context. *

* IMPORTANT: This method is not part of the public * API for GC. It is marked public only so that it * can be shared within the packages provided by SWT. It is not * available on all platforms, and should never be called from * application code. *

* * @param drawable the Drawable for the receiver. * @param data the data for the receiver. * * @return a new GC * * @noreference This method is not intended to be referenced by clients. */ public static GC gtk_new(Drawable drawable, GCData data) { GC gc = new GC(); long gdkGC = drawable.internal_new_GC(data); gc.device = data.device; gc.init(drawable, data, gdkGC); return gc; } void checkGC (int mask) { int state = data.state; if ((state & mask) == mask) return; state = (state ^ mask) & mask; data.state |= mask; long cairo = data.cairo; if ((state & (BACKGROUND | FOREGROUND)) != 0) { GdkRGBA colorRGBA = null; Pattern pattern; if ((state & FOREGROUND) != 0) { colorRGBA = data.foregroundRGBA; pattern = data.foregroundPattern; data.state &= ~BACKGROUND; } else { colorRGBA = data.backgroundRGBA; pattern = data.backgroundPattern; data.state &= ~FOREGROUND; } if (pattern != null) { if ((data.style & SWT.MIRRORED) != 0 && pattern.surface != 0) { long newPattern = Cairo.cairo_pattern_create_for_surface(pattern.surface); if (newPattern == 0) SWT.error(SWT.ERROR_NO_HANDLES); Cairo.cairo_pattern_set_extend(newPattern, Cairo.CAIRO_EXTEND_REPEAT); double[] matrix = {-1, 0, 0, 1, 0, 0}; Cairo.cairo_pattern_set_matrix(newPattern, matrix); Cairo.cairo_set_source(cairo, newPattern); Cairo.cairo_pattern_destroy(newPattern); } else { Cairo.cairo_set_source(cairo, pattern.handle); } } else { Cairo.cairo_set_source_rgba(cairo, colorRGBA.red, colorRGBA.green, colorRGBA.blue, data.alpha / (float)0xFF); } } if ((state & FONT) != 0) { if (data.layout != 0) { Font font = data.font; OS.pango_layout_set_font_description(data.layout, font.handle); } } if ((state & LINE_CAP) != 0) { int cap_style = 0; switch (data.lineCap) { case SWT.CAP_ROUND: cap_style = Cairo.CAIRO_LINE_CAP_ROUND; break; case SWT.CAP_FLAT: cap_style = Cairo.CAIRO_LINE_CAP_BUTT; break; case SWT.CAP_SQUARE: cap_style = Cairo.CAIRO_LINE_CAP_SQUARE; break; } Cairo.cairo_set_line_cap(cairo, cap_style); } if ((state & LINE_JOIN) != 0) { int join_style = 0; switch (data.lineJoin) { case SWT.JOIN_MITER: join_style = Cairo.CAIRO_LINE_JOIN_MITER; break; case SWT.JOIN_ROUND: join_style = Cairo.CAIRO_LINE_JOIN_ROUND; break; case SWT.JOIN_BEVEL: join_style = Cairo.CAIRO_LINE_JOIN_BEVEL; break; } Cairo.cairo_set_line_join(cairo, join_style); } if ((state & LINE_WIDTH) != 0) { Cairo.cairo_set_line_width(cairo, data.lineWidth == 0 ? DPIUtil.autoScaleUp(drawable, 1) : data.lineWidth); switch (data.lineStyle) { case SWT.LINE_DOT: case SWT.LINE_DASH: case SWT.LINE_DASHDOT: case SWT.LINE_DASHDOTDOT: state |= LINE_STYLE; } } if ((state & LINE_STYLE) != 0) { float dashesOffset = 0; float[] dashes = null; float width = data.lineWidth; switch (data.lineStyle) { case SWT.LINE_SOLID: break; case SWT.LINE_DASH: dashes = width != 0 ? LINE_DASH : LINE_DASH_ZERO; break; case SWT.LINE_DOT: dashes = width != 0 ? LINE_DOT : LINE_DOT_ZERO; break; case SWT.LINE_DASHDOT: dashes = width != 0 ? LINE_DASHDOT : LINE_DASHDOT_ZERO; break; case SWT.LINE_DASHDOTDOT: dashes = width != 0 ? LINE_DASHDOTDOT : LINE_DASHDOTDOT_ZERO; break; case SWT.LINE_CUSTOM: dashes = data.lineDashes; break; } if (dashes != null) { dashesOffset = data.lineDashesOffset; double[] cairoDashes = new double[dashes.length]; for (int i = 0; i < cairoDashes.length; i++) { cairoDashes[i] = width == 0 || data.lineStyle == SWT.LINE_CUSTOM ? dashes[i] : dashes[i] * width; } Cairo.cairo_set_dash(cairo, cairoDashes, cairoDashes.length, dashesOffset); } else { Cairo.cairo_set_dash(cairo, null, 0, 0); } } if ((state & LINE_MITERLIMIT) != 0) { Cairo.cairo_set_miter_limit(cairo, data.lineMiterLimit); } if ((state & DRAW_OFFSET) != 0) { int effectiveLineWidth = data.lineWidth < 1 ? 1 : Math.round(data.lineWidth); if (effectiveLineWidth % 2 == 1) { // In case the effective line width is odd, shift coordinates by (0.5, 0.5). // I.e., a line starting at (0,0) will effectively start in the pixel right // below that coordinate with its center at (0.5, 0.5). double[] offsetX = new double[] { 0.5 }; double[] offsetY = new double[] { 0.5 }; // The offset will be applied to the coordinate system of the GC; so transform // it from the drawing coordinate system to the coordinate system of the GC by // applying the inverse transformation as the one applied to the GC and correct // it by the line width. double[] matrix = new double[6]; Cairo.cairo_get_matrix(cairo, matrix); double[] inverseMatrix = Arrays.copyOf(matrix, 6); Cairo.cairo_matrix_invert(inverseMatrix); Cairo.cairo_set_matrix(cairo, inverseMatrix); Cairo.cairo_user_to_device_distance(cairo, offsetX, offsetY); Cairo.cairo_set_matrix(cairo, matrix); data.cairoXoffset = Math.abs(offsetX[0]); data.cairoYoffset = Math.abs(offsetY[0]); } else { data.cairoXoffset = data.cairoYoffset = 0; } } } long convertRgn(long rgn, double[] matrix) { long newRgn = Cairo.cairo_region_create(); if (isIdentity(matrix)) { Cairo.cairo_region_union(newRgn, rgn); return newRgn; } int[] nRects = new int[1]; long [] rects = new long [1]; Region.cairo_region_get_rectangles(rgn, rects, nRects); cairo_rectangle_int_t rect = new cairo_rectangle_int_t (); int[] pointArray = new int[8]; double[] x = new double[1], y = new double[1]; for (int i=0; iSWT.BITMAP
. * * @param image the image to copy into * @param x the x coordinate in the receiver of the area to be copied * @param y the y coordinate in the receiver of the area to be copied * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the image is null
  • *
  • ERROR_INVALID_ARGUMENT - if the image is not a bitmap or has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void copyArea(Image image, int x, int y) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (image == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); if (image.type != SWT.BITMAP || image.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); Point loc = DPIUtil.autoScaleUp(drawable, new Point(x, y)); copyAreaInPixels(image, loc.x, loc.y); } void copyAreaInPixels(Image image, int x, int y) { long cairo = Cairo.cairo_create(image.surface); if (cairo == 0) SWT.error(SWT.ERROR_NO_HANDLES); Cairo.cairo_translate(cairo, -x, -y); Cairo.cairo_push_group(cairo); if (data.image != null) { Cairo.cairo_set_source_surface(cairo, data.image.surface, 0, 0); } else if (data.drawable != 0) { if (!GTK.GTK4) GDK.gdk_cairo_set_source_window(cairo, data.drawable, 0, 0); } else { Cairo.cairo_destroy(cairo); return; } Cairo.cairo_set_operator(cairo, Cairo.CAIRO_OPERATOR_SOURCE); Cairo.cairo_paint(cairo); Cairo.cairo_pop_group_to_source(cairo); Cairo.cairo_paint(cairo); Cairo.cairo_destroy(cairo); } /** * Copies a rectangular area of the receiver at the source * position onto the receiver at the destination position. * * @param srcX the x coordinate in the receiver of the area to be copied * @param srcY the y coordinate in the receiver of the area to be copied * @param width the width of the area to copy * @param height the height of the area to copy * @param destX the x coordinate in the receiver of the area to copy to * @param destY the y coordinate in the receiver of the area to copy to * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void copyArea(int srcX, int srcY, int width, int height, int destX, int destY) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Rectangle src = DPIUtil.autoScaleUp(drawable, new Rectangle(srcX, srcY, width, height)); Point dest = DPIUtil.autoScaleUp(drawable, new Point(destX, destY)); copyAreaInPixels(src.x, src.y, src.width, src.height, dest.x, dest.y); } void copyAreaInPixels(int srcX, int srcY, int width, int height, int destX, int destY) { copyAreaInPixels(srcX, srcY, width, height, destX, destY, true); } /** * Copies a rectangular area of the receiver at the source * position onto the receiver at the destination position. * * @param srcX the x coordinate in the receiver of the area to be copied * @param srcY the y coordinate in the receiver of the area to be copied * @param width the width of the area to copy * @param height the height of the area to copy * @param destX the x coordinate in the receiver of the area to copy to * @param destY the y coordinate in the receiver of the area to copy to * @param paint if true paint events will be generated for old and obscured areas * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public void copyArea(int srcX, int srcY, int width, int height, int destX, int destY, boolean paint) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Rectangle srcLoc = DPIUtil.autoScaleUp(drawable, new Rectangle(srcX, srcY, width, height)); Point destLoc = DPIUtil.autoScaleUp(drawable, new Point(destX, destY)); copyAreaInPixels(srcLoc.x, srcLoc.y, srcLoc.width, srcLoc.height, destLoc.x, destLoc.y, paint); } void copyAreaInPixels(int srcX, int srcY, int width, int height, int destX, int destY, boolean paint) { if (width <= 0 || height <= 0) return; int deltaX = destX - srcX, deltaY = destY - srcY; if (deltaX == 0 && deltaY == 0) return; long drawable = data.drawable; if (data.image != null) { Cairo.cairo_set_source_surface(handle, data.image.surface, deltaX, deltaY); Cairo.cairo_rectangle(handle, destX, destY, width, height); Cairo.cairo_set_operator(handle, Cairo.CAIRO_OPERATOR_SOURCE); Cairo.cairo_fill(handle); } else if (drawable != 0) { Cairo.cairo_save(handle); Cairo.cairo_rectangle(handle, destX, destY, width, height); Cairo.cairo_clip(handle); Cairo.cairo_translate(handle, deltaX, deltaY); Cairo.cairo_set_operator(handle, Cairo.CAIRO_OPERATOR_SOURCE); Cairo.cairo_push_group(handle); if (!GTK.GTK4) GDK.gdk_cairo_set_source_window(handle, drawable, 0, 0); Cairo.cairo_paint(handle); Cairo.cairo_pop_group_to_source(handle); Cairo.cairo_rectangle(handle, destX - deltaX, destY - deltaY, width, height); Cairo.cairo_clip(handle); Cairo.cairo_paint(handle); Cairo.cairo_restore(handle); if (paint) { cairo_rectangle_int_t srcRect = new cairo_rectangle_int_t (); srcRect.x = srcX; srcRect.y = srcY; srcRect.width = width; srcRect.height = height; long invalidateRegion = Cairo.cairo_region_create_rectangle (srcRect); if (GTK.GTK4) { /* TODO: GTK4 no ability to invalidate surfaces, may need to keep track of * invalid regions ourselves and do gdk_surface_queue_expose */ } else { long visibleRegion = GDK.gdk_window_get_visible_region (drawable); long copyRegion = Cairo.cairo_region_create_rectangle (srcRect); Cairo.cairo_region_intersect(copyRegion, visibleRegion); Cairo.cairo_region_subtract (invalidateRegion, visibleRegion); Cairo.cairo_region_translate (invalidateRegion, deltaX, deltaY); GDK.gdk_window_invalidate_region(drawable, invalidateRegion, false); Cairo.cairo_region_destroy (visibleRegion); Cairo.cairo_region_destroy (copyRegion); } Cairo.cairo_region_destroy (invalidateRegion); } } if (data.image == null && paint) { boolean disjoint = (destX + width < srcX) || (srcX + width < destX) || (destY + height < srcY) || (srcY + height < destY); GdkRectangle rect = new GdkRectangle (); if (disjoint) { rect.x = srcX; rect.y = srcY; rect.width = Math.max (0, width); rect.height = Math.max (0, height); if (GTK.GTK4) { /* TODO: GTK4 no ability to invalidate surfaces, may need to keep track of * invalid regions ourselves and do gdk_surface_queue_expose */ } else { GDK.gdk_window_invalidate_rect (drawable, rect, false); } } else { if (deltaX != 0) { int newX = destX - deltaX; if (deltaX < 0) newX = destX + width; rect.x = newX; rect.y = srcY; rect.width = Math.abs(deltaX); rect.height = Math.max (0, height); if (GTK.GTK4) { /* TODO: GTK4 no ability to invalidate surfaces, may need to keep track of * invalid regions ourselves and do gdk_surface_queue_expose */ } else { GDK.gdk_window_invalidate_rect (drawable, rect, false); } } if (deltaY != 0) { int newY = destY - deltaY; if (deltaY < 0) newY = destY + height; rect.x = srcX; rect.y = newY; rect.width = Math.max (0, width); rect.height = Math.abs(deltaY); if (GTK.GTK4) { /* TODO: GTK4 no ability to invalidate surfaces, may need to keep track of * invalid regions ourselves and do gdk_surface_queue_expose */ } else { GDK.gdk_window_invalidate_rect (drawable, rect, false); } } } } } void createLayout() { long context; if (GTK.GTK4) { long fontMap = OS.pango_cairo_font_map_get_default (); context = OS.pango_font_map_create_context (fontMap); } else { context = GDK.gdk_pango_context_get(); } if (context == 0) SWT.error(SWT.ERROR_NO_HANDLES); data.context = context; long layout = OS.pango_layout_new(context); if (layout == 0) SWT.error(SWT.ERROR_NO_HANDLES); data.layout = layout; OS.pango_context_set_language(context, GTK.gtk_get_default_language()); OS.pango_context_set_base_dir(context, (data.style & SWT.MIRRORED) != 0 ? OS.PANGO_DIRECTION_RTL : OS.PANGO_DIRECTION_LTR); OS.pango_layout_set_auto_dir(layout, false); } void disposeLayout() { data.string = null; if (data.context != 0) OS.g_object_unref(data.context); if (data.layout != 0) OS.g_object_unref(data.layout); data.layout = data.context = 0; } @Override void destroy() { if (data.disposeCairo) { long cairo = data.cairo; Cairo.cairo_destroy(cairo); } data.cairo = 0; /* Free resources */ long clipRgn = data.clipRgn; if (clipRgn != 0) Cairo.cairo_region_destroy(clipRgn); Image image = data.image; if (image != null) { image.memGC = null; if (image.transparentPixel != -1) image.createMask(); } disposeLayout(); /* Dispose the GC */ if (drawable != null) { drawable.internal_dispose_GC(handle, data); } data.drawable = data.clipRgn = 0; drawable = null; handle = 0; data.image = null; data.string = null; data = null; } /** * Draws the outline of a circular or elliptical arc * within the specified rectangular area. *

* The resulting arc begins at startAngle and extends * for arcAngle degrees, using the current color. * Angles are interpreted such that 0 degrees is at the 3 o'clock * position. A positive value indicates a counter-clockwise rotation * while a negative value indicates a clockwise rotation. *

* The center of the arc is the center of the rectangle whose origin * is (x, y) and whose size is specified by the * width and height arguments. *

* The resulting arc covers an area width + 1 points wide * by height + 1 points tall. *

* * @param x the x coordinate of the upper-left corner of the arc to be drawn * @param y the y coordinate of the upper-left corner of the arc to be drawn * @param width the width of the arc to be drawn * @param height the height of the arc to be drawn * @param startAngle the beginning angle * @param arcAngle the angular extent of the arc, relative to the start angle * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawArc(int x, int y, int width, int height, int startAngle, int arcAngle) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Rectangle loc = DPIUtil.autoScaleUp(drawable, new Rectangle(x, y, width, height)); drawArcInPixels(loc.x, loc.y, loc.width, loc.height, startAngle, arcAngle); } void drawArcInPixels(int x, int y, int width, int height, int startAngle, int arcAngle) { checkGC(DRAW); if (width < 0) { x = x + width; width = -width; } if (height < 0) { y = y + height; height = -height; } if (width == 0 || height == 0 || arcAngle == 0) return; long cairo = data.cairo; double xOffset = data.cairoXoffset, yOffset = data.cairoYoffset; if (width == height) { if (arcAngle >= 0) { Cairo.cairo_arc_negative(cairo, x + xOffset + width / 2f, y + yOffset + height / 2f, width / 2f, -startAngle * (float)Math.PI / 180, -(startAngle + arcAngle) * (float)Math.PI / 180); } else { Cairo.cairo_arc(cairo, x + xOffset + width / 2f, y + yOffset + height / 2f, width / 2f, -startAngle * (float)Math.PI / 180, -(startAngle + arcAngle) * (float)Math.PI / 180); } } else { Cairo.cairo_save(cairo); Cairo.cairo_translate(cairo, x + xOffset + width / 2f, y + yOffset + height / 2f); Cairo.cairo_scale(cairo, width / 2f, height / 2f); if (arcAngle >= 0) { Cairo.cairo_arc_negative(cairo, 0, 0, 1, -startAngle * (float)Math.PI / 180, -(startAngle + arcAngle) * (float)Math.PI / 180); } else { Cairo.cairo_arc(cairo, 0, 0, 1, -startAngle * (float)Math.PI / 180, -(startAngle + arcAngle) * (float)Math.PI / 180); } Cairo.cairo_restore(cairo); } Cairo.cairo_stroke(cairo); } /** * Draws a rectangle, based on the specified arguments, which has * the appearance of the platform's focus rectangle if the * platform supports such a notion, and otherwise draws a simple * rectangle in the receiver's foreground color. * * @param x the x coordinate of the rectangle * @param y the y coordinate of the rectangle * @param width the width of the rectangle * @param height the height of the rectangle * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #drawRectangle(int, int, int, int) */ public void drawFocus(int x, int y, int width, int height) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Rectangle loc = DPIUtil.autoScaleUp(drawable, new Rectangle(x, y, width, height)); drawFocusInPixels(loc.x, loc.y, loc.width, loc.height); } void drawFocusInPixels(int x, int y, int width, int height) { long cairo = data.cairo; checkGC(FOREGROUND); long context = GTK.gtk_widget_get_style_context(data.device.shellHandle); GTK.gtk_render_focus(context, cairo, x, y, width, height); } /** * Draws the given image in the receiver at the specified * coordinates. * * @param image the image to draw * @param x the x coordinate of where to draw * @param y the y coordinate of where to draw * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the image is null
  • *
  • ERROR_INVALID_ARGUMENT - if the image has been disposed
  • *
  • ERROR_INVALID_ARGUMENT - if the given coordinates are outside the bounds of the image
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* @exception SWTError
    *
  • ERROR_NO_HANDLES - if no handles are available to perform the operation
  • *
*/ public void drawImage(Image image, int x, int y) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (image == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); if (image.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); Point loc = DPIUtil.autoScaleUp(drawable, new Point(x, y)); drawImageInPixels(image, loc.x, loc.y); } void drawImageInPixels(Image image, int x, int y) { drawImage(image, 0, 0, -1, -1, x, y, -1, -1, true); } /** * Copies a rectangular area from the source image into a (potentially * different sized) rectangular area in the receiver. If the source * and destination areas are of differing sizes, then the source * area will be stretched or shrunk to fit the destination area * as it is copied. The copy fails if any part of the source rectangle * lies outside the bounds of the source image, or if any of the width * or height arguments are negative. * * @param image the source image * @param srcX the x coordinate in the source image to copy from * @param srcY the y coordinate in the source image to copy from * @param srcWidth the width in points to copy from the source * @param srcHeight the height in points to copy from the source * @param destX the x coordinate in the destination to copy to * @param destY the y coordinate in the destination to copy to * @param destWidth the width in points of the destination rectangle * @param destHeight the height in points of the destination rectangle * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the image is null
  • *
  • ERROR_INVALID_ARGUMENT - if the image has been disposed
  • *
  • ERROR_INVALID_ARGUMENT - if any of the width or height arguments are negative. *
  • ERROR_INVALID_ARGUMENT - if the source rectangle is not contained within the bounds of the source image
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* @exception SWTError
    *
  • ERROR_NO_HANDLES - if no handles are available to perform the operation
  • *
*/ public void drawImage(Image image, int srcX, int srcY, int srcWidth, int srcHeight, int destX, int destY, int destWidth, int destHeight) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (srcWidth == 0 || srcHeight == 0 || destWidth == 0 || destHeight == 0) return; if (srcX < 0 || srcY < 0 || srcWidth < 0 || srcHeight < 0 || destWidth < 0 || destHeight < 0) { SWT.error (SWT.ERROR_INVALID_ARGUMENT); } if (image == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); if (image.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); Rectangle destRect = DPIUtil.autoScaleUp(drawable, new Rectangle(destX, destY, destWidth, destHeight)); drawImage(image, srcX, srcY, srcWidth, srcHeight, destRect.x, destRect.y, destRect.width, destRect.height, false); } void drawImage(Image srcImage, int srcX, int srcY, int srcWidth, int srcHeight, int destX, int destY, int destWidth, int destHeight, boolean simple) { /* Refresh Image as per zoom level, if required. */ srcImage.refreshImageForZoom (); ImageData srcImageData = srcImage.getImageData(); int imgWidth = srcImageData.width; int imgHeight = srcImageData.height; if (simple) { srcWidth = destWidth = imgWidth; srcHeight = destHeight = imgHeight; } else { simple = srcX == 0 && srcY == 0 && srcWidth == destWidth && destWidth == imgWidth && srcHeight == destHeight && destHeight == imgHeight; if (srcX + srcWidth > imgWidth + 1 || srcY + srcHeight > imgHeight + 1) { //rounding error correction for hidpi SWT.error(SWT.ERROR_INVALID_ARGUMENT); } } long cairo = data.cairo; if (data.alpha != 0) { srcImage.createSurface(); Cairo.cairo_save(cairo); if ((data.style & SWT.MIRRORED) != 0) { Cairo.cairo_scale(cairo, -1f, 1); Cairo.cairo_translate(cairo, - 2 * destX - destWidth, 0); } Cairo.cairo_rectangle(cairo, destX , destY, destWidth, destHeight); Cairo.cairo_clip(cairo); if (srcWidth != destWidth || srcHeight != destHeight) { float scaleX = destWidth / (float)srcWidth; float scaleY = destHeight / (float)srcHeight; Cairo.cairo_translate(cairo, destX - (int)(srcX * scaleX), destY - (int)(srcY * scaleY)); Cairo.cairo_scale(cairo, scaleX, scaleY); } else { Cairo.cairo_translate(cairo, destX - srcX, destY - srcY); } int filter = Cairo.CAIRO_FILTER_GOOD; switch (data.interpolation) { case SWT.DEFAULT: filter = Cairo.CAIRO_FILTER_GOOD; break; case SWT.NONE: filter = Cairo.CAIRO_FILTER_NEAREST; break; case SWT.LOW: filter = Cairo.CAIRO_FILTER_FAST; break; case SWT.HIGH: filter = Cairo.CAIRO_FILTER_BEST; break; } long pattern = Cairo.cairo_pattern_create_for_surface(srcImage.surface); if (pattern == 0) SWT.error(SWT.ERROR_NO_HANDLES); if (srcWidth != destWidth || srcHeight != destHeight) { Cairo.cairo_pattern_set_extend(pattern, Cairo.CAIRO_EXTEND_PAD); } Cairo.cairo_pattern_set_filter(pattern, filter); Cairo.cairo_set_source(cairo, pattern); if (data.alpha != 0xFF) { Cairo.cairo_paint_with_alpha(cairo, data.alpha / (float)0xFF); } else { Cairo.cairo_paint(cairo); } Cairo.cairo_restore(cairo); Cairo.cairo_pattern_destroy(pattern); } } /** * Draws a line, using the foreground color, between the points * (x1, y1) and (x2, y2). * * @param x1 the first point's x coordinate * @param y1 the first point's y coordinate * @param x2 the second point's x coordinate * @param y2 the second point's y coordinate * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawLine(int x1, int y1, int x2, int y2) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Point loc1 = DPIUtil.autoScaleUp(drawable, new Point(x1, y1)); Point loc2 = DPIUtil.autoScaleUp(drawable, new Point(x2, y2)); drawLineInPixels(loc1.x, loc1.y, loc2.x, loc2.y); } void drawLineInPixels(int x1, int y1, int x2, int y2) { checkGC(DRAW); long cairo = data.cairo; double xOffset = data.cairoXoffset, yOffset = data.cairoYoffset; if (Cairo.cairo_version() >= Cairo.CAIRO_VERSION_ENCODE(1, 12, 0)) { Cairo.cairo_set_antialias(cairo, Cairo.CAIRO_ANTIALIAS_BEST); } Cairo.cairo_move_to(cairo, x1 + xOffset, y1 + yOffset); Cairo.cairo_line_to(cairo, x2 + xOffset, y2 + yOffset); Cairo.cairo_stroke(cairo); } /** * Draws the outline of an oval, using the foreground color, * within the specified rectangular area. *

* The result is a circle or ellipse that fits within the * rectangle specified by the x, y, * width, and height arguments. *

* The oval covers an area that is width + 1 * points wide and height + 1 points tall. *

* * @param x the x coordinate of the upper left corner of the oval to be drawn * @param y the y coordinate of the upper left corner of the oval to be drawn * @param width the width of the oval to be drawn * @param height the height of the oval to be drawn * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawOval(int x, int y, int width, int height) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Rectangle rect = DPIUtil.autoScaleUp(drawable, new Rectangle(x, y, width, height)); drawOvalInPixels(rect.x, rect.y, rect.width, rect.height); } void drawOvalInPixels(int x, int y, int width, int height) { checkGC(DRAW); if (width < 0) { x = x + width; width = -width; } if (height < 0) { y = y + height; height = -height; } long cairo = data.cairo; double xOffset = data.cairoXoffset, yOffset = data.cairoYoffset; if (width == height) { Cairo.cairo_arc_negative(cairo, x + xOffset + width / 2f, y + yOffset + height / 2f, width / 2f, 0, -2 * (float)Math.PI); } else { Cairo.cairo_save(cairo); Cairo.cairo_translate(cairo, x + xOffset + width / 2f, y + yOffset + height / 2f); Cairo.cairo_scale(cairo, width / 2f, height / 2f); Cairo.cairo_arc_negative(cairo, 0, 0, 1, 0, -2 * (float)Math.PI); Cairo.cairo_restore(cairo); } Cairo.cairo_stroke(cairo); } /** * Draws the path described by the parameter. *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* * @param path the path to draw * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the parameter is null
  • *
  • ERROR_INVALID_ARGUMENT - if the parameter has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see Path * * @since 3.1 */ public void drawPath(Path path) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (path == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); if (path.handle == 0) SWT.error(SWT.ERROR_INVALID_ARGUMENT); initCairo(); checkGC(DRAW); long cairo = data.cairo; Cairo.cairo_save(cairo); double xOffset = data.cairoXoffset, yOffset = data.cairoYoffset; Cairo.cairo_translate(cairo, xOffset, yOffset); long copy = Cairo.cairo_copy_path(path.handle); if (copy == 0) SWT.error(SWT.ERROR_NO_HANDLES); Cairo.cairo_append_path(cairo, copy); Cairo.cairo_path_destroy(copy); Cairo.cairo_stroke(cairo); Cairo.cairo_restore(cairo); } /** * Draws an SWT logical point, using the foreground color, at the specified * point (x, y). *

* Note that the receiver's line attributes do not affect this * operation. *

* * @param x the point's x coordinate * @param y the point's y coordinate * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.0 */ public void drawPoint (int x, int y) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Point loc = DPIUtil.autoScaleUp(drawable, new Point(x, y)); drawPointInPixels(loc.x, loc.y); } void drawPointInPixels (int x, int y) { checkGC(DRAW); long cairo = data.cairo; Cairo.cairo_rectangle(cairo, x, y, 1, 1); Cairo.cairo_fill(cairo); } /** * Draws the closed polygon which is defined by the specified array * of integer coordinates, using the receiver's foreground color. The array * contains alternating x and y values which are considered to represent * points which are the vertices of the polygon. Lines are drawn between * each consecutive pair, and between the first pair and last pair in the * array. * * @param pointArray an array of alternating x and y values which are the vertices of the polygon * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT if pointArray is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawPolygon(int[] pointArray) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (pointArray == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); int [] scaledPointArray = DPIUtil.autoScaleUp(drawable, pointArray); drawPolygonInPixels(scaledPointArray); } void drawPolygonInPixels(int[] pointArray) { checkGC(DRAW); long cairo = data.cairo; drawPolyline(cairo, pointArray, true); Cairo.cairo_stroke(cairo); } /** * Draws the polyline which is defined by the specified array * of integer coordinates, using the receiver's foreground color. The array * contains alternating x and y values which are considered to represent * points which are the corners of the polyline. Lines are drawn between * each consecutive pair, but not between the first pair and last pair in * the array. * * @param pointArray an array of alternating x and y values which are the corners of the polyline * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the point array is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawPolyline(int[] pointArray) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (pointArray == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); int [] scaledPointArray = DPIUtil.autoScaleUp(drawable, pointArray); drawPolylineInPixels(scaledPointArray); } void drawPolylineInPixels(int[] pointArray) { checkGC(DRAW); long cairo = data.cairo; drawPolyline(cairo, pointArray, false); Cairo.cairo_stroke(cairo); } void drawPolyline(long cairo, int[] pointArray, boolean close) { int count = pointArray.length / 2; if (count == 0) return; double xOffset = data.cairoXoffset, yOffset = data.cairoYoffset; Cairo.cairo_move_to(cairo, pointArray[0] + xOffset, pointArray[1] + yOffset); for (int i = 1, j=2; i < count; i++, j += 2) { Cairo.cairo_line_to(cairo, pointArray[j] + xOffset, pointArray[j + 1] + yOffset); } if (close) Cairo.cairo_close_path(cairo); } /** * Draws the outline of the rectangle specified by the arguments, * using the receiver's foreground color. The left and right edges * of the rectangle are at x and x + width. * The top and bottom edges are at y and y + height. * * @param x the x coordinate of the rectangle to be drawn * @param y the y coordinate of the rectangle to be drawn * @param width the width of the rectangle to be drawn * @param height the height of the rectangle to be drawn * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawRectangle(int x, int y, int width, int height) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); drawRectangle(new Rectangle(x, y, width, height)); } void drawRectangleInPixels(int x, int y, int width, int height) { checkGC(DRAW); if (width < 0) { x = x + width; width = -width; } if (height < 0) { y = y + height; height = -height; } long cairo = data.cairo; double xOffset = data.cairoXoffset, yOffset = data.cairoYoffset; Cairo.cairo_rectangle(cairo, x + xOffset, y + yOffset, width, height); Cairo.cairo_stroke(cairo); } /** * Draws the outline of the specified rectangle, using the receiver's * foreground color. The left and right edges of the rectangle are at * rect.x and rect.x + rect.width. The top * and bottom edges are at rect.y and * rect.y + rect.height. * * @param rect the rectangle to draw * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the rectangle is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawRectangle(Rectangle rect) { if (rect == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); drawRectangleInPixels(DPIUtil.autoScaleUp(drawable, rect)); } void drawRectangleInPixels(Rectangle rect) { drawRectangleInPixels (rect.x, rect.y, rect.width, rect.height); } /** * Draws the outline of the round-cornered rectangle specified by * the arguments, using the receiver's foreground color. The left and * right edges of the rectangle are at x and x + width. * The top and bottom edges are at y and y + height. * The roundness of the corners is specified by the * arcWidth and arcHeight arguments, which * are respectively the width and height of the ellipse used to draw * the corners. * * @param x the x coordinate of the rectangle to be drawn * @param y the y coordinate of the rectangle to be drawn * @param width the width of the rectangle to be drawn * @param height the height of the rectangle to be drawn * @param arcWidth the width of the arc * @param arcHeight the height of the arc * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawRoundRectangle(int x, int y, int width, int height, int arcWidth, int arcHeight) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Rectangle rect = DPIUtil.autoScaleUp(drawable, new Rectangle(x, y, width, height)); Point arcSize = DPIUtil.autoScaleUp(drawable, new Point(arcWidth, arcHeight)); drawRoundRectangleInPixels(rect.x, rect.y, rect.width, rect.height, arcSize.x, arcSize.y); } void drawRoundRectangleInPixels(int x, int y, int width, int height, int arcWidth, int arcHeight) { checkGC(DRAW); int nx = x; int ny = y; int nw = width; int nh = height; int naw = arcWidth; int nah = arcHeight; if (nw < 0) { nw = 0 - nw; nx = nx - nw; } if (nh < 0) { nh = 0 - nh; ny = ny -nh; } if (naw < 0) naw = 0 - naw; if (nah < 0) nah = 0 - nah; long cairo = data.cairo; double xOffset = data.cairoXoffset, yOffset = data.cairoYoffset; if (naw == 0 || nah == 0) { Cairo.cairo_rectangle(cairo, x + xOffset, y + yOffset, width, height); } else { float naw2 = naw / 2f; float nah2 = nah / 2f; float fw = nw / naw2; float fh = nh / nah2; Cairo.cairo_save(cairo); Cairo.cairo_translate(cairo, nx + xOffset, ny + yOffset); Cairo.cairo_scale(cairo, naw2, nah2); Cairo.cairo_move_to(cairo, fw - 1, 0); Cairo.cairo_arc(cairo, fw - 1, 1, 1, Math.PI + Math.PI/2.0, Math.PI*2.0); Cairo.cairo_arc(cairo, fw - 1, fh - 1, 1, 0, Math.PI/2.0); Cairo.cairo_arc(cairo, 1, fh - 1, 1, Math.PI/2, Math.PI); Cairo.cairo_arc(cairo, 1, 1, 1, Math.PI, 270.0*Math.PI/180.0); Cairo.cairo_close_path(cairo); Cairo.cairo_restore(cairo); } Cairo.cairo_stroke(cairo); } /** * Draws the given string, using the receiver's current font and * foreground color. No tab expansion or carriage return processing * will be performed. The background of the rectangular area where * the string is being drawn will be filled with the receiver's * background color. *

* On Windows, {@link #drawString} and {@link #drawText} are slightly * different, see {@link #drawString(String, int, int, boolean)} for * explanation. * * @param string the string to be drawn * @param x the x coordinate of the top left corner of the rectangular area where the string is to be drawn * @param y the y coordinate of the top left corner of the rectangular area where the string is to be drawn * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the string is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawString (String string, int x, int y) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (string == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); drawString (string, x, y, false); } void drawStringInPixels (String string, int x, int y) { drawStringInPixels(string, x, y, false); } /** * Draws the given string, using the receiver's current font and * foreground color. No tab expansion or carriage return processing * will be performed. If isTransparent is true, * then the background of the rectangular area where the string is being * drawn will not be modified, otherwise it will be filled with the * receiver's background color. *

* On Windows, {@link #drawString} and {@link #drawText} are slightly * different: *
    *
  • {@link #drawString} is faster (depends on string size)
    ~7x for 1-char strings
    ~4x for 10-char strings
    ~2x for 100-char strings
  • *
  • {@link #drawString} doesn't try to find a good fallback font when character doesn't have a glyph in currently selected font
  • *
* * @param string the string to be drawn * @param x the x coordinate of the top left corner of the rectangular area where the string is to be drawn * @param y the y coordinate of the top left corner of the rectangular area where the string is to be drawn * @param isTransparent if true the background will be transparent, otherwise it will be opaque * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the string is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawString(String string, int x, int y, boolean isTransparent) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (string == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); Point loc = DPIUtil.autoScaleUp(drawable, new Point(x, y)); drawStringInPixels(string, loc.x, loc.y, isTransparent); } void drawStringInPixels(String string, int x, int y, boolean isTransparent) { drawTextInPixels(string, x, y, isTransparent ? SWT.DRAW_TRANSPARENT : 0); } /** * Draws the given string, using the receiver's current font and * foreground color. Tab expansion and carriage return processing * are performed. The background of the rectangular area where * the text is being drawn will be filled with the receiver's * background color. *

* On Windows, {@link #drawString} and {@link #drawText} are slightly * different, see {@link #drawString(String, int, int, boolean)} for * explanation. * * @param string the string to be drawn * @param x the x coordinate of the top left corner of the rectangular area where the text is to be drawn * @param y the y coordinate of the top left corner of the rectangular area where the text is to be drawn * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the string is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawText(String string, int x, int y) { drawText(string, x, y, SWT.DRAW_DELIMITER | SWT.DRAW_TAB); } void drawTextInPixels(String string, int x, int y) { drawTextInPixels(string, x, y, SWT.DRAW_DELIMITER | SWT.DRAW_TAB); } /** * Draws the given string, using the receiver's current font and * foreground color. Tab expansion and carriage return processing * are performed. If isTransparent is true, * then the background of the rectangular area where the text is being * drawn will not be modified, otherwise it will be filled with the * receiver's background color. *

* On Windows, {@link #drawString} and {@link #drawText} are slightly * different, see {@link #drawString(String, int, int, boolean)} for * explanation. * * @param string the string to be drawn * @param x the x coordinate of the top left corner of the rectangular area where the text is to be drawn * @param y the y coordinate of the top left corner of the rectangular area where the text is to be drawn * @param isTransparent if true the background will be transparent, otherwise it will be opaque * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the string is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawText(String string, int x, int y, boolean isTransparent) { Point loc = DPIUtil.autoScaleUp(drawable, new Point (x, y)); drawTextInPixels(string, loc.x, loc.y, isTransparent); } void drawTextInPixels(String string, int x, int y, boolean isTransparent) { int flags = SWT.DRAW_DELIMITER | SWT.DRAW_TAB; if (isTransparent) flags |= SWT.DRAW_TRANSPARENT; drawTextInPixels(string, x, y, flags); } /** * Draws the given string, using the receiver's current font and * foreground color. Tab expansion, line delimiter and mnemonic * processing are performed according to the specified flags. If * flags includes DRAW_TRANSPARENT, * then the background of the rectangular area where the text is being * drawn will not be modified, otherwise it will be filled with the * receiver's background color. *

* On Windows, {@link #drawString} and {@link #drawText} are slightly * different, see {@link #drawString(String, int, int, boolean)} for * explanation. * *

* The parameter flags may be a combination of: *

*
*
DRAW_DELIMITER
*
draw multiple lines
*
DRAW_TAB
*
expand tabs
*
DRAW_MNEMONIC
*
underline the mnemonic character
*
DRAW_TRANSPARENT
*
transparent background
*
* * @param string the string to be drawn * @param x the x coordinate of the top left corner of the rectangular area where the text is to be drawn * @param y the y coordinate of the top left corner of the rectangular area where the text is to be drawn * @param flags the flags specifying how to process the text * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the string is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void drawText (String string, int x, int y, int flags) { Point loc = DPIUtil.autoScaleUp(drawable, new Point (x, y)); drawTextInPixels(string, loc.x, loc.y, flags); } void drawTextInPixels (String string, int x, int y, int flags) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (string == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); if (string.length() == 0) return; long cairo = data.cairo; setString(string, flags); checkGC(FONT); if ((flags & SWT.DRAW_TRANSPARENT) == 0) { checkGC(BACKGROUND); if (data.stringWidth == -1) { computeStringSize(); } Cairo.cairo_rectangle(cairo, x, y, data.stringWidth, data.stringHeight); Cairo.cairo_fill(cairo); } checkGC(FOREGROUND); if ((data.style & SWT.MIRRORED) != 0) { Cairo.cairo_save(cairo); if (data.stringWidth == -1) { computeStringSize(); } Cairo.cairo_scale(cairo, -1f, 1); Cairo.cairo_translate(cairo, -2 * x - data.stringWidth, 0); } Cairo.cairo_move_to(cairo, x, y); OS.pango_cairo_show_layout(cairo, data.layout); if ((data.style & SWT.MIRRORED) != 0) { Cairo.cairo_restore(cairo); } Cairo.cairo_new_path(cairo); } /** * Compares the argument to the receiver, and returns true * if they represent the same object using a class * specific comparison. * * @param object the object to compare with this object * @return true if the object is the same as this object and false otherwise * * @see #hashCode */ @Override public boolean equals(Object object) { if (object == this) return true; if (!(object instanceof GC)) return false; return handle == ((GC)object).handle; } /** * Fills the interior of a circular or elliptical arc within * the specified rectangular area, with the receiver's background * color. *

* The resulting arc begins at startAngle and extends * for arcAngle degrees, using the current color. * Angles are interpreted such that 0 degrees is at the 3 o'clock * position. A positive value indicates a counter-clockwise rotation * while a negative value indicates a clockwise rotation. *

* The center of the arc is the center of the rectangle whose origin * is (x, y) and whose size is specified by the * width and height arguments. *

* The resulting arc covers an area width + 1 points wide * by height + 1 points tall. *

* * @param x the x coordinate of the upper-left corner of the arc to be filled * @param y the y coordinate of the upper-left corner of the arc to be filled * @param width the width of the arc to be filled * @param height the height of the arc to be filled * @param startAngle the beginning angle * @param arcAngle the angular extent of the arc, relative to the start angle * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #drawArc */ public void fillArc(int x, int y, int width, int height, int startAngle, int arcAngle) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Rectangle rect = DPIUtil.autoScaleUp(drawable, new Rectangle(x, y, width, height)); fillArcInPixels(rect.x, rect.y, rect.width, rect.height, startAngle, arcAngle); } void fillArcInPixels(int x, int y, int width, int height, int startAngle, int arcAngle) { checkGC(FILL); if (width < 0) { x = x + width; width = -width; } if (height < 0) { y = y + height; height = -height; } if (width == 0 || height == 0 || arcAngle == 0) return; long cairo = data.cairo; if (width == height) { if (arcAngle >= 0) { Cairo.cairo_arc_negative(cairo, x + width / 2f, y + height / 2f, width / 2f, -startAngle * (float)Math.PI / 180, -(startAngle + arcAngle) * (float)Math.PI / 180); } else { Cairo.cairo_arc(cairo, x + width / 2f, y + height / 2f, width / 2f, -startAngle * (float)Math.PI / 180, -(startAngle + arcAngle) * (float)Math.PI / 180); } Cairo.cairo_line_to(cairo, x + width / 2f, y + height / 2f); } else { Cairo.cairo_save(cairo); Cairo.cairo_translate(cairo, x + width / 2f, y + height / 2f); Cairo.cairo_scale(cairo, width / 2f, height / 2f); if (arcAngle >= 0) { Cairo.cairo_arc_negative(cairo, 0, 0, 1, -startAngle * (float)Math.PI / 180, -(startAngle + arcAngle) * (float)Math.PI / 180); } else { Cairo.cairo_arc(cairo, 0, 0, 1, -startAngle * (float)Math.PI / 180, -(startAngle + arcAngle) * (float)Math.PI / 180); } Cairo.cairo_line_to(cairo, 0, 0); Cairo.cairo_restore(cairo); } Cairo.cairo_fill(cairo); } /** * Fills the interior of the specified rectangle with a gradient * sweeping from left to right or top to bottom progressing * from the receiver's foreground color to its background color. * * @param x the x coordinate of the rectangle to be filled * @param y the y coordinate of the rectangle to be filled * @param width the width of the rectangle to be filled, may be negative * (inverts direction of gradient if horizontal) * @param height the height of the rectangle to be filled, may be negative * (inverts direction of gradient if vertical) * @param vertical if true sweeps from top to bottom, else * sweeps from left to right * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #drawRectangle(int, int, int, int) */ public void fillGradientRectangle(int x, int y, int width, int height, boolean vertical) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Rectangle rect = DPIUtil.autoScaleUp(drawable, new Rectangle(x, y, width, height)); fillGradientRectangleInPixels(rect.x, rect.y, rect.width, rect.height, vertical); } void fillGradientRectangleInPixels(int x, int y, int width, int height, boolean vertical) { if ((width == 0) || (height == 0)) return; /* Rewrite this to use GdkPixbuf */ RGB backgroundRGB, foregroundRGB; backgroundRGB = getBackground().getRGB(); foregroundRGB = getForeground().getRGB(); RGB fromRGB, toRGB; fromRGB = foregroundRGB; toRGB = backgroundRGB; boolean swapColors = false; if (width < 0) { x += width; width = -width; if (! vertical) swapColors = true; } if (height < 0) { y += height; height = -height; if (vertical) swapColors = true; } if (swapColors) { fromRGB = backgroundRGB; toRGB = foregroundRGB; } long cairo = data.cairo; long pattern; if (DPIUtil.useCairoAutoScale() ) { /* * Here the co-ordinates passed are in points for GTK3. * That means the user is expecting surface to be at * device scale equal to current scale factor. So need * to set the device scale to current scale factor */ long surface = Cairo.cairo_get_target(cairo); if (surface != 0) { float scaleFactor = DPIUtil.getDeviceZoom() / 100f; Cairo.cairo_surface_set_device_scale(surface, scaleFactor, scaleFactor); } } if (fromRGB.equals(toRGB)) { fillRectangleInPixels(x, y, width, height); return; } if (vertical) { pattern = Cairo.cairo_pattern_create_linear (0.0, 0.0, 0.0, 1.0); } else { pattern = Cairo.cairo_pattern_create_linear (0.0, 0.0, 1.0, 0.0); } Cairo.cairo_pattern_add_color_stop_rgba (pattern, 0, fromRGB.red / 255f, fromRGB.green / 255f, fromRGB.blue / 255f, data.alpha / 255f); Cairo.cairo_pattern_add_color_stop_rgba (pattern, 1, toRGB.red / 255f, toRGB.green / 255f, toRGB.blue / 255f, data.alpha / 255f); Cairo.cairo_save(cairo); Cairo.cairo_translate(cairo, x, y); Cairo.cairo_scale(cairo, width, height); Cairo.cairo_rectangle(cairo, 0, 0, 1, 1); Cairo.cairo_set_source(cairo, pattern); Cairo.cairo_fill(cairo); Cairo.cairo_restore(cairo); Cairo.cairo_pattern_destroy(pattern); } /** * Fills the interior of an oval, within the specified * rectangular area, with the receiver's background * color. * * @param x the x coordinate of the upper left corner of the oval to be filled * @param y the y coordinate of the upper left corner of the oval to be filled * @param width the width of the oval to be filled * @param height the height of the oval to be filled * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #drawOval */ public void fillOval(int x, int y, int width, int height) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Rectangle rect = DPIUtil.autoScaleUp(drawable, new Rectangle(x, y, width, height)); fillOvalInPixels(rect.x, rect.y, rect.width, rect.height); } void fillOvalInPixels(int x, int y, int width, int height) { checkGC(FILL); if (width < 0) { x = x + width; width = -width; } if (height < 0) { y = y + height; height = -height; } long cairo = data.cairo; if (width == height) { Cairo.cairo_arc_negative(cairo, x + width / 2f, y + height / 2f, width / 2f, 0, 2 * (float)Math.PI); } else { Cairo.cairo_save(cairo); Cairo.cairo_translate(cairo, x + width / 2f, y + height / 2f); Cairo.cairo_scale(cairo, width / 2f, height / 2f); Cairo.cairo_arc_negative(cairo, 0, 0, 1, 0, 2 * (float)Math.PI); Cairo.cairo_restore(cairo); } Cairo.cairo_fill(cairo); } /** * Fills the path described by the parameter. *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* * @param path the path to fill * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the parameter is null
  • *
  • ERROR_INVALID_ARGUMENT - if the parameter has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see Path * * @since 3.1 */ public void fillPath (Path path) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (path == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); if (path.handle == 0) SWT.error(SWT.ERROR_INVALID_ARGUMENT); initCairo(); checkGC(FILL); long cairo = data.cairo; long copy = Cairo.cairo_copy_path(path.handle); if (copy == 0) SWT.error(SWT.ERROR_NO_HANDLES); Cairo.cairo_append_path(cairo, copy); Cairo.cairo_path_destroy(copy); Cairo.cairo_fill(cairo); } /** * Fills the interior of the closed polygon which is defined by the * specified array of integer coordinates, using the receiver's * background color. The array contains alternating x and y values * which are considered to represent points which are the vertices of * the polygon. Lines are drawn between each consecutive pair, and * between the first pair and last pair in the array. * * @param pointArray an array of alternating x and y values which are the vertices of the polygon * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT if pointArray is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #drawPolygon */ public void fillPolygon(int[] pointArray) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (pointArray == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); int [] scaledPointArray = DPIUtil.autoScaleUp(drawable, pointArray); fillPolygonInPixels(scaledPointArray); } void fillPolygonInPixels(int[] pointArray) { checkGC(FILL); long cairo = data.cairo; drawPolyline(cairo, pointArray, true); Cairo.cairo_fill(cairo); } /** * Fills the interior of the rectangle specified by the arguments, * using the receiver's background color. * * @param x the x coordinate of the rectangle to be filled * @param y the y coordinate of the rectangle to be filled * @param width the width of the rectangle to be filled * @param height the height of the rectangle to be filled * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #drawRectangle(int, int, int, int) */ public void fillRectangle(int x, int y, int width, int height) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); fillRectangle(new Rectangle(x, y, width, height)); } void fillRectangleInPixels(int x, int y, int width, int height) { checkGC(FILL); if (width < 0) { x = x + width; width = -width; } if (height < 0) { y = y + height; height = -height; } long cairo = data.cairo; if (data.regionSet != 0) { cairoClipRegion(cairo); } else { Cairo.cairo_rectangle(cairo, x, y, width, height); } Cairo.cairo_fill(cairo); } /** * Fills the interior of the specified rectangle, using the receiver's * background color. * * @param rect the rectangle to be filled * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the rectangle is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #drawRectangle(int, int, int, int) */ public void fillRectangle(Rectangle rect) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (rect == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); fillRectangleInPixels(DPIUtil.autoScaleUp(drawable, rect)); } void fillRectangleInPixels(Rectangle rect) { fillRectangleInPixels(rect.x, rect.y, rect.width, rect.height); } /** * Fills the interior of the round-cornered rectangle specified by * the arguments, using the receiver's background color. * * @param x the x coordinate of the rectangle to be filled * @param y the y coordinate of the rectangle to be filled * @param width the width of the rectangle to be filled * @param height the height of the rectangle to be filled * @param arcWidth the width of the arc * @param arcHeight the height of the arc * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #drawRoundRectangle */ public void fillRoundRectangle(int x, int y, int width, int height, int arcWidth, int arcHeight) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Rectangle rect = DPIUtil.autoScaleUp(drawable, new Rectangle(x, y, width, height)); Point arcSize = DPIUtil.autoScaleUp(drawable, new Point(arcWidth, arcHeight)); fillRoundRectangleInPixels(rect.x, rect.y, rect.width, rect.height, arcSize.x, arcSize.y); } void fillRoundRectangleInPixels(int x, int y, int width, int height, int arcWidth, int arcHeight) { checkGC(FILL); int nx = x; int ny = y; int nw = width; int nh = height; int naw = arcWidth; int nah = arcHeight; if (nw < 0) { nw = 0 - nw; nx = nx - nw; } if (nh < 0) { nh = 0 - nh; ny = ny -nh; } if (naw < 0) naw = 0 - naw; if (nah < 0) nah = 0 - nah; long cairo = data.cairo; if (naw == 0 || nah == 0) { Cairo.cairo_rectangle(cairo, x, y, width, height); } else { float naw2 = naw / 2f; float nah2 = nah / 2f; float fw = nw / naw2; float fh = nh / nah2; Cairo.cairo_save(cairo); Cairo.cairo_translate(cairo, nx, ny); Cairo.cairo_scale(cairo, naw2, nah2); Cairo.cairo_move_to(cairo, fw - 1, 0); Cairo.cairo_arc(cairo, fw - 1, 1, 1, Math.PI + Math.PI/2.0, Math.PI*2.0); Cairo.cairo_arc(cairo, fw - 1, fh - 1, 1, 0, Math.PI/2.0); Cairo.cairo_arc(cairo, 1, fh - 1, 1, Math.PI/2, Math.PI); Cairo.cairo_arc(cairo, 1, 1, 1, Math.PI, 270.0*Math.PI/180.0); Cairo.cairo_close_path(cairo); Cairo.cairo_restore(cairo); } Cairo.cairo_fill(cairo); } int fixMnemonic (char [] buffer) { int i=0, j=0; int mnemonic=-1; while (i < buffer.length) { if ((buffer [j++] = buffer [i++]) == '&') { if (i == buffer.length) {continue;} if (buffer [i] == '&') {i++; continue;} if (mnemonic == -1) mnemonic = j; j--; } } while (j < buffer.length) buffer [j++] = 0; return mnemonic; } /** * Returns the advance width of the specified character in * the font which is currently selected into the receiver. *

* The advance width is defined as the horizontal distance the cursor * should move after printing the character in the selected font. *

* * @param ch the character to measure * @return the distance in the x direction to move past the character before painting the next * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public int getAdvanceWidth(char ch) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); //BOGUS return stringExtentInPixels(new String(new char[]{ch})).x; } /** * Returns true if receiver is using the operating system's * advanced graphics subsystem. Otherwise, false is returned * to indicate that normal graphics are in use. *

* Advanced graphics may not be installed for the operating system. In this * case, false is always returned. Some operating system have * only one graphics subsystem. If this subsystem supports advanced graphics, * then true is always returned. If any graphics operation such * as alpha, antialias, patterns, interpolation, paths, clipping or transformation * has caused the receiver to switch from regular to advanced graphics mode, * true is returned. If the receiver has been explicitly switched * to advanced mode and this mode is supported, true is returned. *

* * @return the advanced value * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #setAdvanced * * @since 3.1 */ public boolean getAdvanced() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.cairo != 0; } /** * Returns the receiver's alpha value. The alpha value * is between 0 (transparent) and 255 (opaque). * * @return the alpha value * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public int getAlpha() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.alpha; } /** * Returns the receiver's anti-aliasing setting value, which will be * one of SWT.DEFAULT, SWT.OFF or * SWT.ON. Note that this controls anti-aliasing for all * non-text drawing operations. * * @return the anti-aliasing setting * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #getTextAntialias * * @since 3.1 */ public int getAntialias() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.cairo == 0) return SWT.DEFAULT; int antialias = Cairo.cairo_get_antialias(data.cairo); switch (antialias) { case Cairo.CAIRO_ANTIALIAS_DEFAULT: return SWT.DEFAULT; case Cairo.CAIRO_ANTIALIAS_NONE: return SWT.OFF; case Cairo.CAIRO_ANTIALIAS_GRAY: case Cairo.CAIRO_ANTIALIAS_SUBPIXEL: return SWT.ON; } return SWT.DEFAULT; } /** * Returns the background color. * * @return the receiver's background color * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public Color getBackground() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return Color.gtk_new(data.device, data.backgroundRGBA); } /** * Returns the background pattern. The default value is * null. * * @return the receiver's background pattern * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see Pattern * * @since 3.1 */ public Pattern getBackgroundPattern() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.backgroundPattern; } /** * Returns the width of the specified character in the font * selected into the receiver. *

* The width is defined as the space taken up by the actual * character, not including the leading and tailing whitespace * or overhang. *

* * @param ch the character to measure * @return the width of the character * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public int getCharWidth(char ch) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); //BOGUS return stringExtentInPixels(new String(new char[]{ch})).x; } /** * Returns the bounding rectangle of the receiver's clipping * region. If no clipping region is set, the return value * will be a rectangle which covers the entire bounds of the * object the receiver is drawing on. * * @return the bounding rectangle of the clipping region * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public Rectangle getClipping() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return DPIUtil.autoScaleDown(drawable, getClippingInPixels()); } Rectangle getClippingInPixels() { /* Calculate visible bounds in device space */ int x = 0, y = 0, width = 0, height = 0; int[] w = new int[1], h = new int[1]; getSize(w, h); width = w[0]; height = h[0]; /* Intersect visible bounds with clipping in device space and then convert then to user space */ long cairo = data.cairo; long clipRgn = data.clipRgn; long damageRgn = data.damageRgn; if (clipRgn != 0 || damageRgn != 0 || cairo != 0) { long rgn = Cairo.cairo_region_create(); cairo_rectangle_int_t rect = new cairo_rectangle_int_t(); rect.width = width; rect.height = height; Cairo.cairo_region_union_rectangle(rgn, rect); if (damageRgn != 0) { Cairo.cairo_region_intersect (rgn, damageRgn); } /* Intersect visible bounds with clipping */ if (clipRgn != 0) { /* Convert clipping to device space if needed */ if (!Arrays.equals(data.clippingTransform, currentTransform)) { double[] clippingTransform; if (currentTransform != null && data.clippingTransform == null) { /* * User actions in this case are: * 1. Set clipping. * 2. Set a transformation B. * * The clipping was specified before transformation B was set. * So to convert it to the new space, we just invert the transformation B. */ clippingTransform = currentTransform.clone(); Cairo.cairo_matrix_invert(clippingTransform); } else if (currentTransform != null && data.clippingTransform != null) { /* * User actions in this case are: * 1. Set a transformation A. * 2. Set clipping. * 3. Set a different transformation B. This is global and wipes out transformation A. * * Since step 3. wipes out transformation A, we must apply A on the clipping rectangle to have * the correct clipping rectangle after transformation A is wiped. * Then, we apply the inverted transformation B on the resulting clipping, * to convert it to the new space (which results after applying B). */ clippingTransform = new double[6]; double[] invertedCurrentTransform = currentTransform.clone(); Cairo.cairo_matrix_invert(invertedCurrentTransform); Cairo.cairo_matrix_multiply(clippingTransform, data.clippingTransform, invertedCurrentTransform); } else { /* * User actions in this case are: * 1. Set a transformation A. * 2. Set clipping. * 3. Wipe the transformation A (i.e. call GC.setTransformation(A)). * * We must apply transformation A on the clipping, to convert it to the new space. */ clippingTransform = data.clippingTransform.clone(); } long oldRgn = rgn; rgn = convertRgn(rgn, clippingTransform); Cairo.cairo_region_destroy(oldRgn); clipRgn = convertRgn(clipRgn, clippingTransform); Cairo.cairo_region_intersect(rgn, clipRgn); Cairo.cairo_region_destroy(clipRgn); } else { Cairo.cairo_region_intersect(rgn, clipRgn); } } Cairo.cairo_region_get_extents(rgn, rect); Cairo.cairo_region_destroy(rgn); x = rect.x; y = rect.y; width = rect.width; height = rect.height; } return new Rectangle(x, y, width, height); } /** * Sets the region managed by the argument to the current * clipping region of the receiver. * * @param region the region to fill with the clipping region * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the region is null
  • *
  • ERROR_INVALID_ARGUMENT - if the region is disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void getClipping(Region region) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (region == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); if (region.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); long clipping = region.handle; Cairo.cairo_region_subtract(clipping, clipping); long clipRgn = data.clipRgn; if (clipRgn == 0) { cairo_rectangle_int_t rect = new cairo_rectangle_int_t(); int[] width = new int[1], height = new int[1]; getSize(width, height); rect.width = width[0]; rect.height = height[0]; Cairo.cairo_region_union_rectangle(clipping, rect); } else { Cairo.cairo_region_union(clipping, clipRgn); } if (data.damageRgn != 0) { Cairo.cairo_region_intersect(clipping, data.damageRgn); } } /** * Returns the receiver's fill rule, which will be one of * SWT.FILL_EVEN_ODD or SWT.FILL_WINDING. * * @return the receiver's fill rule * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public int getFillRule() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); long cairo = data.cairo; if (cairo == 0) return SWT.FILL_EVEN_ODD; return Cairo.cairo_get_fill_rule(cairo) == Cairo.CAIRO_FILL_RULE_WINDING ? SWT.FILL_WINDING : SWT.FILL_EVEN_ODD; } /** * Returns the font currently being used by the receiver * to draw and measure text. * * @return the receiver's font * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public Font getFont() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.font; } /** * Returns a FontMetrics which contains information * about the font currently being used by the receiver * to draw and measure text. * * @return font metrics for the receiver's font * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public FontMetrics getFontMetrics() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.context == 0) createLayout(); checkGC(FONT); Font font = data.font; long context = data.context; long lang = OS.pango_context_get_language(context); long metrics = OS.pango_context_get_metrics(context, font.handle, lang); FontMetrics fm = new FontMetrics(); int ascent = OS.pango_font_metrics_get_ascent(metrics); int descent = OS.pango_font_metrics_get_descent(metrics); int ascentInPoints = DPIUtil.autoScaleDown(drawable, OS.PANGO_PIXELS(ascent)); fm.ascentInPoints = ascentInPoints; int heightInPoints = DPIUtil.autoScaleDown(drawable, OS.PANGO_PIXELS(ascent + descent)); fm.descentInPoints = heightInPoints - ascentInPoints; fm.averageCharWidthInPoints = DPIUtil.autoScaleDown(drawable, OS.PANGO_PIXELS(OS.pango_font_metrics_get_approximate_char_width(metrics))); OS.pango_font_metrics_unref(metrics); return fm; } /** * Returns the receiver's foreground color. * * @return the color used for drawing foreground things * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public Color getForeground() { if (handle == 0) SWT.error(SWT.ERROR_WIDGET_DISPOSED); return Color.gtk_new(data.device, data.foregroundRGBA); } /** * Returns the foreground pattern. The default value is * null. * * @return the receiver's foreground pattern * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see Pattern * * @since 3.1 */ public Pattern getForegroundPattern() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.foregroundPattern; } /** * Returns the GCData. *

* IMPORTANT: This method is not part of the public * API for GC. It is marked public only so that it * can be shared within the packages provided by SWT. It is not * available on all platforms, and should never be called from * application code. *

* * @return the receiver's GCData * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see GCData * * @noreference This method is not intended to be referenced by clients. * * @since 3.2 */ public GCData getGCData() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data; } /** * Returns the receiver's interpolation setting, which will be one of * SWT.DEFAULT, SWT.NONE, * SWT.LOW or SWT.HIGH. * * @return the receiver's interpolation setting * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public int getInterpolation() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.interpolation; } /** * Returns the receiver's line attributes. * * @return the line attributes used for drawing lines * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.3 */ public LineAttributes getLineAttributes() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); LineAttributes attributes = getLineAttributesInPixels(); attributes.width = DPIUtil.autoScaleDown(drawable, attributes.width); return attributes; } LineAttributes getLineAttributesInPixels() { float[] dashes = null; if (data.lineDashes != null) { dashes = new float[data.lineDashes.length]; System.arraycopy(data.lineDashes, 0, dashes, 0, dashes.length); } return new LineAttributes(data.lineWidth, data.lineCap, data.lineJoin, data.lineStyle, dashes, data.lineDashesOffset, data.lineMiterLimit); } /** * Returns the receiver's line cap style, which will be one * of the constants SWT.CAP_FLAT, SWT.CAP_ROUND, * or SWT.CAP_SQUARE. * * @return the cap style used for drawing lines * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public int getLineCap() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.lineCap; } /** * Returns the receiver's line dash style. The default value is * null. * * @return the line dash style used for drawing lines * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public int[] getLineDash() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.lineDashes == null) return null; int[] lineDashes = new int[data.lineDashes.length]; for (int i = 0; i < lineDashes.length; i++) { lineDashes[i] = (int)data.lineDashes[i]; } return lineDashes; } /** * Returns the receiver's line join style, which will be one * of the constants SWT.JOIN_MITER, SWT.JOIN_ROUND, * or SWT.JOIN_BEVEL. * * @return the join style used for drawing lines * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public int getLineJoin() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.lineJoin; } /** * Returns the receiver's line style, which will be one * of the constants SWT.LINE_SOLID, SWT.LINE_DASH, * SWT.LINE_DOT, SWT.LINE_DASHDOT or * SWT.LINE_DASHDOTDOT. * * @return the style used for drawing lines * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public int getLineStyle() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.lineStyle; } /** * Returns the width that will be used when drawing lines * for all of the figure drawing operations (that is, * drawLine, drawRectangle, * drawPolyline, and so forth. * * @return the receiver's line width * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public int getLineWidth() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return (int)DPIUtil.autoScaleDown(drawable, data.lineWidth); } int getLineWidthInPixels() { return (int)data.lineWidth; } /** * Returns the receiver's style information. *

* Note that the value which is returned by this method may * not match the value which was provided to the constructor * when the receiver was created. This can occur when the underlying * operating system does not support a particular combination of * requested styles. *

* * @return the style bits * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 2.1.2 */ public int getStyle () { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.style; } void getSize(int[] width, int[] height) { if (data.width != -1 && data.height != -1) { width[0] = data.width; height[0] = data.height; return; } if (data.drawable != 0) { if (GTK.GTK4) { width[0] = GDK.gdk_surface_get_width(data.drawable); height[0] = GDK.gdk_surface_get_height(data.drawable); } else { width[0] = GDK.gdk_window_get_width(data.drawable); height[0] = GDK.gdk_window_get_height(data.drawable); } return; } long surface = Cairo.cairo_get_target(handle); switch (Cairo.cairo_surface_get_type(surface)) { case Cairo.CAIRO_SURFACE_TYPE_IMAGE: width[0] = Cairo.cairo_image_surface_get_width(surface); height[0] = Cairo.cairo_image_surface_get_height(surface); break; case Cairo.CAIRO_SURFACE_TYPE_XLIB: width[0] = Cairo.cairo_xlib_surface_get_width(surface); height[0] = Cairo.cairo_xlib_surface_get_height(surface); break; } } /** * Returns the receiver's text drawing anti-aliasing setting value, * which will be one of SWT.DEFAULT, SWT.OFF or * SWT.ON. Note that this controls anti-aliasing * only for text drawing operations. * * @return the anti-aliasing setting * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #getAntialias * * @since 3.1 */ public int getTextAntialias() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.cairo == 0) return SWT.DEFAULT; int antialias = Cairo.CAIRO_ANTIALIAS_DEFAULT; if (data.context != 0) { long options = OS.pango_cairo_context_get_font_options(data.context); if (options != 0) antialias = Cairo.cairo_font_options_get_antialias(options); } switch (antialias) { case Cairo.CAIRO_ANTIALIAS_DEFAULT: return SWT.DEFAULT; case Cairo.CAIRO_ANTIALIAS_NONE: return SWT.OFF; case Cairo.CAIRO_ANTIALIAS_GRAY: case Cairo.CAIRO_ANTIALIAS_SUBPIXEL: return SWT.ON; } return SWT.DEFAULT; } /** * Sets the parameter to the transform that is currently being * used by the receiver. * * @param transform the destination to copy the transform into * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the parameter is null
  • *
  • ERROR_INVALID_ARGUMENT - if the parameter has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see Transform * * @since 3.1 */ public void getTransform(Transform transform) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (transform == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); if (transform.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); long cairo = data.cairo; if (cairo != 0) { /* * The client wants to know the relative transformation they set for their widgets. * They do not want to know about the global coordinates of their widget, which is contained in Cairo.cairo_get_matrix(). * So we return whatever the client specified with setTransform. */ if (currentTransform != null) { transform.handle = currentTransform.clone(); } else { transform.handle = new double[] { 1.0, 0.0, 0.0, 1.0, 0.0, 0.0 }; } } else { transform.setElements(1, 0, 0, 1, 0, 0); } } /** * Returns true if this GC is drawing in the mode * where the resulting color in the destination is the * exclusive or of the color values in the source * and the destination, and false if it is * drawing in the mode where the destination color is being * replaced with the source color value. * * @return true true if the receiver is in XOR mode, and false otherwise * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public boolean getXORMode() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.xorMode; } /** * Returns an integer hash code for the receiver. Any two * objects that return true when passed to * equals must return the same value for this * method. * * @return the receiver's hash * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #equals */ @Override public int hashCode() { return (int)handle; } double[] identity() { double[] identity = new double[6]; if ((data.style & SWT.MIRRORED) != 0) { int[] w = new int[1], h = new int[1]; getSize(w, h); Cairo.cairo_matrix_init(identity, -1, 0, 0, 1, w[0], 0); } else { Cairo.cairo_matrix_init_identity(identity); } if (data.identity != null) { Cairo.cairo_matrix_multiply(identity, data.identity, identity); } return identity; } void init(Drawable drawable, GCData data, long gdkGC) { if (data.foregroundRGBA != null) data.state &= ~FOREGROUND; if (data.backgroundRGBA != null) data.state &= ~(BACKGROUND | BACKGROUND_BG); if (data.font != null) data.state &= ~FONT; Image image = data.image; if (image != null) { image.memGC = this; /* * The transparent pixel mask might change when drawing on * the image. Destroy it so that it is regenerated when * necessary. */ if (image.transparentPixel != -1) image.destroyMask(); } this.drawable = drawable; this.data = data; handle = gdkGC; long cairo = data.cairo = handle; Cairo.cairo_set_fill_rule(cairo, Cairo.CAIRO_FILL_RULE_EVEN_ODD); data.state &= ~(BACKGROUND | FOREGROUND | FONT | LINE_WIDTH | LINE_CAP | LINE_JOIN | LINE_STYLE | DRAW_OFFSET); setClipping(data.clipRgn); initCairo(); if ((data.style & SWT.MIRRORED) != 0) { // Don't overwrite the Cairo transformation matrix in GTK 3.14 and above; it contains a translation relative to the parent widget. int[] w = new int[1], h = new int[1]; getSize(w, h); Cairo.cairo_translate(cairo, w[0], 0); Cairo.cairo_scale(cairo, -1.0, 1.0); } if (cairoTransformationMatrix == null) cairoTransformationMatrix = new double[6]; Cairo.cairo_get_matrix(data.cairo, cairoTransformationMatrix); clipping = getClipping(); } void initCairo() { long cairo = data.cairo; if (cairo != 0) return; if (GTK.GTK4) { long surface = Cairo.cairo_image_surface_create(Cairo.CAIRO_FORMAT_A8, data.width, data.height); data.cairo = cairo = Cairo.cairo_create(surface); } else { data.cairo = cairo = Cairo.cairo_create(data.drawable); } if (cairo == 0) SWT.error(SWT.ERROR_NO_HANDLES); data.disposeCairo = true; Cairo.cairo_set_fill_rule(cairo, Cairo.CAIRO_FILL_RULE_EVEN_ODD); data.state &= ~(BACKGROUND | FOREGROUND | FONT | LINE_WIDTH | LINE_CAP | LINE_JOIN | LINE_STYLE | DRAW_OFFSET); setCairoClip(data.damageRgn, data.clipRgn); } void computeStringSize() { int[] width = new int[1], height = new int[1]; OS.pango_layout_get_pixel_size(data.layout, width, height); data.stringHeight = height[0]; data.stringWidth = width[0]; } /** * Returns true if the receiver has a clipping * region set into it, and false otherwise. * If this method returns false, the receiver will draw on all * available space in the destination. If it returns true, * it will draw only in the area that is covered by the region * that can be accessed with getClipping(region). * * @return true if the GC has a clipping region, and false otherwise * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public boolean isClipped() { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); return data.clipRgn != 0; } /** * Returns true if the GC has been disposed, * and false otherwise. *

* This method gets the dispose state for the GC. * When a GC has been disposed, it is an error to * invoke any other method (except {@link #dispose()}) using the GC. * * @return true when the GC is disposed and false otherwise */ @Override public boolean isDisposed() { return handle == 0; } boolean isIdentity(double[] matrix) { if (matrix == null) return true; return matrix[0] == 1 && matrix[1] == 0 && matrix[2] == 0 && matrix[3] == 1 && matrix[4] == 0 && matrix[5] == 0; } /** * Sets the receiver to always use the operating system's advanced graphics * subsystem for all graphics operations if the argument is true. * If the argument is false, the advanced graphics subsystem is * no longer used, advanced graphics state is cleared and the normal graphics * subsystem is used from now on. *

* Normally, the advanced graphics subsystem is invoked automatically when * any one of the alpha, antialias, patterns, interpolation, paths, clipping * or transformation operations in the receiver is requested. When the receiver * is switched into advanced mode, the advanced graphics subsystem performs both * advanced and normal graphics operations. Because the two subsystems are * different, their output may differ. Switching to advanced graphics before * any graphics operations are performed ensures that the output is consistent. *

* Advanced graphics may not be installed for the operating system. In this * case, this operation does nothing. Some operating system have only one * graphics subsystem, so switching from normal to advanced graphics does * nothing. However, switching from advanced to normal graphics will always * clear the advanced graphics state, even for operating systems that have * only one graphics subsystem. *

* * @param advanced the new advanced graphics state * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @see #setAlpha * @see #setAntialias * @see #setBackgroundPattern * @see #setClipping(Path) * @see #setForegroundPattern * @see #setLineAttributes * @see #setInterpolation * @see #setTextAntialias * @see #setTransform * @see #getAdvanced * * @since 3.1 */ public void setAdvanced(boolean advanced) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (!advanced) { setAlpha(0xFF); setAntialias(SWT.DEFAULT); setBackgroundPattern(null); resetClipping(); setForegroundPattern(null); setInterpolation(SWT.DEFAULT); setTextAntialias(SWT.DEFAULT); setTransform(null); } } /** * Sets the receiver's alpha value which must be * between 0 (transparent) and 255 (opaque). *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* @param alpha the alpha value * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see #getAdvanced * @see #setAdvanced * * @since 3.1 */ public void setAlpha(int alpha) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.cairo == 0 && (alpha & 0xff) == 0xff) return; initCairo(); data.alpha = alpha & 0xff; data.state &= ~(BACKGROUND | FOREGROUND | BACKGROUND_BG); } /** * Sets the receiver's anti-aliasing value to the parameter, * which must be one of SWT.DEFAULT, SWT.OFF * or SWT.ON. Note that this controls anti-aliasing for all * non-text drawing operations. *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* * @param antialias the anti-aliasing setting * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the parameter is not one of SWT.DEFAULT, * SWT.OFF or SWT.ON
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see #getAdvanced * @see #setAdvanced * @see #setTextAntialias * * @since 3.1 */ public void setAntialias(int antialias) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.cairo == 0 && antialias == SWT.DEFAULT) return; int mode = 0; switch (antialias) { case SWT.DEFAULT: mode = Cairo.CAIRO_ANTIALIAS_DEFAULT; break; case SWT.OFF: mode = Cairo.CAIRO_ANTIALIAS_NONE; break; case SWT.ON: mode = Cairo.CAIRO_ANTIALIAS_GRAY; break; default: SWT.error(SWT.ERROR_INVALID_ARGUMENT); } initCairo(); long cairo = data.cairo; Cairo.cairo_set_antialias(cairo, mode); } /** * Sets the background color. The background color is used * for fill operations and as the background color when text * is drawn. * * @param color the new background color for the receiver * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the color is null
  • *
  • ERROR_INVALID_ARGUMENT - if the color has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void setBackground(Color color) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (color == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); if (color.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); data.backgroundRGBA = color.handle; data.backgroundPattern = null; data.state &= ~(BACKGROUND | BACKGROUND_BG); } /** * Sets the background pattern. The default value is null. *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* * @param pattern the new background pattern * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the parameter has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see Pattern * @see #getAdvanced * @see #setAdvanced * * @since 3.1 */ public void setBackgroundPattern(Pattern pattern) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (pattern != null && pattern.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); if (data.cairo == 0 && pattern == null) return; initCairo(); if (data.backgroundPattern == pattern) return; data.backgroundPattern = pattern; data.state &= ~BACKGROUND; } static void setCairoFont(long cairo, Font font) { if (font == null || font.isDisposed()) return; setCairoFont(cairo, font.handle); } static void setCairoFont(long cairo, long font) { long family = OS.pango_font_description_get_family(font); int length = C.strlen(family); byte[] buffer = new byte[length + 1]; C.memmove(buffer, family, length); //TODO - convert font height from pango to cairo double height = OS.PANGO_PIXELS(OS.pango_font_description_get_size(font)) * 96 / 72; int pangoStyle = OS.pango_font_description_get_style(font); int pangoWeight = OS.pango_font_description_get_weight(font); int slant = Cairo.CAIRO_FONT_SLANT_NORMAL; if (pangoStyle == OS.PANGO_STYLE_ITALIC) slant = Cairo.CAIRO_FONT_SLANT_ITALIC; if (pangoStyle == OS.PANGO_STYLE_OBLIQUE) slant = Cairo.CAIRO_FONT_SLANT_OBLIQUE; int weight = Cairo.CAIRO_FONT_WEIGHT_NORMAL; if (pangoWeight == OS.PANGO_WEIGHT_BOLD) weight = Cairo.CAIRO_FONT_WEIGHT_BOLD; Cairo.cairo_select_font_face(cairo, buffer, slant, weight); Cairo.cairo_set_font_size(cairo, height); } static void setCairoRegion(long cairo, long rgn) { GDK.gdk_cairo_region(cairo, rgn); } static void setCairoPatternColor(long pattern, int offset, Color c, int alpha) { GdkRGBA rgba = c.handle; Cairo.cairo_pattern_add_color_stop_rgba(pattern, offset, rgba.red, rgba.green, rgba.blue, alpha / 255f); } void setCairoClip(long damageRgn, long clipRgn) { long cairo = data.cairo; Cairo.cairo_reset_clip(cairo); if (damageRgn != 0) { double[] matrix = new double[6]; Cairo.cairo_get_matrix(cairo, matrix); double[] identity = new double[6]; Cairo.cairo_matrix_init_identity(identity); Cairo.cairo_set_matrix(cairo, identity); setCairoRegion(cairo, damageRgn); Cairo.cairo_clip(cairo); Cairo.cairo_set_matrix(cairo, matrix); } if (clipRgn != 0) { long clipRgnCopy = Cairo.cairo_region_create(); Cairo.cairo_region_union(clipRgnCopy, clipRgn); /* * Bug 531667: widgets paint over other widgets * * The Cairo handle is shared by all widgets, but GC.setClipping allows global clipping changes. * So we intersect whatever the client sets with the initial GC clipping. */ limitClipping(clipRgnCopy); setCairoRegion(cairo, clipRgnCopy); Cairo.cairo_clip(cairo); Cairo.cairo_region_destroy(clipRgnCopy); } } /** * Intersects given clipping with original clipping of this context, so * that resulting clip does not allow to paint outside of the GC bounds. */ private void limitClipping(long gcClipping) { Region clippingRegion = new Region(); if (currentTransform != null) { // we want to apply GC clipping stored in init() as is, so we invert user transformations that may distort it double[] invertedCurrentTransform = currentTransform.clone(); Cairo.cairo_matrix_invert(invertedCurrentTransform); int[] clippingWithoutUserTransform = transformRectangle(invertedCurrentTransform, clipping); /* Bug 540908: limiting clipping is very slow if client uses a transformation * Check if client transformation has no rotation, then use Region.add(Rectangle) as its much faster than Region.add(int[]) */ if (hasNoRotation(invertedCurrentTransform)) { Rectangle rectangle = getTransformedClippingRectangle(clippingWithoutUserTransform); clippingRegion.add(rectangle); } else { clippingRegion.add(clippingWithoutUserTransform); } } else { clippingRegion.add(clipping); } Cairo.cairo_region_intersect(gcClipping, clippingRegion.handle); clippingRegion.dispose(); } /** * Transforms rectangle with given matrix * * @return transformed rectangle corner coordinates, with x,y order of points. */ private static int[] transformRectangle(double[] affineTransformation, Rectangle rectangle) { Point[] endPoints = { new Point(rectangle.x , rectangle.y ), new Point(rectangle.x + rectangle.width, rectangle.y ), new Point(rectangle.x + rectangle.width, rectangle.y + rectangle.height), new Point(rectangle.x , rectangle.y + rectangle.height), }; return transformPoints(affineTransformation, endPoints); } /** * Transforms x,y coordinate pairs with given matrix * * @return transformed x,y coordinates. */ private static int[] transformPoints(double[] transformation, Point[] points) { int[] transformedPoints = new int[points.length * 2]; double[] px = new double[1], py = new double[1]; for (int i = 0; i < points.length; ++i) { px[0] = points[i].x; py[0] = points[i].y; Cairo.cairo_matrix_transform_point(transformation, px, py); transformedPoints[(i * 2) + 0] = (int) Math.round(px[0]); transformedPoints[(i * 2) + 1] = (int) Math.round(py[0]); } return transformedPoints; } private static boolean hasNoRotation(double[] matrix) { /* Indices in the matrix are: (m11 m12 d1) * 0: m11, 1: m12, 2: m21, 3: m22, 4: d1, 5: d2 (m21 m22 d2) */ double m12 = matrix[1]; double m21 = matrix[2]; return m12 == 0.0 && m21 == 0.0; } /* input must be ordered the ordered points of a rectangle: * pointsArray = {x1, y1, x2, y2, x3, y3, x4, y4} * with lines (x1,y1) to (x2,y2), (x2,y2) to (x3,y3), (x3,y3) to (x4,y4), (x4,y4) to (x1,y1) * the lines must be parallel or orthogonal to the x resp. y axis */ private static Rectangle getTransformedClippingRectangle(int[] pointsArray) { int x1 = pointsArray[0]; int y1 = pointsArray[1]; int x2 = pointsArray[2]; int y2 = pointsArray[3]; int x3 = pointsArray[4]; int y3 = pointsArray[5]; int x4 = pointsArray[6]; int y4 = pointsArray[7]; // (x,y) is bottom left corner, so we need minimum x and y coordinates int x = Math.min(Math.min(x1, x2), Math.min(x3, x4)); int y = Math.min(Math.min(y1, y2), Math.min(y3, y4)); int width = Math.abs(x1 - x2); int height = Math.abs(y1 - y4); Rectangle r = new Rectangle(x, y, width, height); return r; } void setClipping(long clipRgn) { if (clipRgn == 0) { if (data.clipRgn != 0) { Cairo.cairo_region_destroy(data.clipRgn); data.clipRgn = 0; } data.clippingTransform = null; setCairoClip(data.damageRgn, 0); } else { if (data.clipRgn == 0) data.clipRgn = Cairo.cairo_region_create(); Cairo.cairo_region_subtract(data.clipRgn, data.clipRgn); Cairo.cairo_region_union(data.clipRgn, clipRgn); if (currentTransform != null) { // store the current transformation, to use it when the user requests clipping bounds data.clippingTransform = currentTransform.clone(); } else { data.clippingTransform = null; } setCairoClip(data.damageRgn, clipRgn); } } /** * Sets the area of the receiver which can be changed * by drawing operations to the rectangular area specified * by the arguments. * * @param x the x coordinate of the clipping rectangle * @param y the y coordinate of the clipping rectangle * @param width the width of the clipping rectangle * @param height the height of the clipping rectangle * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void setClipping(int x, int y, int width, int height) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); setClippingInPixels(DPIUtil.autoScaleUp(drawable, x), DPIUtil.autoScaleUp(drawable, y), DPIUtil.autoScaleUp(drawable, width), DPIUtil.autoScaleUp(drawable, height)); } void setClippingInPixels(int x, int y, int width, int height) { if (width < 0) { x = x + width; width = -width; } if (height < 0) { y = y + height; height = -height; } cairo_rectangle_int_t rect = new cairo_rectangle_int_t(); rect.x = x; rect.y = y; rect.width = width; rect.height = height; long clipRgn = Cairo.cairo_region_create(); Cairo.cairo_region_union_rectangle(clipRgn, rect); setClipping(clipRgn); Cairo.cairo_region_destroy(clipRgn); } /** * Sets the area of the receiver which can be changed * by drawing operations to the path specified * by the argument. *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* * @param path the clipping path. * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the path has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see Path * @see #getAdvanced * @see #setAdvanced * * @since 3.1 */ public void setClipping(Path path) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (path != null && path.isDisposed()) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); resetClipping(); if (path != null) { initCairo(); long cairo = data.cairo; long copy = Cairo.cairo_copy_path(path.handle); if (copy == 0) SWT.error(SWT.ERROR_NO_HANDLES); Cairo.cairo_append_path(cairo, copy); Cairo.cairo_path_destroy(copy); Cairo.cairo_clip(cairo); } } /** * Sets the area of the receiver which can be changed * by drawing operations to the rectangular area specified * by the argument. Specifying null for the * rectangle reverts the receiver's clipping area to its * original value. * * @param rect the clipping rectangle or null * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void setClipping(Rectangle rect) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); setClippingInPixels(DPIUtil.autoScaleUp(drawable, rect)); } void setClippingInPixels(Rectangle rect) { if (rect == null) { resetClipping(); } else { setClippingInPixels(rect.x, rect.y, rect.width, rect.height); } } private void resetClipping() { /* * Bug 531667: widgets paint over other widgets * * The Cairo handle is shared by all widgets, and GC.setClipping(0) allows painting outside the current GC area. * So if we reset any custom clipping we still want to restrict GC operations with the initial GC clipping. */ setClipping(clipping); } /** * Sets the area of the receiver which can be changed * by drawing operations to the region specified * by the argument. Specifying null for the * region reverts the receiver's clipping area to its * original value. * * @param region the clipping region or null * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the region has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void setClipping(Region region) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (region != null && region.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); if (region != null) { setClipping(region.handle); } else { resetClipping(); } } /** * Sets the font which will be used by the receiver * to draw and measure text to the argument. If the * argument is null, then a default font appropriate * for the platform will be used instead. * * @param font the new font for the receiver, or null to indicate a default font * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the font has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void setFont(Font font) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (font != null && font.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); data.font = font != null ? font : data.device.systemFont; data.state &= ~FONT; data.stringWidth = data.stringHeight = -1; } /** * Sets the receiver's fill rule to the parameter, which must be one of * SWT.FILL_EVEN_ODD or SWT.FILL_WINDING. * * @param rule the new fill rule * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the rule is not one of SWT.FILL_EVEN_ODD * or SWT.FILL_WINDING
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public void setFillRule(int rule) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); int cairo_mode = Cairo.CAIRO_FILL_RULE_EVEN_ODD; switch (rule) { case SWT.FILL_WINDING: cairo_mode = Cairo.CAIRO_FILL_RULE_WINDING; break; case SWT.FILL_EVEN_ODD: cairo_mode = Cairo.CAIRO_FILL_RULE_EVEN_ODD; break; default: SWT.error(SWT.ERROR_INVALID_ARGUMENT); } initCairo(); Cairo.cairo_set_fill_rule(data.cairo, cairo_mode); } /** * Sets the foreground color. The foreground color is used * for drawing operations including when text is drawn. * * @param color the new foreground color for the receiver * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the color is null
  • *
  • ERROR_INVALID_ARGUMENT - if the color has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void setForeground(Color color) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (color == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); if (color.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); data.foregroundRGBA = color.handle; data.foregroundPattern = null; data.state &= ~FOREGROUND; } /** * Sets the foreground pattern. The default value is null. *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* @param pattern the new foreground pattern * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the parameter has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see Pattern * @see #getAdvanced * @see #setAdvanced * * @since 3.1 */ public void setForegroundPattern(Pattern pattern) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (pattern != null && pattern.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); if (data.cairo == 0 && pattern == null) return; initCairo(); if (data.foregroundPattern == pattern) return; data.foregroundPattern = pattern; data.state &= ~FOREGROUND; } /** * Sets the receiver's interpolation setting to the parameter, which * must be one of SWT.DEFAULT, SWT.NONE, * SWT.LOW or SWT.HIGH. *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* * @param interpolation the new interpolation setting * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the rule is not one of SWT.DEFAULT, * SWT.NONE, SWT.LOW or SWT.HIGH *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see #getAdvanced * @see #setAdvanced * * @since 3.1 */ public void setInterpolation(int interpolation) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.cairo == 0 && interpolation == SWT.DEFAULT) return; switch (interpolation) { case SWT.DEFAULT: case SWT.NONE: case SWT.LOW: case SWT.HIGH: break; default: SWT.error(SWT.ERROR_INVALID_ARGUMENT); } initCairo(); data.interpolation = interpolation; } /** * Sets the receiver's line attributes. *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* @param attributes the line attributes * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the attributes is null
  • *
  • ERROR_INVALID_ARGUMENT - if any of the line attributes is not valid
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see LineAttributes * @see #getAdvanced * @see #setAdvanced * * @since 3.3 */ public void setLineAttributes(LineAttributes attributes) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (attributes == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); attributes.width = DPIUtil.autoScaleUp(drawable, attributes.width); setLineAttributesInPixels(attributes); } void setLineAttributesInPixels(LineAttributes attributes) { int mask = 0; float lineWidth = attributes.width; if (lineWidth != data.lineWidth) { mask |= LINE_WIDTH | DRAW_OFFSET; } int lineStyle = attributes.style; if (lineStyle != data.lineStyle) { mask |= LINE_STYLE; switch (lineStyle) { case SWT.LINE_SOLID: case SWT.LINE_DASH: case SWT.LINE_DOT: case SWT.LINE_DASHDOT: case SWT.LINE_DASHDOTDOT: break; case SWT.LINE_CUSTOM: if (attributes.dash == null) lineStyle = SWT.LINE_SOLID; break; default: SWT.error(SWT.ERROR_INVALID_ARGUMENT); } } int join = attributes.join; if (join != data.lineJoin) { mask |= LINE_JOIN; switch (join) { case SWT.JOIN_MITER: case SWT.JOIN_ROUND: case SWT.JOIN_BEVEL: break; default: SWT.error(SWT.ERROR_INVALID_ARGUMENT); } } int cap = attributes.cap; if (cap != data.lineCap) { mask |= LINE_CAP; switch (cap) { case SWT.CAP_FLAT: case SWT.CAP_ROUND: case SWT.CAP_SQUARE: break; default: SWT.error(SWT.ERROR_INVALID_ARGUMENT); } } float[] dashes = attributes.dash; float[] lineDashes = data.lineDashes; if (dashes != null && dashes.length > 0) { boolean changed = lineDashes == null || lineDashes.length != dashes.length; for (int i = 0; i < dashes.length; i++) { float dash = dashes[i]; if (dash <= 0) SWT.error(SWT.ERROR_INVALID_ARGUMENT); if (!changed && lineDashes[i] != dash) changed = true; } if (changed) { float[] newDashes = new float[dashes.length]; System.arraycopy(dashes, 0, newDashes, 0, dashes.length); dashes = newDashes; mask |= LINE_STYLE; } else { dashes = lineDashes; } } else { if (lineDashes != null && lineDashes.length > 0) { mask |= LINE_STYLE; } else { dashes = lineDashes; } } float dashOffset = attributes.dashOffset; if (dashOffset != data.lineDashesOffset) { mask |= LINE_STYLE; } float miterLimit = attributes.miterLimit; if (miterLimit != data.lineMiterLimit) { mask |= LINE_MITERLIMIT; } initCairo(); if (mask == 0) return; data.lineWidth = lineWidth; data.lineStyle = lineStyle; data.lineCap = cap; data.lineJoin = join; data.lineDashes = dashes; data.lineDashesOffset = dashOffset; data.lineMiterLimit = miterLimit; data.state &= ~mask; } /** * Sets the receiver's line cap style to the argument, which must be one * of the constants SWT.CAP_FLAT, SWT.CAP_ROUND, * or SWT.CAP_SQUARE. * * @param cap the cap style to be used for drawing lines * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the style is not valid
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public void setLineCap(int cap) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.lineCap == cap) return; switch (cap) { case SWT.CAP_ROUND: case SWT.CAP_FLAT: case SWT.CAP_SQUARE: break; default: SWT.error(SWT.ERROR_INVALID_ARGUMENT); } data.lineCap = cap; data.state &= ~LINE_CAP; } /** * Sets the receiver's line dash style to the argument. The default * value is null. If the argument is not null, * the receiver's line style is set to SWT.LINE_CUSTOM, otherwise * it is set to SWT.LINE_SOLID. * * @param dashes the dash style to be used for drawing lines * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if any of the values in the array is less than or equal 0
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public void setLineDash(int[] dashes) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); float[] lineDashes = data.lineDashes; if (dashes != null && dashes.length > 0) { boolean changed = data.lineStyle != SWT.LINE_CUSTOM || lineDashes == null || lineDashes.length != dashes.length; for (int i = 0; i < dashes.length; i++) { int dash = dashes[i]; if (dash <= 0) SWT.error(SWT.ERROR_INVALID_ARGUMENT); if (!changed && lineDashes[i] != dash) changed = true; } if (!changed) return; data.lineDashes = new float[dashes.length]; for (int i = 0; i < dashes.length; i++) { data.lineDashes[i] = dashes[i]; } data.lineStyle = SWT.LINE_CUSTOM; } else { if (data.lineStyle == SWT.LINE_SOLID && (lineDashes == null || lineDashes.length == 0)) return; data.lineDashes = null; data.lineStyle = SWT.LINE_SOLID; } data.state &= ~LINE_STYLE; } /** * Sets the receiver's line join style to the argument, which must be one * of the constants SWT.JOIN_MITER, SWT.JOIN_ROUND, * or SWT.JOIN_BEVEL. * * @param join the join style to be used for drawing lines * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the style is not valid
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
* * @since 3.1 */ public void setLineJoin(int join) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.lineJoin == join) return; switch (join) { case SWT.JOIN_MITER: case SWT.JOIN_ROUND: case SWT.JOIN_BEVEL: break; default: SWT.error(SWT.ERROR_INVALID_ARGUMENT); } data.lineJoin = join; data.state &= ~LINE_JOIN; } /** * Sets the receiver's line style to the argument, which must be one * of the constants SWT.LINE_SOLID, SWT.LINE_DASH, * SWT.LINE_DOT, SWT.LINE_DASHDOT or * SWT.LINE_DASHDOTDOT. * * @param lineStyle the style to be used for drawing lines * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the style is not valid
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void setLineStyle(int lineStyle) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.lineStyle == lineStyle) return; switch (lineStyle) { case SWT.LINE_SOLID: case SWT.LINE_DASH: case SWT.LINE_DOT: case SWT.LINE_DASHDOT: case SWT.LINE_DASHDOTDOT: break; case SWT.LINE_CUSTOM: if (data.lineDashes == null) lineStyle = SWT.LINE_SOLID; break; default: SWT.error(SWT.ERROR_INVALID_ARGUMENT); } data.lineStyle = lineStyle; data.state &= ~LINE_STYLE; } /** * Sets the width that will be used when drawing lines * for all of the figure drawing operations (that is, * drawLine, drawRectangle, * drawPolyline, and so forth. *

* Note that line width of zero is used as a hint to * indicate that the fastest possible line drawing * algorithms should be used. This means that the * output may be different from line width one and * specially at high DPI it's not recommended to mix * line width zero with other line widths. *

* * @param lineWidth the width of a line * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void setLineWidth(int lineWidth) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); setLineWidthInPixels(DPIUtil.autoScaleUp(drawable, lineWidth)); } void setLineWidthInPixels(int lineWidth) { if (data.lineWidth == lineWidth) return; data.lineWidth = lineWidth; data.state &= ~(LINE_WIDTH | DRAW_OFFSET); } void setString(String string, int flags) { if (data.layout == 0) createLayout(); if (string == data.string && (flags & ~SWT.DRAW_TRANSPARENT) == (data.drawFlags & ~SWT.DRAW_TRANSPARENT)) { return; } byte[] buffer; int mnemonic, length = string.length (); long layout = data.layout; char[] text = new char[length]; string.getChars(0, length, text, 0); if ((flags & SWT.DRAW_MNEMONIC) != 0 && (mnemonic = fixMnemonic(text)) != -1) { char[] text1 = new char[mnemonic - 1]; System.arraycopy(text, 0, text1, 0, text1.length); byte[] buffer1 = Converter.wcsToMbcs(text1, false); char[] text2 = new char[text.length - mnemonic]; System.arraycopy(text, mnemonic - 1, text2, 0, text2.length); byte[] buffer2 = Converter.wcsToMbcs(text2, false); buffer = new byte[buffer1.length + buffer2.length]; System.arraycopy(buffer1, 0, buffer, 0, buffer1.length); System.arraycopy(buffer2, 0, buffer, buffer1.length, buffer2.length); long attr_list = OS.pango_attr_list_new(); long attr = OS.pango_attr_underline_new(OS.PANGO_UNDERLINE_LOW); PangoAttribute attribute = new PangoAttribute(); OS.memmove(attribute, attr, PangoAttribute.sizeof); attribute.start_index = buffer1.length; attribute.end_index = buffer1.length + 1; OS.memmove(attr, attribute, PangoAttribute.sizeof); OS.pango_attr_list_insert(attr_list, attr); OS.pango_layout_set_attributes(layout, attr_list); OS.pango_attr_list_unref(attr_list); } else { buffer = Converter.wcsToMbcs(text, false); OS.pango_layout_set_attributes(layout, 0); } OS.pango_layout_set_text(layout, buffer, buffer.length); OS.pango_layout_set_single_paragraph_mode(layout, (flags & SWT.DRAW_DELIMITER) == 0); OS.pango_layout_set_tabs(layout, (flags & SWT.DRAW_TAB) != 0 ? 0 : data.device.emptyTab); data.string = string; data.stringWidth = data.stringHeight = -1; data.drawFlags = flags; } /** * Sets the receiver's text anti-aliasing value to the parameter, * which must be one of SWT.DEFAULT, SWT.OFF * or SWT.ON. Note that this controls anti-aliasing only * for all text drawing operations. *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* * @param antialias the anti-aliasing setting * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the parameter is not one of SWT.DEFAULT, * SWT.OFF or SWT.ON
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see #getAdvanced * @see #setAdvanced * @see #setAntialias * * @since 3.1 */ public void setTextAntialias(int antialias) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (data.cairo == 0 && antialias == SWT.DEFAULT) return; int mode = 0; switch (antialias) { case SWT.DEFAULT: mode = Cairo.CAIRO_ANTIALIAS_DEFAULT; break; case SWT.OFF: mode = Cairo.CAIRO_ANTIALIAS_NONE; break; case SWT.ON: mode = Cairo.CAIRO_ANTIALIAS_GRAY; break; default: SWT.error(SWT.ERROR_INVALID_ARGUMENT); } initCairo(); long options = Cairo.cairo_font_options_create(); Cairo.cairo_font_options_set_antialias(options, mode); if (data.context == 0) createLayout(); OS.pango_cairo_context_set_font_options(data.context, options); Cairo.cairo_font_options_destroy(options); } /** * Sets the transform that is currently being used by the receiver. If * the argument is null, the current transform is set to * the identity transform. *

* This operation requires the operating system's advanced * graphics subsystem which may not be available on some * platforms. *

* * @param transform the transform to set * * @exception IllegalArgumentException
    *
  • ERROR_INVALID_ARGUMENT - if the parameter has been disposed
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available
  • *
* * @see Transform * @see #getAdvanced * @see #setAdvanced * * @since 3.1 */ public void setTransform(Transform transform) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (transform != null && transform.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); if (data.cairo == 0 && transform == null) return; initCairo(); long cairo = data.cairo; // Re-set the original Cairo transformation matrix: it contains a translation relative to the parent widget. if (currentTransform != null) { Cairo.cairo_set_matrix(cairo, cairoTransformationMatrix); currentTransform = null; } // Apply user transform on top of the current transformation matrix (and remember it) if (transform != null) { currentTransform = transform.handle.clone(); double[] transformMatrix = identity(); Cairo.cairo_matrix_multiply(transformMatrix, transform.handle, transformMatrix); Cairo.cairo_transform(cairo, transformMatrix); } data.state &= ~DRAW_OFFSET; } /** * If the argument is true, puts the receiver * in a drawing mode where the resulting color in the destination * is the exclusive or of the color values in the source * and the destination, and if the argument is false, * puts the receiver in a drawing mode where the destination color * is replaced with the source color value. * * @param xor if true, then xor mode is used, otherwise source copy mode is used * * @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public void setXORMode(boolean xor) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); Cairo.cairo_set_operator(handle, xor ? Cairo.CAIRO_OPERATOR_DIFFERENCE : Cairo.CAIRO_OPERATOR_OVER); data.xorMode = xor; } /** * Returns the extent of the given string. No tab * expansion or carriage return processing will be performed. *

* The extent of a string is the width and height of * the rectangular area it would cover if drawn in a particular * font (in this case, the current font in the receiver). *

* * @param string the string to measure * @return a point containing the extent of the string * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the string is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public Point stringExtent(String string) { return DPIUtil.autoScaleDown(drawable, stringExtentInPixels(string)); } Point stringExtentInPixels(String string) { return textExtentInPixels(string, 0); } /** * Returns the extent of the given string. Tab expansion and * carriage return processing are performed. *

* The extent of a string is the width and height of * the rectangular area it would cover if drawn in a particular * font (in this case, the current font in the receiver). *

* * @param string the string to measure * @return a point containing the extent of the string * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the string is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public Point textExtent(String string) { return DPIUtil.autoScaleDown(drawable, textExtentInPixels(string)); } Point textExtentInPixels(String string) { return textExtentInPixels(string, SWT.DRAW_DELIMITER | SWT.DRAW_TAB); } /** * Returns the extent of the given string. Tab expansion, line * delimiter and mnemonic processing are performed according to * the specified flags, which can be a combination of: *
*
DRAW_DELIMITER
*
draw multiple lines
*
DRAW_TAB
*
expand tabs
*
DRAW_MNEMONIC
*
underline the mnemonic character
*
DRAW_TRANSPARENT
*
transparent background
*
*

* The extent of a string is the width and height of * the rectangular area it would cover if drawn in a particular * font (in this case, the current font in the receiver). *

* * @param string the string to measure * @param flags the flags specifying how to process the text * @return a point containing the extent of the string * * @exception IllegalArgumentException
    *
  • ERROR_NULL_ARGUMENT - if the string is null
  • *
* @exception SWTException
    *
  • ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed
  • *
*/ public Point textExtent(String string, int flags) { if (handle == 0) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); if (string == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); return DPIUtil.autoScaleDown(drawable, textExtentInPixels(string, flags)); } Point textExtentInPixels(String string, int flags) { setString(string, flags); checkGC(FONT); if (data.stringWidth == -1) { computeStringSize(); } return new Point(data.stringWidth, data.stringHeight); } /** * Returns a string containing a concise, human-readable * description of the receiver. * * @return a string representation of the receiver */ @Override public String toString () { if (isDisposed()) return "GC {*DISPOSED*}"; return "GC {" + handle + "}"; } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy