DimStyle

class DimStyle

Defines the appearance of Dimension entities. Each of this dimension variables statrin with dim can be overridden for any Dimension entity individually.

../_images/dimvars11.svg
../_images/dimvars21.svg

DXF Attributes for DimStyle

DimStyle.dxf.handle

Handle of table entry.

DimStyle.dxf.owner

Handle to dimstyle table, requires DXF R13 or later

DimStyle.dxf.name

Dimension style name.

DimStyle.dxf.flags

Standard flag values (bit-coded values):

16 If set, table entry is externally dependent on an xref
32 If both this bit and bit 16 are set, the externally dependent xref has been successfully resolved
64 If set, the table entry was referenced by at least one entity in the drawing the last time the drawing was edited. (This flag is for the benefit of AutoCAD commands. It can be ignored by most programs that read DXF files and need not be set by programs that write DXF files)
DimStyle.dxf.dimpost

Prefix/suffix for primary units dimension values.

DimStyle.dxf.dimapost

Prefix/suffix for alternate units dimensions.

DimStyle.dxf.dimblk

Block type to use for both arrowheads as name string.

DimStyle.dxf.dimblk1

Block type to use for first arrowhead as name string.

DimStyle.dxf.dimblk2

Block type to use for second arrowhead as name string.

DimStyle.dxf.dimscale

Global dimension feature scale factor. (default=1.)

DimStyle.dxf.dimasz

Dimension line and arrowhead size. (default=0.28)

DimStyle.dxf.dimexo

Distance from origin points to extension lines. (default imperial=0.0625, default metric=0.625)

DimStyle.dxf.dimdli

Incremental spacing between baseline dimensions. (default imperial=0.38, default metric=3.75)

DimStyle.dxf.dimexe

Extension line distance beyond dimension line. (default imperial=0.28, default metric=2.25)

DimStyle.dxf.dimrnd

Rounding value for decimal dimensions. (default=0)

Rounds all dimensioning distances to the specified value, for instance, if DIMRND is set to 0.25, all distances round to the nearest 0.25 unit. If you set DIMRND to 1.0, all distances round to the nearest integer.

DimStyle.dxf.dimdle

Dimension line extension beyond extension lines. (default=0)

DimStyle.dxf.dimtp

Upper tolerance value for tolerance dimensions. (default=0)

DimStyle.dxf.dimtm

Lower tolerance value for tolerance dimensions. (default=0)

DimStyle.dxf.dimtxt

Size of dimension text. (default imperial=0.28, default metric=2.5)

DimStyle.dxf.dimcen

Controls placement of center marks or centerlines. (default imperial=0.09, default metric=2.5)

DimStyle.dxf.dimtsz

Controls size of dimension line tick marks drawn instead of arrowheads. (default=0)

DimStyle.dxf.dimaltf

Alternate units dimension scale factor. (default=25.4)

DimStyle.dxf.dimlfac

Scale factor for linear dimension values. (default=1)

DimStyle.dxf.dimtvp

Vertical position of text above or below dimension line. (default=0)

DimStyle.dxf.dimtfac

Scale factor for fractional or tolerance text size. (default=1)

DimStyle.dxf.dimgap

Gap size between dimension line and dimension text. (default imperial=0.09, default metric=0.625)

DimStyle.dxf.dimaltrnd

Rounding value for alternate dimension units. (default=0)

DimStyle.dxf.dimtol

Toggles creation of appended tolerance dimensions. (default imperial=1, default metric=0)

DimStyle.dxf.dimlim

Toggles creation of limits-style dimension text. (default=0)

DimStyle.dxf.dimtih

Orientation of text inside extension lines. (default imperial=1, default metric=0)

DimStyle.dxf.dimtoh

Orientation of text outside extension lines. (default imperial=1, default metric=0)

DimStyle.dxf.dimse1

Toggles suppression of first extension line. (default=0)

DimStyle.dxf.dimse2

Toggles suppression of second extension line. (default=0)

DimStyle.dxf.dimtad

Sets text placement relative to dimension line. (default imperial=0, default metric=1)

DimStyle.dxf.dimzin

Zero suppression for primary units dimensions. (default imperial=0, default metric=8) ???

DimStyle.dxf.dimazin

Controls zero suppression for angular dimensions. (default=0)

DimStyle.dxf.dimalt

Enables or disables alternate units dimensioning. (default=0)

DimStyle.dxf.dimaltd

Controls decimal places for alternate units dimensions. (default imperial=2, default metric=3)

