home *** CD-ROM | disk | FTP | other *** search
/ CD Actual Thematic 25: Programming / pc_actual_25.iso / C_C++ / OptiVecForVisualC++ / README.TXT < prev    next >
Encoding:
Text File  |  2001-09-05  |  11.3 KB  |  280 lines
  1.       ┌───────────────────────────────────────────────────────────────┐
  2.       │                                                               │
  3.       │                      OptiVec for C / C++                      │
  4.       │                                                               │
  5.       │                      Shareware Version 3                      │
  6.       └───────────────────────────────────────────────────────────────┘
  7.  
  8. Contents:
  9.      1. Introduction
  10.      2. System requirements
  11.      3. Installation
  12.      4. Running the examples
  13.      5. Documentation
  14.      6. What's New?
  15.      7. Copyright
  16.      8. Registered Version
  17.  
  18. 1. Introduction
  19. ---------------
  20. Use vector functions instead of loops - if it matters to you how fast and
  21. how accurate your data are processed!
  22. The largest portion of almost all programs processing numerical data
  23. consists of loops. Replace these loops by the specialized vector
  24. and matrix functions of OptiVec, and exploit all the advantages of
  25. vectorized programming:
  26.  
  27. - OptiVec was almost entirely written in Assembly language. The result is a
  28.   highly optimized and numerically accurate code, running 2-3 times faster
  29.   than compiled loops.
  30.  
  31. - fully vectorized forms of all operators and functions of the language
  32.   C/C++ for all integer and floating-point (including complex!) data types
  33.  
  34. - Additionally many other real and complex math functions, statistics,
  35.   analysis, FFT techniques, graphics - in total more than 3000!
  36.  
  37. - Simple and logical syntax, for example
  38.   "VF_exp( Y, X, size );"      for Y[i] = exp( X[i] ) with "float" arrays,
  39.   "VD_FFT( Y, X, size, 1 );"   for double-precision forward FFT
  40.   "ME_mulM( MZ, MX, MY, htX, lenX, lenY );"
  41.                                for extended-precision matrix multiplication
  42.  
  43. 2. System requirements
  44. ----------------------
  45. This version of OptiVec is designed for IBM AT, PS/2 or compatibles,
  46. equipped at least with a 80386 CPU and a 80387 coprocessor
  47. (Visual C++ version: at least 486DX).
  48.  
  49. Depending on your choice when ordering or downloading,
  50. - either for Borland C++ (Turbo C++), version 3.0 or higher, memory
  51.   models Win32, Windows-LARGE, or  DOS-LARGE
  52. - or for Microsoft Visual C++, version 5.0 or higher, "single-thread debug"
  53.   or "multi-thread debug"
  54.  
  55. Registered version for Borland C/C++:
  56. all memory models; separate libraries optimized for all processors from
  57. 486DX/Pentium down to 286 with or without coprocessor.
  58.  
  59. Registered version for Microsoft Visual C++:
  60. all PC models using the "single-thread", "multi-thread", or
  61. "multi-thread DLL" run-time libraries, both for debug and release.
  62.  
  63.  
  64. 3. Installation
  65. ---------------
  66. a) On all operating systems except Windows 2000 or XP:
  67.    Please run the installation program, INSTALL.EXE.
  68.    If you don't like the default directory structure, you may change it
  69.    afterwards.
  70. b) On Windows 2000 or XP:
  71.    You cannot use INSTALL.EXE, as it will hang on Windows 2000 or XP!
  72.    Instead, please manually create a directory OPTIVEC and unzip the file
  73.    DOC.ZIP into it.
  74.    Then create a subdirectory OPTIVEC\LIB and unzip the file LIB.ZIP into it.
  75.    Create a subdirectory OPTIVEC\INCLUDE and unzip the file INCLUDE.ZIP
  76.    into it.
  77.    Now please execute INITOVBC.EXE (Borland C++ version) or INITOVVC.EXE
  78.    (Visual C++ version) to complete the installation.
  79.  
  80. After you completed the installation, you must set the library search path
  81. and the include-file search path according to your OptiVec directory choice:
  82. Add these paths to the standard settings in the menu
  83. "Options/Project/Directories" of Borland C 4.x, 5.x, and BC++ Builder, or
  84. "Options/Directories" in Borland C++ 3.x.
  85. (Remember: a semicolon is used to separate entries in these fields.)
  86.  
  87. Special Turbo C 3.x version only:
  88.    In order to avoid table-overflow errors of the TC 3.x linker, the libraries
  89.    VCL3.LIB and MCL3.LIB were split up into 16 smaller libraries. Instead
  90.    of including VCL3.LIB, you have to include VECLIB.LIB and those data-type
  91.    specific libraries which you actually need:
  92.    VF.LIB for VF_ functions,
  93.    VD.LIB for VD_ functions,
  94.    VCF.LIB for VCF_ functions, and so on.
  95.    VI.LIB for VBI_, VSI_, VI_, and VLI_ functions
  96.    VU.LIB for VUB_, VUS_, VU_, and VUL_ functions
  97.    VQI.LIB for VQI_ functions
  98.    MF.LIB for MF_ functions, and so on.
  99.  
  100.  
  101. 4. Running the examples
  102. -----------------------
  103.  
  104. Check your installation by compiling and running the appropriate demo file.
  105. Follow the instructions in the header of that file.
  106. If you get compiler errors like "Cannot open include file ...", or a
  107. linker error "Unresolved external", you probably did not set the library
  108. and include paths correctly.
  109.  
  110. OptiVec for Borland C/C++:
  111.   VDEMOB.BPR  is a BC++ Builder 4+ project,
  112.   VDEMOW.CPP  is for Windows with Borland C++ 5.0 or higher.
  113.   VDEMO.CPP   is a DOS program,
  114.   Separate versions of the Windows demo program are supplied for
  115.   older BC versions:
  116.   VDEMOW1.CPP is for Borland C++ 3.x with OWL 1.0
  117.   VDEMOW2.CPP is for Borland C++ 4.0 with OWL 2.0
  118.  
  119.   For BC++ Builder 4+, open the project VDEMOB.BPR, compile and run.
  120.  
  121.   For Windows95, 98 or NT with Borland C++ 4.x, 5.x or higher (without OWL),
  122.       either do a command-line compile:
  123.           a) 32-bit: type
  124.                BCC32 -W -Iinclude vdemow.cpp lib\vcf3w.lib
  125.           b) 16-bit: type
  126.                BCC -ml -W -Iinclude vdemow.cpp lib\vcl3w.lib
  127.       and run the program by typing:  vdemow
  128.  
  129.       or create a project containing
  130.       VDEMOW.CPP and VCF3W.LIB.
  131.       In the TargetExpert, choose as target
  132.         Application [.EXE]  for Win32, GUI model.
  133.         Tick the boxes for Standard Libraries ClassLibrary, and Runtime.
  134.         Use Static linking and Single-Thread
  135.  
  136.   For Windows95, 98 or NT with Borland C++ 4.x and OWL 2.0
  137.       create a project containing
  138.       VDEMOW2.CPP and VCF3W.LIB.
  139.       In the TargetExpert, choose as target
  140.         Application [.EXE]  for Win32, GUI model.
  141.         Tick the boxes for Standard Libraries OWL, ClassLibrary, and Runtime.
  142.         Use Static linking and Single-Thread (which means: don't check the
  143.         Multithread box).
  144.  
  145.   For 16-bit Windows with Borland C++ 4.x, 5.x or higher (without OWL)
  146.       create a project containing
  147.       VDEMOW.CPP and VCL3W.LIB.
  148.       In the TargetExpert, choose as target
  149.         Application [.EXE]  for Windows 3.x, model LARGE.
  150.         Tick the boxes for Standard Libraries ClassLibrary, and Runtime.
  151.         Use, as you prefer, either Dynamic or Static linking.
  152.  
  153.   For DOS, create a project containing
  154.      VDEMO.CPP,  VCL3.LIB, and  GRAPHICS.LIB.
  155.      Choose the application either as DOS Standard or as DOS Overlay.
  156.      VCL3.LIB may or may not be used as an overlay (option to be set:
  157.      "Project/Local Options/Overlay this module").
  158.      Choose the memory  model LARGE.
  159.      Check the floating-point options. Neither "No floating-point" nor
  160.      "Floating-point emulation" should be selected.
  161.  
  162.   For 16-bit Windows with Borland C++ 3.x and OWL 1.0
  163.       create a project containing
  164.       VDEMOW1.CPP,  VCL3W.LIB, and OWL.DEF.
  165.       Choose the application as Windows-EXE, model LARGE.
  166.       Choose the memory model LARGE and 287 floating-point operations
  167.  
  168.   For 16-bit Windows with Borland C++ 4.x and OWL 2.0
  169.       create a project containing
  170.       VDEMOW2.CPP and VCL3W.LIB.
  171.       In the TargetExpert, choose as target
  172.         Application [.EXE]  for Windows 3.x, model LARGE.
  173.         Tick the boxes for Standard Libraries OWL, ClassLibrary, and Runtime.
  174.         Use, as you prefer, either Dynamic or Static linking.
  175.  
  176.  
  177. OptiVec for Microsoft Visual C++:
  178.     create a project as a "Win32 application", containing
  179.     VDEMOW.CPP  and  OVVCSD.LIB.
  180.     Choose single-thread debug.
  181.  
  182. Data-fitting functions demo:
  183.     There is a demo program available for the data-fitting functions,
  184.     FITDEMO.CPP (for Borland C++, DOS), or FITDEMOW.CPP for Windows.
  185.     The latter file can be used with Borland C++ (4.x or higher) or Visual C++,
  186.     under Windows 3.1 or Windows 95/98/NT.
  187.     With BC++ Builder, you can alternatively open the project FITDEMOB.BPR.
  188.  
  189.     Follow the instructions given above for VDEMOW.CPP and VDEMOB.BPR.
  190.     With 16-bit BC++, you must additionally include the library MCL3.LIB
  191.     (for DOS) or MCL3W.LIB (for Windows).
  192.  
  193.  
  194. 5. Documentation
  195. ----------------
  196. The full OptiVec documentation is to be found in the files
  197. HANDBOOK.HTM, FUNCREF.HTM, MATRIX.HTM, and CMATH.HTM to be read with
  198. an HTML browser like Netscape or IE.
  199.  
  200.  
  201. 6. What's New?
  202. --------------
  203. Version 3:
  204. a) Version 3 introduces VecObj, a new object-oriented interface to OptiVec,
  205.    written by Brian Dale, Case Western Reserve University.
  206.    See chapter 3 of HANDBOOK.HTM for details.
  207. b) In addition to cartesian complex functions, now structs and classes for
  208.    complex numbers in polar coordinates are defined, and a large number of
  209.    functions is available for them, both in vectorized form and for scalars.
  210. c) Other additions include the functions VF_FFTtoC, MF_FFTtoC, VF_Langevin
  211.    and a complete overhaul of the nonlinear data-fitting functions.
  212. d) The documentation is now in HTML format for easier reference.
  213.  
  214. Version 3.04/3.05:
  215. e) A few bug fixes, affecting the functions
  216.    MCF_mulV,  MCF_tmulV, and their MCD_ analogues;
  217.    pf_real, pf_imag, and their pd_, pe_ analogues;
  218.    pd_mulRe, pd_divRe, pd_divrRe
  219. f) Routine InitOVBC.EXE / InitOVVC.EXE for installation on Windows 2000 or XP
  220.  
  221.  
  222. 7. Copyright
  223. ------------
  224. The copyright owner of this product as a whole and of all its constituent
  225. parts is
  226.          OptiCode
  227.          Dr. Martin Sander Software Development
  228.          Steinachstr. 9A
  229.          D-69198 Schriesheim
  230.          Germany
  231.          e-mail: MartinSander@optivec.com
  232.  
  233. This Shareware version of OptiVec is freely distributable in unchanged form.
  234. For the distribution of applications created using OptiVec, you need the
  235. registered version. The detailed licence terms are described in chapter 1.2
  236. of the file HANDBOOK.HTM.
  237.  
  238.  
  239. 8. Registered Version
  240. ---------------------
  241. If you like OptiVec and decide to use it, please be fair and register.
  242. The registered version
  243.  
  244. -  supports all memory models of Windows95, NT, 3.x, and DOS of Borland C++,
  245.    or all PC debug and release targets of Visual C++, respectively.
  246.  
  247. -  has individually optimized libraries for each degree of processor
  248.    backward-compatibility (Borland C++ only):
  249.       486DX/Pentium+
  250.       386+ (387 coprocessor required)
  251.       286+ (no coprocessor required).
  252.  
  253. -  comes with printed documentation.
  254.  
  255. -  entitles you to two years of free updates
  256.    (by downloading from our web site)
  257.  
  258. -  costs USD 199 or EUR 199 for the commercial edition,
  259.          USD  89 or EUR  89 for the educational edition,
  260.    and can be ordered by e-mail from the author or through the
  261.    following secure-server Internet sites:
  262.  
  263.    SWREG:
  264.    http://www.swreg.org/soft_shop/47/
  265.  
  266.    ShareIt:
  267.    OptiVec for Borland C++:
  268.       http://www.shareit.com/programs/101557.htm         (English handbook)
  269.       http://www.shareit.com/deutsch/programs/101556.htm (German handbook)
  270.    OptiVec for MSVC:
  271.       http://www.shareit.com/programs/103421.htm
  272.  
  273. See chapter 1.3 of the file HANDBOOK.HTM for further details about
  274. ordering.
  275.  
  276.  
  277.     * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  278.  
  279. Copyright (C) OptiCode - Dr. Martin Sander Software Dev. 1996-2001
  280.