primitive-geometry

Geometries for 3D rendering, including normals, UVs and cell indices (faces). Perfect if you want to supercharge your dependency folder... with 30KB of geometries.

Installation

npm install primitive-geometry

Features

• Common API: options object in, simplicial complex out
• Outputs TypedArray (Float32Array for geometry data and Uint8Array|Uint16Array|Uint32Array for cells)
• Zero dependency
• Same parameters naming: radius (or rx/ry/rz), scale (or height/sx/sy/sz), segments (or nx/ny/nz) and a few specific parameters for icosphere/cylinder/cone/torus.

See difference with v1 here.

Usage

See the example and its source.

import Primitives from "primitive-geometry";

const quadGeometry = Primitives.quad();
const planeGeometry = Primitives.plane();

const cubeGeometry = Primitives.cube();
const roundedCubeGeometry = Primitives.roundedCube();

const cylinderGeometry = Primitives.cylinder();
const coneGeometry = Primitives.cone();
const capsuleGeometry = Primitives.capsule();

const sphereGeometry = Primitives.sphere();
const icosphereGeometry = Primitives.icosphere();
const ellipsoidGeometry = Primitives.ellipsoid();
const torusGeometry = Primitives.torus();

// without normals/uvs
const boxGeometry = Primitives.box();
const circleGeometry = Primitives.circle();

console.log(quadGeometry);
// {
//   positions: [ [x, y, z], [x, y, z], ... ],
//   cells: [ [a, b, c], [a, b, c], ... ],
//   uvs: [ [u, v], [u, v], ... ],
//   normals: [ [x, y, z], [x, y, z], ... ]
// }

API

Modules

index

Re-export all geometries and utils.

box

capsule

circle

cone

cube

cylinder

ellipsoid

icosphere

plane

quad

rounded-cube

sphere

torus

utils

Typedefs

BasicSimplicialComplex : Object

Geometry definition without normals and UVs.

SimplicialComplex : Object

Geometry definition.

index

Re-export all geometries and utils.

box

• box
  • box([options]) ⇒ BasicSimplicialComplex ⏏
    • ~BoxOptions : Object

box([options]) ⇒ BasicSimplicialComplex ⏏

Kind: Exported function

box~BoxOptions : Object

Kind: inner typedef of box
Properties

capsule

• capsule
  • capsule([options]) ⇒ SimplicialComplex ⏏
    • ~CapsuleOptions : Object

capsule([options]) ⇒ SimplicialComplex ⏏

Kind: Exported function

capsule~CapsuleOptions : Object

Kind: inner typedef of capsule
Properties

circle

• circle
  • circle([options]) ⇒ BasicSimplicialComplex ⏏
    • ~BoxOptions : Object

circle([options]) ⇒ BasicSimplicialComplex ⏏

Kind: Exported function

circle~BoxOptions : Object

Kind: inner typedef of circle
Properties

cone

• cone
  • cone([options]) ⇒ SimplicialComplex ⏏
    • ~ConeOptions : Object

cone([options]) ⇒ SimplicialComplex ⏏

Kind: Exported function

cone~ConeOptions : Object

Kind: inner typedef of cone
Properties

cube

• cube
  • cube([options]) ⇒ SimplicialComplex ⏏
    • ~CubeOptions : Object

cube([options]) ⇒ SimplicialComplex ⏏

Kind: Exported function

cube~CubeOptions : Object

Kind: inner typedef of cube
Properties

cylinder

• cylinder
  • cylinder([options]) ⇒ SimplicialComplex ⏏
    • ~CylinderOptions : Object

cylinder([options]) ⇒ SimplicialComplex ⏏

Kind: Exported function

cylinder~CylinderOptions : Object

Kind: inner typedef of cylinder
Properties

ellipsoid

• ellipsoid
  • ellipsoid([options]) ⇒ SimplicialComplex ⏏
    • ~EllipsoidOptions : Object

