public class SoAnnoText3 extends SoShape
SoAnnoText3
has some features of SoText3
and also some of SoText2
.
For example, in the RENDER2D_PRINT_RASTER mode the text is rendered using SoText2
, but the font size (see SoFont
) is interpreted in the current 3D units like SoText3
. As a result, the text is always screen aligned, but the size changes depending on distance from the camera. Text in this mode cannot be rotated.
The current annotation property (SoAnnoText3Property
) determines the mode. The default is RENDER3D_PRINT_VECTOR (render like SoText3
).
If scaling is applied (e.g. SoTransform
) and the mode is RENDER2D_PRINT_RASTER, then the scale factor actually applied to the text is the
minimum scale factor of the three axes (x, y, z).
Limitations:
SoFont
), the text is rendered with lines rather than faces. Line attributes apply instead of polygon attributes. Text is not extruded.
SoAnnoText3Property
), the export limitations of SoText2
apply. See that class for more information.
Shape Antialiasing type is SoShape.TEXT
.
File format/default:
AnnoText3 {
string | "" |
spacing | 1.0 |
justification | LEFT |
alternateRep | NULL |
Action behavior:
SoGLRenderAction
Draws text based on the current font, profiles, transformation, drawing style, material, texture, complexity, and so on.
SoRayPickAction
Performs a pick on the text. The string index and character position are available from the SoTextDetail
.
SoGetBoundingBoxAction
Computes the bounding box that encloses the text.
SoCallbackAction
For non-stroke fonts,if any triangle callbacks are registered with the action, they will be invoked for each successive triangle used to approximate the text geometry.
For stroke fonts, if any line segment callbacks are registered with the action, they will be invoked for each successive line segment used to approximate the text geometry.
See also:
SoAnnoText3Property
, SoText2
, SoText3
, SoFullSceneAntialiasing
Modifier and Type | Class and Description |
---|---|
static class |
SoAnnoText3.Justifications
Justification types.
|
SoShape.ShapeTypes
SoNode.RenderModes
Inventor.ConstructorCommand
Modifier and Type | Field and Description |
---|---|
SoSFNode |
alternateRep
This field optionally holds an
SoText3 node that will be written out in place of this SoAnnoText3 node when saved to a .iv file. |
SoSFEnum<SoAnnoText3.Justifications> |
justification
Indicates placement and alignment of strings.
|
SoSFFloat |
spacing
Defines the distance (in the negative y direction) between the base points of successive strings, measured with respect to the current font height.
|
SoMFString |
string
The text string(s) to display.
|
boundingBoxIgnoring
VERBOSE_LEVEL, ZeroHandle
Constructor and Description |
---|
SoAnnoText3()
Constructor.
|
getShapeType, isPrimitiveRestartAvailable, isPrimitiveRestartAvailable
affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderEngineMode, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults
dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable
getNativeResourceHandle
public final SoMFString string
public final SoSFFloat spacing
public final SoSFEnum<SoAnnoText3.Justifications> justification
public final SoSFNode alternateRep
SoText3
node that will be written out in place of this SoAnnoText3
node when saved to a .iv file.Generated on July 31, 2019, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com