X → Point3 Conversions

This topic provides a reference table for all automatic type conversions to point3, sorted by merit.

Direct Conversions

This section lists all direct conversions to the point3 type. A 'Direct' conversion indicates a relation between very related types, such as integers and numbers, or 2D and 3D points. Though note that even these conversions can fail due to out-of-bounds issues, or be narrowing due to reduction.

From	Explanation
point-N	Extracts the first three coordinates as (X,Y,Z) values.
point2	Creates a 3D point on the XY plane.
textdot	Extracts the location point of the text dot.
vector	Maps the vector (X,Y,Z) components to (X,Y,Z) coordinates.

Fair Conversions

This section lists all fair conversions to the point3 type. A 'Fair' conversion indicates the types involved are closesly related in a data layout sense, though not necessarily in a conceptual sense. For example booleans and integers, or points and vectors. Although these conversions may fail or narrow, it is nevertheless considered decent practice to rely upon them in algorithms.

From	Explanation
complex number	Maps real and imaginary components to X and Y coordinates.
ITuple	Convert coordinate tuples to points.
plane	Extracts the origin point of the plane.
view	Get the target point of the view.

Plausible Conversions

This section lists all plausible conversions to the point3 type. A 'Plausible' conversion indicates a non-straightforward, but a still reasonable conversion between two types that share a salient quality, or where one is an obvious sub-type of the other. For example curves and intervals, or points and planes. Any plausible conversion can also be achieved through the explicit use of standard components.

From	Explanation
angle	Creates a point on the unit circle at the specified angle.
arc	Extracts the centre of the arc.
box	Extracts the centre point of the box.
brep	Extracts the area centroid of the brep.
circle	Extracts the centre of the circle.
curve	Extracts the area centroid of the curve.
identifier	Creates a 3D point which matches the location of the referenced Rhino point object.
line	Extracts the middle of the line.
mesh	Extracts the area centroid of the mesh.
polyline	Extracts the area centroid of the polyline.
rectangle	Extracts the centre of the rectangle.
sphere	Extracts the centre point of the sphere.
surface	Extracts the area centroid of the surface.
triangle	Extracts the area centre of the triangle.
tube	Extracts the area centroid of the tube.

Strange Conversions

This section lists all strange conversions to the point3 type. A 'Strange' conversion indicates a peculiar, but occasionally sensible, translation between types. However, it is equally likely that the conversion was not intended and thus represents a mistake in the algorithm design, which is why this conversion level is the default for showing conversion warnings in the Grasshopper interface. Examples in this category include the conversion between colours and booleans, or between circles and triangles. Any strange conversion can also be achieved through the explicit use of standard components.

From	Explanation
boolean	Converts false to origin, true to unit Z coordinate.
colour	Maps (R,G,B) channels to (X,Y,Z) coordinates.
Colour (RGB)	Maps (R,G,B) channels to (X,Y,Z) coordinates.
integer	Creates a 3D point with the integer as the Z coordinate.
integer (big)	Creates a 3D point with the integer as the Z coordinate.
number	Creates a 3D point with the number as the Z coordinate.

Weird Conversions

This section lists all weird conversions to the point3 type. A 'Weird' conversion indicates an exotic relationship between types which is almost certainly unintended on the part of the user. However, very occasionally these conversions make sense and allow the user to avoid the use of several components to achieve the same result. Examples in this category include conversions between planes and integers, or points and intervals.

From	Explanation
interval	Creates a point with the interval middle as Z elevation.