public class TLcdPanoramicTransformationFactory extends Object
ILcdModelModelTransformations
to be used in ILcdPanoramicImages
.
The source CS of the model-model transformations is a 3D topocentric CS. Its center is the focus point of the panoramic image, its axes are parallel to the axes of the model reference. For example, if the model reference is UTM, then the X axis will point east, the Y axis will point north and the Z axis will point up.
The destination CS is the 2D image CS, where:
Note: the setters for the transformation's source and target references are meaningless and will throw an UnsupportedOperationException.
When converting a point from the source CS to the destination CS, we lose depth information: all points on the same line going through the center of projection, will end on the same point in the destination CS.
The reverse transformation (from destination to source CS) converts a 2D point to a 3D point that lies on the
image plane, and must therefore be interpreted as a vector starting in the center of projection,
rather than as a real 3D coordinate.
For the calculations in the realm of the panoramic image API, conversions are indeed treated as a direction in
which is looked from the vantage point of the camera.
Transforming points from a 3D reference CS to point in a 2D image CS, requires three elements:
This class provides static factory methods for creating transformation builders, based on the projection type. See the specific builders for more information on how to set the camera pose and internal parameters for each of them:
newPerspectiveTransformation()
for perspective (or so-called "pinhole") imagesnewSphericalTransformation()
for equirectangular imagesModifier and Type | Class and Description |
---|---|
static class |
TLcdPanoramicTransformationFactory.PerspectiveTransformationBuilder
Builder for a
ILcdModelModelTransformations that transform 3D reference CS
points to 2D image CS points for perspective camera images ("pinhole images"). |
static class |
TLcdPanoramicTransformationFactory.SphericalTransformationBuilder
Builder for a
ILcdModelModelTransformations that transform 3D reference CS
points to 2D image CS points for spherical camera images ("equirectangular images"). |
Modifier and Type | Method and Description |
---|---|
static TLcdPanoramicTransformationFactory.PerspectiveTransformationBuilder |
newPerspectiveTransformation()
Creates a builder for a perspective camera ("pinhole camera") transformation.
|
static TLcdPanoramicTransformationFactory.SphericalTransformationBuilder |
newSphericalTransformation()
Creates a builder for a spherical camera ("equirectangular") transformation.
|
public static TLcdPanoramicTransformationFactory.PerspectiveTransformationBuilder newPerspectiveTransformation()
public static TLcdPanoramicTransformationFactory.SphericalTransformationBuilder newSphericalTransformation()