Package com.microej.painter

Class TransformedImagePainter

java.lang.Object

com.microej.painter.TransformedImagePainter

public class TransformedImagePainter
extends Object

The TransformedImagePainter class provides static methods to draw an image with a transformation defined by a Matrix.

In all the provided drawing APIs, the image pixels color is multiplied with the graphics context's color.

The drawings can be performed either using the bilinear algorithm or the nearest neighbor algorithm. The bilinear algorithm produces a prettier rendering but takes more time.

Constructor Summary

Constructors

Constructor	Description
TransformedImagePainter()

Method Summary

Modifier and Type	Method	Description
static void	drawImage(GraphicsContext gc, Image image, Matrix matrix, boolean bilinear)	Draws the given image with a transformation defined by the given matrix.
static void	drawImage(GraphicsContext gc, Image image, Matrix matrix, boolean bilinear, int alpha, BlendMode blendMode)	Draws the given image with a transformation defined by the given matrix.
static void	drawImageRegion(GraphicsContext gc, Image image, int regionX, int regionY, int regionWidth, int regionHeight, Matrix matrix, boolean bilinear, int alpha, BlendMode blendMode)	Draws a region of the given image with a transformation defined by the given matrix.

Methods inherited from class java.lang.Object

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

Constructor Detail

TransformedImagePainter

public TransformedImagePainter()

Method Detail

drawImage

public static void drawImage(GraphicsContext gc,
                             Image image,
                             Matrix matrix,
                             boolean bilinear)

Draws the given image with a transformation defined by the given matrix.

Equivalent to calling drawImage(GraphicsContext, Image, Matrix, boolean, int, BlendMode) with GraphicsContext.OPAQUE as alpha and BlendMode.SRC_OVER as blend mode.

Parameters:

gc - the graphics context to use.

image - the image to render.

matrix - the transformation matrix to apply.

bilinear - whether to use the bilinear algorithm or the nearest neighbor algorithm.

drawImage

public static void drawImage(GraphicsContext gc,
                             Image image,
                             Matrix matrix,
                             boolean bilinear,
                             int alpha,
                             BlendMode blendMode)

Draws the given image with a transformation defined by the given matrix.

In addition with drawImage(GraphicsContext, Image, Matrix, boolean), this method allows to specify the global opacity value to apply during the image rendering. The blend mode specifies the algorithm to use when blending the pixels of the source and destination.

Parameters:

gc - the graphics context to use.

image - the image to render.

matrix - the transformation matrix to apply.

bilinear - whether to use the bilinear algorithm or the nearest neighbor algorithm.

alpha - the global opacity rendering value.

blendMode - the blend mode.

Throws:

IllegalArgumentException - if the given alpha is not a value between GraphicsContext.TRANSPARENT and GraphicsContext.OPAQUE.

drawImageRegion

public static void drawImageRegion(GraphicsContext gc,
                                   Image image,
                                   int regionX,
                                   int regionY,
                                   int regionWidth,
                                   int regionHeight,
                                   Matrix matrix,
                                   boolean bilinear,
                                   int alpha,
                                   BlendMode blendMode)

Draws a region of the given image with a transformation defined by the given matrix.

Parameters:

gc - the graphics context to use.

image - the image to render.

regionX - the x coordinate of the region in the image.

regionY - the y coordinate of the region in the image.

regionWidth - the width of the region.

regionHeight - the height of the region.

matrix - the transformation matrix to apply.

bilinear - whether to use the bilinear algorithm or the nearest neighbor algorithm.

alpha - the global opacity rendering value.

blendMode - the blend mode.

Throws:

IllegalArgumentException - if the given alpha is not a value between GraphicsContext.TRANSPARENT and GraphicsContext.OPAQUE.