Projects, Scans and Models

A project encompasses all 3D data obtained by scanning and postprocessing that can be saved to disk and accessed for later use. In addition, it contains command history and measurement results. For each project, a corresponding folder contains all project data and an A3D project file.

Note

Please note that, the project data is stored as .sst files for versions 16 and above, and may not be accessible.

Artec Studio can display project statistics. It includes information on number of scans, surfaces (frames), polygons, vertices and UV coordinates. To access this data, call a right-click menu for any Workspace object and select Project info. If you want to collate data on the selected scans with the total numbers for the project, first mark the required scans using with the flag.

Creating a Project

To start a new project, select the File → New project menu option. It is a best practice to save this project to a specific folder before you start scanning. If you start scanning with the Save scans directly to disk option enabled or import scans from Ray/Ray II, a temporary project is created in the Windows temporary folder or another directory if you specified one in Settings.

Saving a Project

Starting from version 16, Artec Studio automatically saves projects, and changes made to projects instantaneously. A newly created and yet manually unsaved project is automatically saved and stored in the default Temporary folder (see Temporary Folder). You can manually save the project in a preferred location using the File → Save project as… menu option or access it from the temporary folder as necessary.

Restoring a Project

While working, if Artec Studio crashes due to unexpected reasons, then the next time you open the application, it will prompt you to restore the project. It is specifically applicable for projects that were not been manually saved (or in other words, that were still in the default temporary folder).

Opening Project and Scans

To open an existing project, use the File → Open project menu option or hit Ctrl+O.

Note

Artec Studio versions 16 and above do not support SPROJ files. Projects created with earlier versions in the SPROJ file format, must be converted to the A3D format to be compatible.

By default, when you open a project, the application will restore it to the state in which it was last saved.

Note

When Artec Studio opens a project, it will determine the amount of available memory. If the scan you are trying to load requires more memory than is available in your system, the application will process it as an “unloaded” scan.

Opening an SPROJ file

In order to open an SPROJ file in Artec Studio (versions 16 and above), you will need to convert them to the A3D file format. On selecting an SPROJ file to open, Artec Studio will automatically prompt project conversion. Artec Studio will convert the selected project to A3D format and save it separately at the file location you specify. You will not lose your SPROJ project. The converted A3D project will, however, not contain the project’s command history.

Opening a Project from Leo

You can obtain projects from Leo via direct connection to the scanner or using an SD card installed in the device.

Connecting to Leo

1. Ensure that your Leo scanner and your computer are connected to the same network, and you authenticated using the same credentials

2. Click File → Import → Leo project (connect to scanner)

3. Wait for the application to show your Leo scanner. If no device is displayed or you are using a direct connection, follow the steps indented below:

   1. Click Connect by IP

   2. Specify IP address that you may find in Leo network settings

   3. Click Add

4. Select the required scanner and click Connect

5. Then using either LMB or ↑ and ↓ select the project that you want to load (Figure 94)

Note

You can import more than one project from Artec Leo at the same time, into a single Artec Studio project. To select multiple projects, use the shift key.

1. If the selected project contains HD raw data, you can import it by checking Import raw data.

2. To start HD reconstruction immediately after the import, perform the following actions:

   1. Check Launch HD reconstruction.

   2. Select the desired Point density, ranging from Normal to Extreme by adjusting the eponymous slider.

   The Point density determines the number of polygons per frame that is used for reconstructing the scanned surfaces from the raw data. With 1× the number of polygons is of the same order as for the SD resolution and 64× corresponds to ~5 million polygons per frame. Increasing the Point density results in higher degree of resolution, coverage, and detail, but requires more memory and time for the HD reconstruction.

   Important

   If Artec Studio evaluates your computer’s resources as insufficient for the selected Point density, then the warning is displayed that the HD reconstruction can take up to several hours on your computer. For information on resources requirements, see the Using HD mode section in System Requirements.

3. Click Import.

If you have enabled the HD reconstruction, it will start immediately after the data uploading finishes.

Wait for scans to appear in the Workspace panel.

The imported projects and scans will be automatically grouped—the group with the project name will be divided into subgroups of scans (see here about grouping). The imported HD scans will have an “HD” mark in their names, for example: Leo HD Scan 1.

If the scans contain information on supporting surface and the corresponding option is enabled in Settings, Artec Studio will also launch base removal.

