CanvasGroup¶
Blends descendants as a flattened group with an optional color/transparency modification.
Not implemented yet
Group clipping and tinting are not implemented.
Workaround: Tint children individually; use a Frame with ClipsDescendants for clipping.
Description¶
CanvasGroup renders its descendants as a flattened group with
GroupColor3 and
GroupTransparency optionally applied to
the rendered result. UIComponent visual modifiers such as
UICorner and UIGradient under a CanvasGroup will also apply
to the whole group. Note that CanvasGroup always has
ClipsDescendants set to true and all
descendants will be clipped outside the group's bounds.
Important Notes¶
- Descendants of
CanvasGroupwill be rendered as a flattened texture only when the ancestor LayerCollector has its ZIndexBehavior set to ZIndexBehavior.Sibling. CanvasGroupconsumes extra texture memory. The quality of the texture and total memory usage is limited by the QualityLevel of the client. When exceeding the memory cap,CanvasGroupwill render as a blank texture.- It's recommended to use
CanvasGroupwith static sizes, otherwise a new texture would need to be created to accommodate new sizes.
Inheritance¶
Object → Instance → GuiBase → GuiBase2d → GuiObject → CanvasGroup
Properties¶
| Member | Signature | Summary |
|---|---|---|
GroupColor3 |
GroupColor3: Color3 |
Color tint that applies to the rendered group. |
GroupTransparency |
GroupTransparency: float |
Transparency that applies to the rendered group. |
ResolutionScale |
ResolutionScale: float |
— |
Roblox reference: CanvasGroup
Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.