目次 [#k602c5bf]

SDL3で始めるクロスプラットフォームゲーム開発 - 環境構築ガイド [#y205cba4]

ゲーム開発やマルチメディアアプリケーションを作りたいなら、SDL3（Simple DirectMedia? Layer 3）は強力な選択肢です。この記事では、Windows、macOS、Linux向けのSDL3環境構築方法を解説します。

SDL3とは？ †

SDL3は、グラフィックス、サウンド、入力デバイスなどを扱うための低レベルAPIを提供するクロスプラットフォームなライブラリです。C言語で書かれていますが、多数の言語バインディングがあり、以下のような機能を備えています：

2Dレンダリング ハードウェアアクセラレーション 入力デバイス（キーボード、マウス、ジョイスティックなど）のサポート オーディオ再生と録音 ウィンドウ管理 ネットワーキング

多くの有名ゲームやエミュレータがSDLを採用しており、ValveのSteamもSDLを利用しています。SDL3はSDL2の後継バージョンで、APIの改良やパフォーマンスの向上が図られています。 それでは早速、各OS向けの環境構築方法を見ていきましょう。

↑

Windows での環境構築 †

↑

必要なもの †

Visual Studio（無料のCommunity Editionで十分） SDL3開発ライブラリ

↑

手順 †

Visual Studioのインストール

Visual Studioからダウンロードし、インストール インストーラーで「C++によるデスクトップ開発」ワークロードを選択

SDL3のダウンロード

SDL公式GitHub?から「SDL3-3.2.8-win32-x64.zip」などの最新リリースをダウンロード ZIPファイルを任意の場所に解凍（例：C:\SDL3） SDL3.dllというファイルが入っており、これを配置するだけでインストール不要

プロジェクトの設定

Visual Studioで新しいC++プロジェクトを作成 プロジェクトのプロパティを開き、以下を設定：

C/C++ > 追加のインクルードディレクトリにC:\SDL3\includeを追加 リンカー > 追加のライブラリディレクトリにC:\SDL3\lib\x64を追加 リンカー > 入力 > 追加の依存ファイルにSDL3.libを追加

SDL3.dllのコピー

C:\SDL3\lib\x64フォルダからSDL3.dllをプロジェクトの実行ファイルと同じディレクトリにコピー

↑

サンプルコード †

#include <SDL3/SDL.h>

#include <iostream> int main(int argc, char* argv[]) { if (SDL_Init(SDL_INIT_VIDEO) < 0) { std::cout << "SDL初期化に失敗: " << SDL_GetError?() << std::endl; return -1; } コピー SDL_Window* window = SDL_CreateWindow?(

    "SDL3テストウィンドウ",
    640, 480,
    SDL_WINDOW_RESIZABLE
);
if (!window) {
    std::cout << "ウィンドウ作成に失敗: " << SDL_GetError() << std::endl;
    SDL_Quit();
    return -1;
}
SDL_Renderer* renderer = SDL_CreateRenderer(window, NULL,

SDL_RENDERER_ACCELERATED); if (!renderer) { std::cout << "レンダラー作成に失敗: " << SDL_GetError?() << std::endl; SDL_DestroyWindow?(window); SDL_Quit(); return -1; } コピー // メインループ

bool running = true;
SDL_Event event;
while (running) {
    // イベント処理
    while (SDL_PollEvent(&event)) {
        if (event.type == SDL_EVENT_QUIT) {
            running = false;
        }
    }
    // 描画
    SDL_SetRenderDrawColor(renderer, 0, 0, 255, 255);  // 青色
    SDL_RenderClear(renderer);
    SDL_RenderPresent(renderer);
    
    // フレームレート制御
    SDL_Delay(16); // ~60fps
}
// 後片付け
SDL_DestroyRenderer(renderer);
SDL_DestroyWindow(window);
SDL_Quit();
return 0;

}

↑

macOS での環境構築 †

↑

必要なもの †

Xcode コマンドラインツール Homebrew（パッケージマネージャー）

↑

手順 †

Xcode コマンドラインツールのインストール xcode-select --install

Homebrewのインストール（まだの場合） /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

SDL3のインストール 現在HomebrewではSDL3は正式にパッケージ化されていない可能性があるため、GitHub?からソースコードを取得してビルドする：

bashコピーgit clone https://github.com/libsdl-org/SDL.git cd SDL mkdir build cd build cmake .. -DCMAKE_BUILD_TYPE=Release make sudo make install

コンパイルとリンク

SDL3をコンパイルとリンクに使用するには以下のコマンドを使用： g++ -o my_program main.cpp pkg-config --cflags --libs sdl3

↑

