3D Mapping parameters
Last updated
Last updated
All parameters of the 3D scene are displayed at the left hand side of the 3D Mapping dialoge (Model Rendering Definition Adjustment).
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.
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.
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.
