Render3D

Global Render3D plugin object

Build a box centered on the origin, six flat faces with uvs covering each face

Build a capsule standing on the Y axis, centered on the origin: a cylinder with a half sphere on each end

Build a cone standing on the Y axis, centered on the origin, the point up

Build a cylinder standing on the Y axis, centered on the origin

Turn a sprite into a 3D block model by giving its pixels thickness

• A pixel counts as solid when it is more than half opaque
• Each pixel keeps its own color, so white art takes the object's tint
• Runs of matching pixels merge into one face, and side walls appear only at the sprite's edges
• A texture's pixels are read once and kept, so redrawing a canvas texture will not change what this builds
• Pixels can also be an array of rows, each a Color, a truthy value for white, or a falsy value for empty

Build a heightfield grid in the XZ plane centered on the origin

• smooth rounds the lighting across cells and colors each corner
• flat lights and colors each cell on its own, so a checkerboard stays crisp

Spin a flat outline around the Y axis to make a round shape, like a vase or a wheel

• profile is [[radius, y], ...] from bottom to top
• A profile that ends where it starts makes a closed ring like a donut

Build a hull from a row of diamond shaped slices along Z, for ships, planes and cars

• Each slice is [z, width, top, bottom, sideHeight]
• sideHeight is 0 to 1 and puts the side corners between the bottom and the top
• List the slices nose first, with the nose at the largest z

Build a lit ribbon along a path, for roads, tracks and walls

• Each segment is a flat quad, the sides are across the path in the plane of the up vector

Build a sky dome: a sphere colored by direction, wound to be seen from inside

• set it as render3D.sky and the pass draws it around the camera behind everything

Build a sphere centered on the origin

Build a mesh of extruded text from an image font, the engine font by default so it needs no assets

• Each glyph is extruded once per font and reused, the block is centered and faces +Z
• Newlines stack downward, spaced a little wider than the character height so the sides do not collide
• Every call builds a new mesh, dispose the old one when text changes often
• Glyphs are white in the engine font, so the object's color tints the text

Build a donut lying flat around the Y axis

Draw a debug wireframe box

Draw a debug line

Draw a debug point as a small cross of three lines

Draw a debug wireframe sphere as three rings

Call a function for each EngineObject3D whose box overlaps a box

Collect the EngineObject3D objects whose boxes overlap a box, sizes are full sizes

• Boxes are axis aligned around the world position, rotation3D is ignored; lights, emitters and trails have no size

Collect every EngineObject3D a ray passes through, nearest first, the 3D twin of engineObjectsRaycast

• The ray has no end, so everything along it counts however far away it is
• Use render3D.pick for the nearest one on its own, with the distance to it

Fetch and parse an OBJ file

Parse Wavefront OBJ text into a Mesh

• Reads v, vt, vn and f lines with convex polygons of any size, materials and groups are ignored
• Normals come from the file when every corner of a face has one, otherwise from the face
• Use mesh.center() and mesh.fit(size) to bring a model of unknown units to the origin