Skip to main content

Camera Section

The camera section contains parameters describing the technical specifications and the position of the camera when shooting the 360° spin.

You only need to specify these values if you are using the virtual space, e.g. for hot spots.

For 2D zoom and spins without hot spots you can omit this parameter group.

digitalCropFactor

(*)

float

depends on the size of the optical sensor chip of the camera
(* Only available in FSI Viewer 360°)
since 17.10

1.0
Default

The value depends on the size of the optical sensor chip of the camera.

For full frame cameras the value is 1.0. Common values are between 1.5 to 1.6. The crop factor is the same factor that affects the focal length of your camera's objective. E.g. the focal length of an objective with a full frame camera is 50mm. With a camera that has a crop factor of 1.5 the effective focal length would be 1.5 x 50mm = 75mm.

Please note that for an accurate calculation the rounded figure (e.g. 1.5) is not precise enough, since two to four decimal places are required.

In order to ensure an exact smooth video and hotspot implementation, please do the following calculation for specific sensor dimensions of the camera used. The size of the optical sensor chip can be found in the cameras technical specifications.

362+242x2+y2=digitalCropFactor\frac{ \sqrt{36^{2}+24^{2}} }{ \sqrt{x^{2} + y^{2}} } = digitalCropFactor
info

36mm x 24mm = 35mm full frame reference
x and y = sensor dimensions im mm of your camera

Please find below the calculation for a Canon 7D camera (which has the sensor dimensions of 22.3mm x 14.9mm) as an example:

362+24222.32+14.92=1.6132\frac{ \sqrt{36^{2}+24^{2}} }{ \sqrt{22.3^{2} + 14.9^{2}} } = 1.6132

focalLength

(*)

float

focal length of the camera objective
(* Only available in FSI Viewer 360°)
since 17.10

50
Default

Determines the focal length of the camera objective in mm.

position, targetPosition

(*)

float

defines the position of the camera and the object in mm
(* Only available in FSI Viewer 360°)
since 17.10

postion(x,y,z) and targetPosition(x,y,z) can be used instead of distanceToTableCenter, heightAboveTable and targetHeightOffset. (see illustration below)



AttributeExplanation position (x,y,z)
xif image plane is in line with table center, x is 0
yheight of the target in reference to the table center
zthe distance between target and table center
AttributeExplanation targetPosition(x,y,z)
xif target is is in table center, x is 0
yheight of the image plane in reference to the table center
zthe distance between image plane and table center

distanceToTableCenter

(*)

float

distance from cameras image plane to the center of the turntable
(* Only available in FSI Viewer 360°)
since 17.10

0
Default

The straight distance from the cameras image plane to the center of the turn table in mm (see illustration below).

heightCamera

(*)

float

distance from image plane of the camera to the ground
(* Only available in FSI Viewer 360°)
since 17.10

0
Default

The straight distance from the optical center of your camera to the ground in mm (see illustration below).

heightTable

(*)

float

distance from top of the turn table to the ground
(* Only available in FSI Viewer 360°)
since 17.10

0
Default

The straight distance from the top of the turn table to the ground in mm (see illustration below).

targetHeightOffset

(*)

float

height of the camera target spot at the center of the turntable
(* Only available in FSI Viewer 360°)
since 17.10

0
Default

The height of the camera target spot at the center of the turn table in mm.

If you vertically target the table center the value is 0.0 mm. (see illustration below)

targetWidthOffset

(*)

float

horizontal offset of the camera target spot
(* Only available in FSI Viewer 360°)
since 17.10

0
Default

The horizontal offset of the camera target spot at the vertical the center of the turn table related to the center of the turn table in mm. If you target the horizontal table center (default) the value is 0.0 mm.

heightAboveTable

(*)

float

height of the image plane above the table
(* Only available in FSI Viewer 360°)
since 17.10

500
Default

Alternative parameter if heightCamera and heightTable are unknown. Only applies if both parameters are undefined.

Camera Positioning Illustration

AttributeDescription
hTParameter: targetHeightOffset
h1Parameter: heightCamera
h2Parameter: heightTable
dParameter: distanceToTableCenter

Usage of Robotic Camera Arm for rotations around the x-axis

armLength

(*)

float

length of the robot arm
(* Only available in FSI Viewer 360°)
since 17.10

Defines the length of the robot arm in mm; default value is the distance of the camera to the camera target. Only relevant if hotspots are used.

armJointPosition

(*)

float

determines
(* Only available in FSI Viewer 360°)
since 17.10

position of the arm joint
Default

Defines the position (x,y,z) of the robot arm joint in mm; default value is equal to the camera targetPosition. Only relevant if hotspots are used.

armAngleMeasureSetup

(*)

float

angle where distance from camera to target is measured
(* Only available in FSI Viewer 360°)
since 17.10

0
Default

Defines the angle from which distance from camera to target was measured in degrees. Only relevant if hotspots are used.

armStartAngle

(*)

float

defines the start angle
(* Only available in FSI Viewer 360°)
since 17.10

-90
Default

Defines the start angle of the rotation around the x-asis in degrees. Only relevant if hotspots are used.

armEndAngle

(*)

float

defines the end angle
(* Only available in FSI Viewer 360°)
since 17.10

90
Default

Defines the end angle of the rotation around the x-axis. Only relevant if hotspots are used.