CONFIGURATION OPTIONS --------------------- --- BRLCAD_BUNDLED_LIBS --- Enables compilation of all 3rd party sources that are provided within a BRL-CAD source distribution. If used this option sets all other 3rd party library build flags to ON by default. However, that setting can be overridden by manually setting individual variables. Default is "AUTO" - 3rd party sources are compiled only if they are not detected as being available and functioning as expected. Aliases: ENABLE_ALL --- BRLCAD_ENABLE_OPENGL --- Enable support for OpenGL based Display Managers in BRL-CAD. Default depends on whether OpenGL is successfully detected - if it is, default is to enable. Aliases: ENABLE_OPENGL --- BRLCAD_ENABLE_RUNTIME_DEBUG --- Enables support for application and library debugging facilities. Disabling the run-time debugging facilities can provide a significant (10%-30%) performance boost at the expense of extensive error checking (that in turn help prevent corruption of your data). Default is "ON", and should only be disabled for read-only render work where performance is critical. Aliases: ENABLE_RUNTIME_DEBUG, ENABLE_RUN_TIME_DEBUG, ENABLE_RUNTIME_DEBUGGING ENABLE_RUN_TIME_DEBUGGING --- BRLCAD_FLAGS_DEBUG --- Add compiler flags to aid in program debugging. Defaults to ON. Aliases: ENABLE_DEBUG, ENABLE_FLAGS_DEBUG, ENABLE_DEBUG_FLAGS --- BRLCAD_ENABLE_COMPILER_WARNINGS --- Use extra compiler warning flags when compiling C/C++ code. Defaults to ON. Aliases: ENABLE_WARNINGS, ENABLE_COMPILER_WARNINGS --- BRLCAD_ENABLE_STRICT --- Causes all compilation warnings for C code to be treated as errors. This is now the default for BRL-CAD source code, and developers should address issues discovered by these flags whenever possible rather than disabling strict mode. Aliases: ENABLE_STRICT, ENABLE_STRICT_COMPILE, ENABLE_STRICT_COMPILE_FLAGS --- ENABLE_ALL_CXX_COMPILE --- Build all C and C++ files with a C++ compiler. Defaults to OFF. EXPERIMENTAL! Aliases: ENABLE_ALL_CXX --- ENABLE_POSIX_COMPLIANCE --- Build with strict POSIX compliance checking. Defaults to OFF. Causes compiler options to be set for strict compliance with the minimum C and C++ standards acceptable according to current BRL-CAD policy. The current minimum C standard is ??. There is no currently defined minimum C++ standard. Aliases: ENABLE_POSIX --- ENABLE_STRICT_COMPILER_STANDARD_COMPLIANCE --- Build with strict ISO C compliance checking. Defaults to OFF. Causes C compiler options to be set for strict compliance with the appropriate ISO C standard. Aliases: STRICT_ISO_C --- BRLCAD_EXTRADOCS --- The core option that enables and disables building of BRL-CAD's DocBook based documentation (includes manuals and man pages for commands, among other things). Defaults to ON, but only HTML and MAN formats are enabled by default - PDF must be enabled separately by use of this option or one of its aliases. Note that you may set environment variable APACHE_FOP to point to your locally installed fop executable file (which on Linux is usually a shell script with 0755 permissions). Aliases: ENABLE_DOCS, ENABLE_EXTRA_DOCS, ENABLE_DOCBOOK --- BRLCAD_LEMON --- Option for enabling and disabling compilation of the lemon parser provided with BRL-CAD's source distribution. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_LEMON --- BRLCAD_RE2C --- Option for enabling and disabling compilation of the re2c scanner utility provided with BRL-CAD's source distribution. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_RE2C --- BRLCAD_PERPLEX --- Option for enabling and disabling compilation of the perplex scanner generator provided with BRL-CAD's source distribution. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. perplex requires a working re2c. Aliases: ENABLE_PERPLEX --- BRLCAD_ASTYLE --- Option for enabling and disabling compilation of the Artistic Style (astyle) utility provided with BRL-CAD's source distribution. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_ASTYLE --- BRLCAD_XSLTPROC --- Option for enabling and disabling compilation of the xsltproc XML transformation utility provided with BRL-CAD's source distribution. Used for DocBook documentation processing. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Depends on BRLCAD_EXTRADOCS. Aliases: ENABLE_XSLTPROC --- BRLCAD_XMLLINT --- Option for enabling and disabling compilation of the xmllint XML validation utility provided with BRL-CAD's source distribution. Used for DocBook documentation validation. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_XMLLINT --- BRLCAD_REGEX --- Option for enabling and disabling compilation of the Regular Expression Library provided with BRL-CAD's source distribution. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_REGEX --- BRLCAD_ZLIB --- Option for enabling and disabling compilation of the zlib library provided with BRL-CAD's source distribution. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_ZLIB, ENABLE_LIBZ --- BRLCAD_TINYCTHREAD --- Option for enabling and disabling compilation of the tinycthread library provided with BRL-CAD's source distribution. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_TINYCTHREAD --- BRLCAD_LZ4 --- Option for enabling and disabling compilation of the lz4 data compression library provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_LZ4 --- BRLCAD_FREETYPE --- Option for enabling and disabling compilation of the FreeType libraries provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_FREETYPE --- BRLCAD_TERMLIB --- Option for enabling and disabling compilation of the termlib library provided with BRL-CAD's source distribution. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. (Except when building with Visual Studio, where it is disabled. Windows does not support the termlib API.) Aliases: ENABLE_TERMLIB --- BRLCAD_NETPBM --- Option for enabling and disabling compilation of the netpbm library provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_NETPBM --- BRLCAD_PNG --- Option for enabling and disabling compilation of the Portable Network Graphics library provided with BRL-CAD's source distribution. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_PNG --- BRLCAD_UTAHRLE --- Option for enabling and disabling compilation of the Utah Raster Toolkit library provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_UTAHRLE --- BRLCAD_TCL --- Option for enabling and disabling compilation of the Tcl library provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_TCL --- BRLCAD_TK --- Option for enabling and disabling compilation of the Tk library provided with BRL-CAD's source code. Default is AUTO, responsive to the BRLCAD_TCL option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Option for enabling and disabling compilation of the Tk graphics package for Tcl provided with BRL-CAD's source distribution. Default is AUTO, auto-enabling if the BRLCAD_TCL option is set to BUNDLED and testing first for a system version if BRLCAD_TCL is set to AUTO or SYSTEM. If BRLCAD_TK is set to BUNDLED, local copy is built even if a system version is present. This option also depends on BRLCAD_ENABLE_TK being ON. Aliases: ENABLE_TK --- BRLCAD_ITCL --- Option for enabling and disabling compilation of the IncrTcl package for Tcl objects provided with BRL-CAD's source distribution. Default is AUTO, auto-enabling if the BRLCAD_TCL option is set to BUNDLED and testing first for a system version if BRLCAD_TCL is set to AUTO or SYSTEM. If BRLCAD_ITCL is set to BUNDLED, local copy is built even if a system version is present. Aliases: ENABLE_ITCL --- BRLCAD_ITK --- Option for enabling and disabling compilation of the IncrTcl itk package for Tk objects provided with BRL-CAD's source distribution. Default is AUTO, auto-enabling if the BRLCAD_TCL option is set to BUNDLED and testing first for a system version if BRLCAD_TCL is set to AUTO or SYSTEM. If BRLCAD_ITK is set to BUNDLED, local copy is built even if a system version is present. This package will be disabled if BRLCAD_ENABLE_TK is OFF. Aliases: ENABLE_ITK --- BRLCAD_IWIDGETS --- Option for enabling and disabling compilation of the IWidgets Tk widget package provided with BRL-CAD's source distribution. Default is AUTO, auto-enabling if the BRLCAD_TCL option is set to BUNDLED and testing first for a system version if BRLCAD_TCL is set to AUTO or SYSTEM. If BRLCAD_IWIDGETS is set to BUNDLED, local copy is built even if a system version is present. This package will be disabled if BRLCAD_ENABLE_TK is OFF. Aliases: ENABLE_IWIDGETS --- BRLCAD_TKHTML --- Option for enabling and disabling compilation of the Tkhtml HTML viewing package provided with BRL-CAD's source distribution. Default is AUTO, auto-enabling if the BRLCAD_TCL option is set to BUNDLED and testing first for a system version if BRLCAD_TCL is set to AUTO or SYSTEM. If BRLCAD_TKHTML is set to BUNDLED, local copy is built even if a system version is present. This package will be disabled if BRLCAD_ENABLE_TK is OFF. Aliases: ENABLE_TKHTML --- BRLCAD_TKPNG --- Option for enabling and disabling compilation of the tkpng PNG image viewing package provided with BRL-CAD's source distribution. Default is AUTO, auto-enabling if the BRLCAD_TCL option is set to BUNDLED and testing first for a system version if BRLCAD_TCL is set to AUTO or SYSTEM. If BRLCAD_TKPNG is set to BUNDLED, local copy is built even if a system version is present. This package will be disabled if BRLCAD_ENABLE_TK is OFF. Aliases: ENABLE_TKPNG --- BRLCAD_TKTABLE --- Option for enabling and disabling compilation of the Tktable graphical table widget package provided with BRL-CAD's source distribution. Default is AUTO, auto-enabling if the BRLCAD_TCL option is set to BUNDLED and testing first for a system version if BRLCAD_TCL is set to AUTO or SYSTEM. If BRLCAD_TKTABLE is set to BUNDLED, local copy is built even if a system version is present. This package will be disabled if BRLCAD_ENABLE_TK is OFF. Aliases: ENABLE_TKTABLE --- BRLCAD_OPENNURBS --- Option for enabling and disabling compilation of the openNURBS library provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_OPENNURBS --- BRLCAD_SPR --- Option for enabling and disabling compilation of the PoissonRecon library provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_SPR --- BRLCAD_SC --- Option for enabling and disabling compilation of the NIST Step Class Libraries provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_SCL, ENABLE_STEP, ENABLE_STEP_CLASS_LIBRARIES --- BRLCAD_VDS --- Option for enabling and disabling compilation of the libvds triangle simplification library provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_VDS --- BRLCAD_OSG --- Option for enabling and disabling compilation of the OpenSceneGraph libraries provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_OPENSCENEGRAPH --- BRLCAD_GDIAM --- Option for enabling and disabling compilation of the libgdiam approximate tight bounding box library provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_GDIAM --- BRLCAD_PROJ4 --- Option for enabling and disabling compilation of the PROJ.4 geographic projection library provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_PROJ4 --- BRLCAD_GDAL --- Option for enabling and disabling compilation of the GDAL geographic library provided with BRL-CAD's source code. Default is AUTO, responsive to the toplevel BRLCAD_BUNDLED_LIBS option and testing first for a system version if BRLCAD_BUNDLED_LIBS is also AUTO. Aliases: ENABLE_GDAL *** Note - Do not add or edit configuration option descriptions and alias lists in this file - those entries are auto-generated from information in the toplevel CMakeLists.txt file and src/other/CMakeLists.txt - any changes should be made in those files. The CMake configuration process will automatically re-generate INSTALL with the new descriptions and alias information.