← 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 like topdown for the camera
  • VOX/OBJ-backed actors (created via createVoxModelEntity / inventory wrappers) pitch to face up at the camera
  • switching between topdown and flatland updates existing actor models in-place
  • transitions spawn newly-entering custom model actors with the correct pose

Scope

  • src/core/cameraAnimation.js — add flatland preset
  • src/components/QMap.vue + scene plumbing — thread a modelPose into actor creation and runtime updates
  • dev/experiments/c23.custom-obj-models/shared/createVoxModelEntity.js — implement setModelPose() 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 cameraPreset between topdown and flatland changes only the model pitch (camera stays topdown).

Artifacts

Qpoint Brand Style Guide