Render3D

Global Render3D plugin object

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

• bevel cuts its edges and corners: 1 segment is a flat chamfer, more round them, and the biggest bevel, half the smallest side, rounds a cube into a ball

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
• doubleSided, a sheet seen from both sides; turn it off for ground only ever seen from above
• One cell is a plain square, render3D.planeMesh and planeMeshDoubleSided are shared ones

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
• An end left open, with a radius and no cap, makes the mesh doubleSided so its inside shows
• An end on the axis smooth shades as a round pole like a sphere's when its segment is within 45 degrees of level, and as a point like a cone's tip when it is steeper

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
• doubleSided, so it is seen and lit from below as well

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 sphere or a box

• An object destroyed by an earlier callback is skipped

Collect the EngineObject3D objects whose boxes overlap a sphere or a box, the 3D twin of engineObjectsCollect

• Each object is its size3D box at its world position, turned as it is turned; lights, emitters and trails have no size and are never collected

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

Make a normal map from a height at each pixel, for bumps and grooves with no image file: the slope at each pixel from its neighbors' heights, taken around the edges so the map tiles; set it as an object's normalMap

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
• Back faces are skipped like any mesh, set doubleSided for a model with open walls or single sided parts

A particle as a ParticleEmitter3D's callbacks see it: one object the emitter reuses, set from the particle for each call and written back after it, so copy what you keep

What VoxelMap.raycast finds: how far along the ray, the block's cell and type, and the normal of the face it comes in through