サンプルコード（Makefileを使用） †

main.cpp [#x2b251e5] Makefile [#pcd4f736] CXX = g++ CXXFLAGS = $(shell pkg-config --cflags sdl3) LDFLAGS = $(shell pkg-config --libs sdl3) all: my_program my_program: main.cpp $(CXX) $(CXXFLAGS) -o $@ $< $(LDFLAGS) clean: rm -f my_program

↑

Linux での環境構築 †

↑

必要なもの †

GCC または Clang SDL3開発パッケージ

↑

手順 †

SDL3のインストール

Linux向けにも現時点ではSDL3のパッケージが準備されていない可能性が高いため、ソースからビルドします： bashコピーgit clone https://github.com/libsdl-org/SDL.git cd SDL mkdir build cd build cmake .. -DCMAKE_BUILD_TYPE=Release make sudo make install

コンパイルとリンク g++ -o my_program main.cpp pkg-config --cflags --libs sdl3

↑

サンプルコード †

main.cpp Makefile

macOSと同じMakefile

↑

CMakeを使用したクロスプラットフォーム対応 †

より一貫した開発環境のために、CMakeを使用することをお勧めします：

CMakeLists?.txt

cmake_minimum_required(VERSION 3.16) project(SDLTest) SDL3をfind_packageで探す find_package(SDL3 REQUIRED) 実行ファイルの追加 add_executable(sdl_test main.cpp) target_link_libraries(sdl_test SDL3::SDL3) Windowsの場合、SDL3.dllをコピー if(WIN32) add_custom_command(TARGET sdl_test POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy_if_different ${SDL3_DIR}/../../../bin/SDL3.dll $<TARGET_FILE_DIR>) endif()

↑

トラブルシューティング †

↑

共通の問題 †

"SDL3/SDL.h file not found"

インクルードパスが正しく設定されているか確認 パッケージが正しくインストールされているか確認 SDL3では、ヘッダーパスがSDL3/SDL.hのようにフォルダが追加されているため注意

リンクエラー

SDL3関連のライブラリがリンクされているか確認 SDL2から移行した場合、関数名やフラグ名が変更されていることがあるので注意

"SDL3.dll が見つかりません"（Windows）

SDL3.dllが実行ファイルと同じディレクトリにあるか確認

イベント名の違いによるエラー

SDL_QUIT（SDL2）からSDL_EVENT_QUIT（SDL3）に変更されたなど、イベント名が変わっていることに注意

予期しない動作

SDL3はまだ開発中であり、一部の機能が安定していない可能性があるため、公式のリリースノートや変更履歴を確認する

↑

便利なSDL3の追加ライブラリ †

SDL3への移行に伴い、関連ライブラリも順次SDL3対応に更新されています。以下のライブラリの最新版を確認してください：

SDL_image: PNG, JPG, GIFなどの画像ファイルを読み込むライブラリ SDL_ttf: TrueType?フォントのレンダリングライブラリ SDL_mixer: 音楽と効果音の再生ライブラリ SDL_net: ネットワーキングライブラリ

これらのライブラリはGitHub?からソースコードを取得し、ビルドすることで最新版を入手できます。例えば： bashコピーgit clone https://github.com/libsdl-org/SDL_image.git cd SDL_image mkdir build cd build cmake .. -DCMAKE_BUILD_TYPE=Release make sudo make install

↑

SDL2からSDL3への主な変更点 †

SDL3はSDL2からいくつかの大きな変更があります：

インクルードパス: #include <SDL.h> から #include <SDL3/SDL.h> に変更 ウィンドウ作成API: パラメータが変更され、位置指定方法が異なる イベント名: SDL_QUIT → SDL_EVENT_QUIT など、接頭辞の変更 オーディオAPI: 大幅に刷新され、より柔軟になった 命名規則: より一貫性のある命名規則に変更

詳細な変更点については、SDL公式のマイグレーションガイドを参照してください。

↑

まとめ †

SDL3は強力でありながら習得しやすいライブラリです。この記事で解説した環境構築手順を踏めば、クロスプラットフォームなアプリケーション開発をすぐに始められます。ゲーム開発やマルチメディアアプリケーション開発に興味がある方は、ぜひSDL3を試してみてください。 次回は、SDL3を使った基本的なゲームループの作り方や、スプライトの描画方法について詳しく解説します。

↑

参考リンク †

↑

SDL公式サイト †

↑

SDL GitHub? †

↑

SDL Wiki †

↑

SDL3マイグレーションガイド †

この記事は2025年3月29日に公開されました。SDL3のバージョンや関連ツールの更新により、手順が一部変更される可能性があります。

トップ   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS