* 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.
*
*
*
* You must dispose the graphics context when it is no longer required.
*
* @param drawable the drawable to draw on
* @exception IllegalArgumentException
* 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 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (image == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
if (image.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT);
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 pixels to copy from the source
* @param srcHeight the height in pixels 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 pixels of the destination rectangle
* @param destHeight the height in pixels 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 == null) 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);
drawImage(image, srcX, srcY, srcWidth, srcHeight, destX, destY, destWidth, destHeight, false);
}
void drawImage(Image srcImage, int srcX, int srcY, int srcWidth, int srcHeight, int destX, int destY, int destWidth, int destHeight, boolean simple) {
NSImage imageHandle = srcImage.handle;
NSSize size = imageHandle.size();
int imgWidth = (int)size.width;
int imgHeight = (int)size.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 || srcY + srcHeight > imgHeight) {
SWT.error(SWT.ERROR_INVALID_ARGUMENT);
}
}
NSAutoreleasePool pool = checkGC(CLIPPING | TRANSFORM);
try {
if (srcImage.memGC != null) {
srcImage.createAlpha();
}
handle.saveGraphicsState();
NSAffineTransform transform = NSAffineTransform.transform();
transform.scaleXBy(1, -1);
transform.translateXBy(0, -(destHeight + 2 * destY));
transform.concat();
NSRect srcRect = new NSRect();
srcRect.x = srcX;
srcRect.y = imgHeight - (srcY + srcHeight);
srcRect.width = srcWidth;
srcRect.height = srcHeight;
NSRect destRect = new NSRect();
destRect.x = destX;
destRect.y = destY;
destRect.width = destWidth;
destRect.height = destHeight;
imageHandle.drawInRect(destRect, srcRect, OS.NSCompositeSourceOver, data.alpha / 255f);
handle.restoreGraphicsState();
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (x1 == x2 && y1 == y2 && data.lineWidth <= 1) {
drawPoint(x1, y1);
return;
}
NSAutoreleasePool pool = checkGC(DRAW);
try {
NSBezierPath path = data.path;
NSPoint pt = new NSPoint();
pt.x = x1 + data.drawXOffset;
pt.y = y1 + data.drawYOffset;
path.moveToPoint(pt);
pt.x = x2 + data.drawXOffset;
pt.y = y2 + data.drawYOffset;
path.lineToPoint(pt);
Pattern pattern = data.foregroundPattern;
if (pattern != null && pattern.gradient != null) {
strokePattern(path, pattern);
} else {
path.stroke();
}
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
/**
* 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
* pixels wide and height + 1 pixels 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
NSAutoreleasePool pool = checkGC(DRAW);
try {
if (width < 0) {
x = x + width;
width = -width;
}
if (height < 0) {
y = y + height;
height = -height;
}
NSBezierPath path = data.path;
NSRect rect = new NSRect();
rect.x = x + data.drawXOffset;
rect.y = y + data.drawXOffset;
rect.width = width;
rect.height = height;
path.appendBezierPathWithOvalInRect(rect);
Pattern pattern = data.foregroundPattern;
if (pattern != null && pattern.gradient != null) {
strokePattern(path, pattern);
} else {
path.stroke();
}
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (path == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
if (path.handle == null) SWT.error(SWT.ERROR_INVALID_ARGUMENT);
NSAutoreleasePool pool = checkGC(DRAW);
try {
handle.saveGraphicsState();
NSAffineTransform transform = NSAffineTransform.transform();
transform.translateXBy(data.drawXOffset, data.drawYOffset);
transform.concat();
NSBezierPath drawPath = data.path;
drawPath.appendBezierPath(path.handle);
Pattern pattern = data.foregroundPattern;
if (pattern != null && pattern.gradient != null) {
strokePattern(drawPath, pattern);
} else {
drawPath.stroke();
}
drawPath.removeAllPoints();
handle.restoreGraphicsState();
} finally {
uncheckGC(pool);
}
}
/**
* Draws a pixel, 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
NSAutoreleasePool pool = checkGC(FOREGROUND_FILL | CLIPPING | TRANSFORM);
try {
NSRect rect = new NSRect();
rect.x = x;
rect.y = y;
rect.width = 1;
rect.height = 1;
NSBezierPath path = data.path;
path.appendBezierPathWithRect(rect);
path.fill();
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (pointArray == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
if (pointArray.length < 4) return;
NSAutoreleasePool pool = checkGC(DRAW);
try {
float /*double*/ xOffset = data.drawXOffset, yOffset = data.drawYOffset;
NSBezierPath path = data.path;
NSPoint pt = new NSPoint();
pt.x = pointArray[0] + xOffset;
pt.y = pointArray[1] + yOffset;
path.moveToPoint(pt);
int end = pointArray.length / 2 * 2;
for (int i = 2; i < end; i+=2) {
pt.x = pointArray[i] + xOffset;
pt.y = pointArray[i+1] + yOffset;
path.lineToPoint(pt);
}
path.closePath();
Pattern pattern = data.foregroundPattern;
if (pattern != null && pattern.gradient != null) {
strokePattern(path, pattern);
} else {
path.stroke();
}
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (pointArray == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
if (pointArray.length < 4) return;
NSAutoreleasePool pool = checkGC(DRAW);
try {
float /*double*/ xOffset = data.drawXOffset, yOffset = data.drawYOffset;
NSBezierPath path = data.path;
NSPoint pt = new NSPoint();
pt.x = pointArray[0] + xOffset;
pt.y = pointArray[1] + yOffset;
path.moveToPoint(pt);
int end = pointArray.length / 2 * 2;
for (int i = 2; i < end; i+=2) {
pt.x = pointArray[i] + xOffset;
pt.y = pointArray[i+1] + yOffset;
path.lineToPoint(pt);
}
Pattern pattern = data.foregroundPattern;
if (pattern != null && pattern.gradient != null) {
strokePattern(path, pattern);
} else {
path.stroke();
}
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
NSAutoreleasePool pool = checkGC(DRAW);
try {
if (width < 0) {
x = x + width;
width = -width;
}
if (height < 0) {
y = y + height;
height = -height;
}
NSRect rect = new NSRect();
rect.x = x + data.drawXOffset;
rect.y = y + data.drawYOffset;
rect.width = width;
rect.height = height;
NSBezierPath path = data.path;
path.appendBezierPathWithRect(rect);
Pattern pattern = data.foregroundPattern;
if (pattern != null && pattern.gradient != null) {
strokePattern(path, pattern);
} else {
path.stroke();
}
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
/**
* 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 (handle == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (rect == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
drawRectangle (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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (arcWidth == 0 || arcHeight == 0) {
drawRectangle(x, y, width, height);
return;
}
NSAutoreleasePool pool = checkGC(DRAW);
try {
NSBezierPath path = data.path;
NSRect rect = new NSRect();
rect.x = x + data.drawXOffset;
rect.y = y + data.drawYOffset;
rect.width = width;
rect.height = height;
path.appendBezierPathWithRoundedRect(rect, arcWidth / 2f, arcHeight / 2f);
Pattern pattern = data.foregroundPattern;
if (pattern != null && pattern.gradient != null) {
strokePattern(path, pattern);
} else {
path.stroke();
}
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
/**
* 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.
*
* @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) {
drawString(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.
*
* @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) {
drawText(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.
*
* @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);
}
/**
* 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.
*
* @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) {
int flags = SWT.DRAW_DELIMITER | SWT.DRAW_TAB;
if (isTransparent) flags |= SWT.DRAW_TRANSPARENT;
drawText(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.
*
* 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) {
if (handle == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (string == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
NSAutoreleasePool pool = checkGC(CLIPPING | TRANSFORM | FONT | FOREGROUND_FILL);
try {
int length = string.length();
if (length == 0) return;
boolean mode = true;
switch (data.textAntialias) {
case SWT.DEFAULT:
/* Printer is off by default */
if (!handle.isDrawingToScreen()) mode = false;
break;
case SWT.OFF: mode = false; break;
case SWT.ON: mode = true; break;
}
handle.saveGraphicsState();
handle.setShouldAntialias(mode);
if (data.textStorage == null) createLayout();
NSAttributedString attribStr = createString(string, flags, true);
data.textStorage.setAttributedString(attribStr);
attribStr.release();
NSPoint pt = new NSPoint();
pt.x = x;
pt.y = y;
if ((flags & SWT.DRAW_TRANSPARENT) == 0) {
data.layoutManager.glyphRangeForTextContainer(data.textContainer);
NSRect rect = data.layoutManager.usedRectForTextContainer(data.textContainer);
rect.x = x;
rect.y = y;
NSColor bg = data.bg;
if (bg == null) {
float /*double*/ [] color = data.background;
bg = data.bg = NSColor.colorWithDeviceRed(color[0], color[1], color[2], data.alpha / 255f);
bg.retain();
}
bg.setFill();
NSBezierPath.fillRect(rect);
}
NSRange range = new NSRange();
range.length = data.layoutManager.numberOfGlyphs();
data.layoutManager.drawGlyphsForGlyphRange(range, pt);
handle.restoreGraphicsState();
} finally {
uncheckGC(pool);
}
}
/**
* 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
*/
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 pixels wide
* by height + 1 pixels 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (width < 0) {
x = x + width;
width = -width;
}
if (height < 0) {
y = y + height;
height = -height;
}
if (width == 0 || height == 0 || arcAngle == 0) return;
NSAutoreleasePool pool = checkGC(FILL);
try {
handle.saveGraphicsState();
NSAffineTransform transform = NSAffineTransform.transform();
float /*double*/ xOffset = data.drawXOffset, yOffset = data.drawYOffset;
transform.translateXBy(x + xOffset + width / 2f, y + yOffset + height / 2f);
transform.scaleXBy(width / 2f, height / 2f);
NSBezierPath path = data.path;
NSPoint center = new NSPoint();
path.moveToPoint(center);
float sAngle = -startAngle;
float eAngle = -(startAngle + arcAngle);
path.appendBezierPathWithArcWithCenter(center, 1, sAngle, eAngle, arcAngle>0);
path.closePath();
path.transformUsingAffineTransform(transform);
Pattern pattern = data.backgroundPattern;
if (pattern != null && pattern.gradient != null) {
fillPattern(path, pattern);
} else {
path.fill();
}
path.removeAllPoints();
handle.restoreGraphicsState();
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if ((width == 0) || (height == 0)) return;
NSAutoreleasePool pool = checkGC(CLIPPING | TRANSFORM);
try {
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;
}
if (fromRGB.equals(toRGB)) {
fillRectangle(x, y, width, height);
} else {
NSColor startingColor = NSColor.colorWithDeviceRed(fromRGB.red / 255f, fromRGB.green / 255f, fromRGB.blue / 255f, data.alpha / 255f);
NSColor endingColor = NSColor.colorWithDeviceRed(toRGB.red / 255f, toRGB.green / 255f, toRGB.blue / 255f, data.alpha / 255f);
NSGradient gradient = ((NSGradient)new NSGradient().alloc()).initWithStartingColor(startingColor, endingColor);
NSRect rect = new NSRect();
rect.x = x;
rect.y = y;
rect.width = width;
rect.height = height;
gradient.drawInRect(rect, vertical ? 90 : 0);
gradient.release();
}
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
NSAutoreleasePool pool = checkGC(FILL);
try {
if (width < 0) {
x = x + width;
width = -width;
}
if (height < 0) {
y = y + height;
height = -height;
}
NSBezierPath path = data.path;
NSRect rect = new NSRect();
rect.x = x;
rect.y = y;
rect.width = width;
rect.height = height;
path.appendBezierPathWithOvalInRect(rect);
Pattern pattern = data.backgroundPattern;
if (pattern != null && pattern.gradient != null) {
fillPattern(path, pattern);
} else {
path.fill();
}
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
void fillPattern(NSBezierPath path, Pattern pattern) {
handle.saveGraphicsState();
path.addClip();
NSRect bounds = path.bounds();
NSPoint start = new NSPoint();
start.x = pattern.pt1.x;
start.y = pattern.pt1.y;
NSPoint end = new NSPoint();
end.x = pattern.pt2.x;
end.y = pattern.pt2.y;
float /*double*/ difx = end.x - start.x;
float /*double*/ dify = end.y - start.y;
if (difx == 0 && dify == 0) {
float /*double*/ [] color = pattern.color1;
NSColor.colorWithDeviceRed(color[0], color[1], color[2], data.alpha / 255f).setFill();
path.fill();
handle.restoreGraphicsState();
return;
}
float /*double*/ startx, starty, endx, endy;
if (difx == 0 || dify == 0) {
startx = bounds.x;
starty = bounds.y;
endx = bounds.x + bounds.width;
endy = bounds.y + bounds.height;
if (difx < 0 || dify < 0) {
startx = endx;
starty = endy;
endx = bounds.x;
endy = bounds.y;
}
} else {
float /*double*/ m = (end.y-start.y)/(end.x - start.x);
float /*double*/ b = end.y - (m * end.x);
float /*double*/ m2 = -1/m; //perpendicular slope
float /*double*/ b2 = bounds.y - (m2 * bounds.x);
startx = endx = (b - b2) / (m2 - m);
b2 = (bounds.y + bounds.height) - (m2 * bounds.x);
float /*double*/ x2 = (b - b2) / (m2 - m);
startx = difx > 0 ? Math.min(startx, x2) : Math.max(startx, x2);
endx = difx < 0 ? Math.min(endx, x2) : Math.max(endx, x2);
b2 = bounds.y - (m2 * (bounds.x + bounds.width));
x2 = (b - b2) / (m2 - m);
startx = difx > 0 ? Math.min(startx, x2) : Math.max(startx, x2);
endx = difx < 0 ? Math.min(endx, x2) : Math.max(endx, x2);
b2 = (bounds.y + bounds.height) - (m2 * (bounds.x + bounds.width));
x2 = (b - b2) / (m2 - m);
startx = difx > 0 ? Math.min(startx, x2) : Math.max(startx, x2);
endx = difx < 0 ? Math.min(endx, x2) : Math.max(endx, x2);
starty = (m * startx) + b;
endy = (m * endx) + b;
}
if (difx != 0) {
while ((difx > 0 && start.x >= startx) || (difx < 0 && start.x <= startx)) {
start.x -= difx;
start.y -= dify;
}
} else {
while ((dify > 0 && start.y >= starty) || (dify < 0 && start.y <= starty)) {
start.x -= difx;
start.y -= dify;
}
}
end.x = start.x;
end.y = start.y;
do {
end.x += difx;
end.y += dify;
pattern.gradient.drawFromPoint(start, end, 0);
start.x = end.x;
start.y = end.y;
} while (
(difx > 0 && end.x <= endx) ||
(difx < 0 && end.x >= endx) ||
(difx == 0 && ((dify > 0 && end.y <= endy) || (dify < 0 && end.y >= endy)))
);
handle.restoreGraphicsState();
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (path == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
if (path.handle == null) SWT.error(SWT.ERROR_INVALID_ARGUMENT);
NSAutoreleasePool pool = checkGC(FILL);
try {
NSBezierPath drawPath = data.path;
drawPath.appendBezierPath(path.handle);
Pattern pattern = data.backgroundPattern;
if (pattern != null && pattern.gradient != null) {
fillPattern(drawPath, pattern);
} else {
drawPath.fill();
}
drawPath.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (pointArray == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
if (pointArray.length < 4) return;
NSAutoreleasePool pool = checkGC(FILL);
try {
NSBezierPath path = data.path;
NSPoint pt = new NSPoint();
pt.x = pointArray[0];
pt.y = pointArray[1];
path.moveToPoint(pt);
int end = pointArray.length / 2 * 2;
for (int i = 2; i < end; i+=2) {
pt.x = pointArray[i];
pt.y = pointArray[i+1];
path.lineToPoint(pt);
}
path.closePath();
Pattern pattern = data.backgroundPattern;
if (pattern != null && pattern.gradient != null) {
fillPattern(path, pattern);
} else {
path.fill();
}
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
NSAutoreleasePool pool = checkGC(FILL);
try {
if (width < 0) {
x = x + width;
width = -width;
}
if (height < 0) {
y = y + height;
height = -height;
}
NSRect rect = new NSRect();
rect.x = x;
rect.y = y;
rect.width = width;
rect.height = height;
NSBezierPath path = data.path;
path.appendBezierPathWithRect(rect);
Pattern pattern = data.backgroundPattern;
if (pattern != null && pattern.gradient != null) {
fillPattern(path, pattern);
} else {
path.fill();
}
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (rect == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
fillRectangle(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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (arcWidth == 0 || arcHeight == 0) {
fillRectangle(x, y, width, height);
return;
}
NSAutoreleasePool pool = checkGC(FILL);
try {
NSBezierPath path = data.path;
NSRect rect = new NSRect();
rect.x = x;
rect.y = y;
rect.width = width;
rect.height = height;
path.appendBezierPathWithRoundedRect(rect, arcWidth / 2f, arcHeight / 2f);
Pattern pattern = data.backgroundPattern;
if (pattern != null && pattern.gradient != null) {
fillPattern(path, pattern);
} else {
path.fill();
}
path.removeAllPoints();
} finally {
uncheckGC(pool);
}
}
void strokePattern(NSBezierPath path, Pattern pattern) {
handle.saveGraphicsState();
int /*long*/ cgPath = createCGPathRef(path);
int /*long*/ cgContext = handle.graphicsPort();
OS.CGContextSaveGState(cgContext);
initCGContext(cgContext);
OS.CGContextAddPath(cgContext, cgPath);
OS.CGContextReplacePathWithStrokedPath(cgContext);
OS.CGPathRelease(cgPath);
cgPath = 0;
cgPath = OS.CGContextCopyPath(cgContext);
if (cgPath == 0) SWT.error(SWT.ERROR_NO_HANDLES);
OS.CGContextRestoreGState(cgContext);
NSBezierPath strokePath = createNSBezierPath(cgPath);
OS.CGPathRelease(cgPath);
fillPattern(strokePath, pattern);
handle.restoreGraphicsState();
}
void flush () {
handle.flushGraphics();
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
//NOT DONE
return stringExtent(new String(new char[]{ch})).x;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
return Color.cocoa_new (data.device, data.background);
}
/**
* 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 == null) SWT.error(SWT.ERROR_WIDGET_DISPOSED);
return data.backgroundPattern;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
return true;
}
/**
* 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 == null) 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
return data.antialias;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
//NOT DONE
return stringExtent(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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
NSAutoreleasePool pool = null;
if (!NSThread.isMainThread()) pool = (NSAutoreleasePool) new NSAutoreleasePool().alloc().init();
try {
NSRect rect = null;
if (data.view != null) {
rect = data.view.visibleRect();
} else {
rect = new NSRect();
if (data.image != null) {
NSSize size = data.image.handle.size();
rect.width = size.width;
rect.height = size.height;
} else if (data.size != null) {
rect.width = data.size.width;
rect.height = data.size.height;
}
}
if (data.paintRect != null || data.clipPath != null || data.inverseTransform != null) {
if (data.paintRect != null) {
OS.NSIntersectionRect(rect, rect, data.paintRect);
}
if (data.clipPath != null) {
NSRect clip = data.clipPath.bounds();
clip.x = (int)clip.x;
clip.y = (int)clip.y;
OS.NSIntersectionRect(rect, rect, clip);
}
if (data.inverseTransform != null && rect.width > 0 && rect.height > 0) {
NSPoint pt = new NSPoint();
pt.x = rect.x;
pt.y = rect.y;
NSSize size = new NSSize();
size.width = rect.width;
size.height = rect.height;
pt = data.inverseTransform.transformPoint(pt);
size = data.inverseTransform.transformSize(size);
rect.x = pt.x;
rect.y = pt.y;
rect.width = size.width;
rect.height = size.height;
}
}
return new Rectangle((int)rect.x, (int)rect.y, (int)rect.width, (int)rect.height);
} finally {
if (pool != null) pool.release();
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (region == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
if (region.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT);
NSAutoreleasePool pool = null;
if (!NSThread.isMainThread()) pool = (NSAutoreleasePool) new NSAutoreleasePool().alloc().init();
try {
region.subtract(region);
NSRect rect = null;
if (data.view != null) {
rect = data.view.visibleRect();
} else {
rect = new NSRect();
if (data.image != null) {
NSSize size = data.image.handle.size();
rect.width = size.width;
rect.height = size.height;
} else if (data.size != null) {
rect.width = data.size.width;
rect.height = data.size.height;
}
}
region.add((int)rect.x, (int)rect.y, (int)rect.width, (int)rect.height);
NSRect paintRect = data.paintRect;
if (paintRect != null) {
region.intersect((int)paintRect.x, (int)paintRect.y, (int)paintRect.width, (int)paintRect.height);
}
if (data.clipPath != null) {
NSBezierPath clip = data.clipPath.bezierPathByFlatteningPath();
int count = (int)/*64*/clip.elementCount();
int pointCount = 0;
Region clipRgn = new Region(device);
int[] pointArray = new int[count * 2];
int /*long*/ points = OS.malloc(NSPoint.sizeof);
if (points == 0) SWT.error(SWT.ERROR_NO_HANDLES);
NSPoint pt = new NSPoint();
for (int i = 0; i < count; i++) {
int element = (int)/*64*/clip.elementAtIndex(i, points);
switch (element) {
case OS.NSMoveToBezierPathElement:
if (pointCount != 0) clipRgn.add(pointArray, pointCount);
pointCount = 0;
OS.memmove(pt, points, NSPoint.sizeof);
pointArray[pointCount++] = (int)pt.x;
pointArray[pointCount++] = (int)pt.y;
break;
case OS.NSLineToBezierPathElement:
OS.memmove(pt, points, NSPoint.sizeof);
pointArray[pointCount++] = (int)pt.x;
pointArray[pointCount++] = (int)pt.y;
break;
case OS.NSClosePathBezierPathElement:
if (pointCount != 0) clipRgn.add(pointArray, pointCount);
pointCount = 0;
break;
}
}
if (pointCount != 0) clipRgn.add(pointArray, pointCount);
OS.free(points);
region.intersect(clipRgn);
clipRgn.dispose();
}
if (data.inverseTransform != null) {
region.convertRgn(data.inverseTransform);
}
} finally {
if (pool != null) pool.release();
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
return data.fillRule;
}
/**
* 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 == null) 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
NSAutoreleasePool pool = checkGC(FONT);
try {
if (data.textStorage == null) createLayout();
if (data.font.metrics == null) {
String s = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"; //$NON-NLS-1$
NSMutableDictionary dict = ((NSMutableDictionary)new NSMutableDictionary().alloc()).initWithCapacity(3);
dict.setObject(data.font.handle, OS.NSFontAttributeName);
data.font.addTraits(dict);
NSAttributedString attribStr = ((NSAttributedString)new NSAttributedString().alloc()).initWithString(NSString.stringWith(s), dict);
data.textStorage.setAttributedString(attribStr);
attribStr.release();
dict.release();
NSLayoutManager layoutManager = data.layoutManager;
layoutManager.glyphRangeForTextContainer(data.textContainer);
NSRect rect = layoutManager.usedRectForTextContainer(data.textContainer);
int avgWidth = (int) Math.ceil(rect.width) / s.length();
int ascent = (int)layoutManager.defaultBaselineOffsetForFont(data.font.handle);
int height = (int)layoutManager.defaultLineHeightForFont(data.font.handle);
data.font.metrics = FontMetrics.cocoa_new(ascent, height - ascent, avgWidth, 0, height);
}
return data.font.metrics;
} finally {
uncheckGC(pool);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_WIDGET_DISPOSED);
return Color.cocoa_new(data.device, data.foreground);
}
/**
* 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 == null) SWT.error(SWT.ERROR_WIDGET_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 == null) SWT.error(SWT.ERROR_WIDGET_DISPOSED);
NSAutoreleasePool pool = checkGC(TRANSFORM | CLIPPING);
uncheckGC(pool);
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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
int interpolation = (int)/*64*/handle.imageInterpolation();
switch (interpolation) {
case OS.NSImageInterpolationDefault: return SWT.DEFAULT;
case OS.NSImageInterpolationNone: return SWT.NONE;
case OS.NSImageInterpolationLow: return SWT.LOW;
case OS.NSImageInterpolationHigh: return SWT.HIGH;
}
return SWT.DEFAULT;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
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 == null) 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 == null) 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 == null) 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 == null) 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
return data.style;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
return data.textAntialias;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (transform == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
if (transform.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT);
NSAffineTransform cmt = data.transform;
if (cmt != null) {
NSAffineTransformStruct struct = cmt.transformStruct();
transform.handle.setTransformStruct(struct);
} 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 == null) 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
*/
public int hashCode() {
return handle != null ? (int)/*64*/handle.id : 0;
}
void init(Drawable drawable, GCData data, int /*long*/ context) {
if (data.foreground != null) data.state &= ~(FOREGROUND | FOREGROUND_FILL);
if (data.background != null) data.state &= ~BACKGROUND;
if (data.font != null) data.state &= ~FONT;
data.state &= ~DRAW_OFFSET;
Image image = data.image;
if (image != null) image.memGC = this;
this.drawable = drawable;
this.data = data;
handle = new NSGraphicsContext(context);
handle.retain();
handle.saveGraphicsState();
data.path = NSBezierPath.bezierPath();
data.path.setWindingRule(data.fillRule == SWT.FILL_WINDING ? OS.NSNonZeroWindingRule : OS.NSEvenOddWindingRule);
data.path.retain();
}
void initCGContext(int /*long*/ cgContext) {
int state = data.state;
if ((state & LINE_WIDTH) != 0) {
OS.CGContextSetLineWidth(cgContext, data.lineWidth == 0 ? 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[] 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) {
float[] lengths = new float[dashes.length];
for (int i = 0; i < lengths.length; i++) {
lengths[i] = width == 0 || data.lineStyle == SWT.LINE_CUSTOM ? dashes[i] : dashes[i] * width;
}
OS.CGContextSetLineDash(cgContext, data.lineDashesOffset, lengths, lengths.length);
} else {
OS.CGContextSetLineDash(cgContext, 0, null, 0);
}
}
if ((state & LINE_MITERLIMIT) != 0) {
OS.CGContextSetMiterLimit(cgContext, data.lineMiterLimit);
}
if ((state & LINE_JOIN) != 0) {
int joinStyle = 0;
switch (data.lineJoin) {
case SWT.JOIN_MITER: joinStyle = OS.kCGLineJoinMiter; break;
case SWT.JOIN_ROUND: joinStyle = OS.kCGLineJoinRound; break;
case SWT.JOIN_BEVEL: joinStyle = OS.kCGLineJoinBevel; break;
}
OS.CGContextSetLineJoin(cgContext, joinStyle);
}
if ((state & LINE_CAP) != 0) {
int capStyle = 0;
switch (data.lineCap) {
case SWT.CAP_ROUND: capStyle = OS.kCGLineCapRound; break;
case SWT.CAP_FLAT: capStyle = OS.kCGLineCapButt; break;
case SWT.CAP_SQUARE: capStyle = OS.kCGLineCapSquare; break;
}
OS.CGContextSetLineCap(cgContext, capStyle);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
return data.clipPath != null;
}
/**
* 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
*/
public boolean isDisposed() {
return handle == null;
}
boolean isIdentity(float[] transform) {
return transform[0] == 1 && transform[1] == 0 && transform[2] == 0
&& transform[3] == 1 && transform[4] == 0 && transform[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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (!advanced) {
setAlpha(0xFF);
setAntialias(SWT.DEFAULT);
setBackgroundPattern(null);
setClipping((Rectangle)null);
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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
data.alpha = alpha & 0xFF;
data.state &= ~(BACKGROUND | FOREGROUND | FOREGROUND_FILL);
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
boolean mode = true;
switch (antialias) {
case SWT.DEFAULT:
/* Printer is off by default */
if (!handle.isDrawingToScreen()) mode = false;
break;
case SWT.OFF: mode = false; break;
case SWT.ON: mode = true; break;
default:
SWT.error(SWT.ERROR_INVALID_ARGUMENT);
}
data.antialias = antialias;
handle.setShouldAntialias(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 == null) 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.background = color.handle;
data.backgroundPattern = null;
if (data.bg != null) data.bg.release();
data.bg = null;
data.state &= ~BACKGROUND;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (pattern != null && pattern.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT);
if (data.backgroundPattern == pattern) return;
data.backgroundPattern = pattern;
data.state &= ~BACKGROUND;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
NSAutoreleasePool pool = null;
if (!NSThread.isMainThread()) pool = (NSAutoreleasePool) new NSAutoreleasePool().alloc().init();
try {
if (width < 0) {
x = x + width;
width = -width;
}
if (height < 0) {
y = y + height;
height = -height;
}
NSRect rect = new NSRect();
rect.x = x;
rect.y = y;
rect.width = width;
rect.height = height;
NSBezierPath path = NSBezierPath.bezierPathWithRect(rect);
path.retain();
setClipping(path);
} finally {
if (pool != null) pool.release();
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (path != null && path.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT);
NSAutoreleasePool pool = null;
if (!NSThread.isMainThread()) pool = (NSAutoreleasePool) new NSAutoreleasePool().alloc().init();
try {
setClipping(new NSBezierPath(path.handle.copy().id));
} finally {
if (pool != null) pool.release();
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (rect == null) {
setClipping((NSBezierPath)null);
} else {
setClipping(rect.x, rect.y, rect.width, rect.height);
}
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (region != null && region.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT);
NSAutoreleasePool pool = null;
if (!NSThread.isMainThread()) pool = (NSAutoreleasePool) new NSAutoreleasePool().alloc().init();
try {
setClipping(region != null ? region.getPath() : null);
} finally {
if (pool != null) pool.release();
}
}
void setClipping(NSBezierPath path) {
if (data.clipPath != null) {
data.clipPath.release();
data.clipPath = null;
}
if (path != null) {
data.clipPath = path;
if (data.transform != null) {
data.clipPath.transformUsingAffineTransform(data.transform);
}
}
data.state &= ~CLIPPING;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
switch (rule) {
case SWT.FILL_WINDING:
case SWT.FILL_EVEN_ODD: break;
default:
SWT.error(SWT.ERROR_INVALID_ARGUMENT);
}
data.fillRule = rule;
data.path.setWindingRule(rule == SWT.FILL_WINDING ? OS.NSNonZeroWindingRule : OS.NSEvenOddWindingRule);
}
/**
* 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 == null) 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;
}
/**
* 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 == null) 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.foreground = color.handle;
data.foregroundPattern = null;
if (data.fg != null) data.fg.release();
data.fg = null;
data.state &= ~(FOREGROUND | FOREGROUND_FILL);
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (pattern != null && pattern.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT);
if (data.foregroundPattern == pattern) return;
data.foregroundPattern = pattern;
data.state &= ~(FOREGROUND | FOREGROUND_FILL);
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
int quality = 0;
switch (interpolation) {
case SWT.DEFAULT: quality = OS.NSImageInterpolationDefault; break;
case SWT.NONE: quality = OS.NSImageInterpolationNone; break;
case SWT.LOW: quality = OS.NSImageInterpolationLow; break;
case SWT.HIGH: quality = OS.NSImageInterpolationHigh; break;
default:
SWT.error(SWT.ERROR_INVALID_ARGUMENT);
}
handle.setImageInterpolation(quality);
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (attributes == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
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;
}
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 == null) 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 == null) 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 == null) 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 == null) 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.
*
*
* @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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (data.lineWidth == lineWidth) return;
data.lineWidth = lineWidth;
data.state &= ~(LINE_WIDTH | 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.
*
* Note that this mode in fundamentally unsupportable on certain
* platforms, notably Carbon (Mac OS X). Clients that want their
* code to run on all platforms need to avoid this method.
*
*
* @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
*
*
* @deprecated this functionality is not supported on some platforms
*/
public void setXORMode(boolean xor) {
if (handle == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
data.xorMode = xor;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
switch (antialias) {
case SWT.DEFAULT:
case SWT.OFF:
case SWT.ON:
break;
default:
SWT.error(SWT.ERROR_INVALID_ARGUMENT);
}
data.textAntialias = antialias;
}
/**
* 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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (transform != null && transform.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT);
if (transform != null) {
if (data.transform != null) data.transform.release();
if (data.inverseTransform != null) data.inverseTransform.release();
data.transform = ((NSAffineTransform)new NSAffineTransform().alloc()).initWithTransform(transform.handle);
data.inverseTransform = ((NSAffineTransform)new NSAffineTransform().alloc()).initWithTransform(transform.handle);
NSAffineTransformStruct struct = data.inverseTransform.transformStruct();
if ((struct.m11 * struct.m22 - struct.m12 * struct.m21) != 0) {
data.inverseTransform.invert();
}
} else {
data.transform = data.inverseTransform = null;
}
data.state &= ~(TRANSFORM | DRAW_OFFSET);
}
/**
* 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 textExtent(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 textExtent(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 == null) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED);
if (string == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
NSAutoreleasePool pool = checkGC(FONT);
try {
int length = string.length();
if (data.textStorage == null) createLayout();
NSAttributedString attribStr = createString(length == 0 ? " " : string, flags, false); //$NON-NLS-1$
data.textStorage.setAttributedString(attribStr);
attribStr.release();
data.layoutManager.glyphRangeForTextContainer(data.textContainer);
NSRect rect = data.layoutManager.usedRectForTextContainer(data.textContainer);
return new Point(length == 0 ? 0 : (int)Math.ceil(rect.width), (int)Math.ceil(rect.height));
} finally {
uncheckGC(pool);
}
}
/**
* Returns a string containing a concise, human-readable
* description of the receiver.
*
* @return a string representation of the receiver
*/
public String toString () {
if (isDisposed()) return "GC {*DISPOSED*}";
return "GC {" + handle + "}";
}
void uncheckGC(NSAutoreleasePool pool) {
if (data.flippedContext != null && data.restoreContext) {
NSGraphicsContext.static_restoreGraphicsState();
data.restoreContext = false;
}
NSView view = data.view;
if (view != null && data.paintRect == null) {
if (data.thread != Thread.currentThread()) flush();
}
if (pool != null) pool.release();
}
}