Image management

Project

images/download/attachments/173278542/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).

images/download/thumbnails/173278542/image_perspective.png

Ortho-image

Similar to a raster map (contrary to perspective).

You can create such images using Extract OrthoImage.

images/download/attachments/173278542/image_ortho.png

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.

images/download/thumbnails/173278542/cubface.png

Spherical image

Also called pano(ramic). This image is equivalent to a cubeface.


images/download/attachments/173278542/spherical_image.png

Image display

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

this display is only suitable to navigate in your project.

images/download/attachments/173278542/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/173278542/2Dimage%2B3Dscene.png

How to import data?


  • The maximum number of pixels to import is 2^30, which is about 1 073 millions.

  • 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

  • e57 (perspective and spherical images)

Edit Image thanks to Save button

excam + incam

Extract OrthoImage

JPG, BMP, PNG, TIF + world files

AutoCAD (through Extract OrthoImage)

ortho-image

Script (refer to SImage documentation)

JPG, BMP, PNG, TIF + world files