Image Processing Toolkit

This is an image processing application written in Java. It provides various functionalities to process and modify images through thresholding, contrast adjustment, and color inversion. The application supports both a command-line interface and a user-friendly Swing GUI.

Features

• Binary Thresholding: Converts the image to black and white based on a threshold value.
• Multiple Thresholds: Applies multiple thresholds for enhanced image processing.
• Contrast Adjustment: Adjusts the contrast of the image below a specified threshold.
• Color Inversion: Inverts the colors of the image.
• Neighbor Adjustment: Modifies neighboring pixels of black pixels based on specific conditions.
• Multi-Format Support: Reads and writes images in various formats including PNG, JPG/JPEG, BMP, GIF, TIFF, and WBMP.
• Format Conversion: Converts between different image formats while processing.
• Graphical User Interface: Interactive Swing GUI with real-time preview and slider controls.

Usage

The application supports both graphical and command-line interfaces.

GUI Usage

Launch the graphical interface for interactive image processing:

java -cp target/classes Main --gui

GUI Features:

• File Menu: Open and save images in various formats
• Real-time Preview: See original and processed images side by side
• Interactive Controls:
  • Checkboxes for enabling/disabling effects
  • Sliders for adjusting threshold values and multiplier with real-time updates
  • Live value display for all parameters
• Status Bar: Shows current file information and processing status

GUI Controls:

• Effects Panel: Toggle binary threshold, neighbor adjustment, multiple thresholds, contrast adjustment, and color inversion
• Threshold Settings: Adjust binary threshold, white threshold, black threshold, contrast threshold, and multiplier using sliders
• Image Display: Scrollable panels showing original and processed images, automatically scaled for optimal viewing

Command-Line Usage

java -cp target/classes Main [inputFile] [outputFile] [outputFormat]

Parameters:

• inputFile (optional): Path to the input image file. Defaults to img.png if not specified.
• outputFile (optional): Path for the output image file. If not specified, uses auto-numbered PNG files.
• outputFormat (optional): Output format (png, jpg, jpeg, bmp, gif, tiff, wbmp). Auto-detected from output file extension if not specified.

Examples

GUI Mode:

# Launch interactive GUI
java -cp target/classes Main --gui

Command-line Mode:

# Convert PNG to JPG
java -cp target/classes Main input.png output.jpg

# Convert JPG to PNG with explicit format
java -cp target/classes Main photo.jpg result.png png

# Process BMP and save as GIF
java -cp target/classes Main image.bmp processed.gif

# Use default behavior (backward compatibility)
java -cp target/classes Main

Supported Formats

Input formats: PNG, JPG, JPEG, BMP, GIF, TIFF, WBMP Output formats: PNG, JPG, JPEG, BMP, GIF, TIFF, WBMP

The application automatically detects input formats and validates format support with helpful error messages.

How It Works

1. The application reads an input image from the specified file (or img.png by default).
2. It processes the image according to the specified configuration in the ImageConfig class.
3. The processed image is saved in the specified format and location.
4. If no output parameters are provided, it maintains backward compatibility by saving as outputX.png.

Configuration

The application uses a nested static class ImageConfig to configure the processing parameters. Below are the available options:

• useBinaryThreshold (default: true): Enables or disables binary thresholding.
• adjustBlackPixelsNeighbors (default: false): Adjusts neighboring pixels of black pixels if enabled.
• useMultipleThresholds (default: false): Enables or disables multiple threshold processing.
• applyContrast (default: false): Enables or disables contrast adjustment.
• invertColors (default: false): Enables or disables color inversion.
• binaryThreshold (default: 0.53): The threshold value for binary thresholding.
• whiteThreshold (default: 0.9): The threshold for identifying white pixels in multiple thresholding.
• blackThreshold (default: 0.7): The threshold for identifying black pixels in multiple thresholding.
• contrastThreshold (default: 0.0): The contrast adjustment threshold.
• multiplier (default: 0.0): The multiplier used for contrast adjustment.

Methods Overview

Image Processing

• processImage(BufferedImage image, ImageConfig config): Processes the input image using the specified configuration.
• applyThreshold(BufferedImage source, BufferedImage target, ImageConfig config): Applies binary or multiple thresholds to the image.
• invertColors(BufferedImage image): Inverts the colors of the input image.
• adjustBlackPixelsNeighbors(BufferedImage image): Adjusts neighboring pixels of black pixels in the image.

Utility Methods

• calculateMagnitude(Color color): Calculates the normalized magnitude of a color based on its RGB components.
• applyMultipleThresholds(Color pixelColor, double magnitude, BufferedImage target, int x, int y, ImageConfig config): Applies multiple thresholds to a pixel and modifies the target image.
• checkAndAdjustNeighbors(BufferedImage image, int x, int y): Checks the neighbors of a black pixel and adjusts them if they are white.
• isValidPosition(int x, int y, int width, int height): Validates the coordinates of a pixel.
• isWhitePixel(BufferedImage image, int x, int y): Checks if a pixel is white.
• getFileExtension(String filename): Extracts the file extension from a filename.
• isFormatSupported(String format, boolean forReading): Checks if a given format is supported for reading or writing.
• getSupportedFormats(boolean forReading): Gets all supported image formats.
• saveImage(BufferedImage image): Saves the processed image to an auto-numbered PNG file (legacy behavior).
• saveImage(BufferedImage image, String filename, String format): Saves the processed image to a specified file in the given format.