meson_options.txt

option(
    'version_fallback',
    type : 'string',
    description : 'Overrides the version string when not building in a git repository'
)

option(
    'developer',
    type : 'combo',
    choices : ['auto', 'true', 'false'],
    description : 'Make a "developer" build with cheats and extra debugging features'
)

option(
    'enable_zip',
    type : 'boolean',
    value : 'true',
    description : 'Enable loading of game data from ZIP packages (requires libzip)'
)

option(
    'package_data',
    type : 'combo',
    choices : ['auto', 'true', 'false'],
    description : 'Package the game’s assets into a compressed archive (requires enable_zip)'
)

option(
    'install_relative',
    type : 'combo',
    choices : ['auto', 'true', 'false'],
    description : 'Use only relative paths to the executable and install everything in the same directory. Always enabled for macOS bundles'
)

option(
    'install_freedesktop',
    type : 'combo',
    choices : ['auto', 'true', 'false'],
    description : 'Install freedesktop.org integration files (launchers, icons, replay file associations, etc.). Mostly relevant for Linux/BSD/etc. desktop systems'
)

option(
    'install_angle',
    type : 'boolean',
    value : 'false',
    description : 'Install pre-built ANGLE libraries. Only makes sense with a GLES backend. Currently only supported on Windows'
)

option(
    'angle_libgles',
    type : 'string',
    description : 'Path to ANGLE\'s libGLESv2 dynamic library (see install_angle)'
)

option(
    'angle_libegl',
    type : 'string',
    description : 'Path to ANGLE\'s libEGL dynamic library (see install_angle)'
)

option(
    'win_console',
    type : 'boolean',
    value : false,
    description : 'Use the console subsystem on Windows'
)

option(
    'static',
    type : 'boolean',
    value : false,
    description : 'Build statically linked executable'
)

option(
    'intel_intrin',
    type : 'boolean',
    value : true,
    description : 'Use some x86-specific intrinsics for optimizations where appropriate (if possible). Note that this is not equivalent to e.g. supplying -march in CFLAGS'
)

option(
    'debug_opengl',
    type : 'boolean',
    value : true,
    description : 'Enable OpenGL debugging. Create a debug context, enable logging, and crash the game on errors. Only available in debug builds'
)

option(
    'macos_bundle',
    type : 'boolean',
    value : true,
    description : 'Make a macOS application bundle on install (ignored on other platforms)'
)

option(
    'docs',
    type : 'boolean',
    value : true,
    description : 'Build and install documentation'
)

option(
    'shader_transpiler',
    type : 'boolean',
    value : false,
    description : 'Enable shader trans-compilation (requires shaderc)'
)

option(
    'validate_glsl',
    type : 'combo',
    choices : ['auto', 'true', 'false'],
    description : 'Enable validation of GLSL shaders (requires glslc)'
)

option(
    'r_default',
    type : 'combo',
    choices : ['gl33', 'gles20', 'gles30', 'null'],
    description : 'Which rendering backend to use by default'
)

option(
    'r_gl33',
    type : 'boolean',
    value : true,
    description : 'Build the OpenGL 3.3 Core renderer'
)

option(
    'r_gles20',
    type : 'boolean',
    value : false,
    description : 'Build the OpenGL ES 2.0 renderer (incomplete)'
)

option(
    'r_gles30',
    type : 'boolean',
    value : false,
    description : 'Build the OpenGL ES 3.0 renderer'
)

option(
    'r_null',
    type : 'boolean',
    value : true,
    description : 'Build the no-op renderer (nothing is displayed)'
)

option(
    'a_default',
    type : 'combo',
    choices : ['sdl2mixer', 'null'],
    description : 'Which audio backend to use by default'
)

option(
    'a_sdl2mixer',
    type : 'boolean',
    value : true,
    description : 'Build the SDL2_Mixer audio backend'
)

option(
    'a_null',
    type : 'boolean',
    value : true,
    description : 'Build the no-op audio backend (silence); you want this on!'
)

option(
    'objpools',
    type : 'boolean',
    value : true,
    description : 'Pre-allocate memory for game objects (disable for debugging only)'
)

option(
    'use_libcrypto',
    type : 'combo',
    choices : ['auto', 'true', 'false'],
    description : 'Use libcrypto from OpenSSL for better SHA implementations'
)