Render3D. Render3DPlugin

Build a mesh once out of draw calls, instead of redrawing the shapes every frame

• Call the same drawStrip, drawQuad and drawBox calls inside, and get a mesh back
• Strips inside a bake ignore their tileInfo, the finished mesh picks the texture when it draws
• drawMesh, drawBox and drawSphere copy their mesh in, moved and tinted, their tileInfo dropped too

Draw a flat square that always faces the camera, unlit so it keeps its own colors

• Draw it from onRenderTransparent or a transparent object so it can fade

Draw a box, untextured, for blocking out a scene without meshes or objects

Draw a line as a camera facing ribbon, unlit

Draw a mesh with the current draw state, batched with its other uses in the opaque stage when instancing is on

Draw a quad from four corners in loop order, counter clockwise seen from the front, a is the top left of the texture

Draw a ribbon along a path, unlit and visible from both sides; width and color can change along it

• The texture runs along the length, u from the first point to the last
• A path that ends where it starts is a loop, and joins with no seam

Draw render3D.sky around the camera, unlit, unfogged and behind everything, called automatically by the pass

Draw a disc that fades to transparent at the rim, unlit, for glows, puffs and sky dots

Draw a soft round shadow on the ground under something, much cheaper than a real shadow

• Draw it from onRenderTransparent or from a transparent object

Draw a sphere, untextured and smooth shaded

Draw a triangle strip, batched into the stream with the current draw state

• Strip order: the first three points make a triangle, then each point makes another with the two before it
• List the first three points counter clockwise as seen from the front, or the face points away and may vanish when back faces are culled
• inside a bake the strip goes into the mesh instead, in the transparent stage it is queued for sorting

Draw a strip with lighting off, for camera facing shapes where the light direction means nothing

Draw a triangle, counter clockwise from outside is the front

Draw the pending stream vertices as one strip with the state they were drawn under, called automatically when needed

Draw the queued transparent draws far to near with the state each was drawn under, called automatically at the end of the transparent stage

Is any part of a sphere on screen this frame, the test that skips meshes the camera cannot see

• While the shadow map is drawing it tests the shadow area instead

Find the nearest object under a screen position or along a ray, for clicking on things

• Each object is tested as a sphere around its mesh, or around a sprite's size3D, not triangle by triangle
• engineObjectsRaycast3D is the other half of this, every object along a ray instead of the nearest

Play a sound at a 3D position, quieter with distance from the camera and panned by its side, like Sound.play with a 2D position

Play a sound on a loop at a 3D position, the same as playSound with loop on

• Its volume and pan are set when it starts, change or stop it through the SoundInstance returned

Queue a draw for the transparent stage, replayed far to near with the current draw state, or draw it now when sorting is off

Draw a layer's objects, solid ones first and see through ones after, called automatically

• The main layer also draws the sky, the render callbacks and the debug shapes

Where a screen position lands on a flat ground plane, for top down games; use HeightMap.raycast for terrain

Get the world ray under a screen position, for clicking on things in 3D

• Uses the camera where it is right now, so it is fine to call from gameUpdate
• It brings the view matrices up to date for that canvas, so worldToScreen stays its exact opposite

Set where fog starts and ends, and its color

Build a sky dome, set it as the sky and set the fog color to the horizon color

Rebuild the view and projection matrices from the camera, called automatically each frame

Rebuild the light's view projection around the shadow center, called automatically each frame shadows are on

Where a world point lands on screen as -1 to 1 across and up, with z as depth

• Uses this frame's camera, call updateMatrices first if the camera just moved

Project a world point to screen space pixels, same space as mousePosScreen

• The opposite of screenToRay, and it takes the same canvas so the pair agree