Stori3D

Delete elements by id (a wall takes its doors and windows with it). Deleting a level, or more than 10 elements, asks the user in Stori3D first — tell them why.

Remove a property definition (values already on elements are kept).

Delete a sheet and the drawings placed on it (the model and the notes on drawings stay). Undoable.

A path-traced (photo-real) image: glass, lamps and the sky's light, saved on the user's computer. Takes from under a minute to many minutes: samples 64 is a quick draft, 256 good (default), 1024 best; bigger images take longer. Set the sky (set_sky) and sun (set_sun) and the camera (a saved view) first. The user sees Stori3D busy meanwhile. Returns where it was saved.

Answer a comment thread on the review link (its id or number from list_comments), as the signed-in user: the client sees it on the link. The user sees your answer and allows it first. resolve: true also marks it resolved.

Mark a comment thread on the review link resolved (or open again with resolved: false). Clients see it.

Save the user's current camera as a named view (for presenting, image exports and share links). Set it up first with set_camera.

Select elements in Stori3D so the user sees them highlighted and their properties (e.g. the doors that fail a check). Empty ids clears the selection.

Make a level the active one (the one being edited and drawn in plan; others show ghosted or hidden). New elements go on the active level unless you name one.

Move the user's view: preset "overview", "top" (plan view of the active level) or "element" (frame one element), or an eye position and target (plan mm plus height in mm above ground).

The details shown with shared tours: architect, client, location, description (plain text). Levels and floor area are added automatically.

Set custom property values on an element (null clears one). Values are checked against the project's definitions (types, choices). Setting data on an untagged room tags it and returns its new id.

Cut the model to see inside: "plan" (horizontal, height mm above the active floor), "x" (vertical at plan x = offset mm), "y" (vertical at plan y = offset mm), or "off".

Put the project on the map: an address (looked up; the first match is used, and the matches are returned) or latitude/longitude, and north: degrees true north is turned clockwise from the plan's north (up). The map, terrain and neighbouring buildings load around it, and set_sun can then light it. Changes the project's saved site (not an undo step).

The project's sky (list_skies): an HDRI environment that lights the model with realistic reflections and ambient light and can show behind it. id "none" goes back to the default lighting. rotation (degrees) turns it, e.g. to put the sunset behind the building; intensity is the lighting strength (1 = as photographed, 0–5); background false lights the model without showing the sky; blur (0–1) softens the background. Settings you leave out keep their current values. Saved with the project; one undo step. Works alongside set_sun (direct sunlight and shadows).

Sun and shadows for the site (needs a site location: set_site): it changes the project's saved sun (not an undo step). Date YYYY-MM-DD and time in hours local to the site (e.g. 9.5 = 09:30). Returns the sun's azimuth (degrees clockwise from north) and altitude. Use with capture_view for shadow studies.

The title block every sheet shares: project, practice, projectNumber, drawnBy, layout (corner, strip down the right side, or band along the bottom) and fields, the practice's own boxes (label and value, e.g. Checked, Client ref). The client and site come from set_project_details.

Publish the project as a link anyone can open in a browser (no account): view-only, or a review link with comments: true, where clients pin comments on the model (list_comments reads them). The user is asked first; the project must be in the cloud (signed in), and review links need a plan with them. The link updates on every cloud save. Returns the link.

Publish a tour as a player-only link (play/pause/speed, optional walking, project details; nothing else) and return it. With `story: true` it is shared as a scroll story instead: a page that opens on the floor plan and, as the visitor scrolls, raises the walls, comes down to where the tour starts and walks it, each room turning from a drawing to its materials as the camera goes in. A tour can have both links. The user is asked to allow it first, and the project must be signed in to the cloud. The link updates on every cloud save. Set the project details with set_project_details first.

Boolean on closed objects, by id (elements or other objects): union (merge), subtract (the first minus the others, which are removed), trim (the same, the others kept) or intersect (only the overlap). The first id is kept and becomes a plain mesh (it loses parametric data, so walls, slabs, roofs, stairs and columns can only cut, not be cut). A door or window used to cut cuts its rough opening and stays, e.g. to open an imported wall. Objects that aren't closed solids are refused. Returns the result's id.

Split a wall in two, offset mm from its start (along its centre line): the wall keeps the first part and its id, a new wall (returned) takes the rest with the doors and windows in it. Not through a door or window, nor within 50 mm of an end. Curved walls split into two arcs of the same circle.

Whether Stori3D is connected, and to which project.

Take a link down, so it stops working: the project's link (default), or a tour's link or scroll story (tour, story). The user is asked first. Comments already made are kept.

Undo your own last change (only if the latest step in Stori3D's history is an AI change — never the user's).

Change an element. Lengths in mm, angles in degrees. By kind: level {name, elevation, height}; wall {length (along its centre line), height, thickness, type (a wall type name or null), bulge (curves it: mm its middle bows out, + to the left going start to end, 0 straight, at most half its straight length), start, end (moves its ends; walls joined there follow)}; slab {thickness}; roof {roofType flat|shed|gable|hip, pitch, overhang, thickness}; stair {width, going, maxRiser, rise, shape straight|L|U, turn left|right, winders (true: an L or U turns on tapered treads instead of a landing), position, rotation}; door/window {width, height, open 0–1, hand left|right, offset (slides it along its wall: mm from the wall's start to its centre)}, window also {sill}; model {position, rotation} (moves an imported model or group); furniture {position, rotation, width, depth, height, lamp {on, lumens, kelvin}}; column {shape rect|round, width, depth, height, position, rotation}; beam {start, end, width, depth, top}; ramp {start, end, width, rise, thickness, transition, headroom}; lift {position, rotation, width, depth, wall, height, doorWidth, doorHeight}; parking {start, end, count, accessible, bayWidth, bayLength, angle, startNumber} (moving start/end refits the count unless count is given); grid {origin, rotation, xSpacings, ySpacings, numbers, letters, extension}; room {name}. wall also {attachTop: true} to extend it up to the roof over it. Any: {name}. Fields a kind doesn't have are an error. A size outside the element's limits fails with the allowed range unless clamp is true.

Change a sheet: name, number, paper, orientation, status; revise with a note to issue the next revision (P1 → P2, A → B) dated today; removeDrawing (a drawing's id) takes a drawing off it.

Change a tour (id or name): name, loop, fov, walk (null: no walking), path (replaces all points; same format as create_tour) or stops.