Texas Instruments | Portable Point Cloud Generation 3D Scanning Using DLP Technology (Rev. A) | User Guides | Texas Instruments Portable Point Cloud Generation 3D Scanning Using DLP Technology (Rev. A) User guides

Texas Instruments Portable Point Cloud Generation 3D Scanning Using DLP Technology (Rev. A) User guides
TIDA-00361: Portable Point Cloud Generation
for 3D Scanning Using DLP® Technology
User's Guide
Literature Number: TIDU985A
May 2015 – Revised May 2016
Contents
Preface ........................................................................................................................................ 6
1
Introduction to the 3D Scanner Reference Design .................................................................... 7
1.1
1.2
2
Installing the Point Grey FlyCapture® 2+ Full SDK ...................................................................... 9
Installing the LifeCam Cinema Camera Driver and Configuring the Camera ...................................... 18
Installing MeshLab ........................................................................................................ 19
Downloading the 3D Scanner Reference Design ...................................................................... 20
Installing the 3D Scanner Reference Design ........................................................................... 21
Using the 3D Scanner Reference Design ............................................................................... 25
3.1
3.2
3.3
3.4
3.5
3.6
3.7
3.8
3.9
4
7
7
7
7
7
7
8
8
Installing the 3D Scanner Reference Design ............................................................................ 9
2.1
2.2
2.3
2.4
2.5
3
Structured Light ..............................................................................................................
How the 3D Scanner Reference Design Works .........................................................................
1.2.1 Projector and Camera Modules ...................................................................................
1.2.2 Calibration ...........................................................................................................
1.2.3 Pattern Projection ...................................................................................................
1.2.4 Image Capture ......................................................................................................
1.2.5 Information Decoding...............................................................................................
1.2.6 Point Cloud Reconstruction .......................................................................................
Connecting the Hardware When Using a Point Grey Flea3 Camera ................................................
Connecting the Hardware When Using the Microsoft LifeCam Cinema Camera ..................................
Configuring the Camera and Scan Type ................................................................................
Creating the Calibration Board ...........................................................................................
Preparing the Projector ....................................................................................................
Calibrating the Camera ....................................................................................................
Calibrating the Projector ...................................................................................................
Calibration Verification .....................................................................................................
Scanning Objects...........................................................................................................
25
25
26
29
31
32
43
51
55
Troubleshooting ................................................................................................................. 56
4.1
General Troubleshooting Steps .......................................................................................... 56
Revision History .......................................................................................................................... 61
2
Contents
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Copyright © 2015–2016, Texas Instruments Incorporated
www.ti.com
List of Figures
2-1.
Point Grey Software Downloads Page .................................................................................... 9
2-2.
Setting Up the FlyCapture2 Install ....................................................................................... 10
2-3.
FlyCapture2 Installation
2-4.
FlyCapture2 SDK Licensing Agreement................................................................................. 11
2-5.
FlyCapture2 SDK Release Notes ........................................................................................ 11
2-6.
FlyCapture2 SDK User Information ...................................................................................... 12
2-7.
FlyCapture2 SDK Installation Path ....................................................................................... 12
2-8.
FlyCapture2 SDK Installation Options ................................................................................... 13
2-9.
Camera Interface Selection for FlyCapture2 SDK ..................................................................... 13
2-10.
Confirm Camera Interface Selection for FlyCapture2 SDK ........................................................... 14
2-11.
Idle State Management Selection for FlyCapture2 SDK .............................................................. 15
2-12.
Install FlyCapture2 SDK ................................................................................................... 16
2-13.
FlyCapture2 SDK Installation Progress Bar
2-14.
FlyCapture2 SDK Finish Installation ..................................................................................... 17
2-15.
MeshLab Installer Initial Screen .......................................................................................... 19
2-16.
MeshLab End User License Agreement
2-17.
MeshLab Installation Path ................................................................................................. 20
2-18.
MeshLab Installation Completed ......................................................................................... 20
2-19.
3D Scanner Reference Design Installation Executable ............................................................... 21
2-20.
3D Scanner Reference Design Setup Wizard Screen................................................................. 21
2-21.
3D Scanner Design License Agreement Screen ....................................................................... 22
2-22.
3D Scanner Reference Design Installation Path Selection ........................................................... 22
2-23.
3D Scanner Reference Design Installation Confirmation ............................................................. 23
2-24.
3D Scanner Reference Design File Installation Progress............................................................. 23
2-25.
3D Scanner Reference Design Installation Completion ............................................................... 24
3-1.
Application Config File - ALGORITHM_TYPE .......................................................................... 26
3-2.
Application Config File - CAMERA_TYPE .............................................................................. 27
3-3.
Camera Shutter and Color Settings...................................................................................... 28
3-4.
Running the 3D Scanning Command Line Program................................................................... 29
3-5.
Command Line Menu Prompt
3-6.
3-7.
3-8.
3-9.
3-10.
3-11.
3-12.
3-13.
3-14.
3-15.
3-16.
3-17.
3-18.
3-19.
3-20.
3-21.
3-22.
...................................................................................................
............................................................................
................................................................................
............................................................................................
Calibration Board Attached to Flat Calibration Surface ...............................................................
Prepare Projector Step ....................................................................................................
Connecting the Camera to the Host PC .................................................................................
Projector, Camera, Object Spatial Orientation .........................................................................
Camera Calibration Board Live View ....................................................................................
Overexposed Camera Capture ...........................................................................................
Underexposed Camera Capture .........................................................................................
Camera Calibration Configuration File ..................................................................................
Calibration Board Image Capture Position 1 ...........................................................................
Calibration Board Image Capture Position 2 ...........................................................................
Calibration Board Image Capture Position 3 ...........................................................................
Calibration Board Image Capture Position 4 ...........................................................................
Calibration Board Image Capture Position 5 ...........................................................................
Calibration Board Image Capture Position 6 ...........................................................................
Calibration Board Image Capture Position 7 ...........................................................................
Calibration Board Image Capture Position 8 ...........................................................................
Calibration Board Image Capture Position 9 ...........................................................................
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
List of Figures
Copyright © 2015–2016, Texas Instruments Incorporated
10
16
19
29
30
31
32
33
34
35
36
36
37
37
38
38
39
39
40
40
41
3
www.ti.com
3-23.
Calibration Board Image Capture Position 10 .......................................................................... 41
3-24.
Number of Projector Calibration Shots .................................................................................. 43
3-25.
Projector Calibration Chessboard Capture.............................................................................. 44
3-26.
Projector Calibration Board Capture Position 1 ........................................................................ 45
3-27.
Projector Calibration Board Capture Position 2 ........................................................................ 45
3-28.
Projector Calibration Board Capture Position 3 ........................................................................ 46
3-29.
Projector Calibration Board Capture Position 4 ........................................................................ 46
3-30.
Projector Calibration Board Capture Position 5 ........................................................................ 47
3-31.
Projector Calibration Board Capture Position 6 ........................................................................ 47
3-32.
Projector Calibration Board Capture Position 7 ........................................................................ 48
3-33.
Projector Calibration Board Capture Position 8 ........................................................................ 48
3-34.
Projector Calibration Board Capture Position 9 ........................................................................ 49
3-35.
Projector Calibration Board Capture Position 10 ....................................................................... 49
3-36.
Typical Depth Map of a Flat Surface
3-37.
3-38.
3-39.
3-40.
4-1.
4-2.
4-3.
4-4.
4-5.
4-6.
4-7.
4
....................................................................................
Deficient Depth Map of a Flat Surface ..................................................................................
Point Cloud of a Flat Surface .............................................................................................
Point Cloud of a Flat Surface Generated With Poor Calibration Data...............................................
Point Cloud File Location for Use With MeshLab ......................................................................
Camera Configuration File ...............................................................................................
Projector Configuration File ...............................................................................................
FlyCap2 Software Utility Shortcut ........................................................................................
Configure Selected Camera in FlyCap2 Software .....................................................................
Restore Factory Camera Settings in FlyCap2 Software ..............................................................
Confirm Factory Camera Settings in FlyCap2 Software ..............................................................
Camera Configuration File Settings for USB 2.0 .......................................................................
List of Figures
51
52
53
54
55
56
57
57
58
59
59
60
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Copyright © 2015–2016, Texas Instruments Incorporated
www.ti.com
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
List of Figures
Copyright © 2015–2016, Texas Instruments Incorporated
5
Preface
TIDU985A – May 2015 – Revised May 2016
Read This First
About This Guide
The 3D Scanner Reference Design enables faster development of machine vision applications utilizing
DLP® platforms. This guide walks the user through the installation, calibration, and operation of the 3D
Scanner Reference Design, as well as building the program from source code.
Related Documentation from Texas Instruments
DLPC300 Datasheet: DLPC300 DLP® Digital Controller for the DLP3000 DMD, DLPS023
DLP3000 Datasheet: DLP3000 DLP® 0.3 WVGA Series 220 DMD, DLPS022
User's Guide: DLP® Lightcrafter™ Evaluation Module (EVM), DLPU006E
User's Guide: DLP® Advanced Light Control SDK for Lightcrafter™ Evaluation Modules, DLPU042
Assembly Guide: TIDA-00361 Camera Trigger Cable Assembly, TIDRIA2
If You Need Assistance
Refer to the DLP and MEMS TI E2E Community support forums:
http://e2e.ti.com/support/dlp__mems_micro-electro-mechanical_systems/default.aspx
Minimum System Requirements
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
PC with 1GHz, or faster, 32-bit (x86) processor
2GB RAM
10GB of free hard-disk space
Microsoft® Windows® 7 SP 1
Microsoft Visual C++ 2010 Redistributable
Microsoft Visual C++ 2012 Redistributable
Microsoft .NET Framework 4.5.1
USB 3.0 port
USB 2.0 port
Qt Creator 5.3.2 Integrated Design Environment (IDE)
OpenCV v2.4.10 Libraries
Point Grey FlyCapture® v 2.9 SDK
MeshLab v1.3.3
DLP® LightCrafter 3000™ Evaluation Module
Point Grey Flea®3 USB 3.0 Camera
Note: The 3D Scanner Reference Design installation and setup is written for users that are familiar with
navigating through Windows command line prompts.
Note: The 3D Scanner Reference Design was created with the above listed versions of each software
tool. Using newer versions of the software tools may render the code inoperable.
Lightcrafter, LightCrafter 3000 are trademarks of Texas Instruments.
DLP is a registered trademark of Texas Instruments.
Microsoft, Windows are registered trademarks of Microsoft Corporation.
FlyCapture, Flea are registered trademarks of Point Grey.
6
Read This First
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Copyright © 2015–2016, Texas Instruments Incorporated
Chapter 1
TIDU985A – May 2015 – Revised May 2016
Introduction to the 3D Scanner Reference Design
The 3D Scanner Reference Design is an active 3-dimensional photography system that generates a digital
representation of a physical object. The data generated by the 3D Scanner Reference Design can be
analyzed, or otherwise manipulated, to provide information to automated systems about their environment.
The information created by the 3D Scanner Reference Design allows machines to make intelligent
decisions in a dynamic environment. Applications include industrial automation, robotics, and digital
storage of physical objects.
1.1
Structured Light
Structured light is a method to achieve 3-dimensional photography of objects by manipulating lighting
conditions of a scene under study. The 3D Scanner Reference Design projects a series of timemultiplexed and three phase patterns to extract spatial data from a scene. The 3D Scanner Reference
Design leverages the highly-programmable DLP digital micromirror device to rapidly display patterns
reducing data acquisition times. DLP is also light source agnostic, making it well suited for structured light
applications using solid-state – near infrared, visible, or ultraviolet light – or laser-based illumination.
1.2
How the 3D Scanner Reference Design Works
The 3D Scanner Reference Design consists of a LightCrafter 3000 evaluation module and a camera
interfacing with a host PC. The 3D Scanner Reference Design utilizes multiple DLP Advanced Light
Control SDK for Lightcrafter EVMs (hereto referred to as DLP ALC SDK) modules to perform necessary
calculations on the host PC.
1.2.1 Projector and Camera Modules
The host PC must send and receive data from both a projector and camera. In this reference design, a
Point Grey Flea3 camera is used with a LightCrafter 3000 module that enables easy, feature-rich use of
the projector.
1.2.2 Calibration
The DLP ALC SDK contains a calibration module to estimate intrinsic and extrinsic parameters of both the
camera and projector. An example of the estimated parameters include focal point, lens distortion, and
spatial orientation of the camera to the projector. The calibration routine must be performed any time the
projector and camera change orientation with each other, or the devices are replaced.
1.2.3 Pattern Projection
Pattern projection is handled by a structured light module in the DLP ALC SDK. The module generates
vertical and horizontal Gray coded patterns or phase shifted patterns that are sent to a LightCrafter 3000
projector. The firmware file is prepared and uploaded to the projector using the LightCrafter 3000 module.
1.2.4 Image Capture
Each projected pattern is captured by the Point Grey Flea3 global or rolling shutter camera or a
compatible OpenCV camera (such as a webcam). The images are stored in an image class and the
information in the series of images is decoded by the structured light class.
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Introduction to the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
7
How the 3D Scanner Reference Design Works
www.ti.com
1.2.5 Information Decoding
The structured light class performs decoding of the captured images to determine which projector ray the
camera ray detects.
1.2.6 Point Cloud Reconstruction
Objects in view of both the camera and projector will cause different rays from the camera and projector to
intersect each other. This intersection can be calculated by using the Gray coded and/or phase-shifted ray
information from the projector along with the detected ray information from the captured images. This
intersection of rays determines an object's real point in space. The geometrical ray intersection
calculations are performed by a geometry module in the DLP ALC SDK for each intersecting point.
The points generated by the geometry module are stored in a collection called a point cloud. The point
cloud is all of the known points from a captured scene. Software tools and algorithms can be produced to
use point clouds to create solid surfaces. MeshLab is the software tool used to view point clouds during
the 3D Scanner Reference Design development.
8
Introduction to the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Chapter 2
TIDU985A – May 2015 – Revised May 2016
Installing the 3D Scanner Reference Design
Before using the 3D Scanner Reference Design application, a few software dependencies and the
reference design software itself must be installed. The Point Grey FlyCapture 2+ SDK supplies the drivers
required for operating the Point Grey Flea3 USB camera, and MeshLab acts as a 3D viewer for the
generated point cloud files. Please read the following sections for more detailed instructions.
2.1
Installing the Point Grey FlyCapture® 2+ Full SDK
The Point Grey software development kit (SDK) supplies the required drivers for image capture when
using the Point Grey cameras. This section walks the user through set up of the FlyCapture2 Full SDK.
Warning: Ensure that Microsoft .NET Framework is installed along with the Visual C++ redistributables
listed in the Minimum System Requirements.
1. Go to the Point Grey download site, located at http://www.ptgrey.com/support/downloads and
download the FlyCapture2 Full SDK for the appropriate operating system, as shown in Figure 2-1.
Note: When developing with the DLP ALC SDK, install the 32-bit version of the FlyCapture SDK to
ensure compatibility with the MinGW compiler used in later steps.
Figure 2-1. Point Grey Software Downloads Page
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
9
Installing the Point Grey FlyCapture® 2+ Full SDK
www.ti.com
2. Run the downloaded installation file and click the Install button, as shown in Figure 2-2.
Note: If the Microsoft .NET Framework has not already been installed, the FlyCapture installer will
attempt to install it.
Figure 2-2. Setting Up the FlyCapture2 Install
3. After extraction of the installation components, the installer will begin with a welcome page as shown in
Figure 2-3. Click the "Next" button to continue.
Figure 2-3. FlyCapture2 Installation
10
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the Point Grey FlyCapture® 2+ Full SDK
www.ti.com
4. Read and accept or decline the end-user license agreement for the FlyCapture2 SDK as shown in
Figure 2-4. If the license agreement is declined, the SDK will not be installed. Click the "Next" button
to continue.
Figure 2-4. FlyCapture2 SDK Licensing Agreement
5. Read the online release notes and click the "Next" button, shown in Figure 2-5, to proceed with the
installation.
Figure 2-5. FlyCapture2 SDK Release Notes
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
11
Installing the Point Grey FlyCapture® 2+ Full SDK
www.ti.com
6. Fill out the required Name and Organization fields and click the "Next" button, shown in Figure 2-6, to
proceed with the installation.
Figure 2-6. FlyCapture2 SDK User Information
7. Choose the installation directory where the FlyCapture2 SDK will be installed. Click the "Next" button,
highlighted in Figure 2-7.
Figure 2-7. FlyCapture2 SDK Installation Path
12
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the Point Grey FlyCapture® 2+ Full SDK
www.ti.com
8. Click the button labeled "Complete" to install the entire FlyCapture2 SDK, shown in Figure 2-8.
Figure 2-8. FlyCapture2 SDK Installation Options
9. Pick the camera interface that will be used. For the 3D Scanner Reference Design, the USB interface
is utilized. Select "I will use USB cameras," uncheck the box "Install USBPro", and then click the "Next"
button. The "Next" button and USB selection is shown in Figure 2-9.
Figure 2-9. Camera Interface Selection for FlyCapture2 SDK
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
13
Installing the Point Grey FlyCapture® 2+ Full SDK
www.ti.com
10. Once your options have been selected, the FlyCapture2 installer will confirm the settings. Check the
box labeled "Click to confirm," then click the "Next" button, shown in Figure 2-10.
Figure 2-10. Confirm Camera Interface Selection for FlyCapture2 SDK
14
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the Point Grey FlyCapture® 2+ Full SDK
www.ti.com
11. Allow FlyCapture2 to manage processor idle states while the SDK is in use. Accept the default
selection and click the "Next" button, shown in Figure 2-11.
Note: This option keeps the CPU running as long as the application executable or the Point Grey GUI
is active. This can significantly increase the computer's power consumption. After any experiment
being run, restore the power option to their previous default. On a Windows machine, search for and
select "power options" in the Start Menu. Click "More Power Options" then "Change Plan Settings" and
finally select "Restore Default Settings."
Figure 2-11. Idle State Management Selection for FlyCapture2 SDK
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
15
Installing the Point Grey FlyCapture® 2+ Full SDK
www.ti.com
12. Click the "Install" button, shown in Figure 2-12, to continue the installation.
Figure 2-12. Install FlyCapture2 SDK
13. Wait for the FlyCapture2 SDK files to install. The progress bar is shown in Figure 2-13.
Figure 2-13. FlyCapture2 SDK Installation Progress Bar
16
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the Point Grey FlyCapture® 2+ Full SDK
www.ti.com
14. After the installation is complete, click the "Finish" button shown in Figure 2-14.
Figure 2-14. FlyCapture2 SDK Finish Installation
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
17
Installing the LifeCam Cinema Camera Driver and Configuring the Camera
2.2
www.ti.com
Installing the LifeCam Cinema Camera Driver and Configuring the Camera
If using a Point Grey camera, this section may be skipped. Two important requirements for cameras used
in 3D machine vision systems are the ability to set the focus and exposure so that they do not
automatically adjust. For this reason, the Microsoft LifeCam Cinema camera was selected as the exposure
and focus can be set manually through the Microsoft LifeCam software. The installation and configuration
of the Microsoft LifeCam Cinema camera are detailed in this section.
1. Go to the Microsoft LifeCam Cinema device downloads website located at
http://www.microsoft.com/hardware/en-us/d/lifecam-cinema and download the software.
2. Run the downloaded installation file and click the "Next" button.
3. Read and accept the end-user license agreement and the privacy agreement by checking the "I accept
this agreement" checkbox and click the "Next" button.
4. The installer will download and install the required camera drivers and software.
5. After the files have finished installing, connect the camera via the USB port and click "Next."
6. If desired, Windows Live Essentials can be installed, but if not desired uncheck the "Install Windows
Live Essentials" checkbox and click "Next."
7. To complete the installation, click "Finish."
After the camera software has been installed, the camera should be configured so that the auto-exposure
and auto-focus are both turned off.
1. Open the LifeCam software with the camera connected and a live view should open. Click the arrow on
the right side of the window.
2. A new window will open to adjust effects of settings of the camera. Click the gear button at the top of
the window to show the settings.
3. Uncheck the "truecolor" checkbox.
4. Click the "Properties" button.
5. From the "Camera Control" tab, uncheck the auto-focus checkbox and click "Apply."
6. Change to the "Video Settings" tab, and set the "Brightness" and "Saturation" settings to their absolute
minimum values.
7. Uncheck both the auto-white balance and auto-exposure checkboxes and click "Apply."
8. With the LightCrafter projecting a white test pattern, adjust the Exposure settings until the image is well
exposed but not over-exposed.
18
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing MeshLab
www.ti.com
2.3
Installing MeshLab
MeshLab is the software utility recommended to view pointclouds generated by the reference design.
Installation of MeshLab is detailed in this section.
1. Go to the MeshLab website located at http://meshlab.sourceforge.net/ and download MeshLab V1.3.3
(or higher) executable.
2. As a system administrator, run the downloaded installation file and click the "Next" button as shown in
Figure 2-15.
Note: If the files fail to install, make sure the installation program is run with administrator privileges.
Running without administrator privileges will cause the installation to fail.
Figure 2-15. MeshLab Installer Initial Screen
3. Read and accept the end-user license agreement and the privacy agreement by clicking the "I Agree"
button once for each agreement, as shown in Figure 2-16.
Figure 2-16. MeshLab End User License Agreement
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
19
Downloading the 3D Scanner Reference Design
www.ti.com
4. Choose the installation directory for the MeshLab program, shown in Figure 2-17.
Figure 2-17. MeshLab Installation Path
5. Allow the files to be installed and, once completed, click the "Finish" button, highlighted in Figure 2-18.
Figure 2-18. MeshLab Installation Completed
2.4
Downloading the 3D Scanner Reference Design
Compiled Windows binaries for the 3D Scanner Reference Design are offered for convenience. The
binaries can be downloaded from the "Software" section of the reference design tool page at
http://www.ti.com/tool/TIDA-00361.
To build the source code for the reference design as well as the DLP Advanced Light Control SDK, please
refer to DLPU042.
20
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the 3D Scanner Reference Design
www.ti.com
2.5
Installing the 3D Scanner Reference Design
1. Decompress the "tidcb92.zip" file in a convenient location.
2. Install the 3D Scanner Reference Design by executing the file "TIDA00361-***-windows-installer.exe,"
as shown in Figure 2-19.
Figure 2-19. 3D Scanner Reference Design Installation Executable
3. Click the "Next" button on the install wizard setup screen, as shown in Figure 2-20.
Figure 2-20. 3D Scanner Reference Design Setup Wizard Screen
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
21
Installing the 3D Scanner Reference Design
www.ti.com
4. Read and review the license agreement for the 3D Scanner Reference Design, as shown in Figure 221. Click the "I accept the agreement" radio button and then click the "Next" button to continue
installing the software.
Figure 2-21. 3D Scanner Design License Agreement Screen
5. Select an installation path where the reference design software will be located. Click the "Next" button,
as shown in Figure 2-22. Click the "Next" button to continue installing the software.
Figure 2-22. 3D Scanner Reference Design Installation Path Selection
22
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the 3D Scanner Reference Design
www.ti.com
6. The installer is ready to install, click the "Next" button to start the process, as shown in Figure 2-23.
Figure 2-23. 3D Scanner Reference Design Installation Confirmation
7. Wait for the files to install in the location specified, as shown in Figure 2-24.
Figure 2-24. 3D Scanner Reference Design File Installation Progress
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
23
Installing the 3D Scanner Reference Design
www.ti.com
8. Once the files have been extracted and installed, click the "Finish" button to close the installer, as
shown in Figure 2-25.
Figure 2-25. 3D Scanner Reference Design Installation Completion
24
Installing the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Chapter 3
TIDU985A – May 2015 – Revised May 2016
Using the 3D Scanner Reference Design
The 3D Scanner Reference Design application allows users to quickly create a 3D scanner; complete with
calibration, setup, and scanning routines. The application generates the calibration board required to
calibrate the 3D scanner, as well as preparing the LightCrafter 3000 EVM with its own calibration and
structured light patterns. After preparing the calibration board and the LightCrafter 3000 EVM, the user
may calibrate the camera and projector. After the calibration procedures are complete, the application is
ready to perform 3D scans. Please follow all instructions to properly setup and use the 3D scanner.
3.1
Connecting the Hardware When Using a Point Grey Flea3 Camera
When using the 3D Scanner reference design with a Point Grey Flea3 camera the following hardware is
needed:
• LightCrafter 3000 EVM & power supply
• Point Grey Flea3 USB 3.0 camera and lens
• USB 2.0 A to mini-B Cable
• USB 3.0 A to micro-B Cable
• TIDA-00254 Camera Trigger Cable
– Assemble the required cable using the instructions from the TIDA-00361 Camera Trigger Cable
Assembly Guide: http://www.ti.com/lit/df/tidria2/tidria2.pdf
Connect the hardware as follows:
1. Power the LightCrafter 3000
2. Connect the LightCrafter 3000 to the PC's USB 2.0 port using the USB 2.0 cable
3. Connect the Point Grey camera to the PC's USB 3.0 port using the USB 3.0 cable
4. Connect the camera trigger cable to the Point Grey camera's GPIO port and the LightCrafter 3000
input trigger connector J7
3.2
Connecting the Hardware When Using the Microsoft LifeCam Cinema Camera
When using the 3D Scanner reference design with a Microsoft LifeCam Cinema camera the following
hardware is needed:
• LightCrafter 3000 EVM & power supply
• Microsoft LifeCam Cinema camera
• USB 2.0 A to mini-B Cable
Connect the hardware as follows:
1. Power the LightCrafter 3000
2. Connect the LightCrafter 3000 to the PC's USB 2.0 port using the USB 2.0 cable
3. Connect the Microsoft LifeCam Cinema camera with its attached USB cable
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
25
Configuring the Camera and Scan Type
3.3
www.ti.com
Configuring the Camera and Scan Type
This design features two methods of scanning: binary Gray code scanning and hybrid three-phase
scanning. It also allows the user to use the native Point Grey interface or the OpenCV camera interface.
To change the scan type, do the following:
1. After installing or building the design, find DLP_Lightcrafter_3D_Scan_Application_Config.txt in the
build or install folder for the reference design.
2. Open the text file.
Figure 3-1. Application Config File - ALGORITHM_TYPE
3. To perform a Gray code scan, ALGORITHM_TYPE should be set to "0". To perform a hybrid three
phase shift scan, ALGORITHM_TYPE should be "1." Figure 3-1 shows where the value should be
changed.
4. Once a selection has been made, save the file. Close and reopen the reference design executable (if it
was running) for the changes to take effect.
Note: For untriggered cameras such as a webcam, three-phase hybrid scanning will not work due to
the precise timing required. In general, any unsynchronized camera will not work with three-phase
hybrid scanning.
26
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Configuring the Camera and Scan Type
www.ti.com
To change the camera interface type, do the following:
1. Follow steps 1 and 2 above.
2. To change the camera type, CAMERA_TYPE, as shown in Figure 3-2, will have to be edited. Enter "0"
to use the OpenCV interface and "1" to use the native camera interface.
Figure 3-2. Application Config File - CAMERA_TYPE
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
27
Configuring the Camera and Scan Type
www.ti.com
To change between using a global shutter monochrome camera and a rolling shutter color camera, edit
the following:
1. Open config_camera.txt.
2. Figure 3-3 highlights the parameters that must be changed depending on the type of camera used. For
a rolling shutter color camera, make sure PG_FLYCAP_PARAMETERS_PIXEL_FORMAT is set to
"MONO8." If the camera is global shutter monochrome camera, set to "RAW8." Similarly, edit the
PG_FLYCAP_PARAMETERS_STROBE_DELAY to "5.0" for rolling shutter color cameras and "0.0" for
global shutter mono-chrome cameras.
Figure 3-3. Camera Shutter and Color Settings
28
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Creating the Calibration Board
www.ti.com
3.4
Creating the Calibration Board
This section guides the user through the generation and measurement of the camera calibration board.
1. Start the 3D Scanner Reference Design program, installed in Section 2.5, by running the executable
file, as shown in Figure 3-4.
Figure 3-4. Running the 3D Scanning Command Line Program
2. Run the "1: Generate camera calibration board and enter feature measurements" option by entering
"1" in the command line menu, as shown in Figure 3-5.
Figure 3-5. Command Line Menu Prompt
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
29
Creating the Calibration Board
www.ti.com
3. Once the command has been entered, the program will generate the calibration board. Print the
camera calibration board image that is found in the location indicated in the prompt
(calibration/camera_images/camera_calibration_board.bmp). The camera calibration board should be
approximately half the size of the total projection area.
4. Attach the printed calibration board to a flat, white surface that is larger than the projection area, as
shown in Figure 3-6. The number of squares on the grid can be changed in the configuration files for
the program. The default grid is 7 x 10.
Figure 3-6. Calibration Board Attached to Flat Calibration Surface
5. After attaching the camera calibration board to the calibration surface, measure the length of one side
of one of the squares on the grid and type the number into the command prompt as shown in
Figure 3-6. Do not enter any units in the command line. Hit enter to continue.
Note: The generated point clouds will show unit-less distances. The actual units depend on how you
measured your calibration board. For example, if each square is 2 cm wide, enter "2" into the prompt.
The generated point clouds will show distances which appear unitless but are actually in centimeters.
30
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Preparing the Projector
www.ti.com
3.5
Preparing the Projector
The LightCrafter 3000 system must be prepared with the calibration images and structured light patterns
for calibration and object scanning, respectively. The 3D Scanner Command Line program will prepare the
projector with the necessary images by selecting menu option "3: Prepare system for calibration and
scanning" by entering "3" in the command line, as shown in Figure 3-7. The system will need to be
prepared every time it is initialized.
Figure 3-7. Prepare Projector Step
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
31
Calibrating the Camera
3.6
www.ti.com
Calibrating the Camera
This section guides the user through the process of creating the physical connections between the
LightCrafter 3000, the host PC, and the Point Grey Flea3 camera and calibrating the camera.
Warning: Section 3.4 must be completed before the camera can be calibrated.
1. Connect the GPIO output trigger from the camera to the projector’s input trigger, using the cable
detailed in the file "TIDA-00361-CAMERA_TRIGGER_CABLE_ASSEMBLY.pdf", as shown in
Figure 3-8.
Figure 3-8. Connecting the Camera to the Host PC
2. Connect the Point Grey Flea3 camera to the host PC's USB 3.0 port.
3. Connect the LightCrafter 3000 to the host PC's USB 2.0 port.
32
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibrating the Camera
www.ti.com
4. Make sure there is sufficient distance between the camera and the projector. The camera and
projector should be separated by a 20 to 45 degree angle as formed by the object being scanned,
shown in Figure 3-9.
Figure 3-9. Projector, Camera, Object Spatial Orientation
5. Enter menu option "4" to start the camera calibration. Follow the prompts and directions on the screen
during the entire process.
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
33
Calibrating the Camera
www.ti.com
6. A live camera view window will appear on the host PC. Position the camera calibration board entirely
in the frame, as shown in Figure 3-10.
Figure 3-10. Camera Calibration Board Live View
34
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibrating the Camera
www.ti.com
7. Stop down the aperture as low as possible while still being able to discern the gray and white squares
on the calibration board and minimize all sources of glare. Make sure the projection area is in focus,
and lock the aperture and focus. An example of an overexposed image is shown in Figure 3-11, and
an example of an underexposed image is shown in Figure 3-12.
Note: If the camera's aperture size or focus is changed after this step, the resulting point cloud data
will be impacted. Perform camera calibration routine again if the results are undesired.
Figure 3-11. Overexposed Camera Capture
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
35
Calibrating the Camera
www.ti.com
Figure 3-12. Underexposed Camera Capture
8. Click on the live camera view window on the host PC and verify the calibration board is in focus.
9. From the live camera view window, position the camera at varying angles and distances from the
projection surface. Place the grid in different areas of the camera's view and press the SPACEBAR to
capture images. Default settings require twenty calibration images although this parameter can be
adjusted. In \config, find calibration_camera.txt. Figure 3-13 highlights the parameter which specifies
the number of calibration images. Some recommended calibration images are shown in Figure 3-14 to
Figure 3-23. It is okay to move the camera at this point in the calibration procedure.
Figure 3-13. Camera Calibration Configuration File
36
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibrating the Camera
www.ti.com
Figure 3-14. Calibration Board Image Capture Position 1
Figure 3-15. Calibration Board Image Capture Position 2
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
37
Calibrating the Camera
www.ti.com
Figure 3-16. Calibration Board Image Capture Position 3
Figure 3-17. Calibration Board Image Capture Position 4
38
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibrating the Camera
www.ti.com
Figure 3-18. Calibration Board Image Capture Position 5
Figure 3-19. Calibration Board Image Capture Position 6
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
39
Calibrating the Camera
www.ti.com
Figure 3-20. Calibration Board Image Capture Position 7
Figure 3-21. Calibration Board Image Capture Position 8
40
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibrating the Camera
www.ti.com
Figure 3-22. Calibration Board Image Capture Position 9
Figure 3-23. Calibration Board Image Capture Position 10
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
41
Calibrating the Camera
www.ti.com
10. The calibration process estimates the lens focal length, focal point, lens distortion, and the translation
and rotation of the camera relative to the calibration board. The calibration procedure will generate a
reprojection error. Zero reprojection error is ideal, however an error below 2 should be adequate for
typical usage. If the reprojection error is not satisfactory or if initial scans are not providing good
results, run the camera calibration routine again.
42
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibrating the Projector
www.ti.com
3.7
Calibrating the Projector
This procedure calibrates the projector and projector/camera system. Only perform this procedure with a
valid camera calibration already completed.
1. Once the camera calibration is complete and the projector has been prepared, the system calibration
can be performed. Start the system calibration process by entering "5" in the command line prompt.
Read the directions in the prompt in detail. Default calibration will require 5 images. To change this,
open calibration_projector.txt in \config. Figure 3-24 shows the parameter to change.
Figure 3-24. Number of Projector Calibration Shots
2. The projector will display a calibration board. The projected calibration board should be larger than the
camera calibration board but still fall entirely on the calibration surface. Adjust the camera's position to
center the projected calibration board in the live view.
3. Select the live camera view window and press the spacebar to capture the centered calibration board.
Avoid glare from the projected board or the captured image is discarded by the software. Rotate the
angle of the backstop on all 3 axes in the captured images. Figure 3-25 to Figure 3-35 show some
recommended projector calibration capture orientations. The camera captures three patterns after the
spacebar is clicked: solid white, black and white chessboard, and solid black.
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
43
Calibrating the Projector
www.ti.com
Figure 3-25. Projector Calibration Chessboard Capture
44
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibrating the Projector
www.ti.com
Figure 3-26. Projector Calibration Board Capture Position 1
Figure 3-27. Projector Calibration Board Capture Position 2
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
45
Calibrating the Projector
www.ti.com
Figure 3-28. Projector Calibration Board Capture Position 3
Figure 3-29. Projector Calibration Board Capture Position 4
46
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibrating the Projector
www.ti.com
Figure 3-30. Projector Calibration Board Capture Position 5
Figure 3-31. Projector Calibration Board Capture Position 6
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
47
Calibrating the Projector
www.ti.com
Figure 3-32. Projector Calibration Board Capture Position 7
Figure 3-33. Projector Calibration Board Capture Position 8
48
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibrating the Projector
www.ti.com
Figure 3-34. Projector Calibration Board Capture Position 9
Figure 3-35. Projector Calibration Board Capture Position 10
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
49
Calibrating the Projector
www.ti.com
4. Repeat step 3 a total of five times, capturing various angles and positions of the calibration board by
rotating and moving the calibration surface. Ensure the projected calibration board falls entirely on the
calibration surface in each capture.
5. The system calibration process estimates extrinsic and intrinsic parameters, and lens distortion
parameters, for the projector. The system calibration also estimates the camera-projector orientation.
The calibration procedure will generate a reprojection error similar to the camera calibration. Zero
reprojection error is ideal, however an error below 2 should be adequate for typical usage. If the
reprojection error is not satisfactory, verify the calibration as detailed in Section 3.8 before performing
the calibration again.
50
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibration Verification
www.ti.com
3.8
Calibration Verification
Once system calibration is complete, the calibration should be verified. Scan a flat, white surface, like the
backdrop for the printed calibration image, by entering the perform scan command "8" in the command
line menu. The output depth map should look similar to Figure 3-36. Performing a scan with both vertical
and horizontal patterns only works with the Lightcrafter set to use binary patterns only as discussed in
Section 3.3
Figure 3-36. Typical Depth Map of a Flat Surface
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
51
Calibration Verification
www.ti.com
If the depth map is missing a significant amount of points, as shown in Figure 3-37, check the
camera/projector synchronization by looking at the captured images and verifying the gray coding is
displayed correctly. It is also possible that the scene was not static. Please ensure that the objects being
scanned are not moving.
Figure 3-37. Deficient Depth Map of a Flat Surface
52
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Calibration Verification
www.ti.com
When the depth map is acceptably dense, open the output point cloud file using MeshLab. Inspect the
point cloud for accurate reproduction of the scanned board. An example of an acceptable point cloud
displayed in MeshLab is shown in Figure 3-38.
Figure 3-38. Point Cloud of a Flat Surface
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
53
Calibration Verification
www.ti.com
If the depth map is twisted or distorted around the edges, the calibration should be performed again with
special attention paid to placing the printed calibration board close to the edges of the camera frame. An
example of an unacceptable point cloud displayed in MeshLab is shown in Figure 3-39.
Note: The 3D Scanner Reference Design is capable of very accurate measurements. If the flat surface
being scanned has a perceivable twist in it, verify that the surface is not twisted as well before performing
the calibration routine again.
Figure 3-39. Point Cloud of a Flat Surface Generated With Poor Calibration Data
54
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Scanning Objects
www.ti.com
3.9
Scanning Objects
With the system calibration complete and verified, scanning of an object is done by placing the object of
interest in the field of view of the camera and projector. Run the 3D Scanner executable file and enter the
perform scan command "8." The object is scanned and a depth map image will open up. The output point
cloud is saved as an XYZ file in the ../output/scan/ directory, viewable in MeshLab, as shown in
Figure 3-40.
The system offers three types of scans. Option "6" uses only the horizontal patterns, options "7" uses only
the vertical patterns, and option "8" uses both types of patterns. Best results will be obtained by using both
types of patterns, being aware that option "8" cannot be used with three-phase hybrid scans.
Figure 3-40. Point Cloud File Location for Use With MeshLab
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Using the 3D Scanner Reference Design
Copyright © 2015–2016, Texas Instruments Incorporated
55
Chapter 4
TIDU985A – May 2015 – Revised May 2016
Troubleshooting
4.1
General Troubleshooting Steps
This chapter details the troubleshooting steps for common problems encountered by users.
• Problem: The LightCrafter 3000 projector will not connect to the 3D Scanner program.
Solution: Make sure the LightCrafter 3000 GUI is not running on the PC. Reset the LightCrafter 3000,
and reconnect using menu option "9."
• Problem: The projected images do not appear in the camera's live view on the PC.
Solution: It is likely that the LightCrafter 3000 and camera are not synchronized. Try reducing the
frame rate of the camera, reducing the shutter speed, and increasing the exposure time and pattern
period of the projector. These settings can be changed in the "config_camera.txt" and the
"config_projector.txt" files in the ../config/ folder, respectively. The camera settings file is shown in
Figure 4-1, and the projector settings are shown in Figure 4-2. In the example shown below, the
camera frame rate is set to 15 frames per second. The projector exposure and period are set to 60,000
microseconds. The formula for the conversion to and from frame rate to exposure is:
106 = Camera Frame Rate × Projector Exposure Time
(1)
Figure 4-1. Camera Configuration File
56
Troubleshooting
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Copyright © 2015–2016, Texas Instruments Incorporated
General Troubleshooting Steps
www.ti.com
Figure 4-2. Projector Configuration File
•
Problem: The camera appears to be running at a very low frame rate causing slow scan rates.
Solution: Close the 3D Scanner program by entering "0" at the main menu. Click the Windows Start
button and search for "flycap2." Open the Point Grey FlyCap2 software, as shown in Figure 4-3.
Figure 4-3. FlyCap2 Software Utility Shortcut
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Troubleshooting
Copyright © 2015–2016, Texas Instruments Incorporated
57
General Troubleshooting Steps
www.ti.com
Select the camera in use, in the case of a single camera, it will already be selected. Click the
Configure Selected button, as shown in Figure 4-4.
Figure 4-4. Configure Selected Camera in FlyCap2 Software
58
Troubleshooting
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Copyright © 2015–2016, Texas Instruments Incorporated
General Troubleshooting Steps
www.ti.com
Enter the Advanced Camera Settings tab on the left of the screen, make sure the memory channel is
set to default. Click the Save button, as shown in Figure 4-5.
Figure 4-5. Restore Factory Camera Settings in FlyCap2 Software
FlyCap2 software will prompt the user that the default setting will load the factory settings. Click the OK
button, as shown in Figure 4-6.
Figure 4-6. Confirm Factory Camera Settings in FlyCap2 Software
After the factory settings have been sent to the camera, disconnect the Flea3 camera from the PC.
Wait 3 seconds with the camera depowered before plugging the camera back into the PC. Restart the
3D Scanner program and try to scan an object to verify the solution.
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Troubleshooting
Copyright © 2015–2016, Texas Instruments Incorporated
59
General Troubleshooting Steps
•
www.ti.com
Problem: The host PC does NOT have a USB 3.0 port to connect the Flea3.
Solution: The Flea3 camera can be connected to a USB 2.0 port but must be run at a lower frame
rate. Open the file named "config_camera.txt" in the ../config/ folder and change the value for
"PG_FLYCAP_PARAMETERS_FRAME_RATE_HZ" to "30" or less, as shown in Figure 4-7. Change
the projector exposure and period in the "config_projector.txt" file according to the above frame
rate/exposure time equation.
Figure 4-7. Camera Configuration File Settings for USB 2.0
•
60
Problem: Attempting to scan an object, or take any captured image, causes a fatal error in the
operating system.
Solution: The Point Grey software can cause issues if the 3D Scanner program is terminated
unexpectedly due to unterminated camera execution threads. If your 3D Scanning program is closed in
any way other than entering "0" into the command prompt, put the PC into sleep mode – or restart the
PC entirely – before attempting to take a picture with the camera.
Troubleshooting
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Copyright © 2015–2016, Texas Instruments Incorporated
Revision History
www.ti.com
Revision History
NOTE: Page numbers for previous revisions may differ from page numbers in the current version.
Changes from Original (May 2015) to A Revision ........................................................................................................... Page
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Restructured document to follow format of other DLP user guides................................................................. 6
Added links to DLP ALC SDK and camera trigger cable assembly guide in Related Documentation from Texas
Instruments ................................................................................................................................. 6
Updated Minimum System Requirements from 5GB of space to 10GB ........................................................... 6
Added C++ redistributable and .NET frameworks, Qt creator, and OpenCV to Minimum System Requirements .......... 6
Updated Flycapture version number in Minimum System Requirements ......................................................... 6
Reworded to match related TI designs. ................................................................................................ 7
Edited Section 1.2 to include reference to DLP ALC SDK for source code ....................................................... 7
Updated screenshots to most recent version of Flycapture in Section 2.1 ........................................................ 9
Added information on using a standard webcam as the camera in Section 2.2 ................................................ 18
Removed information on compiling from source code and added reference to new DLP ALC SDK in Section 2.4 ....... 20
Updated screenshots and file names for installing 3D scanner design in Section 2.5 ......................................... 21
Removed lens specifics for Point Grey Flea3 USB 3.0 in Section 3.1 ........................................................... 25
Added Section 3.2 to describe hardware connections when using a webcam .................................................. 25
Added information on changing scan type and camera type in Section 3.3 ..................................................... 26
Added note on when three phase scanning can be used to Section 3.8......................................................... 51
Added note on which scan types are available for this TI design in Section 3.9 ................................................ 55
Added screenshots to troubleshooting steps and eliminated section on configuration files in Section 4.1 .................. 56
TIDU985A – May 2015 – Revised May 2016
Submit Documentation Feedback
Revision History
Copyright © 2015–2016, Texas Instruments Incorporated
61
IMPORTANT NOTICE
Texas Instruments Incorporated and its subsidiaries (TI) reserve the right to make corrections, enhancements, improvements and other
changes to its semiconductor products and services per JESD46, latest issue, and to discontinue any product or service per JESD48, latest
issue. Buyers should obtain the latest relevant information before placing orders and should verify that such information is current and
complete. All semiconductor products (also referred to herein as “components”) are sold subject to TI’s terms and conditions of sale
supplied at the time of order acknowledgment.
TI warrants performance of its components to the specifications applicable at the time of sale, in accordance with the warranty in TI’s terms
and conditions of sale of semiconductor products. Testing and other quality control techniques are used to the extent TI deems necessary
to support this warranty. Except where mandated by applicable law, testing of all parameters of each component is not necessarily
performed.
TI assumes no liability for applications assistance or the design of Buyers’ products. Buyers are responsible for their products and
applications using TI components. To minimize the risks associated with Buyers’ products and applications, Buyers should provide
adequate design and operating safeguards.
TI does not warrant or represent that any license, either express or implied, is granted under any patent right, copyright, mask work right, or
other intellectual property right relating to any combination, machine, or process in which TI components or services are used. Information
published by TI regarding third-party products or services does not constitute a license to use such products or services or a warranty or
endorsement thereof. Use of such information may require a license from a third party under the patents or other intellectual property of the
third party, or a license from TI under the patents or other intellectual property of TI.
Reproduction of significant portions of TI information in TI data books or data sheets is permissible only if reproduction is without alteration
and is accompanied by all associated warranties, conditions, limitations, and notices. TI is not responsible or liable for such altered
documentation. Information of third parties may be subject to additional restrictions.
Resale of TI components or services with statements different from or beyond the parameters stated by TI for that component or service
voids all express and any implied warranties for the associated TI component or service and is an unfair and deceptive business practice.
TI is not responsible or liable for any such statements.
Buyer acknowledges and agrees that it is solely responsible for compliance with all legal, regulatory and safety-related requirements
concerning its products, and any use of TI components in its applications, notwithstanding any applications-related information or support
that may be provided by TI. Buyer represents and agrees that it has all the necessary expertise to create and implement safeguards which
anticipate dangerous consequences of failures, monitor failures and their consequences, lessen the likelihood of failures that might cause
harm and take appropriate remedial actions. Buyer will fully indemnify TI and its representatives against any damages arising out of the use
of any TI components in safety-critical applications.
In some cases, TI components may be promoted specifically to facilitate safety-related applications. With such components, TI’s goal is to
help enable customers to design and create their own end-product solutions that meet applicable functional safety standards and
requirements. Nonetheless, such components are subject to these terms.
No TI components are authorized for use in FDA Class III (or similar life-critical medical equipment) unless authorized officers of the parties
have executed a special agreement specifically governing such use.
Only those TI components which TI has specifically designated as military grade or “enhanced plastic” are designed and intended for use in
military/aerospace applications or environments. Buyer acknowledges and agrees that any military or aerospace use of TI components
which have not been so designated is solely at the Buyer's risk, and that Buyer is solely responsible for compliance with all legal and
regulatory requirements in connection with such use.
TI has specifically designated certain components as meeting ISO/TS16949 requirements, mainly for automotive use. In any case of use of
non-designated products, TI will not be responsible for any failure to meet ISO/TS16949.
Products
Applications
Audio
www.ti.com/audio
Automotive and Transportation
www.ti.com/automotive
Amplifiers
amplifier.ti.com
Communications and Telecom
www.ti.com/communications
Data Converters
dataconverter.ti.com
Computers and Peripherals
www.ti.com/computers
DLP® Products
www.dlp.com
Consumer Electronics
www.ti.com/consumer-apps
DSP
dsp.ti.com
Energy and Lighting
www.ti.com/energy
Clocks and Timers
www.ti.com/clocks
Industrial
www.ti.com/industrial
Interface
interface.ti.com
Medical
www.ti.com/medical
Logic
logic.ti.com
Security
www.ti.com/security
Power Mgmt
power.ti.com
Space, Avionics and Defense
www.ti.com/space-avionics-defense
Microcontrollers
microcontroller.ti.com
Video and Imaging
www.ti.com/video
RFID
www.ti-rfid.com
OMAP Applications Processors
www.ti.com/omap
TI E2E Community
e2e.ti.com
Wireless Connectivity
www.ti.com/wirelessconnectivity
Mailing Address: Texas Instruments, Post Office Box 655303, Dallas, Texas 75265
Copyright © 2016, Texas Instruments Incorporated
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising