axmol/CMakeOptions.md

39 lines
2.3 KiB
Markdown
Raw Normal View History

2022-10-01 16:24:52 +08:00
# The axmol CMake options
2022-02-24 20:50:58 +08:00
2022-10-01 16:24:52 +08:00
## The options for axmol engine
2022-02-24 20:50:58 +08:00
- AX_BUILD_TESTS: whether build test porojects: cpp-tests, lua-tests, fairygui-tests, default: `TRUE`
- AX_ENABLE_XXX for core feature:
- AX_ENABLE_MSEDGE_WEBVIEW2: whether enable msedge webview2, default: `TRUE`
- AX_ENABLE_MFMEDIA: whether enable microsoft media foundation for windows video player support, default: `TRUE`
2023-06-13 20:44:20 +08:00
- AX_ENABLE_VLC_MEDIA: whether enable libvlc media, default: `TRUE on Linux`, `FALSE on Windows`, not support other platforms
2022-02-24 20:50:58 +08:00
- AX_USE_XXX:
- AX_USE_ALSOFT: whether use openal-soft for all platforms
- Apple platform: Use openal-soft instead system deprecated: `OpenAL.framework`
- Other platforms: Always use openal-soft even this option not enabled
2023-08-25 16:57:38 +08:00
- AX_USE_ANGLE: whether use compat gl as renderer backend, default: `FALSE`
- windows: whether use angleproject as GLES2 backend
- apple: whether use GLES instead Metal backend
- AX_USE_COMPAT_GL: deprecated, use AX_USE_ANGLE instead
- AX_USE_GLAD:
- Android: use glad load for GLES API loads, default `FALSE`
- Other platforms: Always use glad even this option not enabled
2022-02-24 20:50:58 +08:00
- AX_USE_LUAJIT: whether use luajit, default: `FALSE`, use plainlua
- AX_ENABLE_EXT_XXX for extensions
- AX_ENABLE_EXT_GUI: the traditional GUI extension, default: `TRUE`
- AX_ENABLE_EXT_ASSETMANAGER: the assetmanager extension, default: `TRUE`
- AX_ENABLE_EXT_PARTICLE3D: the particle3d extension, default: `TRUE`
- AX_ENABLE_EXT_PHYSICS_NODE: the physics_node extension, default: `TRUE`
- AX_ENABLE_EXT_SPINE: the spine extension, default: `TRUE`
- AX_ENABLE_EXT_DRAGONBONES: the dragonbones extension: `TRUE`
- AX_ENABLE_EXT_COCOSTUDIO: the cocosstudio extension for load .csb: `TRUE`
- AX_ENABLE_EXT_FAIRYGUI: the fairygui extension, default: `TRUE`
2022-10-30 22:56:32 +08:00
- AX_ENABLE_EXT_IMGUI: the imgui extension, support macos,win,linux,android, default: `TRUE`
- AX_ENABLE_EXT_LIVE2D: the live2d extension, default: `FALSE`
- AX_ENABLE_EXT_EFFEKSEER: the effekseer extension, default: `FALSE`
2022-02-24 20:50:58 +08:00
- AX_WITH_XXX: usually user don't need care it
- AX_VS_DEPLOYMENT_TARGET: specify windows store deploy target, default: `10.0.17763.0`
2022-02-24 20:50:58 +08:00
2022-10-01 16:24:52 +08:00
## The options for axmol apps
2022-02-24 20:50:58 +08:00
- AX_PREBUILT_DIR: specific the prebuilt dir (relative to `AX_ROOT`), it's very useful for fast linking apps with prebuilt engine libs