Class Geometry

Used to create a Geometry from given parameters like instances count or geometry attributes (vertices, uvs, normals).
Holds all attributes arrays, bounding box and create as WGSL code snippet for the vertex shader input attributes.

During the render, the Geometry is responsible for setting the vertexBuffers and drawing the vertices.

Example

const vertices = new Float32Array([
  // first triangle
   1,  1,  0,
   1, -1,  0,
  -1, -1,  0,

  // second triangle
   1,  1,  0,
  -1, -1,  0,
  -1,  1,  0
])

// create a quad geometry made of 2 triangles
const geometry = new Geometry()

geometry.setAttribute({
  name: 'position',
  type: 'vec3f',
  bufferFormat: 'float32x3',
  size: 3,
  bufferLength: vertices.length,
  array: vertices,
})

Hierarchy (view full)

Geometry
- IndexedGeometry

Constructors

constructor

new Geometry(parameters?): Geometry
Geometry constructor
Parameters
- parameters: Partial<GeometryOptions> = {}
  parameters used to create our Geometry
Returns Geometry
- Defined in src/core/geometries/Geometry.ts:86

Properties

verticesCount

verticesCount: number

Number of vertices defined by this geometry

verticesOrder

verticesOrder: GPUFrontFace

Vertices order to be drawn by the render pipeline

topology

topology: GPUPrimitiveTopology

Topology to use with this Geometry, i.e. whether to draw triangles or points

instancesCount

instancesCount: number

Number of instances of this geometry to draw

vertexBuffers

vertexBuffers: VertexBuffer[]

Array of vertex buffers to use with this geometry

options

options: GeometryOptions

Options used to create this geometry

type

type: string

The type of the geometry

uuid

uuid: string

The universal unique id of the geometry

boundingBox

boundingBox: Box3

The bounding box of the geometry, i.e. two Vec3 defining the min and max positions to wrap this geometry in a cube

wgslStructFragment

wgslStructFragment: string

A string to append to our shaders code describing the WGSL structure representing this geometry attributes

layoutCacheKey

layoutCacheKey: string

A string representing the vertexBuffers layout, used for pipelines caching

consumers

consumers: Set<string>

A Set to store this Geometry consumers (Mesh uuid)

ready

ready: boolean

Whether this geometry is ready to be drawn, i.e. it has been computed and all its vertex buffers have been created

Accessors

shouldCompute

get shouldCompute(): boolean
Get whether this Geometry is ready to compute, i.e. if its first vertex buffer array has not been created yet

Returns boolean
- Defined in src/core/geometries/Geometry.ts:323

Methods

loseContext

loseContext(): void
Reset all the vertex buffers when the device is lost

Returns void
- Defined in src/core/geometries/Geometry.ts:156

restoreContext

restoreContext(renderer): void
Restore the Geometry buffers on context restoration
Parameters
- renderer: Renderer
  The Renderer used to recreate the buffers
Returns void
- Defined in src/core/geometries/Geometry.ts:168

addVertexBuffer

addVertexBuffer(parameters?): VertexBuffer
Add a vertex buffer to our Geometry, set its attributes and return it
Parameters
- parameters: VertexBufferParams = {}
  vertex buffer parameters
Returns VertexBuffer
- newly created vertex buffer
- Defined in src/core/geometries/Geometry.ts:191

getVertexBufferByName

getVertexBufferByName(name?): VertexBuffer
Get a vertex buffer by name
Parameters
- name: string = ''
  our vertex buffer name
Returns VertexBuffer
- found vertex buffer or null if not found
- Defined in src/core/geometries/Geometry.ts:232

setAttribute

setAttribute(parameters): void
Set a vertex buffer attribute
Parameters
- parameters: VertexBufferAttributeParams
  attributes parameters
Returns void
- Defined in src/core/geometries/Geometry.ts:240

getAttributeByName

getAttributeByName(name): VertexBufferAttribute
Get an attribute by name
Parameters
- name: string
  name of the attribute to find
Returns VertexBufferAttribute
- found attribute or null if not found
- Defined in src/core/geometries/Geometry.ts:332

computeGeometry

computeGeometry(): void
Compute a Geometry, which means iterate through all vertex buffers and create the attributes array that will be sent as buffers. Also compute the Geometry bounding box.

Returns void
- Defined in src/core/geometries/Geometry.ts:345

setWGSLFragment

setWGSLFragment(): void
Set the WGSL code snippet that will be appended to the vertex shader.

Returns void
- Defined in src/core/geometries/Geometry.ts:417

createBuffers

createBuffers(parameters): void
Create the Geometry vertex buffers.
Parameters
- parameters: {
  renderer: Renderer;
  label?: string;
  }
  parameters used to create the vertex buffers.
  - renderer: Renderer
    Renderer used to create the vertex buffers.
  - Optional label?: string
    label to use for the vertex buffers.
Returns void
- Defined in src/core/geometries/Geometry.ts:449

uploadBuffer

uploadBuffer(renderer, buffer): void
Upload a GeometryBuffer to the GPU.
Parameters
- renderer: Renderer
  Renderer used to upload the buffer.
- buffer: GeometryBuffer
  GeometryBuffer holding a Buffer and a typed array to upload.
Returns void
- Defined in src/core/geometries/Geometry.ts:480

setGeometryBuffers

setGeometryBuffers(pass): void
Set our render pass geometry vertex buffers
Parameters
- pass: GPURenderPassEncoder
  current render pass
Returns void
- Defined in src/core/geometries/Geometry.ts:498

drawGeometry

drawGeometry(pass): void
Draw our geometry
Parameters
- pass: GPURenderPassEncoder
  current render pass
Returns void
- Defined in src/core/geometries/Geometry.ts:508

render

render(pass): void
Set our vertex buffers then draw the geometry
Parameters
- pass: GPURenderPassEncoder
  current render pass
Returns void
- Defined in src/core/geometries/Geometry.ts:516

destroy

destroy(renderer?): void
Destroy our geometry vertex buffers.
Parameters
- renderer: Renderer = null
  current Renderer, in case we want to remove the buffers from the cache.
Returns void
- Defined in src/core/geometries/Geometry.ts:527

Class Geometry

Example

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

parameters: Partial<GeometryOptions> = {}

Returns Geometry

Properties

verticesCount

verticesOrder

topology

instancesCount

vertexBuffers

options

type

uuid

boundingBox

wgslStructFragment

layoutCacheKey

consumers

ready

Accessors

shouldCompute

Returns boolean

Methods

loseContext

Returns void

restoreContext

Parameters

renderer: Renderer

Returns void

addVertexBuffer

Parameters

parameters: VertexBufferParams = {}

Returns VertexBuffer

getVertexBufferByName

Parameters

name: string = ''

Returns VertexBuffer

setAttribute

Parameters

parameters: VertexBufferAttributeParams

Returns void

getAttributeByName

Parameters

name: string

Returns VertexBufferAttribute

computeGeometry

Returns void

setWGSLFragment

Returns void

createBuffers

Parameters

parameters: { renderer: Renderer; label?: string; }

renderer: Renderer

Optional label?: string

Returns void

uploadBuffer

Parameters

renderer: Renderer

buffer: GeometryBuffer

Returns void

setGeometryBuffers

Parameters

pass: GPURenderPassEncoder

Returns void

drawGeometry

Parameters

pass: GPURenderPassEncoder

Returns void

render

Parameters

pass: GPURenderPassEncoder

Returns void

parameters: {
renderer: Renderer;
label?: string;
}

`Optional` label?: string