<<

Inhaltsverzeichnis Software Manual diCapture™ Overview…………………………………………………… 1 o diCapture™ User Interface……………………………………… 1 . Preview ………………………………………… 3 . Error Dialogs………………………………………………. 4 o diCapture™ Command Reference………………………………… 5 . Capture Command………………………………………… 5 . Refresh Command………………………………………… 5 . Zoom In / Zoom Out / 100%...... 6 . Select All Command………………………………………. 6 . Delete Selected / Delete All……………………………….. 7 . Download Command……………………………………… 7 . Exit Command 9 o diCapture™ Keyboard Shortcuts………………………………….. 9

DI3D™ Overview………………………………………………………… 9 o DI3D™ User Interface…………………………………………… 10 . Calibrate Page…………………………………………… 11 . Build Page………………………………………………… 13 Build Page Input Options………………………… 14 Build Page Image Set Selection…………………… 15 Build Page Processing Options…………………… 16 o Build Settings……………………………… 16 o Export Settings…………………………… 17 Build Page Output Options……………...... 18 Build Page Processing Control Buttons…………… 18 . Batch Page………………………………………………… 19 Batch Page Queue Display………………………… 20 Batch Page Processing Control Buttons…………… 21 . Log Page…………………………………………………... 21 Log Page Task List………………………………… 22 Log Page Details Pane…………………………… 23 Log Page Controls…………………………………. 24 . Status Bar………………………………………………… 24 . Error Dialogs………………………………………………. 25

I

Inhaltsverzeichnis Software Manual diView™ Overview……………………………………………………….. 25 o diView™ User Interface…………………………………………... 26 . 3D View…………………………………………………… 27 . Status Bar…………………………………………………. 28 . Error Dialogs………………………………………………. 28 o diView™ Interaction Tools……………………………………… 29 . Zoom Tool…………………………………………………. 30 . Rotate Tool…………………………………………………. 30 . Pan Tool……………………………………………………. 31 . Reset Tool………………………………………………….. 32 o diView™ Display Options…………………………………………. 32 . Background Colour 33 . Lighting………………………………………………… 34 . Mesh Overlay………………………………………………. 35 . Texture Display…………………………………………….. 36 . Automatic Colour Correction………………………………. 36 o Exporting Data…………………………………………………… 37 . Exporting 3D Data………………………………………… 37 Export Settings…………………………………… 39 . Exporting Screenshots……………………………………… 39

II

Software Reference Page 1 of 40

Software Reference

This section links to the software reference manuals for all of the application used in the DI3D™ system.

z diCapture™ Software Reference z DI3D™ Software Reference z diView™ Software Reference

©2006 Dimensional Imaging Ltd. All rights reserved.

diCapture™ Overview

The diCapture™ application is designed to provide a simple mechanism for capturing images to be used by DI3D™. It enables you to perform a variety of tasks relating to the connected cameras with the minimum of effort. Common tasks include:

z Capturing calibration images. z Capturing patient (subject) images. z Previewing images stored on multiple cameras simultaneously. z Downloading captured images to local machine or network location. z Deleting existing images from cameras.

What would you like to learn more about:

z User Interface z Available Commands z Keyboard Shortcuts

©2006 Dimensional Imaging Ltd. All rights reserved.

diCapture™ User Interface

The diCapture™ application can be run by double clicking the diCapture™ shortcut either on the desktop or in the Dimensional Imaging folder in the Microsoft Windows® Start .

As the application initialises a will be displayed showing some licensing information and describing the progress of the startup procedure. The final stage of this initialisation involves detecting, and connecting to, attached cameras. In the unlikely event of an error occurring while connecting to one or more of the cameras an Error Dialog will be displayed describing the error

1 Software Reference Page 2 of 40 that occurred and suggesting how to fix it.

Once initialisation is complete the main window of the diCapture™ application will be displayed. This is the interface through which all interaction with the cameras is achieved and is comprised of the following basic components:

1. enabling access to all available commands. 2. Tool Bar that provides buttons for the most frequently used commands. 3. Preview Window that displays thumbnail previews for all the images currently captured on cameras. 4. Status Bar that displays the status of the current operation (if any).

What would you like to learn more about:

z Preview Window z Error Dialogs

©2006 Dimensional Imaging Ltd. All rights reserved.

2 Software Reference Page 3 of 40 Preview Window

The Preview Window is the main component of the diCapture™ interface and is where thumbnail previews of captured images will be displayed. Whenever you capture images they are stored on their respective cameras and will remain there until they are downloaded via the Download command. However the thumbnail previews displayed in the preview window enable you to evaluate images without having to download them first.

The thumbnail previews are displayed in a grid where each row corresponds to a camera and each column corresponds to a single capture. This grid is very simple to work with and is completely built from two basic elements:

1. Thumbnail Images that display reduced size previews of on camera images. 2. Column Headers that can be used to interact with all images from a single capture (column).

Each thumbnail consists of an image and an associated . The label contains the name of the camera on which the image is stored and the image number. All of the images for a particular capture share the same image number and will be displayed in a single column. The size of the previews can be manipulated using the Zoom commands.

Some of the commands available in the diCapture™ application require images or columns to be selected. Images can be selected and deselected in a similar manner to that used by the standard Microsoft Windows® interface:

z Select an image by clicking its thumbnail with the left mouse . z Deselect all images by clicking within the preview window but not over any thumbnails. z Select multiple images by holding down the Ctrl key while selecting individual images. z Select a range of images by selecting the first image and then holding down the Shift key while selecting the last image in the desired range.

3 Software Reference Page 4 of 40

