Text Entities

autocad_entity: autocad_text

Features with autocad_entity set to autocad_text are stored in and read from drawing files as text entities.

A text entity is represented by a single coordinate and the attributes listed below.

Attribute Name

Contents

autocad_active_anno_scale

This indicates the name of the annotation scale that is actively selected (that is, the scale that is shown when viewing the file directly in AutoCAD). When writing multiple annotation scales on an entity, it helps disambiguate the annotation scale associated with the height.

Default: None

autocad_anno_force_visible

This indicates the value of an option to override the ANNOALLVISIBLE system variable for an annotative object, forcing it to display in Autodesk applications, regardless of the current scale.

Used in combination with annotation scales.

Default: None

autocad_anno_scale{}.drawing_units

The drawing units part of an annotation scale definition in a drawing, defined as a scale from paper units to drawing units.

Default: 1

autocad_anno_scale{}.name

The name of an annotation scale, used to represent a reference by an annotation object, to an annotation scale definition in a drawing.

Default: none

autocad_anno_scale{}.paper_units

The paper units part of an annotation scale definition in a drawing, defined as a scale from paper units to drawing units.

Default: 1

autocad_alignment_x

autocad_alignment_y

autocad_alignment_z

The alignment coordinate of the text. This location is used in conjunction with the justification and the feature location to place the text correctly. This is primarily of use when performing an AutoCAD-to-AutoCAD translation.

To override the justification of source AutoCAD dataset, you need to remove these alignment attributes from the feature and then set the autocad_justfication attribute. This is because when performing an AutoCAD-to-AutoCAD translation, these alignment attributes override the autocad_justification attribute.

Note that if autocad_justification is set to autocad_baseline_left for this text, then the alignment point attributes will match the text entity location.

Range: Any 64-bit floating point value

Default: x, y, and z value of text alignment point

autocad_backwards

(used only by the reader)

Indicates whether the text is backwards.

This attribute will only exist if reading a graphical text entity.

Default: not applicable since this is a Reader-only attribute.

autocad_big_fontname

The name of the file which contains fonts for large character sets.

Range: char[65]

Default: No default

autocad_font_bold

Indicates whether the TrueType font related to the text style has bold formatting.

Range: Yes | No

Default: No

autocad_font_charset

The Windows TrueType font character set identifier for the related text style.

  • UndefinedCharset = -1
  • AnsiCharset = 0
  • UnicodeCharset = 1
  • SymbolCharset = 2
  • JapaneseCharset = 128
  • KoreanCharset = 129
  • ChineseSimpCharset = 134
  • ChineseTradCharset = 136
  • JohabCharset = 130
  • HebrewCharset = 177
  • ArabicCharset = 178
  • GreekCharset = 161
  • TurkishCharset = 162
  • VietnameseCharset = 163
  • ThaiCharset = 222
  • EastEuropeCharset = 238
  • RussianCharset = 204
  • BalticCharset = 186
  • INTERNALCHARSET = 256

Range: Integer, as above

Default: 0

autocad_font_family

The Windows font family identifier for the related text style.

RealDWG only.

Range:

  • roman
  • swiss
  • modern
  • script
  • decorative
  • do_not_care

Range: do_not_care

autocad_font_italic

Indicates whether the TrueType font related to the text style has italic formatting.

Range: Yes | No

Default: No

autocad_font_pitch

The Windows font pitch identifier for the related text style.

RealDWG only.

Range: default | fixed | variable

Default: default

autocad_font_pitch_family

The Windows font pitch and family identifier for the related text style.

Not for RealDWG.

Range: Integer

Default: 0

autocad_font_typeface

The Windows TrueType font character set identifier for the related text style.

Range: char[50]

Default: No default

autocad_generation

The generation of the text entry.

Range:

  • autocad_normal
  • autocad_upside_down
  • autocad_backwards
  • autocad_upsidedown_backwards

Default: autocad_normal

autocad_justification

The justification of the text relative to its insert point.

Range:

  • autocad_top_left
  • autocad_top_center
  • autocad_top_right
  • autocad_top_middle
  • autocad_top_aligned
  • autocad_top_fit
  • autocad_middle_left
  • autocad_middle_center
  • autocad_middle_right
  • autocad_middle_middle
  • autocad_middle_aligned
  • autocad_middle_fit
  • autocad_bottom_left
  • autocad_bottom_center
  • autocad_bottom_right
  • autocad_bottom_middle
  • autocad_bottom_aligned
  • autocad_bottom_fit
  • autocad_baseline_left
  • autocad_baseline_center
  • autocad_baseline_right
  • autocad_baseline_middle
  • autocad_baseline_aligned
  • autocad_baseline_fit

