AGI STK Graphics 11Send comments on this topic.
InitializeWithSizeSourceAndSortOrder Method (IAgStkGraphicsMarkerBatchPrimitiveFactory)
See Also 
SizeSource
Determines the source used for the size of markers in the batch.
SortOrder
The order in which markers in the batch should be sorted before rendering.
Windows






Windows & Linux

Description

Initializes a marker batch primitive with the specified sizeSource and sortOrder. This is equivalent to constructing a marker batch with the specified sizeSource, the specified sortOrder, a Set Hint of Frequent, and a Marker Batch Rendering Method of Automatic.

Syntax

[Visual Basic .NET]
Public Function InitializeWithSizeSourceAndSortOrder( _
   ByVal SizeSource As AgEStkGraphicsMarkerBatchSizeSource, _
   ByVal SortOrder As AgEStkGraphicsMarkerBatchSortOrder _
) As IAgStkGraphicsMarkerBatchPrimitive
[Unmanaged C++]
public: HRESULT InitializeWithSizeSourceAndSortOrder(
   AgEStkGraphicsMarkerBatchSizeSource SizeSource,
   AgEStkGraphicsMarkerBatchSortOrder SortOrder,
   IAgStkGraphicsMarkerBatchPrimitive ** ReturnValue
);

Parameters

SizeSource
MemberValueDescription
eStkGraphicsMarkerBatchSizeSourceFromTexture0The size of each marker is the same as the size of its texture. If the marker is not textured, the user defined size is used instead.
eStkGraphicsMarkerBatchSizeSourceUserDefined1The size of each marker in the marker batch is user defined. Either all markers have the same size (MarkerBatchPrimitive.Size) or each marker has a user defined size (MarkerBatchPrimitiveOptionalParameters.SetSizes).
Determines the source used for the size of markers in the batch.
SortOrder
MemberValueDescription
eStkGraphicsMarkerBatchSortOrderBackToFront0The markers are sorted in back to front order before rendering. For overlapping translucent markers, this enables correct blending results. This may not perform as well as ByTexture since the CPU has to sort the markers when the camera moves or a marker changes position.
eStkGraphicsMarkerBatchSortOrderFrontToBack1The markers are sorted in front to back order before rendering. For overlapping opaque markers, this can enable the GPU to quickly eliminate markers that are hidden behind other markers. In many cases, this may not perform as well as ByTexture since the CPU has to sort the markers when the camera moves or a marker changes position.
eStkGraphicsMarkerBatchSortOrderByTexture2The markers are sorted by texture. This minimizes costly texture changes during rendering and does not require resorting when the camera moves or a marker changes position.
The order in which markers in the batch should be sorted before rendering.

See Also

© 2018 Analytical Graphics, Inc. All Rights Reserved.