All of the above mentioned selection techniques also apply to column headers. However it is important to note that performing selection operations on column headers will select or deselect the entire column rather than just the header. Any selected images or columns are clearly indicated in the Preview Window by orange border highlights.

Click here to return to the user interface reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Error Dialogs

In the unlikely event of an error occurring within the diCapture™ application a dialog will be displayed informing you of the error and suggesting a possible course of action to remedy the problem. The precise content of the dialog may vary depending on the type and severity of error that has occurred but it will always adhere to the same basic layout:

1. Error Title containing a single sentence summarising the error that occurred. 2. Error Description containing a longer description of the error and in most cases a suggested course of action. 3. Scroll Bar that can be used to scroll through longer error descriptions or multiple error entries. 4. OK/Exit Button to close the error dialog once you have reviewed the error messages displayed.

Depending on the severity of the error encountered you will either be allowed to continue using the application or it will shut down automatically. If the application does shut down any captured images will remain on the cameras and can be recovered the next time the application is run.

You should only encounter errors rarely while using the diCapture™ application and, particularly in the case of a recurring error, you should consider contacting a customer support representative.

4 Software Reference Page 5 of 40

Click here to return to the user interface reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

diCapture™ Command Reference

The diCapture™ application allows cameras and images to be controlled via a number of commands. These commands are all accessible through the menu bar at the top of the main application window. The most commonly used commands also have an associated button. During execution of commands which involve lengthier operations the current status of the command will be displayed in the status bar at the bottom of the main application window.

Which command would you like to learn more about:

z Capture z Refresh z Zoom In / Zoom Out / 100% z Select All z Delete Selected / Delete All z Download z Exit

©2006 Dimensional Imaging Ltd. All rights reserved.

Capture Command

The Capture command causes each of the connected cameras to take a single synchronized image. The Preview Window will then automatically update to display previews of the newly captured images. Occasionally one or more of the cameras may take slightly longer than usual to save the new image to their internal memory card. In this event it is possible that the preview images may not appear automatically. Should this happen the Refresh command can be used to force the previews to update.

The toolbar button for the Capture command shows a small camera with a flash. The corresponding menu item can be found under Cameras->Capture.

Click here to return to the command reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Refresh Command

The Refresh command deletes all cached preview images and creates a new thumbnail for every image currently stored on each of the connected cameras. In some cases this can lead to images being renumbered but images will never be reordered or discarded. The refresh command can be useful in a number of situations:

5 Software Reference Page 6 of 40

z Previews failed to appear automatically after a Capture command. z Many images have been deleted leaving large blank spaces in the Preview Window. z Images have been captured manually using some other trigger source.

The toolbar button for the Refresh command shows two small arrows circling each other. The corresponding menu item can be found under View->Refresh.

Click here to return to the command reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Zoom In / Zoom Out / 100%

The zoom commands enlarge or reduce the size of the image thumbnails in the Preview Window. Use the Zoom Out command to get an overview of all the images or the Zoom In command to check the details of a particular image. The 100% command can be used to reset the thumbnails to their default size.

The toolbar buttons for the zoom commands show a magnifying glass with either a plus or minus sign next to them. The corresponding menu items can be found under View->Zoom In, View->Zoom Out and View->100%. The 100% menu item will have a tick beside it if thumbnails are already being displayed at their default size.

Click here to return to the command reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Select All Command

The Select All command causes all thumbnails displayed in the Preview Window to be selected. This is commonly a precursor to using the Delete Selected command to delete images from the cameras. The menu item for the Select All command can be found under Edit->Select All.

6 Software Reference Page 7 of 40

Click here to return to the command reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Delete Selected / Delete All

The delete commands cause images to be deleted from connected cameras. The Delete Selected command only deletes those images whose previews are currently selected in the Preview Window and leaves all other images untouched. The Delete Selected command should be used to remove any unwanted images prior to downloading.

The Delete All command deletes all images from all cameras regardless of whether or not they are selected. This is subtly different from selecting all images and deleting them with the Delete Selected command because any images for which previews have not yet been generated will still be deleted. In practice this is rarely an issue however it is something to be aware of. It should also be noted that for large numbers of images the Delete All command is likely to execute significantly faster than the Select All / Delete Selected combination. The Delete All command is useful when a set of images is no longer required, particularly at the start of a new session when there may be images remaining from a previous set of captures.

The toolbar button for the delete commands shows a document with a cross on it. When clicked it will display a popup menu presenting the choice of Delete Selected or Delete All. The corresponding menu items can be found under Edit->Delete Selected and Edit->Delete All.

Click here to return to the command reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Download Command

The Download command downloads all images from all cameras either to the local machine or to a network location. A standard Microsoft Windows® browse for folder dialog will be displayed to allow the target folder to be specified.

7 Software Reference Page 8 of 40

While downloading is underway a progress dialog will appear including:

1. Cancel button that enables you to cancel the download operation at any point. Images that were successfully downloaded will not be deleted when you cancel. 2. indicating which image is currently being downloaded. 3. Progress bar indicating how much of the current image has been downloaded.

The downloaded images are not removed from the cameras automatically and should be manually deleted after download if they are no longer required. To improve the speed of downloading, any unwanted images should be deleted prior to using the Download command.

The toolbar button for the Download command shows a folder with a downwards pointing arrow. The corresponding menu item can be found under Cameras->Download.

Click here to return to the command reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

8 Software Reference Page 9 of 40 Exit Command

The Exit command causes the application to disconnect from the cameras and shut down. Any images which have not been downloaded will remain on the cameras and may be downloaded the next time the application is run.The menu item for the Exit command can be found under File->Exit.

Click here to return to the command reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

