.. index::
   single: Command Reference

Command Reference
=================

Complete list of every command recognised by the IQcad command line.
Type a command name or its alias and press **Enter**.

.. index::
   single: CAD Commands

CAD Commands
------------

.. index::
   single: File

File
~~~~

.. index::
   single: NEW (command)
   single: OPEN (command)
   single: SAVE (command)
   single: SAVEAS (command)
   single: EXPORTPDF (command)
   single: CLOSE (command)
   single: EXPORTDXF (command)
   single: EXPORTIMAGE (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``NEW``
     - —
     - Create a new empty drawing.
   * - ``OPEN``
     - ``O``
     - Open a drawing file.
   * - ``SAVE``
     - —
     - Save the drawing to its current file.  An untitled drawing prompts for
       a name and is then added to the recent-files list.
   * - ``SAVEAS``
     - —
     - Save the drawing under a new name.  The chosen file joins the
       recent-files list.
   * - ``CLOSE``
     - —
     - Close the current drawing.
   * - ``EXPORTDXF``
     - —
     - Export the drawing to DXF.
   * - ``EXPORTIMAGE``
     - —
     - Export the drawing to an image file.
   * - ``EXPORTPDF``
     - —
     - Export the drawing to PDF.  For sheet output use ``PLOTPDF``, which
       honours the layout's page setup.

.. index::
   single: Drawing

Drawing
~~~~~~~

.. index::
   single: LINE (command)
   single: POLYLINE (command)
   single: MULTILINE (command)
   single: ARC (command)
   single: ARC_SCE (command)
   single: ARC_SCA (command)
   single: ARC_SCL (command)
   single: ARC_SEA (command)
   single: ARC_SED (command)
   single: ARC_SER (command)
   single: ARC_CSE (command)
   single: ARC_CSA (command)
   single: ARC_CSL (command)
   single: ARC_CONT (command)
   single: CIRCLE (command)
   single: CIRCLE_CD (command)
   single: CIRCLE_2P (command)
   single: CIRCLE_3P (command)
   single: ELLIPSE (command)
   single: SPLINE (command)
   single: RECTANGLE (command)
   single: POLYGON (command)
   single: HATCH (command)
   single: TEXT (command)
   single: MLEADER (command)
   single: ARROW (command)
   single: POINT (command)
   single: XLINE (command)
   single: 3DFACE (command)
   single: 3DPOLY (command)
   single: EXTRUDE (command)
   single: SWEEP (command)
   single: IMAGEATTACH (command)
   single: BEZIER (command)
   single: TABLE (command)
   single: MTEXT (command)
   single: SOLID (command)
   single: WIPEOUT (command)
   single: -HATCH (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``LINE``
     - ``L``
     - Draw a line (click start and end points, or type coordinates).
   * - ``POLYLINE``
     - ``PL``, ``PLINE``
     - Draw a polyline (multi-segment, optional arc segments via ``A``).
   * - ``MULTILINE``
     - ``ML``
     - Draw a multiline (parallel strands using the current multiline style).
   * - ``ARC``
     - ``A``
     - Draw a three-point arc (start, pass-through, end).
   * - ``ARC_SCE``
     -
     - Arc: Start, Center, End (3 mouse clicks).
   * - ``ARC_SCA``
     -
     - Arc: Start, Center, then mouse defines endpoint (angle).
   * - ``ARC_SCL``
     -
     - Arc: Start, Center, then mouse defines endpoint (chord length).
   * - ``ARC_SEA``
     -
     - Arc: Start, End, then mouse defines arc midpoint (angle).
   * - ``ARC_SED``
     -
     - Arc: Start, End, then mouse defines arc midpoint (direction).
   * - ``ARC_SER``
     -
     - Arc: Start, End, then mouse defines arc midpoint (radius).
   * - ``ARC_CSE``
     -
     - Arc: Center, Start, End (3 mouse clicks).
   * - ``ARC_CSA``
     -
     - Arc: Center, Start, then mouse defines endpoint (angle).
   * - ``ARC_CSL``
     -
     - Arc: Center, Start, then mouse defines endpoint (chord length).
   * - ``ARC_CONT``
     -
     - Arc: Continue from last entity's endpoint.
   * - ``CIRCLE``
     - ``C``
     - Draw a circle (centre + radius).
   * - ``CIRCLE_CD``
     -
     - Circle: Centre, then mouse defines diameter.
   * - ``CIRCLE_2P``
     -
     - Circle: Two points define the diameter endpoints.
   * - ``CIRCLE_3P``
     -
     - Circle: Three points define the circumscribed circle.
   * - ``ELLIPSE``
     - ``EL``
     - Draw an ellipse (centre, then X-radius, then Y-radius).
   * - ``SPLINE``
     - ``SP``
     - Draw a spline through a series of control points.
   * - ``RECTANGLE``
     - ``REC``
     - Draw a rectangle (two opposite corners).
   * - ``POLYGON``
     - ``POL``
     - Draw a regular polygon (number of sides, centre, radius).
   * - ``HATCH``
     - ``H``
     - Create a hatch fill area.
   * - ``TEXT``
     - ``T``
     - Place single-line text.
   * - ``MLEADER``
     - ``MLD``
     - Draw a multileader (arrowhead, landing, and text label).
   * - ``ARROW``
     - ``AR``
     - Draw an arrow entity.
   * - ``POINT``
     - ``P``, ``PT``
     - Place a point marker.
   * - ``XLINE``
     - ``XL``
     - Draw a construction line (infinite in both directions).
   * - ``3DFACE``
     - ``3F``
     - Draw a 3-D face (3 or 4 corner points).
   * - ``3DPOLY``
     - ``3DP``
     - Draw a 3-D polyline (vertices with X, Y, Z). Supports spline-fit
       (Catmull-Rom interpolation in full 3-D). Right-click to finish.
   * - ``EXTRUDE``
     - ``EXT``
     - Extrude a closed 2D profile along the Z-axis to create a 3D polyface
       mesh. Accepts closed polylines, circles, ellipses, and rectangles.
       Prompts for extrusion height (positive = up, negative = down) and
       whether to close top and bottom with triangulated caps. The source
       profile is removed after extrusion. Supports pre-selection.
       Output: TCADPolyfaceMesh (DXF-compatible polyface mesh).
   * - ``SWEEP``
     - ``SW``
     - Sweep a closed 2D profile along a path curve to create a 3D polyface
       mesh. Select a profile, then a path. Valid paths: open polyline,
       3D polyline, arc, spline, or civil alignment. Options available before
       path selection: **T** (Twist) — rotate profile along path (degrees);
       **S** (Scale) — taper from 1.0 to end factor; **R** (Range) — specify
       start/end chainage for alignment paths; **I** (Interval) — fixed path
       sampling distance; **N** (Segments) — profile vertex count for
       circles/ellipses, or Douglas-Peucker simplification for polylines.
       Supports pre-selection (one profile + one path). Output: TCADPolyfaceMesh.
   * - ``IMAGEATTACH``
     - ``IA``
     - Attach a raster image (PNG, JPG, BMP, TIFF). Enter file path or press
       Enter to browse. If an ESRI world file (``.jgw``, ``.pgw``, ``.bpw``,
       ``.tfw``) exists, prompts ``Use georeferenced placement? [Yes/No]``.
       **Yes** (default): places at the world-file origin automatically.
       **No**: interactive placement with pre-filled width and rotation.
   * - ``BEZIER``
     - ``BEZ``
     - Draw a Bézier curve.
   * - ``TABLE``
     - ``TBL``
     - Place a table. Click an insertion point to create a default 3 × 3 table.
       After placement, edit cells, row/column counts, and style in the Object
       Inspector. Cells support formulas and clipboard paste from Excel /
       LibreOffice.
   * - ``MTEXT``
     - ``MT``
     - Place multiline text.
   * - ``SOLID``
     - ``SO``
     - Draw a 2D filled solid.
   * - ``WIPEOUT``
     - ``WO``
     - Mask an area with a background-coloured polygon, hiding what lies
       beneath.  Options: pick points and right-click to close (default);
       ``Polyline`` converts a polyline — the selected one, or it prompts for
       one — closing it automatically if it is open, and optionally erasing
       it; ``Frames`` turns every wipeout's outline on or off (the
       ``WIPEOUTFRAME`` system variable).
   * - ``-HATCH``
     - ``BH``
     - Create a hatch from the command line (no dialog).

.. index::
   single: Modify

Modify
~~~~~~

.. index::
   single: ERASE (command)
   single: MOVE (command)
   single: COPY (command)
   single: ROTATE (command)
   single: SCALE (command)
   single: OFFSET (command)
   single: MIRROR (command)
   single: TRIM (command)
   single: EXTEND (command)
   single: CHAMFER (command)
   single: FILLET (command)
   single: BREAK (command)
   single: JOIN (command)
   single: ALIGN (command)
   single: DIVIDE (command)
   single: MEASURE (command)
   single: ARRAY (command)
   single: PEDIT (command)
   single: UNDO (command)
   single: REDO (command)
   single: COPYCLIP (command)
   single: CUTCLIP (command)
   single: PASTECLIP (command)
   single: PASTEORIG (command)
   single: DUPLICATE (command)
   single: SELECTALL (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``ERASE``
     - ``E``
     - Delete selected objects.  If no objects are pre-selected, prompts
       "Select objects:" — pick objects then right-click to confirm or
       press Escape to cancel (matches AutoCAD behaviour).
   * - ``MOVE``
     - ``M``
     - Move selected objects (base point → destination point).
   * - ``COPY``
     - ``CO``
     - Copy selected objects.
   * - ``ROTATE``
     - ``RO``
     - Rotate selected objects about a base point.
   * - ``SCALE``
     - ``SC``
     - Scale selected objects from a base point.
   * - ``OFFSET``
     - ``O``
     - Offset an entity by a distance or through a point.  Supports Line,
       Circle, Arc, XLine, Polyline, Ellipse, Spline, and Rectangle.  The
       default distance is stored in the ``OFFSETDIST`` system variable.
       Sub-options: **T** = offset through a picked point, **E** = erase
       the source entity after offsetting, **U** = undo last offset.
       A phantom preview shows the offset result while picking the side.
   * - ``MIRROR``
     - ``MI``
     - Mirror selected objects across a two-point axis.
   * - ``TRIM``
     - ``TR``
     - Trim objects to cutting edges. Phase 1: select cutting edges (or type
       ``ALL``). Phase 2: click the portion to remove.
   * - ``EXTEND``
     - ``EX``
     - Extend a line to a boundary edge. Phase 1: select boundary edges.
       Phase 2: click the end to extend.
   * - ``CHAMFER``
     - ``CHA``
     - Chamfer (bevel) two lines. Sub-option ``D`` sets chamfer distances
       (``$CHAMFERA`` / ``$CHAMFERB``). Zero distance trims to intersection.
   * - ``FILLET``
     - ``F``
     - Fillet (round) two lines with an arc. Sub-option ``R`` sets the radius
       (``$FILLETRAD``). Zero radius trims to intersection.
   * - ``BREAK``
     - ``BR``
     - Break an entity between two points. Pick the object (the pick point is
       the first break point), then "Specify second break point or [First
       point]:". **F** = re-pick first point, ``@`` = break at a single point
       with no gap. Lines, arcs and polylines split into two entities (or are
       shortened at an end); a circle becomes an arc (the portion
       counter-clockwise from the first to the second point is removed);
       closed polylines become one open polyline. Single undo step restores
       everything.
   * - ``JOIN``
     - ``J``
     - Join lines, arcs and polylines. Collinear touching lines merge into one
       line; touching arcs on the same circle merge into one arc; other
       touching chains merge into a polyline. Arc segments are preserved as
       true bulge (curved) segments. Reports "N object(s) joined into M."
   * - ``ALIGN``
     - ``AL``
     - Align objects using 1–2 source/destination point pairs: first pair
       translates; second pair adds rotation (Enter after the first pair =
       move only). Then prompts "Scale objects based on alignment points?
       [Yes/No] <No>". Objects picked as destination reference are not
       affected.
   * - ``DIVIDE``
     - ``DIV``
     - Place point entities dividing an entity into N equal segments
       (2–32767). Open entities get N−1 interior points; closed entities
       (circles, closed polylines) get N points. Works on Line, Polyline,
       Arc, Circle, Ellipse, and Spline entities.
   * - ``MEASURE``
     - ``ME``
     - Place point entities along an entity at a fixed interval, starting
       from the end nearest the pick point. The final partial segment
       remains. Same entity types as ``DIVIDE``.
   * - ``ARRAY``
     - ``ARR``
     - Rectangular, polar or path array of the selected objects. Prompts
       "Enter array type [Rectangular/Polar/PAth] <Rectangular>".
       Rectangular: rows, columns, row/column spacing (negative spacing
       allowed). Polar: centre point, item count, angle to fill <360>,
       rotate items Yes/No. Path: pick a path entity, Divide (count) or
       Measure (spacing) placement, align items with the path Yes/No.
       Creates plain copies (alias is ``ARR`` because ``AR`` belongs to
       ``ARROW``).
   * - ``PEDIT``
     - ``PE``
     - Edit a polyline. Select a polyline (or Line/Arc/Circle to convert). Sub-options:
       **C**\ lose / **O**\ pen, **J**\ oin, **W**\ idth, **E**\ dit vertex
       (N/P/M/I/D/S sub-mode), **S**\ pline, **D**\ ecurve, **R**\ everse,
       e\ **X**\ it. Supports both 2D and 3D polylines.
   * - ``UNDO``
     - ``U``
     - Undo the last action.
   * - ``REDO``
     - —
     - Redo the last undone action.
   * - ``COPYCLIP``
     - ``CC``
     - Copy the selection to the clipboard, whichever tab (model or a layout)
       is active. Stamps the clipboard with the source space and drawing
       scale so a later paste can auto-scale.
   * - ``CUTCLIP``
     - ``CX``
     - Cut the selection to the clipboard, whichever tab (model or a layout)
       is active. Stamps the clipboard with the source space and drawing
       scale so a later paste can auto-scale.
   * - ``PASTECLIP``
     - ``CV``
     - Paste entities from the clipboard onto whichever tab is active. A
       ghost of the entities follows the cursor; click (or type ``x,y``) to
       place them, Esc, a right-click, or pressing Enter on an empty command
       line cancels. Pasting between model and a
       layout auto-scales by the drawing scale, so text and tables land at
       the size they plot at; viewports are never carried across the
       clipboard (copying leaves them out). Legacy clipboards without scale
       metadata paste unscaled.
   * - ``PASTEORIG``
     - —
     - Paste entities from the clipboard at their original coordinates, onto
       whichever tab is active. Same auto-scaling as ``PASTECLIP``, but
       non-interactive.
   * - ``DUPLICATE``
     - ``DU``
     - Duplicate the selected entities in place.
   * - ``SELECTALL``
     - ``SA``
     - Select every entity on the active tab.

.. index::
   single: Super Tools

Super Tools
~~~~~~~~~~~

Express/CadTools-style helpers.  Full workflow notes:
:doc:`../super_tools/index`.

.. index::
   single: FLATTEN (command)
   single: PLSIMPLIFY (command)
   single: PLSIM (command)
   single: PLGETZ (command)
   single: PGZ (command)
   single: BESTFITLINE (command)
   single: DGRID (command)
   single: BFL (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``FLATTEN``
     - —
     - Set Z = 0 on the selected objects. Press Enter at the selection
       prompt to flatten the whole drawing. Also zeros polyline
       Elevation. Reports how many objects changed. Undoable. Ribbon /
       menu: **Super Tools → Cleanup**.
   * - ``PLSIMPLIFY``
     - ``PLSIM``
     - Douglas–Peucker vertex reduction on selected 2D/3D polylines.
       Prompts for a deviation tolerance (drawing units; default 0.01,
       session-remembered). 2D polylines use XY deviation; 3D polylines
       use 3D. Arc bulges densify then clear; spline-fit is cleared.
       Optional ``PLSIMPLIFY 0.05`` when objects are pre-selected.
       Undoable. Ribbon / menu: **Super Tools → Polylines**.
   * - ``PLGETZ``
     - ``PGZ``
     - Sample Z from a surface or point cloud along selected paths
       (2D/3D polylines and **lines**; multi-select OK). Sample mode
       **Vertices** (default) / Interval / Both; **Vertex interval**
       (default 1) is prompted only for Interval or Both. Missing
       samples use **Z = 0**. 2D polylines are **replaced** by 3D
       polylines; 3D polylines and lines (vertices mode) update Z in
       place; densified lines become 3D polylines. Undoable.
       **Super Tools → Polylines → Get Z…**.
   * - ``BESTFITLINE``
     - ``BFL``
     - Best-fit 3D line (PCA) through vertices of the selection (points,
       lines, polylines; multi-select). Creates a new LINE on the current
       layer spanning the point cloud. Needs ≥ 2 distinct points.
       Undoable. **Super Tools → Polylines → Best Fit Line…**.
   * - ``DGRID``
     - ``DG``
     - Draw a coordinate grid in model space.  A *Create Grid* dialog sets the
       spacing, text height, target layer, style (**Draw lines** or
       **Draw ticks**) and whether to label the coordinates; you then pick two
       opposite corners of the area.  The grid is real geometry, so it plots
       and can be edited.

.. index::
   single: View

View
~~~~

.. index::
   single: ZOOM (command)
   single: ZOOMOBJECT (command)
   single: PAN (command)
   single: REGEN (command)
   single: UCSICON (command)
   single: 3DORBIT (command)
   single: PLAN (command)
   single: VPOINT (command)
   single: VIEWTWIST (command)
   single: ALIGNVIEW (command)
   single: PLANVIEW (command)
   single: DRAWORDER (command)
   single: FRONT (command)
   single: BACK (command)
   single: ABOVE (command)
   single: BELOW (command)
   single: ZW (command)
   single: REDRAW (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``ZOOM``
     - ``Z``
     - Zoom the viewport. Sub-options: ``E`` = extents, ``W`` = window,
       ``+`` / ``-`` = in / out, ``P`` = previous.
   * - ``ZOOMOBJECT``
     - —
     - Pick an entity on the canvas; the viewport zooms to its bounding
       box with a small margin.  Also available from the Civil Prospector
       right-click menu on Surface, Alignment, Profile View and Point
       Cloud nodes.
   * - ``PAN``
     - —
     - Activate real-time pan (or use middle-mouse drag).
   * - ``REGEN``
     - —
     - Force a full redraw of the canvas.
   * - ``UCSICON``
     - —
     - UCS icon display: ``ON``, ``OFF``, ``ORigin``, ``NOorigin``, ``Size``.
   * - ``3DORBIT``
     - ``ORBIT``
     - Interactive 3D orbit mode — rotate the view around the model.
   * - ``PLAN``
     - —
     - Return to the standard top-down plan view.
   * - ``VPOINT``
     - ``VP``
     - Set the viewpoint to a preset direction.
   * - ``VIEWTWIST``
     - ``VT``
     - Set a 2D view rotation angle.
   * - ``ALIGNVIEW``
     - ``AV``
     - Align the view to two picked points on the canvas.
   * - ``PLANVIEW``
     - —
     - Reset the view twist back to north-up (0° rotation).
   * - ``DRAWORDER``
     - ``DR``
     - Display order menu. Sub-options: ``F`` = front, ``B`` = back,
       ``A`` = above, ``U`` = below (under).
   * - ``FRONT``
     - —
     - Bring selected objects to front (drawn last).
   * - ``BACK``
     - —
     - Send selected objects to back (drawn first).
   * - ``ABOVE``
     - —
     - Move selected objects above a reference object (click to pick).
   * - ``BELOW``
     - —
     - Move selected objects below a reference object (click to pick).
   * - ``ZW``
     - —
     - Zoom window (pick two corners).
   * - ``REDRAW``
     - —
     - Refresh the display.

.. index::
   single: Inquiry

Inquiry
~~~~~~~

.. index::
   single: LIST (command)
   single: ID (command)
   single: DIST (command)
   single: AREA (command)
   single: ANGLE (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``LIST``
     - ``LI``
     - Print all properties of the selected object.
   * - ``ID``
     - —
     - Click a point and report its world X, Y, Z.
   * - ``DIST``
     - ``DI``
     - Measure the distance between two clicked points.
   * - ``AREA``
     - ``AA``
     - Measure an area (pick points or select an object).
   * - ``ANGLE``
     - ``AN``
     - Measure an angle (pick vertex + two ray points).

.. index::
   single: Blocks

Blocks
~~~~~~

.. index::
   single: BLOCK (command)
   single: INSERT (command)
   single: BLOCKS (command)
   single: BEDIT (command)
   single: BCLOSE (command)
   single: BLOCKMANAGER (command)
   single: EXPLODE (command)
   single: MESH2SURFACE (command)
   single: SURFACE2MESH (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``BLOCK``
     - ``B``
     - Create a block definition from selected entities.
   * - ``INSERT``
     - ``INS``
     - Insert a block reference.
   * - ``BLOCKS``
     - ``BL``
     - List all defined blocks in the drawing.
   * - ``BEDIT``
     - ``BE``
     - Edit a block definition in-place.
   * - ``BCLOSE``
     - ``BC``
     - Close the block editor and return to the drawing.
   * - ``BLOCKMANAGER``
     - ``BM``
     - Open the Block Manager dialog.
   * - ``EXPLODE``
     - —
     - Explode blocks, multilines, and polyface meshes into individual
       entities.
   * - ``MESH2SURFACE``
     - ``M2S``
     - Convert a polyface mesh entity into a TIN surface.
   * - ``SURFACE2MESH``
     - ``S2M``
     - Convert a TIN surface into a polyface mesh entity.

.. index::
   single: Dimensions

Dimensions
~~~~~~~~~~

.. index::
   single: DIMLINEAR (command)
   single: DIMALIGNED (command)
   single: DIMANGULAR (command)
   single: DIMRADIUS (command)
   single: DIMDIAMETER (command)
   single: DIMORDINATE (command)
   single: DIMARC (command)
   single: DIMBASELINE (command)
   single: DIMCONTINUE (command)
   single: DIMJOGGED (command)
   single: DIMSTYLE (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``DIMLINEAR``
     - ``DIML``
     - Create a linear (horizontal/vertical) dimension.
   * - ``DIMALIGNED``
     - ``DIMAL``
     - Create an aligned dimension (measures true distance).
   * - ``DIMANGULAR``
     - ``DIMANG``
     - Create an angular dimension.
   * - ``DIMRADIUS``
     - ``DIMRAD``
     - Create a radius dimension.
   * - ``DIMDIAMETER``
     - ``DIMDIA``
     - Create a diameter dimension.
   * - ``DIMORDINATE``
     - ``DIMORD``
     - Create an ordinate dimension.
   * - ``DIMARC``
     - —
     - Create an arc length dimension.
   * - ``DIMBASELINE``
     - ``DIMBASE``
     - Create a baseline dimension series.
   * - ``DIMCONTINUE``
     - ``DIMCONT``
     - Create a continue dimension chain.
   * - ``DIMJOGGED``
     - ``DIMJOG``
     - Create a jogged radius dimension.
   * - ``DIMSTYLE``
     - —
     - Open the Dimension Style Manager dialog.

.. index::
   single: Settings & Drawing Variables
   single: Settings
   single: Drawing Variables

Settings & Drawing Variables
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Rows whose description begins with "Set ``$NAME``" are **system
variables**, not standalone commands — change them with ``SETVAR <name>
<value>`` (alias ``SV``), for example ``SETVAR LUNITS 2``.  The
remaining rows (``UNITS``, ``GRID``, ``ORTHO``, ``SNAP``, ``OSMODE``,
``LIMITS``, ``MAKELAYER``, …) are regular commands.

.. index::
   single: UNITS (command)
   single: LUNITS (system variable)
   single: LUPREC (system variable)
   single: AUNITS (system variable)
   single: AUPREC (system variable)
   single: ANGDIR (system variable)
   single: ANGBASE (system variable)
   single: INSUNITS (system variable)
   single: MEASUREMENT (system variable)
   single: UNITMODE (system variable)
   single: LIMCHECK (system variable)
   single: LIMITS (command)
   single: LTSCALE (system variable)
   single: TEXTSIZE (system variable)
   single: DIMSCALE (system variable)
   single: OSMODE (command)
   single: GRID (command)
   single: GRIDUNIT (command)
   single: GRIDMAJOR (command)
   single: GRIDTEXT (command)
   single: GRIPSIZE (command)
   single: ORTHO (command)
   single: SNAP (command)
   single: ORTHOMODE (system variable)
   single: SNAPMODE (system variable)
   single: PICKADD (system variable)
   single: PICKAUTO (system variable)
   single: SELECTIONCYCLING (system variable)
   single: LAYERS (command)
   single: TABLESTYLE (command)
   single: SETVAR (command)
   single: SCALELISTEDIT (command)
   single: CURRENTLAYER (command)
   single: MAKELAYER (command)
   single: LINETYPES (command)
   single: TEXTSTYLE (command)
   single: PLOTSTYLE (command)
   single: POINTSTYLE (command)
   single: PROPERTIES (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``UNITS``
     - —
     - Multi-step wizard to set linear/angular units and precision.
   * - ``LUNITS``
     - —
     - Set ``$LUNITS`` — linear format (1 = Scientific, 2 = Decimal,
       3 = Engineering, 4 = Architectural, 5 = Fractional).
   * - ``LUPREC``
     - —
     - Set ``$LUPREC`` — linear precision (0–8 decimal places).
   * - ``AUNITS``
     - —
     - Set ``$AUNITS`` — angular format (0 = Decimal degrees, 1 = DMS,
       2 = Grads, 3 = Radians, 4 = Surveyor).
   * - ``AUPREC``
     - —
     - Set ``$AUPREC`` — angular precision (0–8 decimal places).
   * - ``ANGDIR``
     - —
     - Set ``$ANGDIR`` — angle direction (0 = CCW, 1 = CW).
   * - ``ANGBASE``
     - —
     - Set ``$ANGBASE`` — base angle in degrees (0 = East, 90 = North).
   * - ``INSUNITS``
     - —
     - Set ``$INSUNITS`` — insertion units (0 = Unitless, 1 = Inches,
       2 = Feet, 4 = mm, 5 = cm, 6 = m, 7 = km).
   * - ``MEASUREMENT``
     - —
     - Set ``$MEASUREMENT`` — 0 = Imperial, 1 = Metric.
   * - ``UNITMODE``
     - —
     - Set ``$UNITMODE`` — 0 = stacked display, 1 = single string.
   * - ``LIMCHECK``
     - —
     - Set ``$LIMCHECK`` — 0 = off, 1 = enforce drawing limits.
   * - ``LIMITS``
     - —
     - Set ``$LIMMIN`` / ``$LIMMAX`` — drawing limits (lower-left, upper-right).
   * - ``LTSCALE``
     - —
     - Set ``$LTSCALE`` — global linetype scale factor.
   * - ``TEXTSIZE``
     - —
     - Set ``$TEXTSIZE`` — default text height.
   * - ``DIMSCALE``
     - —
     - Set ``$DIMSCALE`` — dimension scale factor.
   * - ``OSMODE``
     - —
     - Set ``$OSMODE`` — object snap bitmask (1 = END, 2 = MID, 4 = CEN,
       8 = NOD, 16 = QUA, 32 = INT, 128 = PER, 256 = TAN, 512 = NEA).
   * - ``GRID``
     - —
     - Set grid spacing or toggle ``ON`` / ``OFF`` (also **F7**).
   * - ``GRIDUNIT``
     - —
     - Set ``$GRIDUNIT`` — grid spacing (saved with drawing).
   * - ``GRIDMAJOR``
     - —
     - Set ``$GRIDMAJOR`` — minor lines between bold major lines (default 5).
   * - ``GRIDTEXT``
     - —
     - Toggle ``$GRIDTEXT`` — X/Y coordinate labels on major grid lines.
   * - ``GRIPSIZE``
     - —
     - Set ``$GRIPSIZE`` — grip square half-size in pixels (default 5).
   * - ``ORTHO``
     - —
     - Toggle orthogonal constraint (also **F8**).
   * - ``SNAP``
     - —
     - Toggle grid snap (also **F9**).
   * - ``ORTHOMODE``
     - —
     - Set ``$ORTHOMODE`` — 0 = off, 1 = on (saved with drawing).
   * - ``SNAPMODE``
     - —
     - Set ``$SNAPMODE`` — 0 = off, 1 = on (saved with drawing).
   * - ``PICKADD``
     - —
     - 0 = replace selection, 1 = additive selection.
   * - ``PICKAUTO``
     - —
     - 0 = no implied window, 1 = implied windowing.
   * - ``SELECTIONCYCLING``
     - —
     - Overlapping pick (0 = off, 1 = badge only, 2 = badge and list,
       the default). Negative values remember the last on-mode.
       Toggle with **Ctrl+Shift+W**.
   * - ``LAYERS``
     - ``LA``
     - Open the Layer Manager dialog.
   * - ``TABLESTYLE``
     - —
     - Open the Table Style Manager (create, edit, and delete table styles).
   * - ``SETVAR``
     - ``SV``
     - Set any system variable by name and value.
   * - ``SCALELISTEDIT``
     - ``SLST``
     - Edit the scale list (add, remove, rename annotation scales).
   * - ``CURRENTLAYER``
     - ``CLAYER``
     - Set the active layer: ``CURRENTLAYER name``.
   * - ``MAKELAYER``
     - —
     - Create a layer: ``MAKELAYER name [color]``.
   * - ``LINETYPES``
     - ``LT``
     - Open the Linetypes dialog.
   * - ``TEXTSTYLE``
     - ``ST``
     - Open the Text Styles dialog.
   * - ``PLOTSTYLE``
     - —
     - Open the Plot Style dialog.
   * - ``POINTSTYLE``
     - —
     - Open the Point Style dialog.
   * - ``PROPERTIES``
     - ``PR``
     - Toggle the Object Inspector (properties) panel.

.. index::
   single: Layout & Paper Space
   single: Layout
   single: Paper Space

Layout & Paper Space
~~~~~~~~~~~~~~~~~~~~

.. index::
   single: LAYOUT (command)
   single: MVIEW (command)
   single: MVSETUP (command)
   single: VPCLIP (command)
   single: VPFADE (command)
   single: VPSCALEBAR (command)
   single: PAGESETUP (command)
   single: PLOTPDF (command)
   single: PLOT (command)
   single: PLOTALL (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``LAYOUT``
     - ``LO``
     - Layout management. Sub-options: ``N`` = new, ``D`` = delete,
       ``L`` = list (``*`` marks active), ``S`` = set active.
   * - ``MVIEW``
     - ``MV``
     - Create a viewport in paper space (Fit or 2-point). Must be on a Layout tab.
   * - ``MVSETUP``
     - ``MVS``
     - Reserved for viewport rotate/scale/title setup.  **Not implemented in
       this release** — use the Object Inspector for viewport scale and
       rotation.
   * - ``VPCLIP``
     - —
     - Clip a viewport boundary to a custom shape.
   * - ``VPFADE``
     - ``VPF``
     - Toggle viewport fade (dimmed display of inactive viewports).
   * - ``VPSCALEBAR``
     - ``VPSB``
     - Toggle scale bar display in a viewport.
   * - ``PAGESETUP``
     - —
     - Open the Page Setup dialog for the active layout.
   * - ``PLOTPDF``
     - ``PDF``
     - Unified PDF export command.  Exports the active layout to PDF.
       Replaces the older ``EXPORTPDF`` alias.
   * - ``PLOT``
     - ``PRINT``
     - Open the Print dialog (Ctrl+P).
   * - ``PLOTALL``
     - —
     - Export all layouts to a multi-page PDF.

Utility
~~~~~~~

.. index::
   single: PURGE (command)
   single: PURGELAYERS (command)
   single: PURGEBLOCKS (command)
   single: PURGESTYLES (command)
   single: PURGELINETYPES (command)
   single: AUDIT (command)
   single: RECOVER (command)
   single: RECOVERCREATELAYERS (command)
   single: DWGPROPS (command)
   single: DRAWINGPROPS (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``PURGE``
     - —
     - Remove all unused items (layers, blocks, styles, linetypes).
   * - ``PURGELAYERS``
     - —
     - Remove unused layers only.
   * - ``PURGEBLOCKS``
     - —
     - Remove unreferenced block definitions.
   * - ``PURGESTYLES``
     - —
     - Remove unused text, dimension, and table styles.
   * - ``PURGELINETYPES``
     - —
     - Remove unused linetypes.
   * - ``AUDIT``
     - —
     - Check drawing file integrity and report issues.
   * - ``RECOVER``
     - —
     - Fix drawing integrity issues found by AUDIT.
   * - ``RECOVERCREATELAYERS``
     - —
     - Recover and recreate any missing layers referenced by entities.
   * - ``DWGPROPS``
     - ``DRAWINGPROPS``
     - Print drawing statistics (entities, layers, blocks, styles, civil
       objects, model summary) to the command line.  Also available as a
       dialog on **File › Drawing Utilities › Properties…**.

Display Performance (experimental)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. index::
   single: RETAINEDGEOMETRY (command)
   single: RETLOD (command)
   single: RETAINEDSTATS (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 12 66

   * - Command
     - Alias
     - Description
   * - ``RETAINEDGEOMETRY``
     - ``RETAINED``
     - Toggle the retained-geometry display mode (``ON`` / ``OFF``, or no
       argument to toggle).  Speeds up pan/zoom on very large drawings.
       Off by default.
   * - ``RETLOD``
     - ``RETAINEDLOD``
     - Tune the retained level of detail live: ``RETLOD FACE <n>`` /
       ``DENSITY <n>`` / ``PTSIZE <n>``; no argument prints the current
       values.
   * - ``RETAINEDSTATS``
     - —
     - Print retained-geometry diagnostics (bucket and vertex counts, level
       of detail, view mode).

Miscellaneous
~~~~~~~~~~~~~

.. index::
   single: HELP (command)
   single: MAPBG (command)
   single: MAPSETTINGS (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``HELP``
     - ``?``
     - Show command help in the command line.
   * - ``MAPBG``
     - —
     - Toggle background map tile layer behind the drawing canvas.
   * - ``MAPSETTINGS``
     - —
     - Open the Map Settings dialog to add, edit, delete, and select map tile
       providers (XYZ and WMS).

.. index::
   single: Diagnostics and Test Commands
   single: GPUTEST (command)
   single: ADDSAMPLEENTITIES (command)
   single: ADDTUNNELSECTION (command)
   single: ADDREALTUNNELSECTION (command)

Diagnostics and Test Commands
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Support and development aids.  They are not part of a normal drawing
workflow, but they are the fastest way to answer "is this my machine or the
drawing?" when reporting a problem.

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 26 10 64

   * - Command
     - Alias
     - Description
   * - ``GPUTEST``
     - —
     - Test the machine's GPU/VBO capability and benchmark it.  Run this when
       display performance is poor, before changing the **GPU rendering**
       setting (:doc:`../cad_environment/15_settings`).
   * - ``ADDSAMPLEENTITIES``
     - —
     - Add one of every entity type to the drawing.  Useful for checking
       rendering, export round-trips and style changes against the full set.
   * - ``ADDTUNNELSECTION``
     - —
     - Add a sample tunnel section line.
   * - ``ADDREALTUNNELSECTION``
     - —
     - Add a real (MEIS) tunnel section line, for testing deviation analysis
       against measured data.

----

.. index::
   single: Civil Commands

Civil Commands
--------------

.. index::
   single: Survey Points

Survey Points
~~~~~~~~~~~~~

.. index::
   single: SURVEYPOINT (command)
   single: TSLINE (command)
   single: TSOPTIMIZE (command)
   single: SURVEYPOINTSTYLE (command)
   single: TSLADDPOINT (command)
   single: TSLDELETEPOINT (command)
   single: TSLCLOSEINVERT (command)
   single: TSLCLOSETOLEVEL (command)
   single: TSLSORT (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``SURVEYPOINT``
     - ``SRVPT``
     - Place an AEC survey point (Northing, Easting, Elevation).
   * - ``TSLINE``
     - ``TSL``
     - Draw a tunnel section line (measured cross-section profile for
       deviation analysis).
   * - ``TSOPTIMIZE``
     - ``TSOPT``
     - Optimize the fit between a measured tunnel profile and its theoretical
       section. Supports five optimization levels: 2P (translate), 3P
       (translate + uniform scale), 4P (translate + non-uniform scale), 5P
       (translate + scale + rotation), and per-vertex radial adjustment.
       Constraints: max overbreak/underbreak DR, max overbreak/underbreak
       area. Uses the Nelder-Mead simplex algorithm for 2P-5P modes.
   * - ``SURVEYPOINTSTYLE``
     - ``SPS``
     - Edit survey point styles.
   * - ``TSLADDPOINT``
     - ``TSLADD``
     - Add points to a tunnel section line.
   * - ``TSLDELETEPOINT``
     - ``TSLDEL``
     - Delete points from a tunnel section line.
   * - ``TSLCLOSEINVERT``
     - ``TSLINV``
     - Add invert points near the axis to close a tunnel section line.
   * - ``TSLCLOSETOLEVEL``
     - ``TSLCLVL``
     - Extend the section line ends to a target elevation.
   * - ``TSLSORT``
     - —
     - Sort tunnel section line points radially around the axis.

.. index::
   single: Surfaces

Surfaces
~~~~~~~~

.. index::
   single: CREATESURFACE (command)
   single: IMPORTDEM (command)
   single: CLOUDSURFACE (command)
   single: DEMTOTIN (command)
   single: ADDSURFACEPOINTS (command)
   single: ADDSURFACEENTITIES (command)
   single: REBUILDSURFACE (command)
   single: ADDSURFACEBOUNDARY (command)
   single: DECIMATESURFACE (command)
   single: DELETESURFACE (command)
   single: SURFACEPROPERTIES (command)
   single: EXPLODECONTOURS (command)
   single: SURFDIFF (command)
   single: PCDIFF (command)
   single: VOLUMEREPORT (command)
   single: MERGESURFACES (command)
   single: SURFACESTYLE (command)
   single: SURFBUILDSETTINGS (command)
   single: SLOPEPATH (command)
   single: FACE2SURFACE (command)
   single: ADDDXFFACES (command)
   single: ELEVTRACK (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``CREATESURFACE``
     - ``CS``
     - Create a TIN surface. If survey points exist in the drawing they are
       triangulated automatically; otherwise an empty surface definition is
       created so point groups and boundaries can be attached later.
   * - ``IMPORTDEM``
     - ``IDEM``
     - Import a GeoTIFF DEM (``.tif``) as a grid-backed surface. Decodes the
       raster natively — uncompressed, Deflate or LZW; single-band Float32 or
       Int16; strips or tiles — and georeferences it from the GeoTIFF tags
       (model tiepoint, pixel scale, CRS); no world file or external conversion
       is required. Elevations are answered by bilinear interpolation on the
       grid (no triangulation), so the DEM can be sampled by section sheets
       exactly like a TIN. NoData, voids and non-finite cells return no
       elevation (honest gaps, never fabricated ground). The CRS is reported
       but not reprojected — the DEM must already share the drawing's
       coordinate system. The surface is persisted in the drawing and
       re-decoded from its source file on reopen (a warning is shown if the
       file has moved).
   * - ``CLOUDSURFACE``
     - ``CLS``
     - Build a grid surface from a loaded point cloud, for comparison against a
       DEM or design surface. Bins the cloud's ground points (LAS class 2) into
       a regular grid, keeping the lowest Z per cell (bare earth); if the cloud
       has no ground classification it falls back to all points and suggests
       running ``PCGROUND`` first. Cell size defaults to about twice the average
       point spacing; empty cells stay void (no fabricated ground from stray
       returns). Produces a surface named ``Cloud_<name>`` that can be sampled
       in a section sheet alongside the DEM, with cut/fill reported between the
       two — the intended way to validate a DEM against survey data.
   * - ``DEMTOTIN``
     - ``D2T``
     - Resample a DEM surface into a **new** editable TIN surface, leaving the
       DEM intact.  Pick the DEM, choose a region (whole DEM, a rectangle, or an
       existing closed polyline), a cell size, and an optional decimation
       tolerance.  The DEM is sampled (bilinear) onto a regular grid tightened to
       the region — so a small high-detail region does not hit the whole-DEM cell
       cap — and triangulated; voids and out-of-region cells become gaps. The
       result is a normal ``TAECC_SURFACE`` named ``<DEM>_TIN`` (source type
       *Derived*) that can be edited, used in corridors, or contoured like any
       TIN.  (Full-resolution DEMs are far too large to triangulate directly, so
       a sensible cell size is required.)
   * - ``ADDSURFACEPOINTS``
     - ``ASP``
     - Add all survey points to a named surface and build (or rebuild) the TIN.
   * - ``ADDSURFACEENTITIES``
     - ``ASE``
     - Add selected drawing objects to a surface. Supported entity types:
       3DFace (loaded as TIN triangles directly), Line, Polyline, Spline,
       Point, and Survey Point (vertices triangulated). If only one surface
       exists it is used automatically; otherwise prompts for the surface name.
   * - ``REBUILDSURFACE``
     - ``RS``
     - Rebuild an existing surface TIN from the current survey points.
   * - ``ADDSURFACEBOUNDARY``
     - ``ASB``
     - Add a boundary polyline to a surface (outer or hole).
   * - ``DECIMATESURFACE``
     - ``DS``
     - Decimate (simplify) a TIN surface. Prompts for the surface name
       (auto-selects if only one exists) and a max elevation tolerance.
       Two algorithms are selected automatically: **grid-based O(n)** for
       surfaces > 100K points (single-pass min/max Z per cell, capped at
       50K output points, < 5 sec for 4M points); **greedy insertion** for
       ≤ 100K points (convex hull seed, binary max-heap, batched refinement).
   * - ``DELETESURFACE``
     - —
     - Delete a surface by name.
   * - ``SURFACEPROPERTIES``
     - —
     - Display surface statistics (points, triangles, area, elevation range)
       and the surface's **source type** (Survey Points / Point Cloud / DEM /
       LandXML / Merged / Derived). The source type is also shown next to each
       surface in the Civil Toolspace tree.
   * - ``EXPLODECONTOURS``
     - ``EXC``
     - Extract a surface's contour lines into editable polyline entities, placed
       on ``<Name>-Contour-Major`` / ``-Minor`` layers at each contour
       elevation (DXF-exportable). Works for any surface with contours —
       including grid-backed DEM surfaces, whose contours are generated by
       marching squares directly on the elevation grid (no triangulation). If
       the surface style has no contour intervals set, the command reports that
       rather than producing nothing.
   * - ``SURFDIFF``
     - —
     - Compare two TIN surfaces to build a **difference (diff) surface** whose
       elevation is the vertical deviation ``dz`` between them. Opens the
       **Compare Surfaces** dialog (sources, cell size, tolerance, max
       deviation, sign convention, insert/stats options) with a live
       overlap/cell-count preview. The result is a deviation-banded surface
       ``DIFF_<A>-vs-<B>``, saved with its comparison provenance so a volume
       report works later without the sources. Basis for earthwork QC.
   * - ``PCDIFF``
     - —
     - As ``SURFDIFF`` but compares a surface against a loaded point cloud
       (as-built). Adds a **PC reducer** choice (Median / Minimum / Mean) for
       collapsing multiple returns per cell to one ground value.
   * - ``VOLUMEREPORT``
     - ``VOLREPORT``
     - Earthwork **volume report** for a comparison (diff) surface: cut, fill
       and net volumes, cut/fill/total areas, deviation statistics, and a
       per-band breakdown, integrated directly from the diff TIN. Uses the
       selected diff surface, or prompts when several exist. Opens as an HTML
       report in the system browser.
   * - ``MERGESURFACES``
     - ``MS``
     - Merge two surfaces (paste or union) into a new or replaced surface.
   * - ``SURFACESTYLE``
     - ``SUS``
     - Edit surface styles.
   * - ``SURFBUILDSETTINGS``
     - ``SBS``
     - Edit per-surface build settings (triangulation algorithm and cleanup filters).
   * - ``SLOPEPATH``
     - ``SLP``
     - Trace a maximum-slope gradient line along a sketched polyline. Select a 2D/3D polyline (or pre-select it); its vertices become waypoints and the command chains a gradient path through them across the surface, never exceeding the given maximum slope (%). Draws one 3D polyline draped on the terrain (collinear runs merged), keeps the sketch, and reports lengths, climb/descent, per-leg status and a per-vertex slope list.
   * - ``FACE2SURFACE``
     - ``F2S``
     - Convert selected 3D faces into a surface.
   * - ``ADDDXFFACES``
     - ``ADF``
     - Add 3DFACE entities imported from DXF to a surface.  When the DXF
       carries 3DFACEs on several layers (typically one exported surface
       per layer), a dialog asks which layer(s) to import — either merged
       into the target surface, or, with **Create a separate surface per
       selected layer** checked, one new surface per layer named after
       it.  Single-layer files import directly, no dialog.
   * - ``ELEVTRACK``
     - —
     - Toggle the surface **Elevation Tracker** overlay — a live Z
       readout of every visible surface under the cursor.  See
       :ref:`elevation-tracker`.

.. index::
   single: Surface Editing

Surface Editing
~~~~~~~~~~~~~~~

.. index::
   single: SURFADDPOINT (command)
   single: SURFDELETEPOINT (command)
   single: SURFMOVEPOINT (command)
   single: SURFMODIFYELEV (command)
   single: SURFSWAPEDGE (command)
   single: SURFADDLINE (command)
   single: SURFDELETELINE (command)
   single: SURFRAISELOWER (command)
   single: SURFUNDO (command)
   single: SURFCLEAREDITS (command)
   single: SURFLISTEDITS (command)
   single: SURFADDBREAKLINE (command)
   single: SURFDELETELONGEDGES (command)
   single: SURFHIDETRI (command)
   single: SURFSHOWTRI (command)
   single: SURFREGRID (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``SURFADDPOINT``
     - ``SAP``
     - Add a single point to a surface TIN interactively.
   * - ``SURFDELETEPOINT``
     - ``SDP``
     - Delete a point from a surface TIN.
   * - ``SURFMOVEPOINT``
     - ``SMP``
     - Move a surface TIN point to a new position.
   * - ``SURFMODIFYELEV``
     - ``SME``
     - Modify the elevation of a surface point.
   * - ``SURFSWAPEDGE``
     - ``SSE``
     - Swap a TIN edge between two adjacent triangles.  Runs continuously
       (click edges one after another) until cancelled with Escape or
       right-click.
   * - ``SURFADDLINE``
     - ``SAL``
     - Force an edge (breakline) between two surface points.
   * - ``SURFDELETELINE``
     - ``SDL``
     - Remove a TIN edge.
   * - ``SURFRAISELOWER``
     - ``SRL``
     - Raise or lower the entire surface by a specified elevation offset.
   * - ``SURFUNDO``
     - —
     - Undo the last surface edit operation.
   * - ``SURFCLEAREDITS``
     - ``SCE``
     - Clear the surface edit log.
   * - ``SURFLISTEDITS``
     - ``SLE``
     - List all surface edit operations performed since the last clear.
   * - ``SURFADDBREAKLINE``
     - ``SAB``
     - Add the selected polyline(s) to the active surface as breaklines.
       Prompts for selection if nothing is pre-selected.
   * - ``SURFDELETELONGEDGES``
     - ``SDLE``
     - Delete TIN edges longer than a threshold.
   * - ``SURFHIDETRI``
     - ``SHT``
     - Hide TIN triangles: click inside each one, right-click to finish.  The
       faces are kept in the edit log, not deleted.
   * - ``SURFSHOWTRI``
     - ``SWT``
     - Restore every hidden triangle on the picked surface.
   * - ``SURFREGRID``
     - ``SRG``
     - Resample a surface onto a regular grid and rebuild it as a gridded TIN.

.. index::
   single: Spot Elevations & Labels
   single: Spot Elevations
   single: Labels

Spot Elevations & Labels
~~~~~~~~~~~~~~~~~~~~~~~~~

.. index::
   single: SPOTELEV (command)
   single: ADDCONTOURLABEL (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``SPOTELEV``
     - ``SE``
     - Place a spot elevation label at a clicked point on a surface.
   * - ``ADDCONTOURLABEL``
     - ``ACL``
     - Place contour labels along surface contour lines with collision
       avoidance and uphill-readable rotation.

.. index::
   single: Alignments

Alignments
~~~~~~~~~~

.. index::
   single: ALIGNMENT (command)
   single: ALIGNREVERSE (command)
   single: ALIGNPROPS (command)
   single: ALIGNFROMPOLYLINE (command)
   single: ADDPI (command)
   single: DELPI (command)
   single: EDITPI (command)
   single: ALIGNMENTREPORT (command)
   single: ALIGNMENTSTYLE (command)
   single: POINTCHAINAGE (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``ALIGNMENT``
     - ``ALG``
     - Create a horizontal alignment from PI (Point of Intersection) picks.
   * - ``ALIGNREVERSE``
     - —
     - Reverse the direction of an alignment.
   * - ``ALIGNPROPS``
     - —
     - Display alignment properties (element table, total length, etc.).
   * - ``ALIGNFROMPOLYLINE``
     - ``AFP``
     - Create an alignment from a selected polyline with optional curve
       radius at interior PIs. Accepts 2D and 3D polylines; when the
       vertices carry differing elevations, optionally also builds the
       vertical profile from the vertex Z values (one PVI per vertex,
       with an optional vertical curve length at interior PVIs).
   * - ``ADDPI``
     - ``API``
     - Click to insert a horizontal PI into an alignment. After picking the
       alignment, prompts once for a default curve radius (and, if > 0, a
       spiral length and type); the defaults are applied to every PI clicked
       in the run. Enter through the prompts for sharp radius-0 PIs. Enter
       finishes; every click is one undo step.
   * - ``DELPI``
     - ``DPI``
     - Click a PI to delete it (nearest PI within the pick tolerance). End
       PIs may be deleted; an alignment keeps at least 2 PIs.
   * - ``EDITPI``
     - ``EPI``
     - Click a PI to edit its curve radius and spiral (current values as
       defaults); end PIs have no curve.
   * - ``ALIGNMENTREPORT``
     - ``ALR``
     - HTML alignment report, opened in the browser: plan sketch, PIs,
       horizontal elements, curve and spiral data, profile sketch, PVIs,
       vertical curve data, cross-section model and a station table.
   * - ``ALIGNMENTSTYLE``
     - ``ALS``
     - Edit alignment styles.
   * - ``POINTCHAINAGE``
     - ``PCH``
     - Report chainage and offset of picked points against an alignment.

.. index::
   single: Profiles

Profiles
~~~~~~~~

.. index::
   single: QUICKPROFILE (command)
   single: CREATEPROFILEVIEW (command)
   single: DESIGNPROFILE (command)
   single: ADDPVI (command)
   single: DELPVI (command)
   single: PROFILEPROPS (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``QUICKPROFILE``
     - ``QP``
     - Create a quick profile along a polyline or line by sampling a
       surface.  Select source entity, then surface, then click insertion
       point.
   * - ``CREATEPROFILEVIEW``
     - ``CPV``
     - Create a profile view from an alignment.  Select alignment, then
       surface, then click insertion point.  Samples ground profile and
       includes design vertical alignment if present.
   * - ``DESIGNPROFILE``
     - ``DP``
     - Create a design profile (vertical alignment) inside a profile view.
       Click PVIs in the view, then enter curve lengths at each interior
       PVI.
   * - ``ADDPVI``
     - ``APV``
     - Click inside a profile view to insert a design-profile PVI (curve
       length 0) at the clicked station/elevation, kept in station order.
   * - ``DELPVI``
     - ``DPV``
     - Click a design-profile PVI in a profile view to delete it; deleting
       all PVIs clears the design line.
   * - ``PROFILEPROPS``
     - —
     - Display profile view properties (station range, elevation range,
       profile count).

.. index::
   single: Cross-Sections

Cross-Sections
~~~~~~~~~~~~~~

.. index::
   single: CREATESECTIONSHEET (command)
   single: EARTHWORKVOLUMES (command)
   single: CREATESECTIONSHEETDLG (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``CREATESECTIONSHEET``
     - ``CSS``
     - Create a cross-section sheet: select alignment, surfaces, interval,
       widths, grid layout, cut/fill surfaces, and click insertion point.
   * - ``EARTHWORKVOLUMES``
     - ``EWV``
     - Compute and display earthwork volume table using the average end
       area method (cut/fill areas, volumes, cumulative totals).
   * - ``CREATESECTIONSHEETDLG``
     - ``CSSD``
     - Create a cross-section sheet via dialog.

.. index::
   single: Parcels

Parcels
~~~~~~~

.. index::
   single: CREATEPARCEL (command)
   single: PARCELCHECK (command)
   single: PARCELTABLE (command)
   single: PARCELREPORT (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``CREATEPARCEL``
     - ``PARCEL``
     - Create a parcel from a closed polyline.  Prompts for a parcel name,
       then click a closed polyline to define the boundary.  Area and
       perimeter are computed automatically, and every corner is assigned
       a vertex name (see :ref:`parcel-vertex-names`).
   * - ``PARCELCHECK``
     - ``PCHK``
     - Check-and-fix hub for parcel vertex issues.  Sub-options
       **Report** (default, read-only listing of duplicate vertices,
       unnamed vertices, mismatched shared corners, and duplicate names),
       **Fix** (repairs everything Report finds; offers to set the
       drawing's vertex prefix), **reNumber** (confirmation-guarded
       full drawing-wide re-sequence), and **Prefix** (directly change
       the drawing's vertex-name prefix; affects newly assigned names
       only).
   * - ``PARCELTABLE``
     - —
     - Insert a coordinate table (Point/X/Y/Dist. plus Perimeter and
       Area) for the selected parcels, or all parcels if none are
       selected.  The Point column shows each corner's vertex name,
       falling back to its index when unnamed.
   * - ``PARCELREPORT``
     - —
     - Generate an HTML report (sketch plus coordinate table) for the
       selected parcels, or all parcels if none are selected, and open
       it in the system browser.

.. index::
   single: Assemblies & Corridors
   single: Assemblies
   single: Corridors

Assemblies & Corridors
~~~~~~~~~~~~~~~~~~~~~~

.. index::
   single: ASSEMBLIES (command)
   single: SAMPLEASSEMBLIES (command)
   single: BUILDCORRIDOR (command)
   single: CORRIDORAUTO (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``ASSEMBLIES``
     - —
     - Open the Assembly Editor.
   * - ``SAMPLEASSEMBLIES``
     - ``SAS``
     - Seed the assembly library with the six standard road templates
       (same set as the shipped standard-roads.iqal).
   * - ``BUILDCORRIDOR``
     - ``BC``
     - Build the corridor for an alignment.  Prints cut/fill,
       excavation-to-formation and per-material quantities.
   * - ``CORRIDORAUTO``
     - ``CA``
     - Toggle corridor auto-rebuild (live update on alignment/surface edits).

.. index::
   single: Grading

Grading
~~~~~~~

.. index::
   single: GRADING (command)
   single: BUILDGRADING (command)
   single: GRADINGBALANCE (command)
   single: GRADINGEXTRACT (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``GRADING``
     - ``GRD``
     - Open the Grading dialog and create/build a grading: project cut/fill
       slopes from a footprint polyline at a design elevation out to a target
       surface, producing a graded surface + cut/fill volumes.  Supports flat /
       vertex-Z / drainage pad elevation, cut & fill slopes (as ratio or %),
       and height-triggered benching with an optional bench cross-slope.  The
       grading is a self-drawing dynamic object that auto-rebuilds when its
       footprint / target / criteria change.
   * - ``BUILDGRADING``
     - ``BG``
     - Rebuild a stale grading (used when Auto rebuild is turned off).
   * - ``GRADINGBALANCE``
     - ``GRDB``
     - Solve the pad's design elevation for a target net cut/fill volume
       (default 0 = balanced earthwork).  Prompts for the target and a
       tolerance; reports the solved elevation, or that the target is not
       achievable for the pad.  Flat/drainage pads only.
   * - ``GRADINGEXTRACT``
     - ``GRDX``
     - Clone a grading's internal graded surface into a standalone editable
       ``AECC_SURFACE`` (``<Grading>_Extracted``) for sectioning, contouring,
       differencing or corridor use.

.. index::
   single: Culverts

Culverts
~~~~~~~~

.. index::
   single: CULVERT (command)
   single: CULVERTEDIT (command)
   single: CULVERTSECTION (command)
   single: CULVERTQUANTITIES (command)
   single: CULVERTREPORT (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 12 66

   * - Command
     - Alias
     - Description
   * - ``CULVERT``
     - ``CULV``
     - Create a parametric box culvert from a picked flow-line polyline (box
       barrel, slabs, subbase/protection, headwalls, wing walls, aprons and an
       optional fall chamber), built with default parameters; reports the part
       count and total volume.
   * - ``CULVERTEDIT``
     - ``CULVEDIT``
     - Open the tabbed Culvert editor for a selected culvert (same as
       double-clicking it): edit box, wing, fall-chamber and material
       parameters with a live schematic and a live quantities table.
   * - ``CULVERTSECTION``
     - ``CULVSEC``
     - Cut the culvert into a dimensioned 2D cross-section (or a longitudinal
       section with the ``LONG`` option), with outlines, material hatches and
       dimensions placed at a picked point.
   * - ``CULVERTQUANTITIES``
     - ``CULVQTY``
     - Report concrete volumes grouped by component and material (grand total)
       and place a quantities table on the drawing.
   * - ``CULVERTREPORT``
     - ``CULVRPT``
     - Write a PDF report of a selected culvert: identity, plan sketch with
       numbered stake-out points, cross and long sections, a volumes table,
       and an X/Y/Z coordinates table.

.. index::
   single: 3D Object Viewer

3D Object Viewer
~~~~~~~~~~~~~~~~

.. index::
   single: OBJVIEW (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 18 60

   * - Command
     - Alias
     - Description
   * - ``OBJVIEW``
     - ``OBJECTVIEWER``
     - Open the read-only 3D Object Viewer on the current selection (surfaces,
       gradings, culverts, 3D polylines): orbit/pan/zoom, display modes,
       show/hide and isolate objects, hover to inspect elevation / slope /
       aspect / area / part name, with live update while you edit in model
       space.

.. index::
   single: Point Groups

Point Groups
~~~~~~~~~~~~

.. index::
   single: ADDTOGROUP (command)
   single: REMOVEFROMGROUP (command)
   single: CREATEGROUP (command)
   single: CONVERTPOINTS (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``ADDTOGROUP``
     - ``ATG``
     - Add selected civil points to a point group.  Select points first,
       then run the command.  Lists existing groups by number; type a
       number to pick one or type a new name to create a group.
   * - ``REMOVEFROMGROUP``
     - ``RFG``
     - Remove selected civil points from a point group.  Select points
       first, then run the command and pick the group.
   * - ``CREATEGROUP``
     - ``CRG``
     - Create a new point group.  Prompts for a name, then lets you click
       individual points to add.  Press Enter to finish.
   * - ``CONVERTPOINTS``
     - ``CPT``
     - Convert selected AutoCAD point markers into AEC civil survey points.
       Optionally assigns a group and deletes the original point entities.

.. index::
   single: Coordinate Transformations

Coordinate Transformations
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. index::
   single: CSTRANSFORM (command)
   single: RUBBERSHEET (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``CSTRANSFORM``
     - ``CST``
     - Global coordinate transformation using common/control points.
       Supports Helmert 2D (4-parameter similarity), Affine 2D (6-parameter),
       and Polynomial degree 1/2/3. Interactive point picking on canvas,
       keyboard coordinate entry (``E,N`` or ``E,N,Z``), survey point lookup
       (``#PointNumber``), and file loading (``.cpt`` JSON / ``.csv``).
       Produces least-squares residuals, RMS statistics, and transformation
       reports (``.trpt``). Common points can be saved for reuse.
   * - ``RUBBERSHEET``
     - ``RBS``
     - Non-uniform rubber-sheet transformation using control points.
       Two modes: **Linear** (Delaunay piecewise affine — C0 continuous)
       and **Smooth** (Thin Plate Spline — C2 continuous). Both achieve
       exact interpolation at control points (zero residual). Points outside
       the convex hull are extrapolated using the nearest triangle (linear)
       or affine far-field (smooth). Reports outside-hull count. Saves
       common points and transformation reports.


.. index::
   single: Point Cloud Commands

Point Cloud Commands
--------------------

.. index::
   single: IMPORTPOINTCLOUD (command)
   single: ATTACHPOINTCLOUD (command)
   single: EXPORTPOINTCLOUD (command)
   single: PCCLIP (command)
   single: PCSECTION (command)
   single: PCSECTIONVIEW (command)
   single: PCSECTIONTRACE (command)
   single: PCSECTIONCOMMIT (command)
   single: PCSECTIONS (command)
   single: PCGROUND (command)
   single: PCSURFACE (command)
   single: PCSECTIONSHEETSTYLES (command)
   single: PCELEVTRACK (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``IMPORTPOINTCLOUD``
     - ``IPC``
     - Import point cloud file (LAS, LAZ, XYZ/CSV/TXT, PTS/PTX, PLY, E57).  Opens a file
       dialog, reads points, builds octree, creates ``.iqpc`` cache.
   * - ``ATTACHPOINTCLOUD``
     - ``APC``
     - Attach an existing ``.iqpc`` cache file without re-importing.
   * - ``EXPORTPOINTCLOUD``
     - ``EPC``
     - Export point cloud to file.  Supported formats: LAS, LAZ, XYZ,
       PTS, PLY, E57.  Runs in background with progress.
   * - ``PCCLIP``
     -
     - Elevation clip for point clouds.  ``PCCLIP <zmin> <zmax>`` enables
       clipping to the specified Z range.  ``PCCLIP OFF`` disables.
       ``PCCLIP`` alone shows current state.
   * - ``PCSECTION``
     - ``PCS``
     - Create a point-cloud section (vertical or horizontal cut) as a
       persistent CAD entity.  Prompts for kind, two pick points, slab
       thickness, Z-range mode, and section name.  See *Civil → Point
       Cloud Sections* for the full workflow.
   * - ``PCSECTIONVIEW``
     - ``PCSV``
     - Open the floating viewer for a selected section entity.  Multiple
       sections can have viewers open simultaneously; each viewer
       auto-refreshes when the underlying section changes.
   * - ``PCSECTIONTRACE``
     - ``PCST``
     - Run line-tracing on a section.  Three modes: ``None`` (clear
       cache), ``Simple`` (PCA + Douglas-Peucker), ``Manhattan``
       (orthogonal-axis snap on top of Simple).  Tolerance defaults to
       2 cm.  Equivalent to clicking **Trace** in the viewer toolbar.
   * - ``PCSECTIONCOMMIT``
     - ``PCSC``
     - Flatten a section's traced polylines into the drawing at a
       picked insertion point with optional rotation and section
       label.  Each commit produces an independent copy; committed
       geometry does not auto-update when the source section changes.
   * - ``PCSECTIONS``
     - ``PCSS``
     - Open the modeless *Point Cloud Sections Along Alignment* viewer.
       Supports **Ground** mode (planimetric slab filter) and **Tunnel**
       mode (angular-bin filter around the alignment center — the retired
       standalone Tunnel Section Viewer is subsumed here).  Shared
       toolbar controls: **Plane** combo (Vertical / Perpendicular) and
       **Absolute Z** toggle.  **Generate sheet…** places the results on
       a grid ``TAECC_PointCloudSectionSheet`` entity via canvas pick;
       tunnel sheets carry a ``SheetKind`` discriminator and store tunnel
       filter parameters for re-sampling.  See *Civil → Point Cloud
       Sections Along Alignment*.
   * - ``PCGROUND``
     - ``PCG``
     - Slope-based ground classifier for a loaded point cloud (marks LAS class 2 ground points).
   * - ``PCSURFACE``
     - ``PCSURF``
     - Build a surface from a point cloud (filter by classification, voxel decimate).
   * - ``PCSECTIONSHEETSTYLES``
     - ``PCSSS``
     - Edit point-cloud section sheet styles.
   * - ``PCELEVTRACK``
     - —
     - Toggle the point cloud **Elevation Tracker** overlay — a live Z
       readout of the nearest point in every visible point cloud under
       the cursor.  Shares the surface tracker's overlay box.  See
       :ref:`elevation-tracker`.

.. index::
   single: Drone Commands

Drone Commands
--------------

.. index::
   single: DRONESURVEY (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``DRONESURVEY``
     - ``DSV``
     - Open the Drone Survey workspace.  Load a GeoTIFF DEM or build one
       from LAS or LAZ, drape an orthophoto, pick points, breaklines and
       boundaries, sample a
       regular or low-pass grid, build a TIN and contours, and send them
       into the drawing.  Named sessions are stored in the IQZ.  Requires
       the Drone module.  See
       :doc:`/parts/drone/01_drone_survey`.

.. index::
   single: Scripting & Automation
   single: Scripting
   single: Automation

Scripting & Automation
----------------------

.. index::
   single: SCRIPT (command)
   single: PYTHON (command)
   single: PYEVAL (command)
   single: PYLOAD (command)
   single: PYSCRIPTS (command)
   single: PYPIP (command)
   single: PASCAL (command)
   single: PASEVAL (command)
   single: PASLOAD (command)
   single: PASSCRIPTS (command)
   single: BLADE (command)
   single: PLUGINS (command)

.. list-table::
   :class: longtable
   :header-rows: 1
   :widths: 22 10 68

   * - Command
     - Alias
     - Description
   * - ``SCRIPT``
     - ``SCR``
     - Run a text script file of commands.  Invoke ``SCRIPT`` with no
       arguments to open a file picker (``*.scr``), or ``SCRIPT <path>``
       to load a specific file directly (relative paths resolved against
       the working directory; quotes around paths with spaces are
       tolerated).  Also reachable from **Tools → Run Script…**.

       **File format** — one input per line, fed to the dispatcher as if
       typed at the prompt.  Lines beginning with ``;`` are comments
       (leading whitespace allowed).  Blank lines act as Enter, which
       repeats the last command — same as AutoCAD's empty-Enter
       behaviour.  No space-as-Enter, no LISP, no DIESEL.

         Typical drawing pattern:

         .. code-block:: text

            LINE
            0,0
            @10,0

            CIRCLE
            20,0
            25,0


       Three sample scripts ship under ``samples\scripts\`` —
       ``hello.scr`` (single-shot view commands, smoke test),
       ``setup_view.scr`` (reset to north-up zoomed extents), and
       ``draw_demo.scr`` (LINE + CIRCLE driven by typed coordinates).
   * - ``PYTHON``
     - ``PY``
     - Run a Python script file (``.py``) in the embedded interpreter.
   * - ``PYEVAL``
     - —
     - Evaluate a Python expression and print the result.
   * - ``PYLOAD``
     - —
     - Load a Python module (session-resident).
   * - ``PYSCRIPTS``
     - —
     - List registered Python commands.
   * - ``PYPIP``
     - —
     - Run pip against the bundled Python (e.g. ``PYPIP install <pkg>``).
   * - ``PASCAL``
     - ``PAS``
     - Run a Pascal Script file (``.pas``).
   * - ``PASEVAL``
     - —
     - Evaluate a Pascal Script expression.
   * - ``PASLOAD``
     - —
     - Load a Pascal Script module (session-resident).
   * - ``PASSCRIPTS``
     - —
     - List registered Pascal Script commands.
   * - ``BLADE``
     - ``BLADERUNNER``
     - Open the Blade Runner script editor.
   * - ``PLUGINS``
     - ``PLUGINMANAGER``
     - Open the Plugin Manager dialog.