TextBatchPrimitiveSet Method (IEnumerableCartesian, IEnumerableString, TextBatchPrimitiveOptionalParameters) |
Namespace: AGI.Foundation.Graphics
public void Set( IEnumerable<Cartesian> positions, IEnumerable<string> text, TextBatchPrimitiveOptionalParameters optionalParameters )
Exception | Condition |
---|---|
ArgumentNullException | positions or text is null. |
ArgumentException | positions and text must contain the same number of elements. |
CouldNotCreateVideoCardResourceException | Could not allocate video memory for positions and text. |
This call overwrites the primitive's previous strings. To update a subset of string, use SetPartial(IEnumerableCartesian, IEnumerableString, IEnumerableInt32)
See TextBatchPrimitiveOptionalParameters for details on how to define per-batch and per-string parameters.
If this method is called frequently, it is recommended to construct the primitive with Frequent, which is the default. If this method will be called only once or infrequently, construct the primitive with Infrequent. See the Set Hint topic for more information.
If the primitive's AutomaticallyComputeBoundingSphere property is , the primitive's BoundingSphere is computed based on positions. Otherwise, it is the caller's responsibility to update the primitive's BoundingSphere to a sphere that encompasses all the positions.