Class GuiTransform

java.lang.Object

com.render.api.gui.effects.GuiTransform

public final class GuiTransform
extends Object

Immutable ordered component-transform list.

The compositor resolver executes affine and perspective 3D transforms. A transformed component is represented by the projective homography produced by intersecting its local z=0 plane with the GUI viewport.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	GuiTransform.Affine	Resolved CSS-compatible 2D affine matrix.
static final record	GuiTransform.AxisAligned	Resolved portable axis-aligned transform used by paint and input.
static final record	GuiTransform.Matrix2d	CSS-compatible 2D matrix using x' = a*x + c*y + tx and y' = b*x + d*y + ty.
static interface	GuiTransform.Operation	One transform operation in the authored list.
static final record	GuiTransform.Perspective
static final record	GuiTransform.Point
static final record	GuiTransform.Projective	Invertible 2D homography used for perspective paint and hit testing.
static final record	GuiTransform.Rotate
static final record	GuiTransform.Rotate3d
static final record	GuiTransform.Scale
static final record	GuiTransform.Scale3d
static final record	GuiTransform.Skew
static final record	GuiTransform.Translate
static final record	GuiTransform.Translate3d

Field Summary

Fields

Modifier and Type	Field	Description
static final GuiTransform	NONE

Constructor Summary

Constructors

Constructor	Description
GuiTransform(List<? extends GuiTransform.Operation> operations)

Method Summary

Modifier and Type	Method	Description
boolean	isNone()
static GuiTransform	of(GuiTransform.Operation... operations)
List<GuiTransform.Operation>	operations()
Optional<GuiTransform.Affine>	resolveAffine(GuiRect reference, GuiTransformOrigin origin)	Resolves this list against a reference box as an invertible 2D affine transform.
Optional<GuiTransform.AxisAligned>	resolveAxisAligned(GuiRect reference, GuiTransformOrigin origin)	Resolves this list against a reference box and returns a portable axis-aligned transform when possible.
Optional<GuiTransform.Projective>	resolveProjective(GuiRect reference, GuiTransformOrigin origin)	Resolves this transform list to an invertible projective mapping of the component plane.
static GuiTransform	rotate(float degrees)
static GuiTransform	scale(float scale)
static GuiTransform	scale(float x, float y)
GuiTransform	then(GuiTransform.Operation operation)
static GuiTransform	translate(float x, float y)

Methods inherited from class Object

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

Field Details

NONE

public static final GuiTransform NONE

Constructor Details

GuiTransform

public GuiTransform(List<? extends GuiTransform.Operation> operations)

Method Details

of

public static GuiTransform of(GuiTransform.Operation... operations)

translate

public static GuiTransform translate(float x,
 float y)

scale

public static GuiTransform scale(float scale)

scale

public static GuiTransform scale(float x,
 float y)

rotate

public static GuiTransform rotate(float degrees)

then

public GuiTransform then(GuiTransform.Operation operation)

operations

public List<GuiTransform.Operation> operations()

isNone

public boolean isNone()

resolveAxisAligned

public Optional<GuiTransform.AxisAligned> resolveAxisAligned(GuiRect reference,
 GuiTransformOrigin origin)

Resolves this list against a reference box and returns a portable axis-aligned transform when possible.

Parameters:

reference - transform reference box

origin - normalized transform origin

Returns:

resolved transform, or empty for a non-axis-aligned/3D matrix

resolveAffine

public Optional<GuiTransform.Affine> resolveAffine(GuiRect reference,
 GuiTransformOrigin origin)

Resolves this list against a reference box as an invertible 2D affine transform.

Parameters:

reference - transform reference box

origin - normalized transform origin

Returns:

resolved affine transform, or empty for perspective/non-planar 3D

resolveProjective

public Optional<GuiTransform.Projective> resolveProjective(GuiRect reference,
 GuiTransformOrigin origin)

Resolves this transform list to an invertible projective mapping of the component plane.

Parameters:

reference - transform reference box

origin - normalized transform origin

Returns:

resolved homography, or empty for a singular/non-finite mapping