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 | |
|---|---|
| Description | depends on the size of the optical sensor chip of the camera |
| Syntax | float |
| Default | 1.0 |
| Context | FSI 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 | |
|---|---|
| Description | focal length of the camera objective |
| Syntax | float (in mm) |
| Default | 50 |
| Context | FSI Viewer |
The focal length of the camera objective.
position, targetPosition | |
|---|---|
| Description | defines the position of the camera and the object |
| Syntax | float (in mm) |
| Default | |
| Context | FSI 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) | |
|---|---|
| x | if image plane is in line with table center, x is 0 |
| y | height of the image plane in reference to the table center |
| z | the distance between image plane and table center |
Explanation targetPosition(x,y,z) | |
|---|---|
| x | if target is is in table center, x is 0 |
| y | height of the target in reference to the table center |
| z | the distance between target and table center |
distanceToTableCenter | |
|---|---|
| Description | distance from cameras image plane to the center of the turntable |
| Syntax | float (in mm) |
| Default | 0 |
| Context | FSI Viewer |
The straight distance from the cameras image plane to the center of the turn table in mm (see illustration below).
heightCamera | |
|---|---|
| Description | distance from image plane of the camera to the ground |
| Syntax | float (in mm) |
| Default | 0 |
| Context | FSI Viewer |
The straight distance from the optical center of your camera to the ground in mm (see illustration below).
heightTable | |
|---|---|
| Description | distance from top of the turn table to the ground |
| Syntax | float (in mm) |
| Default | 0 |
| Context | FSI Viewer |
The straight distance from the top of the turn table to the ground in mm. (see illustration below)
targetHeightOffset | |
|---|---|
| Description | height of the camera target spot at the center of the turntable |
| Syntax | float (in mm) |
| Default | 0 |
| Context | FSI 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 | |
|---|---|
| Description | horizontal offset of the camera target spot |
| Syntax | float (in mm) |
| Default | 0 |
| Context | FSI 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 | |
|---|---|
| Description | height of the image plane above the table |
| Syntax | float (in mm) |
| Default | 500 |
| Context | FSI Viewer |
Alternative parameter if heightCamera and heightTable are unkown. Only applies if both parameters are undefined.
Camera Positioning Illustration
| Attribute | Description |
|---|---|
| hT | Parameter: targetHeightOffset |
| h1 | Parameter: heightCamera |
| h2 | Parameter:heightTable |
| d | Parameter: distanceToTableCenter |
Usage of Robotic Camera Arm for rotations around the x-axis
armLength | |
|---|---|
| Description | length of the robot arm |
| Syntax | float (in mm) |
| Default | |
| Context | FSI 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 | |
|---|---|
| Description | position of the arm joint |
| Syntax | float (in mm) |
| Default | |
| Context | FSI 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 | |
|---|---|
| Description | angle where distance from camera to target is measured |
| Syntax | float (in degrees) |
| Default | 0 |
| Context | FSI Viewer |
Defines the angle from which distance from camera to target was measured. Only relevant if hotspots are used.
armStartAngle | |
|---|---|
| Description | defines the start angle |
| Syntax | float (in degrees) |
| Default | -90 |
| Context | FSI Viewer |
Defines the start angle of the rotation around the x-asis. Only relevant if hotspots are used.
armEndAngle | |
|---|---|
| Description | defines the end angle |
| Syntax | float (in degrees) |
| Default | 90 |
| Context | FSI Viewer |
Defines the end angle of the rotation around the x-axis. Only relevant if hotspots are used.