home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FOXPCX.ZIP / FOXPCX.DOC < prev    next >
Encoding:
Text File  |  1994-10-29  |  17.3 KB  |  449 lines
  1.                      . . . . . . . . . . . . . . . . .                          
  2.                               F  O  X  P  C  X  
  3.     .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . 
  4.                            Version 3.0 Oct 28, 1994
  5.      .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   .
  6.        .    .    .    .    .    .    .    .    .    .    .    .    .
  7.        .     .     .     .     .     .     .     .     .     .     .
  8.          .      .      .      .      .      .      .      .      .
  9.      .       .       .       .       .       .       .       .       .
  10.           .        .        .        .        .        .        .
  11.        .         .         .         .         .         .         .
  12.     .          .          .          .          .          .          .
  13.  
  14.  
  15.  
  16.              FOXPCX (c) 1991-1994 Master Creative Software, Inc.
  17.                              All Rights Reserved
  18.  
  19.  
  20.                                Documentation 
  21.                            (revised Oct 28, 1994)
  22.  
  23.              Support: BBS (201) 585-7002, COMPUSERVE: 70713,2002
  24.                                      
  25.  
  26.  
  27.  
  28.  
  29. What's New !
  30. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  31.     24 Bit (16 million color ) PCX file now supported
  32.     automaticly detects image size and colors
  33.     added full page pan left and right as well as up and down
  34.     
  35.  
  36. A BBS system has been set up for additional support. The phone number is 
  37. 201-585-7002. Baud rates of 300-14400 supported, 8 data bits ,no parity
  38. and one stop bit should get you in. XMODEM, YMODEM , KERMIT, ASCII and ZMODEM
  39. protocols are supported for downloading files. 
  40. The latest demos, patches etc will be on the BBS first. Support will
  41. continue on Compuserve as before. BBS software updated Sept 10, 1994
  42.  
  43.  
  44. Introduction
  45. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  46. FOXPCX is a small loadable PLB file that will allow the display of 
  47. ANYSIZE B&W or color PCX (up to 16 MILLION colors ! ) file from within
  48. FOXPRO without using the RUN command ! FOXPCX becomes part of FOXPRO when 
  49. loaded. FOXPCX utilizes XMS memory or it's own Virtual Memory System
  50. to manage large images and to speed viewing. PCX files can be viewed
  51. from a regular dos file or directly from a FOXPRO memo field. FOXPCX
  52. supports all standard VGA and many SUPER VGA hardware configurations
  53. by way of loadable screen drivers. The screen drivers are loaded from
  54. a disk file or optionally a Foxpro memo field. A typical call to 
  55. FOXPCX would look like : =VIEWPCX("FROGG.PCX","VGA.DRV"). 
  56.  
  57.  
  58.  
  59. Evaluation Copy Limitations
  60. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  61. If you have the evaluation version only 3 of 36 screen drivers 
  62. are supplied. In addition MEMO fields are not supported for 
  63. IMAGES, they are for drivers. This version will not work in a
  64. shared network environment. An annoying evaluation copy 
  65. message pops up on each invocation of the VIEWPCX Function.
  66. To remove all of these restrictions PLEASE Register !
  67.  
  68.  
  69.  
  70. FOXPCX.PRG DEMO Application
  71. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  72. Included with this package is a demo program called FOXPCX.PRG
  73. This is a small demonstration program that will ask the user to
  74. select a PCX image to view. It asks the user for the screen driver
  75. ,memory type to use and page buffer size. FOXPCX.PRG will look for
  76. the DRIVERS database which is included.
  77.  
  78. Feel free to use any part of the demo code in your application. 
  79. When using FOXPRO(X) you must select Virtual Memory System option,
  80. or set MEMLIMT to leave at least 512-1MB of free XMS memory for FOXPCX.
  81. I also reccomend using a 8K page buffer when using VMS. Select a screen 
  82. driver that matches the hardware you are running on. The Standard VGA drivers
  83. should work on any VGA card. If you have a SVGA card that has VESA
  84. suport (most do) the VESA driver should be used for maximum compatibilty
  85. and resolutions.
  86.  
  87.  
  88. PLB Parameters and ussage:
  89. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  90. Set Libray to FOXPCX  
  91. =ViewPCx(<paramr 1>,<param 2>,<param 3>,<param 4>) 
  92.  
  93. Parameter 1 is a string containing the PCX file name or a FOXPRO memo field
  94. reference. The image file must be a valid 2 color B&W or 16-16M color PCX
  95. file. The image may as large as your XMS memory limit or diskSpace. A memo
  96. feild reference must be precceded by a @ ie) @IMAGEDBF->IMAGE, Alias must
  97. be used if not currently selected database which, might be the case if you
  98. are loading screen drivers from memo fields.
  99.  
  100.  
  101.  
  102. Parameter 2 is a string containing the screen driver file name or a FOXPRO 
  103. memo field reference of which contains the screen driver .
  104. A Screen driver is a binary file that that is loaded into memory
  105. and executed. Several drivers are provided for Standard VGA and many popular
  106. SVGA cards. See DRIVERS.DBF for a list. DRIVERS.DBF contains all of the supported 
  107. drivers in a memo field called DRIVER. You can load the screen driver
  108. directly from this file or copy the memo feild to a dos file .
  109. ie) Copy memo DRIVER to TRIDENT.DRV . A memo feild reference must be precceded
  110. by a @ ie) @DRIVERS->Driver, Alias must be used if Not currently selected
  111. database which ,might be the case if you are loading screen drivers from 
  112. memo fields.
  113.  
  114.  
  115. Parameter 3 is of numeric type , it can be either a 0 or a 1. This parameter
  116. instructs FOXPCX which expanded memory scheme to use. 0 for XMS or 
  117. 1 For Virtual. FOXPRO(X) users need to use the virtual option.  
  118. When using XMS memory you need to make sure that at least 512K of XMS memory
  119. is free. This should allow the viewing of 800X600X256 Image Larger Images
  120. Should leave more free. IF you are using a memory manager like qemm386
  121. that can make available EMS and XMS from the same memory pool you can set EMS 
  122. setting in config.fp to some amount that will be 512K less then the total
  123. EMS in the system or What FOXPRO will use. ie; If you have 2048K or 2MB of
  124. Free EMS then set EMS=1536 in your config.fp file.  The Virtual Memory Option
  125. will Create a (Unique File for LAN) SWAP file and will delete it when completed.
  126. XMS and OR Virtual memory are needed to view Large Images. A 800X600x256 
  127. Image requires 480,000 Bytes of memory !  The Swap File 
  128.  
  129.  
  130. Parameter 4 is of numeric type , it can be either a 0 or a 1. This parameter
  131. instructs FOXPCX which size page buffer to use. The page buffer is used to transfer
  132. a page of Expanded memory from and to either XMS or Virtual memory Use
  133. 0 for a Small 4k buffer and use 1 for Large 8k buffer.
  134. The 8K buffer will speed things up when using Virtual memory option other-
  135. wise use small page buffer. This Memory is allocated from FOXPRO.
  136.  
  137.  
  138. Parameter 5 is of numeric type , it is used to set the amount of time 
  139. that a image will appear on the Screen. The number represents MS DOS timer ticks
  140. (18/Second) to wait. One this time is expired The Image is left on the screen
  141. and it is upto you to call TextMode() to put the screen back into the proper
  142. mode. This allows you to display a Image for a certain amount of time while giving
  143. the option of doing something else in the background while the image is 
  144. displayed. Like Playing a Voice or Music File. If 0 is use as the Timeout
  145. The User Must hit Escape to Exit the Image and Cursor Keys (panning) is in
  146. affect for Images larger than the Screen TextMode is automaticly called 
  147. in this case. TextMode is called automaticaly on Unloading of PLB.
  148. You can pass a timeout of -1 for FOXPCX to return to your application
  149. as soon as it paints the image on the screen , no delay.
  150.  
  151.  
  152. Programming Examples
  153. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  154. Set Libr to FOXPCX   && Make FOXPCX a part of FOXPRO
  155. =Viewpcx("Frogg.pcx","VGA.DRV",1,0,0)   && View the PCX file && Call the Viewer
  156.  
  157. View the Frogg.pcx File with Standard VGA Driver File VGA.DRV using 
  158. XMS memory and a small Page Buffer..
  159.  
  160. Set Libr to FOXPCX
  161. =Viewpcx(@IMAGE",@DRIVER",0,1,1)   && View the PCX file
  162. DO SoundIntro
  163. =TextMode()
  164.  
  165. View the image file contained in memo field IMAGE. Use Standard VGA Driver 
  166. Located in the MemoFeild DRIVER . Use Virtual Memory with a Large 8K Page 
  167. Buffer.View The Image and return to FOXPRO for after one Second. Run a program
  168. called SoundIntro and Return the Screen to Text Mode.
  169.  
  170.  
  171. When using timeout of 0 :
  172. Once an Image is on the screen you can exit by hiting Escape. 
  173. If the Image is larger than the screen use the arrow keys to 
  174. move around and PGDN-PGUP to move around the image a page at a time.
  175. Use HOME-END to go to the top and bottom of the image.
  176. 0-9 keys select panning speed. Enjoy !!!!!!"  
  177. Cntrl + Right & Left Arrow Arrow for Full page pan
  178.  
  179.  
  180. FOXPCX Requirements
  181. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  182. FOXPRO 2.00 or higher (upto v2.6a supported)
  183. VGA or better Video Card .
  184. 512KB Free XMS or at least 512KB of disk Space Free.
  185.  
  186.  
  187. Error Codes Returned By FOXPCX
  188. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  189. The Following function can be used to Interprete FOXPCX Return Codes..
  190.  
  191. ************************************
  192. Procedure PCX_ERROR
  193. ***********************************
  194. Parameters _ER
  195.  
  196. do case
  197. Case _ER=0
  198.     return "No Errors Detected"
  199.     * Success !
  200. Case _ER=100
  201.     return "XMS driver not detected"
  202.     ** XMS Memory Requested and not available
  203.     ** XMS Driver may not be loaded or not enough XMS free
  204.     ** make sure HIMEM or a memory manager like QEMM is loaded
  205. Case _ER=101
  206.     return "Error allocating XMS memory block"
  207.     ** Probably not enough XMS.
  208. Case _ER=102
  209.     return "Error allocating VMS memory block"
  210.     ** Virtual memory manager failure. Check your disk space.
  211. Case _ER=103
  212.     return "Error writing XMS memory block"
  213. Case _ER=104
  214.     return "Error reading XMS memory block"
  215. Case _ER=105
  216.     return "Error writing VMS memory block"
  217.     ** Error Writing to Virtual memory Swap File. Check Disk Space.
  218. Case _ER=106
  219.     return "Error reading VMS memory block"
  220.     ** Error Reading Virtual memory Swap File. Check Disk .
  221. Case _ER=107
  222.     return "Error decoding PCX Image"
  223.     ** Error PCX Decoder Error. PCX file could be damaged.
  224. Case _ER=108
  225.     return "file i/o error"
  226. Case _ER=109
  227.     return "FOXPRO memory allocation error"
  228.     ** Remove TSR and/or other PLB files Etc..
  229. Case _ER=110
  230.     return "error loading screen driver"
  231.     ** Check to see if the driver is valid and exists.
  232. Case _ER=111
  233.     return "error calling screen driver"
  234. Case _ER=112
  235.     return "invalid driver "
  236.     * Not a Supported Driver  OR
  237.     * driver file probably damaged.
  238. Case _ER=113
  239.     return "error opening file"
  240. Case _ER=114
  241.     return "FOXPCX requires VGA or better"
  242. Case _ER=115
  243.     return "error opening PCX image"
  244. Case _ER=116
  245.     return "error allocating XMS"
  246. Case _ER=117
  247.     return "Error in Parameter 1"
  248. Case _ER=118
  249.     return "Error in Parameter 2"
  250. Case _ER=119
  251.     return "Error in Parameter 3"
  252. Case _ER=120
  253.     return "Error in Parameter 4"
  254. Case _ER=121
  255.     return "This is not a PCX file"
  256. Case _ER=122
  257.     return "driver load error (size)"
  258. Case _ER=123
  259.     return "error allocating driver resources"
  260. Case _ER=124
  261.     return "driver does not support > 256 Colors"
  262. EndCase
  263.  
  264.  
  265.  
  266.  
  267. Revision History
  268. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  269. Oct 28 1994 3.5  
  270.     added 24 bit PCX file support and upto 16 million colors
  271.     adjustable scroll speeds
  272.  
  273. Jun/94 2.5  
  274.     TextMode function added. 
  275.     Foxpro 2.5/2.6 Compatible.
  276.  
  277. Mar 8, 1993 version 2.3 
  278.     Enabled Error Handler Was prev. not activated 
  279.     Fixed problem with Loading Screen driver from Disk File.
  280.  
  281. March 10, 1993 Version 2.3a
  282.     Added Workaround to Problem with FOXPRO Standalone EXE's
  283.     See FOXBUG.TXT
  284.  
  285. Jan/93 2.2 Intial Release
  286.  
  287.  
  288.  
  289. Screen Drivers
  290. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  291. All VGA/SVGA  screen drivers are Copyright (c) 1991, 1993 Alchemy Mindworks
  292. Inc. Additional VGA and SVGA Screen Drivers and Information on creating your 
  293. drivers own can be obtained from Alchemy. A detailed description is contained 
  294. in the GWS.DOC file of the Graphics WorkShop. The Graphics Work Shop is a 
  295. excellent image manager. It can convert most formats to another ie) PCX to GIF .
  296. In addition an excellent source of information can be found in Steve Rimmers
  297. books "Bitmapped Graphics", "SuperCharged Bitmapped Graphics" and 
  298. "Bitmapped Graphics for Windows". The development of this package would not
  299. have been possible without the help of these excellent books.
  300.  
  301.  
  302. You can Register Graphics Work Shop from Alchemy Mindworks Inc. By Writing to :
  303.  
  304. Alchemy Mindworks Inc.
  305. P.O. Box 500
  306. Beeton, Ontario
  307. L0G 1A0
  308. Canada
  309.  
  310.  
  311.  
  312. Support
  313. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  314. If you have any questions and or suggestions please send EMAIL via
  315. Compuseve to address 70713,2002 or leave a message on the BBS 
  316. @ (201) 585-7002. The BBS and CIS EMAIL are checked daily.
  317. All Suggestions/comments are welcome and, of course, appreciated.
  318.  
  319.  
  320. WARRANTY AND LEGAL STUFF
  321. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  322. FOXPCX is Copyright (c) 1991-94 Master Creative Software, Inc.
  323. All Rights Reserved. 
  324.  
  325. FOXPCX may NOT be freely copied and/or  distributed with the exception of
  326. the demo version, which may be posted on BBS's and passed to friends as 
  327. long as all files that come with the demo are distributed together.
  328.  
  329. One registered version of FOXPCX entitles one person to use FOXPCX on one 
  330. machine at a time. Very reasonable and flexible distribution options are
  331. available.
  332.  
  333. There is no warranty or guarantees of any kind associated with FOXPCX. 
  334. Master Creative Software, Inc. and the author of FOXPCX will assume NO
  335. responsibility for ANY damages or losses caused by the use of FOXPCX 
  336. however it may happen and whatever may happen. Master Creative Software,
  337. Inc. and the author of FOXPCX will not be liable for any damages 
  338. whatsoever due to loss of data or any other reason even if they have been 
  339. advised of the possibility of such damages. 
  340.  
  341. Any risk of damage due to any possible inaccurate information or a 
  342. misunderstanding of the provided information is assumed by the user of the 
  343. information.
  344.  
  345. By registering and/or using FOXPCX, you agree to these terms.   
  346.  
  347. That's it ...
  348.  
  349.  
  350.  
  351.  
  352. How Much does it cost ?
  353. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  354.  
  355. One developer registration costs U.S. $55.00 ea.
  356.  
  357. When Registering via Compuserve the costs are a little more due to charges
  358. incurred from Compuserve for using the on line registration service which 
  359. is exactly 15%. It costs roughly $10.00 more to register on line.
  360.  
  361.  
  362. Multiple Copy Distribution:
  363. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  364. If you plan to distribute multiple copies of FOXPCX you are required 
  365. to purchase a distribution licensce. To obtain one you must have at least
  366. one registered developer version of FOXPCX and must pay an additional 
  367. $3.00/copy for the amount of copies you will be distributing up to a 
  368. maximum of 100 copies. When 100 copies are registered at the $3.00/copy 
  369. price then distribution is unlimited and royalty free.   
  370.  
  371.  
  372. Distribution
  373. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  374. This Software may be distributed with your application 
  375. when properly registered.
  376.  
  377.  
  378. How To Receive FOXPCX
  379. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  380. You can receive FOXPCX by sending the order form below with a
  381. check or money order, payable to Master Creative Software Inc.
  382. in U.S Funds for the total amount. 
  383.  
  384. Mail to: Master Creative Software, Inc.
  385.          1530 Palisade Avenue
  386.          Suite 16C   
  387.          Fort Lee, N.J. 07024
  388.  
  389.  
  390. ** Registration on Compuserve  **
  391.  
  392. You can also register FOXPCX via the Compuserve shareware
  393. database. GO SWREG the charge will billed to your Compuserve
  394. account. 
  395.  
  396. Multiple distribution licenses are available separately..
  397.  
  398.  
  399.  
  400. --------------------- FOXPCX ORDER FORM ------------------------- 
  401.  
  402. Where did you obtain FOXPCX?
  403.  
  404. Compuserve  [  ]    Your I.D. # _____________
  405.  
  406. BBS         [  ]    Which BBS  ______________ 
  407.  
  408.                     Phone#?    ______________
  409.  
  410. Friend      [  ]    ?          ______________ 
  411.  
  412.  
  413. How would you like FOXPCX shipped ? There are three choices:
  414.  
  415. 1) [ ] EMAIL to Compuserve I.D ________________________ (usually  
  416. same-day delivery $1-2 extra charge billed to your CIS account) 
  417.  
  418. 2) [  ] Download From BBS  (Fill in Address Info Below and a
  419. Account will be set up for you on the BBS)
  420.           Password you would like for BBS __________________  
  421.  
  422. 3) [  ] Send via U.S. Mail  
  423.  
  424. Company          ______________________________________________  
  425. Name             ______________________________________________  
  426. Address          ______________________________________________  
  427. City State Zip   ______________________________________________  
  428. Country          ______________________________________________   
  429. Phone/Fax       ______________________________________________   
  430.  
  431. SINGLE COPY REGISTRATION
  432.  
  433. qty ordered: ____ @ $______ $55.00 ea. 
  434.  
  435. MULTIPLE COPY REGISTRATION ADD
  436.  
  437. ____ copies @ $3.00 per copy. Maximum 100 copies. There is no   
  438. additional cost for distribution once the maximum 100 copies   
  439. have been registered. 1 Developer @55.00 + 100 copy registrations @$3.00 per
  440. copy entitles you to unlimited distribution. 
  441.  
  442.           $_________   License Fee @ $3.00/copy ($300 =unlimited)
  443.           $_________   N.J. res. add 6% sales tax. 
  444. Total:    $_________   Payable in U.S. Funds 
  445.  
  446.  
  447.  
  448.  
  449.