eu.webtoolkit.jwt
Class WPainter

java.lang.Object
  eu.webtoolkit.jwt.WPainter

public class WPainter
extends java.lang.Object

Vector graphics painting class.

The painter class provides a vector graphics interface for painting. It needs to be used in conjunction with a WPaintDevice, onto which it paints. To start painting on a device, either pass the device through the constructor, or use begin().

A typical use is to instantiate a WPainter from within a specialized WPaintedWidget#paintEvent() implementation, to paint on the given paint device, but you can also use a painter to paint directly to a particular paint device of choice, for example to create SVG, PDF or PNG images (as resources).

The painter maintains state such as the current pen, brush, font, shadow, transformation and clipping settings (see setClipping() and setClipPath()). A particular state can be saved using save() and later restored using restore().

The painting system distinguishes between device coordinates, logical coordinates, and local coordinates. The device coordinate system ranges from (0, 0) in the top left corner of the device, to (device.width().toPixels(), device.height().toPixels()) for the bottom right corner. The logical coordinate system defines a coordinate system that may be chosen independent of the geometry of the device, which is convenient to make abstraction of the actual device size. Finally, the current local coordinate system may be different from the logical coordinate system because of a transformation set (using translate(), rotate(), and scale()). Initially, the local coordinate system coincides with the logical coordinate system, which coincides with the device coordinate system.

The device coordinates are defined in terms of pixels. Even though most underlying devices are actual vector graphics formats, when used in conjunction with a WPaintedWidget, these vector graphics are rendered by the browser onto a pixel-based canvas (like the rest of the user-interface). The coordinates are defined such that integer values correspond to an imaginary raster which separates the individual pixels, as in the figure below.

The device coordinate system for a 6x5 pixel device

As a consequence, to avoid anti-aliasing effects when drawing straight lines of width one pixel, you will need to use vertices that indicate the middle of a pixel to get a crisp one-pixel wide line, as in the example figure.

By setting a getViewPort() and a getWindow(), a viewPort transformation is defined which maps logical coordinates onto device coordinates. By changing the world transformation (using setWorldTransform(), or translate(), rotate(), scale() operations), it is defined how current local coordinates map onto logical coordinates.

The painter provides support for clipping using an arbitrary path, but not that the VmlImage only has limited support for clipping.

See Also:

WPaintedWidget.paintEvent(WPaintDevice paintDevice)

Nested Class Summary

static class	WPainter.Image An image that can be rendered on a WPainter.
static class	WPainter.RenderHint Enumeration for render hints.

Constructor Summary

WPainter()
Default constructor.

WPainter(WPaintDevice device)
Creates a painter on a given paint device.

Method Summary

