struct · iOS 18.0+ · SDK 27.1
struct OpacityComponentA component that controls the opacity of an entity and its descendants. An opacity component multiplies its ``OpacityComponent/opacity`` property with all visual components the entity and its descendants own. Visual components include ``ModelComponent`` and ``ParticleEmitterComponent``. If a descendant also has its own opacity component, the system combines the two opacities by multiplying their values. The system repeats this pattern for the entity's entire family tree. For example, the following code sets a component's opacity value to `0.5` for its entity: ```swift // Load a USDZ model from a file, or create a model component. let robot = try await Entity(named: "vintage_robot") // Create an opacity component. let opacityComponent = OpacityComponent(opacity: 0.5) // Apply the opacity component to the robot entity. robot.components.set(opacityComponent) ``` The following images show robot models with opacity values of `1.0` and `0.5`. | `opacity: 1` | `opacity: 0.5` | |:-:|:-:| |  |  |
static init(opacity?: number): OpacityComponentinit(opacity: Float = 1.0)Creates a new opacity component. - Parameters: - opacity: A floating-point value in the range `[0.0, 1.0]`, where `0.0` is completely transparent and `1.0` is completely opaque.
get opacity(): numbervar opacity: FloatThe floating-point value the renderer applies to an entity and its descendants. The opacity is a float within the inclusive range `[0.0, 1.0]`, where `0.0` is completely transparent and `1.0` is completely opaque.
set opacity(value: number)var opacity: FloatThe floating-point value the renderer applies to an entity and its descendants. The opacity is a float within the inclusive range `[0.0, 1.0]`, where `0.0` is completely transparent and `1.0` is completely opaque.
No declarations were skipped in this snapshot.