Interface AcDbFormatterOptions

Per-call options for AcDbFormatter methods.

These options layer on top of the drawing system variables held by the bound AcDbDatabase; they do not change the database itself.

interface AcDbFormatterOptions {
    applyAngbaseAngdir?: boolean;
    showApproximate?: boolean;
    showUnits?: boolean;
}

Properties

applyAngbaseAngdir? showApproximate? showUnits?

Properties

OptionalapplyAngbaseAngdir

applyAngbaseAngdir?: boolean

Whether to apply ANGBASE and ANGDIR before formatting an angle.

When true (default), the input is treated as an absolute WCS angle (counterclockwise from +X before adjustment), matching status-bar bearing-style display.

When false, the input radians are formatted directly (after normalization to ([0, 2\pi))), for included angles, relative rotations, rubber-band sweep angles, and dynamic-input relative angle values.

OptionalshowApproximate

showApproximate?: boolean

Whether to prefix the formatted value with ~ when display precision rounds the input.

When true, values that are not exactly representable at the current LUPREC / AUPREC (or fractional denominator for architectural modes) are returned as ~ ${formatted} — for example ~ 12.35 instead of 12.35 for 12.3456 with two decimal places.

When false (default), no approximate prefix is added.

OptionalshowUnits

showUnits?: boolean

Whether to append real-world unit suffixes to formatted values.

When true:

  • Decimal/scientific/fractional linear values may receive a suffix derived from INSUNITS (or MEASUREMENT when INSUNITS is unitless), for example 12.35 mm or 10".
  • Angles may receive °, g, rad, or inch marks in DMS/surveyor formats.
  • Engineering and architectural lengths already embed ' / " in the LUNITS pattern; this flag mainly adds the inch quote for those modes when appropriate.

When false (default), only the numeric pattern dictated by LUNITS / AUNITS is returned (for example 12.35, 1'-3 1/2, 45d30'15").

Settings

Member Visibility

On This Page

Properties