📄 RenderList.js
¶
📊 Analysis Summary¶
Metric | Count |
---|---|
🔧 Functions | 11 |
🧱 Classes | 1 |
📦 Imports | 1 |
📊 Variables & Constants | 3 |
📚 Table of Contents¶
🛠️ File Location:¶
📂 src/renderers/common/RenderList.js
📦 Imports¶
Name | Source |
---|---|
DoubleSide |
../../constants.js |
Variables & Constants¶
Name | Type | Kind | Value | Exported |
---|---|---|---|---|
hasTransmission |
any |
let/var | material.transmission > 0 \|\| material.transmissionNode |
✗ |
renderItem |
any |
let/var | this.renderItems[ this.renderItemsIndex ] |
✗ |
renderItem |
any |
let/var | this.renderItems[ i ] |
✗ |
Functions¶
painterSortStable(a: any, b: any): number
¶
JSDoc:
/**
* Default sorting function for opaque render items.
*
* @private
* @function
* @param {Object} a - The first render item.
* @param {Object} b - The second render item.
* @return {number} A numeric value which defines the sort order.
*/
Parameters:
a
any
b
any
Returns: number
Code
reversePainterSortStable(a: any, b: any): number
¶
JSDoc:
/**
* Default sorting function for transparent render items.
*
* @private
* @function
* @param {Object} a - The first render item.
* @param {Object} b - The second render item.
* @return {number} A numeric value which defines the sort order.
*/
Parameters:
a
any
b
any
Returns: number
Code
needsDoublePass(material: Material): boolean
¶
JSDoc:
/**
* Returns `true` if the given transparent material requires a double pass.
*
* @private
* @function
* @param {Material} material - The transparent material.
* @return {boolean} Whether the given material requires a double pass or not.
*/
Parameters:
material
Material
Returns: boolean
Code
RenderList.begin(): RenderList
¶
JSDoc:
/**
* This method is called right at the beginning of a render call
* before the scene is analyzed. It prepares the internal data
* structures for the upcoming render lists generation.
*
* @return {RenderList} A reference to this render list.
*/
Returns: RenderList
Code
RenderList.getNextRenderItem(object: Object3D, geometry: BufferGeometry, material: Material, groupOrder: number, z: number, group: number, clippingContext: ClippingContext): any
¶
JSDoc:
/**
* Returns a render item for the giving render item state. The state is defined
* by a series of object-related parameters.
*
* The method avoids object creation by holding render items and reusing them in
* subsequent render calls (just with different property values).
*
* @param {Object3D} object - The 3D object.
* @param {BufferGeometry} geometry - The 3D object's geometry.
* @param {Material} material - The 3D object's material.
* @param {number} groupOrder - The current group order.
* @param {number} z - Th 3D object's depth value (z value in clip space).
* @param {?number} group - {?Object} group - Only relevant for objects using multiple materials. This represents a group entry from the respective `BufferGeometry`.
* @param {ClippingContext} clippingContext - The current clipping context.
* @return {Object} The render item.
*/
Parameters:
object
Object3D
geometry
BufferGeometry
material
Material
groupOrder
number
z
number
group
number
clippingContext
ClippingContext
Returns: any
Code
getNextRenderItem( object, geometry, material, groupOrder, z, group, clippingContext ) {
let renderItem = this.renderItems[ this.renderItemsIndex ];
if ( renderItem === undefined ) {
renderItem = {
id: object.id,
object: object,
geometry: geometry,
material: material,
groupOrder: groupOrder,
renderOrder: object.renderOrder,
z: z,
group: group,
clippingContext: clippingContext
};
this.renderItems[ this.renderItemsIndex ] = renderItem;
} else {
renderItem.id = object.id;
renderItem.object = object;
renderItem.geometry = geometry;
renderItem.material = material;
renderItem.groupOrder = groupOrder;
renderItem.renderOrder = object.renderOrder;
renderItem.z = z;
renderItem.group = group;
renderItem.clippingContext = clippingContext;
}
this.renderItemsIndex ++;
return renderItem;
}
RenderList.push(object: Object3D, geometry: BufferGeometry, material: Material, groupOrder: number, z: number, group: number, clippingContext: ClippingContext): void
¶
JSDoc:
/**
* Pushes the given object as a render item to the internal render lists.
* The selected lists depend on the object properties.
*
* @param {Object3D} object - The 3D object.
* @param {BufferGeometry} geometry - The 3D object's geometry.
* @param {Material} material - The 3D object's material.
* @param {number} groupOrder - The current group order.
* @param {number} z - Th 3D object's depth value (z value in clip space).
* @param {?number} group - {?Object} group - Only relevant for objects using multiple materials. This represents a group entry from the respective `BufferGeometry`.
* @param {ClippingContext} clippingContext - The current clipping context.
*/
Parameters:
object
Object3D
geometry
BufferGeometry
material
Material
groupOrder
number
z
number
group
number
clippingContext
ClippingContext
Returns: void
Calls:
this.getNextRenderItem
needsDoublePass
this.transparentDoublePass.push
this.transparent.push
this.opaque.push
Code
push( object, geometry, material, groupOrder, z, group, clippingContext ) {
const renderItem = this.getNextRenderItem( object, geometry, material, groupOrder, z, group, clippingContext );
if ( object.occlusionTest === true ) this.occlusionQueryCount ++;
if ( material.transparent === true || material.transmission > 0 ) {
if ( needsDoublePass( material ) ) this.transparentDoublePass.push( renderItem );
this.transparent.push( renderItem );
} else {
this.opaque.push( renderItem );
}
}
RenderList.unshift(object: Object3D, geometry: BufferGeometry, material: Material, groupOrder: number, z: number, group: number, clippingContext: ClippingContext): void
¶
JSDoc:
/**
* Inserts the given object as a render item at the start of the internal render lists.
* The selected lists depend on the object properties.
*
* @param {Object3D} object - The 3D object.
* @param {BufferGeometry} geometry - The 3D object's geometry.
* @param {Material} material - The 3D object's material.
* @param {number} groupOrder - The current group order.
* @param {number} z - Th 3D object's depth value (z value in clip space).
* @param {?number} group - {?Object} group - Only relevant for objects using multiple materials. This represents a group entry from the respective `BufferGeometry`.
* @param {ClippingContext} clippingContext - The current clipping context.
*/
Parameters:
object
Object3D
geometry
BufferGeometry
material
Material
groupOrder
number
z
number
group
number
clippingContext
ClippingContext
Returns: void
Calls:
this.getNextRenderItem
needsDoublePass
this.transparentDoublePass.unshift
this.transparent.unshift
this.opaque.unshift
Code
unshift( object, geometry, material, groupOrder, z, group, clippingContext ) {
const renderItem = this.getNextRenderItem( object, geometry, material, groupOrder, z, group, clippingContext );
if ( material.transparent === true || material.transmission > 0 ) {
if ( needsDoublePass( material ) ) this.transparentDoublePass.unshift( renderItem );
this.transparent.unshift( renderItem );
} else {
this.opaque.unshift( renderItem );
}
}
RenderList.pushBundle(group: any): void
¶
JSDoc:
/**
* Pushes render bundle group data into the render list.
*
* @param {Object} group - Bundle group data.
*/
Parameters:
group
any
Returns: void
Calls:
this.bundles.push
RenderList.pushLight(light: Light): void
¶
JSDoc:
Parameters:
light
Light
Returns: void
Calls:
this.lightsArray.push
RenderList.sort(customOpaqueSort: (arg0: any, arg1: any) => number, customTransparentSort: (arg0: any, arg1: any) => number): void
¶
JSDoc:
/**
* Sorts the internal render lists.
*
* @param {?function(any, any): number} customOpaqueSort - A custom sort function for opaque objects.
* @param {?function(any, any): number} customTransparentSort - A custom sort function for transparent objects.
*/
Parameters:
customOpaqueSort
(arg0: any, arg1: any) => number
customTransparentSort
(arg0: any, arg1: any) => number
Returns: void
Calls:
this.opaque.sort
this.transparentDoublePass.sort
this.transparent.sort
Code
sort( customOpaqueSort, customTransparentSort ) {
if ( this.opaque.length > 1 ) this.opaque.sort( customOpaqueSort || painterSortStable );
if ( this.transparentDoublePass.length > 1 ) this.transparentDoublePass.sort( customTransparentSort || reversePainterSortStable );
if ( this.transparent.length > 1 ) this.transparent.sort( customTransparentSort || reversePainterSortStable );
}
RenderList.finish(): void
¶
JSDoc:
Returns: void
Calls:
this.lightsNode.setLights
Internal Comments:
Code
finish() {
// update lights
this.lightsNode.setLights( this.lightsArray );
// Clear references from inactive renderItems in the list
for ( let i = this.renderItemsIndex, il = this.renderItems.length; i < il; i ++ ) {
const renderItem = this.renderItems[ i ];
if ( renderItem.id === null ) break;
renderItem.id = null;
renderItem.object = null;
renderItem.geometry = null;
renderItem.material = null;
renderItem.groupOrder = null;
renderItem.renderOrder = null;
renderItem.z = null;
renderItem.group = null;
renderItem.clippingContext = null;
}
}
Classes¶
RenderList
¶
Class Code
class RenderList {
/**
* Constructs a render list.
*
* @param {Lighting} lighting - The lighting management component.
* @param {Scene} scene - The scene.
* @param {Camera} camera - The camera the scene is rendered with.
*/
constructor( lighting, scene, camera ) {
/**
* 3D objects are transformed into render items and stored in this array.
*
* @type {Array<Object>}
*/
this.renderItems = [];
/**
* The current render items index.
*
* @type {number}
* @default 0
*/
this.renderItemsIndex = 0;
/**
* A list with opaque render items.
*
* @type {Array<Object>}
*/
this.opaque = [];
/**
* A list with transparent render items which require
* double pass rendering (e.g. transmissive objects).
*
* @type {Array<Object>}
*/
this.transparentDoublePass = [];
/**
* A list with transparent render items.
*
* @type {Array<Object>}
*/
this.transparent = [];
/**
* A list with transparent render bundle data.
*
* @type {Array<Object>}
*/
this.bundles = [];
/**
* The render list's lights node. This node is later
* relevant for the actual analytical light nodes which
* compute the scene's lighting in the shader.
*
* @type {LightsNode}
*/
this.lightsNode = lighting.getNode( scene, camera );
/**
* The scene's lights stored in an array. This array
* is used to setup the lights node.
*
* @type {Array<Light>}
*/
this.lightsArray = [];
/**
* The scene.
*
* @type {Scene}
*/
this.scene = scene;
/**
* The camera the scene is rendered with.
*
* @type {Camera}
*/
this.camera = camera;
/**
* How many objects perform occlusion query tests.
*
* @type {number}
* @default 0
*/
this.occlusionQueryCount = 0;
}
/**
* This method is called right at the beginning of a render call
* before the scene is analyzed. It prepares the internal data
* structures for the upcoming render lists generation.
*
* @return {RenderList} A reference to this render list.
*/
begin() {
this.renderItemsIndex = 0;
this.opaque.length = 0;
this.transparentDoublePass.length = 0;
this.transparent.length = 0;
this.bundles.length = 0;
this.lightsArray.length = 0;
this.occlusionQueryCount = 0;
return this;
}
/**
* Returns a render item for the giving render item state. The state is defined
* by a series of object-related parameters.
*
* The method avoids object creation by holding render items and reusing them in
* subsequent render calls (just with different property values).
*
* @param {Object3D} object - The 3D object.
* @param {BufferGeometry} geometry - The 3D object's geometry.
* @param {Material} material - The 3D object's material.
* @param {number} groupOrder - The current group order.
* @param {number} z - Th 3D object's depth value (z value in clip space).
* @param {?number} group - {?Object} group - Only relevant for objects using multiple materials. This represents a group entry from the respective `BufferGeometry`.
* @param {ClippingContext} clippingContext - The current clipping context.
* @return {Object} The render item.
*/
getNextRenderItem( object, geometry, material, groupOrder, z, group, clippingContext ) {
let renderItem = this.renderItems[ this.renderItemsIndex ];
if ( renderItem === undefined ) {
renderItem = {
id: object.id,
object: object,
geometry: geometry,
material: material,
groupOrder: groupOrder,
renderOrder: object.renderOrder,
z: z,
group: group,
clippingContext: clippingContext
};
this.renderItems[ this.renderItemsIndex ] = renderItem;
} else {
renderItem.id = object.id;
renderItem.object = object;
renderItem.geometry = geometry;
renderItem.material = material;
renderItem.groupOrder = groupOrder;
renderItem.renderOrder = object.renderOrder;
renderItem.z = z;
renderItem.group = group;
renderItem.clippingContext = clippingContext;
}
this.renderItemsIndex ++;
return renderItem;
}
/**
* Pushes the given object as a render item to the internal render lists.
* The selected lists depend on the object properties.
*
* @param {Object3D} object - The 3D object.
* @param {BufferGeometry} geometry - The 3D object's geometry.
* @param {Material} material - The 3D object's material.
* @param {number} groupOrder - The current group order.
* @param {number} z - Th 3D object's depth value (z value in clip space).
* @param {?number} group - {?Object} group - Only relevant for objects using multiple materials. This represents a group entry from the respective `BufferGeometry`.
* @param {ClippingContext} clippingContext - The current clipping context.
*/
push( object, geometry, material, groupOrder, z, group, clippingContext ) {
const renderItem = this.getNextRenderItem( object, geometry, material, groupOrder, z, group, clippingContext );
if ( object.occlusionTest === true ) this.occlusionQueryCount ++;
if ( material.transparent === true || material.transmission > 0 ) {
if ( needsDoublePass( material ) ) this.transparentDoublePass.push( renderItem );
this.transparent.push( renderItem );
} else {
this.opaque.push( renderItem );
}
}
/**
* Inserts the given object as a render item at the start of the internal render lists.
* The selected lists depend on the object properties.
*
* @param {Object3D} object - The 3D object.
* @param {BufferGeometry} geometry - The 3D object's geometry.
* @param {Material} material - The 3D object's material.
* @param {number} groupOrder - The current group order.
* @param {number} z - Th 3D object's depth value (z value in clip space).
* @param {?number} group - {?Object} group - Only relevant for objects using multiple materials. This represents a group entry from the respective `BufferGeometry`.
* @param {ClippingContext} clippingContext - The current clipping context.
*/
unshift( object, geometry, material, groupOrder, z, group, clippingContext ) {
const renderItem = this.getNextRenderItem( object, geometry, material, groupOrder, z, group, clippingContext );
if ( material.transparent === true || material.transmission > 0 ) {
if ( needsDoublePass( material ) ) this.transparentDoublePass.unshift( renderItem );
this.transparent.unshift( renderItem );
} else {
this.opaque.unshift( renderItem );
}
}
/**
* Pushes render bundle group data into the render list.
*
* @param {Object} group - Bundle group data.
*/
pushBundle( group ) {
this.bundles.push( group );
}
/**
* Pushes a light into the render list.
*
* @param {Light} light - The light.
*/
pushLight( light ) {
this.lightsArray.push( light );
}
/**
* Sorts the internal render lists.
*
* @param {?function(any, any): number} customOpaqueSort - A custom sort function for opaque objects.
* @param {?function(any, any): number} customTransparentSort - A custom sort function for transparent objects.
*/
sort( customOpaqueSort, customTransparentSort ) {
if ( this.opaque.length > 1 ) this.opaque.sort( customOpaqueSort || painterSortStable );
if ( this.transparentDoublePass.length > 1 ) this.transparentDoublePass.sort( customTransparentSort || reversePainterSortStable );
if ( this.transparent.length > 1 ) this.transparent.sort( customTransparentSort || reversePainterSortStable );
}
/**
* This method performs finalizing tasks right after the render lists
* have been generated.
*/
finish() {
// update lights
this.lightsNode.setLights( this.lightsArray );
// Clear references from inactive renderItems in the list
for ( let i = this.renderItemsIndex, il = this.renderItems.length; i < il; i ++ ) {
const renderItem = this.renderItems[ i ];
if ( renderItem.id === null ) break;
renderItem.id = null;
renderItem.object = null;
renderItem.geometry = null;
renderItem.material = null;
renderItem.groupOrder = null;
renderItem.renderOrder = null;
renderItem.z = null;
renderItem.group = null;
renderItem.clippingContext = null;
}
}
}
Methods¶
begin(): RenderList
¶
Code
getNextRenderItem(object: Object3D, geometry: BufferGeometry, material: Material, groupOrder: number, z: number, group: number, clippingContext: ClippingContext): any
¶
Code
getNextRenderItem( object, geometry, material, groupOrder, z, group, clippingContext ) {
let renderItem = this.renderItems[ this.renderItemsIndex ];
if ( renderItem === undefined ) {
renderItem = {
id: object.id,
object: object,
geometry: geometry,
material: material,
groupOrder: groupOrder,
renderOrder: object.renderOrder,
z: z,
group: group,
clippingContext: clippingContext
};
this.renderItems[ this.renderItemsIndex ] = renderItem;
} else {
renderItem.id = object.id;
renderItem.object = object;
renderItem.geometry = geometry;
renderItem.material = material;
renderItem.groupOrder = groupOrder;
renderItem.renderOrder = object.renderOrder;
renderItem.z = z;
renderItem.group = group;
renderItem.clippingContext = clippingContext;
}
this.renderItemsIndex ++;
return renderItem;
}
push(object: Object3D, geometry: BufferGeometry, material: Material, groupOrder: number, z: number, group: number, clippingContext: ClippingContext): void
¶
Code
push( object, geometry, material, groupOrder, z, group, clippingContext ) {
const renderItem = this.getNextRenderItem( object, geometry, material, groupOrder, z, group, clippingContext );
if ( object.occlusionTest === true ) this.occlusionQueryCount ++;
if ( material.transparent === true || material.transmission > 0 ) {
if ( needsDoublePass( material ) ) this.transparentDoublePass.push( renderItem );
this.transparent.push( renderItem );
} else {
this.opaque.push( renderItem );
}
}
unshift(object: Object3D, geometry: BufferGeometry, material: Material, groupOrder: number, z: number, group: number, clippingContext: ClippingContext): void
¶
Code
unshift( object, geometry, material, groupOrder, z, group, clippingContext ) {
const renderItem = this.getNextRenderItem( object, geometry, material, groupOrder, z, group, clippingContext );
if ( material.transparent === true || material.transmission > 0 ) {
if ( needsDoublePass( material ) ) this.transparentDoublePass.unshift( renderItem );
this.transparent.unshift( renderItem );
} else {
this.opaque.unshift( renderItem );
}
}
pushBundle(group: any): void
¶
pushLight(light: Light): void
¶
sort(customOpaqueSort: (arg0: any, arg1: any) => number, customTransparentSort: (arg0: any, arg1: any) => number): void
¶
Code
sort( customOpaqueSort, customTransparentSort ) {
if ( this.opaque.length > 1 ) this.opaque.sort( customOpaqueSort || painterSortStable );
if ( this.transparentDoublePass.length > 1 ) this.transparentDoublePass.sort( customTransparentSort || reversePainterSortStable );
if ( this.transparent.length > 1 ) this.transparent.sort( customTransparentSort || reversePainterSortStable );
}
finish(): void
¶
Code
finish() {
// update lights
this.lightsNode.setLights( this.lightsArray );
// Clear references from inactive renderItems in the list
for ( let i = this.renderItemsIndex, il = this.renderItems.length; i < il; i ++ ) {
const renderItem = this.renderItems[ i ];
if ( renderItem.id === null ) break;
renderItem.id = null;
renderItem.object = null;
renderItem.geometry = null;
renderItem.material = null;
renderItem.groupOrder = null;
renderItem.renderOrder = null;
renderItem.z = null;
renderItem.group = null;
renderItem.clippingContext = null;
}
}