G21-2024

> h2. [[Wiki]] | [[Team Members]] | [[Meeting Documentation]] | [[Our Project]] | [[Functional & Non-Functional Requirements]] | [[Math Document]] | [[UML Diagrams]] | [[Test Report]] | [[Results]]

h1. User Manual

*1. Introduction*

This project demonstrates how to display and “mesh” an image across two adjacent projectors, producing one larger, seamless image. It does so by applying a “mask” to the overlapping region so that the final displayed image appears continuous. The code uses OpenCV and NumPy for image processing and relies on python-dotenv for reading configuration variables (e.g., image path, projector spacing) from a .env file.

*2. System Requirements*

* Operating System: Mac OS (recommended/tested)

* Python: 3.x (e.g., Python 3.9+)

* Required Python Libraries:

# numpy==2.2.0

# opencv-python==4.10.0.84

# python-dotenv==1.0.1

h1. Setup

*Step 1: Install required packages*

* Run the following command to install all required packages (if not yet installed).

<pre><code class="shell">

pip install -r requirements.txt

</code></pre>

This will install the following packages:

* numpy==2.2.0

* opencv-python==4.10.0.84

* python-dotenv==1.0.1

*Step 2: Configure the Environment*

* Locate the image_configuration.env file and adjust the settings if needed:

* IMAGE_FILE_PATH: Path to the image you want to project.

* SIDE: Set as either left or right to specify the projector's position.

* DISTANCE_BETWEEN_PROJECTOR_CM: Distance between the two projectors in centimeters.

* PROJECTION_WIDTH_CM: The total width of the projection area in centimeters​.

* GAMMA_VALUE: The exponent value when creating the mask. Increase in value increases the intensity of intersection area.

*Step 3: Preparing the Code*

* Ensure the main.py script is in the working directory.

* Ensure the required images (e.g., Left.jpg, Right.jpg) are properly placed as referenced in the code.

h1. Running the Application

# Open a terminal in the project directory.

# Run the following command to execute the script:

<pre><code class="shell">

chmod +x run.sh

./run.sh

</code></pre>

# The script will automatically:

* Load the configuration from image_configuration.env.

* Process the images using the settings provided.

* Split and align the image for projection on two projectors.

* *Alignment:* The software handles automatic alignment of the image sections for both projectors.

* *Projection Area:* Adjust the position of the projectors to ensure proper overlapping at the image boundaries.

h1. Troubleshooting

*Issue 1: Misaligned Images*

* Ensure the DISTANCE_BETWEEN_PROJECTOR_CM and PROJECTION_WIDTH_CM are accurate.

* Verify both projectors are calibrated and aligned physically.

*Issue 2: Missing Libraries*

* Install the required libraries using:

<pre><code class="python">

pip install -r requirements.txt

</code></pre>

*Issue 3: Image File Not Found*

* Verify that the image file path in *image_configuration.env* matches the image's location.