LuaCAD Help

Systems and layers

A system says what flows in a pipe or duct – cold water, heating supply, supply air, foul water. It decides which layer a part is on and how it looks. All systems are kept in one place, the system definitions; they are the same in Piping 3D, Piping 2D, Drainage 3D and Ventilation 3D. LuaCAD creates its layers itself by a fixed scheme – and leaves every layer that already exists exactly as you set it up.

What a system is

PartMeaningExample
AbbreviationThe code by standard; shown at the part and in annotations. Several systems may share it, and it may be empty.VL, PWC, SUP
DescriptionAbbreviation and description together are the name of the system ("abbreviation-description") – it must be unique, because it is also the name of its layer.VL-Heizung, PWC-Kaltwasser reduziert
DisciplineDecides where the layer stands in the layer list: LuaCAD_<discipline>_<name>.HZG → LuaCAD_HZG_VL-Heizung
Plug-insIn which plug-ins the system is offered.Ventilation 3D only
DisplayLayer, color, linetype, lineweight and – for bodies and insulation – transparency, per part of the system ("display entry").centerline fixed color 7

Each system also has a fixed ID. It is created when the system is created and never changes – not even when you rename the system. So all parts in your drawings keep their system.

By default there are 55 systems: 32 for Piping 3D and Piping 2D, 13 for Drainage 3D, 10 for Ventilation 3D.

Display entries: the look per part

A system draws several parts: the routing line, the body, the centerline, the insulation … Each of these display entries has its own display. Which entries the system definitions show depends on the plug-in you open them from. Each entry is on one of three layers of the system: the base layer (LuaCAD_HZG_VL-Heizung), the layer …_Achse (centerline) or the layer …_Dämmung (insulation).

Plug-inDisplay entryWhat it drawsLayerDefault
Piping 3DRouting lineThe routing line; a newly created base layer gets its values.baseByLayer
Piping 3DCenterlineThe axis of pipes and fittings.centerlinefixed color 7, linetype CENTER
Piping 3DBodyPipes and fittings (layer, color, transparency only).baseByLayer, transparency ByLayer 0 %
Piping 3DSymbol below, symbol above, symbol straightThe rise/drop symbols down, up and straight.baseByLayer
Piping 3DSymbol axisThe axis of the symbols.centerlinefixed color 7
Piping 3DInsulationThe insulation shell.insulationByLayer, transparency ByLayer 80 %
Drainage 3DStack down, stack up, fixturesThe connectors of this kind.baseByLayer
Drainage 3DPlumbing line and connectorsPlumbing lines, vents, offsets, spot elevations.basemostly ByLayer, three systems fixed
Drainage 3DPipe axisThe centerline of pipes and fittings.centerlinefixed color 7
Drainage 3DBody PEPipes and fittings made of PE; a new base layer gets its values.baseByLayer
Drainage 3DBody sound-insulatedPipes and fittings of the sound-insulated product lines.baseByLayer (like body PE)
Drainage 3DInsulationThe insulation shell.insulationByLayer, transparency ByLayer 80 %
Ventilation 3DBodyDucts, round ducts, fittings and their preview at the cursor; a new base layer gets its values.baseByLayer
Ventilation 3DCenterline duct, centerline round ductThe axes.centerlinefixed color 7
Ventilation 3DDuct accessoriesGrilles, dampers, sound attenuators …basefixed gray
Piping 2DSingle-line (2D pipe)Pipes, rise/drop symbols, manifolds and symbols of Piping 2D.baseByLayer
Piping 2DRiser insulation circleThe second circle of an insulated riser.baseByLayer

The insulation of Ventilation 3D does not take its color from the system but from the insulation table.

ByLayer or fixed

Each property of a display entry is set in one of three ways:

SettingWhat the part getsWhen useful
ByLayerThe property follows the layer. Change the layer in the GstarCAD layer manager and every part on it changes at once. The value next to it is the value LuaCAD uses to create a missing layer.Color, linetype and lineweight of the routing line and the body – one layer, one color.
fixedThe value is stored at the part; a change to the layer has no effect.The centerline in color 7 (black on white, white on a dark background) on a red layer.
from CAD (empty)The current settings of the drawing at the time of inserting: the current layer, the current color.Rarely – a new system that is not set up yet looks like this.

Transparency exists only for bodies and insulation: 0 % = opaque, 90 % = almost invisible, in steps of 10 %. With the check box ByLayer the part shows the transparency of its layer.

Opening the system definitions

Plug-inLocation
Piping 3D, Drainage 3D, Ventilation 3D, Piping 2DGear menu › Settings › Systems

