Description
Initializes a marker batch primitive with the
specified sizeSource, sortOrder, and setHint. This is equivalent to
constructing a marker batch with the specified arguments and a
Marker Batch Rendering Method of
Automatic.Syntax
| [Visual Basic .NET] |
|---|
Public Function InitializeSizeSourceSortOrderAndSetHint( _
ByVal SizeSource As AgEStkGraphicsMarkerBatchSizeSource, _
ByVal SortOrder As AgEStkGraphicsMarkerBatchSortOrder, _
ByVal SetHint As AgEStkGraphicsSetHint _
) As IAgStkGraphicsMarkerBatchPrimitive
|
| [C#] |
|---|
public IAgStkGraphicsMarkerBatchPrimitive InitializeSizeSourceSortOrderAndSetHint(
|
| [Managed C++] |
|---|
public: IAgStkGraphicsMarkerBatchPrimitive^ InitializeSizeSourceSortOrderAndSetHint(
|
| [Java] |
|---|
public IAgStkGraphicsMarkerBatchPrimitive initializeSizeSourceSortOrderAndSetHint(
|
| [Unmanaged C++] |
|---|
public: HRESULT InitializeSizeSourceSortOrderAndSetHint(
|
Parameters
- SizeSource
-
Determines the source used for the size of markers in the batch.Member Value Description eStkGraphicsMarkerBatchSizeSourceFromTexture 0 The 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. eStkGraphicsMarkerBatchSizeSourceUserDefined 1 The 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). - SortOrder
-
The order in which markers in the batch should be sorted before rendering.Member Value Description eStkGraphicsMarkerBatchSortOrderBackToFront 0 The 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 ByTexturesince the CPU has to sort the markers when the camera moves or a marker changes position.eStkGraphicsMarkerBatchSortOrderFrontToBack 1 The 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 ByTexturesince the CPU has to sort the markers when the camera moves or a marker changes position.eStkGraphicsMarkerBatchSortOrderByTexture 2 The 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. - SetHint
-
Member Value Description eStkGraphicsSetHintInfrequent 0 Rendering is optimized for static geometry. The primitive's vertices are not going to be updated with Set() or SetPartial() calls. Calls to SetPartial() will fail. Calls to Set() are allowed but may not be as efficient as SetHintFrequent. eStkGraphicsSetHintPartial 1 Rendering is optimized for dynamic geometry. The primitive's vertices are expected to be updated with SetPartial() - some or all of the vertices will change but the number of vertices will not. eStkGraphicsSetHintFrequent 2 Rendering is optimized for streaming geometry. The primitive's vertices are expected to be updated with Set() - all the vertices will change and/or the number of vertices will change. Calls to SetPartial() will fail.