Chapter 641: BundleGroup

Core Idea

A specialized group which enables applications access to the Render Bundle API of WebGPU. The group with all its descendant nodes are considered as one render bundle and processed as such by the renderer.

This module is only fully supported by WebGPURenderer with a WebGPU backend. With a WebGL backend, the group can technically be rendered but without any performance improvements.

Key Concepts

• isBundleGroup : boolean (readonly): This flag can be used for type testing.
• needsUpdate : boolean: Set this property to true when the bundle group has changed.
• static : boolean: Whether the bundle is static or not. When set to true, the structure is assumed to be static and does not change. E.g. no new objects are…
• type : string (readonly): This property is only relevant for detecting types during serialization/deserialization. It should always match the class name.
• version : number (readonly): The bundle group's version.

Reference Tables

Constructor

Signature
new BundleGroup()

Properties

Property	Description
.isBundleGroup : boolean (readonly)	This flag can be used for type testing.
.needsUpdate : boolean	Set this property to true when the bundle group has changed.
.static : boolean	Whether the bundle is static or not. When set to true, the structure is assumed to be static and does not change. E.g. no new objects are added to the group.
.type : string (readonly)	This property is only relevant for detecting types during serialization/deserialization. It should always match the class name.
.version : number (readonly)	The bundle group's version.

Key Takeaways

1. BundleGroup extends: EventDispatcher → Object3D → Group
2. Most relevant properties: isBundleGroup, needsUpdate, static, type.

Connects To

• EventDispatcher: parent class
• Object3D: parent class
• Group: parent class
• Source: src/renderers/common/BundleGroup.js