There is no button of its own on the ribbon. Block Library, Floor Heating, Openings and Annotation have no system definitions: Floor Heating sets its look in the gear menu › Display, and which system the connectors of a standard fixture get is set in the Block Library – systems of fixture connectors.

The system definitions opened from Piping 3D: the system list with "VL-Heizung" selected (1), Edit, Add, Remove, Duplicate (2), the plug-ins choice with Piping 3D (3), cost breakdown › Insert defaults (4), OK and Cancel (5)
The system definitions opened from Piping 3D: the system list with "VL-Heizung" selected (1), Edit, Add, Remove, Duplicate (2), the plug-ins choice with Piping 3D (3), cost breakdown › Insert defaults (4), OK and Cancel (5)

Changing the color of a system

Goal: a system gets a different color – for new parts and, through its layer, for all parts of the open drawing.

  1. Open gear menu › Settings › Systems.
  2. Select the system and click Edit (or double-click).
  3. Choose the Attributes tab. Each row is a display entry; the button shows what applies ("ByLayer | LuaCAD_HZG_VL-Heizung", with the color swatch of the layer).
  4. Click the button of the display entry – the attribute dialog box opens. Click Color, choose the new color in the GstarCAD color dialog box, OK.
  5. OK in the dialog box of the system, then OK in the system definitions.
The dialog box of a system, Attributes tab: the tabs General and Attributes (1), the row Pipe line with "ByLayer | LuaCAD_HZG_VL-Heizung" and a red swatch (2), the row Insulation with "Transparency ByLayer (80 %)" (3)
The dialog box of a system, Attributes tab: the tabs General and Attributes (1), the row Pipe line with "ByLayer | LuaCAD_HZG_VL-Heizung" and a red swatch (2), the row Insulation with "Transparency ByLayer (80 %)" (3)
The attribute dialog box of the insulation entry: layer (1), color (2), linetype (3), lineweight (4), transparency with the ByLayer check box (5) – the transparency row exists only for body and insulation
The attribute dialog box of the insulation entry: layer (1), color (2), linetype (3), lineweight (4), transparency with the ByLayer check box (5) – the transparency row exists only for body and insulation

What happens to the layer: if the color of a display entry was ByLayer and you explicitly choose another one, the new value goes to the layer of the open drawing when you click OK in the system definitions, and the entry stays ByLayer. The command line reports which layers were updated. This applies only to the entry whose values the layer carries – the routing line in Piping 3D, body PE in Drainage 3D, the body in Ventilation 3D – and in the same way to linetype and lineweight; for body and insulation also to transparency ByLayer. If instead you choose the color of the body in Piping 3D or of a rise/drop symbol, it is fixed at that entry and the layer stays.

Picture coming soonThe GstarCAD layer manager after the example: the heating supply base layer in color 30 (1), next to it its centerline and insulation layers unchanged (2), the layers of the other Piping 3D systems (3)
Video coming soon: Changing the color of a system

Creating a new system

Goal: a system that does not exist by default – for example a separate kitchen exhaust in ventilation.

The easiest way is to duplicate a similar system: the copy takes over its whole display and gets its own ID and its own layers. A system created with Add starts empty instead (abbreviation Neu, description Neues Medium, discipline general, every display entry from CAD, so without a layer) – you then set up each entry yourself.

  1. Open the system definitions from the plug-in that will use the system (here Ventilation 3D).
  2. Select a similar system and click Duplicate. The copy is named like the original with a number at the abbreviation: ETA-Abluft becomes ETA[1]-Abluft.
  3. Edit the copy: General tab – abbreviation, description, discipline, plug-ins (field by field: Editing a system).
  4. On the Attributes tab adjust the display entries – as in Changing the color of a system.
  5. OK, then OK in the system definitions. The system appears at once in the System list of the palette.
Video coming soon: Creating a new system

Editing a system field by field

General tab:

FieldEffectExample
AbbreviationCode by standard; may occur several times and may be empty.VL
DescriptionWith the abbreviation the name of the system and its layer.Heizung
RemarkFree text.Vorlauf
Catalog system groupAssigns the system to the groups of the manufacturer catalogs (heating, domestic water, ventilation …).heating
SubstanceLiquid or gas.gas for compressed air
DisciplineSAN, HZG, LUE, KAE, ELT, BRS, ALG – or "without layer – current layer": then the system has no layer of its own.HZG
Plug-insPiping 3D, Drainage 3D, Ventilation 3D, Piping 2D – where the system is offered.Ventilation 3D only
Cost breakdown › eBKP-HThe cost breakdown code for pipes, fittings, valves and insulation of this system; empty = default, "-" = explicitly none.D05.04

