SelectionBox

Show Deprecated

SelectionBox is an object which renders a 3D box around its Adornee when it is a descendant of the Workspace or anywhere where GUI objects are rendered. The box's geometry consists of rectangular prisms forming an outline/wireframe in addition to a surface for each of its faces. By default, only the outline is visible.

A default SelectionBox adorned to a default Part There are several properties available to configure the appearance of the cube. The outline can modified through the `Class.GuiBase3d.Color3|Color3`†, `Class.GuiBase3d.Transparency|Transparency`† and `Class.SelectionBox.LineThickness|LineThickness` properties. The faces can be modified through the `Class.SelectionBox.SurfaceColor3|SurfaceColor3` and `Class.SelectionBox.SurfaceTransparency|SurfaceTransparency` properties. Finally, rendering of the box can be toggled with the `Class.GuiBase3d.Visible|Visible`† property.

† These properties come from this object's superclass, GuiBase3d.

The SelectionBox object does not capture any form of input; it is solely a visual effect. To capture simple pointer input on the adornee, consider using a ClickDetector.

Summary

Properties

Properties inherited from InstanceAdornmentProperties inherited from GuiBase3d
  • read parallel

    Sets the color of a GUI object.

  • read parallel

    Sets the transparency of a GUI object, where 1 is invisible and 0 is completely visible.

  • read parallel

    Determines whether the object and its descendants will be displayed.

Properties

LineThickness

read parallel

LineThickness determines the thickness of the box's outlines. It is measured in studs, the same unit for BasePart.Size. If set to 0, the outline will not be visible at all.

Three SelectionBoxes with LineThickness values of 0.075, 0.15 (default) and 0.3

Pictured above are three default Parts with default SelectionBoxes applied to them. Their thicknesses from left-to-right are 0.075, 0.15 (default) and 0.3.

See also:

SurfaceColor3

read parallel

SurfaceColor3 determines the color of the SelectionBox's surfaces.

See also:

  • SurfaceTransparency, which controls the transparency of the surfaces. You may need to adjust this property in order to see changes to SurfaceColor.
  • GuiBase3d.Color, a property of the superclass GuiBase3d which controls the color of the outline rather than the surface faces

SurfaceTransparency

read parallel

SurfaceTransparency determines the transparency of the SelectionBox's surfaces, similar to the way BasePart.Transparency works. By default, this property is 1, which causes the surfaces to not be visible.

See also:

Methods

Events