Leap Motion C# API Reference  0.8.0
Leap.ScreenList Class Reference

The ScreenList class represents a list of Screen objects. More...

Inherits Leap.Interface, and IEnumerable< Screen >.

Public Member Functions

Screen ClosestScreen (Vector position)
 Gets the Screen closest to the specified position.
 
Screen ClosestScreenHit (Pointable pointable)
 Gets the closest Screen intercepting a ray projecting from the specified Pointable object.
 
Screen ClosestScreenHit (Vector position, Vector direction)
 Gets the closest Screen intercepting a ray projecting from the specified position in the specified direction.
 
 ScreenList ()
 Constructs an empty list of screens.
 

Properties

int Count [get]
 Returns the number of screens in this list.
 
bool Empty [get]
 Deprecated.
 
bool IsEmpty [get]
 Reports whether the list is empty.
 

Detailed Description

The ScreenList class represents a list of Screen objects.

The list always contains at least one entry representing the default screen. If the user has not registered the location of this default screen, then the coordinates, directions, and other values reported by the functions in its Screen object will not be accurate. Other monitor screens only appear in the list if their positions have been registered using the Leap Motion Screen Locator.

Get a ScreenList object by calling Controller::locatedScreens().

Constructor & Destructor Documentation

Leap.ScreenList.ScreenList ( )
inline

Constructs an empty list of screens.

Member Function Documentation

Screen Leap.ScreenList.ClosestScreen ( Vector  position)
inline

Gets the Screen closest to the specified position.

The specified position is projected along each screen's normal vector onto the screen's plane. The screen whose projected point is closest to the specified position is returned. Call Screen::project(position) on the returned Screen object to find the projected point.

Parameters
positionThe position from which to check for screen projection.
Returns
The closest Screen onto which the specified position is projected.
Screen Leap.ScreenList.ClosestScreenHit ( Pointable  pointable)
inline

Gets the closest Screen intercepting a ray projecting from the specified Pointable object.

The projected ray emanates from the Pointable tipPosition along the Pointable's direction vector. If the projected ray does not intersect any screen surface directly, then the Leap Motion software checks for intersection with the planes extending from the surfaces of the known screens and returns the Screen with the closest intersection.

If no intersections are found (i.e. the ray is directed parallel to or away from all known screens), then an invalid Screen object is returned.

Note: Be sure to test whether the Screen object returned by this method is valid. Attempting to use an invalid Screen object will lead to incorrect results.

Parameters
pointableThe Pointable object to check for screen intersection.
Returns
The closest Screen toward which the specified Pointable object is pointing, or, if the pointable is not pointing in the direction of any known screen, an invalid Screen object.
Screen Leap.ScreenList.ClosestScreenHit ( Vector  position,
Vector  direction 
)
inline

Gets the closest Screen intercepting a ray projecting from the specified position in the specified direction.

The projected ray emanates from the position along the direction vector. If the projected ray does not intersect any screen surface directly, then the Leap Motion software checks for intersection with the planes extending from the surfaces of the known screens and returns the Screen with the closest intersection.

If no intersections are found (i.e. the ray is directed parallel to or away from all known screens), then an invalid Screen object is returned.

Note: Be sure to test whether the Screen object returned by this method is valid. Attempting to use an invalid Screen object will lead to incorrect results.

Parameters
positionThe position from which to check for screen intersection.
directionThe direction in which to check for screen intersection.
Returns
The closest Screen toward which the specified ray is pointing, or, if the ray is not pointing in the direction of any known screen, an invalid Screen object.

Property Documentation

int Leap.ScreenList.Count
get

Returns the number of screens in this list.

Returns
The number of screens in this list.
bool Leap.ScreenList.Empty
get

Deprecated.

Use ScreenList::isEmpty() instead.

See Also
ScreenList::isEmpty()
bool Leap.ScreenList.IsEmpty
get

Reports whether the list is empty.

Returns
True, if the list has no members.