Package com.storedobject.svg

Class TransformMatrix<N extends Node>

java.lang.Object

com.storedobject.svg.TransformMatrix<N>

Type Parameters:

N - The type of Node this transformation matrix is associated with.

All Implemented Interfaces:

Serializable

public class TransformMatrix<N extends Node>
extends Object
implements Serializable

Represents a transformation matrix for a Node. This class provides various transformation operations like translation, scaling, rotation, and flipping. Transformations are applied to the node's coordinate system.

Author:

Syam

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
TransformMatrix(N node)	Constructs a new TransformMatrix for the specified node.

Method Summary

Modifier and Type	Method	Description
TransformMatrix<N>	flipHorizontally()	Flips the transformation matrix horizontally around the node's center.
TransformMatrix<N>	flipHorizontallyAroundOrigin()	Flips the transformation matrix horizontally around the origin.
TransformMatrix<N>	flipVertically()	Flips the transformation matrix vertically around the node's center.
TransformMatrix<N>	flipVerticallyAroundOrigin()	Flips the transformation matrix vertically around the origin.
N	get()	Returns the node associated with this transformation matrix.
Coordinates	getCoordinates()	Returns the bounding coordinates of the node after applying the transformation matrix.
TransformMatrix<N>	moveTo(double x, double y)	Moves the top-left corner of the node to the specified (x, y) coordinate.
TransformMatrix<N>	moveTo(Point point)	Moves the top-left corner of the node to the specified Point.
TransformMatrix<N>	reset()	Resets the transformation matrix to the identity matrix.
TransformMatrix<N>	rotate(double degrees)	Rotates the transformation matrix by a given angle around the origin.
TransformMatrix<N>	rotateAround(double angleDegrees, double x, double y)	Rotates the transformation matrix by a given angle around a specified point (x, y).
TransformMatrix<N>	rotateAround(double angleDegrees, Point point)	Rotates the transformation matrix by a given angle around a specified Point.
TransformMatrix<N>	rotateAroundCenter(double angleDegrees)	Rotates the transformation matrix by a given angle around the node's center.
TransformMatrix<N>	scale(double scale)	Scales the transformation matrix uniformly by the given factor.
TransformMatrix<N>	scale(double sx, double sy)	Scales the transformation matrix by the given factors sx and sy.
TransformMatrix<N>	scaleHeightTo(double targetHeight)	Scales the node's height to the specified target height.
TransformMatrix<N>	scaleTo(double targetWidth, double targetHeight)	Scales the node to the specified target width and height.
TransformMatrix<N>	scaleWidthTo(double targetWidth)	Scales the node's width to the specified target width.
TransformMatrix<N>	shear(double kx, double ky)	Applies a shear transformation to the transformation matrix.
String	toString()	Returns a string representation of the transformation matrix as an SVG transform attribute.
TransformMatrix<N>	translate(double tx, double ty)	Translates the transformation matrix by a given offset (tx, ty).
TransformMatrix<N>	translate(Point point)	Translates the transformation matrix by a given offset specified as a Point.

Methods inherited from class java.lang.Object

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

Constructor Details

TransformMatrix

public TransformMatrix(N node)

Constructs a new TransformMatrix for the specified node.

Parameters:

node - The node to be transformed.

Method Details

get

public N get()

Returns the node associated with this transformation matrix.

Returns:

The node.

translate

public TransformMatrix<N> translate(Point point)

Translates the transformation matrix by a given offset specified as a Point.

Parameters:

point - The offset point for translation.

Returns:

This transformation matrix for chaining.

translate

public TransformMatrix<N> translate(double tx,
 double ty)

Translates the transformation matrix by a given offset (tx, ty).

Parameters:

tx - The distance to translate along the x-axis.

ty - The distance to translate along the y-axis.

Returns:

This transformation matrix for chaining.

moveTo

public TransformMatrix<N> moveTo(Point point)

Moves the top-left corner of the node to the specified Point.

Parameters:

point - The destination point.

Returns:

This transformation matrix for chaining.

moveTo

public TransformMatrix<N> moveTo(double x,
 double y)

