Primitives are individual GPU draw calls comprising a Mesh.

Meshes typically have only a single Primitive, although various cases may require more. Each primitive may be assigned vertex attributes, morph target attributes, and a material. Any of these properties should be reused among multiple primitives where feasible.

Primitives cannot be moved independently of other primitives within the same mesh, except through the use of morph targets and skinning. If independent movement or other runtime behavior is necessary (like raycasting or collisions) prefer to assign each primitive to a different mesh. The number of GPU draw calls is typically not affected by grouping or ungrouping primitives to a mesh.

Each primitive may optionally be deformed by one or more morph targets, stored in a PrimitiveTarget.

Usage:

const primitive = doc.createPrimitive()
    .setAttribute('POSITION', positionAccessor)
    .setAttribute('TEXCOORD_0', uvAccessor)
    .setMaterial(material);
mesh.addPrimitive(primitive);
node.setMesh(mesh);

References:

Hierarchy

Properties

propertyType: PRIMITIVE

Property type.

Mode: Record<string, MeshPrimitiveMode> = ...

Type of primitives to render. All valid values correspond to WebGL enums.

Methods

  • Events.

  • dispose(): void
  • Removes both inbound references to and outbound references from this object. At the end of the process the object holds no references, and nothing holds references to it. A disposed object is not reusable.

  • equals(other: Primitive, skip?: Set<string>): boolean
  • Returns true if two properties are deeply equivalent, recursively comparing the attributes of the properties. Optionally, a 'skip' set may be included, specifying attributes whose values should not be considered in the comparison.

    Example: Two Primitives are equivalent if they have accessors and materials with equivalent content — but not necessarily the same specific accessors and materials.

  • getAttribute(semantic: string): Accessor
  • getDefaults(): Nullable<IPrimitive>
  • getExtension<Prop>(name: string): Prop
  • getExtras(): Record<string, unknown>
  • getName(): string
  • init(): void
  • isDisposed(): boolean
  • Returns true if the node has been permanently removed from the graph.

  • listAttributes(): Accessor[]
  • listExtensions(): ExtensionProperty<IProperty>[]
  • listParents(): Property<IProperty>[]
  • Returns a list of all properties that hold a reference to this property. For example, a material may hold references to various textures, but a texture does not hold references to the materials that use it.

    It is often necessary to filter the results for a particular type: some resources, like Accessors, may be referenced by different types of properties. Most properties include the Root as a parent, which is usually not of interest.

    Usage:

    const materials = texture
        .listParents()
        .filter((p) => p instanceof Material)
    
  • listSemantics(): string[]
  • listTargets(): PrimitiveTarget[]
  • setExtension<Prop>(name: string, extensionProperty: Prop): Primitive
  • setExtras(extras: Record<string, unknown>): Primitive
Function symbol, f(📦) → 📦, where the argument and output are a box labeled 'glTF'.

Made by Don McCurdy TypeDoc documentation Copyright 2021 under MIT license