diCapture™ Keyboard Shortcuts

A number of the most commonly used commands within diCapture™ are accessible via keyboard shortcuts. A full list of these shortcuts is given below:

Command Shortcut Capture Ctrl + Enter Refresh Ctrl + R Zoom In Ctrl + + Zoom Out Ctrl + - 100% Ctrl + 1 Select All Ctrl + A Delete Selected Ctrl + Delete Download Ctrl + D Exit Alt + F4

©2006 Dimensional Imaging Ltd. All rights reserved.

DI3D™ Overview

The DI3D™ application is designed to provide a simple mechanism for building 3D models from images generated by diCapture™. It enables you to perform a variety of tasks including:

z Calibrating the system. z Building 3D models of subjects at different resolutions. z Exporting data to other industry standard 3D formats. z Building batch queues that can be processed when your PC is not in use.

What would you like to learn more about:

z User Interface

©2006 Dimensional Imaging Ltd. All rights reserved.

9 Software Reference Page 10 of 40

DI3D™ User Interface

The DI3D™ application can be run by double clicking the DI3D™ shortcut icon either on the desktop or in the Dimensional Imaging folder in the Microsoft Windows® Start Menu.

Once initialisation is complete the main window of the DI3D™ application will be displayed. The user interface is divided into a number of distinct pages which each contain all of the functionality necessary to achieve a particular task. You can switch between these pages at any point whilst using the DI3D™ application. Regardless of which page you are currently working on the main application window will always be comprised of the same basic components:

1. Menu Bar enabling access to all available commands. The subset of commands available through the menu bar is dependant on which page of the interface is currently active and will be described in the user reference for each page. 2. Page Selector containing a for each available page of the interface. You can switch between pages by clicking on the appropriate tab. The currently active page is indicated by a highlight at the top of the corresponding tab. 3. Page Contents containing all of the buttons and other controls for the currently active page. The precise content of this area of the main window varies between pages and will be described in the user reference for each page. 4. Status Bar that displays the status of the current operation (if any).

10 Software Reference Page 11 of 40

In the unlikely event of an error occurring within DI3D™ an Error Dialog will be displayed describing the error that occurred and suggesting how to fix it.

What would you like to learn more about:

z Calibrate Page z Build Page z Batch Page z Log Page z Status Bar z Error Dialogs

©2006 Dimensional Imaging Ltd. All rights reserved.

Calibrate Page

The calibrate page enables you to calibrate the system based on a set of calibration images from diCapture™. Full details of how to capture these images can be found in the system user guide. The page contains a number of buttons and inputs that you should use as follows:

11 Software Reference Page 12 of 40

1. Calibration Path Input Box You should type the fully qualified path to the folder that contains the calibration images into this box. 2. Calibration Path Browse Button If you cannot remember the path to the calibration images then clicking this button will display a standard Microsoft Windows® folder browser to let you search for the correct folder. 3. Image Status Display As you change the calibration path this status text will update to indicate the number of images found in the currently selected calibration directory. You will not be able to perform a calibration unless at least one image has been found. 4. Existing Targets Check Box If you have previously performed a calibration using the images in the current calibration directory then you can choose to reuse existing target files. 5. Calibration Target List Select the calibration target you used when generating the images for the calibration. Your previous setting will be remembered so you should not need to change this setting very often. If your target is not on the list then contact your system supplier. 6. Calibrate Now Button Use this button to begin calibrating the system. Once calibration has started no other processing can be performed until calibration finishes or is cancelled. You can view the status of the calibration on the Log Page. This button is only enabled if you have selected a valid calibration directory and no other processing is currently underway. 7. Calibrate Later Button Use this button to add the calibration to the end of the current batch queue. Use the Batch Page to view and process the batch queue. This button is only enabled if you have selected a valid calibration directory. You can use this button to add a calibration to the batch queue even if the batch queue is currently being processed. 8. Cancel Button Use this button to cancel any processing that is currently underway. This button has the same functionality regardless of which page of the user interface is currently active. Depending on the nature of the processing underway, and the number of PCs involved, it can take up to a minute for all processing to be stopped. Once you have cancelled processing all progress is lost and any subsequent processing must start from the beginning. This button is enabled whenever any processing is being performed by the DI3D™ application.

12 Software Reference Page 13 of 40

What would you like to learn more about:

z Build Page z Batch Page z Log Page

©2006 Dimensional Imaging Ltd. All rights reserved.

Build Page

The build page enables you to build 3D data from a calibration and a set of subject images from diCapture™. Full details of how to perform calibration and capture these images can be found in the system user guide.

The build page is divided into a number of sections:

1. Input Options Enable you to choose subject images and calibration to be processed. 2. Image Set Selection Enables you to select from multiple sets of subject images stored in the same location. 3. Processing Options Enable you to specify parameters for building and/or exporting 3D data. 4. Output Options Enable you to specify the name for the generated 3D Data files. 5. Processing Control Buttons Enable you to control how processing will be performed by the DI3D™ application.

13 Software Reference Page 14 of 40

What would you like to learn more about:

z Input Options z Image Set Selection z Processing Options z Output Options z Processing Control Buttons

©2006 Dimensional Imaging Ltd. All rights reserved.

Build Page Input Options

The build page input options enable you to specify the location of the subject images and calibration data to be used when building a 3D model of your subject.

The input options section contains the following:

1. Subject Path Input Box You should type the fully qualified path to the folder that contains the subject images you wish to process into this box.

14 Software Reference Page 15 of 40