ellipsoid([options]) ⇒ SimplicialComplex ⏏

Default to an oblate spheroid.

Kind: Exported function

ellipsoid~EllipsoidOptions : Object

Kind: inner typedef of ellipsoid
Properties

icosphere

• icosphere
  • icosphere([options]) ⇒ SimplicialComplex ⏏
    • ~IcosphereOptions : Object

icosphere([options]) ⇒ SimplicialComplex ⏏

Kind: Exported function

icosphere~IcosphereOptions : Object

Kind: inner typedef of icosphere
Properties

plane

• plane
  • plane([options]) ⇒ SimplicialComplex ⏏
    • ~PlaneOptions : Object

plane([options]) ⇒ SimplicialComplex ⏏

Kind: Exported function

plane~PlaneOptions : Object

Kind: inner typedef of plane
Properties

quad

• quad
  • quad([options]) ⇒ SimplicialComplex ⏏
    • ~QuadOptions : Object

quad([options]) ⇒ SimplicialComplex ⏏

Kind: Exported function

quad~QuadOptions : Object

Kind: inner typedef of quad
Properties

rounded-cube

• rounded-cube
  • roundedCube([options]) ⇒ SimplicialComplex ⏏
    • ~RoundedCubeOptions : Object

roundedCube([options]) ⇒ SimplicialComplex ⏏

Kind: Exported function

roundedCube~RoundedCubeOptions : Object

Kind: inner typedef of roundedCube
Properties

sphere

• sphere
  • sphere([options]) ⇒ SimplicialComplex ⏏
    • ~SphereOptions : Object

sphere([options]) ⇒ SimplicialComplex ⏏

Kind: Exported function

sphere~SphereOptions : Object

Kind: inner typedef of sphere
Properties

torus

• torus
  • torus([options]) ⇒ SimplicialComplex ⏏
    • ~TorusOptions : Object

torus([options]) ⇒ SimplicialComplex ⏏

Kind: Exported function

torus~TorusOptions : Object

Kind: inner typedef of torus
Properties

utils

• utils
  • .TAU : number
  • .getCellsTypedArray ⇒ Uint8Array | Uint16Array | Uint32Array
  • .normalize(v) ⇒ Array.<number>
  • .checkArguments(...args)
  • .setTypedArrayType(type)

utils.TAU : number

Two times PI.

Kind: static constant of utils

utils.getCellsTypedArray ⇒ Uint8Array | Uint16Array | Uint32Array

Select cells typed array from a size determined by amount of vertices.

Kind: static constant of utils
See: MDN TypedArray objects

utils.normalize(v) ⇒ Array.<number>

Normalize a vector 3.

Kind: static method of utils
Returns: Array.<number> - Normalized vector

utils.checkArguments(...args)

Ensure first argument passed to the primitive functions is an object

Kind: static method of utils

utils.setTypedArrayType(type)

Enforce a typed array constructor for cells

Kind: static method of utils

BasicSimplicialComplex : Object

Geometry definition without normals and UVs.

Kind: global typedef
Properties

SimplicialComplex : Object

Geometry definition.

Kind: global typedef
Properties

License

See original packages used in v1:

• primitive-quad
• primitive-plane
• primitive-cube
• primitive-rounded-cube
• primitive-capsule
• primitive-sphere
• primitive-icosphere
• primitive-ellipsoid
• primitive-torus
• primitive-cylinder
• primitive-box
• primitive-circle

Differences with v1:

• [x] fix cylinder orientation and uvs
• [x] fix icosphere uvs (based on: https://github.com/mourner/icomesh)
• [x] uniformise api and internal names
• [x] use options object
• [x] remove gl-matrix/pex-math and icosphere dependencies
• [x] use only trigonometric operation, no matrix transformation
• [x] base sphere on ellispsoid
• [x] add cone based on cylinder
• [x] use flat typed arrays
• [x] add jsdoc, prettier, eslint via snowdev

MIT. See license file.