Syntax @Snip([REJECTABLE, ][HANDLE_ARCS_AND_ELLIPSES, ], [,(DISTANCE|PERCENTAGE|VERTEX|][,(2D|3D)]) @Snip([REJECTABLE, ][HANDLE_ARCS_AND_ELLIPSES, ],,,) @Snip([REJECTABLE, ][HANDLE_ARCS_AND_ELLIPSES, ],,[], (MEASURE_RELATIVE_FROM_START|MEASURE_REAL_VALUES)) Arguments REJECTABLE If this keyword is specified, unprocessable features will have a rejection code added, and will be sent along. Range: N/A , Define the distances to retain, measured from the first coordinate of the line, of the beginning and end of the portion of the line. Each of these can be a numeric value or one of the literal strings "start" or "end", to refer to the first coordinate or last coordinate of the line, respectively. A value of "0" is equivalent to "start", and a value of "-1" is equivalent to "end". Range: Real number >=0, -1, "start" or "end" Specifies the upper bound on the range in which and are specified. A length specifier of PERCENTAGE is equivalent to specifying a normalized length of 100.0; in this case and specify percentage of distance along the line. A length specifier of VERTEX indicates that the and are 0- relative indices of the first and last vertices of the line (inclusive) to be contained in the resulting feature's geometry. If a textual keyword or specific is not specified, the locations are assumed to be specified in ground units. Range: Positive real number , Specifies an (x,y) coordinate from which to begin snipping. If the coordinate is not directly on the line being snipped, the given (x,y) value will be snapped to the nearest coordinate which is on the line. Range: Real number , Specifies an (x,y) coordinate from which to begin snipping. If the coordinate is not directly on the line being snipped, the given (x,y) value will be snapped to the nearest coordinate which is on the line. Range: Real number , If MEASURE_RELATIVE_FROM_START is specified, it denotes the measure values that are relative to the start of the line. These values must be greater than or equal to zero. If MEASURE_REAL_VALUES is specified, it denotes the actual measure values where snipping should occur. Range: Real number The name of the measure used in snipping. Default measure name is assumed when it is left blank. Range: String Description This function is used to shorten a line by chopping off the ends either by distance, vertex or measure values. It only operates on features with simple line geometry and polygons without holes. Distance or Vertex Snipping ~~~~~~~~~~~~~~~~~~~~~~~~~~~ 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 start and end of the snipping can be specified in one of two forms. In the first form, the locations are specified as a measured distance from the first coordinate of the original features. By default, the measurement is taken as the same units as the coordinates of the feature. However, a third parameter may be specified to indicate how the distance is to be interpreted. It may be a number or one of the special keywords: DISTANCE, PERCENTAGE, or VERTEX. If the distance interpretation is specified as a number, it indicates that the and are expressed with the assumption that the line has length equal to the given . In other words, the positions are in the numerical range of [0,], where 0 is the first vertex of the original line and is its final vertex. An interpretation of DISTANCE is the default if no distance specifier is given. It indicates that and are measured in ground units, from the initial vertex of the line. An interpretation of PERCENTAGE indicates that and express the distance as a percentage of the total length of the line. An interpretation of VERTEX indicates that and specify the indices of actual vertices within the original line feature. The index is 0-relative; that is, the initial vertex of the line is at index 0. The final optional parameter in the first form of the form of this function tells it how to measure its length. If the input feature's geometry is two- dimensional, or the measurement specifier is given as 2D (the default), then all measurements are taken in the (x,y) plane. If the function is operating on a three-dimensional line, and the measurement specifier is given as 3D, the Z coordinate value will be taken into account when computing the length of each line segment. Note: The 2D/3D specifier does not have any effect on two-dimensional lines, or when and are being interpreted using the VERTEX option. The second form by which to specify the snipping bounds is as a pair of (x,y) coordinate values. If the endpoints for the snipping are provided in this form, the nearest location on the feature's line is used as the endpoint of the resulting geometry. Note: @Snip currently only operates on plain lines and simple polygons. Attempts to @Snip points, donuts, aggregates, arcs, or other geometry will have no effect. Measure Snipping ~~~~~~~~~~~~~~~~ The parameters specify the measure name, starting and ending measure values for the snipping. One of the two modes is entered when MEASURE_RELATIVE_FROM_START or MEASURE_REAL_VALUES form is used. In MEASURE_RELATIVE_FROM_START mode, the specified measure values 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. In MEASURE_REAL_VALUES mode, the specified measure values refer to actual measure values at the start and end points of the resulting line. Linear feature must have non-strictly increasing or decreasing measure values; otherwise, a warning is generated. In both cases, if the specified measure value(s) do not correspond to measure value(s) on the vertices of the original line, then the snipped line will have end point(s) that are the interpolated points of the two closest measure values. The interpolation is done either using the 2D or 3D distance depending on the dimension of the original line. TO BE RESOLVED HANDLE_ARCS_AND_ELLIPSES argument added to Syntax section above, but not documented. This argument is now deprecated, but must be kept for legacy purposes.