Project
Image types
Image display
How to import data?
How to complete data (External and Internal parameters)?
How to share georeferencing?
- Ortho-Image: World files
- Perspective: Excam and Incam files
How to texture?
Texturing masks
How to export data?

Project

images/download/attachments/137619390/images.png

Pictures folder must follow the .3dr when you share your project.
Temp folder stores temporary images which are necessary while the project is open.

Image types

Type	Comment	Example
Unknown/Abstract	This is the default type when the type is unknown. Use Edit Image to set the image type.
Perspective	Type for pinhole images (usual photography from a camera).
Ortho-image	Similar to a raster map (contrary to perspective). You can create such images using Extract OrthoImage.
Cubeface	They are a set of 6 images on a cube (images share the same position). This object is not created by Cyclone 3DR, but are either imported as 6 independent images or as a spherical image.
Spherical image	Also called pano(ramic). This image is equivalent to a cubface.

Image display

From the 3D scene, only external parameters are read:

this display is only suitable to navigate in your project.

images/download/attachments/137619390/3Dimage%2B3Dscene.png

From the treeview, you can Go to camera viewpoint.

This will use external and internal parameters (as long as you keep the same position).

Thus, you can make measurements on the image.

images/download/attachments/137619390/2Dimage%2B3Dscene.png

How to import data?

Images stored on your local or remote drive: Import
Images stored in CloudWorx clouds (jsa, lgs): Convert Project (after opening the corresponding files)
Images stored in a textured mesh: Extract Texture
Images stored on your Leica BLK360: Load from BLK

Refer to SImage, SSurveyingFormat and SCwCloud classes to import images through a script.

How to complete data (External and Internal parameters)?

	Perspective	Ortho-Image	Spherical
Estimate Pose	Internal and/or External	External	External
Edit Image	Internal and/or External	External	External
Calibrate Camera	Internal	-	-
Script	Internal and/or External	External	External

How to share georeferencing?

Ortho-Image: World files

This definition follows the ESRI standard (refer to word files).

Perspective: Excam and Incam files

These files are related to perspective images

External parameters, parameters which define the point of view:

position,
orientation.

Internal parameters, data collected from a camera calibration:

sensor size,
focal length,
PPA,
PPS,
distorsions.

3DReshaper camera external parameters
X = 1.74146e+06
Y = 2.29867e+06
Z = 696.503
#Orientation is given with Euler angles in radians
Omega = -0.659887
Phi = 0.884306
Kappa = 2.46287

3DReshaper camera internal parameters
WIDTH=0.04896000027656555
HEIGHT=0.03672000020742416
PIXELSIZE=9.000000318337698e-06
PIXELRATIO=1
PPA=-2.499999936844688e-05; -0.0002979999990202487
PPS=-1.082631133721602e-06; 3.390730833438562e-05
FOCAL=0.03512400016188622
K0=0
K1=0.062675787745
K2=-0.30013658211
K3=0.29014370032
K4=0
K5=0
K6=0
P1=0.00014974133558
P2=-7.914469536399999e-06

How to texture?

You can texture and edit thanks to commands below:

Texturing masks

A mask is a black and white copy of the image saved in the same folder that can be displayed using Image Preview. Black areas correspond to ignored areas when texturing with the Smart Texture command; w hite areas will be used when texturing.

These masks are generated automatically while importing images.

Note that:

images imported in 2022.0 and previous versions haven't got masks: re-import them.
the mask can be corrupted (wrong file path, mask image with another dimensions...).

How to export data?

Commands	Formats
Export	obj (textured mesh) bmp, jpg, png + excam + incam
Edit Image thanks to Save button	excam + incam
Extract OrthoImage	JPG, BMP, PNG, TIF, GIF + world files
Send to AutoCAD (through Extract OrthoImage)	ortho-image
Script (refer to SImage documentation)	JPG, BMP, PNG, TIF, GIF + world files