Skip to content

An asynchronous utility for encoding images to Google's .webp format using lossy and lossless compression algorithms.

Notifications You must be signed in to change notification settings

frankodoom/libwebp.net

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

78 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

An asynchronous utility for encoding images to Google's .webp format. Seamlessly compress images to lossy and lossless formats in your .NET projects to improve network performance and reduce file size on disk. WebP generally has better compression than JPEG, PNG, and GIF and is designed to supersede them. You can see the library in action by using the webclient , your result will be downloaded into your browser.

Using the Library

General Usage

Below shows the basic use of the library using a console app.

 class Program
  {
    static async Task Main(string[] args)
     {

      // get file to encode
      using var file = new FileStream(@"C:\Users\fodoo\Desktop\logo.png", FileMode.Open);

      // copy file to Memory
       using var ms = new MemoryStream();
       await file.CopyToAsync(ms);
          
       //setup configuration for the encoder
       var config = new WebpConfigurationBuilder()
                       .Output("output.webp")
                       .Build();
                       
       // create an encoder and pass in the configuration
        var encoder = new WebpEncoder(config);

       // start encoding by passing your memorystream and filename      
       var output = await encoder.EncodeAsync(ms, Path.GetFileName(file.Name));

       /* your converted file is returned as FileStream, do what you want download,
          copy to disk, write to db or save on cloud storage,*/  
             
        Console.WriteLine($"Your output file : {Path.GetFileName(output.Name)}");
        Console.WriteLine($"Length in bytes : {output.Length}");
      }
   }

Asp.Net Core

Below demonstrates how the library is used in Asp.Net Core to convert uploaded images. This library is currently supported only in Windows Environments.

 public async Task<IActionResult> UploadAsync(IFormFile file)
       {

           if (file == null)
               throw new FileNotFoundException();

           //you can handle file checks ie. extensions, file size etc..
           
           //creating output file name
           // your name can be a unique Guid or any name of your choice with .webp extension..eg output.webp
           //in my case i am removing the extension from the uploaded file and appending
           // the .webp extension
           var oFileName = $"{Path.GetFileNameWithoutExtension(file.FileName)}.webp";

           // create your webp configuration
           var config = new WebpConfigurationBuilder()
              .Preset(Preset.PHOTO)
              .Output(oFileName)
              .Build();
           
           //create an encoder and pass in your configuration
           var encoder = new WebpEncoder(config);
           
          //copy file to memory stream
           var ms = new MemoryStream();
                    file.CopyTo(ms);
           
           //call the encoder and pass in the Memorystream and input FileName
           //the encoder after encoding will return a FileStream output
           
           //Optional cast to Stream to return file for download
           Stream fs = await encoder.EncodeAsync(ms, file.FileName);

           /*Do whatever you want with the file....download, copy to disk or 
             save to cloud*/

           return File(fs, "application/octet-stream", oFileName);
       }   

[Coming SOON!!!] Asp.Net Core MiddleWare

Libewebp.Net.Middleware is a separate package that depends on Libewebp.Net and allows you to inject image compression in your Asp.Net pipeline. This middleware will compress your specified image types using lossy and lossless angorithms.

Advanced Encoding

The encoder contains a lot advanced parameters. LibWebP.Net supports libWebp's advanced encoding API which can be used to better balance the trade-off between compression efficiency and processing time. You can get access to the advanced encode parameters by adding the various options below to your WebpConfigurationBuilder

  // create your WebP Configuration using fluent builder 
           var configuration = new WebpConfigurationBuilder()
                .Output("image.webp")
                .Preset(Preset.DEFAULT)
                .QualityFactor(200)
                .AlphaQ(10)
                 //.... add more advanced options//
                .Build();
              

Options

These options are currently supported in the library, use it to manipulate the compression algorithm for your desired output.

Option Description
AlphaQ(int value) transparency-compression quality (0..100)
CompressionMethod(int value) compression method (0=fast, 6=slowest)
Lossless() encode image losslessly
Preset(string value) one of default, photo, picture, drawing, icon, textd
QualityFactor(float value) quality factor (0:small..100:big)

Licence

Copyright 2021 

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.