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