GUI Text

GUI Text displays text of any font you import in screen coordinates.


The GUI Text Inspector

Please Note: Unity 2.0 introduced UnityGUI, a GUI Scripting system. You may prefer creating user interface elements with UnityGUI instead of GUI Texts. Read more about how to use UnityGUI in the GUI Scripting Guide.

Properties

TextThe string to display.
AnchorThe point at which the Text shares the position of the Transform.
AlignmentHow multiple lines are aligned within the GUIText.
Pixel OffsetOffset of the text relative to the position of the GUIText in the screen.
Line SpacingHow much space will be in-between lines of Text.
Tab SizeHow much space will be inserted for a tab ('\t') character. As a multiplum of the space character offset.
FontThe Font to use when rendering the text.
MaterialReference to the Material containing the characters to be drawn. If set, this property overrides the one in the Font asset.
Font SizeThe font size to use. Set to 0 to use the default font size. Only applicable for dynamic fonts.
Font StyleThe font style to use. (Normal, Bold, Italic or Bold and Italic). Only applicable for dynamic fonts.
Pixel CorrectIf enabled, all Text characters will be drawn in the size of the imported font texture. If disabled, the characters will be resized based on the Transform's Scale.
Rich TextIf enabled, allows HTML-style tags for text formatting.

Details

GUI Texts are used to print text onto the screen in 2D. The Camera has to have a GUI Layer attached in order to render the text. Cameras include a GUI Layer by default, so don't remove it if you want to display a GUI Text. GUI Texts are positioned using only the X and Y axes. Rather than being positioned in World Coordinates, GUI Texts are positioned in Screen Coordinates, where (0,0) is the bottom-left and (1,1) is the top-right corner of the screen

To import a font see the Font page.

To use Rich Text see the Rich Text page.

Pixel Correct

By default, GUI Texts are rendered with Pixel Correct enabled. This makes them look crisp and they will stay the same size in pixels independent of the screen resolution.

Hints

Page last updated: 2013-07-12