boolean	begin(WPaintDevice device) Begins painting on a paint device.
void	drawArc(double x, double y, double width, double height, int startAngle, int spanAngle) Draws an arc.
void	drawArc(WRectF rectangle, int startAngle, int spanAngle) Draws an arc.
void	drawChord(double x, double y, double width, double height, int startAngle, int spanAngle) Draws a chord.
void	drawChord(WRectF rectangle, int startAngle, int spanAngle) Draws a chord.
void	drawEllipse(double x, double y, double width, double height) Draws an ellipse.
void	drawEllipse(WRectF rectangle) Draws an ellipse.
void	drawImage(double x, double y, WPainter.Image image) Draws part of an image.
void	drawImage(double x, double y, WPainter.Image image, double sx) Draws part of an image.
void	drawImage(double x, double y, WPainter.Image image, double sx, double sy) Draws part of an image.
void	drawImage(double x, double y, WPainter.Image image, double sx, double sy, double sw) Draws part of an image.
void	drawImage(double x, double y, WPainter.Image image, double sx, double sy, double sw, double sh) Draws part of an image.
void	drawImage(WPointF point, WPainter.Image image) Draws an image.
void	drawImage(WPointF point, WPainter.Image image, WRectF sourceRect) Draws part of an image.
void	drawImage(WRectF rect, WPainter.Image image) Draws an image inside a rectangle.
void	drawImage(WRectF rect, WPainter.Image image, WRectF sourceRect) Draws part of an image inside a rectangle.
void	drawLine(double x1, double y1, double x2, double y2) Draws a line.
void	drawLine(WLineF line) Draws a line.
void	drawLine(WPointF p1, WPointF p2) Draws a line.
void	drawLines(WLineF[] lines, int lineCount) Draws an array of lines.
void	drawLines(WPointF[] pointPairs, int lineCount) Draws an array of lines.
void	drawLinesLine(java.util.List<WLineF> lines) Draws an array of lines.
void	drawLinesPoint(java.util.List<WPointF> pointPairs) Draws an array of lines.
void	drawPath(WPainterPath path) Draws a (complex) path.
void	drawPie(double x, double y, double width, double height, int startAngle, int spanAngle) Draws a pie.
void	drawPie(WRectF rectangle, int startAngle, int spanAngle) Draws a pie.
void	drawPoint(double x, double y) Draws a point.
void	drawPoint(WPointF point) Draws a point.
void	drawPoints(WPointF[] points, int pointCount) Draws a number of points.
void	drawPolygon(WPointF[] points, int pointCount) Draws a polygon.
void	drawPolyline(WPointF[] points, int pointCount) Draws a polyline.
void	drawRect(double x, double y, double width, double height) Draws a rectangle.
void	drawRect(WRectF rectangle) Draws a rectangle.
void	drawRects(java.util.List<WRectF> rectangles) Draws a number of rectangles.
void	drawRects(WRectF[] rectangles, int rectCount) Draws a number of rectangles.
void	drawText(double x, double y, double width, double height, java.util.EnumSet<AlignmentFlag> flags, java.lang.CharSequence text) Draws text.
void	drawText(double x, double y, double width, double height, java.util.EnumSet<AlignmentFlag> alignmentFlags, TextFlag textFlag, java.lang.CharSequence text) Draws text.
void	drawText(WRectF rectangle, java.util.EnumSet<AlignmentFlag> flags, java.lang.CharSequence text) Draws text.
void	drawText(WRectF rectangle, java.util.EnumSet<AlignmentFlag> alignmentFlags, TextFlag textFlag, java.lang.CharSequence text) Draws text.
boolean	end() Ends painting.
void	fillPath(WPainterPath path, WBrush b) Fills a (complex) path.
void	fillRect(double x, double y, double width, double height, WBrush brush) Fills a rectangle.
void	fillRect(WRectF rectangle, WBrush b) Fills a rectangle.
WBrush	getBrush() Returns the current brush.
WPainterPath	getClipPath() Returns the clip path.
WTransform	getCombinedTransform() Returns the combined transformation matrix.
WPaintDevice	getDevice() Returns the device on which this painter is active (or 0 if not active).
WFont	getFont() Returns the current font.
WPen	getPen() Returns the current pen.
int	getRenderHints() Returns the current render hints.
WShadow	getShadow() Returns the current shadow effect.
WRectF	getViewPort() Returns the viewport.
WRectF	getWindow() Returns the current window.
WTransform	getWorldTransform() Returns the current world transformation matrix.
boolean	hasClipping() Returns whether clipping is enabled.
boolean	isActive() Returns whether this painter is active on a paint device.
void	resetTransform() Resets the current transformation.
void	restore() Returns the last save state.
void	rotate(double angle) Rotates the logical coordinate system.
void	save() Saves the current state.
void	scale(double sx, double sy) Scales the logical coordinate system.
void	setBrush(WBrush b) Sets the fill style.
void	setClipPath(WPainterPath clipPath) Sets the clip path.
void	setClipping(boolean enable) Enables or disables clipping.
void	setFont(WFont f) Sets the font.
void	setPen(WPen p) Sets the pen.
void	setRenderHint(WPainter.RenderHint hint) Sets a render hint.
void	setRenderHint(WPainter.RenderHint hint, boolean on) Sets a render hint.
void	setShadow(WShadow shadow) Sets a shadow effect.
void	setViewPort(double x, double y, double width, double height) Sets the viewport.
void	setViewPort(WRectF viewPort) Sets the viewport.
void	setWindow(double x, double y, double width, double height) Sets the window.
void	setWindow(WRectF window) Sets the window.
void	setWorldTransform(WTransform matrix) Sets a transformation for the logical coordinate system.
void	setWorldTransform(WTransform matrix, boolean combine) Sets a transformation for the logical coordinate system.
void	strokePath(WPainterPath path, WPen p) Strokes a path.
void	translate(double dx, double dy) Translates the origin of the logical coordinate system.
void	translate(WPointF p) Translates the origin of the logical coordinate system.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WPainter