DimStyle.dxf.dimtofl

Toggles forced dimension line creation. (default imperial=0, default metric=1)

DimStyle.dxf.dimsah

Toggles appearance of arrowhead blocks. (default=0)

DimStyle.dxf.dimtix

Toggles forced placement of text between extension lines. (default=0)

DimStyle.dxf.dimsoxd

Suppresses dimension lines outside extension lines. (default=0)

DimStyle.dxf.dimclrd

Dimension line, arrowhead, and leader line color. (default=0)

DimStyle.dxf.dimclre

Dimension extension line color. (default=0)

DimStyle.dxf.dimclrt

Dimension text color. (default=0)

DimStyle.dxf.dimadec

Controls the number of decimal places for angular dimensions.

DimStyle.dxf.dimunit

Obsolete, now use DIMLUNIT AND DIMFRAC

DimStyle.dxf.dimdec

Decimal places for dimension values. (default imperial=4, default metric=2)

DimStyle.dxf.dimtdec

Decimal places for primary units tolerance values. (default imperial=4, default metric=2)

DimStyle.dxf.dimaltu

Units format for alternate units dimensions. (default=2)

DimStyle.dxf.dimalttd

Decimal places for alternate units tolerance values. (default imperial=4, default metric=2)

DimStyle.dxf.dimaunit

Unit format for angular dimension values. (default=0)

DimStyle.dxf.dimfrac

Controls the fraction format used for architectural and fractional dimensions. (default=0)

DimStyle.dxf.dimlunit

Specifies units for all nonangular dimensions. (default=2)

DimStyle.dxf.dimdsep

Specifies a single character to use as a decimal separator. (default imperial=”.”, default metric=”,”) This is an integer value, use ord('.') to write value.

DimStyle.dxf.dimtmove

Controls the format of dimension text when it is moved. (default=0)

DimStyle.dxf.dimjust

Horizontal justification of dimension text. (default=0)

DimStyle.dxf.dimsd1

Toggles suppression of first dimension line. (default=0)

DimStyle.dxf.dimsd2

Toggles suppression of second dimension line. (default=0)

DimStyle.dxf.dimtolj

Vertical justification for dimension tolerance text. (default=1)

DimStyle.dxf.dimaltz

Zero suppression for alternate units dimension values. (default=0)

DimStyle.dxf.dimalttz

Zero suppression for alternate units tolerance values. (default=0)

DimStyle.dxf.dimfit

Obsolete, now use DIMATFIT and DIMTMOVE

DimStyle.dxf.dimupt

Controls user placement of dimension line and text. (default=0)

DimStyle.dxf.dimatfit

Controls placement of text and arrowheads when there is insufficient space between the extension lines. (default=3)

DimStyle.dxf.dimtxsty

Text style used for dimension text by name.

DimStyle.dxf.dimtxsty_handle

Text style used for dimension text by handle of STYLE entry. (use DimStyle.dxf.dimtxsty to get/set text style by name)

DimStyle.dxf.dimldrblk

Specify arrowhead used for leaders by name.

DimStyle.dxf.dimldrblk_handle

Specify arrowhead used for leaders by handle of referenced block. (use DimStyle.dxf.dimldrblk to get/set arrowhead by name)

DimStyle.dxf.dimblk_handle

Block type to use for both arrowheads, handle of referenced block. (use DimStyle.dxf.dimblk to get/set arrowheads by name)

DimStyle.dxf.dimblk1_handle

Block type to use for first arrowhead, handle of referenced block. (use DimStyle.dxf.dimblk1 to get/set arrowhead by name)

DimStyle.dxf.dimblk2_handle

Block type to use for second arrowhead, handle of referenced block. (use DimStyle.dxf.dimblk2 to get/set arrowhead by name)

DimStyle.dxf.dimlwd

Lineweight value for dimension lines. (default=-2, BYBLOCK)

DimStyle.dxf.dimlwe

Lineweight value for extension lines. (default=-2, BYBLOCK)

DimStyle.dxf.dimltype

Specifies the linetype used for the dimension line as linetype name, requires DXF R2007+

DimStyle.dxf.dimltype_handle

Specifies the linetype used for the dimension line as handle to LTYPE entry, requires DXF R2007+ (use DimStyle.dxf.dimltype to get/set linetype by name)

DimStyle.dxf.dimltex1

Specifies the linetype used for the extension line 1 as linetype name, requires DXF R2007+

DimStyle.dxf.dimlex1_handle

