PlotLayer.UpdatePlots Method
Updates the plots and/or visualization of an existing plot batch.
UpdatePlots(System.UInt64 id, double\[\] plots, System.Int32 start, System.Int32 count, Crs crs, PlotSymbol symbol, System.Double opacity)
Updates the plots and/or visualization of an existing plot batch.Syntax
public System.UInt64 UpdatePlots (
System.UInt64 id,
double[] plots,
System.Int32 start,
System.Int32 count,
Crs crs,
PlotSymbol symbol,
System.Double opacity
)Parameters
The batch identifier, as returned from AddPlots.
An array of coordinate values. Each two consecutive values define the X and Y coordinates of a plot, expressed in the coordinate reference system specified by crs. If this parameter is null, the existing plots in the batch will not be changed.
Starting offset of the first coordinate pair in plots.
Number of coordinate pairs to read from plots.
The coordinate reference system of the plots.
The symbol to draw.
An extra opacity value applied when rendering the plots; 0.0 means transparent, 1.0 fully opaque.
Return Value
The batch identifier, i.e. the same as the id parameter.
Remarks
This method updates an existing batch. You can update both the plot list and the visualization, or you can update just the visualization while keeping the old plot list, by setting plots to null.
If a new plot list is specified, the plots, start and count parameters specify the geographic coordinates of the plots. Note that start and count are specified in coordinate pairs, not in number of coordinates. The coordinates will be copied internally, the plots array will not be accessed after this call.
You can also select to display only a subrange of a previously loaded batch. If plots is null, and count > 0, then start and count are used to select a subrange of the batch. If plots is null, and both start and count are 0, the full batch will be selected. Finally, if plots is null, count is 0 and start > 0, then an empty range is selected and no plots will be rendered. Note that the plot index within a batch always start from 0, even if the batch was created/updated with on offset into a plot vector.
The coordinate reference system of the plots is specified by the crs parameter; if this is different from the view coordinate reference system the coordinates will be automatically re-projected when needed. Avoid re-projecting the coordinates yourself in the application; it is more efficient to let the PlotLayer do this internally.
To update plots in a globe view, use UpdatePlots3D instead.
Platforms
Windows, Linux, Android