voxel_scene 0.2.0-dev

flutter_scene renderer for voxel_engine: one scene node per chunk, the terrain material and its shaders.

Changelog

0.2.0-dev

• NodeBody keeps two poses of its node, the last step's and the one before it, each a position, a yaw and a pitch, and draws the node between them: syncNode({at, yaw, pitch, snap}) sets the step's pose and puts the node there (as before, and now turned too), beginStep() makes it the pose the frames draw from, and drawNode(alpha) puts the node alpha of the way from the one to the other, the yaw the short way round; drawnPosition is where it stands. A body's first sync, and one with snap, jumps. A game that never calls drawNode sees the node where the last sync put it. The node's transform is written whole (translation and rotation, scale 1).
• VoxelChunkView packs a chunk's lit surfaces once, when its mesh arrives, and keeps them packed: a region's rebuild moves each chunk's words by an integer offset instead of packing every chunk's floats again, on the UI thread, at every mesh in the region. The bits are the same as before (PackedSurface.of packs one chunk, merge moves and joins them), and the view no longer keeps the lit surfaces' floats.
• The terrain's lit surfaces (solid, cutout, liquid) draw in a packed 16-byte vertex where the engine's is 72: a Geometry of the kit's with its own vertex shaders (shaders/terrain.vert, and terrain_depth.vert for the shadow cascades, the depth prepass and the selection mask), two streams of two 32-bit words. The position is in 1/256 m from the region's corner, which the depth passes read alone (8 bytes a vertex where they read 12); the colour's square root, the normal and the two light levels are the second. The glow surface keeps the engine's vertex: its baked colour can pass 1.0. The terrain looks as it did: against the 72-byte vertex, 0.04% of a frame's pixels differ by more than 2 of 255, fewer than between two runs of the same build. VoxelChunkView asserts regionChunks × the chunk size stays under 256 m, and TerrainMaterial.loadLibrary now requires the bundle's two vertex shaders; the bundle is rebuilt, and tool/build_shaders.dart compiles vertex shaders too.
• The terrain shader multiplies in each block's colour variation, computed from the fragment's cell with the same hash as voxel_engine's ChunkMesher.voxelTint, which the mesher no longer bakes into the vertex colour so it can merge faces. The terrain looks as it did: against the baked variation, 97.7% of a frame's pixels are identical and the rest lie on cells' edges, where multisampling now shades one cell's variation. Requires voxel_engine's greedy mesher; the shader bundle is rebuilt.
• VoxelChunkView draws chunks in regions of regionChunks × regionChunks (2 by default): one node per region, one geometry per surface in it, the chunks' offsets baked into its positions and its bounds taken while they are copied. flutter_scene batches only draws of the identical geometry, so every chunk surface was a draw of its own in every pass; at radius 6 the colour pass draws ~40 items where it drew ~95. A chunk's mesh or removal rebuilds its region from the surfaces the view now keeps. Breaking: nodeCount is gone; chunkCount and regionCount replace it, and a node is named region_x_z where it was chunk_x_z.

0.1.2-dev

• Formatted by dart format at the 120 columns the code is written at (formatter: page_width: 120 in analysis_options.yaml); pana took 10 pub points for formatting.

0.1.1-dev

• Requires Flutter 3.47.1, the first with a runner setting that turns Flutter GPU on for Windows and Linux. The README says how on every platform, and why the web is not one.
• DayNightSky takes the shadows' shadowCascades, shadowResolution and shadowDistance (4, 2048 and 110 m, as they were fixed before).
• DayNightSky's fog is Minecraft's band: linear, DayNightSky.fogBand metres wide (a tenth of the edge, 4 to 64) and full on the edge. It used to start at 45% of the distance and hazed a good part of the loaded world.

0.1.0-dev

First version.

• VoxelChunkView: voxel_engine chunk meshes as flutter_scene nodes.
• TerrainMaterial with its compiled shader bundle.
• MirroredCamera for the engine's winding, and shadows that match.
• DayNightSky, SelectionOutline, VoxelModelMesh, RigPart, NodeBody.