NewTun.CaesiumSharp 1.0.0

NewTun.CaesiumSharp for C#

NewTun.CaesiumSharp is a powerful .NET wrapper for the Libcaesium library, providing seamless image compression and format conversion capabilities with an intuitive C# API.

Features

• 🚀 High Performance: Native C library integration for optimal speed
• 📦 Multiple Formats: Support for JPEG, PNG, GIF, WebP, and TIFF
• 🔧 Fine-grained Control: Extensive compression parameters for each format
• 💾 Flexible Input/Output: File-based and in-memory compression
• 🎯 Target Size Compression: Automatically compress to a specific file size
• 🔄 Format Conversion: Convert between different image formats
• 🧹 Metadata Management: Option to preserve or remove EXIF/ICC metadata
• 📐 Image Resizing: Scale images while compressing
• 🪶 Lightweight: No external dependencies beyond the native library

Installation

Prerequisites

• .NET 8.0 or higher

Via NuGet

dotnet add package NewTun.CaesiumSharp

Examples

• Program.cs

static void Main(string[] args)
{
    Console.WriteLine("Hello, World!");

    List<string> paths =
    [
        @"/Downloads/1.jpg",
        @"/Downloads/2.jpg",
        @"/Downloads/3.jpg",
        @"/Downloads/4.jpg",
        @"/Downloads/5.jpg",
    ];
    
    using (var compressor = new CaesiumCompressor())
    {
        // var parameters = compressor.GetDefaultParameters();
        var parameters = new CCSParameters()
        {
            KeepMetadata = false,
            JpegQuality = 30,
            
            PngQuality = 30,
            
            GifQuality = 30,
            
            WebpQuality = 30,
        };

        foreach (var path in paths)
        {
            if (compressor.CompressFile(path, Path.Combine(Path.GetDirectoryName(path), "scaled", Path.GetFileName(path)), parameters, out string? error))
            {
                Console.WriteLine("Compression successful!");
            }
            else
            {
                Console.WriteLine($"Compression failed: {error}");
            }
        }
    }
}

License

• This project is licensed under the MIT License - see the LICENSE file for details.

⭐ Star this repository if you find it useful!