Note

You can import HD projects from Artec Leo multiple times with different values of Point density.

Figure 93 Scanner list and the Connect by IP button.

Figure 94 Dialog for selecting Leo projects to import.

Using SD Card

If you want to open Leo scans without having to connect to the device, use the following method:

1. On Leo, first copy a project to SD card.

2. Then insert the card into the computer with installed Artec Studio.

3. Click File → Import → Leo project

4. Browse for the required project folder

5. Select the folder containing Leo project and click Select folder. Import will start.

Note

HD data from Artec Leo can be exported to an SD card with the .leo format.

Importing Models and Scans

Importing is another way to load data into Artec Studio in place of capturing or opening a project. You can import scan files created in earlier versions of the software, individual frames, point cloud data, as well as CAD models in the following formats:

SCAN	Artec 3D scan format
PLY	Stanford polygon file format
STL	Stereolithography file format
VRML	VRML file; actual extension is *.wrl
OBJ	Wavefront OBJ file format
PTX	Disney per-face texture mapping format, Artec Ray point cloud
C3D	Artec Ray original point cloud
BTX	Artec Ray/Ray II point cloud
STEP, STP	(CAD format) Standard for the Exchange of Product model data
IGES, IGS	(CAD format) Initial Graphics Exchange Specification
X_T	(CAD format) Parasolid XT data format
SAT	(CAD format) Standard ACIS text format
E57	Artec Ray/Ray II point cloud

Importing Scans, Meshes or Point Clouds

To import a file, use the File → Import → Scans, meshes or point clouds menu option or hit Ctrl+I . Next, select a file for importing. You can also drag and drop a file into the main Artec Studio window, or just double click on it.

Note

The import process runs in the background, so you can continue working with the scans you’ve already loaded. The progress indicator for the import operation will appear at the bottom of the main application window. To abort the operation, click Cancel in the bottom-right corner.

Artec Studio will import frame files as individual single-frame scans. After importing each scan, the application calculates the key frames for any scan that contains more than one surface. Also, the application will check the surfaces for defects when the appropriate setting is enabled (see Surface-Consistency Detection During Import). If it finds defects, it will show a dialog with a list of defective surfaces once the import operation is complete. You can then choose which ones should be corrected.

Importing Ray II scans

To import Ray II scans, use the File → Import → Ray II scans menu option. Next, select a Ray II project (*.artec) file . You can also drag and drop a file into the main Artec Studio window.

Now, mark the checkboxes of the desired scans to import, and then click Import button.

Figure 95 Dialog for importing Ray II scans from the selected project (*.artec).

Note

Wait until all selected scans are imported. Imported scans will appear in the Workspace panel.

Figure 96 The progress indicator for imported scans.

Figure 97 Imported Ray II scans in the Workspace panel.

Before importing scans, click the settings icon and make sure the Search for spheres option is not selected. Disabling it will make the import faster.

Figure 98 Import options

To detect spheres for further Global registration and alignment:

• Mark the checkboxes of desired scan in the Workspace

• Navigate to the Tools panel → Spheres detection

• Click the icon

• Specify the spheres diameter by entering the value in the Diameter field

• Click the Run button to apply Sphere detection algorithm

Figure 99 Spheres detection pop-up

Importing CAD models

You can import CAD models created in different CAD programs and saved to the following formats: STEP, STP, IGES, IGS, X_T, SAT.

To import a file, use the File → Import → CAD models menu option. Next, select a file for importing. You can also drag and drop a file into the main Artec Studio window, or just double click on it.

Figure 100 Imported CAD model.

Exporting Models, Scans and Point Clouds

When you want to store data for future processing, the best approach is to save the project as an A3D file or to export the data to the SCAN format. Any Artec Studio version can open the latter format. If you plan to use the data in other applications, however, you should save scans and individual frames in another format.

You may also need to perform one of the following tasks:

Export one or more scans	File → Export → Scans or use the Export option in the context menu	Doing so will save all frames to folders with names that match the corresponding scan names. An exception is the SCAN format; in this case, Artec Studio not only stores the frame-by-frame scan structure, but it does so in a single file.
Export a single surface	File → Export → Meshes- or use the Export option in the context menu	It works for models. If you, however, marked several scans, models or frames using the button, Artec Studio will suggest merging them.
Export Ray/Ray II scans	File → Export → Point clouds	It works for point-cloud scans from Ray/Ray II.

