ej.microui.display.transform

Class ImageDeformation

java.lang.Object

ej.microui.display.transform.AbstractTransform

ej.microui.display.transform.ImageDeformation

public class ImageDeformation
extends AbstractTransform

This class holds a context in order to perform a free deformation on images. The deformation is specified by a coordinates array .

An image deformation instance holds a global state for all drawings. Several instances can be created at the same time. However a default instance is created on MicroUI framework startup and is always available.

Since:

2.0

Field Summary

Fields

Modifier and Type	Field and Description
static ImageDeformation	Singleton Default instance created on MicroUI framework startup.

Constructor Summary

Constructors

Constructor and Description
ImageDeformation()

Method Summary

Modifier and Type	Method and Description
void	draw(GraphicsContext gc, Image image, int[] xys, int x, int y, int anchor) Draws a deformed image at the given anchor point. The image anchor point is at position @{code (x,y)}.

Methods inherited from class ej.microui.display.transform.AbstractTransform

getAlpha, getTranslateX, getTranslateY, isMirrored, resetAlpha, resetTranslate, setAlpha, setMirror, translate

Methods inherited from class java.lang.Object

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

Field Detail

Singleton

public static ImageDeformation Singleton

Default instance created on MicroUI framework startup.

Constructor Detail

ImageDeformation

public ImageDeformation()

Method Detail

draw

public void draw(GraphicsContext gc,
                 Image image,
                 int[] xys,
                 int x,
                 int y,
                 int anchor)

Draws a deformed image at the given anchor point.
The image anchor point is at position @{code (x,y)}. Position constants may be given to specify the precise location of the image around the anchor point.

The deformed image is identified by its four corner points. These points are defined by the array of integer coordinates and they must respect the following order: first is the top-left corner, second is the top-right, third is the bottom-right and fourth is the bottom-left.

Examples with img an image and imgWidth and imgHeight its size.

• To draw normal img, the array should be : {0, 0, imgWidth-1, 0, imgWidth-1, imgHeight-1, 0, imgHeight-1}.
• To draw img with a rotation clockwise by 90 degrees, the array should be : {imgHeight-1, 0, imgHeight-1, imgWidth-1, 0, imgWidth-1, 0, 0}.
• To draw img mirrored about the vertical axis, the array should be : {0, 0, -(imgWidth-1), 0, -(imgWidth-1), -(imgHeight-1), 0, -(imgHeight-1)}.
• To draw img with a double scale, the array should be : {0, 0, (imgWidth-1)*2, 0, (imgWidth-1)*2, (imgHeight-1)*2, 0, (imgHeight-1)*2}.

Parameters:

gc - the GraphicsContext where to render the drawing.

image - the Image to draw

x - the x coordinate of the anchor point

y - the y coordinate of the anchor point

xys - the array of coordinates : x1,y1,x2,y2,x3,y3,x4,y4.

anchor - position of the image around the anchor point

Throws:

java.lang.NullPointerException - if @{code image}, @{code gc} or @{code xys} array is @{code null}

java.lang.IllegalArgumentException - if the @{code xys} length is different than 2*4.