home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / irun11.zip / IMAGERUN.TXT < prev    next >
Text File  |  1994-12-05  |  20KB  |  538 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                              Image::Runner(tm)
  9.                             -------------------
  10.  
  11.            developers' pcx display utility for DOS applications
  12.  
  13.  
  14.  
  15.  
  16.                         a product of RCCO Research
  17.  
  18.  
  19.  
  20. Capabilities
  21. -------------
  22. Image::Runner(tm) is basically a simple utility that allows DOS executable
  23. applications to display a developer- or enduser-designed VGA .pcx file from
  24. anywhere within the application.  It is provided in form of a small,
  25. efficient, fast .exe meant to be called with the system command processor in
  26. the host application.  Image::Runner will display 640x480x16 VGA pcx images
  27. that may contain static graphs, artwork, or other graphic objects needed in
  28. an application.
  29.  
  30. While it has always been possible to execute other programs from within an
  31. application that will display such images, Image::Runner provides advantages
  32. for the commercial developer in that, upon payment of a very nominal regis-
  33. tration fee ($24.95), it may included and distributed with multiple applica-
  34. tions legally and without further license, restriction, or payment of runtime
  35. royalties.
  36.  
  37. Image::Runner may be called multiple times from within an application and
  38. adds little overhead to the executable sequence.  The called pcx image
  39. displays until the end-user presses a key, then returns quickly and
  40. efficiently to the calling program.
  41.  
  42. Image::Runner may be used with most traditional MS-DOS language executables,
  43. including those created with CA-Clipper, Borland Turbo Pascal, QuickBASIC,
  44. PowerBasic, Visual Basic(tm) for DOS, dBase, Clarion, C, etc.   It is very
  45. small, very efficient, and executes cleanly and quickly from within any DOS
  46. program; its small file size (about 30k, not compressed) provides for
  47. minimal space usage on distribution disks and is non-obtrusive and very
  48. discrete to the end-user as to its purpose.  (An attempt by an end-user to
  49. execute '_i_.exe' without knowledge of the proper command line parameter will
  50. yield nothing other than an exit back to the DOS prompt.)
  51.  
  52. Image::Runner image displays will run under both DOS and Windows.  The
  53. chief advantages, aside from the displays themselves, are both low cost and
  54. method of acquiring.  The copy included herewith is a fully-functional
  55. evaluation copy available easily and universally through the user-supported
  56. software marketplace.
  57.  
  58.  
  59.  
  60.  
  61. IRDemo.exe and the sample files
  62. --------------------------------
  63. To run the demonstration files included in this package (IRDEMO.EXE and 2
  64. sample pcx files), copy all pertinent files (including _I_.EXE) to a direc-
  65. tory on the hard disk (or a ram drive), and simply execute
  66.  
  67.                            IRDEMO <enter>
  68.  
  69. from the DOS prompt.  IRDEMO is a C language program that will call the
  70. Image::Runner utility (ie, _i_.exe) twice using the system() function;
  71. other languages will call a similar instruction (see below).
  72.  
  73. For tolerable viewing results, do not run the demo from a floppy drive.
  74.  
  75.  
  76.  
  77.  
  78. Preparation of images
  79. ----------------------
  80. Image::Runner is particularly effective for software developers preparing
  81. static graphs, artwork, or other images for their applications, in that they
  82. can easily capture usable materials with programs like Hijaak(tm) for Windows
  83. and modify or create them in editing programs such as Windows(tm) Paintbrush.
  84. Image names may also be selected by the end-user via a menu selection and
  85. passed to to the calling sequence with the appropriate string.
  86.  
  87. The only requirement is that images must be finally saved in 640x480 16-
  88. color VGA .pcx file format.  If you are doing image preparation in Windows,
  89. you will have to load a 16-color video driver for 640x480 VGA in order to
  90. prepare proper images.  This format is used since it is the most universal
  91. that will allow presentations to be viewed on as many DOS and/or Windows
  92. VGA systems as possible.  Do not build your images with 256 or more colors
  93. as they will not display with Image::Runner.  The end-user should then
  94. be able to properly display using any VGA card and driver with 16 or more
  95. colors; it is only during the preparation and saving of .pcx images that you
  96. must use a 640x480x16 driver.
  97.  
  98. We have observed excellent, consistent results with using a program such as
  99. Hijaak(tm) for Windows to capture entire DOS or Windows screens, or selected
  100. areas of screens, or a particular window on a full Windows screen.  The pre-
  101. parer then does final editing, adding text, drawing lines or other objects,
  102. in a drawing program.  For example, the two sample pcx images provided with
  103. this package were done entirely in the program that comes free with Win-
  104. dows(tm) 3.1:  Paintbrush.  The inset picture in _ADMIN1.PCX was captured
  105. from a black and white line drawing with a hand scanner and edited in Paint-
  106. brush.
  107.  
  108. Other graphics programs are likely to provide compatible material, but they
  109. must be tried on a test basis with Image::Runner.  The two programs mentioned
  110. above work well for most users, are widely available, and do not require
  111. great technical or artistic ability.  Scanned images will be effective in
  112. Image::Runner if they are saved in the proper format.  If one format you are
  113. using seems not workable, try saving that image in another program, such as
  114. Windows Paintbrush; we have often found that certain images work better when
  115. converted or simply saved in another program's format even though they may
  116. use the same .pcx extension.
  117.  
  118. When attempting to use monochrome pcx files, resave them as 16-color
  119. 640x480 VGA pcx files.  Even though the appearance may remain the same,
  120. they will be saved in a format usable by Image::Runner.
  121.  
  122. Once you find the right combination of steps to produce pcx file formats
  123. consistently usable by Image::Runner, you will save a great deal of time
  124. and effort by always using that combination in future applications.
  125.  
  126.  
  127.  
  128.  
  129. Running Image::Runner from with your application
  130. -------------------------------------------------
  131. The basic requirement is that the image files and the related executables be
  132. placed in the same directory on a hard drive.  You should advise end-users
  133. against running your application from a floppy diskette, due to the slowness
  134. of building the on-screen image when reading from a diskette.
  135.  
  136. Your end-users will certainly need VGA graphics capabilities to view your
  137. images.  If a user attempts execution on a non-VGA-capable system, a simple
  138. screen will display the message
  139.  
  140.  
  141.  
  142.  
  143.                    ╔════════════════════════════════════════╗
  144.                    ║                                        ║
  145.                    ║  Image display requires VGA graphics.  ║
  146.                    ║              (640x480x16)              ║
  147.                    ║                                        ║
  148.                    ╚════════════════════════════════════════╝
  149.  
  150.  
  151.  
  152.  
  153.  
  154. and return to the calling program after a 2-second delay.
  155.  
  156.  
  157. The calling sequence for all languages will consist of the traditional
  158. instruction for utilizing the command processor from within the program
  159. plus an indication of the command line parameters:
  160.  
  161.                            _i_ x.pcx
  162.  
  163. where '_i_' indicates the _I_.EXE Image::Runner utility, and 'x.pcx'
  164. is the full filename (including extension) of the 640x480x16 pcx image
  165. you wish to display.  The image will not display without specifying the
  166. .pcx extension.
  167.  
  168. You need not specify a clearscreen before or after the image display; a
  169. clearscreen is automatic with an Image::Runner call.  Therefore, it may be
  170. desirable to save and restore (or recreate) the screen existing at the time
  171. of the call.  Also, if the non-VGA text screen is displayed (see above),
  172. please note that the text cursor is momentarily turned off and then turned
  173. on again as the screen exits; if, by chance, your program was originally
  174. executing with the text cursor turned off, you may need to turn it off
  175. again upon reentry.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182. Specific languages example calls
  183. ---------------------------------
  184. The following examples provide typical calls to display a 640x480x16 pcx
  185. image from within a program.
  186.  
  187.  
  188. QuickBASIC, PowerBasic, Visual Basic for DOS
  189. ---------------------------------------------
  190.  
  191.    RUN "_I_ X.PCX"
  192.  
  193.  
  194.  
  195.  
  196. dBase and Clipper S '87
  197. ------------------------
  198.  
  199.    RUN _I_ X.PCX
  200.  
  201.  
  202.  
  203.  
  204.  
  205. CA-Clipper
  206. -----------
  207.  
  208.    run _i_ x.pcx
  209.  
  210.    // may also be overlayed with Blinker's
  211.  
  212.    //       SwpRunCmd("_i_ x.pcx")
  213.  
  214.    // although this may be overkill for a simple
  215.    // utility such as Image::Runner.
  216.  
  217.  
  218.  
  219.  
  220.  
  221. Clarion
  222. --------
  223.  
  224.    OPEN(SCREEN)
  225.    RUN('_I_ X.PCX')
  226.    CLOSE(SCREEN)
  227.    RETURN
  228.  
  229.  
  230.  
  231.  
  232. Turbo Pascal
  233. -------------
  234. This is one suggestion for Turbo Pascal use; most Pascal developers will
  235. have their own preferred method of executing a DOS program from within an
  236. application.
  237.  
  238.  
  239. {$M $8192,0,0 }  { stacks spec, used by drun procedure }
  240. uses crt, dos;
  241.  
  242. procedure drun(what : string);
  243.    begin
  244.       swapvectors;
  245.       exec(getenv('COMSPEC'), '/C ' + what);
  246.       swapvectors;
  247.       if DosError <> 0 then
  248.          WriteLn('Could not execute COMMAND.COM');
  249.       WriteLn;
  250.    end;
  251.  
  252.  
  253. { call the image display within the program: }
  254.  
  255.    drun('_I_ X.PCX');
  256.  
  257.  
  258.  
  259.  
  260. C programs
  261. -----------
  262. Although there are several excellent ways to call DOS processes,
  263. including the many variants of SPAWN and EXEC, we provide herewith
  264. the simple and direct use of the system() function.
  265.  
  266.  
  267.    #include <process.h>   /*  or stdlib.h  */
  268.  
  269.    ...
  270.  
  271.    system("_I_ X.PCX");
  272.  
  273.  
  274. (The sample demo program included in this package uses the system()
  275. function.)
  276.  
  277.  
  278.  
  279. Other development environments will have equivalent methods for executing
  280. a DOS executable program via the command processor; consult the appropriate
  281. reference manual for specific procedures.
  282.  
  283.  
  284.  
  285. Batch files
  286. ------------
  287.  
  288.    @echo off
  289.    _i_ x.pcx
  290.  
  291.  
  292.  
  293.  
  294. From the DOS system prompt
  295. ---------------------------
  296.  
  297.    C:\DIR\_i_ x.pcx <enter>
  298.  
  299.  
  300.  
  301.  
  302.  
  303. In all instances, the calling of '_i_.exe' and the resulting image display
  304. do not require a great deal of memory and therefore generally may be used
  305. in a typical 640k DOS memory environment.
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312. Troubleshooting
  313. ----------------
  314. The only caveat we might offer with this program is that if you find that
  315. your images do not display, or do not display properly, it is probably
  316. because they have been created or saved in a format that may only be
  317. slightly incompatible with that which Image::Runner requires.  Before
  318. you decide that the Image::Runner program is not usable in such instances,
  319. try the suggestion given before for re-saving your .pcx files in another
  320. graphics program.  Most image-editing programs will read files in several
  321. formats, and often allow conversions, or perhaps will save them in a later
  322. .pcx format that will work with applications such as Image::Runner.
  323.  
  324. Also, make certain that images are saved in 640x480 by 16-color format by
  325. using the proper software and/or video drivers to handle the format.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332. Program Requirements
  333. ---------------------
  334. The requirements for running Image::Runner include a DOS-compatible PC
  335. with 512k memory, VGA graphics capability, and a hard drive.  DOS 3.1 (or
  336. later) or Windows 3.x (or later) should be utilized.
  337.  
  338.  
  339.  
  340.  
  341. The Unregistered Evaluation Copy
  342. ---------------------------------
  343. The unregistered version of this program is intended for use in evaluation
  344. situations.  It may be used for ninety (90) days within your own organ-
  345. ization by persons that have knowledge and understanding of the fact that
  346. this is an unregistered evaluation copy.
  347.  
  348. The payment of the $24.95 purchase price for a registered copy of this
  349. program will allow license for a single user to make use of the program for
  350. purposes that are traditionally accepted for software utilities of this
  351. type.  Additional site license fees of $10.00 per user may be paid at the
  352. time of registration, or any time in the future after initial registration
  353. at the then current license fee in effect.  There are no runtime royalties
  354. involved in the distribution of your materials utilizing a duly registered
  355. copy of Image::Runner.
  356.  
  357. The license and authorized registration shall not be construed as being
  358. in effect until direct payment has been received by RCCO Research and an
  359. authorized, registered copy has been sent in the registered user's/users'
  360. name(s).
  361.  
  362.  
  363.  
  364.  
  365. The Registered Version of Image::Runner
  366. --------------------------------------------
  367. The registered copy performs the same execution as the evaluation copy, only
  368. without the unregistered copy delay at the close of the VGA display.
  369.  
  370. Documentation for the registered version is an on-disk text file, similar to
  371. the present format.
  372.  
  373.  
  374.  
  375.  
  376.  
  377. Licensing Information
  378. ----------------------
  379. This program is licensed and supplied as is, without any warranty.  To the 
  380. extent permitted under applicable law, RCCO Research Associates disclaims 
  381. all warranties, either expressed or implied, with respect to this software 
  382. program, its quality, performance, merchantability, or fitness for any 
  383. particular purpose.
  384.  
  385. In particular, this software program is not guaranteed to prevent or detect
  386. damage to your data or programs.  In no event shall RCCO Research Associates
  387. be liable for any claims for lost profits or any damage, including, but not
  388. limited to, special, incidental, consequential or other damage (including, 
  389. without limitation, damages for loss of business profits, business interrup-
  390. tion, loss of business information, or other pecuniary loss) arising out of
  391. the use of or inability to use this RCCO Research Associates product, even
  392. if RCCO Research Associates has been advised of the possibility of such
  393. damages.  Some states do not allow the exclusion or limitation of incidental
  394. or consequential damages, so the above limitation or exclusion may not apply
  395. to you.  In no case shall RCCO Research Associates's liability exceed the
  396. license fees paid for the right to use the licensed version of the software. 
  397.  
  398. The license agreement and warranty shall be construed, interpreted and
  399. governed by the laws of the state of Tennessee.
  400.  
  401. This software program is protected under the Copyright Laws of the United 
  402. States of America and all applicable International Copyright Conventions.  
  403. Makers and/or users of illegal or unauthorized copies of the registered 
  404. version are subject to prosecution under these laws.
  405.  
  406. The name  Image::Runner(tm)  is a trademark of RCCO Research Associates.
  407. Windows(tm) is a trademark of Microsoft Corporation.
  408.  
  409.  
  410.  
  411.  
  412.  
  413. Registration Notes
  414. -------------------
  415. Registration will obtain a copy of the most recent authorized version and
  416. provide legal authorization for continued use of the program after the
  417. ninety-day (90-day) evaluation period.
  418.  
  419. To obtain a registered copy, you must mail an advance-payment registration
  420. fee of U.S. $24.95 + $2.55 shipping/handling ($7.05 non-U.S. shipping/
  421. handling, $4.05 for Canada) directly to RCCO Research.  Payment is to be
  422. made by check or money order only, please.  We require payment with order so
  423. that prices and fees may be kept as reasonable as possible; this policy has
  424. worked well for us in recent years, as we observe increased registration on
  425. products that are reasonably priced.  For telephone and credit card orders,
  426. see Additional Ordering Options note below.
  427.  
  428. An invoice will be included with your order, showing the registered serial
  429. number(s) applicable to the purchase.  We can provide a pro forma invoice
  430. to those corporations or institutions that require same before payment can
  431. be issued; shipment will be made promptly upon receipt of payment.  Prices
  432. and/or registration and/or license fees are subject to change.
  433.  
  434. Tennessee clients please include the required 8.5% sales tax on both the
  435. product amount and shipping/handling as mandated by the state.
  436.  
  437. International clients must pay by check or money order in U.S. dollars, drawn
  438. on a U.S. bank or the U.S. branch of an international bank.  Please realize
  439. that international postal money orders are considerably delayed through the
  440. postal systems and may not be the most expedient way of relaying payment.  An
  441. often-used form of payment consists of obtaining a dollar-denominated money
  442. order from the local American Express office which you may then airmail to
  443. us along with your order.
  444.  
  445.  
  446. Please indicate program name and current version number on your order; you
  447. may use the Order.frm file provided on the disk (or the program directory)
  448. or simply send a note or letter with your name, organization name, address,
  449. program name & version, number of users being licensed, and remittance.
  450. Your comments on our programs are welcomed.
  451.  
  452.  
  453.  
  454.  
  455.      Additional Ordering Options:
  456.      ----------------------------------------------------------------------
  457.      CREDIT CARD ORDERS ONLY -
  458.      You may order a registered copy of this RCCO Research program
  459.      with MC, Visa, Amex, or Discover from PsL, Public (software)
  460.      Library of Houston, Texas by calling 800-242-4775 or 713-524-6394,
  461.      or by FAX to 713-524-6398, or by CompuServe E-mail to 71355,470.
  462.      You may also mail credit card orders to PsL at P.O. Box 35705,
  463.      Houston, TX 77235-5705.  PsL's item/product number for Image::Runner
  464.      is #11623.
  465.  
  466.      THE ABOVE NUMBERS ARE FOR ORDERS ONLY.
  467.      Any questions about the status of the shipment of the order,
  468.      registration options, product details, technical support, volume
  469.      discounts, dealer pricing, site licenses, etc. must be directed in
  470.      writing to RCCO Research, P.O. Box 196, Gatlinburg, TN 37738.  To
  471.      ensure that you get the fastest possible delivery of your registered
  472.      copy, PsL will notify us the day of your order and we will ship the
  473.      materials directly to you.  There are no additional fees for ordering
  474.      by credit card.
  475.  
  476.      Your credit card number is *not* transmitted to RCCO Research, but
  477.      rather is processed by PsL as part of their software registration
  478.      ordering service.
  479.  
  480.      The above service is made available as a convenience to client
  481.      individuals who feel comfortable with ordering by telephone and
  482.      with a credit card.  Established concerns may prefer to order
  483.      directly from RCCO Research with the company's own business check.
  484.  
  485.      Please realize that we pay PsL for the service, and that you should
  486.      not make non-order calls to them about RCCO Research products, as
  487.      indicated above.  PsL cannot answer non-order inquiries.
  488.      ----------------------------------------------------------------------
  489.  
  490.  
  491.  
  492.  
  493.  
  494. Additional Information
  495. -----------------------
  496. If you have any comments regarding this program after (or with) registra-
  497. tion, please send them in writing to:
  498.  
  499.                               RCCO Research Associates
  500.                               P. O. Box 196
  501.                               Gatlinburg, TN 37738  (U.S.A.)
  502.  
  503. Please include your phone (day & evening) and fax (if any) numbers as well
  504. as your mailing address and CompuServe number / Internet address (if any) on
  505. ALL written communications.  Please indicate the serial number from your copy
  506. of the program as well as your CustID number.
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513. Image::Runner(tm)
  514. ------------------
  515. developers' pcx display utility for DOS applications
  516.  
  517.  
  518.  
  519. (C) Copyright 1994 RCCO Research Associates
  520. All Rights Reserved under International Conventions
  521. Product of U.S.A.
  522.  
  523.  
  524.  
  525. RCCO Research Associates
  526. Post Office Box 196
  527. Gatlinburg, Tennessee 37738
  528.  
  529.  
  530.  
  531.  
  532.                      ┌─────────────────────────────────┐
  533.                      │     RCCO Research Associates    │
  534.                      │ Technical Publishers, Est. 1965 │
  535.                      └─────────────────────────────────┘
  536.  
  537.  
  538.