diff --git a/doc/index.html b/doc/index.html index a3feb52..022c1d3 100644 --- a/doc/index.html +++ b/doc/index.html @@ -513,6 +513,34 @@ This function allows for 3D object "picking." "pick line" (the line from the camera through the "pick point" on the screen. Upon error, pickObjects returns nil. +For each object in the "pick line", the following properties are set: +
objects = ag.pickOne(x, y, obj)
++This function allows for 3D object "picking," but only tests the given +object for intersection with the pick line and is thus much more efficient +than pickObjects() if you only care about +selecting on a given object. +x and y should be the 2D screen coordinates of the +"pick point." +obj indicates which object to be tested. +pickOne returns a boolean for whether or not the given object +was hit by the "pick line." +If the return value is true, then the following properties are +set on obj: +