ArcGIS Developer Help

IRay2 Interface

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

	Name	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.

Classes that implement IRay2

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;
}