com.luciad.create.geometries

Interface IGeometryCreator

All Known Implementing Classes:

PatchCreator, PointCreator, PolylineCreator, PolylineRingCreator

public interface IGeometryCreator

A geometry creator can create geometry instances, based on input events.

It uses a callback to signal changes to the geometry or to signal that the creation has finished.

Users of this class need to

• explicitly start creation
• send events to the creator
• listen to geometry changes
• stop sending events when creation has finished

IGeometryCreator instances can be used multiple times. Creating a new instance should only start after the last one has finished.

Method Summary

Modifier and Type	Method and Description
EventResult	onEvent(IInputEvent inputEvent, FeatureCreateContext context) Handles the given event, and returns if the event was handled or not.
void	start(IGeometryCreateCallback callback, FeatureCreateContext context) This method is called to start creation.

Method Detail

start

void start(@NotNull
           IGeometryCreateCallback callback,
           @NotNull
           FeatureCreateContext context)
    throws NullPointerException

This method is called to start creation.

After this call, IGeometryCreator#onEvent can be called.

When a IGeometryCreator was started, it can not be started again until it has finished. Implementations of this method are encouraged to throw an exception in that case to signal a programming error by the caller of this method.

Parameters:

callback - the callback to signal geometry changes, and whether creation for the geometry has finished, cannot be null.

context - the context, cannot be null

Throws:

NullPointerException - when null is passed.

onEvent

@NotNull
EventResult onEvent(@NotNull
                             IInputEvent inputEvent,
                             @NotNull
                             FeatureCreateContext context)
                      throws NullPointerException

Handles the given event, and returns if the event was handled or not.

Parameters:

inputEvent - an event, cannot be null

context - the context, cannot be null

Returns:

if the event was consumed or not

Throws:

NullPointerException - when null is passed.