Blender Documentation Volume II - Reference Guide: Last modified March 29 2004 S68
<<< Previous | Python API Reference | Next >>>

# Text Objects

This module provides access to Text objects in Blender.

Example:

     import Blender
     from Blender import Text
     #
     txt = Text.New("MyText")          # create a new Text object
     print Text.Get()                  # current list of Texts in Blender
     txt.write("Appending some ")      # appending text
     txt.write("text to my\n")         # '\n' inserts new-line markers
     txt.write("text buffer.")
     print txt.asLines()               # retrieving the buffer as a list of lines
     Text.unlink(txt)                  # removing a Text object

Classes |
`Text` | This object gives access to Texts in Blender.

Function Summary |
Blender Text or a list of Blender Texts | `Get(name)` Get the Text object(s) from Blender.
Blender Text | `Load(filename)` Load a file into a Blender Text object.
Blender Text | `New(name, follow_cursor)` Create a new Text object.
| `unlink(textobj)` Unlink (remove) the given Text object from Blender.

Function Details |

Get(name=None) Get the Text object(s) from Blender. Parameters: `name` - The name of the Text object. (type=string) Returns: It depends on the 'name' parameter: (name): The Text object with the given name; (): A list with all Text objects in the current scene. (type=Blender Text or a list of Blender Texts)

Load(filename) Load a file into a Blender Text object. Parameters: `filename` - The name of the file to load. (type=string) Returns: A Text object with the contents of the loaded file. (type=Blender Text)

New(name=None, follow_cursor=0) Create a new Text object. Parameters: `name` - The Text name. (type=string) `follow_cursor` - The text follow flag: if 1, the text display always follows the cursor. (type=int) Returns: The created Text Data object. (type=Blender Text)

unlink(textobj) Unlink (remove) the given Text object from Blender. Parameters: `textobj` - The Text object to be deleted. (type=Blender Text)

<<< Previous | Home | Next >>>
Module Text | Up | Class Text