Hit Lists

3ds Max maintains three INode lists, for successfully hit nodes in the ViewExp class after performing hit tests. The first list is an internally maintained list of all hit nodes. In addition a HitLog is provided for modifier sub-object hits and a CtrlHitLog for controller sub-object hits.

The following methods of the ViewExp class are used to work with INode hit lists.

• ViewExp::ClearHitList() - Clears the list of hits.
• ViewExp::GetClosestHit() - Returns the INode pointer of the node that was the closest all those hit.
• ViewExp::HitCount() - Returns the number of hits recorded.

The following methods of the ViewExp class are used to work with modifier sub-object hit lists.

• ViewExp::LogHit()- This method records a sub-object level hit record with the system using the specified parameters. This is frequently called when a plug-in needs to select a node from the scene.
• ViewExp::GetSubObjHitList() - Returns the sub-object hit list.
• ViewExp::ClearSubObjHitList() - Clears the sub-object hit list.
• ViewExp::NumSubObjHits() - Returns the number of sub-object hits.

The following methods of the ViewExp class are used to work with controller sub-object hit lists.

• ViewExpr::CtrlLogHit() - This method records a sub-object level hit record with the system using the specified parameters.
• ViewExpr::GetCtrlHitList() - Returns the controller gizmo hit list.
• ViewExpr::ClearCtrlHitList() - Clears the controller gizmo hit list.