"Fossies" - the Fresh Open Source Software Archive

Member "plplot-5.15.0/doc/wiki_source/CMake_options_for_PLplot" (1 Jun 2019, 6681 Bytes) of package /linux/misc/plplot-5.15.0.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 <!---
    2 N.B.  The definitive Markdown source of this file is located in the
    3 doc/wiki_source subdirectory of the PLplot source tree.  So only use
    4 the ctrl-v and delete capabilities of the GUI file editor at
    5 SourceForge to make changes to the SourceForge version of this file,
    6 where ctrl-v is used to complete a cut and paste from the definitive
    7 version of this file in the PLplot source tree that is being edited
    8 with your favorite file editor, and delete used to remove extraneous
    9 unmodified text whose changed form has been copied with the cut and
   10 paste.
   11 -->
   12 
   13 A large number of options are available to modify the CMake configuration process. Use the ccmake or cmake-gui commands or inspect the contents of the CMakeCache.txt file after a build to obtain documentation for most options. Some options are hidden depending on other option values so for a more complete look at all option documentation look for the string "option" in the files in the cmake/modules subdirectory.
   14 
   15 Here we give the documentation of the most heavily used subset of the options. The value specified is the default value, but note that value can automatically be changed by the build system if some essential resource is not available on the platform. For example, if no Fortran 95-capable compiler can be found on the platform, the Fortran 95 bindings are automatically disabled. Furthermore, certain option values depend on other option values. For example, if BUILD_SHARED_LIBS is set to OFF, then ENABLE_DYNDRIVERS is automatically set to OFF as well.
   16 
   17 In general, if you just use the default options PLplot will normally configure itself to build without problems. The cmake output will have WARNING messages about any missing components. If one of those is important to you, then you will have to install additional libraries or executables (e.g., a Fortran 95-capable compiler) and do a fresh cmake run in an empty directory to configure a PLplot build that includes the component that was missing before.
   18 
   19 General options
   20 ---------------
   21 
   22 **CMAKE_INSTALL_PREFIX:PATH**=/usr/local - install directory.
   23 
   24 **CMAKE_BUILD_TYPE:STRING**= - One of blank (None), Debug, Release, RelWithDebInfo, or MinSizeRel. This option provides overall control of the optimization and debug options used for the build depending on the compiler and platform.
   25 
   26 **BUILD_SHARED_LIBS:BOOL**=ON - build shared libraries (ON) or static libraries (OFF).
   27 
   28 **ENABLE_DYNDRIVERS:BOOL**=ON - build device drivers as dynamically loaded plugins (ON) or as part of the PLplot core C library (OFF).
   29 
   30 **BUILD_TEST:BOOL**=OFF - builds examples in the build tree so that ctest can be run afterward to test that those examples work.
   31 
   32 **BUILD_DOC:BOOL**=OFF - build DocBook form of documentation.
   33 
   34 **BUILD_DOX_DOC:BOOL**=OFF - build Doxygen form of documentation.
   35 
   36 **PL_DOUBLE:BOOL**=ON - use 64-bit (ON) or 32-bit (OFF) floating-point precision.
   37 
   38 **USE_RPATH:BOOL**=ON - use rpath (ON) or do not use rpath (OFF) when linking libraries and executables.
   39 
   40 **HAVE_QHULL:BOOL**=ON - internally build and use the csironn library for natural neighbours interpolation. This library depends externally on the qhull library.
   41 
   42 **WITH_CSA:BOOL**=ON - internally build and use the csirocsa library for bivariate cubic spline approximation.
   43 
   44 Bindings options
   45 ----------------
   46 
   47 **DEFAULT_NO_BINDINGS:BOOL**=OFF - if this option is turned ON, all language bindings are turned OFF by default.
   48 
   49 **ENABLE_ada:BOOL**=ON - Ada 95 and Ada 2005 binding.
   50 
   51 **ENABLE_cxx:BOOL**=ON - C++ binding.
   52 
   53 **ENABLE_d:BOOL**=ON - [D](http://www.digitalmars.com/d/index.html) binding.
   54 
   55 **ENABLE_f95:BOOL**=ON - Fortran 95 binding.
   56 
   57 **ENABLE_itcl:BOOL**=ON - iTcl object-oriented extension of the Tcl binding.
   58 
   59 **ENABLE_itk:BOOL**=ON - iTk object-oriented extension of the Tk binding.
   60 
   61 **ENABLE_java:BOOL**=ON - Java binding.
   62 
   63 **ENABLE_lua:BOOL**=ON - [Lua](http://www.lua.org/) binding.
   64 
   65 **ENABLE_ocaml:BOOL**=ON - [OCaml](http://caml.inria.fr/) binding.
   66 
   67 **ENABLE_octave:BOOL**=ON - [Octave](https://gnu.org/software/octave/) binding.
   68 
   69 **ENABLE_python:BOOL**=ON - Python binding.
   70 
   71 **ENABLE_tcl:BOOL**=ON - Tcl binding.
   72 
   73 **ENABLE_tk:BOOL**=ON - Tk (graphical extension of Tcl) binding.
   74 
   75 Device options
   76 --------------
   77 
   78 ### General device options
   79 
   80 **DEFAULT_ALL_DEVICES:BOOL**=OFF - if this option is turned ON, all devices default to ON.
   81 
   82 **DEFAULT_NO_DEVICES:BOOL**=OFF - if this option is turned ON, all devices default to OFF.
   83 
   84 **DEFAULT_NO_CAIRO_DEVICES:BOOL**=OFF - if this option is turned ON, all cairo devices default to OFF.
   85 
   86 **DEFAULT_NO_QT_DEVICES:BOOL**=OFF - if this option is turned ON, all qt devices default to OFF.
   87 
   88 **WITH_FREETYPE:BOOL**=ON - access TrueType fonts with direct calls to libfreetype for certain device drivers that use this method of accessing TrueType fonts.
   89 
   90 N.B. All PLD_\* options below which default to OFF correspond to deprecated/unmaintained devices.
   91 
   92 ### libpango/libcairo-related devices
   93 
   94 These devices use various cairo backends. The ones that are turned ON by default generally give beautiful results with properly hinted unicode fonts even for CTL (complex text layout) languages.
   95 
   96 **PLD_epscairo**=ON
   97 
   98 **PLD_extcairo**=ON
   99 
  100 **PLD_memcairo**=ON
  101 
  102 **PLD_pdfcairo**=ON
  103 
  104 **PLD_pngcairo**=ON
  105 
  106 **PLD_pscairo**=ON
  107 
  108 **PLD_svgcairo**=ON
  109 
  110 **PLD_wincairo**=ON - Windows platforms only.
  111 
  112 **PLD_xcairo**=ON - Unix platforms only.
  113 
  114 ### Qt4-related devices
  115 
  116 These devices depend on the Qt4 libraries and generally give beautiful results with properly hinted unicode fonts even for CTL (complex text layout) languages.
  117 
  118 **PLD_bmpqt**=ON
  119 
  120 **PLD_epsqt**=ON
  121 
  122 **PLD_extqt**=ON
  123 
  124 **PLD_jpgqt**=ON
  125 
  126 **PLD_memqt**=ON
  127 
  128 **PLD_pdfqt**=ON
  129 
  130 **PLD_pngqt**=ON
  131 
  132 **PLD_ppmqt**=ON
  133 
  134 **PLD_qtwidget**=ON
  135 
  136 **PLD_svgqt**=ON
  137 
  138 **PLD_tiffqt**=ON
  139 
  140 ### libgd-related devices
  141 
  142 **PLD_png:BOOL**=OFF
  143 
  144 **PLD_jpeg:BOOL**=OFF
  145 
  146 **PLD_gif:BOOL**=OFF
  147 
  148 ### Other devices
  149 
  150 **PLD_aqt:BOOL**=ON - Mac OS X platform only.
  151 
  152 **PLD_cgm:BOOL**=OFF- note this device depends on the NIST public-domain cd library which we build internally (as libnistcd) if this option is set to ON by the user.
  153 
  154 **PLD_mem:BOOL**=ON
  155 
  156 **PLD_ntk:BOOL**=ON
  157 
  158 **PLD_null:BOOL**=ON - a working device that creates no (!) interactive or file output.
  159 
  160 **PLD_pdf:BOOL**=ON
  161 
  162 **PLD_plmeta:BOOL**=OFF
  163 
  164 **PLD_ps:BOOL**=ON
  165 
  166 **PLD_pstex:BOOL**=OFF
  167 
  168 **PLD_psttf:BOOL**=ON
  169 
  170 **PLD_svg:BOOL**=ON
  171 
  172 **PLD_tk:BOOL**=ON
  173 
  174 **PLD_tkwin:BOOL**=ON
  175 
  176 **PLD_wingcc:BOOL**=ON - Windows platforms only.
  177 
  178 **PLD_wxpng:BOOL**=OFF
  179 
  180 **PLD_wxwidgets:BOOL**=ON
  181 
  182 **PLD_xfig:BOOL**=ON
  183 
  184 **PLD_xwin:BOOL**=ON - Unix platforms only.
  185 
  186 
  187 The content of this page is available under the [GNU Free Documentation License 1.2](http://www.gnu.org/copyleft/fdl.html).