Plan a 4K walkthrough camera path
cao_visite_planWHEN the building should be SEEN in motion rather than read on a flat plan — you direct the shot. IMPORTANT: call cao_verifier FIRST and fix every severite=critique (intégrité clos/couvert + escalier/lucarne). This endpoint REFUSES with HTTP 400 construction_critique if the scene still has critical construction defects — the 4K visit would show them. Apply fixes via REST /api/v1/cao/integrite {appliquer:true, revalider:true} then retry. DIRECT the 4K cinematic visit of a CAO scene: choose the LENS (focal length in mm, full-frame equivalent) and the CAMERA PATH. Returns a shooting plan {plan:{objectif, cadence, plans[], chemin[]}, alertes[], resume} where chemin is the full waypoint list (position/vise in mm, CAO axes x=right y=depth z=height). Rooms are detected automatically (walls → flood fill → room centres → path through doorways), one interior walk per storey plus the stair climb. Rendering is done by ONE engine, the browser GPU: paste plan into CAO editor → « Visite 4K » → « Plan de caméra piloté », or call window.CAD_startCinematicTour({plan}). To adjust: resend with a modified objectif/cadence, or send back an edited chemin (it is then used verbatim and checked). Lens catalogue (free, no key): GET /api/v1/cao/visite/objectifs. Requires API key. REST: /api/v1/cao/visite/plan.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | No | Images par seconde de la visite. 24 à 30 pour un rendu naturel ; au-delà, le fichier grossit sans gain visible. | |
| mode | No | 'deco' = furnished as modelled; 'nu' = bare shell (plaster). | deco |
| murs | No | Walls: plan segments extruded vertically. Every coordinate in this whole scene is in MILLIMETRES, in a single plan frame whose origin you choose — X to the right, Y upward, Z up from the floor. Keep one consistent origin across murs/boites/plan: the generators never recentre anything for you. | |
| plan | No | 2D reference lines — drawn flat, never extruded and never counted in the quantities. Use them for axes, plot limits or setting-out marks. | |
| boites | No | Boxes (furniture, volumes): a rectangular block placed by its CENTRE, not by a corner. Millimetres, same frame as murs[]. | |
| chemin | No | OPTIONAL: your own waypoints — replaces the computed path. | |
| georef | No | Optional Lambert-93 (EPSG:2154) false origin for IfcMapConversion. Local millimetres are scaled by 0.001 to CRS metres. Do not invent coordinates: omit est/nord if unknown (origin stays 0). orientation is the angle in degrees of project X from map East, counterclockwise. | |
| cadence | No | Pacing. Interior is a WALK: above ~1600 mm/s the video is unwatchable. | |
| cercles | No | Circles on the 2D plan, alongside plan[] lines: each has a centre and a radius, in the same unit as the plan. Use for round shapes a polyline would render badly — fillets, posts, manholes. | |
| duree_s | No | Video length, 8–900 s (default 60). A real estate walkthrough runs 480–600 s; the path is ENRICHED with extra exterior revolutions to fill it with movement rather than slowed down. | |
| reseaux | No | Plumbing pipe runs (EF/EC/EU/EV/EP/chauffage) — used only by cao_pdf (technical plan + linear-meter quantities per type). | |
| objectif | No | Lens, full-frame equivalent mm. 20 = interior standard, 35 = exterior, 50 = closing shot. Below 16 mm the image goes fisheye. | |
| toitures | No | Roofs — used only by cao_pdf. WITHOUT this field: a flat roof is auto-generated over the footprint of ALL walls (legacy default). WITH it: compose freely — each entry can target a subset of walls (via `murs`), letting you build an L-shaped building's roof, or add a dormer on top of a main roof. | |
| plomberie | No | Sanitary fixtures (sink, WC, shower…) — used only by cao_pdf. Same positioning as electricite. | |
| decoration | No | Paint/finish per wall — used only by cao_pdf. Colors the elevations (exterior face) and the axonometric view (face auto-detected by orientation relative to the building's centroid). | |
| ouvertures | No | Doors/windows embedded in a wall — used only by cao_pdf (elevations + axonometric view), no effect on dxf/metres. | |
| resolution | No | Définition du rendu — « 1080p » ou « 4k ». La 4K quadruple le temps de calcul. | 4k |
| electricite | No | Electrical symbols (outlets, switches, lights…) — used only by cao_pdf (dedicated technical plan + quantities), no effect on dxf/metres/render. Position: attached to a wall (`mur`+`position`, like ouvertures) or free (`x`,`y`). | |
| compositions | No | Named wall/slab layer sets declared by the project. A key that matches an inferred kind (mur_exterieur, refend, cloison, plancher, toiture) or murs[].composition drops the Hypothese flag. Each value is {libelle, couches: [{cle, epaisseur?}]}. cle: enduit, bloc_beton, isolant, ba13, ossature, enduit_platre, beton_arme, tuile, charpente, etancheite. Omit epaisseur on the load-bearing layer. |