Software Developer Zola 2019-04-27T00:00:00+00:00 https://edgl.dev/categories/sdl2/atom.xml 2019-04-27T00:00:00+00:00 2019-04-27T00:00:00+00:00 Edgar Luque https://edgl.dev/blog/sdl2-cmake/ <h2 id="installing-cmake">Installing CMake</h2> <p>Most common distributions have cmake available on their package manager repostories:</p> <pre class="giallo" style="color: #BFBDB6; background-color: #0D1017;"><code data-lang="shellscript"><span class="giallo-l"><span style="color: #5A6673;font-style: italic;"># Debian based</span></span> <span class="giallo-l"><span style="color: #59C2FF;">sudo</span><span style="color: #AAD94C;"> apt install cmake</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: #5A6673;font-style: italic;"># Arch</span></span> <span class="giallo-l"><span style="color: #59C2FF;">pacman</span><span style="color: #95E6CB;"> -S</span><span style="color: #AAD94C;"> cmake</span></span></code></pre><h2 id="install-sdl2-libraries">Install SDL2 libraries</h2> <p>I only know about the debian based ones, if you are on another distro you should look them up.</p> <pre class="giallo" style="color: #BFBDB6; background-color: #0D1017;"><code data-lang="shellscript"><span class="giallo-l"><span style="color: #59C2FF;">sudo</span><span style="color: #AAD94C;"> apt install libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-net-dev libsdl2-ttf-dev libsdl2-gfx-dev</span></span></code></pre><h2 id="directory-structure">Directory Structure</h2> <p>Here is a common directory structure when using cmake to find packages:</p> <pre class="giallo" style="color: #BFBDB6; background-color: #0D1017;"><code data-lang="plain"><span class="giallo-l"><span>├── cmake</span></span> <span class="giallo-l"><span>│   ├── FindSDL2.cmake</span></span> <span class="giallo-l"><span>│   ├── FindSDL2_mixer.cmake</span></span> <span class="giallo-l"><span>│   └── FindSDL2_net.cmake</span></span> <span class="giallo-l"><span>├── CMakeLists.txt</span></span> <span class="giallo-l"><span>└── src</span></span> <span class="giallo-l"><span> └── main.cpp</span></span></code></pre> <p>You can find the cmake files to find SDL2 and it's components <a rel="external" href="https://github.com/aminosbh/sdl2-cmake-modules">here</a></p> <p>Or you can use this simple command:</p> <pre class="giallo" style="color: #BFBDB6; background-color: #0D1017;"><code data-lang="shellscript"><span class="giallo-l"><span style="color: #F07178;">cd</span><span style="color: #AAD94C;"> cmake</span></span> <span class="giallo-l"><span style="color: #59C2FF;">wget</span><span style="color: #AAD94C;"> https://raw.githubusercontent.com/aminosbh/sdl2-cmake-modules/master/FindSDL2{,_gfx,_image,_mixer,_net,_ttf}.cmake</span></span></code></pre><h2 id="creating-the-cmakelists-txt-file">Creating the CMakeLists.txt file</h2> <pre class="giallo" style="color: #BFBDB6; background-color: #0D1017;"><code data-lang="cmake"><span class="giallo-l"><span style="color: #FF8F40;">cmake_minimum_required</span><span>(VERSION 3.13)</span></span> <span class="giallo-l"><span style="color: #FF8F40;">project</span><span>(MyProject)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: #5A6673;font-style: italic;"># Needed so that cmake uses our find modules.</span></span> <span class="giallo-l"><span style="color: #FF8F40;">list</span><span>(APPEND CMAKE_MODULE_PATH</span><span style="color: #FF8F40;"> ${CMAKE_CURRENT_SOURCE_DIR}</span><span>/cmake)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: #FF8F40;">find_package</span><span>(SDL2 REQUIRED)</span></span> <span class="giallo-l"><span style="color: #FF8F40;">find_package</span><span>(SDL2_net REQUIRED)</span></span> <span class="giallo-l"><span style="color: #FF8F40;">find_package</span><span>(SDL2_mixer REQUIRED)</span></span> <span class="giallo-l"><span style="color: #FF8F40;">find_package</span><span>(SDL2_image REQUIRED)</span></span> <span class="giallo-l"><span style="color: #FF8F40;">find_package</span><span>(SDL2_gfx REQUIRED)</span></span> <span class="giallo-l"><span style="color: #FF8F40;">find_package</span><span>(SDL2_ttf REQUIRED)</span></span> <span class="giallo-l"></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: #FF8F40;">set</span><span>(SOURCE_FILES</span></span> <span class="giallo-l"><span> src/main.cpp</span></span> <span class="giallo-l"><span> )</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: #FF8F40;">include_directories</span><span>(src)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: #FF8F40;">add_executable</span><span>(MyProject </span><span style="color: #FF8F40;">${SOURCE_FILES}</span><span>)</span></span> <span class="giallo-l"><span style="color: #FF8F40;">target_link_libraries</span><span>(MyProject SDL2::Main SDL2::Net SDL2::Mixer SDL2::Image SDL2::TTF SDL2::GFX)</span></span> <span class="giallo-l"></span></code></pre> <p>And thats it! Now you can remove the SDL2 components you don't want to use.</p> <h2 id="building">Building</h2> <p>Following the standard cmake procedure:</p> <pre class="giallo" style="color: #BFBDB6; background-color: #0D1017;"><code data-lang="shellscript"><span class="giallo-l"><span style="color: #59C2FF;">mkdir</span><span style="color: #AAD94C;"> build</span></span> <span class="giallo-l"><span style="color: #F07178;">cd</span><span style="color: #AAD94C;"> build</span></span> <span class="giallo-l"><span style="color: #59C2FF;">cmake</span><span style="color: #AAD94C;"> ..</span></span> <span class="giallo-l"><span style="color: #59C2FF;">make</span><span style="color: #95E6CB;"> -j$</span><span>{nproc}</span></span></code></pre>