3D Mapping parameters

All parameters of the 3D scene are displayed at the left hand side of the 3D Mapping dialoge (Model Rendering Definition Adjustment).

Parameters explained

3D model

Name	Select your 3D model from the list of created custom content spaces
Texture	If there is a custom texture that you would like to apply to your model, click ‘Select’ to browse an image from the disk. The default models created by VIOSO will have the texture file automatically created and filled in this field.
Quality	slider to increase/decrease the preview quality of the rendered texture

Camera

Name	Name of the camera. from V5.3+ it is automatically selected
Type	Type of the lens (Perspective or Fisheye)
Resolution	Resolution used by the camera during the calibration, if you did any cropping or ROI define here the final pixel space used. From V5.3+ it is automatically detected
FOV	Refer to the lens specifications, Values are usually for perspective (50-110) & fisheye (180-185)
Border px	If the camera has a lens that crops some areas of the sensor – fill out the dimension of the border of cropped pixels. It’s most frequently used with fish eye lenses – around 250px
Ratio	Resolution X/Y , usually automatically calculated

Alignment

This is the most important setting where you put the measured pose of the camera from the origin of the screen.

We recommend to set the Alignment always to relative, so that all parameters are applied to the camera object directly.

Origin:	Translation values: (Y up, X right, Z backward)
Rotation	Rotation values (X pitch, Y yaw, Z roll)

The translation and rotation are defined in the system coordinates of the 3D model on screen, where the camera pose is originally as shown below:

If you created the 3D model from the VIOSO software, it will be in the right hand system, and the (0,0,0) origin is located:

• Flat plane: Bottom center line.

• Cylinder: At the center of bottom circumference.

• Panadome/Dome: At the center of the sphere.

Example: Top-down fisheye camera on a panadome screen:

Fisheye calibration camera view

The camera is mounted on top of the screen pointing down, it is rotated 90 degrees counterclockwise around axis X, meaning rotation x will be -90 or 270.

Our screen is a panadome and the camera is mounted on top of the screen in the center,meaning that it is located at some height relative to center of the sphere (origin) -> Y translation.

By adding these parameters you will start to see grey texture on the projection screen. This is the real-time rendered image onto the UV texture of the 3D model you have introduced to the system.

To find the best values to position your texture and align it onto your real screen, use all the camera position parameters and border px parameter.

• You can type the values in fields from the keyboard. You can use the scroll-wheel or you can use the keyboard arrows.

• If you hold SHIFT and change the value in the field, it will change with bigger steps (coarse).

• If you hold CTRL and change the value in the field it will change with smaller steps (fine).

Align the testing grid as good you can by carefully tweaking all of the values mentioned above. It is natural that this procedure takes a time.

It is recommended to position the grey test picture in a way that it overshoots the screen a little bit, so that you get rid of the aliased edge of the texture and later mask it out.

If you did your best and the alignment is still not perfect, you can use the warping tools in the VC grid of the main window (Refer to the 2D Warp chapter to learn more)-

Note that warping will be still in camera perspective, as the calibration is not converted yet.