Paragraph¶

Qualified name: manim.mobject.text.text\_mobject.Paragraph

class Paragraph(*text, line_spacing=-1, alignment=None, **kwargs)[source]¶

Bases: VGroup

Display a paragraph of text.

For a given Paragraph par, the attribute par.chars is a VGroup containing all the lines. In this context, every line is constructed as a VGroup of characters contained in the line.

Parameters:

line_spacing (float) – Represents the spacing between lines. Defaults to -1, which means auto.
alignment (str | None) – Defines the alignment of paragraph. Defaults to None. Possible values are “left”, “right” or “center”.
text (str)
kwargs (Any)

Examples

Normal usage:

paragraph = Paragraph(
    "this is a awesome",
    "paragraph",
    "With \nNewlines",
    "\tWith Tabs",
    "  With Spaces",
    "With Alignments",
    "center",
    "left",
    "right",
)

Remove unwanted invisible characters:

self.play(Transform(remove_invisible_chars(paragraph.chars[0:2]),
                    remove_invisible_chars(paragraph.chars[3][0:3]))

Methods

Attributes

`always`	Call a method on a mobject every frame.
`animate`	Used to animate the application of any method of `self`.
`animation_overrides`
`color`
`depth`	The depth of the mobject.
`fill_color`	If there are multiple colors (for gradient) this returns the first one
`height`	The height of the mobject.
`n_points_per_curve`
`sheen_factor`
`stroke_color`
`width`	The width of the mobject.

_change_alignment_for_a_line(alignment, line_no)[source]¶

Function to change one line’s alignment to a specific value.

Parameters:

alignment (str) – Defines the alignment of paragraph. Possible values are “left”, “right”, “center”.
line_no (int) – Defines the line number for which we want to set given alignment.

Return type:

None

_gen_chars(lines_str_list)[source]¶

Function to convert a list of plain strings to a VGroup of VGroups of chars.

Parameters:: lines_str_list (list) – List of plain text strings.
Returns:: The generated 2d-VGroup of chars.
Return type:: VGroup

_original__init__(*text, line_spacing=-1, alignment=None, **kwargs)¶

Initialize self. See help(type(self)) for accurate signature.

Parameters:

text (str)
line_spacing (float)
alignment (str | None)
kwargs (Any)

_set_all_lines_alignments(alignment)[source]¶

Function to set all line’s alignment to a specific value.

Parameters:: alignment (str) – Defines the alignment of paragraph. Possible values are “left”, “right”, “center”.
Return type:: Paragraph

_set_all_lines_to_initial_positions()[source]¶

Set all lines to their initial positions.

Return type:: Paragraph

_set_line_alignment(alignment, line_no)[source]¶

Function to set one line’s alignment to a specific value.

Parameters:

alignment (str) – Defines the alignment of paragraph. Possible values are “left”, “right”, “center”.
line_no (int) – Defines the line number for which we want to set given alignment.

Return type:

Paragraph

_set_line_to_initial_position(line_no)[source]¶

Function to set one line to initial positions.

Parameters:: line_no (int) – Defines the line number for which we want to set given alignment.
Return type:: Paragraph