home *** CD-ROM | disk | FTP | other *** search
/ Learn 3D Graphics Programming on the PC / Learn_3D_Graphics_Programming_on_the_PC_Ferraro.iso / rwwin / read4.tx_ / read4.bin
Text File  |  1995-11-14  |  5KB  |  113 lines
  1.                     RenderWare(tm) v1.4 FCS Libraries
  2.                     =================================
  3.  
  4. ----------------------------------------------------------------------------
  5. These libraries are copyright Criterion Software Limited 1994. All Rights
  6. Reserved. You may not disassemble, decompile or reverse engineer these
  7. libraries.
  8.  
  9. These libraries are furnished under a license agreement or a non-disclosure
  10. agreement. The software may be used or copied only in accordance with the
  11. terms of the agreement. It is against the law to copy the software on any
  12. medium except as specifically allowed in the license or non-disclosure
  13. agreement.
  14.  
  15. RenderWare is a registered trademark of Canon Inc.
  16. ----------------------------------------------------------------------------
  17.  
  18. This directory contains the libraries of the RenderWare(tm) v1.4 release
  19. the Microsoft Windows family of Operating Systems.
  20.  
  21. Libraries
  22. --------------
  23.  
  24. The following libraries are located in his directory. Note: A subset of
  25. the libraries may be chosen at install time so not all libraries may be 
  26. present
  27.  
  28. rwl.dll        Floating point, production DLL
  29. rwlb.lib       Floating point, Borland C import library
  30. rwld.dll       Floating point, debugging DLL
  31. rwlv.lib       Floating point MSVC 1.5 import library
  32. rwnld.lib      Floating point, debugging MSVC 2.0 static library
  33. rwnlp.lib      Floating point, production MSVC 2.0 static library
  34. rwnxd.lib      Fixed point, debugging MSVC 2.0 static library
  35. rwnxp.lib      Fixed point, production MSVC 2.0 static library
  36. rwrlw.lib      Register based, floating point Watcom import library
  37. rwrxw.lib      Register based, fixed point Watcom import library
  38. rwslw.lib      Stack based, floating point Watcom import library   
  39. rwsxw.lib      Stack based, fixed point Watcom import library   
  40. rwwrld.lib     Register based, floating point, debugging,  Watcom static library
  41. rwwrlp.lib     Register based, floating point, production,  Watcom static library
  42. rwwrxd.lib     Register based, fixed point, debugging,  Watcom static library
  43. rwwrxp.lib     Register based, fixed point, production,  Watcom static library
  44. rwwsld.lib     Stack based, floating point, debugging,  Watcom static library
  45. rwwslp.lib     Stack based, floating point, production,  Watcom static library
  46. rwwsxd.lib     Stack based, fixed point, debugging,  Watcom static library
  47. rwwsxp.lib     Stack based, fixed point, production,  Watcom static library
  48. rwx.dll        Fixed point, production DLL
  49. rwxb.lib       Fixed point,  Borland C import library
  50. rwxd.dll       Fixed point, debugging DLL
  51. rwxv.lib       Fixed point, MSVC 1.5 import library
  52.  
  53. All the libraries have identical APIs and, therefore, share the same include
  54. files (found in the \rwwin\include\ directory of this distribution).
  55.  
  56. Platform
  57. --------
  58.  
  59. Simply link against the version of the library for the platform you wish to
  60. build for.
  61.  
  62. Calling Convention
  63. ------------------
  64.  
  65. Simply link against the library whose calling convention matches the one
  66. used by your application.
  67.  
  68. Numeric Type
  69. ------------
  70.  
  71. See Chapter 2 of the RenderWare reference manual for a discussion of the 
  72. fixed and floating-point versions of RenderWare. Having decided whether 
  73. to use fixed or floating-point RenderWare (and having modified your 
  74. application if necessary) simply link against the appropriate library.
  75.  
  76. Kernel Type
  77. -----------
  78.  
  79. Two versions of the RenderWare library kernel are available to developers. The
  80. production and debugging versions. The debugging version contains considerably
  81. more parameter validation and error checking than the production version. The
  82. debugging version also issues messages about errors and potential problems to
  83. a debugging stream. The debugging libraries are particularly useful in
  84. identifying missed API level error conditions, tracing the parsing of problem
  85. scripts, and when requesting technical support from the RenderWare technical
  86. support group.
  87.  
  88. This additional error checking and validation causes the debugging library to
  89. be considerably larger and slower than its production equivalent. Therefore,
  90. is is essential that the production kernel be used in all production builds.
  91. The debugging kernel must only be used during the application development process.
  92.  
  93. It is important to note, however, that the debugging kernel is designed to
  94. behave externally in exactly the same way as the production kernel. The flow
  95. of control is the same in both libraries. The debugging kernel will not attempt
  96. to abort an operation if its additional error checking detects an error. Instead,
  97. it attempts to issue informational messages which will assist the developer and
  98. RenderWare technical support to identify the problem.
  99.  
  100. To use the RenderWare debugging kernel simply relink your application against
  101. the appropriate debugging library is you are using static linked libraries. 
  102. No recompilation is necessary. If you are using a DLL library then simply
  103. switch to using the debugging DLL. 2 batch files are provided in this 
  104. directory for switching to and from the debugging DLL library
  105.  
  106.   rwn2d.bat - switch to debugging DLL
  107.   rwd2n.bat - switch to production DLL
  108.  
  109. For more information on the debugging kernel see Chapter 1 of the RenderWare
  110. reference manual.
  111.  
  112.                     =================================
  113.