public WPainter()

Default constructor.

Before painting, you must invoke begin() on a paint device.

See Also:

WPainter(WPaintDevice device)

WPainter

public WPainter(WPaintDevice device)

Creates a painter on a given paint device.

Method Detail

begin

public boolean begin(WPaintDevice device)

Begins painting on a paint device.

See Also:

end(), isActive()

isActive

public boolean isActive()

Returns whether this painter is active on a paint device.

See Also:

begin(WPaintDevice device), end()

end

public boolean end()

Ends painting.

getDevice

public WPaintDevice getDevice()

Returns the device on which this painter is active (or 0 if not active).

See Also:

begin(WPaintDevice device), WPainter(WPaintDevice device), isActive()

setRenderHint

public void setRenderHint(WPainter.RenderHint hint,
                          boolean on)

Sets a render hint.

Renderers may ignore particular hints for which they have no support.

setRenderHint

public final void setRenderHint(WPainter.RenderHint hint)

Sets a render hint.

Calls setRenderHint(hint, true)

getRenderHints

public int getRenderHints()

Returns the current render hints.

Returns the logical OR of render hints currently set.

See Also:

setRenderHint(WPainter.RenderHint hint, boolean on)

drawArc

public void drawArc(WRectF rectangle,
                    int startAngle,
                    int spanAngle)

Draws an arc.

Draws an arc using the current pen, and fills using the current brush.

The arc is defined as a segment from an ellipse, which fits in the rectangle. The segment starts at startAngle, and spans an angle given by spanAngle. These angles have as unit 1/16th of a degree, and are measured counter-clockwise starting from the 3 o'clock position.

See Also:

drawEllipse(WRectF rectangle), drawChord(WRectF rectangle, int startAngle, int spanAngle), drawArc(double x, double y, double width, double height, int startAngle, int spanAngle)

drawArc

public void drawArc(double x,
                    double y,
                    double width,
                    double height,
                    int startAngle,
                    int spanAngle)

Draws an arc.

This is an overloaded method for convenience.

See Also:

drawArc(WRectF rectangle, int startAngle, int spanAngle)

drawChord

public void drawChord(WRectF rectangle,
                      int startAngle,
                      int spanAngle)

Draws a chord.

Draws an arc using the current pen, and connects start and end point with a line. The area is filled using the current brush.

The arc is defined as a segment from an ellipse, which fits in the rectangle. The segment starts at startAngle, and spans an angle given by spanAngle. These angles have as unit 1/16th of a degree, and are measured counter-clockwise starting at 3 o'clock.

See Also:

drawEllipse(WRectF rectangle), drawArc(WRectF rectangle, int startAngle, int spanAngle), drawChord(double x, double y, double width, double height, int startAngle, int spanAngle)

drawChord

public void drawChord(double x,
                      double y,
                      double width,
                      double height,
                      int startAngle,
                      int spanAngle)

Draws a chord.

This is an overloaded method for convenience.

See Also:

drawChord(WRectF rectangle, int startAngle, int spanAngle)

drawEllipse

public void drawEllipse(WRectF rectangle)

Draws an ellipse.

Draws an ellipse using the current pen and fills it using the current brush.

The ellipse is defined as being bounded by the rectangle.

See Also:

drawArc(WRectF rectangle, int startAngle, int spanAngle), drawEllipse(double x, double y, double width, double height)

drawEllipse

public void drawEllipse(double x,
                        double y,
                        double width,
                        double height)

Draws an ellipse.

This is an overloaded method for convenience.

See Also:

drawEllipse(WRectF rectangle)

drawImage

public void drawImage(WPointF point,
                      WPainter.Image image)

Draws an image.

Draws the image so that the top left corner corresponds to point.

This is an overloaded method provided for convenience.

drawImage

public void drawImage(WPointF point,
                      WPainter.Image image,
                      WRectF sourceRect)

Draws part of an image.

Draws the sourceRect rectangle from an image to the location point.

This is an overloaded method provided for convenience.

drawImage

public void drawImage(WRectF rect,
                      WPainter.Image image)