2. Subject Path Browse Button If you cannot remember the path to the subject images then clicking this button will display a standard Microsoft Windows® folder browser to let you search for the correct folder. 3. Image Status Display As you change the subject path this status text will update to indicate the number of images found in the currently selected subject directory. None of the other inputs or buttons on the build page will be enabled unless at least one complete set of images has been found. A complete image set consists of a group of images, one for each camera, that all have the same index number e.g. pod1bottom_00.jpg, pod1top_00.jpg, pod2bottom_00.jpg, pod2top_00.jpg. 4. Calibration Path Input Box As you change the subject path DI3D™ will automatically try to locate the appropriate calibration data by looking in the subject directory and then the last directory for which you performed a calibration. The resulting path will be displayed in this box. Should the automatically generated path be incorrect you must manually enter the correct path to the folder that contains the calibration data in this box. 5. Calibration Path Browse Button If you cannot remember the path to the calibration data then clicking this button will display a standard Microsoft Windows® folder browser to let you search for the correct folder. 6. Camera Status Display As you change the calibration path this status text will update to indicate the number of cameras for which calibration data has been found in the currently selected calibration directory. None of the other inputs or buttons on the build page will be enabled unless a complete set of camera calibration data has been found.

Occasionally when changing the subject path or calibration path it may take several seconds for the status displays to update. This is normally due to one or both of the selected folders containing large numbers of images that must all be checked to see if they form part of a complete image set.

Click here to return to the build page reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Build Page Image Set Selection

If the currently selected subject directory has more than one complete image set, such as when you have downloaded images for a number of subjects into the same folder, then you can use the image set selection list to choose which subject's data to process.

By default the first image set is always selected so that in the case of a single subject per directory you will not need to change this selection in order to process this directory.

In the event of there being no complete image sets in the current subject directory the image set selection list will be disabled and you will be unable to process any data.

Click here to return to the build page reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

15 Software Reference Page 16 of 40

Build Page Processing Options

The build page processing options enable you to specify whether you want to build a 3D model, export 3D data or both:

1. Build Check Box Tick this box to indicate that you wish to build a 3D model. 2. Build Settings Button Press this button to display further settings relating to the processing of 3D data. This button is only enabled if the Build Check Box is ticked. 3. Export Check Box Tick this box to indicate that you wish to export 3D data to another format. This check box is only enabled if you have previously built the 3D data for the currently selected image set or the Build Check Box is ticked. 4. Export Settings Button Press this button to display further settings relating to the exporting of 3D data. This button is only enabled if the Export Check Box is ticked.

You can only modify these settings when an image set has been selected in the image set selection box.

What would you like to learn more about:

z Build Settings z Export Settings

©2006 Dimensional Imaging Ltd. All rights reserved.

Build Settings

Currently the only user configurable build setting is the resolution at which the 3D data is to be generated. Resolution is expressed as a percentage in the range 1 - 100%. Higher resolutions produce higher quality 3D data but take longer to process. Conversely, lower resolutions process very quickly but may produce rougher 3D data.

You can modify the resolution either by typing a new percentage or by using the arrows to incrementally increase/decrease the current resolution. If you type a value outside the range 1 - 100% it will be clamped to the closest valid value.

16 Software Reference Page 17 of 40

Press OK to apply the new resolution or Cancel to restore the previous setting.

Click here to return to the build page processing options reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Export Settings

The export settings dialog gives you precise control over 3D data being exported to other formats. It contains the following options:

1. Units Selection 3D Data generated by DI3D™ is usually expressed in metres. You can select your preferred units for exported data here. This is useful if the exported data is going to be passed on to another tool that only operates at a particular scale. 2. Mesh Resolution 3D data generated by DI3D™ is generally too dense to be easily manipulated in mesh form. By selecting a lower resolution for the mesh here you can effectively limit the polygon count of your exported models. Minimum resolution is 1% and maximum resolution is determined by the resolution at which the original 3D data was built. 3. Mesh Smoothing Depending on what the exported data is going to be used for you may wish to preserve the fine detail of the 3D data or you may wish to smooth out the surface to obtain an idealised representation. Here you can select the percentage of smoothing to be applied when exporting data. Valid settings are from 0% (no smoothing) to 100% (significant smoothing of surface features). 4. Format Selection DI3D™ supports exporting to a number of different industry standard 3D formats. Select your desired format from this list. The set of available formats may vary depending on the terms of your license. 5. Export Path By default exported models will be placed in the same location as the original 3D data. You can specify an alternative location for exported models by typing it in this box. It is important to note that this is the path to a folder where all exported models will be saved rather than the path to a single exported model. 6. Export Path Browse Button If you cannot remember the path where exported models should be saved then clicking this button will display a standard Microsoft Windows® folder browser to let you search for the correct folder.

Once you have customised your setting press OK to apply them or Cancel to revert to the previous settings. Once you have applied your settings they will be saved so that you should only have to set them up once.

Click here to return to the build page processing options reference.

17 Software Reference Page 18 of 40

©2006 Dimensional Imaging Ltd. All rights reserved.

Build Page Output Options

Currently the only available output option is the name assigned to the generated DI3D™ session file. This defaults to the name of the subject directory but you can enter any preferred name here.

This option is most useful when data for a number of subjects is being stored in the same directory where more distinctive session names make it easier to distinguish between data sets at a later date.

You can only edit the output session name when an image set has been selected in the image set selection box.

Click here to return to the build page reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Build Page Processing Control Buttons

There are three buttons at the bottom of the build page that control processing of model building and/or exporting:

