Provides access to 3D Ray properties and methods. A ray has one endpoint (its origin) and continues infinitely in one direction. Note: the IRay interface has been superseded byIRay2. Please consider using the more recent version.
Product Availability
Description
A Ray is a one-dimensional object defined by an Origin point and a directional Vector. A Ray extends to infinity from the Origin point in the direction of the Vector.
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. |
![]() |
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 |
---|---|
IGeometry | Provides access to members that describe properties and behavior of all geometric objects. |
CoClasses that implement IRay
CoClasses and Classes | Description |
---|---|
Ray | A 3D ray that begins at a point and extends infinitely along a line in one direction only. |
Remarks
A fixed tolerance value is currently used for the three intersection methods: Intersects(), Intersect(), and QueryFirstIntersection().
public IRay CreateRay(IPoint point, IVector3D vector)
{
IRay 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;
}