Draws an image inside a rectangle.

Draws the image inside rect (If necessary, the image is scaled to fit into the rectangle).

This is an overloaded method provided for convenience.

drawImage

public void drawImage(WRectF rect,
                      WPainter.Image image,
                      WRectF sourceRect)

Draws part of an image inside a rectangle.

Draws the sourceRect rectangle from an image inside rect (If necessary, the image is scaled to fit into the rectangle).

drawImage

public void drawImage(double x,
                      double y,
                      WPainter.Image image,
                      double sx,
                      double sy,
                      double sw,
                      double sh)

Draws part of an image.

Draws the sourceRect rectangle with top left corner (sx, sy) and size sw x sh from an image to the location (x, y).

drawImage

public final void drawImage(double x,
                            double y,
                            WPainter.Image image)

Draws part of an image.

Calls drawImage(x, y, image, 0, 0, - 1, - 1)

drawImage

public final void drawImage(double x,
                            double y,
                            WPainter.Image image,
                            double sx)

Draws part of an image.

Calls drawImage(x, y, image, sx, 0, - 1, - 1)

drawImage

public final void drawImage(double x,
                            double y,
                            WPainter.Image image,
                            double sx,
                            double sy)

Draws part of an image.

Calls drawImage(x, y, image, sx, sy, - 1, - 1)

drawImage

public final void drawImage(double x,
                            double y,
                            WPainter.Image image,
                            double sx,
                            double sy,
                            double sw)

Draws part of an image.

Calls drawImage(x, y, image, sx, sy, sw, - 1)

drawLine

public void drawLine(WLineF line)

Draws a line.

Draws a line using the current pen.

See Also:

drawLine(WPointF p1, WPointF p2), drawLine(double x1, double y1, double x2, double y2)

drawLine

public void drawLine(WPointF p1,
                     WPointF p2)

Draws a line.

Draws a line defined by two points.

See Also:

drawLine(WLineF line), drawLine(double x1, double y1, double x2, double y2)

drawLine

public void drawLine(double x1,
                     double y1,
                     double x2,
                     double y2)

Draws a line.

Draws a line defined by two points.

See Also:

drawLine(WLineF line), drawLine(WPointF p1, WPointF p2)

drawLines

public void drawLines(WLineF[] lines,
                      int lineCount)

Draws an array of lines.

Draws the lineCount first lines from the given array of lines.

drawLines

public void drawLines(WPointF[] pointPairs,
                      int lineCount)

Draws an array of lines.

Draws lineCount lines, where each line is specified using a begin and end point that are read from an array. Thus, the pointPairs array must have at least 2*lineCount points.

drawLinesLine

public void drawLinesLine(java.util.List<WLineF> lines)

Draws an array of lines.

Draws the lines given in the vector.

drawLinesPoint

public void drawLinesPoint(java.util.List<WPointF> pointPairs)

Draws an array of lines.

Draws a number of lines that are specified by pairs of begin- and endpoints. The vector should hold a number of points that is a multiple of two.

drawPath

public void drawPath(WPainterPath path)

Draws a (complex) path.

Draws and fills the given path using the current pen and brush.

See Also:

strokePath(WPainterPath path, WPen p), fillPath(WPainterPath path, WBrush b)

drawPie

public void drawPie(WRectF rectangle,
                    int startAngle,
                    int spanAngle)

Draws a pie.

Draws an arc using the current pen, and connects start and end point with the center of the corresponding ellipse. The area is filled using the current brush.

The arc is defined as a segment from an ellipse, which fits in the rectangle. The segment starts at startAngle, and spans an angle given by spanAngle. These angles have as unit 1/16th of a degree, and are measured counter-clockwise starting at 3 o'clock.

See Also:

drawEllipse(WRectF rectangle), drawArc(WRectF rectangle, int startAngle, int spanAngle), drawPie(double x, double y, double width, double height, int startAngle, int spanAngle)

drawPie

public void drawPie(double x,
                    double y,
                    double width,
                    double height,
                    int startAngle,
                    int spanAngle)

Draws a pie.

This is an overloaded method for convenience.

See Also:

drawPie(WRectF rectangle, int startAngle, int spanAngle)

drawPoint

public void drawPoint(WPointF point)

Draws a point.

