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

Descriptiondepends on the size of the optical sensor chip of the camera
Syntaxfloat
Default1.0
ContextFSI Viewer

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.





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


 


focalLength

Descriptionfocal length of the camera objective
Syntaxfloat (in mm)
Default50
ContextFSI Viewer

The focal length of the camera objective.


position, targetPosition

Descriptiondefines the position of the camera and the object
Syntaxfloat (in mm)
Default 
ContextFSI Viewer

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




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


Explanation targetPosition(x,y,z)

xif target is is in table center, x is 0
yheight of the target in reference to the table center
zthe distance between target and table center


distanceToTableCenter

Descriptiondistance from cameras image plane to the center of the turntable
Syntaxfloat (in mm)
Default0
ContextFSI Viewer

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


heightCamera

Descriptiondistance from image plane of the camera to the ground
Syntaxfloat (in mm)
Default0
ContextFSI Viewer

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


heightTable

Descriptiondistance from top of the turn table to the ground
Syntaxfloat (in mm)
Default0
ContextFSI Viewer

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


targetHeightOffset

Descriptionheight of the camera target spot at the center of the turntable
Syntaxfloat (in mm)
Default0
ContextFSI Viewer

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

Descriptionhorizontal offset of the camera target spot
Syntaxfloat (in mm)
Default0
ContextFSI Viewer

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

Descriptionheight of the image plane above the table
Syntaxfloat (in mm)
Default500
ContextFSI Viewer

Alternative parameter if heightCamera and heightTable are unkown. 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

Descriptionlength of the robot arm
Syntaxfloat (in mm)
Default 
ContextFSI Viewer

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


armJointPosition

Descriptionposition of the arm joint
Syntaxfloat (in mm)
Default 
ContextFSI Viewer

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


armAngleMeasureSetup

Descriptionangle where distance from camera to target is measured
Syntaxfloat (in degrees)
Default0
ContextFSI Viewer

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


armStartAngle

Descriptiondefines the start angle
Syntaxfloat (in degrees)
Default-90
ContextFSI Viewer

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


armEndAngle

Descriptiondefines the end angle
Syntaxfloat (in degrees)
Default90
ContextFSI Viewer

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