📸 SnapForge

SnapForge is a lightweight, fast, and intuitive Python library designed for easy image processing tasks. Whether you need to resize, convert, or manipulate images, SnapForge makes it a breeze!

✨ Features

• 🚀 Fast & Lightweight: Minimal overhead for quick image tasks.
• 🔄 Format Conversion: Easily switch between JPEG, PNG, BMP, and more.
• 📏 Smart Resizing: High-quality scaling and resizing capabilities.
• 🛠️ Easy API: Designed with developer experience in mind—simple commands for complex tasks.
• 🐍 Pythonic: Follows Python's best practices for a seamless integration.

📦 Installation

You can install SnapForge directly from PyPI using pip:

pip install snapforge


🚀 Quick Start

Here is a quick example to get you started with SnapForge:

import snapforge

# Load an image
img = snapforge.Snapforge("example.jpg")

# Resize the image
resized_img = img.resize(800,600)

# Convert and save the image
resized_img.convert("PNG").save("example_resized.png")

print("Image processed successfully!")

## 🧾 Feature Showcase (Full Reference)

Here is the complete list of all available methods in SnapForge:

Category	Method	Description	Example
Core	.convert(fmt)	Change image format (e.g., PNG, JPG)	.convert("PNG")
	.resize(w, h)	Change image dimensions	.resize(800, 600)
	.thumbnail(w, h)	Resize to fit within max dimensions (aspect ratio preserved)	.thumbnail(500, 500)
	.fit(w, h)	Resize and crop to exact dimensions (social media style)	.fit(1080, 1080)
	.crop(l, t, r, b)	Crop image to specific boundaries	.crop(0, 0, 100, 100)
	.rotate(a)	Rotate image by angle	.rotate(90)
	.optimize(q)	Set compression quality (1-100)	.optimize(85)
	.save(name)	Save the final forged image	.save("result.jpg")
Lighting	.apply_brightness(f)	Adjust brightness (factor > 1.0 is brighter)	.apply_brightness(1.2)
	.apply_contrast(f)	Adjust contrast (factor > 1.0 is higher)	.apply_contrast(1.5)
	.invert()	Invert image colors (negative effect)	.invert()
Filters	.apply_sepia()	Apply a classic vintage sepia effect	.apply_sepia()
	.apply_grayscale(f)	Convert to black & white (0.0 to 1.0)	.apply_grayscale(1.0)
	.apply_blur(r)	Apply Gaussian blur with radius r	.apply_blur(5.0)
	.apply_sharpen()	Enhance image sharpness/clarity	.apply_sharpen()
	.apply_camscanner()	Apply document scanner effect (B&W/Threshold)	.apply_camscanner()
	.apply_preset(name)	Apply professional mood (vintage, cinematic, etc.)	.apply_preset("vibrant")
Extras	.flip(dir)	Flip image (horizontal or vertical)	.flip("horizontal")
	.add_watermark(p)	Add a watermark image	.add_watermark("logo.png")
	.add_text(txt, pos)	Add custom text to the image	.add_text("Hello!", (50,50))
	.add_border(s, col)	Add a colored border around the image	.add_border(10, (0,0,0))
	.round_corners(r)	Round the corners of the image (requires RGBA)	.round_corners(40)
	.compare()	Show image metadata and status	.compare()


🛠️ Requirements

    Python: 3.7 or higher
    Dependencies: Pillow

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

📜 License

Distributed under the MIT License.

👤 Author

Ali.Shm
Project Maintainer