Project Operations

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 measurement results (see Measurement Tools). For each project, a corresponding folder contains all project data as well as a project file describing the structure of that data.

Creating a Project

We recommend creating and naming a project before you start scanning (see Scanning Procedure). You can create a new project using the FileNew project menu option. Click the tlb_new_project button at the top of the Workspace panel, or use the shortcut Ctrl + N. Then, in the subsequent dialog (see Figure 73), enter the project name and specify the path for the folder to which you want to save your project. While you’re working with a given project, the header of Workspace window will display its name.

4_save_project.png

Figure 73 Project-creation dialog.

Creating a project is unnecessary if you don’t plan to process or otherwise use the scanned material in a future session.

Saving a Project

Note

Artec Studio saves data incrementally, meaning that if you save an existing project, the application will only save newly changed or added data.

You can save your project using the FileSave project menu option, by clicking tlb_save_project at the top of the Workspace panel or by hitting Ctrl + S. For unsaved projects, a project-creation dialog will appear (see Creating a Project). For projects that allocate more than 6 GB of memory, another dialog [1] will prompt you to compress project data using the maximum settings (see Data-Compression Level). To save project to a file compatible with all Artec Studio versions using medium compression settings, click Skip. You can reconvert the project with the maximum compression to ensure full compatibility with the previous version of software. To this end, move the slider to the middle or the left position and save the project again.

[1]You can also disable this dialog: select the corresponding checkbox either in the message or in the Pefromance tab of the application’s Settings.

Opening a Project

To open an existing project, use the FileOpen project menu option, click tlb_open_project at the top of the Workspace panel or hit Ctrl + O.

Note

Files from Artec Studio versions 8, 9, 10 and 11 are mutually compatible. Earlier versions, however, may be unable to open projects saved in a later version using the SPROJ format.

By default, when you open a project, the application will restore it to the state in which it was last saved (the three scan-loading states include loaded, unloaded and key frames only—see Selectively Loading Project Data). To load faster by opening the project without loading any scans, use the Open project (scans not loaded) dropdown menu option under the tlb_open_project button. Alternatively, use the same option from the File menu or hit Ctrl + Shift + O.

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.

Exporting Models and Scans

When you want to store data for future processing, the best approach is to save the project as an SPROJ 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.
Select the Export scans... command. 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.
The best approach here is to select the Export meshes... command. If you marked several scans, models or frames using the eye button, Artec Studio will suggest merging them.

Exporting Scans

To export scans:

  1. Mark any scans you want to export using the eye button.
  2. Select the Export scans... command in the File menu or the corresponding dropdown menu option of tlb_save_project in the Workspace panel.
  3. Click the ... button to open and specify the destination folder.
  4. Select Scan export format using the eponymous dropdown list (see Figure 74).
  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.

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)

To export a mesh:

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

  2. Select the Export meshes... command in the File menu or in the dropdown menu of the tlb_save_project button in the Workspace panel.

    Tip

    Ctrl + Shift + E hot key also works.

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

  4. Click Save.

  5. If the model has texture and the format supports it, specify the Texture export format in the new dialog (see Storing and Exporting Color Information).

  6. Click Export.

[2]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

4_export_formats.png

Figure 74 Formats available for each command as well as for both commands.

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 5 Formats that support color-information transfer.
Texture stored as a bitmap PLY, VRML (*.wrl), OBJ, X, e57
Model file contains separate texture for each face PTX
Formats that support vertex color plyVC, XYZRGB

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 eye button to mark any scans that you captured without having uploaded an OBC file.
  2. Select the Export scans... command from the File menu, or select the corresponding dropdown menu option of tlb_save_project in the Workspace panel.
  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 FileExport to Leios
  3. Then, in Leios, select millimeters as the length unit for the imported files.
4_leios_model.png

Figure 75 Model exported to Leios

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 models 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 eye 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.
_images/4_design_x.jpg

Figure 76 Model exported to Geomagic Design X

Exporting to SolidWorks

Artec Studio allows you to export models to SolidWorks by using third-party plug-ins. It supports the following plug-ins:

  • Geomagic for SolidWorks
  • DezignWorks for SolidWorks

Note

If you have installed both plug-ins, Artec Studio will use Geomagic for SolidWorks.

To export a model,

  1. Make sure SolidWorks and either of the plug-ins are installed on your computer
  2. In the Workspace panel, mark one model using the eye flag
  3. Select the Export to SolidWorks command from the File menu
  4. Wait for the model to open in the CAD system.

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, as well as individual frames, in the following formats: PLY, STL, VRML, OBJ and PTX. To do so, use the FileImport... menu option, Ctrl + I or the dropdown menu option for the tlb_open_project button. 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.

4_import_incons.png

Figure 77 Dialog for selecting surfaces to correct.

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 (see Figure 77).

History of Project Changes

Artec Studio stores all data changes, so you can undo them later. To undo an operation, click the undo button in the Workspace panel, or click redo to perform the previously undone operation. You can also use Ctrl + Z or Ctrl + Y. Use the dropdown menu buttons undo or redo, respectively, to undo or redo several operations at once.

When you save a project, Artec Studio stores 3D data together with the history of changes. You can select the maximum length of the history in the settings window under the Performance tab (see Command History). In addition, the Compact memory button allows you to save the history of changes on a local drive and thus free up RAM. Also, the Clear command history button clears the change history, likewise freeing up RAM, and makes the undo operation for the most recent changes unavailable. To clear the history, you can use the EditClear history menu option in the main window or hit Ctrl + Alt + H.

Selectively Loading Project Data

When working with a large data set, you may often find it necessary to free up RAM without deleting any of the project data. To this end, Artec Studio implements a mechanism for selectively loading scans. You can move to disk any currently unused scans to free up extra RAM. If a particular algorithm later requires any of the unloaded scans, the application will automatically reload them. Frames that are not currently loaded into the memory won’t show in the 3D View window.

Any scans or frames that are completely unloaded from memory will appear in a gray italicized font in the Workspace window (see Figure 78).

4_load_unload.png

Figure 78 Selectively unloading scans.

Note

Before you can change a scan’s loading status, you must save the project.

To change the loading status, select the scans in the Workspace window (using the Ctrl key), click RMB and then select one of the scan-loading options in the pop-up menu (see Figure 78):

Table 6 Workspace menu commands and icons
Menu Command Function Icon Appearance
Unload scans Fully unload scans from RAM unloaded
Load key frames only Only load key frames into RAM key_frames_only
Load scans Fully load scans into RAM loaded
Load textures Fully load texture images into RAM
Unload textures Fully unload textures from RAM

Algorithms may automatically change the loading status of project data in the following cases:

You have selected unloaded scans for processing by clicking the eye button.
Artec Studio will load these scans into memory.
Execution of the algorithm requires large amounts of memory.
Artec Studio will unload unused scans, frames, textures or a combination thereof.

Note

In addition to 3D data, the change history can also consume a large portion of memory. For information on how to control the history size as well as how to unload or clear it, consult History of Project Changes.

Autosaving a Project

A project can be saved by either the user or Artec Studio. The latter case is called autosaving. For temporary (i.e., unsaved) projects, autosaving is unavailable. The application autosaves a project in the following cases: