TextCurve(Curve)#

base classes — bpy_struct, ID, Curve

class bpy.types.TextCurve(Curve)#

Curve data-block used for storing text

active_textbox#
Type:

int in [-inf, inf], default 0

align_x#

Text horizontal alignment from the object center

  • LEFT Left – Align text to the left.

  • CENTER Center – Center text.

  • RIGHT Right – Align text to the right.

  • JUSTIFY Justify – Align to the left and the right.

  • FLUSH Flush – Align to the left and the right, with equal character spacing.

Type:

enum in [‘LEFT’, ‘CENTER’, ‘RIGHT’, ‘JUSTIFY’, ‘FLUSH’], default ‘LEFT’

align_y#

Text vertical alignment from the object center

  • TOP Top – Align text to the top.

  • TOP_BASELINE Top Baseline – Align text to the top line’s baseline.

  • CENTER Middle – Align text to the middle.

  • BOTTOM_BASELINE Bottom Baseline – Align text to the bottom line’s baseline.

  • BOTTOM Bottom – Align text to the bottom.

Type:

enum in [‘TOP’, ‘TOP_BASELINE’, ‘CENTER’, ‘BOTTOM_BASELINE’, ‘BOTTOM’], default ‘TOP_BASELINE’

body#

Content of this text object

Type:

string, default “”, (never None)

body_format#

Stores the style of each character

Type:

bpy_prop_collection of TextCharacterFormat, (readonly)

edit_format#

Editing settings character formatting

Type:

TextCharacterFormat, (readonly)

family#

Use objects as font characters (give font objects a common name followed by the character they represent, eg. ‘family-a’, ‘family-b’, etc, set this setting to ‘family-’, and turn on Vertex Instancing)

Type:

string, default “”, (never None)

follow_curve#

Curve deforming text object

Type:

Object

font#
Type:

VectorFont

font_bold#
Type:

VectorFont

font_bold_italic#
Type:

VectorFont

font_italic#
Type:

VectorFont

has_selection#

Whether there is any text selected

Type:

boolean, default False, (readonly)

is_select_bold#

Whether the selected text is bold

Type:

boolean, default False, (readonly)

is_select_italic#

Whether the selected text is italics

Type:

boolean, default False, (readonly)

is_select_smallcaps#

Whether the selected text is small caps

Type:

boolean, default False, (readonly)

is_select_underline#

Whether the selected text is underlined

Type:

boolean, default False, (readonly)

offset_x#

Horizontal offset from the object origin

Type:

float in [-inf, inf], default 0.0

offset_y#

Vertical offset from the object origin

Type:

float in [-inf, inf], default 0.0

overflow#

Handle the text behavior when it doesn’t fit in the text boxes

  • NONE Overflow – Let the text overflow outside the text boxes.

  • SCALE Scale to Fit – Scale down the text to fit inside the text boxes.

  • TRUNCATE Truncate – Truncate the text that would go outside the text boxes.

Type:

enum in [‘NONE’, ‘SCALE’, ‘TRUNCATE’], default ‘NONE’

shear#

Italic angle of the characters

Type:

float in [-1, 1], default 0.0

size#
Type:

float in [0.0001, 10000], default 1.0

small_caps_scale#

Scale of small capitals

Type:

float in [-inf, inf], default 0.75

space_character#
Type:

float in [0, 10], default 1.0

space_line#
Type:

float in [0, 10], default 1.0

space_word#
Type:

float in [0, 10], default 1.0

text_boxes#
Type:

bpy_prop_collection of TextBox, (readonly)

underline_height#
Type:

float in [0, 0.8], default 0.05

underline_position#

Vertical position of underline

Type:

float in [-0.2, 0.8], default 0.0

use_fast_edit#

Don’t fill polygons while editing

Type:

boolean, default False

classmethod bl_rna_get_subclass(id, default=None)#
Parameters:

id (string) – The RNA type identifier.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)#
Parameters:

id (string) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties#

Inherited Functions#