Acts as a split feature agent while editing vector features.
| OpenLayers.
|
Acts as a split feature agent while editing vector features. |
| Properties | |
| events | {OpenLayers.Events} Events instance for listeners and triggering control specific events. |
| layer | {OpenLayers.Layer.Vector} The target layer with features to be split. |
| tolerance | {Number} Distance between the calculated intersection and a vertex on the source geometry below which the existing vertex will be used for the split. |
| edge | {Boolean} Allow splits given intersection of edges only. |
| deferDelete | {Boolean} Instead of removing features from the layer, set feature states of split features to DELETE. |
| mutual | {Boolean} If source and target layers are the same, split source features and target features where they intersect. |
| targetFilter | {OpenLayers.Filter} Optional filter that will be evaluated to determine if a feature from the target layer is eligible for splitting. |
| sourceFilter | {OpenLayers.Filter} Optional filter that will be evaluated to determine if a feature from the source layer is eligible for splitting. |
| Constructor | |
| OpenLayers.
|
Creates a new split control. |
| Functions | |
| setSource | Set the source layer for edits layer. |
| activate | Activate the control. |
| deactivate | Deactivate the control. |
{OpenLayers.Events} Events instance for listeners and triggering control specific events.
control.events.register(type, obj, listener);
| beforesplit | Triggered before a split occurs. Listeners receive an event object with source and target properties. |
| split | Triggered when a split occurs. Listeners receive an event with an original property and a features property. The original is a reference to the target feature that the sketch or modified feature intersects. The features property is a list of all features that result from this single split. This event is triggered before the resulting features are added to the layer (while the layer still has a reference to the original). |
| aftersplit | Triggered after all splits resulting from a single sketch or feature modification have occurred. The original features have been destroyed and features that result from the split have already been added to the layer. Listeners receive an event with a source and features property. The source references the sketch or modified feature used as a splitter. The features property is a list of all resulting features. |
{OpenLayers.Layer.Vector} The target layer with features to be split. Set at construction or after construction with <setLayer>.
{Boolean} Allow splits given intersection of edges only. Default is true. If false, a vertex on the source must be within the tolerance distance of the calculated intersection for a split to occur.
{OpenLayers.Filter} Optional filter that will be evaluated to determine if a feature from the target layer is eligible for splitting.
{OpenLayers.Filter} Optional filter that will be evaluated to determine if a feature from the source layer is eligible for splitting.
Creates a new split control. A control is constructed with a target layer and an optional source layer. While the control is active, creating new features or modifying existing features on the source layer will result in splitting any eligible features on the target layer. If no source layer is provided, a temporary sketch layer will be created to create lines for splitting features on the target.
| options | {Object} An object containing all configuration properties for the control. |
| layer | {OpenLayers.Layer.Vector} The target layer. Features from this layer will be split by new or modified features on the source layer or temporary sketch layer. |
| source | {OpenLayers.Layer.Vector} Optional source layer. If provided newly created features or modified features will be used to split features on the target layer. If not provided, a temporary sketch layer will be created for drawing lines. |
| tolerance | {Number} Optional value for the distance between a source vertex and the calculated intersection below which the split will occur at the vertex. |
| edge | {Boolean} Allow splits given intersection of edges only. Default is true. If false, a vertex on the source must be within the tolerance distance of the calculated intersection for a split to occur. |
| mutual | {Boolean} If source and target are the same, split source features and target features where they intersect. Default is true. If false, only target features will be split. |
| targetFilter | {OpenLayers.Filter} Optional filter that will be evaluated to determine if a feature from the target layer is eligible for splitting. |
| sourceFilter | {OpenLayers.Filter} Optional filter that will be evaluated to determine if a feature from the target layer is eligible for splitting. |
setSource: function( layer )
Set the source layer for edits layer.
| layer | {OpenLayers.Layer.Vector} The new source layer layer. If null, a temporary sketch layer will be created. |
Set the source layer for edits layer.
setSource: function( layer )
Activate the control.
activate: function()
Deactivate the control.
deactivate: function()