twgl/primitives

Concatenates sets of vertices

Assumes the vertices match in composition. For example
if one set of vertices has positions, normals, and indices
all sets of vertices must have positions, normals, and indices
and of the same type.

Example:

 const cubeVertices = twgl.primitives.createCubeVertices(2);
 const sphereVertices = twgl.primitives.createSphereVertices(1, 10, 10);
 // move the sphere 2 units up
 twgl.primitives.reorientVertices(
     sphereVertices, twgl.m4.translation([0, 2, 0]));
 // merge the sphere with the cube
 const cubeSphereVertices = twgl.primitives.concatVertices(
     [cubeVertices, sphereVertices]);
 // turn them into WebGL buffers and attrib data
 const bufferInfo = twgl.createBufferInfoFromArrays(gl, cubeSphereVertices);

Creates 3D 'F' BufferInfo.
An 'F' is useful because you can easily tell which way it is oriented.
The created 'F' has position, normal, texcoord, and color buffers.

Creates 3D 'F' buffers.
An 'F' is useful because you can easily tell which way it is oriented.
The created 'F' has position, normal, texcoord, and color buffers.

Creates 3D 'F' vertices.
An 'F' is useful because you can easily tell which way it is oriented.
The created 'F' has position, normal, texcoord, and color arrays.

creates a typed array with a push function attached
so that you can easily push values.

push can take multiple arguments. If an argument is an array each element
of the array will be added to the typed array.

Example:

const array = createAugmentedTypedArray(3, 2);  // creates a Float32Array with 6 values
array.push(1, 2, 3);
array.push([4, 5, 6]);
// array now contains [1, 2, 3, 4, 5, 6]

Also has numComponents and numElements properties.

Creates crescent BufferInfo.

Creates crescent buffers.

Creates crescent vertices.

Creates crescent BufferInfo.

Creates crescent buffers.

Creates crescent vertices.

Creates a BufferInfo for a cube.

The cube is created around the origin. (-size / 2, size / 2).

Creates the buffers and indices for a cube.

The cube is created around the origin. (-size / 2, size / 2).

Creates the vertices and indices for a cube.

The cube is created around the origin. (-size / 2, size / 2).

Creates cylinder BufferInfo. The cylinder will be created around the origin
along the y-axis.

Creates cylinder buffers. The cylinder will be created around the origin
along the y-axis.

Creates cylinder vertices. The cylinder will be created around the origin
along the y-axis.

Creates a disc BufferInfo. The disc will be in the xz plane, centered at
the origin. When creating, at least 3 divisions, or pie
pieces, need to be specified, otherwise the triangles making
up the disc will be degenerate. You can also specify the
number of radial pieces stacks. A value of 1 for
stacks will give you a simple disc of pie pieces. If you
want to create an annulus you can set innerRadius to a
value > 0. Finally, stackPower allows you to have the widths
increase or decrease as you move away from the center. This
is particularly useful when using the disc as a ground plane
with a fixed camera such that you don't need the resolution
of small triangles near the perimeter. For example, a value
of 2 will produce stacks whose outside radius increases with
the square of the stack index. A value of 1 will give uniform
stacks.

Creates disc buffers. The disc will be in the xz plane, centered at
the origin. When creating, at least 3 divisions, or pie
pieces, need to be specified, otherwise the triangles making
up the disc will be degenerate. You can also specify the
number of radial pieces stacks. A value of 1 for
stacks will give you a simple disc of pie pieces. If you
want to create an annulus you can set innerRadius to a
value > 0. Finally, stackPower allows you to have the widths
increase or decrease as you move away from the center. This
is particularly useful when using the disc as a ground plane
with a fixed camera such that you don't need the resolution
of small triangles near the perimeter. For example, a value
of 2 will produce stacks whose outside radius increases with
the square of the stack index. A value of 1 will give uniform
stacks.

