🖼️ 2D Image Editor - Standalone Software

🧩 Description

This project is a complete 2D image editor built with JavaFX as a standalone desktop application, designed to work with PNM image formats (PBM, PGM, PPM).

The editor supports a modular and extensible design and follows Agile principles (Scrum), unit and UI testing, and strong architectural practices (Layering, MVC, Design Patterns).

🧱 Software Architecture

The application is composed of two clearly separated Maven modules:

🔧 Backend

Implements a Layered Architecture:

• Application Layer: coordination and orchestration
• Business Layer: transformation logic, error management
• Data Access Layer: reading/writing PNM files

The backend is fully decoupled from the GUI and is designed for reusability and testability.

🎨 Frontend

Developed in JavaFX using MVC, with a dedicated controller dispatching events and updates to the view.
Notable design features:

• Observer Pattern: notifies UI components of model changes
• Adapter Pattern: unifies interaction between different UI elements (e.g., buttons, menu items)
• Abstract Factory Pattern: dynamic creation of format-specific image readers

🎮 Main Features

• 📂 Load and display PNM images (PBM, PGM, PPM – plain text and binary)
• 🔄 Apply image transformations:
  • Flip (vertical and horizontal)
  • Rotate 90° (clockwise and counter-clockwise)
  • Negative
• 🧪 Prepare and run a pipeline of transformation steps
• 💾 Save modified images in PNM format
• 🕓 Reopen recently used images
• 🌐 Multilingual UI without real-time switching
• 📁 User preferences saved in a plain-text config file
• ℹ️ Application info panel (version, build date, credits)

🛠️ Technologies Used

• Language: Java 17
• GUI Framework: JavaFX
• Build Tool: Maven (multi-module)
• Patterns: MVC, Observer, Adapter, Abstract Factory
• Persistence: PNM format, preferences in plain text
• Testing: JUnit 5, Mockito, JavaFX UI testing (robot)

🚀 How to Run the Project

⚠️ Ensure Java (JDK 17 or higher) is installed.

1. Clone the repository:

   git clone https://github.com/adelitoo/2D-image-editor.git

2. Navigate into the project folder:

   cd 2D-image-editor

3. Build and run the application:

   mvn javafx:run

Alternatively, execute the standalone .jar file located in the build/ or target/ directory.

📦 Requirements

• Java Development Kit (JDK) 17+
• JavaFX SDK (bundled or added via Maven)
• OS Compatibility: Windows, macOS, Linux

📚 Educational Goals

During the development, the following software engineering practices were applied:

• Agile methodology with Scrum (sprints, backlog, iterations)
• Software architecture principles (layering, modularization)
• Design patterns to support maintainability and scalability
• Internationalization and user interaction design
• Configuration management (Git, Maven)
• Comprehensive testing (unit + end-to-end)

The system aligns with the Open-Closed Principle (OCP), allowing new editing operations or file formats to be added without modifying the existing code.