画像

[C#] 画像ファイルをavifフォーマットに変換する方法

2025-01-18更新日: 2025-01-18

C#で画像ファイルをAVIFフォーマットに変換するには、標準ライブラリでは直接サポートされていないため、外部ライブラリを使用する必要があります。

例えば、libavifやImageMagickのC#バインディングを利用する方法があります。

ImageMagickを使う場合、Magick.NETライブラリをNuGetからインストールし、画像を読み込んでAVIF形式で保存することが可能です。

目次から探す

Magick.NETを使ったAVIF変換
libavifを使ったAVIF変換
画像変換のエラーハンドリング
複数画像の一括変換
画像変換の応用例
まとめ

Magick.NETを使ったAVIF変換

Magick.NETとは

Magick.NETは、ImageMagickの.NETラッパーであり、画像の処理や変換を簡単に行うことができるライブラリです。

多くの画像フォーマットに対応しており、特にAVIFフォーマットへの変換もサポートしています。

これにより、開発者は高品質な画像を効率的に扱うことができます。

Magick.NETのインストール手順

Magick.NETをプロジェクトに追加するには、NuGetパッケージマネージャを使用します。

以下の手順でインストールできます。

Visual Studioを開く
プロジェクトを右クリックし、「NuGetパッケージの管理」を選択
「参照」タブで Magick.NET を検索
Magick.NET-Q8-AnyCPU を選択し、インストール

または、以下のコマンドを使用してインストールすることもできます。

Install-Package Magick.NET-Q8-AnyCPU

画像を読み込む方法

Magick.NETを使用して画像を読み込むには、MagickImageクラスを使用します。

以下は、画像を読み込むサンプルコードです。

using ImageMagick;
class Program
{
    static void Main(string[] args)
    {
        // 画像ファイルのパスを指定
        string inputFilePath = "input.jpg";
        
        // 画像を読み込む
        using (var image = new MagickImage(inputFilePath))
        {
            // 画像の情報を表示
            Console.WriteLine($"幅: {image.Width}, 高さ: {image.Height}");
        }
    }
}

幅: 800, 高さ: 600

画像をAVIF形式で保存する方法

画像をAVIF形式で保存するには、Writeメソッドを使用します。

以下は、AVIF形式で保存するサンプルコードです。

using ImageMagick;
class Program
{
    static void Main(string[] args)
    {
        // 画像ファイルのパスを指定
        string inputFilePath = "input.jpg";
        string outputFilePath = "output.avif";
        
        // 画像を読み込む
        using (var image = new MagickImage(inputFilePath))
        {
            // AVIF形式で保存
            image.Write(outputFilePath);
            Console.WriteLine("AVIF形式で保存しました。");
        }
    }
}

AVIF形式で保存しました。

変換時のオプション設定(圧縮率、品質など)

AVIF形式で保存する際には、圧縮率や品質を設定することができます。

以下は、オプションを設定するサンプルコードです。

using ImageMagick;

class Program
{
    static void Main(string[] args)
    {
        // 画像ファイルのパスを指定
        string inputFilePath = "input.jpg";
        string outputFilePath = "output.avif";

        // 画像を読み込む
        using (var image = new MagickImage(inputFilePath))
        {
            // 圧縮率を設定
            image.Quality = 75;

            // AVIF形式で保存
            image.Write(outputFilePath);
            Console.WriteLine("AVIF形式で保存しました。");
        }
    }
}

AVIF形式で保存しました。

このように、Magick.NETを使用することで、簡単に画像をAVIF形式に変換することができます。

圧縮率や品質を調整することで、最適な画像を生成することが可能です。

libavifを使ったAVIF変換

libavifとは

libavifは、AV1 Image File Format (AVIF) のためのオープンソースライブラリです。

GitHub – AOMediaCodec/libavif: libavif – Library for encoding and decoding .avif files

libavif – Library for encoding and decoding .avif files – AOMediaCodec/libavif

GitHub

AVIFは、AV1コーデックを使用して高効率な画像圧縮を実現するフォーマットで、JPEGやPNGに比べて高い圧縮率を持ちながら、同等またはそれ以上の画質を提供します。

libavifを使用することで、C#アプリケーションでもAVIF形式の画像を簡単に扱うことができます。

libavifのC#バインディングの導入方法

libavifをC#で使用するためには、C#バインディングを導入する必要があります。

以下の手順で導入できます。

libavifのC#バインディングをGitHubからダウンロードします。
プロジェクトにバインディングを追加します。
必要な依存関係をNuGetからインストールします。

具体的には、以下のコマンドを使用して、libavifのC#バインディングをインストールします。

Install-Package LibAvifSharp

画像を読み込む方法

libavifを使用して画像を読み込むには、AvifImageクラスを使用します。

以下は、画像を読み込むサンプルコードです。

using LibAvifSharp;
class Program
{
    static void Main(string[] args)
    {
        // 画像ファイルのパスを指定
        string inputFilePath = "input.avif";
        
        // 画像を読み込む
        using (var image = AvifImage.Load(inputFilePath))
        {
            // 画像の情報を表示
            Console.WriteLine($"幅: {image.Width}, 高さ: {image.Height}");
        }
    }
}

幅: 800, 高さ: 600

画像をAVIF形式で保存する方法

画像をAVIF形式で保存するには、Saveメソッドを使用します。

以下は、AVIF形式で保存するサンプルコードです。

using LibAvifSharp;
class Program
{
    static void Main(string[] args)
    {
        // 画像ファイルのパスを指定
        string inputFilePath = "input.png";
        string outputFilePath = "output.avif";
        
        // 画像を読み込む
        using (var image = AvifImage.Load(inputFilePath))
        {
            // AVIF形式で保存
            image.Save(outputFilePath);
            Console.WriteLine("AVIF形式で保存しました。");
        }
    }
}

AVIF形式で保存しました。

変換時のパフォーマンス最適化

AVIF形式での変換時にパフォーマンスを最適化するためには、以下のポイントに注意することが重要です。

圧縮設定: 圧縮率を調整することで、変換速度と画像品質のバランスを取ることができます。
マルチスレッド処理: 画像処理をマルチスレッドで行うことで、処理速度を向上させることができます。
メモリ管理: 大きな画像を扱う場合は、メモリの使用量を最適化することが重要です。

不要なオブジェクトを早めに解放するように心がけましょう。

以下は、圧縮率を設定してAVIF形式で保存するサンプルコードです。

using LibAvifSharp;
class Program
{
    static void Main(string[] args)
    {
        // 画像ファイルのパスを指定
        string inputFilePath = "input.png";
        string outputFilePath = "output.avif";
        
        // 画像を読み込む
        using (var image = AvifImage.Load(inputFilePath))
        {
            // AVIF形式で保存する際の圧縮設定
            var options = new AvifSaveOptions
            {
                Quality = 75 // 圧縮率を設定
            };
            
            // AVIF形式で保存
            image.Save(outputFilePath, options);
            Console.WriteLine("AVIF形式で保存しました。");
        }
    }
}

AVIF形式で保存しました。

このように、libavifを使用することで、C#アプリケーションにおいてもAVIF形式の画像を効率的に扱うことができます。

パフォーマンス最適化のポイントを押さえることで、よりスムーズな画像処理が可能になります。

画像変換のエラーハンドリング

変換時に発生しやすいエラー

画像変換を行う際には、いくつかの一般的なエラーが発生する可能性があります。

以下は、よく見られるエラーの例です。

エラーの種類	説明
ファイルが見つからないエラー	指定した画像ファイルが存在しない場合に発生します。
フォーマット不正エラー	読み込もうとした画像がサポートされていないフォーマットの場合に発生します。
メモリ不足エラー	大きな画像を処理する際に、メモリが不足することがあります。
書き込みエラー	出力先のディレクトリに書き込み権限がない場合に発生します。

例外処理の実装方法

C#では、try-catchブロックを使用して例外処理を実装します。

以下は、画像変換時のエラーハンドリングを行うサンプルコードです。

using ImageMagick;
using System;
class Program
{
    static void Main(string[] args)
    {
        string inputFilePath = "input.jpg";
        string outputFilePath = "output.avif";
        try
        {
            // 画像を読み込む
            using (var image = new MagickImage(inputFilePath))
            {
                // AVIF形式で保存
                image.Write(outputFilePath);
                Console.WriteLine("AVIF形式で保存しました。");
            }
        }
        catch (FileNotFoundException ex)
        {
            Console.WriteLine($"エラー: ファイルが見つかりません - {ex.Message}");
        }
        catch (MagickException ex)
        {
            Console.WriteLine($"エラー: 画像処理中に問題が発生しました - {ex.Message}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"エラー: {ex.Message}");
        }
    }
}

エラー: ファイルが見つかりません - 指定されたファイルが見つかりません。

このように、特定の例外をキャッチすることで、エラーの原因を特定しやすくなります。

画像フォーマットのサポートチェック

画像を変換する前に、指定したフォーマットがサポートされているかを確認することが重要です。

以下は、サポートされているフォーマットをチェックするサンプルコードです。

using ImageMagick;
using System;
class Program
{
    static void Main(string[] args)
    {
        string inputFilePath = "input.jpg";
        // サポートされているフォーマットを取得
        var supportedFormats = MagickImage.Formats;
        // 画像フォーマットのチェック
        string fileExtension = System.IO.Path.GetExtension(inputFilePath).ToLower();
        if (!supportedFormats.Contains(fileExtension))
        {
            Console.WriteLine("エラー: このフォーマットはサポートされていません。");
            return;
        }
        try
        {
            // 画像を読み込む
            using (var image = new MagickImage(inputFilePath))
            {
                Console.WriteLine("画像が正常に読み込まれました。");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"エラー: {ex.Message}");
        }
    }
}

画像が正常に読み込まれました。

このように、画像フォーマットのサポートチェックを行うことで、変換時のエラーを未然に防ぐことができます。

エラーハンドリングを適切に実装することで、ユーザーにとって使いやすいアプリケーションを作成することが可能です。

複数画像の一括変換

複数ファイルの読み込み方法

複数の画像ファイルを一括で読み込むには、Directory.GetFilesメソッドを使用して指定したディレクトリ内のファイルを取得します。

以下は、特定のフォーマットの画像ファイルを読み込むサンプルコードです。

using System;
using System.IO;
class Program
{
    static void Main(string[] args)
    {
        // 画像ファイルが格納されているディレクトリのパス
        string directoryPath = "images";
        
        // JPEGファイルを取得
        string[] imageFiles = Directory.GetFiles(directoryPath, "*.jpg");
        // 読み込んだファイルの数を表示
        Console.WriteLine($"読み込んだファイル数: {imageFiles.Length}");
    }
}

読み込んだファイル数: 5

ループ処理での一括変換

取得した画像ファイルをループ処理で一括変換することができます。

以下は、JPEGファイルをAVIF形式に変換するサンプルコードです。

using ImageMagick;
using System;
using System.IO;
class Program
{
    static void Main(string[] args)
    {
        // 画像ファイルが格納されているディレクトリのパス
        string directoryPath = "images";
        string[] imageFiles = Directory.GetFiles(directoryPath, "*.jpg");
        foreach (var inputFilePath in imageFiles)
        {
            // 出力ファイルのパスを生成
            string outputFilePath = Path.ChangeExtension(inputFilePath, ".avif");
            try
            {
                // 画像を読み込む
                using (var image = new MagickImage(inputFilePath))
                {
                    // AVIF形式で保存
                    image.Write(outputFilePath);
                    Console.WriteLine($"{inputFilePath} を {outputFilePath} に変換しました。");
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"エラー: {ex.Message} - {inputFilePath}");
            }
        }
    }
}

images/image1.jpg を images/image1.avif に変換しました。
images/image2.jpg を images/image2.avif に変換しました。
エラー: ファイルが見つかりません - images/image3.jpg

変換結果の保存先指定

変換結果の保存先を指定するには、出力ファイルのパスを適切に設定する必要があります。

以下は、変換結果を別のディレクトリに保存するサンプルコードです。

using ImageMagick;
using System;
using System.IO;
class Program
{
    static void Main(string[] args)
    {
        // 画像ファイルが格納されているディレクトリのパス
        string inputDirectoryPath = "images";
        string outputDirectoryPath = "converted_images";
        // 出力ディレクトリが存在しない場合は作成
        if (!Directory.Exists(outputDirectoryPath))
        {
            Directory.CreateDirectory(outputDirectoryPath);
        }
        string[] imageFiles = Directory.GetFiles(inputDirectoryPath, "*.jpg");
        foreach (var inputFilePath in imageFiles)
        {
            // 出力ファイルのパスを生成
            string outputFilePath = Path.Combine(outputDirectoryPath, Path.GetFileNameWithoutExtension(inputFilePath) + ".avif");
            try
            {
                // 画像を読み込む
                using (var image = new MagickImage(inputFilePath))
                {
                    // AVIF形式で保存
                    image.Write(outputFilePath);
                    Console.WriteLine($"{inputFilePath} を {outputFilePath} に変換しました。");
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"エラー: {ex.Message} - {inputFilePath}");
            }
        }
    }
}

images/image1.jpg を converted_images/image1.avif に変換しました。
images/image2.jpg を converted_images/image2.avif に変換しました。
エラー: ファイルが見つかりません - images/image3.jpg

このように、複数の画像を一括で変換する際には、ファイルの読み込み、ループ処理、保存先の指定を適切に行うことで、効率的に処理を進めることができます。

画像変換の応用例

画像のリサイズとAVIF変換の同時処理

画像をAVIF形式に変換する際に、同時にリサイズを行うことができます。

以下は、画像を指定したサイズにリサイズしながらAVIF形式に変換するサンプルコードです。

using ImageMagick;
using System;
using System.IO;
class Program
{
    static void Main(string[] args)
    {
        string inputFilePath = "input.jpg";
        string outputFilePath = "output.avif";
        
        // リサイズの幅と高さを指定
        int newWidth = 400;
        int newHeight = 300;
        try
        {
            // 画像を読み込む
            using (var image = new MagickImage(inputFilePath))
            {
                // 画像をリサイズ
                image.Resize(newWidth, newHeight);
                
                // AVIF形式で保存
                image.Write(outputFilePath);
                Console.WriteLine("リサイズとAVIF変換が完了しました。");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"エラー: {ex.Message}");
        }
    }
}

リサイズとAVIF変換が完了しました。

画像の圧縮とAVIF変換の組み合わせ

AVIF形式に変換する際に、圧縮率を設定することでファイルサイズを小さくすることができます。

以下は、圧縮率を指定してAVIF形式に変換するサンプルコードです。

using ImageMagick;
using System;
using System.IO;
class Program
{
    static void Main(string[] args)
    {
        string inputFilePath = "input.jpg";
        string outputFilePath = "output.avif";
        
        // 圧縮率を指定
        int quality = 50; // 0から100の範囲で指定
        try
        {
            // 画像を読み込む
            using (var image = new MagickImage(inputFilePath))
            {
                // AVIF形式で保存する際の圧縮設定
                var options = new MagickReadSettings
                {
                    Quality = quality
                };
                
                // AVIF形式で保存
                image.Write(outputFilePath, options);
                Console.WriteLine("圧縮とAVIF変換が完了しました。");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"エラー: {ex.Message}");
        }
    }
}

圧縮とAVIF変換が完了しました。

WebアプリケーションでのAVIF変換機能の実装

Webアプリケーションにおいて、ユーザーがアップロードした画像をAVIF形式に変換する機能を実装することができます。

以下は、ASP.NET Coreを使用したサンプルコードです。

using Microsoft.AspNetCore.Mvc;
using ImageMagick;
using System.IO;
using System.Threading.Tasks;
public class ImageController : Controller
{
    [HttpPost("upload")]
    public async Task<IActionResult> Upload(IFormFile file)
    {
        if (file == null || file.Length == 0)
        {
            return BadRequest("ファイルが選択されていません。");
        }
        string outputFilePath = Path.Combine("uploads", Path.ChangeExtension(file.FileName, ".avif"));
        using (var stream = new MemoryStream())
        {
            await file.CopyToAsync(stream);
            using (var image = new MagickImage(stream.ToArray()))
            {
                image.Write(outputFilePath);
            }
        }
        return Ok("AVIF形式に変換しました。");
    }
}

AVIF形式に変換しました。

バッチ処理でのAVIF変換自動化

定期的に画像をAVIF形式に変換するバッチ処理を作成することができます。

以下は、Windowsのタスクスケジューラを使用してバッチ処理を自動化するサンプルコードです。

using ImageMagick;
using System;
using System.IO;
class Program
{
    static void Main(string[] args)
    {
        string inputDirectoryPath = "images";
        string outputDirectoryPath = "converted_images";
        // 出力ディレクトリが存在しない場合は作成
        if (!Directory.Exists(outputDirectoryPath))
        {
            Directory.CreateDirectory(outputDirectoryPath);
        }
        string[] imageFiles = Directory.GetFiles(inputDirectoryPath, "*.jpg");
        foreach (var inputFilePath in imageFiles)
        {
            string outputFilePath = Path.Combine(outputDirectoryPath, Path.GetFileNameWithoutExtension(inputFilePath) + ".avif");
            try
            {
                using (var image = new MagickImage(inputFilePath))
                {
                    image.Write(outputFilePath);
                    Console.WriteLine($"{inputFilePath} を {outputFilePath} に変換しました。");
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"エラー: {ex.Message} - {inputFilePath}");
            }
        }
    }
}

images/image1.jpg を converted_images/image1.avif に変換しました。
images/image2.jpg を converted_images/image2.avif に変換しました。

このように、画像変換の応用例として、リサイズや圧縮、Webアプリケーションでの実装、バッチ処理の自動化など、さまざまなシナリオでAVIF形式の画像を効率的に扱うことができます。

まとめ

この記事では、C#を使用して画像ファイルをAVIFフォーマットに変換する方法について詳しく解説しました。

具体的には、Magick.NETやlibavifを利用した変換手法、エラーハンドリング、複数画像の一括変換、さらには画像変換の応用例についても触れました。

これらの知識を活用することで、画像処理の効率を向上させることが可能です。

ぜひ、実際のプロジェクトに取り入れて、AVIF形式の画像を効果的に活用してみてください。

2025-01-18更新日: 2025-01-18

Magick.NETを使ったAVIF変換

Magick.NETとは

Magick.NETのインストール手順

画像を読み込む方法

画像をAVIF形式で保存する方法

変換時のオプション設定(圧縮率、品質など)

libavifを使ったAVIF変換

libavifとは

libavifのC#バインディングの導入方法

画像を読み込む方法

画像をAVIF形式で保存する方法

変換時のパフォーマンス最適化

画像変換のエラーハンドリング

変換時に発生しやすいエラー

例外処理の実装方法

画像フォーマットのサポートチェック

複数画像の一括変換

複数ファイルの読み込み方法

ループ処理での一括変換

変換結果の保存先指定

画像変換の応用例

画像のリサイズとAVIF変換の同時処理

画像の圧縮とAVIF変換の組み合わせ

WebアプリケーションでのAVIF変換機能の実装

バッチ処理でのAVIF変換自動化

まとめ

関連記事