STK Graphics PrimitivesSend comments on this topic.
SetPartialWithOptionalParameters Method (IAgStkGraphicsMarkerBatchPrimitive)
See Also
Positions
An array containing positions (in the order x, y, z) used to update a subset of positions in the marker batch.
OptionalParameters
Optional per-marker parameters corresponding to positions. Each per-marker parameter must have the same number of elements as positions.
Indices
An array of integers containing the indices into positions. A set of x, y, and z elements is considered a single index.
Windows





Windows & Linux

Description

Updates a subset of marker positions and/or per-marker parameters in a marker batch.

Syntax

[Visual Basic .NET]
Public Sub SetPartialWithOptionalParameters( _
    ByVal Positions As System.Array, _
    ByVal OptionalParameters As IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters, _
    ByVal Indices As System.Array _
)
[C#]
public void SetPartialWithOptionalParameters(
    System.Array Positions,
    IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters OptionalParameters,
    System.Array Indices
);
[Managed C++]
public: void SetPartialWithOptionalParameters(
    System::Array ^ Positions,
    IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters ^ OptionalParameters,
    System::Array ^ Indices
);
[Unmanaged C++]
public: HRESULT SetPartialWithOptionalParameters(
    SAFEARRAY * * Positions,
    IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters * OptionalParameters,
    SAFEARRAY * * Indices
);
[Java]
public void setPartialWithOptionalParameters(
    AgSafeArray Positions,
    IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters OptionalParameters,
    AgSafeArray Indices
);
[Python - STK API ]
def SetPartialWithOptionalParameters(self, Positions:list, OptionalParameters:"IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters", Indices:list) -> None:

Parameters

Positions
An array containing positions (in the order x, y, z) used to update a subset of positions in the marker batch.
OptionalParameters
Optional per-marker parameters corresponding to positions. Each per-marker parameter must have the same number of elements as positions.
Indices
An array of integers containing the indices into positions. A set of x, y, and z elements is considered a single index.

Remarks

See Also

Example

Shows the format of the Colors, Positions and Indices parameters when updating a marker batch primitive.
[C#]
Array colors = new object[]
{
    Color.Red.ToArgb(),
    Color.Green.ToArgb(),
    Color.Blue.ToArgb(),
    Color.White.ToArgb()
};

IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters parameters = sceneManager.Initializers.MarkerBatchPrimitiveOptionalParameters.Initialize();
parameters.SetColors(ref colors);

Array positions = new object[]
{
    1247.87, -4739.74, 4067.77,
    1115.48, -4847.09, 3979.36,   
    -24.12, -5529.31, 3168.45,
    -2683.42, -4307.74, 3850.11
};

Array indices = new object[]
{
    0,
    1,
    2,
    3
};

markerBatch.SetPartialWithOptionalParametersIndicesOrderAndRenderPass(
    ref positions,
    parameters, 
    ref indices,
    AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending,
    AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque);
Shows the format of the Colors, Positions and Indices parameters when updating a marker batch primitive.
[Visual Basic .NET]
Dim colors As Array = New Object() {Color.Red.ToArgb(), Color.Green.ToArgb(), Color.Blue.ToArgb(), Color.White.ToArgb()}

Dim parameters As IAgStkGraphicsMarkerBatchPrimitiveOptionalParameters = sceneManager.Initializers.MarkerBatchPrimitiveOptionalParameters.Initialize()
parameters.SetColors(colors)

Dim positions As Array = New Object() {1247.87, -4739.74, 4067.77, 1115.48, -4847.09, 3979.36, _
	-24.12, -5529.31, 3168.45, -2683.42, -4307.74, 3850.11}

Dim indices As Array = New Object() {0, 1, 2, 3}

markerBatch.SetPartialWithOptionalParametersIndicesOrderAndRenderPass(positions, parameters, indices, AgEStkGraphicsIndicesOrderHint.eStkGraphicsIndicesOrderHintSortedAscending, AgEStkGraphicsRenderPassHint.eStkGraphicsRenderPassHintOpaque)
© 2025 Analytical Graphics, Inc. All Rights Reserved.