Table of Contents

1. Production Lens Validation Tool
2. Key Features
3. Our Team
4. Getting Started
   • Windows Build Instructions
     • Dependencies
     • Installation
   • Ubuntu Build Instructions
     • Dependencies
     • Installation
5. License

Production Lens Validation Tool

An application created for the lens testing team at OptiTrack that takes an image and identifies and grades the relevant lens' quality by examining how circular the markers are.

**Alt text:** Full view of the application using zoom view and displaying focus and lens statistics.

The program the lens testing team currently uses is intended for direct motion capture usage and is therefore much more technically complex than what's required for basic lens testing. Our program is intended to be a lightweight and easy to use solution for the team, who'll experience the same functionality, but in a much more streamlined way.

Key Features

• Viewing focus and circularity metrics via graphs and plain numbers
• Clear, color-coded pass/inconclusive/fail lens grading metrics
• Ability to export lens metrics
• Dual-language options (English and Simplified Chinese)
• Mode to zoom in on outer quadrants or specific markers

Our Team

Daniel Green (fuzzylogic88) --> Team Captain, Scrum Master
Nathan Puckett (natpuck) --> GUI
Bernardo Mendes (BernardoM03) --> Implementation
Jack Ollenbrook (OllenJ) --> Implementation
Raed Kabir (Reptop) --> GUI, Implementation

Getting Started

Windows Build Instructions

Dependencies

• Qt 6.10.0 (Important: select the msvc2022_64 component during installation)
• OpenCV 4.12.0
• MSVC2022_64 C++ toolchain
• Cmake 4.1.2

Installation

1. Clone this repository. ⚠️Avoid placing it too deep in your file system; Windows max-path issues can break the build script.
2. Set environment variables (configure-time only)
   • OPENCV_DIR = ..\opencv\build
   • OPENCV_BIN_DIR = ..\opencv\build\bin
   • Qt6_DIR = ..\Qt\6.10.0\msvc2022_64\lib\cmake\Qt6
   • QT_PLUGIN_PATH = ..\Qt\6.10.0\msvc2022_64\plugins Avoid setting QT_PLUGIN_PATH globally; deployment handles plugins.
3. Build using the provided script:

   ..\Production-Lens-Validation\CameraViewerApp\winBuild.bat
   

   Example:./WinBuild.bat <CameraSDK_PATH>
4. Your executable will be located at ..\Production-Lens-Validation\CameraViewerApp\build\Release\CameraViewerApp.exe.

Ubuntu Build Instructions

Dependencies

1. Install Dependencies:

   sudo apt update && sudo apt install -y cmake git build-essential
   qt6-base-dev qt6-base-private-dev qt6-tools-dev qt6-svg-dev
   libgl1-mesa-dev libjpeg-dev libopencv-dev python3-opencv
   

Installation

1. Clone Repository
   Navigate to the directory where you want the project, then run:

   git clone https://github.com/fuzzylogic88/Production-Lens-Validation.git
   cd Production-Lens-Validation
   

2. Build Project

   chmod +x build.sh
   ./build.sh ../OptiTrack_Camera_SDK_3.4.1_Final_Ubuntu
   

3. (Optional) Enable color camera support (FFmpeg)

   • Install FFmpeg:

     sudo apt install -y ffmpeg
     

   • Build with FFmpeg support:

     ./linuxBuild.sh ../CameraSDK --ffmpeg
     

4. Configure network (required)
   Set the camera network interface to Link-Local Only:
   Settings → Network → Wired (camera port) → IPv4 → IPv4 Method → Link-Local Only

5. Run application
   ./build/CameraViewerApp

License

All non-third party code included in this repository is jointly owned by the team mentioned above and NaturalPoint Inc. DBA OptiTrack.

Distributed under the GNU LESSER GENERAL PUBLIC LICENSE License. See LICENSE.txt in the "licenses" folder for more information. Third-party licenses can also be found in the "licenses" folder, named accordingly.