Exporting Scans

To export scans:

1. Mark any scans you want to export using the button.

2. Right click and select the Export → Scans option, or select the File → Export → Scans command.

3. Click the … button to open and specify the destination folder.

4. Select Scan export format using the eponymous dropdown list.

5. If the selected format supports textures, also specify the texture format.

6. Select the Apply transformation checkbox, or leave it cleared (for more information, consult Understanding How Artec Studio Applies Transformations).

7. Click OK.

ply	Stanford polygon file format
stl	Stereolithography file format
obj	Wavefront OBJ file format
wrl	VRML file; actual extension is *.wrl
x	Direct X file format
scan	Artec 3D scan format
obc	OBC point-cloud file

Note

The export process for models and scans runs in the background, so the application will allow you to continue working with the scans. The progress indicator for the export operation will appear at the bottom of the main application window. To abort the operation, click Cancel in the bottom-right corner.

Exporting Meshes (Models)

You can export a single model (mesh) or several models at a time. Models can be merged before export or exported separately.

To export a mesh or multiple meshes:

1. Mark one or more models using or select frames in the scan by clicking on them while holding the Ctrl key.

2. Right click and select the Export → Meshes option, or select the File → Export → Meshes command. A dialog window will appear (Figure 101).

   Tip

   Ctrl+Shift+E hot key does the same.

3. Click … and specify the destination folder.

4. Use one of the following options for the file names:

   • Leave the field blank and the exported meshes will get the same names as their corresponding models in the Workspace panel.

   • Enter a custom export name. If you are going to export multiple meshes, this name will be used as a mask. For example, if you specify ‘Model’ as the custom export name, then the meshes will be named as Model1, Model2, and so on.

5. Select an appropriate mesh format from the Model export format dropdown list 1 (see the description of available formats below).

6. If the model has texture and the selected mesh format supports it, choose an appropriate texture export format from the eponymous dropdown list (see Storing and Exporting Color Information for details).

7. To merge the models into a single mesh before exporting, select the Merge models checkbox. Otherwise, each model selected in the Workspace panel will be exported to a separate file.

8. To move the models to origin before exporting, select the Move to origin checkbox.

9. Click OK.

Figure 101 Dialog for exporting meshes.

PLY	Stanford polygon file format (standard and with the support for vertex color)
STL	Stereolithography file format
VRML	VRML file (1.0 and 2.0); actual extension is *.wrl
OBJ	Wavefront OBJ file format
ASC	Point cloud 3D format
AOP	American Academy of Orthotists and Prosthetists file format
PTX	Walt Disney Ptex: mesh with per-face texture mapping
X	Direct X file format (binary and text)
XYZRGB	XYZRGB file format
E57	ASTM E57 3D file format (with the support for vertex color)

1

If you type an extension in the file name field, application will use it rather than the selected mesh file format.

See also

Model Placement

Exporting CAD objects

You can export CAD primitives created in Artec Studio to the following formats: STEP, IGES, X_T.

To export CAD primitives:

1. Mark one or more CAD object using flag or Workspace menu commands.

2. Select the File → Export → CAD objects command.

3. Specify the destination folder, enter the file name, and select the appropriate format from the dropdown list.

4. Click Save.

Exporting Point Clouds

You can export point-cloud scans obtained from Ray and imported from Ray II to either of the following formats (respective units are given in the third column):

PTX	Leica Geosystems Cyclone Point Cloud. Important! Don’t confuse it with Disney Ptex.	Meter
XYZ	XYZRGB file format	Specified in settings
BTX	Artec Ray/Ray II point cloud; various versions (v2, v3, v5, v6).	Micron
E57	Artec Ray/Ray II point cloud	Meter

1. Mark one or more point-cloud scans using flag in Workspace. Ensure that you have selected a point-cloud scan by double-clicking its name: the panel must show point-cloud properties.

2. Select File → Export → Point clouds.

3. Specify the destination folder and required format and click Save.

Merging Sections

When exporting to PTX, ensure the Export point clouds to PTX with merged sections checkbox is marked in the Artec Studio settings. This option merges all sections (selections made during scan with Ray scanner) so that third-party software products can open the exported file.