Specifies the linetype used for the extension line 1 as handle to LTYPE entry, requires DXF R2007+ (use DimStyle.dxf.dimltex1 to get/set linetype by name)

DimStyle.dxf.dimltex2

Specifies the linetype used for the extension line 2 as linetype name, requires DXF R2007+

DimStyle.dxf.dimlex2_handle

Specifies the linetype used for the extension line 2 as handle to LTYPE entry, requires DXF R2007+ (use DimStyle.dxf.dimltex2 to get/set linetype by name)

DimStyle.dxf.dimfxlon

Extension line has fixed length if set to 1, requires DXF R2007+

DimStyle.dxf.dimfxl

Length of extension line below dimension line if fixed (DimStyle.dxf.dimtfxlon == 1), DimStyle.dxf.dimexen defines the the length above the dimension line, requires DXF R2007+

DimStyle.dxf.dimtfill

Text fill 0=off; 1=background color; 2=custom color (see DimStyle.dxf.dimtfillclr), requires DXF R2007+

DimStyle.dxf.dimtfillclr

Text fill custom color as color index (1-255), requires DXF R2007+

DimStyle Methods

DimStyle.copy_to_header(dwg):

Copy all dimension style variables to HEADER section of dwg.

DimStyle.set_arrows(blk='', blk1='', blk2=''):

Set arrows by block names or AutoCAD standard arrow names, set DIMTSZ to 0, which disables tick.

Parameters:
  • blk (str) – block/arrow name for both arrows, if DIMSAH == 0
  • blk1 (str) – block/arrow name for first arrow, if DIMSAH == 1
  • blk2 (str) – block/arrow name for second arrow, if DIMSAH == 1
DimStyle.set_tick(size=1):

Set tick size, which also disables arrows, a tick is just an oblique stroke as marker.

DimStyle.set_text_align(halign=None, valign=None):

Set measurement text alignment, halign defines the horizontal alignment (requires DXFR2000+), valign defines the vertical alignment, above1 and above2 means above extension line 1 or 2 and aligned with extension line.

Parameters:
  • halign (str) – above, center, below, above1, above2 (set DIMJUST), requires DXF R2000+
  • valign (str) – left, right or center (set DIMTAD)
DimStyle.set_text_format(prefix='', postfix='', rnd=None, dec=None, sep=None,
leading_zeros=True, trailing_zeros=True):

Set dimension text format, like prefix and postfix string, rounding rule and number of decimal places.

Parameters:
  • prefix (str) – Dimension text prefix text as string
  • postfix (str) – Dimension text postfix text as string
  • rnd (float) – Rounding value for decimal dimensions, see DimStyle.dxf.dimrnd
  • dec (int) – Sets the number of decimal places displayed for the primary units of a dimension. requires DXF R2000+
  • sep (str) – “.” or “,” as decimal separator requires DXF R2000+
  • leading_zeros (bool) – Suppress leading zeros for decimal dimensions if False
  • trailing_zeros (bool) – Suppress trailing zeros for decimal dimensions if False
DimStyle.set_dimline_format(color=None, linetype=None, lineweight=None,
extension=None, disable1=None, disable2=None)

Set dimension line properties

Parameters:
  • color (int) – color index
  • linetype (str) – linetype as string, requires DXF R2007+
  • lineweight (int) – line weight as int, 13 = 0.13mm, 200 = 2.00mm, requires DXF R2000+
  • extension (float) – extension length
  • disable1 (bool) – True to suppress first part of dimension line, requires DXF R2000+
  • disable2 (bool) – True to suppress second part of dimension line, requires DXF R2000+
DimStyle.set_extline_format(color=None, lineweight=None, extension=None,
offset=None, fixed_length=None):

Set common extension line attributes.

Parameters:
  • color (int) – color index
  • lineweight (str) – line weight as int, 13 = 0.13mm, 200 = 2.00mm
  • extension (float) – extension length above dimension line
  • offset (float) – offset from measurement point
  • fixed_length (float) – set fixed length extension line, length below the dimension line
DimStyle.set_extline1(linetype=None, disable=False)

Set extension line 1 attributes.

Parameters:
  • linetype (str) – linetype for extension line 1, requires DXF R2007+
  • disable (bool) – disable extension line 1 if True
DimStyle.set_extline2(linetype=None, disable=False)

Set extension line 2 attributes.

Parameters:
  • linetype (str) – linetype for extension line 2, requires DXF R2007+
  • disable (bool) – disable extension line 2 if True