Shortens the geometry of a line feature by snipping off specified distances, indices or measure values from the ends. It operates on features with simple line geometry and polygons without holes.
The parameters specify a starting and ending point for the snipping. After execution, the feature's geometry will be a line representing the portion of the original line between those two positions, inclusive of the endpoints. New coordinates will be generated at the beginning or end of the line, if there are not already coordinates at exactly the specified positions. If the line contains three-dimensional coordinates, the Z value at each endpoint will be interpolated linearly from the original feature's coordinates between which the endpoint exists.
The mode you choose determines which parameters are available and how they are interpreted. Therefore, only the mode parameters are listed here.
In all modes, features containing geometry other than polygons or lines (for example, points and donut polygons) will be passed through this transformer untouched.
Distance (Value) or Distance (Percentage): The amount to snip from the beginning and end of the line can be specified as either a measurement in ground units or a percentage of the line's entire length, starting from the first coordinate. The placeholder value "-1" may be used to specify an ending position corresponding to the original line's final vertex. Each of these parameters may either be entered as a number, or can be taken from the value of a feature attribute by selecting the attribute name from the pull-down list.
If the measurement mode is 3D, and the linear feature has Z coordinates, all measurements will be taken as a distance from one vertex to the next in 3D space. Otherwise, only the X and Y coordinates will be considered, and measurements will be planar distances between vertices.
Measure (Relative to Start Point): The values specified in the Starting Location and Ending Location parameters refer to the absolute difference in the measure value of the start point of the original line and the start or end points of the resulting line respectively. These parameters must have values greater than or equal to zero. If Measure Name field is blank, the default measure values are used. Otherwise, the measure values with the name specified in Measure Name field is used instead.
Measure (Value): The values specified in Starting Location and Ending Location parameters refer to the measure values at the start and end points of the resulting line. If Measure Name field is blank, the default measure values are used. Otherwise, the measure values with the name specified in Measure Name field is used instead.
Vertex: The vertices from the original line which are to form the first and last vertices of the resulting line are specified as a numeric index, with "0" being the first vertex of the line. Negative numbers measure vertices relative to the last point in the line, with the value "-1" used to specify the vertex which is the last vertex of the line's geometry, "-2" the second last vertex, and so on. Each of these parameters may either be entered as a number, or can be taken from the value of a feature attribute by selecting the attribute name from the pull- down list.
If the Geometry Handling parameter (under Advanced Workspace Settings) is set to Enhanced in the workspace, arcs and ellipses can be snipped; they are otherwise left untouched.
The Measurement Mode parameter does not have any effect on two-dimensional lines, or when the Mode is Vertex.
About Transformer Parameter Options
This transformer replaces the DistanceSnipper and VertexSnipper.
Search for samples and information about this transformer on FMEpedia.
Keywords: DistanceSnipper VertexSnipper