Attributes tab: one button per display entry (see Display entries). The shortcut menu of a button has Copy style (Ctrl+C) and Paste style (Ctrl+V) – this way you take over the display of one entry into another entry, another system or an annotation template. What the target entry does not know is dropped silently.

Systems of Piping 2D

Goal: show the pipes in the 2D plan in their own way – independent of how Piping 3D shows the same system.

Piping 2D has its own list in the system definitions. They are the same systems as in Piping 3D (same ID – annotation, schedules and the conversion to 3D stay the same), but with their own display: single-line (2D pipe) and riser insulation circle. Both are on the base layer of the system – the same layer as in Piping 3D.

  1. Piping 2D › gear menu › Settings › Systems. Piping 2D is selected under Plug-ins.
  2. Edit the system, Attributes tab, change the entry single-line (2D pipe).
  3. OK, OK.
FunctionEffect
First start of Piping 2DAll systems of Piping 3D are taken over into Piping 2D once, with the display of their routing line. After that you maintain the list yourself.
Take over from Piping 3DOnly in the Piping 2D list: fetches the systems of Piping 3D that are still missing in 2D – saved with OK.
Add, DuplicateCreated in the Piping 2D list, the system belongs to Piping 2D only.
RemoveIf the system is also in a 3D plug-in, it only leaves Piping 2D (after a question); it stays there.
Video coming soon: Systems of Piping 2D

The layers of LuaCAD

LuaCAD finds and creates layers by a fixed layer standard – the same in all plug-ins. The principle: you decide about your layers, LuaCAD overwrites nothing.

Layer names

KindSchemeExample
System, base layerLuaCAD_<discipline>_<abbreviation>-<description>LuaCAD_HZG_VL-Heizung
System, centerline…_AchseLuaCAD_HZG_VL-Heizung_Achse
System, insulation…_DämmungLuaCAD_HZG_VL-Heizung_Dämmung
Connectors per discipline (not plotted)LuaCAD_<discipline>_AnschlüsseLuaCAD_SAN_Anschlüsse
Annotation per disciplineLuaCAD_<discipline>_BeschriftungLuaCAD_HZG_Beschriftung
GroupsLuaCAD_<discipline>_<group>LuaCAD_SAN_Apparate, LuaCAD_BAU_Aussparung
Auxiliary layersLuaCAD_HLP_…LuaCAD_HLP_Nicht löschen (do not delete)

Codes in the name: SAN plumbing, HZG heating, LUE ventilation, KAE cooling, ELT electrical, BRS fire protection, ARC architecture, BAU openings, PLN title block and layouts, BES annotation, ISO isometric, IFC IFC import, HLP auxiliary, ALG general. A system can carry the disciplines SAN, HZG, LUE, KAE, ELT, BRS and ALG. The layer names follow the program language (German today).

A new layer of a system gets color, linetype and lineweight of the display entry whose values it carries (Piping 3D: routing line, Drainage 3D: body PE, Ventilation 3D: body); white and black are created as color 7. The insulation layer gets the transparency of the insulation.

When LuaCAD creates a layer

OccasionWhat is created
A palette opens, the drawing changesThe base layers of all systems of the plug-in and its group layers – without an undo step, the drawing does not count as modified.
A part is insertedThe layer the part needs (for example the centerline layer with the first pipe).
Gear menu › Layers › Create all layers of this plug-inAll layers the plug-in can use.

Locked layer

If a part is on a locked layer, LuaCAD changes nothing about it – no moving, no rebuilding, no values, not even when updating after a CAD command. The command line says that the layer is locked, the part was not changed and the change was reversed. A part made of several objects stays whole. New parts are created on a locked layer as well, as with the GstarCAD commands.

If a new part lands on a frozen or turned-off layer, the command line says that the part is not visible.

Blocks

The LuaCAD drawing template

New drawings are created from the LuaCAD drawing template (LuaCAD.dwt, see Welcome window). It already contains the base layers of all default systems, the group layers of all plug-ins, the annotation layers per discipline and the layers of the layouts (title block, sheet border, viewports, survey origin). The centerline and insulation layers are created with the first part that needs them – or with Create all layers of this plug-in.

Creating all layers of a plug-in

Goal: have all layers a plug-in can use in the drawing at once – for example to set up an office template with your own names and colors.

  1. Open the gear menu in the palette of the plug-in.
  2. Under Layers › Create all layers of this plug-in.
  3. The command line tells you how many layers were created and that existing ones stayed unchanged.

Only missing layers are created: in Piping 3D for example the base, centerline and insulation layers of all systems, the annotation layers of the disciplines, the layers of the isometric and of the connectors. Every plug-in with layers of its own has this entry.

Video coming soon: Creating all layers of a plug-in