private void CreateSimpleDemoScene()
{
// When using Ab3d.PowerToys and Ab3d.DXEngine, then the standard way to render text is to use TextBlockVisual3D.
// It provides many options and easy positioning with Position / PositionType properties. See sample in the Ab3d.PowerToys samples project for more info.
//
// Here we also show how to setup the alpha-clip threshold that can be used when rendering with Ab3d.DXEngine.
// This way we do not need to sort the TextBlockVisual3D by their distance to render them correctly.
var textBlockVisual3D = new TextBlockVisual3D()
{
Text = "TextBlockVisual3D",
Position = new Point3D(-190, -50, 0),
PositionType = PositionTypes.BottomLeft,
TextDirection = new Vector3D(1, 0, 0),
UpDirection = new Vector3D(0, 1, 0),
Size = new Size(80, 40),
Background = Brushes.Transparent,
RenderBitmapSize = new Size(256, 128),
TextPadding = new Thickness(5, 0, 5, 0),
BorderBrush = Brushes.Yellow,
BorderThickness = new Thickness(0, 2, 0, 2),
IsBackSidedTextFlipped = true
};
// Because TextBlockVisual3D usually use transparent background the rules and limitations of rendering transparent objects apply when using multiple TextBlockVisual3D objects (see Alpha clipping sample for more info).
// With Ab3d.DXEngine a very fast transparent objects sorting can be enabled by:
// MainDXViewportView.DXScene.IsTransparencySortingEnabled
//
// But instead of using transparency sorting, we enable alpha-clipping (see Alpha clipping sample for more info):
textBlockVisual3D.SetDXAttribute(DXAttributeType.Texture_AlphaClipThreshold, 0.15f);
MainViewport.Children.Add(textBlockVisual3D);
// It is also possible to show 3D text with using TextVisual3D.
// This objects renders text with using 3D lines.
// Its disadvantage is that it supports only an old style font that was used for plotters and cannot render all the characters.
// TextBlockVisual3D renders the text with first rendering the text with the specified border to a texture.
// This this texture is rendered into a plane 3D object.
// This works very well when there are not a lot of texts.
// But if many texts need to be rendered, then the it takes long to render all texts to textures and also they take a lot of memory.
//
// In this case the InstancedTextNode can be used because it only rendered individual characters and then reuses
// the textures with rendered characters to show the texts. To make rendering even more efficient object instancing is used.
//
//
// The first set in using the InstancedTextNode is to create its instance.
//
// There we define the FontFamily and FontWeight that will be the same for all added texts.
//
// We also define the size of the texture that will be used to render the characters.
// It is recommended to use size that is power of 2 - for example 64, 128, 256, etc.
// By default the fontBitmapSize is set to 128 that rendered characters to 128 x 128 texture.
//
// We can also set the useDynamicInstanceBuffer to true. This would create dynamic instance buffer.
// This is recommended when the text data is changed very ofter (color, position or visibility is changed in each frame or similar).
// Here we change data only occasionally, so preserve the useDynamicInstanceBuffer in its default value (this is better for GPU access to the buffer)
_instancedTextNode = new InstancedTextNode(fontFamily: new FontFamily("Arial"),
fontWeight: FontWeights.Normal,
fontBitmapSize: 128,
useDynamicInstanceBuffer: false);
// Than we can call AddText to add individual text to the InstancedTextNode.
// Note that to be able to show text from the back side, we need to set hasBackSide to true (this rendered twice as many objects).
// AddText method returns an instance of InstancedText object that can be used to change the color, position, show or hide text.
_instancedText = _instancedTextNode.AddText("Ab3d.DXEngine", Colors.Orange, new Point3D(-190, 0, 0), size: 25, hasBackSide: true);
// To change direction and orientation of text, we can call the SetTextDirection method.
_instancedTextNode.SetTextDirection(textDirection: new Vector3D(1, 0, 0), upDirection: new Vector3D(0, 0, -1));
// All characters from font are supported. Also new line is supported.
_instancedTextNode.AddText("All chars:\n@üßščžç☯", Colors.Black, new Point3D(-100, 1, 50), size: 30, hasBackSide: true);
_instancedTextNode.SetTextDirection(textDirection: new Vector3D(1, 0, 0), upDirection: new Vector3D(0, 1, 0));
_instancedTextNode.AddText("Right->", Colors.Red, new Point3D(0, 30, 0), size: 30, hasBackSide: true);
_instancedTextNode.SetTextDirection(textDirection: new Vector3D(0, 0, -1), upDirection: new Vector3D(0, 1, 0));
_instancedTextNode.AddText("Forward->", Colors.Blue, new Point3D(0, 30, 0), size: 30, hasBackSide: true);
_instancedTextNode.SetTextDirection(textDirection: new Vector3D(0, 1, 0), upDirection: new Vector3D(-1, 0, 0));
_instancedTextNode.AddText("UP->", Colors.Green, new Point3D(0, 70, 0), size: 30, hasBackSide: true);
// Sample on how to create text that is flipped on the back side (so it can be correctly read from the back side)
var startPosition = new Point3D(10, 0, 0);
_instancedTextNode.SetTextDirection(textDirection: new Vector3D(1, 0, 0), upDirection: new Vector3D(0, 1, 0));
var flippedFrontFaceInstancedText = _instancedTextNode.AddText("FlippedBackSideText", Colors.Green, startPosition, size: 25, hasBackSide: false);
// Based on size of previous text (instancedText.TextBounds), we can calculate the start position for the flipped back face text:
var backFaceStartPosition = new Point3D(startPosition.X + flippedFrontFaceInstancedText.TextBounds.SizeX, startPosition.Y, startPosition.Z);
_instancedTextNode.SetTextDirection(textDirection: new Vector3D(-1, 0, 0), upDirection: new Vector3D(0, 1, 0)); // flip textDirection, preserve upDirection
var flippedBackFaceInstancedText = _instancedTextNode.AddText(flippedFrontFaceInstancedText.Text, flippedFrontFaceInstancedText.Color, backFaceStartPosition, size: 25, hasBackSide: false);
// It is also possible to call AddText that takes transformation matrix instead of position and scale.
// This method does not use current text direction that is set with SetTextDirection:
var transform3DGroup = new Transform3DGroup();
transform3DGroup.Children.Add(new ScaleTransform3D(20, 70, 20)); // Note that initially the font size is 1, so we need to scale it !!!
transform3DGroup.Children.Add(new TranslateTransform3D(-120, -120, 0));
_instancedTextNode.AddText("Custom transform", Colors.Gray, transform3DGroup.Value, hasBackSide: true);
// If we want to immediately create character textures, we can call the InitializeResources method.
// Note that MainDXViewportView.DXScene must not be null (this can be called in MainDXViewportView.DXSceneDeviceCreated or MainDXViewportView.DXSceneInitialized event handler)
//_instancedTextNode.InitializeResources(MainDXViewportView.DXScene);
// Show the InstancedTextNode as any other DXEngine's SceneNode:
var sceneNodeVisual1 = new SceneNodeVisual3D(_instancedTextNode);
MainViewport.Children.Add(sceneNodeVisual1);
// To show text with other font or with other font weight, we need to create another InstancedTextNode
_instancedTextNode2 = new InstancedTextNode(new FontFamily("Times New Roman"), FontWeights.Bold, fontBitmapSize: 128);
_instancedTextNode2.AddText("Text with any font", Colors.Gold, new Point3D(100, -100, 0), 30, true);
var sceneNodeVisual2 = new SceneNodeVisual3D(_instancedTextNode2);
MainViewport.Children.Add(sceneNodeVisual2);
SetupDemoSceneButtons(isDemoSceneShown: true);
UpdateCharactersCountInfo();
}
