Text document

TextDocument ¶

Stores a value for a TextLayer's Source Text property.

Example

from py_aep import parse

app = parse("project.aep")
comp = app.project.compositions[0]
text_doc = comp.text_layers[0].text.source_text.value
print(text_doc.text)

See: https://ae-scripting.docsforadobe.dev/text/textdocument/

Attributes¶

all_caps ¶

all_caps: bool | None

True if a Text layer has All Caps enabled. Read-only.

apply_fill ¶

apply_fill: bool | None = bool('_char_style', '56')

When True, the Text layer shows a fill. Read / Write.

apply_stroke ¶

apply_stroke: bool | None = bool('_char_style', '57')

When True, the Text layer shows a stroke. Read / Write.

auto_hyphenate ¶

auto_hyphenate: bool | None = bool('_para_style', '9')

The Text layer's auto hyphenate option. Read / Write.

auto_kern_type ¶

auto_kern_type: AutoKernType | None = NO_AUTO_KERN

The Text layer's auto kern type option. Read / Write.

auto_leading ¶

auto_leading: bool | None = bool('_para_style', '6')

The Text layer's auto leading option. Read / Write.

baseline_direction ¶

baseline_direction: BaselineDirection | None = (
    BASELINE_WITH_STREAM
)

The Text layer's baseline direction. Read / Write.

baseline_shift ¶

baseline_shift: float | None = float('_char_style', '9')

This Text layer's baseline shift in pixels. Read / Write.

box_text ¶

box_text: bool | None

True if this is a box (paragraph) text layer. Read-only.

composed_line_count ¶

composed_line_count: int | None

The number of composed lines in the Text layer. Read-only.

composer_engine ¶

composer_engine: ComposerEngine | None

The Text layer's composer engine type. Read-only.

digit_set ¶

digit_set: DigitSet | None = DEFAULT_DIGITS

The Text layer's digit set option. Read / Write.

direction ¶

direction: ParagraphDirection | None = (
    DIRECTION_LEFT_TO_RIGHT
)

The Text layer's paragraph direction. Read / Write.

end_indent ¶

end_indent: float | None = float('_para_style', '3')

The Text layer's paragraph end indent. Read / Write.

every_line_composer ¶

every_line_composer: bool | None

The Text layer's Every-Line Composer option. Read / Write.

True when Every-Line Composer is used, False for Single-Line.

faux_bold ¶

faux_bold: bool | None = bool('_char_style', '2')

True if a Text layer has faux bold enabled. Read / Write.

faux_italic ¶

faux_italic: bool | None = bool('_char_style', '3')

True if a Text layer has faux italic enabled. Read / Write.

fill_color ¶

fill_color: list[float] | None

The Text layer's fill color as [r, g, b]. Read / Write.

first_line_indent ¶

first_line_indent: float | None = float('_para_style', '1')

The Text layer's paragraph first line indent. Read / Write.

font ¶

font: str | None

The Text layer's font PostScript name. Read / Write.

font_baseline_option ¶

font_baseline_option: FontBaselineOption | None = enum(
    FontBaselineOption,
    "_char_style",
    "13",
    map=_FONT_BASELINE_MAP,
    reverse_map=_REVERSE_FONT_BASELINE_MAP,
)

The Text layer's font baseline option. Read / Write.

font_caps_option ¶

font_caps_option: FontCapsOption | None = enum(
    FontCapsOption,
    "_char_style",
    "12",
    map=_FONT_CAPS_MAP,
    reverse_map=_REVERSE_FONT_CAPS_MAP,
)

The Text layer's font caps option. Read / Write.

font_object ¶

font_object: FontObject | None

The Text layer's FontObject. Read / Write.

font_size ¶

font_size: float | None = float('_char_style', '1')

The Text layer's font size in pixels. Read / Write.

hanging_roman ¶

hanging_roman: bool | None = bool('_para_style', '21')

The Text layer's Roman Hanging Punctuation. Read / Write.

horizontal_scale ¶

horizontal_scale: float | None = float('_char_style', '6')

This Text layer's horizontal scale in pixels. Read / Write.

justification ¶

justification: ParagraphJustification | None = enum(
    ParagraphJustification,
    "_para_style",
    "0",
    map=_JUSTIFICATION_MAP,
    reverse_map=_REVERSE_JUSTIFICATION_MAP,
)

The paragraph justification for the Text layer. Read / Write.

kerning ¶

kerning: int | None = 0

The Text layer's kerning value. Read / Write.

leading ¶

leading: float | None

The Text layer's spacing between lines. Read / Write.

When auto-leading is enabled, returns font_size * auto_leading_factor.

leading_type ¶

leading_type: LeadingType | None = enum(
    LeadingType,
    "_para_style",
    "8",
    map=_LEADING_TYPE_MAP,
    reverse_map=_REVERSE_LEADING_TYPE_MAP,
)

The Text layer's paragraph leading type. Read / Write.

ligature ¶

ligature: bool | None = False

When True, ligature is used. Read / Write.

line_join_type ¶

line_join_type: LineJoinType | None = LINE_JOIN_MITER

The Text layer's line join type for strokes. Read / Write.

line_orientation ¶

line_orientation: LineOrientation | None = HORIZONTAL

The Text layer's line orientation. Read / Write.

no_break ¶

no_break: bool | None = False

When True, the no-break attribute is applied. Read / Write.

paragraph_count ¶

paragraph_count: int | None

The number of paragraphs in the text layer. Read-only.

point_text ¶

point_text: bool | None

True if this is a point text layer. Read-only.

small_caps ¶

small_caps: bool | None

True if a Text layer has Small Caps enabled. Read-only.

space_after ¶

space_after: float | None = float('_para_style', '5')

The Text layer's paragraph space after. Read / Write.

space_before ¶

space_before: float | None = float('_para_style', '4')

The Text layer's paragraph space before. Read / Write.

start_indent ¶

start_indent: float | None = float('_para_style', '2')

The Text layer's paragraph start indent. Read / Write.

stroke_color ¶

stroke_color: list[float] | None

The Text layer's stroke color as [r, g, b]. Read / Write.

stroke_over_fill ¶

stroke_over_fill: bool | None = bool('_char_style', '58')

When True, the stroke appears over the fill. Read / Write.

stroke_width ¶

stroke_width: float | None = float('_char_style', '63')

The Text layer's stroke thickness in pixels. Read / Write.

subscript ¶

subscript: bool | None

True if a Text layer has subscript enabled. Read-only.

superscript ¶

superscript: bool | None

True if a Text layer has superscript enabled. Read-only.

text ¶

text: str

The text value for the Source Text property. Read / Write.

tracking ¶

tracking: float | None = float('_char_style', '8')

The Text layer's spacing between characters. Read / Write.

tsume ¶

tsume: float | None = float('_char_style', '17')

This Text layer's tsume value (0.0 to 1.0). Read / Write.

vertical_scale ¶

vertical_scale: float | None = float('_char_style', '7')

This Text layer's vertical scale in pixels. Read / Write.