manim.utils.tex.TexTemplate

class TexTemplate(tex_compiler=None, output_format=None, documentclass=None, preamble=None, placeholder_text=None, post_doc_commands=None, **kwargs)[source]

Bases: object

TeX templates are used for creating Tex() and MathTex() objects.

Parameters
  • tex_compiler (Optional[str], optional) – The TeX compiler to be used, e.g. latex, pdflatex or lualatex

  • output_format (Optional[str], optional) – The output format resulting from compilation, e.g. .dvi or .pdf

  • documentclass (Optional[str], optional) – The command defining the documentclass, e.g. \documentclass[preview]{standalone}

  • preamble (Optional[str], optional) – The document’s preamble, i.e. the part between \documentclass and \begin{document}

  • placeholder_text (Optional[str], optional) – Text in the document that will be replaced by the expression to be rendered

  • post_doc_commands (Optional[str], optional) – Text (definitions, commands) to be inserted at right after \begin{document}, e.g. \boldmath

tex_compiler

The TeX compiler to be used, e.g. latex, pdflatex or lualatex

Type

str

output_format

The output format resulting from compilation, e.g. .dvi or .pdf

Type

str

documentclass

The command defining the documentclass, e.g. \documentclass[preview]{standalone}

Type

str

preamble

The document’s preample, i.e. the part between \documentclass and \begin{document}

Type

str

placeholder_text

Text in the document that will be replaced by the expression to be rendered

Type

str

post_doc_commands

Text (definitions, commands) to be inserted at right after \begin{document}, e.g. \boldmath

Type

str

Methods

add_to_document

Adds txt to the TeX template just after begin{document}, e.g.

add_to_preamble

Adds stuff to the TeX template’s preamble (e.g.

copy

get_texcode_for_expression

Inserts expression verbatim into TeX template.

get_texcode_for_expression_in_env

Inserts expression into TeX template wrapped in begin{environemnt} and end{environment}

Attributes

default_documentclass

default_output_format

default_placeholder_text

default_post_doc_commands

default_preamble

default_tex_compiler

add_to_document(txt)[source]

Adds txt to the TeX template just after begin{document}, e.g. \boldmath

Parameters

txt (str) – String containing the text to be added.

add_to_preamble(txt, prepend=False)[source]

Adds stuff to the TeX template’s preamble (e.g. definitions, packages). Text can be inserted at the beginning or at the end of the preamble.

Parameters
  • txt (string) – String containing the text to be added, e.g. \usepackage{hyperref}

  • prepend (Optional[bool], optional) – Whether the text should be added at the beginning of the preample, i.e. right after \documentclass. Default is to add it at the end of the preample, i.e. right before \begin{document}

get_texcode_for_expression(expression)[source]

Inserts expression verbatim into TeX template.

Parameters

expression (str) – The string containing the expression to be typeset, e.g. $\sqrt{2}$

Returns

LaTeX code based on current template, containing the given expression and ready for typesetting

Return type

str

get_texcode_for_expression_in_env(expression, environment)[source]

Inserts expression into TeX template wrapped in begin{environemnt} and end{environment}

Parameters
  • expression (str) – The string containing the expression to be typeset, e.g. $\\sqrt{2}$

  • environment (str) – The string containing the environment in which the expression should be typeset, e.g. align*

Returns

LaTeX code based on template, containing the given expression inside its environment, ready for typesetting

Return type

str