Before you start
You have the house of Cut a section: a room of walls with a door, a window, a floor slab and a roof, and a project with a plan view.Give the elements a phase
The phase isexisting, new or demolished. An element with no phase is new. Here the walls, the floor and the roof stand today, the door is to be removed, and the window is new: it keeps no phase.
Save an existing and a proposed plan
phaseFilter: 'existing' draws the building before the work. phaseFilter: 'proposed' draws it after the work.
new phase, and the demolished door draws over it with its dashed pen.
A room exists in one phase. The proposed plan does not draw a demolished room, its name or its details, so an old and a new room in the same place do not print two labels. The existing plan draws the demolished room and not the new one.
Draw the finished building
phaseFilter: 'complete' draws the building as it is when the work is done: the existing and the new elements, and no demolished element. A demolished door leaves no hole in its wall. Use it where a drawing shows only the result, such as the proposed elevations of a UK planning application or a plan for the client. Use proposed where the drawing must show what is removed, and existing for the drawings of the building as it is today. A complete view draws every element with its usual pens, as the plan of a building with no phases.
Ink each phase
In a view withphaseFilter: 'proposed', each line and fill of an element carries the phase of the element, and the sheet inks it with the pen of that phase. These are the default pens:
This is how UK planning drawings tell the work apart: new work is filled, kept work is plain, and work to be removed is dashed. An existing and a complete view have no phase pens: the existing plan draws the building as it stands with the usual pens, cut walls with their poché, the same as a plan of a model of the building before the work.
The demolished dash is short, so the end of a wall and the jamb of a door show a gap at 1:100. An edge shorter than one dash, such as the end of a 100 mm wall at 1:100, draws as one dash.
The
phases entries of a paper style change the pens of a phase. Each entry takes the fields of a class entry, such as fill, hatch, dash and ink. This style greys the kept work and draws the removed work with a longer dash:
classes entry in a phase gives one element type its own pens in that phase. visible: false there leaves that type of that phase out of the drawing. This style fills the new walls, hatches the kept walls in light grey and draws the removed walls red and dashed. It leaves the removed doors, windows, stairs, floors and chimneys out of the plan; the removed walls stay. New floors, stairs and rooms keep their usual pens:
Put both states on one sheet
Each viewport draws its view in the state of the view’s filter, so one sheet holds the existing and the proposed plan of one model.Rules
phaseis on walls, doors, windows, voids, slabs, roofs, rooflights, dormers, chimneys, columns, beams, stairs, railings, ramps, rooms and placed blocks. It is not on annotations, room separators, model objects, masses or the site.set-phasesets the phase of elements of one building, hosted openings included.phase: nullremoves the field, so the element is new again.- A view with
phaseFilter: 'existing'leaves out each new element. A new opening leaves no hole in its wall. A demolished element draws as an existing one. - A view with
phaseFilter: 'complete'leaves out each demolished element. A demolished opening leaves no hole in its wall. - A view with
phaseFilter: 'proposed'draws every element but the demolished rooms, with the phase pens. A view with nophaseFilterdraws every element and has no phase pens. - A proposed plan closes each demolished door, window or void in a wall that is not demolished. The infill is the cut of the wall over the opening, with the hatch of the wall and the
newphase. A new opening that the plan cuts stays open, also where it lies inside the width of a demolished one. A plan with nophaseFilterdoes not close a demolished opening, so there it differs from the proposed plan. An arc wall is not closed yet: the opening stays open and the drawing’swarningsname the wall. - Only a proposed view has phase pens. An existing or a complete view draws each element with its usual pens.
- A room exists in one phase: a demolished room draws only in an existing view or a view with no
phaseFilter. A demolished room with noheighthas no ceiling height line. A demolished and a new room that overlap give noroom-overlapwarning, as they never stand together. - The phase pen of a line or fill comes from the element that
sourceReforsourceRefsnames. Door, window and wall tags, room names and their detail lines, dimensions and other annotations keep their own pens. - A phase pen is drawn over the class and edge-class entries of a paper style, and a
phasesentry over the default pen of its phase. The defaultexistinganddemolishedpens, and aphasesentry with afillor ahatch, also replace the poché that the drawing gives a cut. The seen surfaces of an elevation keep their fill and material hatch: a phase changes only their lines. - A
phasesentry applies to every element of that phase: walls, floors, roofs, rooms, columns and the rest. Afillthere fills each of them, so ink and dash suit most styles. To fill only the walls, put thefillinphases.<phase>.classes.WALL. - A
fill: 'paper'fills with the paper colour of the sheet, and only a cut that has a poché.phases: { existing: { fill: 'paper' } }paints the existing cut walls and columns in the paper colour and leaves the floors and the seen surfaces with no fill. - A
phases.<phase>.classesentry is drawn over thephases.<phase>entry, with itsbyKindandpartsentries. Itsvisible: falseremoves that type in that phase only, afterclasses.<type>.visible. A phase class entry with afillor ahatchalso replaces the poché of a cut. - Walls of different phases do not join into one outline. Each phase draws its own outline and poché, so the joint between an existing wall and a new or demolished one shows as a line, as it does in Revit. This holds in every view, with or without
phaseFilter, except in an existing view, where a demolished wall joins the existing walls. A model with no phases draws as before. - A wall with
joinsAcrossPhases: falsedoes not join a wall on the other side of demolished and new: a demolished wall and a new wall keep their full lengths, with no trim, mitre or T at each other, when either of the two hasfalse. A demolished wall still joins an existing wall and another demolished wall. Where walls of several phases meet at one end, the walls of the same phase join first; a wall of another phase then joins them only if it may join each of them, so a demolished wall never joins a new wall through a third wall. Without the field, walls join as before. - A proposed plan leaves open the holes of the demolished openings of a demolished wall. A demolished wall with
demolishedOpenings: 'closed'draws whole over them instead, dashed and hatched as the rest of the wall, with no line at the jambs. - Sheets, their SVG and PDF exports and the sheet renderer draw the paper phase pens. The plan editor of a proposed view draws demolished work with a screen dash of 4 px and 3 px and existing work with no poché.
- An existing cut wall has no fill, and nothing shows through it: a plan stops the lines under a cut wall at its faces. A slab edge, a room separation line, the site boundary and a line above the cut end at the faces of every cut wall, and a wall face line ends at the edge of a cut column or chimney of the storey, or of a chimney of a lower storey that reaches the cut.
- Plans, roof plans, sections and elevations take
phaseFilter. On a sheet, each viewport draws its view in the state of its filter, a raster viewport of a section or an elevation too. - In the existing and the complete state, an element goes with the element that carries it: an opening with its wall, a rooflight or a dormer with its roof, a railing with its stair.
- A link of an existing element to a new one is not drawn in the existing state. A wall that follows only new roofs keeps its own height. A stair loses the link to the hole of a new slab. A dimension that follows only new walls or slabs is not drawn; a dimension that follows a new and an existing element keeps the saved point of the new end. A join setting of a junction with a new wall is not used. In the complete state, the same holds for links to demolished elements.
elementIdsof an existing or a complete view leaves out the ids of the elements that the state leaves out. When it names only such elements, the draw is refused withunknown-element.- With a session, the existing and the complete state are each built once for each saved step of the model, when a view of that state is drawn first. An edit does no work for them. Without a session, a draw or a sheet export builds each state that it draws once and disposes it at the end.
- The plan editor edits the proposed model. It refuses a view with
phaseFilter: 'existing'or'complete'withProjectDrawingErrorcodephase-view-not-editable. - A demolition plan is not a filter yet.
Next
Compose a sheet
Put the existing and the proposed plan on one sheet.
Cut a section
Sections and elevations take the same filter.