ENGSIM for MS VC++ Engineering Simulation Library for Microsoft Visual C++ Copyright(C) ContinOceean Tech Inc. 1996. All rights reserved. Version 1.0 (November 1996) ENGSIM is a registered trade mark of ContinOcean Tech Inc. CTI ENGSIM is a business unit wholly owned by ContinOcean Tech Inc. Note: You should read the Software License Agreement (see Section V) before using this software. If you start to use this software, you agree to be bound by the terms of the Software License Agreement. I. Features of ENGSIM for MS VC++ -> More than 100% Faster than MATLAB -> Very Easy to program. Use the same programming syntax as MATLAB, ANSI C and/or ANSI C++ -> Graphics Support is Very Good -> Support Negative Indexing for Array and Matrix -> Support Complex Array and Complex Matrix -> Support User-Defined Classes -> Support User-Graphics Development -> Support Unix C and ANSI C Programming Style -> Support Communications Engineering Simulation -> Support Signal Processing Simulation -> Support Fixed-Point Digital Signal Processing Simulation II. How to Install ENGSIM for MS VC++ Before installing ENGSIM for MS VC++, you should make sure to have Windows NT or Windows 95 as the operating system of your PC and have Microsoft Visual C++ Version 4.0 (or higher) installed. If you have ENGSIM for MS VC++ with two floppy disks, you can insert the first floppy into Drive A. Then click My Computer folder, click Drive A, click setup. Then follow the instructions on the screen to install ENGSIM for MS VC++. If you downloaded ENGSIM for MS VC++ from www.webexpert.net/continocean/engsim.htm or any other sources, you should copy the PKZIPed ENGSIM.ZIP to a temporary directory (folder) and use PKUNZIP to expand the files. Or you should copy the self-extracting file ENGSIM.EXE to a temporary directory (folder) and click ENGSIM.EXE to expand the file. Then you can open the temporary directory (folder) and click setup. III. How to Run ENGSIM for MS VC++ After installing ENGSIM for MS VC++, you can click ENGSIM for MS VC++ icon to open Microsoft Development Studio. From Microsoft Development Studio, click File, click OpenWorkspace, click the ENGSIM folder, and finally click Sim to load the complete ENGSIM library and interface. After loading the ENGSIM library and interface, click File, click Open, click main.cpp. The source code of main.cpp will be shown in the editing window of Microsoft Development Studio. The coding style of main.cpp is the same as Unix ANSI C. It includes several examples which can be called from main() routine. You can edit main.cpp to include your own C source files and call them from main(). There are several examples under \engsim\examples which are included in main.cpp. You may want to edit main.cpp and the examples for exercises. To compile and link the code, click Build in Microsoft Development Studio, click Build Sim.exe, then all the files are compiled and linked with necessary libraries and an executable code Sim.exe is built for you to execute. If you encounter any warning messages, you should ignore them (sometimes you need to click OK). To execute Sim.exe, click Build, click Execute Sim.exe. To debug Sim.exe, set a breakpoint in the source code by clicking at the line of the source code, then click build, click debug, click go. Then follow the instructions to continue the debugging process. Microsoft Development Studio's left-lower corner has three colorful small icons and the third one is called FileView. You may click FileView to open the list of all source files including Help.txt, ReadMe.txt, main.cpp and your source files. To open a file in the FileView list, for example, Help.txt, click Help.txt. By opening Help.txt, you can view the on-line help for ENGSIM instructions. Please read file HELP.txt (or HELP.cpp) for usage of ENGSIM instructions for your MS VC++ code. Read the user's manual ENGSIM.DOC for detailed documentation of ENGSIM for MS VC++. You need a word processor, for example MS Word, to read the manual and you may also want to print it out to get a hard copy of the manual. It would be helpful if you have some basic knowledge of C/C++. However, if you do not, you can start from the simple examples in this manual. You do not have to read all chapters of any C/C++ book. You need only to check related sections if you encounter certain problems. You may use the classical C book as your reference: B.W. Kernighan and D.M. Ritchie, The C Programming Language, second edition, Prentice Hall, 1988. The following references are not necessary for learning the basics of ENGSIM for MS VC++, but are useful if you want to become an expert in C++: M.A. Ellis and B.Stroustrup, The Annotated C++ Reference Manual, Reading: Addospm Wesley, 1990. B. Stroustrup, The C++ Programming Language, 2ed Ed., Reading: Addison Wesley, 1991. J. Kruglinski, Inside Visual C++, Microsoft Press, 1996. IV. Release Notes This is a shareware version of ENGSIM for MS VC++ and is identical to the commercial version except for certain restrictions. You may use this version for not more than 60 days and you are encouraged to distribute the software to other people provided they agree the Software License Agreement (see Section V). You may purchase a registered version of ENGSIM for MS VC++ and you will get one-year free technical support. The cost is US $399 for an Engineer's Version and is US $99 for a Student's Version. Please contact CTI ENGSIM at Tel: (201)257-1912 Fax: (201)257-9634 Email: continocean@webexpert.net www.webexpert.net/continocean/engsim.htm ContinOcean Tech Inc. 12 Mountain Ave. Montville, NJ USA 07045 ENGSIM is a registered trade mark of ContinOcean Tech Inc. CTI ENGSIM is a business unit wholly owned by ContinOcean Tech Inc. V. SOFTWARE LICENSE AGREEMENT This is a legal Agreement between you and CONTINOCEAN TECH INC. (CONTINOCEAN). You agree to be bound by the terms of this Agreement. If you do not agree to the terms of this Agreement, please stop using the Software and delete it from your computer. LICENSE TERMS 60 days Grant of License. CONTINOCEAN grants to you the right to use one copy of the enclosed "ENGSIM: Engineering Simulation Library for Microsoft Visual C++: V1.0" software program (SOFTWARE) on a single computer for not more than 60 days. You may not rent or lease the SOFTWARE, but you may transfer the SOFTWARE and accompanying written material on a permanent basis provided you retain no copies and the recipient agrees to the terms of this Agreement. You may not reverse engineer, decompile, or disassemble the SOFTWARE. The Agreement is effective from the day you start to use the Software until terminated. You may terminate this Agreement by stopping using the Software and deleting it from your computer. If you break this Agreement, CONTINOCEAN can terminate this license upon written notification to you. Intellectual Property. The SOFTWARE is owned by CONTINOCEAN and is protected by United States copyright laws and corresponding international treaties. Therefore, you must treat the SOFTWARE like any other proprietary material except that you may either (a) make one copy of the SOFTWARE solely for backup or archival purposes, or (b) transfer the SOFTWARE to a single hard disk provided you keep the original solely for backup or archival purposes. You may not copy the written materials accompanying the SOFTWARE. Furthermore, you acknowledge that the license provided under this Agreement is a limited one and in no way shall be construed to provide you an express or an implied license to any of CONTINOCEAN's Intellectual Property Rights other than as expressly set forth above and in no way confers to you or anyone else any right, title, or interest to the CONTINOCEAN's Intellectual Property Rights in the SOFTWARE. VI. How to Purchase ENGSIM for MS VC++ You may purchase a registered version of ENGSIM for MS VC++ and you will get one-year free technical support. The cost is US $399 for an Engineer's Version and is US $99 for a Student's Version. Please contact CTI ENGSIM at Tel: (201)257-1912 Fax: (201)257-9634 Email: continocean@webexpert.net www.webexpert.net/continocean/engsim.htm Please send your money order, check or credit card number to: ContinOcean Tech Inc. 12 Mountain Ave. Montville, NJ USA 07045 ENGSIM is a registered trade mark of ContinOcean Tech Inc. CTI ENGSIM is a business unit wholly owned by ContinOcean Tech Inc.