Config.pp 38 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891
  1. //
  2. // dtool/Config.pp
  3. //
  4. // This file defines certain configuration variables that are written
  5. // into the various make scripts. It is processed by ppremake (along
  6. // with the Sources.pp files in each of the various directories) to
  7. // generate build scripts appropriate to each environment.
  8. //
  9. // ppremake is capable of generating makefiles for Unix compilers such
  10. // as gcc or SGI's MipsPRO compiler, as well as for Windows
  11. // environments like Microsoft's Visual C++. It can also,
  12. // potentially, generate Microsoft Developer's Studio project files
  13. // directly, although we haven't written the scripts to do this yet.
  14. // In principle, it can be extended to generate suitable build script
  15. // files for any number of different build environments.
  16. //
  17. // All of these build scripts can be tuned for a particular
  18. // environment via this file. This is the place for the user to
  19. // specify which external packages are installed and where, or to
  20. // enable or disable certain optional features. However, it is
  21. // suggested that rather than modify this file directly, you create a
  22. // custom file in your home directory and there redefine whatever
  23. // variables are appropriate, and set the environment variable
  24. // PPREMAKE_CONFIG to refer to it. In this way, you can easily get an
  25. // updated source tree (including a new Config.pp) without risking
  26. // accidentally losing your customizations. This also avoids having
  27. // to redefine the same variables in different packages (for instance,
  28. // in dtool and in panda).
  29. //
  30. // The syntax in this file resembles some hybrid between C++
  31. // preprocessor declarations and GNU make variables. This is the same
  32. // syntax used in the various ppremake system configure files; it's
  33. // designed to be easy to use as a macro language to generate
  34. // makefiles and their ilk.
  35. //
  36. // Some of the variables below are defined using the #define command,
  37. // and others are defined using #defer. The two are very similar in
  38. // their purpose; the difference is that, if the variable definition
  39. // includes references to other variables (e.g. $[varname]), then
  40. // #define will evaluate all of the other variable references
  41. // immediately and store the resulting expansion, while #defer will
  42. // store only the variable references themselves, and expand them when
  43. // the variable is later referenced. It is very similar to the
  44. // relationship between := and = in GNU Make.
  45. // dtool/Config.pp
  46. // In general, #defer is used in this file, to allow the user to
  47. // redefine critical variables in his or her own Config.pp file.
  48. // What kind of build scripts are we generating? This selects a
  49. // suitable template file from the ppremake system files. The
  50. // allowable choices, at present, are:
  51. //
  52. // unix - Generate makefiles suitable for most Unix platforms.
  53. // msvc - Generate Visual C++ project files (still a work in progress)
  54. // nmake - Generate makefiles for Microsoft Visual C++, using
  55. // Microsoft's nmake utility.
  56. // gmsvc - Generate makefiles similar to the above, using Microsoft
  57. // Visual C++, but uses the Cygwin-supplied GNU make
  58. // instead of Microsoft nmake. This is potentially
  59. // faster if you have multiple CPU's, since it supports
  60. // distributed make. It's a tiny bit slower if you're
  61. // not taking advantage of distributed make, because of
  62. // the overhead associated with Cygwin fork() calls.
  63. #if $[eq $[PLATFORM], Win32]
  64. #define BUILD_TYPE nmake
  65. #elif $[eq $[PLATFORM], Cygwin]
  66. #define BUILD_TYPE gmsvc
  67. #elif $[eq $[PLATFORM], osx]
  68. #define BUILD_TYPE unix
  69. #else
  70. #define BUILD_TYPE unix
  71. #endif
  72. // What is the default install directory for all trees in the Panda
  73. // suite? The default value for this variable is provided by
  74. // ppremake; on Unix machines it is the value of --prefix passed in to
  75. // the configure script, and on Windows machines the default is
  76. // hardcoded in config_msvc.h to C:\Panda3d.
  77. // You may also override this for a particular tree by defining a
  78. // variable name like DTOOL_INSTALL or PANDA_INSTALL. (The
  79. // INSTALL_DIR variable will have no effect if you are using the
  80. // ctattach tools to control your attachment to the trees; but this
  81. // will be the case only if you are a member of the VR Studio.)
  82. // #define INSTALL_DIR /usr/local/panda
  83. // If you intend to use Panda only as a Python module, you may find
  84. // the following define useful (but you should put in the correct path
  85. // to site-packages within your own installed Python). This will
  86. // install the Panda libraries into the standard Python search space
  87. // so that they can be accessed as Python modules. (Also see the
  88. // PYTHON_IPATH variable, below.)
  89. // If you don't do this, you can still use Panda as a Python module,
  90. // but you must put /usr/local/panda/lib (or $INSTALL_DIR/lib) on
  91. // your PYTHONPATH.
  92. // #define INSTALL_LIB_DIR /usr/lib/python2.2/site-packages
  93. // The character used to separate components of an OS-specific
  94. // directory name depends on the platform (it is '/' on Unix, '\' on
  95. // Windows). That character selection is hardcoded into Panda and
  96. // cannot be changed here. (Note that an internal Panda filename
  97. // always uses the forward slash, '/', to separate the components of a
  98. // directory name.)
  99. // There's a different character used to separate the complete
  100. // directory names in a search path specification. On Unix, the
  101. // normal convention is ':', on Windows, it has to be ';', because the
  102. // colon is already used to mark the drive letter. This character is
  103. // selectable here. Most users won't want to change this. If
  104. // multiple characters are placed in this string, any one of them may
  105. // be used as a separator character.
  106. #define DEFAULT_PATHSEP $[if $[WINDOWS_PLATFORM],;,:]
  107. // What level of compiler optimization/debug symbols should we build?
  108. // The various optimize levels are defined as follows:
  109. //
  110. // 1 - No compiler optimizations, full debug symbols
  111. // 2 - Full compiler optimizations, full debug symbols
  112. // (if the compiler supports this)
  113. // 3 - Full compiler optimizations, no debug symbols
  114. // 4 - Full optimizations, no debug symbols, and asserts removed
  115. //
  116. #define OPTIMIZE 3
  117. // Panda uses prc files for runtime configuration. There are many
  118. // compiled-in options to customize the behavior of the prc config
  119. // system; most users won't need to change any of them. Feel free to
  120. // skip over all of the PRC_* variables defined here.
  121. // The default behavior is to search for files names *.prc in the
  122. // directory specified by the PRC_DIR environment variable, and then
  123. // to search along all of the directories named by the PRC_PATH
  124. // environment variable. Either of these variables might be
  125. // undefined; if both of them are undefined, the default is to search
  126. // in the directory named here by DEFAULT_PRC_DIR.
  127. // By default, we specify the install/etc dir, which is where the
  128. // system-provided PRC files get copied to.
  129. #defer DEFAULT_PRC_DIR $[INSTALL_DIR]/etc
  130. // You can specify the names of the environment variables that are
  131. // used to specify the search location(s) for prc files at runtime.
  132. // These are space-separated lists of environment variable names.
  133. // Specify empty string for either one of these to disable the
  134. // feature. For instance, redefining PRC_DIR_ENVVARS here to
  135. // PANDA_PRC_DIR would cause the environment variable $PANDA_PRC_DIR
  136. // to be consulted at startup instead of the default value of
  137. // $PRC_DIR.
  138. #define PRC_DIR_ENVVARS PRC_DIR
  139. #define PRC_PATH_ENVVARS PRC_PATH
  140. // You can specify the name of the file(s) to search for in the above
  141. // paths to be considered a config file. This should be a
  142. // space-separated list of filename patterns. This is *.prc by
  143. // default; normally there's no reason to change this.
  144. #define PRC_PATTERNS *.prc
  145. // One unusual feature of config is the ability to execute one or more
  146. // of the files it discovers as if it were a program, and then treat
  147. // the output of this program as a prc file. If you want to use this
  148. // feature, define this variable to the filename pattern or patterns
  149. // for such executable-style config programs (e.g. *prc.exe). This
  150. // can be the same as the above if you like this sort of ambiguity; in
  151. // that case, config will execute the file if it appears to be
  152. // executable; otherwise, it will simply read it.
  153. #define PRC_EXECUTABLE_PATTERNS
  154. // If you do use the above feature, you'll need another environment
  155. // variable that specifies additional arguments to pass to the
  156. // executable programs. The default definition, given here, makes
  157. // that variable be $PRC_EXECUTABLE_ARGS. Sorry, the same arguments
  158. // must be supplied to all executables in a given runtime session.
  159. #define PRC_EXECUTABLE_ARGS_ENVVAR PRC_EXECUTABLE_ARGS
  160. // You can implement signed prc files, if you require this advanced
  161. // feature. This allows certain config variables to be set only by a
  162. // prc file that has been provided by a trusted source. To do this,
  163. // first install and compile Dtool with OpenSSL (below) and run the
  164. // program make-prc-key, and then specify here the output filename
  165. // generated by that program, and then recompile Dtool (ppremake; make
  166. // install).
  167. #define PRC_PUBLIC_KEYS_FILENAME
  168. // By default, the signed-prc feature, above, is enabled only for a
  169. // release build (OPTIMIZE = 4). In a normal development environment
  170. // (OPTIMIZE < 4), any prc file can set any config variable, whether
  171. // or not it is signed. Set this variable true (nonempty) or false
  172. // (empty) to explicitly enable or disable this feature.
  173. #defer PRC_RESPECT_TRUST_LEVEL $[= $[OPTIMIZE],4]
  174. // Similarly, the descriptions are normally saved only in a
  175. // development build, not in a release build. Set this value true to
  176. // explicitly save them anyway.
  177. #defer PRC_SAVE_DESCRIPTIONS $[< $[OPTIMIZE],4]
  178. // This is the end of the PRC variable customization section. The
  179. // remaining variables are of general interest to everyone.
  180. // NOTE: In the following, to indicate "yes" to a yes/no question,
  181. // define the variable to be a nonempty string. To indicate "no",
  182. // define the variable to be an empty string.
  183. // Many of the HAVE_* variables are defined in terms of expressions
  184. // based on the paths and library names, etc., defined above. These
  185. // are defined using the "defer" command, so that they are not
  186. // evaluated right away, giving the user an opportunity to redefine
  187. // the variables they depend on, or to redefine the HAVE_* variables
  188. // themselves (you can explicitly define a HAVE_* variable to some
  189. // nonempty string to force the package to be marked as installed).
  190. // Do you want to generate a Python-callable interrogate interface?
  191. // This is only necessary if you plan to make calls into Panda from a
  192. // program written in Python. This is done only if HAVE_PYTHON,
  193. // below, is also true.
  194. #define INTERROGATE_PYTHON_INTERFACE 1
  195. // Define this true to use the new interrogate feature to generate
  196. // Python-native objects directly, rather than requiring a separate
  197. // FFI step. This loads and runs much more quickly than the original
  198. // mechanism. Define this false (that is, empty) to use the original
  199. // interfaces.
  200. #define PYTHON_NATIVE 1
  201. // Do you want to generate a C-callable interrogate interface? This
  202. // generates an interface similar to the Python interface above, with
  203. // a C calling convention. It should be useful for most other kinds
  204. // of scripting language; the VR Studio used to use this to make calls
  205. // into Panda from Squeak. This is not presently used by any VR
  206. // Studio code.
  207. #define INTERROGATE_C_INTERFACE
  208. // Do you even want to build interrogate at all? This is the program
  209. // that reads our C++ source files and generates one of the above
  210. // interfaces. If you won't be building the interfaces, you don't
  211. // need the program.
  212. #defer HAVE_INTERROGATE $[or $[INTERROGATE_PYTHON_INTERFACE],$[INTERROGATE_C_INTERFACE]]
  213. // What additional options should be passed to interrogate when
  214. // generating either of the above two interfaces? Generally, you
  215. // probably don't want to mess with this.
  216. #define INTERROGATE_OPTIONS -fnames -string -refcount -assert
  217. // What's the name of the interrogate binary to run? The default
  218. // specified is the one that is built as part of DTOOL. If you have a
  219. // prebuilt binary standing by (for instance, one built opt4), specify
  220. // its name instead.
  221. #define INTERROGATE interrogate
  222. #define INTERROGATE_MODULE interrogate_module
  223. // Is Python installed, and should Python interfaces be generated? If
  224. // Python is installed, which directory is it in?
  225. #define PYTHON_IPATH /usr/include/python2.4
  226. #define PYTHON_LPATH
  227. #define PYTHON_FPATH
  228. #define PYTHON_COMMAND python
  229. #defer PYTHON_DEBUG_COMMAND $[PYTHON_COMMAND]$[if $[WINDOWS_PLATFORM],_d]
  230. #define PYTHON_FRAMEWORK
  231. #defer HAVE_PYTHON $[isdir $[PYTHON_IPATH]]
  232. // Define the default set of libraries to be instrumented by
  233. // genPyCode. You may wish to add to this list to add your own
  234. // libraries, or if you want to use some of the more obscure
  235. // interfaces like libpandaegg and libpandafx.
  236. #define GENPYCODE_LIBS libpandaexpress libpanda libpandaphysics libdirect libpandafx
  237. // Normally, Python source files are copied into the INSTALL_LIB_DIR
  238. // defined above, along with the compiled C++ library objects, when
  239. // you make install. If you prefer not to copy these Python source
  240. // files, but would rather run them directly out of the source
  241. // directory (presumably so you can develop them and make changes
  242. // without having to reinstall), comment out this definition and put
  243. // your source directory on your PYTHONPATH.
  244. #define INSTALL_PYTHON_SOURCE 1
  245. // Do you want to enable the "in_interpreter" global variable? This
  246. // will enable some callbacks, particularly the MemoryUsage object, to
  247. // know whether they were called from Python code (or other high-level
  248. // show code) and react accordingly, generally for debugging
  249. // purporses. It adds a bit of runtime overhead, and isn't usually
  250. // useful unless we're building a debug tree anyway. The default is
  251. // to enable it only for optimize levels 1 and 2.
  252. #defer TRACK_IN_INTERPRETER $[<= $[OPTIMIZE], 2]
  253. // Do you want to compile in support for tracking memory usage? This
  254. // enables you to define the variable "track-memory-usage" at runtime
  255. // to help track memory leaks, and also report total memory usage on
  256. // PStats. There is some small overhead for having this ability
  257. // available, even if it is unused.
  258. #defer DO_MEMORY_USAGE $[<= $[OPTIMIZE], 3]
  259. // This option compiles in support for simulating network delay via
  260. // the min-lag and max-lag prc variables. It adds a tiny bit of
  261. // overhead even when it is not activated, so it is typically enabled
  262. // only in a development build.
  263. #defer SIMULATE_NETWORK_DELAY $[<= $[OPTIMIZE], 3]
  264. // This option compiles in support for immediate-mode OpenGL
  265. // rendering. Since this is normally useful only for researching
  266. // buggy drivers, and since there is a tiny bit of per-primitive
  267. // overhead to have this option available even if it is unused, it is
  268. // by default enabled only in a development build. This has no effect
  269. // on DirectX rendering.
  270. #define SUPPORT_IMMEDIATE_MODE $[<= $[OPTIMIZE], 3]
  271. // Do you want to compile in support for pipelining? This enables
  272. // setting and accessing multiple different copies of frame-specific
  273. // data stored in nodes, etc. At the moment, Panda cannot actually
  274. // take advantage of this support to do anything useful, but
  275. // eventually this will enable multi-stage pipelining of the render
  276. // process, as well as potentially remote rendering using a
  277. // distributed scene graph. For now, we enable this when building
  278. // optimize 1 only, since turning this on does perform some additional
  279. // sanity checks, but doesn't do anything else useful other than
  280. // increase run-time overhead.
  281. #defer DO_PIPELINING $[<= $[OPTIMIZE], 1]
  282. // Is NSPR installed, and where? This is the Netscape Portable
  283. // Runtime library, downloadable as part of the Mozilla package from
  284. // mozilla.org. It provides portable threading and networking
  285. // services to Panda. Panda should compile without it, although
  286. // without any threading or networking capabilities; eventually,
  287. // native support for these capabilities may be added for certain
  288. // platforms. See also HAVE_IPC and HAVE_NET.
  289. #define NSPR_IPATH /usr/include/nspr
  290. #define NSPR_LPATH
  291. #define NSPR_LIBS nspr4
  292. #defer HAVE_NSPR $[isfile $[NSPR_IPATH]/prtypes.h]
  293. // Is a third-party STL library installed, and where? This is only
  294. // necessary if the default include and link lines that come with the
  295. // compiler don't provide adequate STL support. At least some form of
  296. // STL is absolutely required in order to build Panda.
  297. #define STL_IPATH
  298. #define STL_LPATH
  299. #define STL_CFLAGS
  300. #define STL_LIBS
  301. // Does your STL library provide hashed associative containers like
  302. // hash_map and hash_set? Define this true if you have a nonstandard
  303. // STL library that provides these, like Visual Studio .NET's. (These
  304. // hashtable containers are not part of the C++ standard yet, but the
  305. // Dinkum STL library that VC7 ships with includes a preliminary
  306. // implementation that Panda can optionally use.) For now, we assume
  307. // you have this by default only on a Windows platform.
  308. // On second thought, it turns out that this API is still too
  309. // volatile. The interface seems to have changed with the next
  310. // version of .NET, and it didn't present any measureable performance
  311. // gain anyway. Never mind.
  312. #define HAVE_STL_HASH
  313. // Is OpenSSL installed, and where?
  314. #define SSL_IPATH /usr/local/ssl/include
  315. #define SSL_LPATH /usr/local/ssl/lib
  316. #define SSL_LIBS ssl crypto
  317. #defer HAVE_SSL $[libtest $[SSL_LPATH],$[SSL_LIBS]]
  318. // Define this nonempty if your version of OpenSSL is 0.9.7 or better.
  319. #define SSL_097
  320. // Define this true to include the OpenSSL code to report verbose
  321. // error messages when they occur.
  322. #defer REPORT_OPENSSL_ERRORS $[< $[OPTIMIZE], 4]
  323. // Is libjpeg installed, and where?
  324. #define JPEG_IPATH
  325. #define JPEG_LPATH
  326. #define JPEG_LIBS jpeg
  327. #defer HAVE_JPEG $[libtest $[JPEG_LPATH],$[JPEG_LIBS]]
  328. // Is libpng installed, and where?
  329. #define PNG_IPATH
  330. #define PNG_LPATH
  331. #define PNG_LIBS png
  332. #defer HAVE_PNG $[libtest $[PNG_LPATH],$[PNG_LIBS]]
  333. // Is libtiff installed, and where?
  334. #define TIFF_IPATH
  335. #define TIFF_LPATH
  336. #define TIFF_LIBS tiff z
  337. #defer HAVE_TIFF $[libtest $[TIFF_LPATH],$[TIFF_LIBS]]
  338. // Is libfftw installed, and where?
  339. #define FFTW_IPATH /usr/local/include
  340. #define FFTW_LPATH /usr/local/lib
  341. #define FFTW_LIBS rfftw fftw
  342. #defer HAVE_FFTW $[libtest $[FFTW_LPATH],$[FFTW_LIBS]]
  343. // Is NURBS++ installed, and where?
  344. #define NURBSPP_IPATH /usr/local/include/nurbs++
  345. #define NURBSPP_LPATH /usr/local/lib
  346. #define NURBSPP_LIBS nurbsf matrixN matrixI matrix
  347. #defer HAVE_NURBSPP $[libtest $[NURBSPP_LPATH],$[NURBSPP_LIBS]]
  348. // Is Cg installed, and where?
  349. #if $[WINDOWS_PLATFORM]
  350. #define CG_IPATH
  351. #define CG_LPATH
  352. #define CG_LIBS cg.lib
  353. #else
  354. #define CG_IPATH
  355. #define CG_LPATH
  356. #define CG_LIBS Cg
  357. #endif
  358. #defer HAVE_CG $[libtest $[CG_LPATH],$[CG_LIBS]]
  359. // Is CgGL installed, and where?
  360. #define CGGL_IPATH $[CG_IPATH]
  361. #define CGGL_LPATH $[CG_LPATH]
  362. #define CGGL_LIBS $[if $[WINDOWS_PLATFORM],cgGL.lib,CgGL]
  363. #defer HAVE_CGGL $[and $[HAVE_CG],$[libtest $[CGGL_LPATH],$[CGGL_LIBS]]]
  364. // Is VRPN installed, and where?
  365. #define VRPN_IPATH
  366. #define VRPN_LPATH
  367. #define VRPN_LIBS
  368. #defer HAVE_VRPN $[libtest $[VRPN_LPATH],$[VRPN_LIBS]]
  369. // Is HELIX installed, and where?
  370. #define HELIX_IPATH
  371. #define HELIX_LPATH
  372. #define HELIX_LIBS
  373. #defer HAVE_HELIX $[libtest $[HELIX_LPATH],$[HELIX_LIBS]]
  374. // Is ZLIB installed, and where?
  375. #define ZLIB_IPATH
  376. #define ZLIB_LPATH
  377. #define ZLIB_LIBS z
  378. #defer HAVE_ZLIB $[libtest $[ZLIB_LPATH],$[ZLIB_LIBS]]
  379. // Is OpenGL installed, and where? This should include libGL as well
  380. // as libGLU, if they are in different places.
  381. #if $[WINDOWS_PLATFORM]
  382. #defer GL_IPATH
  383. #defer GL_LPATH
  384. #define GL_LIBS opengl32.lib glu32.lib
  385. #else
  386. #defer GL_IPATH
  387. #defer GL_LPATH /usr/X11R6/lib
  388. #defer GL_LIBS GL GLU
  389. #endif
  390. #defer HAVE_GL $[libtest $[GL_LPATH],$[GL_LIBS]]
  391. // Is Mesa installed separately from OpenGL? Mesa is an open-source
  392. // software-only OpenGL renderer. Panda can link with it
  393. // independently from OpenGL (and if Mesa is built statically, and/or
  394. // with -DUSE_MGL_NAMESPACE declared to rename gl* to mgl*, it can
  395. // switch between the system OpenGL implementation and the Mesa
  396. // implementation at runtime).
  397. // Also, Mesa includes some core libraries (in libOSMesa.so) that
  398. // allow totally headless rendering, handy if you want to run a
  399. // renderer as a batch service, and you don't want to insist that a
  400. // user be logged on to the desktop or otherwise deal with X11 or
  401. // Windows.
  402. // If you define HAVE_MESA here, and the appropriate paths to headers
  403. // and libraries, then Panda will build libmesadisplay, which can be
  404. // used in lieu of libpandagl or libpandadx to do rendering. However,
  405. // for most applications, you don't need to do this, since (a) if you
  406. // have hardware rendering capability, you probably don't want to use
  407. // Mesa, since it's software-only, and (b) if you don't have hardware
  408. // rendering, you can install Mesa as the system's OpenGL
  409. // implementation, so you can just use the normal libpandagl. You
  410. // only need to define HAVE_MESA if you want to run totally headless,
  411. // or if you want to be able to easily switch between Mesa and the
  412. // system OpenGL implementation at runtime. If you compiled Mesa with
  413. // USE_MGL_NAMESPACE defined, define MESA_MGL here.
  414. #define MESA_IPATH
  415. #define MESA_LPATH
  416. #define MESA_LIBS
  417. #define MESA_MGL
  418. #defer HAVE_MESA $[libtest $[MESA_LPATH],$[MESA_LIBS]]
  419. // Is the Chromium remote-rendering library installed, and where?
  420. // This should include libcr_opengl32.
  421. #defer CHROMIUM_IPATH
  422. #defer CHROMIUM_LPATH
  423. #defer CHROMIUM_LIBS
  424. #defer HAVE_CHROMIUM $[libtest $[CHROMIUM_LPATH],$[CHROMIUM_LIBS]]
  425. // How about GLX?
  426. #define GLX_IPATH
  427. #define GLX_LPATH
  428. #defer HAVE_GLX $[and $[HAVE_GL],$[UNIX_PLATFORM]]
  429. // Should we try to build the WGL interface?
  430. #defer HAVE_WGL $[and $[HAVE_GL],$[WINDOWS_PLATFORM]]
  431. // Should we try to build the SGI-specific glxdisplay?
  432. #define HAVE_SGIGL $[eq $[PLATFORM],Irix]
  433. // Is DirectX available, and should we try to build with it?
  434. #define DX_IPATH
  435. #define DX_LPATH
  436. #define DX_LIBS d3d8.lib d3dx8.lib dxerr8.lib
  437. #defer HAVE_DX $[libtest $[DX_LPATH],$[DX_LIBS]]
  438. // Is CV available, and should we try to build with it?
  439. #define CV_IPATH $[WINTOOLS]/sdk/cv/include
  440. #define CV_LPATH $[WINTOOLS]/sdk/cv/lib
  441. #define CV_LIBS cv.lib highgui.lib cxcore.lib
  442. #defer HAVE_CV $[libtest $[CV_LPATH],$[CV_LIBS]]
  443. // Do you want to build the DirectD tools for starting Panda clients
  444. // remotely? This only affects the direct tree. Enabling this may
  445. // cause libdirect.dll to fail to load on Win98 clients.
  446. #define HAVE_DIRECTD
  447. // Do you want to build in support for threading (multiprocessing)?
  448. // Building in support for threading will enable Panda to take
  449. // advantage of multiple CPU's if you have them (and if the OS
  450. // supports kernel threads running on different CPU's), but it will
  451. // slightly slow down Panda for the single CPU case, so this is not
  452. // enabled by default.
  453. // Currently, threading support requires NSPR, so you should not
  454. // define this true unless you have NSPR installed.
  455. #define HAVE_THREADS
  456. // Do you want to build the network interface? What additional libraries
  457. // are required? Currently, this requires NSPR.
  458. #define NET_IPATH
  459. #define NET_LPATH
  460. #if $[WINDOWS_PLATFORM]
  461. #define NET_LIBS wsock32.lib
  462. #else
  463. #define NET_LIBS
  464. #endif
  465. #defer HAVE_NET $[HAVE_NSPR]
  466. // Do you want to build the PStats interface, for graphical run-time
  467. // performance statistics? This requires NET to be available. By
  468. // default, we don't build PStats when OPTIMIZE = 4, although this is
  469. // possible.
  470. #defer DO_PSTATS $[or $[and $[HAVE_NET],$[< $[OPTIMIZE], 4]], $[DO_PSTATS]]
  471. // Do you want to type-check downcasts? This is a good idea during
  472. // development, but does impose some run-time overhead.
  473. #defer DO_DCAST $[< $[OPTIMIZE], 4]
  474. // Do you want to build the debugging tools for recording and
  475. // visualizing intersection tests by the collision system? Enabling
  476. // this increases runtime collision overhead just a tiny bit.
  477. #defer DO_COLLISION_RECORDING $[< $[OPTIMIZE], 4]
  478. // Do you want to include the "debug" and "spam" Notify messages?
  479. // Normally, these are stripped out when we build with OPTIMIZE = 4, but
  480. // sometimes it's useful to keep them around. Redefine this in your
  481. // own Config.pp to achieve that.
  482. #defer NOTIFY_DEBUG $[< $[OPTIMIZE], 4]
  483. // Do you want to build the audio interface?
  484. #define HAVE_AUDIO 1
  485. // Info for the RAD game tools, Miles Sound System
  486. // note this may be overwritten in wintools Config.pp
  487. #define RAD_MSS_IPATH /usr/include/Miles6/include
  488. #define RAD_MSS_LPATH /usr/lib/Miles6/lib/win
  489. #define RAD_MSS_LIBS Mss32
  490. #defer HAVE_RAD_MSS $[libtest $[RAD_MSS_LPATH],$[RAD_MSS_LIBS]]
  491. // Info for the Fmod audio engine
  492. // note this may be overwritten in wintools Config.pp
  493. #define FMOD_IPATH
  494. #define FMOD_LPATH
  495. #define FMOD_LIBS fmod
  496. #defer HAVE_FMOD $[libtest $[FMOD_LPATH],$[FMOD_LIBS]]
  497. // Info for http://www.sourceforge.net/projects/chromium
  498. // note this may be overwritten in wintools Config.pp
  499. #define CHROMIUM_IPATH /usr/include/chromium/include
  500. #define CHROMIUM_LPATH /usr/lib/chromium/bin/WINT_NT
  501. #define CHROMIUM_LIBS spuload
  502. #defer HAVE_CHROMIUM $[libtest $[CHROMIUM_LPATH],$[CHROMIUM_LIBS]]
  503. // Is Gtk-- installed? How should we run the gtkmm-config program?
  504. // This matters only to programs in PANDATOOL.
  505. #define GTKMM_CONFIG gtkmm-config
  506. #defer HAVE_GTKMM $[bintest $[GTKMM_CONFIG]]
  507. // Do we have Freetype 2.0 (or better)? If available, this package is
  508. // used to generate dynamic in-the-world text from font files.
  509. // On Unix, freetype comes with the freetype-config executable, which
  510. // tells us where to look for the various files. On Windows, we need to
  511. // supply this information explicitly.
  512. #defer FREETYPE_CONFIG $[if $[not $[WINDOWS_PLATFORM]],freetype-config]
  513. #defer HAVE_FREETYPE $[or $[libtest $[FREETYPE_LPATH],$[FREETYPE_LIBS]],$[bintest $[FREETYPE_CONFIG]]]
  514. #define FREETYPE_CFLAGS
  515. #define FREETYPE_IPATH
  516. #define FREETYPE_LPATH
  517. #define FREETYPE_LIBS
  518. // Define this true to compile in a default font, so every TextNode
  519. // will always have a font available without requiring the user to
  520. // specify one. Define it empty not to do this, saving a few
  521. // kilobytes on the generated library. Sorry, you can't pick a
  522. // particular font to be the default; it's hardcoded in the source
  523. // (although you can use the text-default-font prc variable to specify
  524. // a particular font file to load as the default, overriding the
  525. // compiled-in font).
  526. #define COMPILE_IN_DEFAULT_FONT 1
  527. // Is Maya installed? This matters only to programs in PANDATOOL.
  528. // Also, as of Maya 5.0 it seems the Maya library will not compile
  529. // properly with optimize level 4 set (we get link errors with ostream).
  530. #define MAYA_LOCATION /usr/aw/maya
  531. #defer MAYA_LIBS $[if $[WINDOWS_PLATFORM],Foundation.lib OpenMaya.lib OpenMayaAnim.lib,Foundation OpenMaya OpenMayaAnim]
  532. // Optionally define this to the value of LM_LICENSE_FILE that should
  533. // be set before invoking Maya.
  534. #define MAYA_LICENSE_FILE
  535. #defer HAVE_MAYA $[and $[<= $[OPTIMIZE], 3],$[isdir $[MAYA_LOCATION]/include/maya]]
  536. // Define this if your version of Maya is earlier than 5.0 (e.g. Maya 4.5).
  537. #define MAYA_PRE_5_0
  538. // In the same fashion as mayaegg converter above, set softimage to egg converter as well
  539. #define SOFTIMAGE_LOCATION /c/Softimage/sdk_18sp2/SDK_1.8SP2/SAAPHIRE
  540. #defer SOFTIMAGE_LIBS SAA.lib
  541. #defer HAVE_SOFTIMAGE $[isdir $[SOFTIMAGE_LOCATION]/h]
  542. // Define this to generate static libraries and executables, rather than
  543. // dynamic libraries.
  544. //#define LINK_ALL_STATIC yes
  545. // Define this to export the templates from the DLL. This is only
  546. // meaningful if LINK_ALL_STATIC is not defined, and we are building
  547. // on Windows. Some Windows compilers may not support this syntax.
  548. #defer EXPORT_TEMPLATES yes
  549. // Define this to explicitly link in the various external drivers, which
  550. // are normally separate, as part of the Panda library.
  551. //#define LINK_IN_GL yes
  552. //#define LINK_IN_DX yes
  553. //#define LINK_IN_EGG yes
  554. //#define LINK_IN_PHYSICS yes
  555. // Define USE_COMPILER to switch the particular compiler that should
  556. // be used. A handful of tokens are recognized, depending on BUILD_TYPE.
  557. // This may also be further customized within Global.$[BUILD_TYPE].pp.
  558. // If BUILD_TYPE is "unix", this may be one of:
  559. // GCC (gcc/g++)
  560. // MIPS (Irix MIPSPro compiler)
  561. //
  562. // If BUILD_TYPE is "msvc" or "gmsvc", this may be one of:
  563. // MSVC (Microsoft Visual C++ 6.0)
  564. // MSVC7 (Microsoft Visual C++ 7.0)
  565. // BOUNDS (BoundsChecker)
  566. // INTEL (Intel C/C++ compiler)
  567. #if $[WINDOWS_PLATFORM]
  568. #if $[eq $[USE_COMPILER],]
  569. #define USE_COMPILER MSVC7
  570. #endif
  571. #elif $[eq $[PLATFORM], Irix]
  572. #define USE_COMPILER MIPS
  573. #elif $[eq $[PLATFORM], Linux]
  574. #define USE_COMPILER GCC
  575. #elif $[eq $[PLATFORM], osx]
  576. #define USE_COMPILER GCC
  577. #endif
  578. // Permission masks to install data and executable files,
  579. // respectively. This is only meaningful for Unix systems.
  580. #define INSTALL_UMASK_DATA 644
  581. #define INSTALL_UMASK_PROG 755
  582. // How to invoke bison and flex. Panda takes advantage of some
  583. // bison/flex features, and therefore specifically requires bison and
  584. // flex, not some other versions of yacc and lex. However, you only
  585. // need to have these programs if you need to make changes to the
  586. // bison or flex sources (see the next point, below).
  587. #defer BISON bison
  588. #defer FLEX flex
  589. // You may not even have bison and flex installed. If you don't, no
  590. // sweat; Panda ships with the pre-generated output of these programs,
  591. // so you don't need them unless you want to make changes to the
  592. // grammars themselves (files named *.yxx or *.lxx).
  593. #defer HAVE_BISON $[bintest $[BISON]]
  594. // How to invoke sed. A handful of make rules use this. Since some
  595. // platforms (specifically, non-Unix platforms like Windows) don't
  596. // have any kind of sed, ppremake performs some limited sed-like
  597. // functions. The default is to use ppremake in this capacity. In
  598. // this variable, $[source] is the name of the file to read, $[target]
  599. // is the name of the file to generate, and $[script] is the one-line
  600. // sed script to run.
  601. #defer SED ppremake -s "$[script]" <$[source] >$[target]
  602. // What directory name (within each source directory) should the .o
  603. // (or .obj) files be written to? This can be any name, and it can be
  604. // used to differentiate different builds within the same tree.
  605. // However, don't define this to be '.', or you will be very sad the
  606. // next time you run 'make clean'.
  607. //#defer ODIR Opt$[OPTIMIZE]-$[PLATFORM]$[USE_COMPILER]
  608. // ODIR_SUFFIX is optional, usually empty
  609. #defer ODIR Opt$[OPTIMIZE]-$[PLATFORM]$[ODIR_SUFFIX]
  610. // What is the normal extension of a compiled object file?
  611. #if $[WINDOWS_PLATFORM]
  612. #define OBJ .obj
  613. #else
  614. #define OBJ .o
  615. #endif
  616. ///////////////////////////////////////////////////////////////////////
  617. // The following variables are only meaningful when BUILD_TYPE is
  618. // "unix". These define the commands to invoke the compiler, linker,
  619. // etc.
  620. //////////////////////////////////////////////////////////////////////
  621. // How to invoke the C and C++ compilers.
  622. #if $[eq $[USE_COMPILER], GCC]
  623. #define CC gcc
  624. #define CXX g++
  625. // gcc might run into template limits on some parts of Panda.
  626. // I upped this from 25 to build on OS X (GCC 3.3) -- skyler.
  627. #define C++FLAGS_GEN -ftemplate-depth-30
  628. #else
  629. #define CC cc
  630. #define CXX CC
  631. #endif
  632. // How to compile a C or C++ file into a .o file. $[target] is the
  633. // name of the .o file, $[source] is the name of the source file,
  634. // $[ipath] is a space-separated list of directories to search for
  635. // include files, and $[flags] is a list of additional flags to pass
  636. // to the compiler.
  637. #defer COMPILE_C $[CC] $[CFLAGS_GEN] -c -o $[target] $[ipath:%=-I%] $[flags] $[source]
  638. #defer COMPILE_C++ $[CXX] $[C++FLAGS_GEN] -c -o $[target] $[ipath:%=-I%] $[flags] $[source]
  639. // What flags should be passed to both C and C++ compilers to enable
  640. // compiler optimizations? This will be supplied when OPTIMIZE
  641. // (above) is set to 2, 3, or 4.
  642. #defer OPTFLAGS -O2
  643. // What define variables should be passed to the compilers for each
  644. // value of OPTIMIZE? We separate this so we can pass these same
  645. // options to interrogate, guaranteeing that the correct interfaces
  646. // are generated. Do not include -D here; that will be supplied
  647. // automatically.
  648. #defer CDEFINES_OPT1 _DEBUG $[EXTRA_CDEFS]
  649. #defer CDEFINES_OPT2 _DEBUG $[EXTRA_CDEFS]
  650. #defer CDEFINES_OPT3 $[EXTRA_CDEFS]
  651. #defer CDEFINES_OPT4 NDEBUG $[EXTRA_CDEFS]
  652. // What additional flags should be passed for each value of OPTIMIZE
  653. // (above)? We separate out the compiler-optimization flags, above,
  654. // so we can compile certain files that give optimizers trouble (like
  655. // the output of lex and yacc) without them, but with all the other
  656. // relevant flags.
  657. #defer CFLAGS_OPT1 $[CDEFINES_OPT1:%=-D%] -Wall -g
  658. #defer CFLAGS_OPT2 $[CDEFINES_OPT2:%=-D%] -Wall -g $[OPTFLAGS]
  659. #defer CFLAGS_OPT3 $[CDEFINES_OPT3:%=-D%] $[OPTFLAGS]
  660. #defer CFLAGS_OPT4 $[CDEFINES_OPT4:%=-D%] $[OPTFLAGS]
  661. // What additional flags should be passed to both compilers when
  662. // building shared (relocatable) sources? Some architectures require
  663. // special support for this.
  664. #defer CFLAGS_SHARED -fPIC
  665. // How to generate a C or C++ executable from a collection of .o
  666. // files. $[target] is the name of the binary to generate, and
  667. // $[sources] is the list of .o files. $[libs] is a space-separated
  668. // list of dependent libraries, and $[lpath] is a space-separated list
  669. // of directories in which those libraries can be found.
  670. #defer LINK_BIN_C $[cc_ld] -o $[target] $[sources] $[flags] $[lpath:%=-L%] $[libs:%=-l%]\
  671. $[fpath:%=-Wl,-F%] $[patsubst %,-framework %, $[frameworks]]
  672. #defer LINK_BIN_C++ $[cxx_ld]\
  673. -o $[target] $[sources]\
  674. $[flags]\
  675. $[lpath:%=-L%] $[libs:%=-l%]\
  676. $[fpath:%=-Wl,-F%] $[patsubst %,-framework %, $[frameworks]]
  677. // How to generate a static C or C++ library. $[target] is the
  678. // name of the library to generate, and $[sources] is the list of .o
  679. // files that will go into the library.
  680. #if $[eq $[PLATFORM], osx]
  681. #defer STATIC_LIB_C libtool -static -o $[target] $[sources]
  682. #defer STATIC_LIB_C++ libtool -static -o $[target] $[sources]
  683. #else
  684. #defer STATIC_LIB_C ar cru $[target] $[sources]
  685. #defer STATIC_LIB_C++ ar cru $[target] $[sources]
  686. #endif
  687. // How to run ranlib, if necessary, after generating a static library.
  688. // $[target] is the name of the library. Set this to the empty string
  689. // if ranlib is not necessary on your platform.
  690. #defer RANLIB ranlib $[target]
  691. // Where to put the so_locations file, used by an Irix MIPSPro
  692. // compiler, to generate a map of shared library memory locations.
  693. #defer SO_LOCATIONS $[DTOOL_INSTALL]/etc/so_locations
  694. // How to generate a shared C or C++ library. $[source] and $[target]
  695. // as above, and $[libs] is a space-separated list of dependent
  696. // libraries, and $[lpath] is a space-separated list of directories in
  697. // which those libraries can be found.
  698. #if $[eq $[PLATFORM], osx]
  699. #defer SHARED_LIB_C $[cc_ld] -o $[target] -install_name $[notdir $[target]] $[sources] $[lpath:%=-L%] $[libs:%=-l%] $[patsubst %,-framework %, $[frameworks]]
  700. #defer SHARED_LIB_C++ $[cxx_ld] -dynamic -dynamiclib -o $[target] -install_name $[notdir $[target]] $[sources] $[lpath:%=-L%] $[libs:%=-l%] $[patsubst %,-framework %, $[frameworks]]
  701. #else
  702. #defer SHARED_LIB_C $[cc_ld] -shared -o $[target] $[sources] $[lpath:%=-L%] $[libs:%=-l%]
  703. #defer SHARED_LIB_C++ $[cxx_ld] -shared -o $[target] $[sources] $[lpath:%=-L%] $[libs:%=-l%]
  704. #endif
  705. // How to install a data file or executable file. $[local] is the
  706. // local name of the file to install, and $[dest] is the name of the
  707. // directory to put it in.
  708. // On Unix systems, we strongly prefer using the install program to
  709. // install files. This has nice features like automatically setting
  710. // the permissions bits, and also is usually clever enough to install
  711. // a running program without crashing the running instance. However,
  712. // it doesn't understanding installing a program from a subdirectory,
  713. // so we have to cd into the source directory first.
  714. #defer install_dash_p $[if $[KEEP_TIMESTAMPS],-p,]
  715. #defer INSTALL $[if $[ne $[dir $[local]], ./],cd ./$[dir $[local]] &&] install -m $[INSTALL_UMASK_DATA] $[install_dash_p] $[notdir $[local]] $[dest]/
  716. #defer INSTALL_PROG $[if $[ne $[dir $[local]], ./],cd ./$[dir $[local]] &&] install -m $[INSTALL_UMASK_PROG] $[install_dash_p] $[notdir $[local]] $[dest]/
  717. // Variable definitions for building with the Irix MIPSPro compiler.
  718. #if $[eq $[USE_COMPILER], MIPS]
  719. #define CC cc -n32 -mips3
  720. #define CXX CC -n32 -mips3
  721. // Turn off a few annoying warning messages.
  722. // 1174 - function 'blah' was declared but never used
  723. // 1201 - trailing comma is nonstandard.
  724. // 1209 - controlling expression is constant, e.g. if (0) { ... }
  725. // 1234 - access control not specified, 'public' by default
  726. // 1355 - extra ";" ignored
  727. // 1375 - destructor for base class is not virtual.
  728. // this one actually is bad. But we got alot of them from the classes
  729. // that we've derived from STL collections. Beware of this.
  730. // 3322 - omission of explicit type is nonstandard ("int" assumed)
  731. #define WOFF_LIST -woff 1174,1201,1209,1234,1355,1375,3322
  732. // Linker warnings
  733. // 85 - definition of SOMESYMBOL in SOMELIB preempts that of definition in
  734. // SOMEOTHERLIB.
  735. #define WOFF_LIST $[WOFF_LIST] -Wl,-LD_MSG:off=85
  736. #defer OPTFLAGS -O2 -OPT:Olimit=2500
  737. #defer CFLAGS_OPT1 $[CDEFINES_OPT1:%=-D%] $[WOFF_LIST] -g
  738. #defer CFLAGS_OPT2 $[CDEFINES_OPT2:%=-D%] $[WOFF_LIST]
  739. #defer CFLAGS_OPT3 $[CDEFINES_OPT3:%=-D%] $[WOFF_LIST]
  740. #defer CFLAGS_OPT4 $[CDEFINES_OPT4:%=-D%] $[WOFF_LIST]
  741. #defer CFLAGS_SHARED
  742. #defer STATIC_LIB_C $[CC] -ar -o $[target] $[sources]
  743. #defer STATIC_LIB_C++ $[CXX] -ar -o $[target] $[sources]
  744. #defer RANLIB
  745. #defer SHARED_FLAGS -Wl,-none -Wl,-update_registry,$[SO_LOCATIONS]
  746. #defer SHARED_LIB_C $[cc_ld] -shared $[SHARED_FLAGS] -o $[target] $[sources] $[lpath:%=-L%] $[libs:%=-l%]
  747. #defer SHARED_LIB_C++ $[cxx_ld] -shared $[SHARED_FLAGS] -o $[target] $[sources] $[lpath:%=-L%] $[libs:%=-l%]
  748. #endif
  749. //////////////////////////////////////////////////////////////////////
  750. // There are also some additional variables that control specific
  751. // compiler/platform features or characteristics, defined in the
  752. // platform specific file Config.platform.pp. Be sure to inspect
  753. // these variables for correctness too.
  754. //////////////////////////////////////////////////////////////////////