class

AArcUIAnimHost

Transparent single-child wrapper the widget factory inserts around every node an animation targets. Layout-transparent always: it reports the child's desired size and hands the child a rect of its full allotted size. Animation state only moves how that rect is drawn — translation shifts it (design pixels, scaled to the viewport by the screen-root canvas), scale and rotation are a render transform about its centre (painted, and inverted for hit testing), opacity multiplies the whole subtree through the renderer's layer stack. No setter invalidates layout: a pulsing button never re-measures or re-wraps its text.

Module
ArcUI
Header
#include "ArcUI/Widgets/AArcUIAnimHost.h"
Namespace
Arcf

Public functions

ReturnsNameDescription
ArcVec2ComputeDesiredSize
voidArrangeChildren
int32_tOnPaint
const char*GetTypeName
voidSetAnimTranslationX
voidSetAnimTranslationY
voidSetAnimScale
voidSetAnimOpacity
voidSetAnimRotation
voidResetAnimState
ArcVec2GetAnimTranslation
floatGetAnimScale
floatGetAnimOpacity
floatGetAnimRotation
ArcMat3BuildRotationMatrixRotation about the child's centre, in absolute pixels.
ArcMat3BuildRenderTransformScale then rotation about the child's centre; identity at rest.
boolHasRenderTransform
voidSetDesignUnitScaleThe design-pixel → viewport-pixel factor translations are multiplied by.
floatGetDesignUnitScale

Function details

ComputeDesiredSize

C++
ArcVec2 ComputeDesiredSize(float scale) const override

ArrangeChildren

C++
void ArrangeChildren(const CGeometry& geo) override

OnPaint

C++
int32_t OnPaint(const CArcPaintArgs& args, const CGeometry& geo, CArcUIRenderer& renderer, int32_t layerId) const override

GetTypeName

C++
const char* GetTypeName() const override

SetAnimTranslationX

C++
void SetAnimTranslationX(float designUnits)

SetAnimTranslationY

C++
void SetAnimTranslationY(float designUnits)

SetAnimScale

C++
void SetAnimScale(float scale)

SetAnimOpacity

C++
void SetAnimOpacity(float opacity)

SetAnimRotation

C++
void SetAnimRotation(float degrees)

ResetAnimState

C++
void ResetAnimState()

GetAnimTranslation

C++
ArcVec2 GetAnimTranslation() const

GetAnimScale

C++
float GetAnimScale() const

GetAnimOpacity

C++
float GetAnimOpacity() const

GetAnimRotation

C++
float GetAnimRotation() const

BuildRotationMatrix

C++
ArcMat3 BuildRotationMatrix(const CGeometry& childGeo) const

Rotation about the child's centre, in absolute pixels. Identity while the rotation track is at zero, which is what keeps the untouched UI on the renderer's no-transform fast path.

BuildRenderTransform

C++
ArcMat3 BuildRenderTransform(const CGeometry& childGeo) const

Scale then rotation about the child's centre; identity at rest.

HasRenderTransform

C++
bool HasRenderTransform() const

SetDesignUnitScale

C++
static void SetDesignUnitScale(float scale)

The design-pixel → viewport-pixel factor translations are multiplied by. The screen-root canvas writes it at the top of every arrange pass, so hosts below it read the value of the screen they belong to.

GetDesignUnitScale

C++
static float GetDesignUnitScale()
Generated from ArcUI/Widgets/AArcUIAnimHost.h via arcui.json · Nov 4, 2026Version 1.0.0