"C"

Crimson

"L"

Lime

"I"

Indigo

"P"

Pink

Point feature

A point that is exactly on an edge of a clipper is regarded as inside the clipper if the outside of the clipper is to the left of the edge, or if the edge is exactly horizontal and the outside is below it. This means that if the clippers cover the plane with no overlaps, each point will be inside exactly one polygon.

Line feature

A line piece that is exactly on a clipper boundary is regarded as inside the clipper. So if a river defines the border between two clipping country polygons, then the river as a line feature is inside both countries and will appear twice in the output. If you want to make the borders of adjacent clippers into unique lines, you can use a BorderMergeOperator instead.

Polygon feature

Polygons or polygon parts that have a horizontal area of zero will disappear in the output. Also, the z-coordinates in the output pieces will become zero.

Raster feature

Since a raster geometry is always rectangular, the raster cells that should be clipped away cannot literally be removed, but will be filled with something invisible. For an RGB or RGBA raster, this will be a completely transparent color, so an RGB raster is automatically converted to RGBA before clipping. For a purely numeric raster or a raster containing indexes into a color table, the invisible value will be the UndefinedValue. If an Undefined value is not specified for the input raster, the operator will specify the largest representable cell value as the Undefined value of the output raster. While doing this, the operator will also, if possible, extend the bit depth of the raster from 8 to 16 bit or from 16 to 32 bit, to avoid specifying an Undefined value that may occur in the input raster.

For efficiency, and also because raster features are usually not assigned attributes, a raster object that shall be clipped to the inside of the clipping polygons is treated slightly differently from vector data objects. For each such raster feature, the operator collects all clipping polygons whose InsideClipperTag equals the raster ObjectTag, and clips the raster by this polygon collection using the even-odd rule. The effect is that raster cells that are inside an odd number of polygons remain visible, and the input raster gives rise to at most one clipped output raster, which does not get attributes from the clipping polygon features. This behavior should normally be what you want, and the difference from the behavior for vector data objects is noticeable only when the clipping polygons overlap each other. If you really want to clip a raster by the union of possibly overlapping polygons, you have to calculate the union first by a ConnectPolygonOperator.

Mesh feature

The clipping does not work if the visualization requires a Material with an explicit MapApplier.

"C"

Crimson

"L"

Lime

"I"

Indigo

"P"

Pink

Point feature

A point that is exactly on an edge of a clipper is regarded as inside the clipper if the outside of the clipper is to the left of the edge, or if the edge is exactly horizontal and the outside is below it. This means that if the clippers cover the plane with no overlaps, each point will be inside exactly one polygon.

Line feature

A line piece that is exactly on a clipper boundary is regarded as inside the clipper. So if a river defines the border between two clipping country polygons, then the river as a line feature is inside both countries and will appear twice in the output. If you want to make the borders of adjacent clippers into unique lines, you can use a BorderMergeOperator instead.

Polygon feature

Polygons or polygon parts that have a horizontal area of zero will disappear in the output. Also, the z-coordinates in the output pieces will become zero.

Raster feature

Since a raster geometry is always rectangular, the raster cells that should be clipped away cannot literally be removed, but will be filled with something invisible. For an RGB or RGBA raster, this will be a completely transparent color, so an RGB raster is automatically converted to RGBA before clipping. For a purely numeric raster or a raster containing indexes into a color table, the invisible value will be the UndefinedValue. If an Undefined value is not specified for the input raster, the operator will specify the largest representable cell value as the Undefined value of the output raster. While doing this, the operator will also, if possible, extend the bit depth of the raster from 8 to 16 bit or from 16 to 32 bit, to avoid specifying an Undefined value that may occur in the input raster.

For efficiency, and also because raster features are usually not assigned attributes, a raster object that shall be clipped to the inside of the clipping polygons is treated slightly differently from vector data objects. For each such raster feature, the operator collects all clipping polygons whose insideClipperTag equals the raster objectTag, and clips the raster by this polygon collection using the even-odd rule. The effect is that raster cells that are inside an odd number of polygons remain visible, and the input raster gives rise to at most one clipped output raster, which does not get attributes from the clipping polygon features. This behavior should normally be what you want, and the difference from the behavior for vector data objects is noticeable only when the clipping polygons overlap each other. If you really want to clip a raster by the union of possibly overlapping polygons, you have to calculate the union first by a ConnectPolygonOperator.

Mesh feature

The clipping does not work if the visualization requires a Material with an explicit MapApplier.

