Difference between revisions of "CMake Options"

From Minetest Developer Wiki
Jump to navigation Jump to search
(Reference to README, mark as obsolete.)
(Replaced content with "[https://github.com/minetest/minetest#cmake-options Please see the Minetest README.md for an up-to-date list of CMake options.] Category:Compiling Minetest Category...")
Tag: Replaced
Line 1: Line 1:
This page is supposed to document the CMake switches you can use when building Minetest. These options are properly documented in the [https://github.com/minetest/minetest/blob/master/README.txt#L165-L245 official README file]. Since there can be some changes, this page might be outdated.
+
[https://github.com/minetest/minetest#cmake-options Please see the Minetest README.md for an up-to-date list of CMake options.]
 
 
 
 
 
 
== General options ==
 
 
 
{| class="wikitable collapsible sortable"
 
! Name
 
! Functionality
 
! Default Value
 
|-
 
|<code>BUILD_CLIENT</code>
 
|Build Minetest client
 
|YES
 
|-
 
|<code>BUILD_SERVER</code>
 
|Build Minetest server
 
|YES on Linux; NO on Windows
 
|-
 
|<code>CMAKE_BUILD_TYPE</code>
 
|Type of build (Release vs. Debug)
 
* ''Release'' - Release build
 
* ''Debug'' - Debug build
 
* ''RelWithDebInfo'' - Release build with Debug information
 
* ''MinSizeRel'' - Release build with smaller executable
 
|Release
 
|-
 
|<code>ENABLE_CURL</code>
 
|Build with cURL; Public serverlist and remote media fetching via HTTP
 
|YES
 
|-
 
|<code>ENABLE_FREETYPE</code>
 
|Build with Freetype2; TTF fonts
 
|NO
 
|-
 
|<code>ENABLE_GETTEXT</code>
 
|Build with Gettext; Translations
 
|NO
 
|-
 
|<code>ENABLE_GLES</code>
 
|Search for Open GLES headers & libraries and use them
 
|NO
 
|-
 
|<code>ENABLE_LEVELDB</code>
 
|Build with LevelDB; LevelDB map backend
 
|NO
 
|-
 
|<code>ENABLE_REDIS</code>
 
|Build with libhiredis; redis map backend
 
|YES
 
|-
 
|<code>ENABLE_SOUND</code>
 
|Build with OpenAL, libogg & libvorbis; in-game sounds
 
|YES
 
|-
 
|<code>ENABLE_LUAJIT</code>
 
|Build with LuaJIT; faster Lua execution
 
|YES
 
|-
 
|<code>RUN_IN_PLACE</code>
 
|Create a portable install (worlds, settings etc. in current directory)
 
|NO on Linux; YES on Windows
 
|-
 
|<code>USE_GPROF</code>
 
|Enable profiling using GProf
 
|NO
 
|-
 
|<code>VERSION_EXTRA</code>
 
|Text to append to version (e.g. VERSION_EXTRA=foobar -> Minetest 0.4.9-foobar)
 
|}
 
== Library specific ==
 
 
 
=== General ===
 
 
 
<code>BZIP2_INCLUDE_DIR</code> - '''Linux''' only; directory where ''bzlib.h'' is located
 
 
 
<code>BZIP2_LIBRARY</code> - '''Linux''' only; path to ''libbz2.a''/''libbz2.so''
 
 
 
<code>IRRLICHT_DLL</code> - path to ''Irrlicht.dll''
 
 
 
<code>IRRLICHT_INCLUDE_DIR</code> - directory that contains ''IrrCompileConfig.h''
 
 
 
<code>IRRLICHT_LIBRARY</code> - path to ''libIrrlicht.a''/''libIrrlicht.so''/''libIrrlicht.dll.a''
 
 
 
<code>LUA_INCLUDE_DIR</code> - Only if you want to use '''LuaJIT'''; directory where ''luajit.h'' is located
 
 
 
<code>LUA_LIBRARY</code> - Only if you want to use '''LuaJIT'''; path to ''libluajit.a''/''libluajit.so''
 
 
 
<code>MINGWM10_DLL</code> - Only if compiling with '''MinGW'''; path to ''mingwm10.dll''
 
 
 
<code>SQLITE3_INCLUDE_DIR</code> - Only if you want to use '''SQLite from your OS'''; directory that contains ''sqlite3.h''
 
 
 
<code>SQLITE3_LIBRARY</code> - Only if you want to use the '''SQLite from your OS'''; path to ''libsqlite3.a''/''libsqlite3.so''
 
 
 
<code>XXF86VM_LIBRARY</code> - Only on '''Linux'''; path to ''libXXf86vm.a''/''libXXf86vm.so''
 
 
 
<code>ZLIB_DLL</code> - Only on '''Windows'''; path to ''zlibwapi.dll''
 
 
 
<code>ZLIB_INCLUDE_DIR</code> - directory where ''zlib.h'' is located
 
 
 
<code>ZLIB_LIBRARY</code> - path to ''libz.a''/''libz.so''/''zlibwapi.lib''
 
 
 
=== cURL ===
 
 
 
<code>CURL_DLL</code> - Only on '''Windows'''; path to ''libcurl.dll''
 
 
 
<code>CURL_INCLUDE_DIR</code> - directory where ''curl.h'' is located
 
 
 
<code>CURL_LIBRARY</code> - path to ''libcurl.a''/''libcurl.so''/''libcurl.lib''
 
 
 
=== OpenGL ES ===
 
 
 
<code>EGL_INCLUDE_DIR</code> - directory that contains ''egl.h''
 
 
 
<code>EGL_LIBRARY</code> - path to ''libEGL.a''/''libEGL.so''
 
 
 
<code>OPENGLES2_INCLUDE_DIR</code> - directory that contains ''gl2.h''
 
 
 
<code>OPENGLES2_LIBRARY</code> - path to ''libGLESv2.a''/''libGLESv2.so''
 
 
 
=== Freetype2 ===
 
 
 
<code>FREETYPE_INCLUDE_DIR_freetype2</code> - directory that contains an ''freetype'' directory with files such as ''ftimage.h'' in it
 
 
 
<code>FREETYPE_INCLUDE_DIR_ft2build</code> - directory that contains ''ft2build.h''
 
 
 
<code>FREETYPE_LIBRARY</code> - path to ''libfreetype.a''/''libfreetype.so''/''freetype.lib''
 
 
 
=== Gettext ===
 
 
 
<code>GETTEXT_DLL</code> - Only on '''Windows'''; path to ''libintl3.dll''
 
 
 
<code>GETTEXT_ICONV_DLL</code> - Only on '''Windows'''; path to ''libiconv2.dll''
 
 
 
<code>GETTEXT_INCLUDE_DIR</code> - directory that contains ''iconv.h''
 
 
 
<code>GETTEXT_LIBRARY</code> - Only on '''Windows'''; path to ''libintl.dll.a''
 
 
 
<code>GETTEXT_MSGFMT</code> - path to ''msgfmt''/''msgfmt.exe''
 
 
 
=== LevelDB ===
 
 
 
<code>LEVELDB_INCLUDE_DIR</code> - directory that contains ''db.h''
 
 
 
<code>LEVELDB_LIBRARY</code> - path to ''libleveldb.a''/''libleveldb.so''/''libleveldb.dll''
 
 
 
=== Redis ===
 
 
 
<code>REDIS_INCLUDE_DIR</code> - directory that contains ''hiredis.h''
 
 
 
<code>REDIS_LIBRARY</code> - path to ''libhiredis.a''/''libhiredis.so''
 
 
 
=== Sound ===
 
 
 
<code>OGG_DLL</code> - Only on '''Windows'''; path to ''libogg.dll''
 
 
 
<code>OGG_INCLUDE_DIR</code> - directory that contains an ''ogg'' directory which contains ''ogg.h''
 
 
 
<code>OGG_LIBRARY</code> - path to ''libogg.a''/''libogg.so''/''libogg.dll.a''
 
 
 
<code>OPENAL_DLL</code> - Only on '''Windows'''; path to ''OpenAL32.dll''
 
 
 
<code>OPENAL_INCLUDE_DIR</code> - directory that contains an ''AL'' directory which contains ''al.h''
 
 
 
<code>OPENAL_LIBRARY</code> - path to ''libopenal.a''/''libopenal.so''/''OpenAL32.lib''
 
 
 
<code>VORBISFILE_DLL</code> - Only on '''Windows'''; path to ''libvorbisfile-3.dll''
 
 
 
<code>VORBISFILE_LIBRARY</code> - path to ''libvorbisfile.a''/''libvorbisfile.so''/''libvorbisfile.dll.a''
 
 
 
<code>VORBIS_DLL</code> - Only on '''Windows'''; path to ''libvorbis-0.dll''
 
 
 
<code>VORBIS_INCLUDE_DIR</code> - directory that contains a directory ''vorbis'' with ''vorbisenc.h'' inside
 
 
 
<code>VORBIS_LIBRARY</code> - path to ''libvorbis.a''/''libvorbis.so''/''libvorbis.dll.a''
 
  
 
[[Category:Compiling Minetest]]
 
[[Category:Compiling Minetest]]
 
[[Category:Obsolete]]
 
[[Category:Obsolete]]

Revision as of 19:46, 24 October 2022