Description:

Get the computed station orientation for a particular photo.

Syntax:

"GetPhotoStation ID t"

where:

ID is a unique identifier number for the photograph (>=1), and t is "0" to return angles as omega, phi, kappa Euler angles or "1" to return the rotation matrix form, or 2 to return the center point coordinates and roll angle.

Return:

"1 x y z w p k"  or

"1 x y z r11 r12 r13 r21 r22 r23 r31 r32 r33" or

"1 x y z x2 y2 z2 roll" 

if  successful or "0" if not

where:

"x y z" is the station perspective center, "w p k" are the station's Euler angles (in radians), or the r's are the values of the rotation matrix (e.g. r21 is the element in the 2nd row and 1st column) or the “x2 y2 z2” are the center point coordinates and “roll” is the roll angle.

Failure returns

- incorrect number of parameters

- no project is open

- 'ID' does not correspond to an existing photo

- photo is not oriented

Example:

"GetPhotoStation 1 0"

returned "1 23.3 12.1 -1.3 0.0 1.4 -2.1"  OR

"GetPhotoStation 1 1"

returned "1 23.3 12.1 -1.3 1.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0"

"GetPhotoStation 1 2"

returned "1 23.3 12.1 -1.3 0.0 0.0 0.0 45.0"