1. Build Now Button Use this button to begin building/exporting the data immediately. Once building/exporting has started no other processing can be performed until the current processing finishes or is cancelled. You can view the status of the building/exporting on the Log Page. This button is only enabled if you have selected valid input sources and processing options and no other processing is currently underway. 2. Build Later Button Use this button to add the building/exporting job to the end of the current batch queue. Use the Batch Page to view and process the batch queue. This button is only enabled if you have selected valid input sources and processing options. You can use this button to add a build/export job to the batch queue even if the batch queue is currently being processed. 3. Cancel Button Use this button to cancel any processing that is currently underway. This button has the same functionality regardless of which page of the user interface is currently active. Depending on the nature of the processing underway, and the number of PCs involved, it can take up to a minute for all processing to be stopped. Once you have cancelled processing all progress is lost and any subsequent processing must start from the beginning. This button is enabled whenever any processing is being performed by the DI3D™ application.

Click here to return to the build page reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

18 Software Reference Page 19 of 40

Batch Page

The batch page enables you to review and process the queue of jobs that have been scheduled for batch processing. You can add jobs to the batch queue from either the Calibrate Page or the Build Page.

The batch page has a number of components:

1. Batch Queue Status Indicates the number of jobs currently in the batch queue regardless of their completion status. 2. Batch Queue Display Displays all the jobs currently in the batch queue along with status information. 3. Batch Control Buttons Enable you to control processing of the batch queue.

What would you like to learn more about:

z Batch Queue Display z Batch Control Buttons

©2006 Dimensional Imaging Ltd. All rights reserved.

19 Software Reference Page 20 of 40

Batch Page Queue Display

The batch queue display is a standard Microsoft Windows® list control, that allows you to view detailed information on each of the batch jobs in the queue. The contents of this list are organised into a number of columns as described below:

1. Status Indicates the current status of the batch job and will have one of the following values: Indicates that the job has not yet started processing. Indicates that one or more of the sub-tasks involved with the job are being processed. Indicates that no processing is currently underway but that some of the sub-tasks involved with the job have been processed. Indicates that the job was processed successfully. Indicates that an error occurred while processing the job. Details of the failed sub-task can be found on the Log Page. 2. Title Contains the name assigned to the batch job. For build/export jobs this will be the name of the generated DI3D™ Session File. For calibration jobs this will have the default value of "calibration". 3. Date Added Displays the date and time at which the batch job was added to the queue. This can be useful when trying to find a specific job in a large queue. 4. Path Displays the full path to the data associated with the batch job. 5. Progress Displays a progress bar indicating the current progress of the batch job. A detailed breakdown of the progress for currently processing batch jobs can be found on the Log Page.

In order to facilitate location of specific jobs or groups of jobs the batch queue can be sorted by any one of the columns described above. Clicking on a column once will sort by that column in ascending order. Clicking a second time will sort by the same column but in descending order. The currently sorted column will be indicated by an arrow in the column header. In the screenshot above the queue has been sorted in ascending order of Date Added.

Click here to return to the batch page reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

20 Software Reference Page 21 of 40

Batch Page Processing Control Buttons

There are three buttons at the bottom of the batch page that control processing of the batch queue:

1. Run Now Button Use this button to begin processing the batch queue. Once processing has started no other processing can be performed until the current batch queue finishes or is cancelled. This button is only enabled if the batch queue contains at least one job and no other processing is currently underway. You can change the order in which jobs from the batch queue are built by sorting the queue prior to starting batch processing. Details of how to sort the queue can be found in the Batch Queue Display help. 2. Clear Queue Button Use this button to clear the current batch queue. All jobs will be discarded regardless of whether or not they have been processed. This button is enabled whenever the batch queue contains at least one job and is not being processed. You will commonly use this button when the current queue has been completely processed or you wish to scrap the current queue and build up a new one. 3. Cancel Button Use this button to cancel any processing that is currently underway. This button has the same functionality regardless of which page of the user interface is currently active. Depending on the nature of the processing underway, and the number of PCs involved, it can take up to a minute for all processing to be stopped. When you cancel during batch processing as much of your progress as possible is saved. This means you can restart processing where you left off by pressing the Run Now Button at a later date.

Click here to return to the batch page reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Log Page

The log page enables you to monitor sub-tasks that are conducted as part of building 3D data.

The log page is divided into a number of sections:

1. Task List Enables you to monitor and view different aspects of a sub-task such as status and progress. 2. Details Enables you to view the detailed output from a selected sub-task. 3. Log Control Buttons Enables you to save or clear the sub-task log, or cancel processing.

21 Software Reference Page 22 of 40

What would you like to learn more about:

z Task List z Details z Log Control

©2006 Dimensional Imaging Ltd. All rights reserved.

Log Page Task List

The task list is a standard Microsoft Windows® list control, that allows you to view detailed information about tasks associated with build and calibration jobs. The list is can be sorted by any one of the column headers as described below:

