← Cycles
Qmap · c26
flatland-view
activecreated 2026-04-28· last activity 2026-08-15
Add a `flatland` view (topdown camera + pitched 3D models) for VOX/OBJ-backed actors
Why
Top-down views are great for layouts, but VOX/OBJ character-like models are authored “upright” and read poorly from directly above.
flatland keeps the same camera as topdown, while pitching custom models to face the camera, improving silhouette legibility without changing layout.
Objective
Deliver a new camera preset and minimal pose plumbing so:
cameraPreset: 'flatland'behaves liketopdownfor the camera- VOX/OBJ-backed actors (created via
createVoxModelEntity/ inventory wrappers) pitch to face up at the camera - switching between
topdownandflatlandupdates existing actor models in-place - transitions spawn newly-entering custom model actors with the correct pose
Scope
src/core/cameraAnimation.js— addflatlandpresetsrc/components/QMap.vue+ scene plumbing — thread amodelPoseinto actor creation and runtime updatesdev/experiments/c23.custom-obj-models/shared/createVoxModelEntity.js— implementsetModelPose()on custom model entities
Non-Goals
- re-anchoring rotated models to the ground plane
- pitching built-in primitive meshes (app/service/user/etc.)
Success Criteria
- In c25 inventory experiments, flipping
cameraPresetbetweentopdownandflatlandchanges only the model pitch (camera stays topdown).