Image management

Project

images/download/attachments/191398825/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

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 cubeface.


Set of images

Perspective and spherical images can be stored either individually or grouped in a set of images.

In a set of images, images are also grouped by position. These positions are displayed in the scene like any scan position (Image Navigation Toolbar) and these positions are the access point to display images through the 3D scene.

Image display


Position display in the 3D scene

Full display in the 3D scene

Display in a 2D layout

Spherical (individual or within an image set)

Activate the display of positions (Image Navigation Toolbar).

This display can be toggled object per object using the treeview.

  • Double click a position to enter the image navigation mode where images are displayed like Go to camera viewpoint (Refer to Image Navigation Toolbar).

  • Use Go to camera viewpoint from the treeview to go the (first) position.

  • Individual images: use Image Preview from the ribbon or the treeview.

  • Image set: double click an image set from the treeview to display the images individually. You will also be able to select which images to use for texturing. Refer to Edit Image Set.

Perspective (individual or within an image set)

Ortho-image

images/s/j1yiok/8803/kx433e/_/images/icons/emoticons/error.svg

Use Go to camera viewpoint from the treeview.

Use Image Preview from the ribbon or the treeview.

Unknown

images/s/j1yiok/8803/kx433e/_/images/icons/emoticons/error.svg

images/s/j1yiok/8803/kx433e/_/images/icons/emoticons/error.svg

Display from the camera viewpoint (image navigation or "go to camera viewpoint")

This display will use external and internal parameters. Consequently, you can use the image to draw objects.

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 or using Edit Mask.

Note that:

  • images imported in 2022.0 and previous versions haven't got masks.

  • 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