Class
HandleAdornment
NotCreatable
An abstract class inherited by 3D handle adornments.
HandleAdornment is an abstract class inherited by 3D handle adornments. If
parented to a player's PlayerGui or the CoreGui, handles can
listen to input events for purposes such as making dragger tools.
Properties 5#
AdornCullingModeAdornCullingMode | Determines whether to automatically cull the adornment.ReadSafe |
AlwaysOnTopboolean | Forces this adornment to render on top of all 3D objects in the workspace.ReadSafe |
CFrameCFrame | The position and rotation of the object relative to its
PVAdornment.Adornee.ReadSafe |
SizeRelativeOffsetVector3 | The positional offset of the adornment based on the adornee's
BasePart.Size.ReadSafe |
ZIndexint | Determines the draw order of this HandleAdornment when
AlwaysOnTop is true.ReadSafe |
AdornCullingMode: AdornCullingMode#
ReadSafe
This property determines whether to automatically cull the adornment based on distance from the camera.
AlwaysOnTop: boolean#
ReadSafe
If true, forces this adornment to render on top of all 3D objects in the
workspace. As an exception, setting ZIndex
to -1 will override an AlwaysOnTop
value of true and cause the adornment to appear either in front of or
behind other adornments and objects based on their relative position in
the 3D space.
CFrame: CFrame#
ReadSafe
CFrame position and rotation relative to its
PVAdornment.Adornee, applied after any translations due to
SizeRelativeOffset.
SizeRelativeOffset: Vector3#
ReadSafe
By default, an adornment draws in the center of its
Adornee, but this property shifts the
adornment's relative position based on the adornee's
BasePart.Size.
Note that the units of
SizeRelativeOffset are a
scale based on the size of the adornee itself, such that a value of
1 will move the adornment to the corresponding edge of the adornee. For
example, a value of Datatype.Vector3.new(0, 1, 0) will shift the
adornment to the exact top of its adornee.
ZIndex: int#
ReadSafe
Only applies if AlwaysOnTop is true
and determines the draw order of this HandleAdornment relative to
other adornments. It does not relate to the
ZIndex property for GuiObjects.
Valid values are from -1 to 10 with higher values drawing on top (in
front) of lesser values. This drawing order will be respected even if an
adornment is in front of or behind another adornment in the 3D space.
As an exception, setting ZIndex to -1 or
AlwaysOnTop to false will cause the
adornment to appear either in front of or behind other adornments and
objects based on their relative position in the 3D space.
Events 4#
| MouseButton1Down | Fires when a player presses down on their left mouse button while hovering over the adornment. |
| MouseButton1Up | Fires when a player releases their left mouse button while hovering over the adornment. |
| MouseEnter | Fires when a player moves their mouse over the adornment. |
| MouseLeave | Fires when a player moves their mouse out of the adornment. |
Inherited members#
Inherited from PVAdornment 1
Properties (1)
Inherited from GuiBase3d 4
Properties (4)
Inherited from Instance 58
Properties (10)
Archivable, archivable, Capabilities, IsInSandbox, Name, Parent, PredictionMode, RobloxLocked, Sandboxed, UniqueId
Methods (39)
AddTag, children, ClearAllChildren, Clone, clone, Destroy, destroy, FindFirstAncestor, FindFirstAncestorOfClass, FindFirstAncestorWhichIsA, FindFirstChild, findFirstChild, FindFirstChildOfClass, FindFirstChildWhichIsA, FindFirstDescendant, GetActor, GetAttribute, GetAttributeChangedSignal, GetAttributes, GetChildren, getChildren, GetDebugId, GetDescendants, GetFullName, GetStyled, GetStyledPropertyChangedSignal, GetTags, HasTag, IsAncestorOf, IsDescendantOf, isDescendantOf, IsPropertyModified, QueryDescendants, Remove, remove, RemoveTag, ResetPropertyToDefault, SetAttribute, WaitForChild
Subclasses 8#
BoxHandleAdornment, ConeHandleAdornment, CylinderHandleAdornment, ImageHandleAdornment, LineHandleAdornment, PyramidHandleAdornment, SphereHandleAdornment, WireframeHandleAdornment