VertexCreator

If the Mode parameter is set to Add Point, this transformer accepts features with null, point, text, line, or arc geometries. In this case, the transformer has no effect on features containing other types of geometries.

The table below shows input features and their resulting geometries.

Input Feature	Add Point - Resulting Geometry
null geometry	point
point geometry	line
text geometry	line
line geometry	line or polygon
arc geometry	path or polygon (with path boundary)
other geometry	untouched original geometry

Text features are treated as though their geometry is a point at the text's location.

If the input feature has 3D geometry and only the X and Y parameters are specified, then any existing Z values will be removed and the resulting geometry will be 2D. If the Z parameter is an attribute whose value is null, missing or an empty string, the resulting geometry will also be 2D.

Conversely, if the input feature has 2D geometry and the X, Y, and Z parameters are all specified, then the resulting geometry will be promoted to 3D and any pre-existing 2D coordinates will gain a Z value of 0.

If the Mode parameter is set to Replace with Point, then this transformer accepts features with all types of geometries.

If the Mode parameter is set to Insert Point at Index or Replace Point at Index, then this transformer will accept only lines, paths, and polygons. If the input is a path, the last point in one segment and the first point in the next segment will be treated as two separate points (but with the same coordinates), and will therefore take up two index positions. For example, a path consisting of two segments and a total of 5 points will technically have 6 points (and consequently, 6 index positions that can be replaced/inserted to).

For polygons, the transformer will operate on the polygon's boundary as a curve, then replace the polygon's old boundary with the modified one.

The features with the new point geometry appended to, or replacing, the existing geometry.

Features that caused processing failures are output to the <Rejected> port. This may happen if the geometry does not support point appending, or if the specified coordinate attribute values were not numerical. Null, missing or empty string values for the x or y attributes will cause the feature to be rejected.

The features with the new point geometry appended to, or replacing, the existing geometry.

If the Mode parameter is set to Add Point, the VertexCreator will attempt to append the specified coordinates as a point on the given feature geometry. This geometry must be of the type null, point, text, line, or arc. Other types of input feature geometry will be ignored.

If this parameter is set to Replace with Point, the VertexCreator will replace any existing geometry on the feature with a point geometry at the specified coordinates.

If this parameter is set to Insert Point At Index, the VertexCreator will insert a point with x, y, and z (if the input geometry is 3D) coordinates into the input geometry at the index specified.

If this parameter is set to Replace Point At Index, the VertexCreator will replace the current point at the index specified of the input geometry with a new point that has the coordinates specified.

You can either choose coordinates from the value of a feature attribute by selecting the attribute name from the pull-down list, or enter numbers. If a selected attribute has a value that is null, missing or an empty string, the feature will be output through the <Rejected> port.

You can either choose coordinates from the value of a feature attribute by selecting the attribute name from the pull-down list, or enter numbers. If a selected attribute has a value that is null, missing or an empty string, the feature will be output through the <Rejected> port.

You can either choose coordinates from the value of a feature attribute by selecting the attribute name from the pull-down list, or enter numbers.

If the optional Z Value parameter is specified, the resulting feature will have a 3D geometry. Otherwise, the output feature will have a 2D geometry. If the Z Value parameter is an attribute whose value is null, missing or an empty value, the output feature will have a 2D geometry. You can either choose coordinates from the value of a feature attribute by selecting the attribute name from the pull-down list, or enter constants.

Note: The SurfaceDraper transformer (available in FME Professional and higher) can be used to supply interpolated elevation values to the vertices of 2D features based on a 3D grid or set of 3D features.

If the Mode parameter is set to Insert Point At Index or Replace Point At Index, then the VertexCreator transformer will insert or replace a point at the Index specified.