Provides access to 3D Ray properties and methods. A ray has one endpoint (its origin) and continues infinitely in one direction.

#### Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

#### Description

This interface is new at ArcGIS 9.3. It supersedes IRay.

#### Members

Description |
||
---|---|---|

Dimension | The topological dimension of this geometry. | |

Envelope | Creates a copy of this geometry's envelope and returns it. | |

GeometryType | The type of this geometry. | |

GeoNormalize | Shifts longitudes, if need be, into a continuous range of 360 degrees. | |

GeoNormalizeFromLongitude | Normalizes longitudes into a continuous range containing the longitude. This method is obsolete. | |

GetEnumIntersect | Not implemented at this release. | |

GetPointAtDistance | Constructs a point at a distance along the ray. | |

Intersect | Returns a point collection containing all points of intersection, in order along the ray. | |

Intersects | Indicates if the ray intersects the target geometry. | |

IsEmpty | Indicates whether this geometry contains any points. | |

Origin | The origin point of the ray. | |

Project | Projects this geometry into a new spatial reference. | |

QueryEnvelope | Copies this geometry's envelope properties into the specified envelope. | |

QueryFirstIntersection | Returns the first point of intersection between the ray and the target geometry. The point is set empty if there is no intersection. | |

QueryOrigin | Sets a point equal to the ray's origin. | |

QueryPlaneIntersection | Returns the point of intersection between the ray and the target plane. The point is set empty if there is no intersection. | |

QueryPointAtDistance | Queries a point at a distance along the ray. | |

QueryVector | Sets a vector equal to a unit vector with the same direction as the ray. | |

SetEmpty | Removes all points from this geometry. | |

SnapToSpatialReference | Moves points of this geometry so that they can be represented in the precision of the geometry's associated spatial reference system. | |

SpatialReference | The spatial reference associated with this geometry. | |

Vector | The direction vector of the ray. |

#### Inherited Interfaces

Interfaces | Description |
---|---|

IRay | Provides access to 3D Ray properties and methods. A ray has one endpoint (its origin) and continues infinitely in one direction. |

IGeometry | Provides access to members that describe properties and behavior of all geometric objects. |

#### CoClasses that implement IRay2

CoClasses and Classes | Description |
---|---|

Ray | A 3D ray that begins at a point and extends infinitely along a line in one direction only. |

[C#]

public IRay2 CreateRay(IPoint point, IVector3D vector)

{

IRay2 ray = new RayClass();

//If the input point.Z is NAN (Not A Number = value not set) set the z to 0

if (point.Z.Equals(Double.NaN))

{

point.Z = 0;

}

ray.Origin = point;

ray.Vector = vector;

return ray;

}