SDL_image のインストール（ソースコードを用いたインストール）（Build Tools for Visual Studio を使用），SDL_image のプログラム例（Windows 上）

SDL_image は， BMP, JPEG, PNG, PNM などの画像ファイル処理のライブラリである．Windows上でのインストール手順は以下の通り：管理者権限でコマンドプロンプトを実行し，GitHubからソースコードをクローン．cmakeを使用してビルド設定を生成し，ソースコードをビルドしてインストール．その後，システム環境変数（SDL_IMAGE_ROOT，Path）を設定し，必要な実行ファイルをコピーする．最後に，テスト実行を行って機能を確認する．ライブラリの使用例として，画像ファイルを読み込み，各ピクセルのRGB値を出力するサンプルコードも示している．このライブラリにより，様々な形式の画像ファイルを簡単に扱うことが可能になる．

【目次】

前準備
SDL_image のインストール（Build Tools for Visual Studio を利用）

前準備

Build Tools for Visual Studio 2026 のインストール（Windows 上） [クリックして展開]

Build Tools for Visual Studio は，Visual Studio の IDE を含まない C/C++ コンパイラ，ライブラリ，ビルドツール等のコマンドライン向け開発ツールセットである。インストール済みの場合、この手順は不要である。

管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。

REM VC++ ランタイム
winget install --scope machine --id Microsoft.VCRedist.2015+.x64 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet /norestart"

REM Build Tools + Desktop development with C++（VCTools）+ 追加コンポーネント（一括）
winget install --scope machine --id Microsoft.VisualStudio.BuildTools -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "--quiet --wait --norestart --nocache --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100"

--add で追加されるコンポーネント

上記のコマンドでは，まず Build Tools 本体と Visual C++ 再頒布可能パッケージをインストールし，次に setup.exe を用いて以下のコンポーネントを追加している。

VCTools：C++ デスクトップ開発ワークロード（--includeRecommended により、MSVC コンパイラ、C++ AddressSanitizer、vcpkg、CMake ツール、Windows 11 SDK 等の推奨コンポーネントが含まれる）
VC.Llvm.Clang：Windows 向け C++ Clang コンパイラ
ClangCL：clang-cl ツールセットを含むコンポーネントグループ（MSBuild から Clang を使用するために必要）
VC.CMake.Project：Windows 向け C++ CMake ツール
Windows11SDK.26100：Windows 11 SDK（ビルド 10.0.26100）

インストール完了の確認

winget list Microsoft.VisualStudio.BuildTools

上記以外の追加のコンポーネントが必要になった場合は Visual Studio Installer で個別にインストールできる。

Visual Studio の機能を必要とする場合は、追加インストールできる。

Python 3.12 のインストール（Windows 上） [クリックして展開]

以下のいずれかの方法で Python 3.12 をインストールする。Python がインストール済みの場合、この手順は不要である。

方法1：winget によるインストール

winget install --scope machine --id Python.Python.3.12 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_pip=1 Include_test=0 Include_launcher=1 InstallLauncherAllUsers=1"

--scope machine を指定することで、システム全体（全ユーザー向け）にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。

方法2：インストーラーによるインストール

Python 公式サイト（https://www.python.org/downloads/）にアクセスし、「Download Python 3.x.x」ボタンから Windows 用インストーラーをダウンロードする。
ダウンロードしたインストーラーを実行する。
初期画面の下部に表示される「Add python.exe to PATH」に必ずチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号（例：Python 3.12.x）が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

Git のインストール（Windows 上） [クリックして展開]

管理者権限のコマンドプロンプトで以下を実行する．管理者権限は，winget の --scope machine オプションでシステム全体にインストールするために必要となる．

REM Git をシステム領域にインストール
winget install --scope machine --id Git.Git -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/VERYSILENT /NORESTART /NOCANCEL /SP- /CLOSEAPPLICATIONS /RESTARTAPPLICATIONS /COMPONENTS=""icons,ext\reg\shellhere,assoc,assoc_sh"" /o:PathOption=Cmd /o:CRLFOption=CRLFCommitAsIs /o:BashTerminalOption=MinTTY /o:DefaultBranchOption=main /o:EditorOption=VIM /o:SSHOption=OpenSSH /o:UseCredentialManager=Enabled /o:PerformanceTweaksFSCache=Enabled /o:EnableSymlinks=Disabled /o:EnableFSMonitor=Disabled"

CMakeのインストール（Windows 上） [クリックして展開]

REM CMake をシステム領域にインストール
winget install --scope machine --id Kitware.CMake -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/qn /norestart ADD_CMAKE_TO_PATH=System"

SDL2 のインストール

Windows での SDL2 のインストール: 別ページ »で説明

SDL_image のインストール（Build Tools for Visual Studio を利用）

