 | |
Text | |
TextBlockFactory is a helper class that can create text blocks with specified background and border.
The TextBlockFactory can use the default SharpEngine's BitmapTextCreator (created by GetDefaultBitmapTextCreator(Scene))
or can be created by a custom BitmapTextCreator.
Inheritance HierarchySystemObject
Ab4d.SharpEngine.UtilitiesTextBlockFactory
Ab4d.SharpEngine.UtilitiesTextBlockFactory
Namespace: Ab4d.SharpEngine.Utilities
Assembly: Ab4d.SharpEngine (in Ab4d.SharpEngine.dll) Version: 3.2.9386+3a404a3e1ebfa4efd231da7fe6f10dfb23b95dc4
SyntaxC#
public class TextBlockFactory : IDisposable
The TextBlockFactory type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | TextBlockFactory(BitmapTextCreator) | Constructor that will use the specified BitmapTextCreator. |
| TextBlockFactory(Scene) | Constructor that will use the default BitmapTextCreator (get by GetDefaultBitmapTextCreator(Scene)). |
Properties| Name | Description | |
|---|---|---|
 | BackgroundColor | Color4 that specifies the color of the background panel. When set to Color4.Transparent, then the background panel is not rendered. Default value is Transparent. |
| BackgroundHorizontalPadding | Float value that defines the horizontal padding of the background plane - how much bigger is the background plane. Default value is 8. |
| BackgroundOffset | Float that defined how far from the background plane the text will be. This prevents z-fighting artifacts (merging the text with the background). Default value is 0.05. Increase this value if some artifacts are visible. |
| BackgroundVerticalPadding | Float value that defines the vertical padding of the background plane - how much bigger is the background plane. Default value is 4. |
| BackMaterialColor | Color4 that defines the background color of a BackMaterial for PlaneModelNode that is created to render background panel. When set to Color4.Transparent, then BackMaterial is set to null. Default value is Color4.Black. |
| BorderColor | Color4 that defines the color of the border. When set to Color4.Transparent, then the border is not rendered. Default value is Color4.Black. |
| BorderThickness | Float value that specifies the thickness of the border. When set to 0, then the border is not rendered. Default value is 0. |
| FontSize | Size of the font. 14 by default. |
| IsSolidColorMaterial | True when a SolidColorMaterial is used to render the text. In this case the text will always be rendered with the specified color and will not be shaded by lighting. True by default. |
| Scene | Gets the Scene that was used to initialize this TextBlockFactory. |
| TextColor | Color4 of the text. Black by default. |
Methods| Name | Description | |
|---|---|---|
| CreateTextBlock(String, Vector3, Single, Single, String) | CreateTextBlock that creates a GroupNode with text at the specified center position and text orientation. Color of the text, background and the border is specified with the properties in this class. To align the text to a specific position use the overload that takes position and positionType. |
| CreateTextBlock(String, Vector3, PositionTypes, Single, Single, String) | CreateTextBlock that creates a GroupNode with text at the specified position, position type and text orientation. Color of the text, background and the border is specified with the properties in this class. |
| CreateTextBlock(Vector3, PositionTypes, String, Vector3, Vector3, String) | CreateTextBlock that creates a GroupNode with text at the specified position, position type and text orientation. Color of the text, background and the border is specified with the properties in this class. |
| Dispose |
Remarks[Missing <remarks> documentation for "T:Ab4d.SharpEngine.Utilities.TextBlockFactory"]
See Also