Oriented-Image

Any georeferenced photo (e.g., drone images, historical aerial photographs, street images) can be displayed in PlexMap 3D using the Oriented-Image data type. The Oriented-Image data type describes the capture center of an oriented photo for integration into PlexMap 3D. Licenses for the PlexMap backend, PlexMap 3D, and PlexMap Street360° are required to use this data type.

An object of type Oriented-Image must contain the name of the image capture (Title) and the image ID (ImageId) as attributes. Furthermore, the angle of rotation (Heading, Roll, Pitch) and the focal length (FocalLength) are required. The photo associated with each capture center can be imported using the File type and saved in a layer together with the Oriented-Image for processing.

Aus

The following table shows all attributes that an Oriented Image file can have:

Attribut	Funktion
`ID` (string)	ID of the image
`Title` (string)	Name of the image
`Width` (number)	Width of the image
`Height` (number)	Height of the image
`Resource` (string)	Can be the image name if the import was done via File or the URL if the import was done via a URL.
`Heading` (number)	Rotation around the negative z-axis
`Pitch` (number)	Rotation around the negative y-axis
`Roll` (number)	Rotation around the x-axis
`FocalLength` (number)	Focal length set when taking the photo
`CreationTime` (string)	Date the image was created
`AngleAxisMapping` (string)	Specifies the order, axis selection, and sign of the "Heading," "Pitch," and "Roll" values for the transformation from the panorama coordinate system to the origin coordinate system (e.g., UTM). You can also determine this value using our calibration tool. Please contact our support team for further information.

`Resource` Anchor

The Oriented-Image are assigned to the actual image files via Resource (string). The image on the right shows an example photo with a house, a lake, and a tree. Using this image, the heading, pitch, and roll attributes in the adjacent images will be explained below.

`Heading` Anchor

This attribute contains the angle in degrees that specifies the rotation around the negative z-axis in the ENU system (EastNorthUp). Heading (float) is also referred to as yaw or roll in the body-fixed coordinate system. This angle specifies the deviation of the image center from the north direction. For example, if the image center were exactly east, the heading would be exactly 90°.

Pitch Anchor

This attribute contains the angle in degrees that specifies the rotation around the negative y-axis in the ENU system (EastNorthUp). Pitch (float) is also referred to as pitch around the transverse axis in the body-fixed coordinate system. The angle specifies the deviation of the image center from the horizon. For example, if the image center were exactly at the zenith, the pitch would be exactly 90°.

Roll Anchor

This attribute contains the angle in degrees that indicates the rotation around the x-axis in the ENU system (EastNorthUp). Roll (float) is also referred to as rolling and swaying around the longitudinal axis in the body-fixed coordinate system. The angle indicates the deviation of the horizon in the image from the actual horizon in PlexMap 3D.

For example, if Roll were 90°, viewers would have to view the photo lying on their right ear to see the image correctly aligned.