"C"

Crimson

"L"

Lime

"I"

Indigo

"P"

Pink

Point feature

A point that is exactly on an edge of a clipper is regarded as inside the clipper if the outside of the clipper is to the left of the edge, or if the edge is exactly horizontal and the outside is below it. This means that if the clippers cover the plane with no overlaps, each point will be inside exactly one polygon.

Line feature

A line piece that is exactly on a clipper boundary is regarded as inside the clipper. So if a river defines the border between two clipping country polygons, then the river as a line feature is inside both countries and will appear twice in the output. If you want to make the borders of adjacent clippers into unique lines, you can use a BorderMergeOperator instead.

Polygon feature

Polygons or polygon parts that have a horizontal area of zero will disappear in the output. Also, the z-coordinates in the output pieces will become zero.

Raster feature

Since a raster geometry is always rectangular, the raster cells that should be clipped away cannot literally be removed, but will be filled with something invisible. For an RGB or RGBA raster, this will be a completely transparent color, so an RGB raster is automatically converted to RGBA before clipping. For a purely numeric raster or a raster containing indexes into a color table, the invisible value will be the UndefinedValue. If an Undefined value is not specified for the input raster, the operator will specify the largest representable cell value as the Undefined value of the output raster. While doing this, the operator will also, if possible, extend the bit depth of the raster from 8 to 16 bit or from 16 to 32 bit, to avoid specifying an Undefined value that may occur in the input raster.

For efficiency, and also because raster features are usually not assigned attributes, a raster object that shall be clipped to the inside of the clipping polygons is treated slightly differently from vector data objects. For each such raster feature, the operator collects all clipping polygons whose insideClipperTag equals the raster objectTag, and clips the raster by this polygon collection using the even-odd rule. The effect is that raster cells that are inside an odd number of polygons remain visible, and the input raster gives rise to at most one clipped output raster, which does not get attributes from the clipping polygon features. This behavior should normally be what you want, and the difference from the behavior for vector data objects is noticeable only when the clipping polygons overlap each other. If you really want to clip a raster by the union of possibly overlapping polygons, you have to calculate the union first by a ConnectPolygonOperator.

Mesh feature

The clipping does not work if the visualization requires a Material with an explicit MapApplier.

"C"

Crimson

"L"

Lime

"I"

Indigo

"P"

Pink

Point feature

A point that is exactly on an edge of a clipper is regarded as inside the clipper if the outside of the clipper is to the left of the edge, or if the edge is exactly horizontal and the outside is below it. This means that if the clippers cover the plane with no overlaps, each point will be inside exactly one polygon.

Line feature

A line piece that is exactly on a clipper boundary is regarded as inside the clipper. So if a river defines the border between two clipping country polygons, then the river as a line feature is inside both countries and will appear twice in the output. If you want to make the borders of adjacent clippers into unique lines, you can use a BorderMergeOperator instead.

Polygon feature

Polygons or polygon parts that have a horizontal area of zero will disappear in the output. Also, the z-coordinates in the output pieces will become zero.

Raster feature

Since a raster geometry is always rectangular, the raster cells that should be clipped away cannot literally be removed, but will be filled with something invisible. For an RGB or RGBA raster, this will be a completely transparent color, so an RGB raster is automatically converted to RGBA before clipping. For a purely numeric raster or a raster containing indexes into a color table, the invisible value will be the UndefinedValue. If an Undefined value is not specified for the input raster, the operator will specify the largest representable cell value as the Undefined value of the output raster. While doing this, the operator will also, if possible, extend the bit depth of the raster from 8 to 16 bit or from 16 to 32 bit, to avoid specifying an Undefined value that may occur in the input raster.

For efficiency, and also because raster features are usually not assigned attributes, a raster object that shall be clipped to the inside of the clipping polygons is treated slightly differently from vector data objects. For each such raster feature, the operator collects all clipping polygons whose insideClipperTag equals the raster objectTag, and clips the raster by this polygon collection using the even-odd rule. The effect is that raster cells that are inside an odd number of polygons remain visible, and the input raster gives rise to at most one clipped output raster, which does not get attributes from the clipping polygon features. This behavior should normally be what you want, and the difference from the behavior for vector data objects is noticeable only when the clipping polygons overlap each other. If you really want to clip a raster by the union of possibly overlapping polygons, you have to calculate the union first by a ConnectPolygonOperator.

Mesh feature

The clipping does not work if the visualization requires a Material with an explicit MapApplier.