G12-2025-Final Project

h1. 💡 About Project

---

h2. I. Project Overview

Our project focuses on developing a high-quality image composition system capable of seamlessly merging two or more projected images into a single, visually uniform display. The goal is to ensure that the combined image appears continuous and free from visible seams, color shifts, or brightness inconsistencies.

Built using Python and OpenCV, the system applies a series of advanced image-processing techniques including gamma correction, alpha blending, and intensity adjustment to harmonize overlapping areas. These methods allow us to dynamically compensate for lighting variations and surface irregularities, resulting in a more accurate and visually pleasing projection output.

The project team is divided into multiple sub-groups, each focusing on specific responsibilities such as software development, UML design, testing, and wiki management. This structure encourages effective collaboration, clear communication, and consistent progress across all development phases.

To maintain transparency and ensure reproducibility, we integrate Doxygen for detailed source-code documentation and Redmine for structured task tracking and project coordination. Together, these tools support a development environment that prioritizes scalability, maintainability, and long-term usability.

Ultimately, the project aims to deliver a robust framework for real-time image correction and blending, serving as a foundation for future extensions in projection mapping, interactive displays, and multi-screen visualization systems.

---

h2. II. Motivation & Problem Statement

When using multiple projectors to display a single image, visible seams or brightness inconsistencies often occur in overlapping regions. These inconsistencies degrade image quality and make the final projection appear uneven.  

Manual calibration methods are time-consuming and prone to human error.  

Our motivation is to develop a software-based approach that automates the alignment and blending process, ensuring seamless image projection.  

By leveraging the **OpenCV** library, the system can detect overlapping areas, apply brightness corrections, and blend images smoothly — eliminating the need for costly hardware-based calibration systems.

---

h2. III. Objectives

* To develop an automated image blending system capable of merging two or more projections into a single seamless image.  

* To apply *gamma correction* and *intensity modification* techniques to balance color and brightness across overlapping regions.  

* To implement *alpha blending* for smooth transitions between images.  

* To design and visualize the system architecture using **UML diagrams**.  

* To document the entire project using **Doxygen** and manage tasks via **Redmine**.

---

h2. IV. Key Features

*1. Automated Image Blending*

Uses OpenCV and user-defined parameters to automatically blend two projected images, ensuring accurate overlap and alignment.

*2. Gamma Correction and Intensity Adjustment*

Employs advanced color and brightness correction algorithms to maintain consistent luminance across blended areas, effectively removing visible seams and mismatches.

*3. Video Blending*

Leverages GPU acceleration through PyTorch to calculate per-pixel brightness for video streams, enabling real-time blending and correction.

*4. User-Friendly Graphical Interface*

Provides an intuitive GUI that allows users to select interpolation modes, specify overlap pixels, and control blending parameters easily.

*5. Modular System Architecture*

Designed using UML-based class structures that divide the project into smaller, manageable components, improving scalability and ease of feature expansion.

*6. Comprehensive Documentation and Project Management*

Integrates Doxygen for automated code documentation and Redmine for task tracking, ensuring transparent collaboration and efficient workflow management.

---

h2. V. Algorithm and Theoretical Framework

_(Add later)_

---

h2. VI. System Architecture

_(Add later)_

---

h2. VII. Requirement Analysis

This defines the functional requirement of the project and outlining what the system needs to accomplish 

*- Image Input and Processing*

-The system must accept image files and video files as input.

-The system must split a given image into two sub-images (left and right) with a specific overlap region

-The system must allow users to choose a one out of the three blending mode (linear, quadratic, or gaussian).

-The system must apply blending algorithms using OpenCV and PyTorch for GPU-accelerated computation for videos.

-The system must save the blended images (left.png, right.png) locally after processing.

*- Video Frame Blending*

-The system must be able to process individual video frames sequentially for real-time blending.

-The system must output a smooth blended video stream without visible seams.

*- Graphical User Interface (GUI)*

-The system must let the user select the overlap pixel value from the GUI.

-The system must let the user choose the blending algorithm from the GUI.

-The system must be able to run both image and video blending modes in the GUI.

-The system must let the user view the original, left, and right images in real-time in the GUI.

-The system must be able display the blended outputs in fullscreen mode from the GUI.

*- Error Handling and Feedback*

-The system must handle missing files and display warnings or error messages appropriately.

-The GUI must handle invalid user input without crashing the program.

---

h2. VIII. Technology Stack

Our project combines a number of strong tools and technologies to make *image blending, documentation, and management* faster and more reliable.  

Each stack has a specific job to do to help the development workflow and keep the system working and easy to maintain.

---

h3. 🐍 Python (OpenCV, NumPy)

The major programming language we utilize to build our image-processing system is *Python*.  

It is flexible, easy to read, and has a large number of libraries that are good for scientific computing and computer vision.  

The *OpenCV* library is the heart of our picture blending technique. It has functions for filtering, correcting colors, and changing gamma.  

*NumPy* works with OpenCV to speed up calculations and make it easier to work with data by adding numerical and matrix-based operations.  

They work together to let us effortlessly combine several projected images, change brightness and contrast, and calibrate automatically with great accuracy.

---

h3. 📘 Doxygen

You can use *Doxygen* to make structured and easy-to-read documentation right from the codebase.  

It makes sure that our functions, variables, and logic are all linked and defined correctly, which makes it easy for future developers to understand and add to the system.  

Doxygen makes our source code more open, easier to maintain, and more consistent.

---

h3. 🧭 Redmine

*Redmine* is the main tool we use for project management and collaboration.  

It enables effective tracking of tasks, deadlines, and issues while maintaining clear communication among team members.  

Redmine makes sure that everyone in the team is on the same page about goals, progress, and deliverables by using Wiki pages, ticket tracking, and file sharing.  

It also lets you visualize project progress with *Gantt charts* and integrates version control.

---

h3. 🧩 Astah

You can use *Astah* to make UML diagrams such as class diagrams, use case diagrams, and sequence diagrams.  

These diagrams show the system's architecture, how components interact with each other, and how data flows across the system.  

This makes it easier to grasp complicated software systems.  

Astah helps people work together by making it easier to go from conceptual design to actual implementation.

---

These tools work together to create a *complete ecosystem* that helps with every step of development — from planning and building to writing documentation and managing projects.  

With this integrated technology stack, our team can create a strong, well-organized, and scalable system for combining images in real time.

---

h2. IX. Application & Impact

_(Add later)_

---

h2. X. Limitation & Future Enhancements

_(Add later)_

---

!https://media.tenor.com/Q14Y3rSxX5wAAAAM/plan-roadmap.gif!