For raw rendering speed, use the least amount of primitives to represent as many objects as possible.
|Triangle Mesh||Combine TriangleMeshPrimitive objects that have the same color. When using indexed triangle lists as input, the triangles do not need to be adjacent. See the Triangle Mesh Overview to learn about indexed triangle lists.|
|Point Batch||Instead of creating several PointBatchPrimitive objects, each with a single point, create one PointBatchPrimitive with many points.|
|Text Batch||Use one TextBatchPrimitive object to render several strings. Although in many cases, rendering thousands of strings with a small number of objects will be as efficient as rendering with just one, and is likely to provide better culling.|
|Polyline||Instead of creating several PolylinePrimitive objects with two positions each, create one PolylinePrimitive with several positions. Also, instead of creating several PolylinePrimitive objects, using PolylineType.LineStrip, create one PolylinePrimitive using PolylineType.Lines. This trades memory for better batching.|
By combining triangle mesh primitives that share the same color we can improve performance even though the number of pixels rendered remains the same. This batching relies on primitives sharing the same color so it is limited by the number of unique colors used. The following class can be used to combine triangle mesh primitives.
To use this class, first create an instance, specifying the color of the mesh. Then call Append one or more times to add triangles to the mesh. The triangulator objects do not need to be adjacent to each other. Finally, call Commit to create the primitive. An example that combines two extents is shown below.
For best performance, use large point batches. If a point batch is created for each point in the STK Area Targets for the United States, 13,691 primitives are created. Instead, if one point batch is created for each area target, only 134 primitives are created. The frame rate can be improved if only one point batch is used to represent every point.
In order to combine point batches, it may be necessary to use Set methods with arguments for colors if the orginial point batches have different colors. These methods allow each point in a point batch to have a unique color.
Text batches provide a great degree of flexibility to allow grouping several strings into one batch. Using TextBatchPrimitiveOptionalParameters, each string can have a unique color, horizontal origin, vertical origin, pixel offset, and eye offset. The main constraint is each string in a batch must share the same GraphicsFont.
It is straightforward and beneficial to combine several polylines that use PolylineType.Lines into one polyline. It is also possible to combine several polylines that use PolylineType.LineStrip into a single primitive that uses PolylineType.Lines by duplicating positions, for example, rendering the boundary for each state using a separate primitive. If per-position color is used and the type is changed from line strips to individual lines, one polyline primitive can render the boundary for every state.
This uses a significant amount more memory and more than double the previous method. Be cautious with this technique because it may hurt performance when limited GPU memory is available. If too much memory is used, it will not all fit into GPU memory and will cause more bus traffic.
STK Engine for UNIX 11.2