Skip to content
Shapemetry

Model - views[]

Every method of the views[] lane. Each step of a views[] entry returns a view, and the lane's entries are addressed by the identity schema/lanes.ts declares for it.

MethodDescriptionArgTypeDefaultMeaning
view3d3D view — 3D camera head (family 3d) — restores the 3D viewport via settings.activeView, AND places on paper as an AXONOMETRIC (the drawing projects in parallel down the camera direction; fov is ignored there). An inline perspective pose (position/target/up/fov), OR a cameras[] key (XOR — not both), which is also the only way to name an ORTHOGRAPHIC 3D view.positionpoint[1000, 1000, 1000]Eye position [x,y,z] mm.
targetpoint[0, 0, 0]Look-at point [x,y,z] mm. Must differ from Position — equal points name no view direction.
upvectorRoll reference [x,y,z]. Default [0,0,1] (level with the world).
fovnumber45VERTICAL field of view in DEGREES. An inline pose is always perspective — name a cameras[] entry with a height for an orthographic one.
camerastringcameras[] entry name (quoted) — XOR with the inline pose args above.
viewDetailDetail — Detail-view head (family detail) — frames a FLAT components[] entry's own 2D content 1:1: no camera, no projection. The one path a detail/chart/diagram takes to paper; a 3D component fails soft with a named error.sourcestring''components[] key (quoted). Must be flat — the component declares flat: true, or it is flat by inference.
viewElevationElevation — Elevation-view head (family elevation). direction = 'front'|'back'|'left'|'right'; window optional.directionstring'front'Principal elevation direction.
windowlength[][left, bottom, right, top] mm. Omit = auto-fit.
viewFilterFilter — Stackable filter step — rules array of {key, equals?, notEquals?, override?}. Multiple steps AND together; node enabled toggles the layer.rulesobject[]Array of ViewFilterRule objects (key + equals/notEquals/override).
viewPlanPlan — Plan-view head (family plan). cut = world Z height (absent = roof plan, no cut); depth = visible range below cut; window = [left,bottom,right,top] mm crop.cutlengthWorld Z of the cut plane (mm). Omit for a roof plan (no section cut).
depthlengthVisible range below the cut (mm). Only meaningful with cut.
windowlength[][left, bottom, right, top] mm in the view plane. Omit = auto-fit.
viewSectionSection — Section-view head (family section). plane (sectionPlane node key, quoted) XOR position+direction; depth; window.planestringsectionPlane node key (quoted). Supplies cut position + direction. Mutually exclusive with position/direction.
positionpointCut point [x,y,z] mm when plane is omitted.
directionvectorView forward [x,y,z] when plane is omitted.
depthlengthVisible range beyond the cut (mm).
windowlength[][left, bottom, right, top] mm. Omit = auto-fit.
viewStyleStyle — Style step — name of a styles[] entry (quoted or expression). Multiple steps: last wins (validate warns).namestring''styles[] name (quote literals).
Last updated: 📖 2 min readEdit on GitHub