1. Status Status shows the status of the current task. Valid values for status are: { Processing The task is currently active and is being processed. { Complete The task has completed successfully. { Warning The task has completed, but there is something you should be aware of, select the task in the list and view the tasks output in the 'details' section. { Error The task has failed, select the task in the list and view the tasks output in the 'details' section.

22 Software Reference Page 23 of 40

2. Job Job is the name of the job that the task applies to. For instance if your subject name is 'ewan' and you are building the '01' image set for your subject, then the build job is called 'ewan_01'. Calibration jobs are simply referred to as 'calibration. 3. Task Task is the name of the task. For instance, a build job is made of 2 mask tasks, 2 match tasks and a merge task. Whereas, a calibration job consists of many findTarget tasks and a calibrate task. 4. Time Time is the time that the task was started. 5. Server Server is the name of the server that the task was run on. in most cases, this will always be 'localhost', which is the current machine. In more sophisticated system structures, where tasks can be distributed, the name of the server will change to whichever server ran the task. 6. Progress Progress is a the progress for each task. When the task is running, it will display a progress bar that indicates the progress for the task. When complete, the progress will display a completion message for the tasks.

Click here to return to the log page reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Log Page Details Pane

The details pane on the Log Page, allows you to view the output from a selected task. To select a task, simply click on one of the tasks in the list [see the 'task list' section for more information about the task list]. The selected task's full output will now be available to view in the details pane.

In the example above, you can see that the output includes things like which files have been opened, which files have been created, and any error messages or warnings in full, as well as task specific information, such as in this case, which 'pod' is being masked, and at what resolution.

Click here to return to the log page reference.

23 Software Reference Page 24 of 40

©2006 Dimensional Imaging Ltd. All rights reserved.

Log Page Controls

There are three buttons at the bottom of the log page that control the log of tasks associated with calibrating, building and/or exporting jobs:

1. Save Log Use this button to save a log of the current tasks. The log will contain the detailed output from all of the tasks that are currently in the list. You will be prompted to save the file somewhere, you can choose what the file is called, and where it is saved, the file will be saved as a 'diLog' file, and can be viewed using any text editor. This functionality is particularly helpful if you are having problems with you system, because you can save the log and then email the log to a support engineer. 2. Clear Log Use this button to clear the entire task list. By pressing the clear log button, all previous tasks will be cleared from the list, including all of the detailed output from each of the tasks. Please be sure you want to clear the list, as the only way to get the information back is to re-run all the tasks. Also note that the list is cleared when the application is shutdown, so when restarted, the list will be cleared. 3. Cancel Button Use this button to cancel any processing that is currently underway. This button has the same functionality regardless of which page of the user interface is currently active. Depending on the nature of the processing underway, and the number of PCs involved, it can take up to a minute for all processing to be stopped. Once you have cancelled processing all progress is lost and any subsequent processing must start from the beginning. This button is enabled whenever any processing is being performed by the DI3D™ application.

Click here to return to the log page reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Status Bar

The Status Bar is positioned at the bottom of the main application window and displays information about any currently running tasks. When no processing is underway the Status Bar will simply display the word "Ready":

When a lengthy operation is underway the status bar will change to display detailed information:

1. Description of the operation that is underway. 2. Progress bar indicating how far the current operation has progressed.

As the operation progresses the Status Bar will update to reflect the current level of progress. Once the operation has completed the Status Bar will return to its default state. When processing a batch queue the status bar will reflect the total progress for the entire queue rather than just the currently running job.

Click here to return to the user interface reference.

24 Software Reference Page 25 of 40

©2006 Dimensional Imaging Ltd. All rights reserved.

Error Dialogs

In the unlikely event of an error occurring within the DI3D™ application a dialog will be displayed informing you of the error. The precise content of the dialog may vary depending on the type and severity of error that has occurred but it will always adhere to the same basic layout:

1. Error Title containing a single sentence summarising the error that occurred. 2. Error Description containing a longer description of the error and in most cases a suggested course of action. 3. Scroll Bar that can be used to scroll through longer error descriptions or multiple error entries. 4. OK/Exit Button to close the error dialog once you have reviewed the error messages displayed.

Depending on the severity of the error encountered you will either be allowed to continue using the application or it will shut down automatically. You should only encounter errors rarely while using the DI3D™ application and, particularly in the case of a recurring error, you should consider contacting a customer support representative.

Errors encountered during processing of data are handled differently than general application errors and will be reported through the Log Page.

Click here to return to the user interface reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

diView™ Overview

The diView™ application enables you to visualize and interact with 3D data generated by DI3D™. In particular you are able to:

z View 3D data at extremely high resolutions.

25 Software Reference Page 26 of 40

z Position and orient data in 3D to visualize specific features. z Display data in a variety of different ways to help with visualization of surfaces. z Generate screenshots for inclusion in presentations or on the web (supports JPEG, TIFF, BMP and more). z Export to other standard 3D file formats (supports OBJ, PIF, STL, VRML and more).

What would you like to learn more about:

z User Interface z Working With Sessions z Manipulating Data z Display Options z Exporting Data z Keyboard Shortcuts

©2006 Dimensional Imaging Ltd. All rights reserved.

diView™ User Interface

The diView™ application can be run by double clicking the diView™ shortcut icon either on the desktop or in the Dimensional Imaging folder in the Microsoft Windows® Start Menu.

Once initialisation is complete the main window of the diView™ application will be displayed. This is the interface through which all interaction with the 3D data is achieved and is comprised of the following basic components:

1. Menu Bar enabling access to all available commands. 2. Tool Bar that provides buttons for the most frequently used commands. 3. 3D View that displays currently open 3D data. 4. Status Bar that displays the status of the current operation (if any).

26 Software Reference Page 27 of 40

In the unlikely event of an error occurring while working with 3D data an Error Dialog will be displayed describing the error that occurred and suggesting how to fix it.

What would you like to learn more about:

z 3D View z Status Bar z Error Dialogs

©2006 Dimensional Imaging Ltd. All rights reserved.

3D View

27 Software Reference Page 28 of 40

The 3D View is the main component of the diView™ interface and is where 3D data will be displayed. You can change the appearance of the data by switching between different Display Modes. You can interact with the data via the Interaction Tools.

Click here to return to the user interface reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Status Bar

The Status Bar is positioned at the bottom of the main application window and displays information about any currently running tasks. When no processing is underway the Status Bar will simply display the word "Ready":

When a lengthy operation is underway the status bar will change to display detailed information:

1. Description of the operation that is underway. 2. Progress bar indicating how far the current operation has progressed.

As the operation progresses the Status Bar will update to reflect the current level of progress. Once the operation has completed the Status Bar will return to its default state.

You can toggle display of the Status Bar on or off by using the View->Status Bar menu item. A tick mark next to this menu item indicates whether or not the Status Bar is currently being displayed.

Click here to return to the user interface reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Error Dialogs

In the unlikely event of an error occurring within the diView™ application a dialog will be displayed informing you of the error. The precise content of the dialog may vary depending on the type and severity of error that has occurred but it will always adhere to the same basic layout:

1. Error Title containing a single sentence summarising the error that occurred. 2. Error Description containing a longer description of the error and in most cases a suggested course of action. 3. Scroll Bar that can be used to scroll through longer error descriptions or multiple error entries. 4. OK/Exit Button to close the error dialog once you have reviewed the error messages displayed.

28 Software Reference Page 29 of 40

Depending on the severity of the error encountered you will either be allowed to continue using the application or it will shut down automatically. The 3D data is not modified by the application so even if the application does shut down you will not lose any data.

You should only encounter errors rarely while using the diView™ application and, particularly in the case of a recurring error, you should consider contacting a customer support representative.

Click here to return to the user interface reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

diView™ Interaction Tools

The diView™ application enables you to change the position, orientation and magnification of data in the 3D View using a set of interaction tools. These tools are all accessible through the menu bar at the top of the main application window and also have dedicated toolbar buttons.

Only one tool can be used at a time and you can determine which tool is currently active by checking for one of the following indicators:

z The corresponding menu item will have a tick next to it. z The corresponding toolbar button will be highlighted. z The mouse cursor will change shape when moved over the 3D View to reflect the current tool.

Which tool would you like to learn more about:

z Zoom z Rotate

29 Software Reference Page 30 of 40

z Pan z Reset

©2006 Dimensional Imaging Ltd. All rights reserved.

Zoom Tool

The Zoom tool enables you to magnify the data displayed in the 3D View. You can use the Zoom tool as follows:

1. Select the Zoom tool from either the menu bar or the toolbar. 2. Position the mouse cursor over the 3D View and hold down the left mouse button. 3. Move the mouse (whilst holding the left mouse button down) to change the magnification level: { Moving the mouse forwards increases the magnification level. { Moving the mouse backwards decreases the magnification level. 4. If you have a 3 button mouse you can also access the Zoom tool using the scroll wheel: { Scrolling up increases the magnification level. { Scrolling down decreases the magnification level.

The toolbar button and mouse cursor for the Zoom tool show a magnifying glass. The corresponding menu item can be found under Interaction->Zoom.

The screen shots below show a subject before and after the Zoom tool has been used:

Click here to return to the interaction tools reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Rotate Tool

30 Software Reference Page 31 of 40

The Rotate tool enables you to change the orientation of the data displayed in the 3D View. You can use the Rotate tool as follows:

1. Select the Rotate tool from either the menu bar or the toolbar. 2. Position the mouse cursor over the 3D View and hold down the left mouse button. 3. Move the mouse (whilst holding the left mouse button down) to change the orientation of the data: { Moving the mouse backwards and forwards rotates the data around its horizontal axis. { Moving the mouse from side to side rotates the data around its vertical axis. 4. More complex orientations can be achieved by performing multiple rotations one after the other.

The toolbar button and mouse cursor for the Rotate tool show an arc with an arrow. The corresponding menu item can be found under Interaction->Rotate.

The screen shots below show a subject before and after the Rotate tool has been used:

Click here to return to the interaction tools reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Pan Tool

The Pan tool enables you to change the horizontal and vertical position of the data displayed in the 3D View. You can use the Pan tool as follows:

1. Select the Pan tool from either the menu bar or the toolbar. 2. Position the mouse cursor over the 3D View and hold down the left mouse button. 3. Move the mouse (whilst holding the left mouse button down) to change the position of the data: { Moving the mouse forwards moves the data up. { Moving the mouse backwards moves the data down. { Moving the mouse left moves the data left. { Moving the mouse right moves the data right.

The toolbar button and mouse cursor for the Pan tool show four arrows pointing up, down, left and right. The corresponding menu item can be found under Interaction->Pan.

31 Software Reference Page 32 of 40

The screen shots below show a subject before and after the Pan tool has been used:

Click here to return to the interaction tools reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Reset Tool

The Reset tool enables you to restore the default position, orientation and magnification of the data displayed in the 3D View. The Reset tool is useful when you have been using the other interaction tools to obtain a certain pose and now wish to return to your starting position. To use the Reset tool simply select it from either the menu bar or the toolbar. The view will be reset and the previously selected interaction tool will be re-selected ready to begin manipulating the data again.

The toolbar button for the Reset tool shows four arrows pointing inwards. The corresponding menu item can be found under Interaction->Reset.

Click here to return to the interaction tools reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

diView™ Display Options

The diView™ application enables you to customise the way 3D data is displayed in the 3D View. In addition to changing the

32 Software Reference Page 33 of 40 background colour there are also a number of display modes which can be combined to produce different representations of the 3D data. These display modes can all be toggled on or off via the menu bar at the top of the main application window and also have dedicated toolbar buttons.

You can determine which display modes are active at any time by checking the following indicators:

z The menu item for an active display mode will have a tick next to it. z The corresponding toolbar button will be highlighted.

Which display option would you like to learn more about:

z Background Colour z Lighting z Mesh Overlay z Texture Display z Automatic Colour Correction

©2006 Dimensional Imaging Ltd. All rights reserved.

Background Colour

The background colour used in the 3D View can be customised by selecting the Edit->Background Colour menu item.

This will bring up a standard Microsoft Windows® colour chooser that allows you to select the new background colour in the following way:

1. Select one of the predefined colours by clicking any box to select that colour. 2. Select a non-standard colour by clicking anywhere in this box to select the colour at that point. 3. Adjust the brightness of your chosen colour by moving the arrow up and down the scale. 4. Preview your selected colour in this box. 5. Press OK to apply your chosen colour or Cancel to revert to the previous background colour.

33 Software Reference Page 34 of 40

Click here to return to the display options reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Lighting

The lighting mode determines if the 3D data will be rendered with artificial lights turned on or off. With lighting turned off the fine detail of the texture is more obvious but it can be hard to visualize the 3D shape of the data. With lighting turned on the 3D data is shaded to indicate shadows from an artificial light source. This makes areas of the texture darker but improves the perception of 3D features.

The toolbar button for enabling/disabling lighting shows a sphere with a shadow at the bottom corner. The corresponding menu item can be found under Display->Lights.

The screen shots below show a subject with and without lighting enabled:

34 Software Reference Page 35 of 40

Click here to return to the display options reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Mesh Overlay

The mesh mode determines if the 3D data will be rendered with the underlying mesh structure displayed. When the mesh overlay is turned on the 3D data will be rendered with the mesh structure shown on top of the usual 3D data display. This enables you to visualize the density of the data at the current resolution.

The toolbar button for enabling/disabling the mesh overlay shows a sphere with a mesh overlaid. The corresponding menu item can be found under Display->Mesh.

The screen shots below show a subject with and without the mesh overlaid:

Click here to return to the display options reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

35 Software Reference Page 36 of 40

Texture Display

The texture mode determines if the 3D data will be rendered with or without colour textures. With texture turned on fine details such as moles or scars can be accurately located but it can be hard to visualize the 3D shape of the data. With texture turned off 3D features are more apparent but it can be harder to locate features which are delineated purely by differences in colours.

The toolbar button for enabling/disabling texture shows a sphere with a coloured map of the world overlaid. The corresponding menu item can be found under Display->Textures.

The screen shots below show a subject with and without texture enabled:

Click here to return to the display options reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Automatic Colour Correction

Occasionally there will be small differences in the colouration of texture images from different cameras. To minimize the impact of these differences diView™ automatically corrects the colours of the texture images to obtain the best possible colour balance.

However if the subject has a marked difference in colouration across the face the colour correction can overcompensate. If this should happen then the colour correction can be disabled for the current 3D data by selecting the Display->Disable Colour Correction menu item. This will cause the 3D data to be refreshed with the original uncorrected colour images.

36 Software Reference Page 37 of 40

The screen shots below show a subject with and without automatic colour correction enabled:

Click here to return to the display options reference.

©2006 Dimensional Imaging Ltd. All rights reserved.

Dimensional Imaging Logo

Exporting Data

diView™ enables you to export to a range of different 2D and 3D file formats ready for use by other applications.

What would you like to learn more about:

z Exporting 3D Data z Exporting Screenshots

Exporting 3D Data diView™ enables you to export 3D data to a variety of industry standard formats by using the File- >Export menu item.

The export command displays a standard Microsoft Windows® file chooser dialog that allows you to specify the location and name under which the exported data will be saved:

37 diView™ - Exporting 3D Data Page 38 of 40

1. Select the folder where you wish the exported data to be saved. 2. Enter a name for the exported file. 3. Choose the type of file to export from the drop-down list. 4. Press Save to export the data or Cancel to cancel the export operation.

The majority of settings for export, including mesh resolution and automatic colour correction, will be derived from the current display settings. However there are some export specific settings which you can customize as desired. The progress of the export operation will be displayed in the Status Bar

.

What would you like to learn more about:

z Changing Mesh Resolution z Automatic Colour Correction z Export Settings

38 Software Reference Page 39 of 40

.

Export Settings

The Export Settings dialog enables you to choose the units to be used when exporting 3D data to other formats. The dialog can be displayed by selecting the Edit->Export Settings menu item.

The dialog displays a list of available units for you to choose from. Once you have made your selection press OK to apply the new settings or Cancel to revert back to the previous settings.

Your choice of units will be remembered the next time you run the application. So if you always export in metres then you should only have to change your export settings once.

©2006 Dimensional Imaging Ltd

. All rights reserved.

Exporting Screenshots

diView™ enables you to export a screenshot of the main 3D View to a variety of industry standard image formats ready for inclusion in presentations or on the web. You can accomplish this by using the Export Frame command accessible via the File-

>Export Frame menu item.

The Export Frame command saves the current display exactly as you see it. The area of the display which will be saved is shown outlined in blue below:

39

The Export Frame command displays a standard Microsoft Windows® file chooser dialog that allows you to specify the location and name under which the screenshot will be saved:

1. Select the folder where you wish the exported image to be saved. 2. Enter a name for the exported file. 3. Choose the type of image to export from the drop-down list. 4. Press Save to export the screenshot or Cancel to cancel the operation. >Export Frame menu item.

The Export Frame command saves the current display exactly as you see it. The area of the display which will be saved is shown : Software Reference Page 40 of 40

The Export Frame command displays a standard Microsoft Windows® file chooser dialog that allows you to specify the location and name under which the screenshot will be saved:

1. Select the folder where you wish the exported image to be saved. 2. Enter a name for the exported file. 3. Choose the type of image to export from the drop-down list. 4. Press Save to export the screenshot or Cancel to cancel the operation.

Since the screenshot will reflect exactly what is show on screen you should take care to position data and set display settings before using the Export Frame command.

40