Unimplemented but documented Camera functions

The Camera Documentation states that the following functions are available:

applyTransform(transform) Apply a transform to the camera. The camera position, focal-point, and view-up are re-calculated using the transform’s matrix to multiply the old points by the new transform.

But this is not implemented at all.

Additionally,

getOrientation() Get the orientation of the camera (x, y, z orientation angles from the transformation matrix).

and

getOrientationWXYZ() Get the wxyz angle+axis representing the current orientation. The angle is in degrees and the axis is a unit vector.

are both implemented as () => {};

Several other functions are only half-documented, (explicitly stating a getFunction when there are both getters and setters) and some are even duplicated, (eg: roll() and roll(angle), yet does not state if the angle is in degrees or radians)

Camera functions are a pretty important part of setting up a viewer. Either state that certain functions are unimplemented or don’t include them in documentation until finished.

What can I do to help?

[aylward]

Ken mentioned that vtkMath provides methods that don’t exist for gl-matrix and vtkMath provides compatibility with vtk C++.

See also #612

More discussion is needed - triaged.

[jourdain]

We could remove the matrix stuff from vtkMath and force the user to use gl-matrix or the matrixBuilder instead.