VTK/3DConnexion Devices Support Implementation Work Sheet

Mismatch between documentations

There is a mismatch between the old Win SDK (2.0), new Win SDK, and Mac SDK about the sign of axes of translation and rotation.

All documents state: "The home position for the device is with the negative Z-axis pointing towards the screen."

In bold are the cases that match the above sentense (mostly old Windows SDK).

oldWin newWin Mac

Translations:

Device illustration	old	new	Mac
arrow pointing away from the screen	Translate Z-axis 0 to -MAX	Translate Z-axis 0 to MAX	Translate Z-axis 0 to -MAX
arrow pointing towards the screen	Translate Z-axis 0 to MAX	Translate Z-axis 0 to -MAX	Translate Z-axis 0 to MAX
arrow pointing up	Translate Y-axis 0 to MAX	Translate Y-axis 0 to MAX	Translate Y-axis 0 to -MAX
arrow pointing down	Translate Y-axis 0 to -MAX	Translate Y-axis 0 to -MAX	Translate Y-axis 0 to MAX
arrow pointing right	Translate X-axis 0 to MAX	Translate X-axis 0 to MAX	Translate X-axis 0 to MAX
arrow pointing left	Translate X-axis 0 to -MAX	Translate X-axis 0 to -MAX	Translate X-axis 0 to -MAX

Rotations:

Device illustration	old	new	Mac
arrow turning left	Rotate Z-axis 0 to -MAX	Rotate Z-axis 0 to MAX	Rotate Z-axis 0 to -MAX
arrow turning right	Rotate Z-axis 0 to MAX	Rotate Z-axis 0 to -MAX	Rotate Z-axis 0 to MAX
arrow turning clockwise when the user looks at the table	Rotate Y-axis 0 to -MAX	Rotate Y-axis 0 to -MAX	Rotate Y-axis 0 to MAX
arrow turning counter clockwise when the user looks at the table	Rotate Y-axis 0 to MAX	Rotate Y-axis 0 to MAX	Rotate Y-axis 0 to -MAX
arrow turning down towards the user	Rotate X-axis 0 to MAX	Rotate X-axis 0 to MAX	Rotate X-axis 0 to MAX
arrow turning up towards the screen	Rotate X-axis 0 to -MAX	Rotate X-axis 0 to -MAX	Rotate X-axis 0 to -MAX

A post I wrote

http://www.3dconnexion.com/forum/viewtopic.php?p=16213#16213