以下の操作を管理者権限のコマンドプロンプトで実行する（手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。
SDL_image のインストールディレクトリを削除する
```
cd /d c:%HOMEPATH%
rmdir /s /q SDL_image
```

SDL_image のソースコードをダウンロード

cd /d c:%HOMEPATH%
git clone --recursive https://github.com/libsdl-org/SDL_image

cmake の実行

cmake の実行手順例は次の通り

cd /d c:%HOMEPATH%
cd SDL_image
rmdir /s /q build
mkdir build
cd build
del CMakeCache.txt
rmdir /s /q CMakeFiles
cmake .. -A x64 -T host=x64 ^
    -DSDLIMAGE_AVIF=OFF ^
    -DCMAKE_PREFIX_PATH="c:/sdl" ^
    -DCMAKE_INSTALL_PREFIX="c:/sdl"

cmake の実行結果の確認
* 下の通りになるとは限らない．エラーメッセージが出るなど場合は，前で cmake を実行したときの設定を変えてやり直す．
ソースコードからビルドし、インストールする
```
cmake --build . --config Release --target INSTALL -- /m:4
```
実行結果の確認
Windows のシステム環境変数 SDL_IMAGE_ROOT に，C:\sdl を設定
Windows で，管理者権限でコマンドプロンプトを起動（手順：Windowsキーまたはスタートメニュー > cmd と入力 > 右クリック > 「管理者として実行」）。
次のコマンドを実行
```
powershell -command "[System.Environment]::SetEnvironmentVariable(\"SDL_IMAGE_ROOT\", \"C:\sdl\", \"Machine\")"
```
Windows のシステム環境変数 Pathに，C:\sdl\bin を追加することにより，パスを通す．
Windows で，管理者権限でコマンドプロンプトを起動（手順：Windowsキーまたはスタートメニュー > cmd と入力 > 右クリック > 「管理者として実行」）。
次のコマンドを実行
```
powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";C:\sdl\bin\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"
```

.exe ファイルのコピー

cd /d c:%HOMEPATH%
cd SDL_image\build\Release
copy *.exe C:\sdl\bin

テスト実行
SDL_image の機能を使い JPEG ファイルなどを表示するプログラムを起動してみる． JPEG ファイルは何でも良いが，ここでは，lena_std.jpg を使ってみる．
```
c:\sdl\bin\showimage.exe lena_std.jpg
```

SDL_image のプログラム例

ソースコード

画像ファイルはヘッダが付いていたり，しばしば圧縮されている．画像ファイルの種類もいろいろある． SDL_image を使うと，こうしたことを気にしなくて済む．

次の仮定を置く

ＲＧＢのカラー画像
１画素の R, G, B 成分は１バイトであること．
画像データは隙間無くならんでいること．
R, G, B の順に並んでいることを仮定している．

/* SDL を用いた画像読み込みファイルプログラム */



#include<stdlib.h>
#include<stdio.h>
#include<string.h>

#include "SDL.h"
#include "SDL_image.h"

int main(int argc, char *argv[])
{
  SDL_Surface *image;
  int i, j;
  int r, g, b;

  /* Check command line usage */
  if ( ! argv[1] ) {
    fprintf(stderr, "Usage: %s <image_file>\n", argv[0]);
    return(1);
  }

  /* Open the image file */
  image = IMG_Load(argv[1]);
  if ( image == NULL ) {
    fprintf(stderr, "Couldn't load %s: %s\n", argv[1], SDL_GetError());
  }

  for ( i = 0; i < image->h; i++ ) {
      for ( j = 0; j < image->w; j++ ) {
    // １画素の R, G, B 成分は１バイトであること．画像データは隙間無くならんでいること．R, G, B の順に並んでいることを仮定している．
    unsigned char* p = (unsigned char*)image->pixels;
    int pixel_at = (i * (image->w) + j ) * image->format->BytesPerPixel;
    r = p[pixel_at];
    g = p[pixel_at + 1];
    b = p[pixel_at + 2];
    fprintf(stderr, "%d, %d = (%d, %d, %d)\n", i, j, r, g, b);
      }
  }

  fprintf( stderr, "image->format->BytesPerPixel = %d", image->format->BytesPerPixel );
  fprintf( stderr, "image->w = %d", image->w );
  fprintf( stderr, "image->h = %d", image->h );

  /* We're done! */
  SDL_Quit();
  return(0);
}

ビルド手順

view.cpp のところは実際のファイル名に読み替えてください．

g++ -I/usr/local/include/SDL -o a.exe view.cpp -lSDL_image -lSDL -lpthread -lm

実行結果の例

テストデータ: 24.bmp

実行結果の例

【まとめ】 SDL_imageをクローン，cmakeでビルド，環境変数設定後にテスト実行．