Default: autocad_baseline_left

autocad_oblique

The oblique angle of the text, which causes the entity to lean to the right or left of vertical, where positive numbers indicate to the right.

For convenience, the AutoCAD reader and writer will treat the range of values from 275.0..360.0, as an alternative specification of the range from -85.0..0.

Range: -85.0 ..85.0

Default: 0

autocad_original_rotation

The rotation of the text of an entity before a potential transformation, such as a User Coordinate System, is applied by the AutoCAD reader. This value is used preferentially to set the text rotation when writing a text entity.

Range: -360.0..360.0

Default: 0

autocad_original_text_size

The text height of an entity before a potential transformation, such as a User Coordinate System, is applied by the AutoCAD reader.

This value is used preferentially to set the text size when writing a text entity.

Range: 64-bit floating point number > 0

Default: 10

autocad_original_text_string

The contents of a text entity including the character codes used to define its style and formatting.

When reading, this is converted into autocad_text_string.

To set the contents of a text entity when writing, the value of this attribute is used in preference to autocad_text_string.

Range: char[1024]

Default: No default

autocad_overlined

(used only by the reader)

Indicates if the text is overlined.

This attribute will exist only if reading a graphical text entity.

Default: not applicable, since this is a Reader-only attribute.

autocad_rotation

The rotation of the text for an entity.

Range: -360.0..360.0

Default: 0

autocad_shape_filename

The name of the file which contains the text font definition.

AutoCAD shape files should not be confused with Esri shapefiles. AutoCAD shape files hold font and symbol definitions; Esri shapefiles hold spatial features.

Range: char[65];

Default: txt

autocad_shape_height

The height of the text as defined in shape file.

Range: 64-bit floating point number

Default: 0

autocad_shape_name

The name of the shape which contains the text font definition.

Range: char[33]

Default: STANDARD

autocad_shape_rotation

The angle for the text as defined in shape file.

Range: 64-bit floating point number

Default: 0

autocad_shape_vertical

Indicates if the shape text, as defined in the shape file, is vertical or horizontal.

Range: yes | no

Default: None

autocad_shape_width

The width of the text as defined in shape file.

Range: 64-bit floating point number

Default: 1

autocad_text_original_coordinate_system

This attribute stores the coordinate system of the text if it is known.

When the writer receives this attribute, and if the feature has a different coordinate system set, the feature’s autocad_alignment_[xyz], autocad_<tag>[xyz], fme_attrib_info{<n>}.align_[xyz], and fme_attrib_info{<n>}.location_[xyz] attributes will be reprojected and processed as usual, using the reprojected values.

autocad_text_size

The text height.

Range: 64-bit floating point number > 0

Default: 10

autocad_text_string

The text string.

Range: char[1024]

Default: No default

autocad_tracking_
percent

(used only by the reader)

The tracking percent.

This attribute will only exist if reading a graphical text entity.

Default: not applicable, since this is a Reader-only attribute.

autocad_true_type_font

The name of the TrueType font used to display the text string.

For text entities, this attribute is only used by the AutoCAD writer, since single-line text entities do not have support for TrueType fonts.

If this attribute is specified on an autocad_text feature, a multiline text entity will be created and written instead of a single-line text entity.

Default: No default

autocad_underlined

(used only by the reader)

Indicates if the text is underlined.

This attribute will only exist if reading a graphical text entity.

Default: not applicable, since this is a Reader-only attribute.

autocad_upside_down

(used only by the reader)

Indicates if the text is upside down.

This attribute will only exist if reading a graphical text entity.

Default: not applicable, since this is a Reader-only attribute.

autocad_vertical

(used only by the reader)

Indicates if the text is vertical.

This attribute will only exist if reading a graphical text entity.

Default: not applicable, since this is a Reader-only attribute.

autocad_width_factor

The scaling applied in the x direction which makes the text wider or narrower. However, this does not affect the weight (i.e., boldness) of the text string.

Range: 64-bit floating point number > 0 and <= 10000

Default: 1