Understanding How Artec Studio Applies Transformations

Artec Studio offers two options for exporting surfaces:

1. Store surfaces using the scanner coordinates and create XF text files that contain the coordinates calculated during registration. To use this approach, clear the Apply transformations checkbox.

2. Store surfaces that are relocated to the positions calculated during registration. In this case, XF files contain no relevant data. To use this approach, select the Apply transformations checkbox.

Special Aspects of Scan Placement

In most cases when you’re exporting a scan to a common 3D-graphics format, you should select the Apply transformations checkbox. By doing so, you instruct third-party applications to display surfaces in the same way that Artec Studio does: that is, with the origin at the center of mass. If for some reason you need to store a scan in the scanner’s coordinate system—in other words, with surfaces located at a distance from the origin that is equal to scanner’s operating range—clear the Apply transformations checkbox.

Technically, Artec Studio saves scans in the scanner’s coordinate system, but it displays them in a user-friendly manner by placing the origin at the center of mass. The actual positions of surfaces calculated during registration are stored in text (XF) files. Therefore, when you’re importing files using Artec Studio, it makes no difference whether the checkbox was cleared when Artec Studio exported them. It does make a difference, however, for third-party applications that cannot read XF files simultaneously with 3D geometry.

Storing and Exporting Color Information

You can transfer color information for 3D surfaces in three ways. The most common is through a texture using a separate bitmap file (see Applying Texture (Procedure)). Another option is to save color information in each vertex of a mesh. The third is to assign a small textured fragment to each polygon. The two latter methods produce no texture files.

Colors stored in a vertex are blended throughout the polygon. As a result, you should avoid oversimplifying the exported mesh; otherwise, colors blended over a large face may fail to render true texture information.

Table 8 Formats that support color-information transfer.

Texture stored as a bitmap	PLY, VRML (*.wrl), OBJ, X
Model file contains separate texture for each face	PTX
Formats that support vertex color	plyVC, XYZRGB, E57

When exporting texture as a bitmap image, you can select one of the following formats: PNG, BMP or JPG. PNG format provides the best quality for a given file size thanks to its lossless image compression. JPG is the most compact format.

Exporting Target Coordinates

If you scan while in the Targets tracking mode using only Artec scanners, you can save an OBC file containing the target coordinates. Once you finish scanning, run Global registration, then do the following:

1. Use the button to mark any scans that you captured without having uploaded an OBC file.

2. Select the File → Export → Scans command.

3. Click the … button to open and specify the destination folder.

4. Select obc from the Scan export format dropdown list.

5. Click OK. The targets.obc file will appear in the folder you specified.

For more information on the OBC file structure, consult the FAQ.

Exporting to Leios

Artec Studio enables you to export files to Leios by accessing the File menu if the Leios software is already installed on your computer.

1. Select a model in the Workspace panel

2. Open File → Export to Leios

3. Then, in Leios, select millimeters as the length unit for the imported files.

Exporting to Geomagic Design X

Polygonal models created in Artec Studio are insufficient for most design needs. Geomagic Design X (formerly Rapidform XOR) is purpose built to create manufacturing-ready CAD model’s directly from meshes.

To export a model,

1. Make sure Geomagic Design X is installed on your computer

2. In the Workspace panel, mark one model using the flag

3. Select the Export to Design X command from the File menu

4. Wait for the model in OBJ format to open in the reverse-engineering system.

Figure 102 Model exported to Geomagic Design X

Exporting to SolidWorks

Artec Studio allows you to export models, CAD primitives and cross-sections to SolidWorks. You can export CAD primitives, cross-sections and models directly to SolidWorks without any third-party plug-ins. It is also possible to export one or multiple objects into a single file in SolidWorks.

To export objects,

1. Make sure SolidWorks is installed on your computer

2. In the Workspace panel, mark one or more objects using the flag

3. Right-click and select the Export to Solidworks option from the context menu

4. Alternatively, use the Export to SolidWorks command in the File menu

5. Wait for the selected objects to open in the CAD system as one single file

6. In order to export each object as a separate instance, export them one by one

Exporting to Control X

Control X is a 3D quality control and dimensional inspection software with which you can capture and process the data from 3D scanners to measure and inspect quality. With Artec Studio 17, you can export models and target clouds to Control X, or directly inspect them and generate inspection results.