Creates disc vertices. The disc will be in the xz plane, centered at
the origin. When creating, at least 3 divisions, or pie
pieces, need to be specified, otherwise the triangles making
up the disc will be degenerate. You can also specify the
number of radial pieces stacks. A value of 1 for
stacks will give you a simple disc of pie pieces. If you
want to create an annulus you can set innerRadius to a
value > 0. Finally, stackPower allows you to have the widths
increase or decrease as you move away from the center. This
is particularly useful when using the disc as a ground plane
with a fixed camera such that you don't need the resolution
of small triangles near the perimeter. For example, a value
of 2 will produce stacks whose outside radius increases with
the square of the stack index. A value of 1 will give uniform
stacks.

Creates XZ plane BufferInfo.

The created plane has position, normal, and texcoord data

Creates XZ plane buffers.

The created plane has position, normal, and texcoord data

Creates XZ plane vertices.

The created plane has position, normal, and texcoord data

Creates sphere BufferInfo.

The created sphere has position, normal, and texcoord data

Creates sphere buffers.

The created sphere has position, normal, and texcoord data

Creates sphere vertices.

The created sphere has position, normal, and texcoord data

Creates BufferInfo for a torus

Creates buffers for a torus

Creates vertices for a torus

Creates a BufferInfo for a truncated cone, which is like a cylinder
except that it has different top and bottom radii. A truncated cone
can also be used to create cylinders and regular cones. The
truncated cone will be created centered about the origin, with the
y axis as its vertical axis.

Creates buffers for a truncated cone, which is like a cylinder
except that it has different top and bottom radii. A truncated cone
can also be used to create cylinders and regular cones. The
truncated cone will be created centered about the origin, with the
y axis as its vertical axis.

Creates vertices for a truncated cone, which is like a cylinder
except that it has different top and bottom radii. A truncated cone
can also be used to create cylinders and regular cones. The
truncated cone will be created centered about the origin, with the
y axis as its vertical axis. .

Creates XY quad Buffers

The default with no parameters will return a 2x2 quad with values from -1 to +1.
If you want a unit quad with that goes from 0 to 1 you'd call it with

twgl.primitives.createXYQuadBufferInfo(gl, 1, 0.5, 0.5);

If you want a unit quad centered above 0,0 you'd call it with

twgl.primitives.createXYQuadBufferInfo(gl, 1, 0, 0.5);

Creates XY quad BufferInfo

The default with no parameters will return a 2x2 quad with values from -1 to +1.
If you want a unit quad with that goes from 0 to 1 you'd call it with

twgl.primitives.createXYQuadBufferInfo(gl, 1, 0.5, 0.5);

If you want a unit quad centered above 0,0 you'd call it with

twgl.primitives.createXYQuadBufferInfo(gl, 1, 0, 0.5);

Creates XY quad vertices

The default with no parameters will return a 2x2 quad with values from -1 to +1.
If you want a unit quad with that goes from 0 to 1 you'd call it with

twgl.primitives.createXYQuadVertices(1, 0.5, 0.5);

If you want a unit quad centered above 0,0 you'd call it with

twgl.primitives.createXYQuadVertices(1, 0, 0.5);

Given indexed vertices creates a new set of vertices un-indexed by expanding the indexed vertices.

Creates a duplicate set of vertices

This is useful for calling reorientVertices when you
also want to keep the original available

flattens the normals of deindexed vertices in place.

Creates an augmentedTypedArray of random vertex colors.
If the vertices are indexed (have an indices array) then will
just make random colors. Otherwise assumes they are triangles
and makes one random color for every 3 vertices.

Reorients directions by the given matrix..

Reorients normals by the inverse-transpose of the given
matrix..

Reorients positions by the given matrix. In other words, it
multiplies each vertex by the given matrix.

Reorients arrays by the given matrix. Assumes arrays have
names that contains 'pos' could be reoriented as positions,
'binorm' or 'tan' as directions, and 'norm' as normals.

Used to supply random colors