CompositeSelectionItem

class Selection.CompositeSelectionItem()

This class is used to represent the result of a composite picking operation. Each of its fields may be populated with a [[NodeEntitySelectionItem]].

Constructors


Constructors

CompositeSelectionItem.constructor(faceItem, lineItem, pointItem)
Arguments:
  • faceItem (null | FaceSelectionItem()) – None
  • lineItem (null | LineSelectionItem()) – None
  • pointItem (null | PointSelectionItem()) – None
Return type:

CompositeSelectionItem

Properties

CompositeSelectionItem.faceItem
Type:null | FaceSelectionItem
CompositeSelectionItem.lineItem
Type:null | LineSelectionItem
CompositeSelectionItem.pointItem
Type:null | PointSelectionItem

Methods

fetchMostRelevant

CompositeSelectionItem.fetchMostRelevant(mask)
Arguments:
  • mask (SelectionMask()) – a selection mask used to indicate the relevancy of the item to retrieve.

Returns the most relevant selection item for the provided selection mask. The priority used by this method is points -> lines -> faces. For example, if your selection mask was Faces | Lines and this item contained and all fields were populated, this method would return its lineItem.

Returns:the most relevant selection item if one exists. If no relevant item is found, null is returned.
Return type:null | NodeEntitySelectionItem