Moves the top-left corner of the node to the specified (x, y) coordinate.

Parameters:

x - The destination x-coordinate.

y - The destination y-coordinate.

Returns:

This transformation matrix for chaining.

scaleTo

public TransformMatrix<N> scaleTo(double targetWidth,
 double targetHeight)

Scales the node to the specified target width and height.

Parameters:

targetWidth - The target width.

targetHeight - The target height.

Returns:

This transformation matrix for chaining.

scaleWidthTo

public TransformMatrix<N> scaleWidthTo(double targetWidth)

Scales the node's width to the specified target width.

Parameters:

targetWidth - The target width.

Returns:

This transformation matrix for chaining.

scaleHeightTo

public TransformMatrix<N> scaleHeightTo(double targetHeight)

Scales the node's height to the specified target height.

Parameters:

targetHeight - The target height.

Returns:

This transformation matrix for chaining.

scale

public TransformMatrix<N> scale(double sx,
 double sy)

Scales the transformation matrix by the given factors sx and sy.

Parameters:

sx - The scaling factor along the x-axis.

sy - The scaling factor along the y-axis.

Returns:

This transformation matrix for chaining.

scale

public TransformMatrix<N> scale(double scale)

Scales the transformation matrix uniformly by the given factor.

Parameters:

scale - The scaling factor.

Returns:

This transformation matrix for chaining.

rotate

public TransformMatrix<N> rotate(double degrees)

Rotates the transformation matrix by a given angle around the origin.

Parameters:

degrees - The clockwise angle of rotation in degrees.

Returns:

This transformation matrix for chaining.

rotateAround

public TransformMatrix<N> rotateAround(double angleDegrees,
 double x,
 double y)

Rotates the transformation matrix by a given angle around a specified point (x, y).

Parameters:

angleDegrees - clockwise The angle of rotation in degrees.

x - The x-coordinate of the rotation center.

y - The y-coordinate of the rotation center.

Returns:

This transformation matrix for chaining.

rotateAround

public TransformMatrix<N> rotateAround(double angleDegrees,
 Point point)

Rotates the transformation matrix by a given angle around a specified Point.

Parameters:

angleDegrees - The clockwise angle of rotation in degrees.

point - The point around which to rotate.

Returns:

This transformation matrix for chaining.

rotateAroundCenter

public TransformMatrix<N> rotateAroundCenter(double angleDegrees)

Rotates the transformation matrix by a given angle around the node's center.

Parameters:

angleDegrees - The clockwise angle of rotation in degrees.

Returns:

This transformation matrix for chaining.

flipVerticallyAroundOrigin

public TransformMatrix<N> flipVerticallyAroundOrigin()

Flips the transformation matrix vertically around the origin.

Returns:

This transformation matrix for chaining.

flipVertically

public TransformMatrix<N> flipVertically()

Flips the transformation matrix vertically around the node's center.

Returns:

This transformation matrix for chaining.

flipHorizontallyAroundOrigin

public TransformMatrix<N> flipHorizontallyAroundOrigin()

Flips the transformation matrix horizontally around the origin.

Returns:

This transformation matrix for chaining.

flipHorizontally

public TransformMatrix<N> flipHorizontally()

Flips the transformation matrix horizontally around the node's center.

Returns:

This transformation matrix for chaining.

getCoordinates

public Coordinates getCoordinates()

Returns the bounding coordinates of the node after applying the transformation matrix.

Returns:

The bounding Coordinates.

shear

public TransformMatrix<N> shear(double kx,
 double ky)

Applies a shear transformation to the transformation matrix.

Parameters:

kx - The shear factor along the x-axis.

ky - The shear factor along the y-axis.

Returns:

This transformation matrix for chaining.

toString

public String toString()

Returns a string representation of the transformation matrix as an SVG transform attribute.

Overrides:

toString in class Object

Returns:

A string in the format transform="matrix(...)" or an empty string if it's an identity matrix.

reset

public TransformMatrix<N> reset()

Resets the transformation matrix to the identity matrix.

Returns:

This transformation matrix for chaining.