To inspect a model or target cloud in Control X,

1. Make sure Control X is installed on your computer

2. In the Workspace panel, right-click on the model or target cloud that you want to inspect

3. Select the Inspect in Control X option from the dropdown menu

4. Wait for it to directly open in Control X and generate the inspection report

Exporting to Artec Cloud

Artec Cloud is an easy-to-use collaborative platform that makes your 3D scan data available to you and your team, anywhere.

The Artec Cloud interface is now integrated into Artec Studio. You can view, download and upload projects and fusions in Artec Cloud, directly via Artec Studio. This enables you to quickly share your projects, without any external devices or without the need to open Cloud in a browser. It is possible to upload projects stored in your PC, upload newly acquired meshes, generate sharable links and automatically create Artec Cloud accounts, that are free to use.

Sharing projects:

To open and view projects in your Artec Cloud account, open Home panel → Artec Cloud. Each project contains its status info on the preview image. To upload a new project from your PC, navigate to the Recent tab in the Home panel, click on the upload () icon of the desired project, and then click on the Upload button. If you’re a first time user of Artec Cloud, the window prompts you to create a free account.

Figure 103 Upload a project from Artec Studio to Artec Cloud

Once uploading completes, the project preview image will have the uploaded () icon.

To sync the shared project between Artec Studio and Artec Cloud, you have three following states:

• Project updated locally - click on the synchronize () icon to upload local updates of the project to Artec Cloud. You can review changes by clicking the Review changes button. Review changes modal will display the list of changes made with this project in Artec Studio.

Figure 104 Review changes before uploading them to Artec Cloud

To upload changes to Artec Cloud, click the Upload to Cloud button.

• Project updated in Artec Cloud - click the cloud icon (), and then click the Check updates button. Once checking updates completes, you can review updates by clicking the sync icon (), and then clicking Review changes button.

Figure 105 Review changes before downloading from Artec Cloud

To download changes from Artec Cloud, click the Download from Cloud button.

• Project updated both locally and in Artec Cloud - click the sync icon with a dot (). Sync popup will show you how many changes have been made in Artec Studio and Artec Cloud. Click the Review changes button to see the difference.

Figure 106 Review changes made either in Artec Studio and Artec Cloud

Here you have the following options to resolve conflict:

• Get changes from Cloud - All changes made in Artec Studio and not uploaded to Artec Cloud will be overwritten by those from Artec Cloud.

• Upload changes to Cloud - All changes made in Artec Cloud and not downloaded from there will be overwritten by those from Artec Studio and uploaded to Artec Cloud.

• Split changes into two projects - A copy of the conflict project will be created and displayed in the Recent projects tab, the original project will get all changes from Artec Cloud. From now on, these are two separate projects.

Alternatively, you can click the Resolve conflict button on the Sync popup instead of reviewing changes in detail. There, you can select the same options for resolving conflict described above.

Sharing fusions:

• To upload a fusion that is currently open on Artec Studio, select the fusion, go to File → Export → Fusion to Artec Cloud. Alternatively, right-click on the fusion in the Workspace panel, and select the Upload to Cloud option from the drop-down menu.

History of Project Changes

Artec Studio stores all data changes, and you can later undo any unnecessary changes. You can see the saved changes and their use of memory in the History panel. To open the panel, click the button at the bottom left or hit Ctrl+H

Figure 107 The History panel.

Click on the desired operations in the list to undo or redo them. Operations can be undone (redone) only sequentially, i.e. you cannot skip any of them selectively.

To quickly undo or redo the changes stored in the project history, you can also use the following options:

• Undo:

  • Hit Ctrl+Z or

  • Click in the lower-left corner of the main window

• Redo:

  • Hit Ctrl+Y or

  • Click in the lower-left corner of the main window

When you save a project, Artec Studio stores 3D data together with the history of changes. You cannot limit the maximum length of command history. The Clear command history button clears the command history, and thus frees up RAM, and makes the undo operation for the most recent changes unavailable. Additionally, in the Clear History window, you can choose to Keep the last’n’ actions, and clear the rest. Simply specify the number of actions you would like to keep, and confirm. To clear the history, you can use the Edit → Clear history menu option in the main window or hit Ctrl+Alt+H.