public final class MarkerBatchPrimitiveOptionalParameters extends Object implements IDisposable
MarkerBatchPrimitivethat overrides the marker batch's per-batch parameters. Define per-marker parameters by creating an instance of
MarkerBatchPrimitiveOptionalParameters, then calling the desired methods to define per-marker parameters, and finally passing the object to the marker batch's
SetPartialmethod. Marker Batch Primitive topic
|Constructor and Description|
Initializes default marker batch primitive optional parameters.
|Modifier and Type||Method and Description|
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
Defines a collection of colors, one for each marker in the batch.
Defines a collection of boolean display flags, one for each marker in the batch.
Defines a collection of eye offsets, one for each marker in the batch.
Defines a collection of origins, one for each marker in the batch.
Defines a collection of pixel offsets, one for each marker in the batch.
Defines a collection of rotation angles in radians, one for each marker in the batch.
Defines a collection of sizes, one for each marker in the batch.
Defines a collection of texture coordinates, one for each marker in the batch.
Defines a collection of textures, one for each marker in the batch.
Defines a collection of
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
protected void finalize() throws Throwable
finalizemethod to dispose of system resources or to perform other cleanup.
The general contract of
finalize is that it is invoked
if and when the Java™ virtual
machine has determined that there is no longer any
means by which this object can be accessed by any thread that has
not yet died, except as a result of an action taken by the
finalization of some other object or class which is ready to be
finalize method may take any action, including
making this object available again to other threads; the usual purpose
finalize, however, is to perform cleanup actions before
the object is irrevocably discarded. For example, the finalize method
for an object that represents an input/output connection might perform
explicit I/O transactions to break the connection before the object is
finalize method of class
Object performs no
special action; it simply returns normally. Subclasses of
Object may override this definition.
The Java programming language does not guarantee which thread will
finalize method for any given object. It is
guaranteed, however, that the thread that invokes finalize will not
be holding any user-visible synchronization locks when finalize is
invoked. If an uncaught exception is thrown by the finalize method,
the exception is ignored and finalization of that object terminates.
finalize method has been invoked for an object, no
further action is taken until the Java virtual machine has again
determined that there is no longer any means by which this object can
be accessed by any thread that has not yet died, including possible
actions by other objects or classes which are ready to be finalized,
at which point the object may be discarded.
finalize method is never invoked more than once by a Java
virtual machine for any given object.
Any exception thrown by the
finalize method causes
the finalization of this object to be halted, but is otherwise
public final void dispose()
protected void dispose(boolean disposing)
get) is not used.
public final void setSizes(Iterable<DimensionF> sizes)
To use user-defined per-marker sizes, the marker batch must be
The size may be interpreted to be pixels or meters depending on
Per-marker sizes override the per-batch size. Therefore, when
per-marker sizes are defined with this method,
If per-marker or per-batch textures are used, the texture is modulated
with the per-marker color defined with
Per-marker colors override the per-batch color. Therefore, when
per-marker colors are defined with this method, the marker batch's
The origin defines where the marker is placed relative to its position.
Per-marker origins override the per-batch origin. Therefore, when
per-marker origins are defined with this method,
The pixel offset defines a screen-space translation for a marker from its
Per-marker pixel offsets override the per-batch pixel offset. Therefore, when
per-marker pixel offsets are defined with this method,
Eye offsets define an eye-space translation in meters. In eye-space, the
Per-marker eye offsets override the per-batch eye offset. Therefore, when
per-marker eye offsets are defined with this method,
Positive rotation angles rotate counter-clockwise in screen-space.
Per-marker rotation angles override the per-batch rotation angle. Therefore, when
per-marker rotation angles are defined with this method,
public final void setTextureCoordinates(Iterable<TextureCoordinate4DF> textureCoordinates)
Each texture coordinate component is in the range
Per-marker texture coordinates are used to implement a technique called a texture atlas. Instead of creating several small textures and assigning each texture to markers using per-marker textures, one large texture containing all the images is made. This texture is assigned to the marker batch and each marker is given texture coordinates that index the correct part of the texture. This can lead to better performance due to the reduced number of costly texture changes during rendering.
Per-marker texture coordinates override the per-batch texture coordinate. Therefore, when
per-marker texture coordinates are defined with this method, the marker batch's
public final void setTimeIntervalDisplayConditions(Iterable<TimeIntervalDisplayCondition> timeIntervals)
TimeIntervalDisplayConditions, one for each marker in the batch.
TimeIntervalDisplayConditions for each marker in the batch. There must be one condition for each marker passed to the
displays- The display flags for each marker in the batch. There must be one flag for each marker passed to the