PixiJS

Class: Geometry

Geometry

A Geometry is a low-level object that represents the structure of 2D shapes in terms of vertices and attributes. It's a crucial component for rendering as it describes the shape and format of the data that will go through the shaders. Essentially, a Geometry object holds the data you'd send to a GPU buffer.

A geometry is basically made of two components:
Attributes: These are essentially arrays that define properties of the vertices like position, color, texture coordinates, etc. They map directly to attributes in your vertex shaders.
Indices: An optional array that describes how the vertices are connected. If not provided, vertices will be interpreted in the sequence they're given.

new Geometry (options)

ts:129

Create a new instance of a geometry

Name Type Description
options GeometryDescriptor

The options for the geometry.

Example

const geometry = new Geometry({
  attributes: {
    aPosition: [ // add some positions
      0, 0,
      0, 100,
      100, 100,
      100,   0,
    ],
    aUv: [ // add some uvs
      0, 0,
      0, 1,
      1, 1,
      1, 0,
    ]
  }
});

Members

attributes Record<string, Attribute> readonly

A record of the attributes of the geometry.

bounds Bounds

Returns the bounds of the geometry.

buffers Buffer[] readonly

The buffers that the attributes use

indexBuffer Buffer readonly

The index buffer of the geometry

instanceCount number

the instance count of the geometry to draw

instanced boolean

true if the geometry is instanced

topology Topology

The topology of the geometry.

uid number readonly

The unique id of the geometry.

Methods

destroy (destroyBuffers) void

ts:231

destroys the geometry.

Name Type Default Description
destroyBuffers boolean false

destroy the buffers associated with this geometry

getAttribute (id) Attribute

ts:174

Returns the requested attribute.

Name Type Description
id string

The name of the attribute required
Returns:
Type Description
Attribute
  • The attribute requested.

getBuffer (id) Buffer

ts:193

Returns the requested buffer.

Name Type Description
id string

The name of the buffer required.
Returns:
Type Description
Buffer
  • The buffer requested.

getIndex () Buffer

ts:184

Returns the index buffer

Returns:
Type Description
Buffer
  • The index buffer.

getSize () number

ts:203

Used to figure out how many vertices there are in this geometry

Returns:
Type Description
number the number of vertices in the geometry