User Guide

modelsUnderRay 403
Parameters
locationVector
Required. A vector from which a ray is drawn and under which a list of models
is found.
directionVector Required. A vector that specifies the direction the ray is pointing.
optionsList Optional. A list that specifies the maximum number of models to return, the level
of information detail, a list of models among which to cast, and the maximum distance to draw
the ray. All of these properties are optional.
maxNumberOfModels Optional. An integer that specifies the maximum length of the returned list.
If omitted, the command returns a list containing references for all of the models found under the
specified ray.
levelOfDetail Optional. A symbol that specifies the level of detail of the information returned.
Valid values include the following:
• #simple returns a list containing references to the models found under the point. This is the
default setting.
• #detailed returns a list of property lists, each representing an intersected model. Each
property list will have the following properties:
■ #model is a reference to the intersected model object.
■ #distance is the distance from the world position specified by locationVector to the
point of intersection with the model.
■ #isectPosition is a vector representing the world space position of the point of
intersection.
■ #isectNormal is the world space normal vector to the mesh at the point of intersection.
■ #meshID is the meshID of the intersected mesh which can be used to index into the mesh
list of the
meshDeform modifier.
■ #faceID is the face ID of the intersected face which can be used to index into the face list of
the
meshDeform modifier.
■ #vertices is a 3-element list of vectors that represent the world space positions of the
vertices of the intersected face.
■ #uvCoord is a property list with properties #u and #v that represent the u and v barycentric
coordinates of the face.
modelList Optional. A list of model references that are included if they are found under the
specified ray. Model references not included in this list are ignored, even if they are under the
specified ray. Use the model references, not the string names of the models. Specify each model
you want to include. Adding a parent model reference does not automatically include its child
model references.
maxDistance Optional. The maximum distance from the world position specified by
locationVector. If a model's bounding sphere is within the maximum distance specified, that
model is included. If the bounding sphere is in range, then it may contain polygons in range and
thus might be intersected.
Example
This statement creates a list of ten models:
tModelList = [member("3D").model("foo"),member("3D").model[10]]