How ishaannene/convo-boost works
Project Type & Purpose
• A macOS command‑line toolkit demonstrating GPU‑accelerated image processing via Apple’s Metal.
• Four standalone utilities: Random Image Generator, Image Effects Processor, Metal Convolution, PPM→PNG Converter.
Main Components
• CLI Frontends (four binaries)
• Core Processing Modules
– CPU-based image I/O & effects (C++17 using stb_image/write)
– GPU-based shaders (Metal kernels in .metal/Objective‑C++ .mm)
• File I/O
– PPM input/output
– Optional PNG output via stb_image_write or converter utility
• Build & Config
– CMakeLists.txt, build scripts, test scripts
Component Interactions
[User]
↓
CLI Tool (e.g., image_effects_processor)
↙ ↘
CPU Parser GPU Kernels
↘ ↙
Image Buffers
↓
File Output (PPM/PNG)
Architectural Patterns
• Modular CLI → each tool is a separate executable.
• Dual‑path processing: CPU fallback vs Metal pipeline.
• Shared libraries: stb_image for uniform I/O.