Draws a single point using the current pen. This is implemented by drawing a very short line, centered around the given position. To get the result of a single point, you should use a pen with a PenCapStyle.SquareCap or PenCapStyle.RoundCap pen cap style.

See Also:

drawPoint(double x, double y)

drawPoint

public void drawPoint(double x,
                      double y)

Draws a point.

This is an overloaded method for convenience.

See Also:

drawPoint(WPointF point)

drawPoints

public void drawPoints(WPointF[] points,
                       int pointCount)

Draws a number of points.

Draws the pointCount first points from the given array of points.

See Also:

drawPoint(WPointF point)

drawPolygon

public void drawPolygon(WPointF[] points,
                        int pointCount)

Draws a polygon.

Draws a polygon that is specified by a list of points, using the current pen. The polygon is closed by connecting the last point with the first point, and filled using the current brush.

See Also:

drawPath(WPainterPath path), drawPolyline(WPointF[] points, int pointCount)

drawPolyline

public void drawPolyline(WPointF[] points,
                         int pointCount)

Draws a polyline.

Draws a polyline that is specified by a list of points, using the current pen.

See Also:

drawPath(WPainterPath path), drawPolygon(WPointF[] points, int pointCount)

drawRect

public void drawRect(WRectF rectangle)

Draws a rectangle.

Draws and fills a rectangle using the current pen and brush.

See Also:

drawRect(double x, double y, double width, double height)

drawRect

public void drawRect(double x,
                     double y,
                     double width,
                     double height)

Draws a rectangle.

This is an overloaded method for convenience.

See Also:

drawRect(WRectF rectangle)

drawRects

public void drawRects(WRectF[] rectangles,
                      int rectCount)

Draws a number of rectangles.

Draws and fills the rectCount first rectangles from the given array, using the current pen and brush.

See Also:

drawRect(WRectF rectangle)

drawRects

public void drawRects(java.util.List<WRectF> rectangles)

Draws a number of rectangles.

Draws and fills a list of rectangles using the current pen and brush.

See Also:

drawRect(WRectF rectangle)

drawText

public void drawText(WRectF rectangle,
                     java.util.EnumSet<AlignmentFlag> alignmentFlags,
                     TextFlag textFlag,
                     java.lang.CharSequence text)

Draws text.

Draws text using inside the rectangle, using the current font. The text is aligned inside the rectangle following alignment indications given in flags. The text is drawn using the current transformation, pen color (getPen()) and font settings ( getFont()).

AlignmentFlags is the logical OR of a horizontal and vertical alignment. Horizontal alignment may be one of AlignLeft, AlignCenter, or AlignRight. Vertical alignment is one of AlignTop, AlignMiddle or AlignBottom.

TextFlag determines how the text is rendered in the rectangle. Text can be rendered on one line or by wrapping the words within the rectangle.

