home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Science / Science.zip / stplot16.zip / plot_us.inf (.txt) < prev    next >
OS/2 Help File  |  1995-07-01  |  23KB  |  510 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. PLOT is an OS/2 Presentation Manager application which offers graphical plot 
  5. support. Graphics created by PLOT can be printed or exported to a Windows 3.x 
  6. bitmap file. This allows you to load the created graphic from a word processor 
  7. and to embed it in your documents. 
  8.  
  9. PLOT highlights 
  10.  
  11. Calling PLOT from other applications 
  12.  
  13.  
  14. ΓòÉΓòÉΓòÉ 1.1. 1.1 PLOT highlights ΓòÉΓòÉΓòÉ
  15.  
  16. Version 1.6
  17.  
  18. Γûá Fully 32 bit architecture 
  19. Γûá Export a graphic to a Windows 3.x bitmap file 
  20. Γûá Copy a graphic to the clipboard 
  21. Γûá Capability of choosing line types, colors and markers 
  22. Γûá Accelerator keys providing quick access to commands 
  23. Γûá Enhanced color graphics printing support 
  24. Γûá Graph data can be easily created using a text editor 
  25. Γûá Save settings command 
  26. Γûá Online help for every command by pressing F1 
  27. Γûá Easy to use 
  28.  
  29.  
  30. ΓòÉΓòÉΓòÉ 1.2. 1.2 Calling PLOT from other applications ΓòÉΓòÉΓòÉ
  31.  
  32. This information is intended for developers writing applications that need 
  33. graphical plot support under OS/2 version 2. 
  34.  
  35. If you are writing an OS/2 application that needs X-Y plot support, PLOT may be 
  36. very useful. You can start PLOT from your program by creating a child process 
  37. via DosExecPgm. 
  38.  
  39. If you are writing a commercial application, you can include PLOT on your 
  40. software package. In this case, registration fees have to be paid for every 
  41. distributed package. 
  42.  
  43. If you are interested in using PLOT together with your commercial software, 
  44. please contact us by writing to the following address: 
  45.  
  46. StegSoft
  47. Haid-und-Neu-Str. 16/90
  48. 76131 Karlsruhe
  49. West Germany
  50.  
  51. Fax: +49 721 693242
  52.  
  53.  
  54. ΓòÉΓòÉΓòÉ 1.2.1. 1.2.1 Creating a child process ΓòÉΓòÉΓòÉ
  55.  
  56. The following example code shows a way to call PLOT from an application written 
  57. in C. First of all, a file containing all your data must be created and stored 
  58. to a disk. Then a child process must be created using the DosExecPgm kernel 
  59. function. This will start PLOT and your data file will automatically be loaded. 
  60.  
  61. #define INCL_DOSPROCESS
  62. #include <os2.h>
  63.  
  64. RESULTCODES resc;
  65. CHAR szFailName[CCHMAXPATH];
  66. CHAR szCommandLine[] = "plot\0yourdata.plt\0";
  67.  
  68. /*
  69.  * The following function writes your data to a file
  70.  * named "yourdata.plt". It is not included on this
  71.  * package, but you can obtain it by contacting us.
  72.  */
  73. SavePlotData("yourdata.plt", xdata, ydata, flags);
  74.  
  75. DosExecPgm(szFailName,          /* Object-name buffer  */
  76.            sizeof(szFailName),  /* Length of buffer    */
  77.            EXEC_ASYNC,          /* Async flag          */
  78.            szCommandLine,       /* Argument string     */
  79.            (PSZ) NULL,          /* Environment string  */
  80.            &resc,               /* Address of result   */
  81.            "plot.exe");         /* Name of application */
  82.  
  83.  
  84. ΓòÉΓòÉΓòÉ 2. 2. System requirements ΓòÉΓòÉΓòÉ
  85.  
  86. PLOT was translated with a 32 bit compiler to take advantage of the power of 
  87. the new OS/2 version. The system requirements for running this program are as 
  88. follows: 
  89.  
  90. Γûá 386 or higher based personal computer 
  91. Γûá 6.0 MB of memory 
  92. Γûá One diskette drive 
  93. Γûá A hard disk with 200 kB free space 
  94. Γûá Operating system OS/2 version 2.0 or higher 
  95. Γûá A mouse 
  96.  
  97. The availability of a numerical coprocessor 387 or 487 is not necessary for 
  98. running PLOT. However, PLOT will use the coprocessor if present. In this case, 
  99. the performance of this program will be increased considerably. 
  100.  
  101.  
  102. ΓòÉΓòÉΓòÉ 3. 3. Installation ΓòÉΓòÉΓòÉ
  103.  
  104. To install PLOT on your system, copy the file plot.exe to a directory of your 
  105. hard disk. Be sure to copy the plot help file plot.hlp to a directory included 
  106. on the HELP environment variable (see CONFIG.SYS file). 
  107.  
  108. If you want to access this manual from every directory, you should add the 
  109. directory name where the file is placed to the environment variable BOOKSHELF 
  110. (see CONFIG.SYS file). 
  111.  
  112. After having followed these steps, you should have a ready-to-run PLOT copy on 
  113. your hard disk. If you have modified your CONFIG.SYS file, please reboot. 
  114.  
  115. You may also want to integrate PLOT into your desktop. For that purpose please 
  116. refer to the section Integration into the OS/2 desktop. 
  117.  
  118.  
  119. ΓòÉΓòÉΓòÉ 4. 4. File format ΓòÉΓòÉΓòÉ
  120.  
  121. Before trying to load a data file for creating a graphic, this data file must 
  122. be created. The data file must have a certain format, so that the application 
  123. is able to understand the data correctly. You can create and edit your data 
  124. file by using a text editor. If you have of a full OS/2 installation, two 
  125. editors should be on your hard disk: the OS/2 system editor (E.EXE) and the 
  126. enhanced editor (EPM.EXE). Both editors are well-suited for creating your data 
  127. files. When creating your own data files, you should choose the name extension 
  128. *.plt, because this is the extension used by PLOT by default. 
  129.  
  130. Data files should contain one data point per line. There are two possibilities 
  131. of describing your data points. 
  132.  
  133. If both x and y values are specified (parametric data), your data file should 
  134. contain two number columns. The first one is assumed to be the x value of each 
  135. pair (x,y) and the second one represents the y value. 
  136.  
  137. However, the x value of each pair (x,y) may be omitted. In this case the 
  138. omitted value is assigned the current coordinate number. These coordinate 
  139. numbers start at 0 and are incremented for each data point read. This is useful 
  140. if you want to represent sampled values. 
  141.  
  142. In both cases you can add comments in any line beginning with ;. These lines 
  143. will be ignored. 
  144.  
  145. You can select some parameters such as the graph color, line type and marker 
  146. type by adding some commands to your data file. All commands begin with the # 
  147. character. You can use a command more than once each file, but only the last 
  148. oen will be used. 
  149.  
  150. Currently the following 3 commands are supported: 
  151.  
  152. o #COLOR 
  153. o #LINE 
  154. o #MARKER 
  155.  
  156. These two examples show you how to create both parametric and non-parametric 
  157. data files. 
  158.  
  159. Parametric file 
  160.  
  161. Non-parametric file 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 4.1. 4.1 #COLOR command ΓòÉΓòÉΓòÉ
  165.  
  166. Use this command to select your graph's color. The following parameters are 
  167. available: 
  168.  
  169. WHITE
  170. BLACK
  171. BACKGROUND
  172. BLUE
  173. RED
  174. PINK
  175. GREEN
  176. CYAN
  177. YELLOW
  178. NEUTRAL
  179. DARK_GRAY
  180. DARK_BLUE
  181. DARK_RED
  182. DARK_PINK
  183. DARK_GREEN
  184. DARK_CYAN
  185. BROWN
  186. PALE_GRAY
  187.  
  188. Example: 
  189.  
  190. #COLOR BLUE
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 4.2. 4.2 #LINE command ΓòÉΓòÉΓòÉ
  194.  
  195. Use this command to select your graph's line type. The following parameters are 
  196. available: 
  197.  
  198. DOT
  199. SHORT_DASH
  200. DASH_DOT
  201. DOUBLE_DOT
  202. LONG_DASH
  203. DASH_DOUBLE_DOT
  204. SOLID
  205. INVISIBLE
  206. ALTERNATE
  207.  
  208. Example: 
  209.  
  210. #LINE LONG_DASH
  211.  
  212.  
  213. ΓòÉΓòÉΓòÉ 4.3. 4.3 #MARKER command ΓòÉΓòÉΓòÉ
  214.  
  215. Use this command to select your graph's marker types. The following parameters 
  216. are available: 
  217.  
  218. NONE
  219. CROSS
  220. PLUS
  221. DIAMOND
  222. SQUARE
  223. 6-POINT-STAR
  224. 8-POINT-STAR
  225. SOLID_DIAMOND
  226. SOLID_SQUARE
  227. DOT
  228. CIRCLE
  229.  
  230. Example: 
  231.  
  232. #MARKER SOLID_SQUARE
  233.  
  234.  
  235. ΓòÉΓòÉΓòÉ 4.4. 4.4 Parametric file ΓòÉΓòÉΓòÉ
  236.  
  237. #COLOR  RED
  238. #LINE   ALTERNATE
  239. #MARKER SOLID_SQUARE
  240. ; both x and y values
  241.  0     0
  242.  0.5   0.25
  243.  1     1
  244.  1.5   2.25
  245.  2     4
  246.  2.5   6.25
  247.  3     9
  248.  3.5   12.25
  249.  4    16
  250.  
  251.  
  252. ΓòÉΓòÉΓòÉ 4.5. 4.5 Non-parametric file ΓòÉΓòÉΓòÉ
  253.  
  254. #COLOR  BLUE
  255. ; only y values
  256.  0
  257.  1
  258.  4
  259.  9
  260. 16
  261. 25
  262.  
  263.  
  264. ΓòÉΓòÉΓòÉ 5. 5. Starting PLOT ΓòÉΓòÉΓòÉ
  265.  
  266. To run PLOT, enter the following from a OS/2 prompt: 
  267.  
  268. plot test.plt
  269.  
  270. where test.plt is the filename of a data file. This parameter is optional. 
  271.  
  272. There are other ways to run this progam; they are described in the section 
  273. Integration into the OS/2 desktop. 
  274.  
  275.  
  276. ΓòÉΓòÉΓòÉ 6. 6. Using PLOT ΓòÉΓòÉΓòÉ
  277.  
  278. In this section the PLOT menus are described briefly. Please refer to the 
  279. online help to get more information about the commands described here. 
  280.  
  281. File menu 
  282.  
  283. Options menu 
  284.  
  285. Help menu 
  286.  
  287.  
  288. ΓòÉΓòÉΓòÉ 6.1. 6.1 File menu ΓòÉΓòÉΓòÉ
  289.  
  290. The File menu contains commands that you use to open data files, print and 
  291. export graphics. In addition, it also contains the command that you use to exit 
  292. the application. 
  293.  
  294. The following commands appear in the File menu: 
  295.  
  296. New...              Opens an existing data file for creating a new graphic. 
  297.  
  298. Open...             Opens an existing data file for embedding in the current 
  299.                     graphic. 
  300.  
  301. Export...           Saves the current graphic to a Windows 3.x bitmap file. 
  302.  
  303. Print...            Prints the current graphic on the default printer. 
  304.  
  305. Exit                Quits this application. 
  306.  
  307.  
  308. ΓòÉΓòÉΓòÉ 6.2. 6.2 Options menu ΓòÉΓòÉΓòÉ
  309.  
  310. The Options menu contains commands that you use to modify your graphic, load a 
  311. text editor or save the current settings. 
  312.  
  313. The following commands appear in the Options menu: 
  314.  
  315. Graphic...          Allows you to set new axis limits, to document the axis and 
  316.                     to select and unselect other drawing options. 
  317.  
  318. Set Font...         Allows you to select the desired font type and size. 
  319.  
  320. Graph...            Allows you to modify the line type when interpolating 
  321.                     between points, to put markers at each point and to change 
  322.                     the color of a graph. 
  323.  
  324. Edit Data File      Starts a text editor that allows you to create or modify a 
  325.                     data file. 
  326.  
  327. Save options        Use this command to save the current settings. 
  328.  
  329.  
  330. ΓòÉΓòÉΓòÉ 6.3. 6.3 Help menu ΓòÉΓòÉΓòÉ
  331.  
  332. Refer to this menu to access the online help and to obtain information about 
  333. this product. 
  334.  
  335. The following commands appear in the Help menu: 
  336.  
  337. Help index                      Use this command to access the help index. 
  338.  
  339. General help                    Use this command to get a brief description of 
  340.                                 PLOT. 
  341.  
  342. Using help                      Here you can learn how to use the online help. 
  343.  
  344. Registration information        Displays registration data (only if you 
  345.                                 registered the product). 
  346.  
  347. Product information             Displays program version and copyright. 
  348.  
  349.  
  350. ΓòÉΓòÉΓòÉ 7. 7. Integration into the OS/2 desktop ΓòÉΓòÉΓòÉ
  351.  
  352. After having installed PLOT, you can create a program object to start PLOT 
  353. directly from the desktop. Follow these steps to create a program object: 
  354.  
  355.  1. Open the Templates folder. 
  356.  2. Drag a copy of the Program template to the desktop or to a folder. A window 
  357.     will appear prompting you for the settings of the object to create. 
  358.  3. Enter the path and the file name (PLOT.EXE). If you want, you can also 
  359.     enter the name of your desired working directory. 
  360.  4. Rename your program object. 
  361.  
  362. In your Templates folder should appear a template named Plot-Data-File.PLT. You 
  363. can use this template to create plot data objects. These objects will be 
  364. automatically associated to PLOT. Follow these steps to create a plot data 
  365. object: 
  366.  
  367.  1. Open the Templates folder. 
  368.  2. Drag a copy of the Plot-Data-File.PLT template to the desktop or to a 
  369.     folder. 
  370.  3. Rename your object. Be sure not to change the default extension. You may 
  371.     have problems when opening your data file if the object file name contains 
  372.     blanks. 
  373.  4. Open the plot data file object to begin editing the file. PLOT will 
  374.     recognize that the plot data hasn't been yet entered and will start a text 
  375.     editor. Enter the plot data for creating a graphic. 
  376.  5. Save the file and quit the editor. 
  377.  
  378. After quitting the editor, PLOT will automatically create a graphic using the 
  379. data you entered. 
  380.  
  381. If you want to load an existing data object and create a new graphic, you can 
  382. follow different ways: 
  383.  
  384. o Open your data object by double-clicking. PLOT will be started and a graphic 
  385.   will be created from the data contained in your object. 
  386.  
  387. o Drag your data object and drop it over the PLOT program object. You will 
  388.   experience similar results as when opening the object directly. 
  389.  
  390. o Open the PLOT program object. Select the File menu and choose the Open 
  391.   command for loading a data file. Select the folder where you placed your data 
  392.   object, select the desired object and open it. A graphic will be created. 
  393.  
  394.  
  395. ΓòÉΓòÉΓòÉ 8. 8. Offline help ΓòÉΓòÉΓòÉ
  396.  
  397. In this section you will be teached what to do, if you have any problems when 
  398. working with PLOT, or you notice bugs or incompatibilities. 
  399.  
  400.  
  401. ΓòÉΓòÉΓòÉ 8.1. 8.1 Hotline ΓòÉΓòÉΓòÉ
  402.  
  403. There is a hotline to offer more help to every user of any registered version. 
  404. Please write us a letter or a fax if you have questions about PLOT, how to use 
  405. it, the latest version available etc. Or if you just want to tell us what you 
  406. think about PLOT, or how you would like it to be. 
  407.  
  408.  
  409. ΓòÉΓòÉΓòÉ 8.2. 8.2 Bugs and incompatibilities ΓòÉΓòÉΓòÉ
  410.  
  411. We have tested this PLOT version intensively before distributing this shareware 
  412. version. However, if you notice any bugs or incompatibilities by using PLOT, 
  413. please tell us about them as soon as posible. Send us a letter or a fax to the 
  414. address or fax number included on this document. 
  415.  
  416.  
  417. ΓòÉΓòÉΓòÉ 9. 9. Registration ΓòÉΓòÉΓòÉ
  418.  
  419. If you are working with an unregistered PLOT version, you may use it for a two 
  420. weeks trial period. After this time you must register or stop using it. You can 
  421. obtain a registered PLOT version by ordering it at the following address or fax 
  422. number: 
  423.  
  424. StegSoft
  425. Haid-und-Neu-Str. 16/90
  426. 76131 Karlsruhe
  427. West Germany
  428.  
  429. Fax: +49 721 693242
  430.  
  431. As soon as you order PLOT, you will receive the latest version for US $20 
  432. (Germany DM 30). Please add US $5 (Germany DM 5) for shipping and handling if 
  433. you live in Europe, US $8 if you don't live in Europe. 
  434.  
  435. Obtaining a registered version has the following advantages: 
  436.  
  437. o PLOT registered versions do not tell you to obtain a registered version each 
  438.   time you print. This shareware version does, because it should only be used 
  439.   for evaluation purposes. 
  440.  
  441. o There are registered PLOT version available in three languages: English, 
  442.   Spanish and German. You can choose which language you prefer. The shareware 
  443.   version is only available in English. 
  444.  
  445. Please use the order form included on this manual. To print an order form, do 
  446. the following: 
  447.  
  448.  1. Select the following item and double-click: PLOT Order form. 
  449.  2. Select Print. 
  450.  3. Make sure that This section is selected. 
  451.  4. Select Print. 
  452.  
  453. The order form will be printed on your printer. Please send your order to the 
  454. address or fax number above. 
  455.  
  456.  
  457. ΓòÉΓòÉΓòÉ 9.1. 9.1 StegSoft PLOT - Price list ΓòÉΓòÉΓòÉ
  458.  
  459. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  460. ΓöéProduct            ΓöéU.S. Dollar ΓöéGerman Marks Γöé
  461. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  462. ΓöéPLOT 1.6 for OS/2  Γöé20          Γöé30           Γöé
  463. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  464. ΓöéPLOT Update (from  Γöé5           Γöé8            Γöé
  465. Γöéany registered     Γöé            Γöé             Γöé
  466. Γöéversion)           Γöé            Γöé             Γöé
  467. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  468.  
  469.  
  470. ΓòÉΓòÉΓòÉ 9.2. 9.2 StegSoft PLOT - Order form ΓòÉΓòÉΓòÉ
  471.  
  472. Name    ___________________________________________________________
  473.  
  474. Address ___________________________________________________________
  475.  
  476. City    __________________________ State _________ ZIP ____________
  477.  
  478. Country ___________________________________________________________
  479.  
  480. Phone Number (optional) __________________  Circle:  home  or  work
  481.  
  482. Shipping (check one):
  483.  __  By mail, payment enclosed (add $8 U.S. if you don't live in
  484.      Europe, $5 U.S. if you live in Europe)
  485.  __  By mail, cash on delivery (charge for shipping and handling)
  486.  
  487. Choose Disk Size (check one):
  488.  __  5 1/4" disk size
  489.  __  3 1/2" disk size
  490.  
  491. Payment mode (check one):
  492.  __  Cheque drawn in U.S. dollars or german marks enclosed
  493.  __  Cash enclosed (only U.S. dollars or german marks accepted)
  494.  __  Cash on delivery
  495.  
  496. PLOT for OS/2 2.x Registration Fee ($20.00 US)              ______
  497. PLOT Update Fee from any registered version ($5.00 U.S.)    ______
  498. Shipping and Handling                                       ______
  499.  
  500. Total Enclosed                                              ______
  501.  
  502. Mail or fax to:  StegSoft
  503.                  Haid-und-Neu-Str. 16/90
  504.                  76131 Karlsruhe
  505.                  West Germany
  506.  
  507.                  Fax: +49 721 693242
  508.  
  509.                  *** Thank you for your order! ***
  510.