Note: HtmlCanvas: on older browsers implementing Html5 canvas, text will be rendered horizontally (unaffected by rotation and unaffected by the scaling component of the transformation matrix). In that case, text is overlayed on top of painted shapes (in DOM div's), and is not covered by shapes that are painted after the text. Use the SVG and VML renderers (WPaintedWidget::inlineSvgVml) for the most accurate font rendering. Native HTML5 text rendering is supported on Firefox3+, Chrome2+ and Safari4+.

TextWordWrap: using the TextWordWrap TextFlag is currently only supported by the SVG backend. The code generated by the SVG backend uses features currently only supported by Inkscape. Inkscape currently supports only Top vertical alignments.

drawText

public void drawText(WRectF rectangle,
                     java.util.EnumSet<AlignmentFlag> flags,
                     java.lang.CharSequence text)

Draws text.

This is an overloaded method for convenience, it will render text on a single line.

See Also:

drawText(WRectF rectangle, EnumSet alignmentFlags, TextFlag textFlag, CharSequence text)

drawText

public void drawText(double x,
                     double y,
                     double width,
                     double height,
                     java.util.EnumSet<AlignmentFlag> flags,
                     java.lang.CharSequence text)

Draws text.

This is an overloaded method for convenience.

See Also:

drawText(WRectF rectangle, EnumSet flags, CharSequence text)

drawText

public void drawText(double x,
                     double y,
                     double width,
                     double height,
                     java.util.EnumSet<AlignmentFlag> alignmentFlags,
                     TextFlag textFlag,
                     java.lang.CharSequence text)

Draws text.

This is an overloaded method for convenience.

See Also:

drawText(WRectF rectangle, EnumSet alignmentFlags, TextFlag textFlag, CharSequence text), WRectF, TextFlag, WString

fillPath

public void fillPath(WPainterPath path,
                     WBrush b)

Fills a (complex) path.

Like drawPath(), but does not stroke the path, and fills the path with the given brush.

See Also:

drawPath(WPainterPath path), strokePath(WPainterPath path, WPen p)

fillRect

public void fillRect(WRectF rectangle,
                     WBrush b)

Fills a rectangle.

Like drawRect(), but does not stroke the rect, and fills the rect with the given brush.

See Also:

drawRect(WRectF rectangle)

fillRect

public void fillRect(double x,
                     double y,
                     double width,
                     double height,
                     WBrush brush)

Fills a rectangle.

This is an overloaded method for convenience.

See Also:

fillRect(WRectF rectangle, WBrush b)

strokePath

public void strokePath(WPainterPath path,
                       WPen p)

Strokes a path.

Like drawPath(), but does not fill the path, and strokes the path with the given pen.

See Also:

drawPath(WPainterPath path), fillPath(WPainterPath path, WBrush b)

setShadow

public void setShadow(WShadow shadow)

Sets a shadow effect.

The shadow effect is applied to all things drawn (paths, text and images).

Note: With the VML backend (IE), the shadow is not applied to images, and the shadow color is always black; only the opacity (alpha) channel is taken into account.

See Also:

WPainter.RenderHint.LowQualityShadows

getShadow

public WShadow getShadow()

Returns the current shadow effect.

See Also:

setShadow(WShadow shadow)

setBrush

public void setBrush(WBrush b)

Sets the fill style.

Changes the fills style for subsequent draw operations.

See Also:

getBrush(), setPen(WPen p)

setFont

public void setFont(WFont f)

Sets the font.

Changes the font for subsequent text rendering. Note that only font sizes that are defined as an explicit size (see WFont.Size.FixedSize) will render correctly in all devices (SVG, VML, and HtmlCanvas).

The list of fonts that will render correctly with VML (on IE<9) are limited to the following: http://www.ampsoft.net/webdesign-l/WindowsMacFonts.html

Careful, for a font family that contains a space, you need to add quotes, to WFont#setFamily() e.g.

 WFont mono;
    mono.setFamily(WFont::Monospace, "'Courier New'");
    mono.setSize(18);
   
 

See Also:

getFont(), drawText(WRectF rectangle, EnumSet alignmentFlags, TextFlag textFlag, CharSequence text)

setPen

public void setPen(WPen p)

Sets the pen.

Changes the pen used for stroking subsequent draw operations.

See Also:

getPen(), setBrush(WBrush b)

getBrush

public WBrush getBrush()

Returns the current brush.

Returns the brush style that is currently used for filling.

See Also:

setBrush(WBrush b)

getFont

public WFont getFont()

Returns the current font.

Returns the font that is currently used for rendering text. The default font is a 10pt sans serif font.

See Also:

setFont(WFont f)

getPen

public WPen getPen()

Returns the current pen.

Returns the pen that is currently used for stroking.

See Also:

setPen(WPen p)

setClipping

public void setClipping(boolean enable)

Enables or disables clipping.

Enables are disables clipping for subsequent operations using the current clip path set using setClipPath().

Note: Clipping is not supported for the VML renderer.

See Also:

hasClipping(), setClipPath(WPainterPath clipPath)

hasClipping

public boolean hasClipping()

Returns whether clipping is enabled.

Note: Clipping is not supported for the VML renderer.

See Also:

setClipping(boolean enable), setClipPath(WPainterPath clipPath)

setClipPath

public void setClipPath(WPainterPath clipPath)

Sets the clip path.

Sets the path that is used for clipping subsequent drawing operations. The clip path is only used when clipping is enabled using setClipping(). The path is specified in local coordinates.

Note: Only clipping with a rectangle is supported for the VML renderer (see WPainterPath#addRect()). The rectangle must, after applying the combined transformation system, be aligned with the window.

See Also:

getClipPath(), setClipping(boolean enable)

getClipPath

public WPainterPath getClipPath()

Returns the clip path.

The clip path is returned as it was defined: in the local coordinates at time of definition.

See Also:

setClipPath(WPainterPath clipPath)

resetTransform

public void resetTransform()

Resets the current transformation.

Resets the current transformation to the identity transformation matrix, so that the logical coordinate system coincides with the device coordinate system.

rotate

public void rotate(double angle)

Rotates the logical coordinate system.

Rotates the logical coordinate system around its origin. The angle is specified in degrees, and positive values are clock-wise.

See Also:

scale(double sx, double sy), translate(double dx, double dy), resetTransform()

scale

public void scale(double sx,
                  double sy)

Scales the logical coordinate system.

Scales the logical coordinate system around its origin, by a factor in the X and Y directions.

See Also:

rotate(double angle), translate(double dx, double dy), resetTransform()

translate

public void translate(WPointF p)

Translates the origin of the logical coordinate system.

Translates the origin of the logical coordinate system to a new location relative to the current logical coordinate system.

See Also:

translate(double dx, double dy), rotate(double angle), scale(double sx, double sy), resetTransform()

translate

public void translate(double dx,
                      double dy)

Translates the origin of the logical coordinate system.

Translates the origin of the logical coordinate system to a new location relative to the logical coordinate system.

See Also:

translate(WPointF p), rotate(double angle), scale(double sx, double sy), resetTransform()

setWorldTransform

public void setWorldTransform(WTransform matrix,
                              boolean combine)

Sets a transformation for the logical coordinate system.

Sets a new transformation which transforms logical coordinates to device coordinates. When combine is true, the transformation is combined with the current world transformation matrix.

See Also:

getWorldTransform(), rotate(double angle), scale(double sx, double sy), translate(double dx, double dy), resetTransform()

setWorldTransform

public final void setWorldTransform(WTransform matrix)

Sets a transformation for the logical coordinate system.

Calls setWorldTransform(matrix, false)

getWorldTransform

public WTransform getWorldTransform()

Returns the current world transformation matrix.

See Also:

setWorldTransform(WTransform matrix, boolean combine)

save

public void save()

Saves the current state.

A copy of the current state is saved on a stack. This state will may later be restored by popping this state from the stack using restore().

The state that is saved is the current pen, brush, font, shadow, transformation and clipping settings (see setClipping() and setClipPath()).

See Also:

restore()

restore

public void restore()

Returns the last save state.

Pops the last saved state from the state stack.

See Also:

save()

setViewPort

public void setViewPort(WRectF viewPort)

Sets the viewport.

Selects the part of the device that will correspond to the logical coordinate system.

By default, the viewport spans the entire device: it is the rectangle (0, 0) to (device.width(), device.height()). The window defines how the viewport is mapped to logical coordinates.

See Also:

getViewPort(), setWindow(WRectF window)

setViewPort

public void setViewPort(double x,
                        double y,
                        double width,
                        double height)

Sets the viewport.

This is an overloaded method for convenience.

See Also:

setViewPort(WRectF viewPort)

getViewPort

public WRectF getViewPort()

Returns the viewport.

See Also:

setViewPort(WRectF viewPort)

setWindow

public void setWindow(WRectF window)

Sets the window.

Defines the viewport rectangle in logical coordinates, and thus how logical coordinates map onto the viewPort.

By default, is (0, 0) to (device.width(), device.height()). Thus, the default window and viewport leave logical coordinates identical to device coordinates.

See Also:

getWindow(), setViewPort(WRectF viewPort)

setWindow

public void setWindow(double x,
                      double y,
                      double width,
                      double height)

Sets the window.

This is an overloaded method for convenience.

See Also:

setWindow(WRectF window)

getWindow

public WRectF getWindow()

Returns the current window.

See Also:

setViewPort(WRectF viewPort)

getCombinedTransform

public WTransform getCombinedTransform()

Returns the combined transformation matrix.

Returns the transformation matrix that maps coordinates to device coordinates. It is the combination of the current world transformation (which defines the transformation within the logical coordinate system) and the window/viewport transformation (which transforms logical coordinates to device coordinates).

See Also:

setWorldTransform(WTransform matrix, boolean combine), setViewPort(WRectF viewPort), setWindow(WRectF window)