home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / FOXPRO / FOXPCX / FOXPCX.DOC < prev    next >
Text File  |  1993-03-10  |  17KB  |  412 lines
  1. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2.  F O X P C X  Version 2.3a  Mar 10, 1993
  3. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  4. Thank you for your interest and support of the PCX file 
  5. viewer Version 2.3a for Foxpro 2.0 & 2.5 !!
  6.  
  7.  
  8. Introduction
  9. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  10. FOXPCX is a small Loadable PLB File (Now reduced to only 10K in size !)
  11. that will display ANYSIZE B&W or color PCX File. You do not need to use 
  12. the RUN or the ! command. FOXPCX Becomes part of FOXPRO when Loaded . It 
  13. utilizes XMS memory or it's own Virtual Memory System to manage large 
  14. Images and to speed viewing. PCX files can be viewed from a regular dos 
  15. file or directly from a FOXPRO Memo Field. FOXPCXF supports many VGA 
  16. and SUPER VGA monitors by way of loadable screen drivers. Screen drivers are
  17. loaded from a disk file or a Foxpro MemoField. A typical call to FOXPCX would
  18. look like : =VIEWPCX("FROGG.PCX","VGA.DRV"). FOXPCX supports many SVGA 
  19. boards including the VESA standard by way of loadable screen drivers from 
  20. Alchemy Mindworks Inc. Which are included in this package.
  21.  
  22.  
  23. Evaluation Copy Limitations
  24. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  25. If you have the Evaluation Version only 3 of  
  26. 35 screen drivers are supplied. In addition MEMO Fields
  27. are not supported for IMAGES, they are for drivers. This version
  28. will not work in a shared Network Environment. And an annoying
  29. Evaluation Copy message pops up on each invocation of the VIEWPCX Function.
  30. To remove these restrictions PLEASE Register !!!!
  31.  
  32. FOXPCX.PRG DEMO Application
  33. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  34. Included with this package is a demo Program called FOXPCX.PRG
  35. This is a small demonstration program that will ask the user to select a PCX
  36. Image to View. It asks the User the Screen Type , Memory System to Use and Page
  37. Buffer size. FOXPCX.PRG Will look for the DRIVERS Database which is included.
  38. Feel free to usa any part of the Demo code in your application. 
  39. When using FOXPRO(X) you must select Virtual memory Option, and I reccoment
  40. using a 8K page buffer. Select a Screen Driver that matches the hardware
  41. you are running on. The Standard VGA drivers should work on any VGA card.
  42. If you have a SVGA card that has VESA suport the VESA driver should be used for
  43. maximum compatibilty and resolutions.
  44.  
  45.  
  46. PLB Parameters and ussage:
  47. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  48. Set Libray to FOXPCX  
  49. =ViewPCx(<paramr 1>,<param 2>,<param 3>,<param 4>) 
  50.  
  51. Paramter 1 is a string containing the PCX file name or a FOXPRO memo feild
  52. reference .The Image File must be a Valid 2 B&W or 16-256 Color PCX file.
  53. And can be as large as your XMS memory limit or DiskSpace. A memo feild 
  54. refernce must be precceded by a @ ie) @IMAGEDBF->IMAGE, ALias must be used
  55. if Not currently selected database which ,might be the case if you are loading
  56. screen drivers from memo fields.
  57.  
  58.  
  59.  
  60. Paramter 2 is a string containing the screen driver file name or a FOXPRO 
  61. memo field reference of which contains the screen driver .
  62. A Screen driver is a binary file that that is loaded into memory
  63. and executed. Several drivers are provided for Standard VGA and many popular
  64. SVGA cards. See DRIVERS.DBF for a list. DRIVERSV contains all of the supported 
  65. drivers in a memo feild called DRIVER. You can load the screen driver
  66. direclty from this file or copy the memo feild to a dos file .
  67. ie) Copy memo DRIVER to TRIDENT.DRV . A memo feild refernce must be precceded
  68. by a @ ie) @DRIVERS->Driver, Alias must be used if Not currently selected
  69. database which ,might be the case if you are loading screen drivers from 
  70. memo fields.
  71.  
  72.  
  73. Parameter 3 is of numeric type , it can be either a 0 or a 1. This parameter
  74. instructs FOXPCX which Expanded Memory scheme to use. 0 for XMS or 
  75. 1 For Virtual. FOXPRO(X) users need to use the virtual Option.  
  76. When using XMS memory you need to make sure that at least 512K of XMS memory
  77. is free. This should allow the viewing of 800X600X256 Image Larger Images
  78. Should leave more free. IF you are using a memory manager like qemm386
  79. that can make available EMS and XMS from the same memory pool you can set EMS 
  80. setting in config.fp to some amount that will be 512K less then the total
  81. EMS in the system or What FOXPRO will use. ie; If you have 2048K or 2MB of
  82. Free EMS then set EMS=1536 in your config.fp file.  The Virtual Memory Option
  83. will Create a (Unique File for LAN) SWAP file and will delete it when completed.
  84. XMS and OR Virtual memory are needed to view Large Images. A 800X600x256 
  85. Image requires 480,000 Bytes of memory !  The Swap File 
  86.  
  87.  
  88. Parameter 4 is of numeric type , it can be either a 0 or a 1. This parameter
  89. instructs FOXPCX which size page buffer to use. The page buffer is used to transfer
  90. a page of Expanded memory from and to either XMS or Virtual memory Use
  91. 0 for a Small 4k buffer and use 1 for Large 8k buffer.
  92. The 8K buffer will speed things up when using Virtual memory option other-
  93. wise use small page buffer. This Memory is allocated from FOXPRO.
  94.  
  95.  
  96. Parameter 5 is of numeric type , it is used to set the amount of time 
  97. that a image will appear on the Screen. The number represents MS DOS timer ticks
  98. (18/Second) to wait. One this time is expired The Image is left on the screen
  99. and it is upto you to call TextMode() to put the screen back into the proper
  100. mode. This allows you to display a Image for a certain amount of time while giving
  101. the option of doing something else in the background while the image is 
  102. displayed. Like Playing a Voice or Music File. If 0 is use as the Timeout
  103. The User Must hit Escape to Exit the Image and Cursor Keys (panning) is in
  104. affect for Images larger than the Screen TextMode is automaticly called 
  105. in this case. TextMode is called automaticaly on Unloading of PLB.
  106.  
  107.  
  108. Programming Examples
  109. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  110. Set Libr to FOXPCX   && Make FOXPCX a part of FOXPRO
  111. =Viewpcx("Frogg.pcx","VGA.DRV",1,0,0)   && View the PCX file && Call the Viewer
  112.  
  113. View the Frogg.pcx File with Standard VGA Driver File VGA.DRV using 
  114. XMS memory and a small Page Buffer..
  115.  
  116. Set Libr to FOXPCX
  117. =Viewpcx(@IMAGE",@DRIVER",0,1,1)   && View the PCX file
  118. DO SoundIntro
  119. =TextMode()
  120.  
  121. View The Image File Contained in Memo Field IMAGE. Use Standard VGA Driver 
  122. Located in the MemoFeild DRIVER . Use Virtual Memory with a Large 8K Page 
  123. Buffer.View The Image and return to FOXPRO for after one Second. Run a program
  124. called SoundIntro and Return the Screen to Text Mode.
  125.  
  126.  
  127. When using timeout of 0 :
  128. Once an Image is on the screen you can exit by hiting Escape. 
  129. If the Image is larger than the screen use the arrow keys to 
  130. move around and PGDN-PGUP to move around the image a page at a time.
  131. Use HOME-END to go to the top and bottom of the image.
  132. 0-9 keys select panning speed. Enjoy !!!!!!"  
  133.  
  134.  
  135. FOXPCX Requirements
  136. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  137. FOXPRO 2.00 (a Version for FOXPRO 2.5 will be available when 2.5 ships)
  138. VGA Video card Or Higher.
  139. 512KB Free XMS or at least 512KB of disk Space Free.
  140.  
  141.  
  142. Error Codes Returned By FOXPCX
  143. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  144. The Followinf Function can be used to Interprete FOCPCX Return Codes..
  145.  
  146. *****************
  147. Procedure PCXERR
  148. *****************
  149. Paramters _ER
  150.     Case _ER=0 
  151.       return "NO_ERROR_DETECTED"  
  152.         ** Success !!!
  153.     Case _ER=100 
  154.         return "XMS_NOAVAIL_ERROR" 
  155.         ** XMS Memory Requested and not Available
  156.         ** XMS Driver may not be loaded or Not enough XMS free
  157.     Case _ER=101 
  158.         return "XMS_ALLOC_ERROR"
  159.         ** Error Allocating XMS Memory . Probabaly not enough XMS.
  160.     Case _ER=102 
  161.         return "VMS_ALLOC_ERROR"
  162.         ** Virtual memory manager failure. Check your disk space.
  163.     Case _ER=103 
  164.         return "XMS_PUT_ERROR"
  165.         ** Error Writing to XMS memory
  166.     Case _ER=104 
  167.         return "XMS_GET_ERROR"
  168.         ** Error Reading XMS
  169.     Case _ER=105 
  170.         return "VMS_PUT_ERROR"
  171.         ** Error Writing to Virtual memory Swap File. Check Disk Space.
  172.     Case _ER=106 
  173.         return "VMS_GET_ERROR"
  174.         ** Error Reading Virtual memory Swap File. Check Disk .
  175.     Case _ER=107 
  176.         return "DECODER_ERROR"
  177.         ** Error PCX Decoder Error. PCX file could be damaged.
  178.     Case _ER=108 
  179.         return "FILE_I_O_ERROR"
  180.         ** Error Reading Imgae File.
  181.     Case _ER=109 
  182.         return "FOX_MEM_ERROR"
  183.         ** Error Allocating Memory Foxpro FoxPro Remove TSR Etc..
  184.     Case _ER=110 
  185.         return "DRIVER_LOAD_ERROR"
  186.         ** Error Loading Screen Driver. check to see if Valid and exists.
  187.     Case _ER=111 
  188.         return "DRIVER_CALL_ERROR"
  189.         * Driver File Probabaly damaged.
  190.     Case _ER=112 
  191.         return "DRIVER_TYPE_ERROR"
  192.         * Not a Supported Driver
  193.     Case _ER=113 
  194.         return "FILE_OPEN_ERROR"
  195.         ** Error opening Image File
  196.     Case _ER=114 
  197.         return "NEED_VGA_ERROR"
  198.         ** Must be running on VGA or better
  199.     Case _ER=115 
  200.         return "OPEN_INPUT_ERROR"
  201.         ** Error opeing IMAGE File.
  202.     Case _ER=116 
  203.         return "NOXMS_ERROR"
  204.         ** XMS Driver Not Found
  205.     Case _ER=117 
  206.         return "PARAM1_ERROR"
  207.         ** PLB Paramater Error Check the Type and count of your paramterts.
  208.     Case _ER=118 
  209.         return "PARAM2_ERROR"
  210.         ** PLB Paramater Error Check the Type and count of your paramterts.
  211.     Case _ER=119 
  212.         return "PARAM3_ERROR"
  213.         ** PLB Paramater Error Check the Type and count of your paramterts.
  214.     Case _ER=120 
  215.         return "PARAM4_ERROR"
  216.         ** PLB Paramater Error Check the Type and count of your paramterts.
  217.     Case _ER=121 
  218.         return "NOT_PCX_ERROR"
  219.         ** This can't be a valid PCx file.
  220. Endcase
  221.  
  222. Revision History
  223. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  224. Jan/93 2.2 Intial Release
  225.  
  226. Mar 8, 1993 version 2.3 
  227.     Enabled Error Handler Was prev. not activated 
  228.     Fixed problem with Loading Screen driver from Disk File.
  229.  
  230. March 10, 1993 Version 2.3a
  231.     Added Workaround to Problem with FOXPRO Standalone EXE's
  232.     See FOXBUG.TXT
  233.  
  234.  
  235. Screen Drivers
  236. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  237. All VGA/SVGA  Screen Drivers are Copyright (c) 1991, 1993 Alchemy Mindworks Inc.
  238. Additional VGA and SVGA Screen Drivers and Information on creating your 
  239. drivers own can be obtained Alchemy A Detailed Descrition is contained 
  240. in the GWS.DOC file of the Graphics WorkShop . The Graphics work Shop is a 
  241. Excellent Image Manager It can Convert most Formats to another ie) PCX to GIF .
  242.  
  243. You can Register Graphics Work Shop from Alchemy Mindworks Inc. By Writing to :
  244.  
  245. Alchemy Mindworks Inc.
  246. P.O. Box 500
  247. Beeton, Ontario
  248. L0G 1A0
  249. Canada
  250.  
  251.  
  252.  
  253. Support
  254. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  255. FOXPCX is Copyright (c) 1993 Warren Master
  256.  
  257. If you have any questions/sugestions EMAIL me at (CIS) 70713,2002. Or 
  258. leave a message on FOXFORUM (ThirdParty Section) .
  259. I check my EMAIL everyday...
  260.  
  261. All Suggestions/comments are appericated..
  262.  
  263.  
  264.  
  265.  
  266. How To Receive FOXPCX
  267. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  268. You can recieve FOXPCX for a small donation of U.S. $35.00 + $5.00 Handling
  269.  
  270.  To Order: send Check or Money Order payable to:
  271.      Warren Master
  272.      1530 Pallisade AVenue
  273.      Suite 16C
  274.     Fort Lee, N.J. 07024
  275.  
  276.     I can be reached via CIS MAIL My I.D. is 70713,2002 and I monitor
  277.     the FOXForum daily. No Phone Calls Please! FOXPCX can be recieved
  278.     by U.S. Mail or CIS EMAIL.. 
  279.  
  280.  
  281. Distribution
  282. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  283. This Software may be distributed with your application in a bound EXE or APP
  284. One time ! Additional copies may be used by sending me $2.00/Copy. After 100
  285. copies, it's yours for ever and for as many copies as you like. If you would 
  286. like to discuss this with me Please EMail me and I will contact you. Users
  287. who register for Unlimited Distribuition have the option of Changing the 
  288. Notice that is in the Status Window....
  289.  
  290.  
  291.  
  292. WARRANTY AND LEGAL STUFF
  293. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  294. There is no warranty of any kind associated with this software.
  295. I assume NO responsibility for any damage or loss caused by the use of 
  296. this programs, however it may happen and whatever may happen. 
  297.  
  298. I will not be liable for any damages whatsoever due to loss of data or any 
  299. other reason, even if I have been advised of the possibility of such damages. 
  300.  
  301. Any risk of damage due to any possible inaccurate information or a 
  302. misunderstanding of the provided information is assumed by the user 
  303. of the information.
  304.  
  305.  
  306. By using this software, you  agree to these Terms. 
  307.  
  308.  
  309. That's it...
  310.  
  311.  
  312.  
  313. FOXPRO 2.0 & 2.5 PLB Shareware Catalog By Warren Master January 30, 1993
  314. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  315. Vendor Name:    Warren Master
  316. Address:        1530 Palisade Ave
  317.                 Suite 16C
  318.                 Fort Lee, NJ 07024
  319.  
  320. Compuserve I.D: 70713,2002
  321.  
  322.  
  323. Products I currently Have available:
  324. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  325.  
  326.  
  327. Product Name:   COMP5
  328. Description:    Data Compression System For Foxpro 2.00
  329. Recent Version: 5.0 Dated 12/09/91
  330. Price:          U.S. $35.00 + $5.00 Shipping
  331. Description:    Compress and Decompress files within Foxpro 2.00. Up-to 75% 
  332.                 Compression Ratios. Includes PLB file,DOS EXE version and
  333.                 docs with Examples. Demo Version is limited to Compresing 
  334.                 Files <=64K and  does not support memo fields directly. 
  335.                 Several PLB Versions are included that have different 
  336.                 Compression Ratios and memory requirements .CRC Checking 
  337.                 ensures data Integrity.
  338.  
  339. Product Name:   PCX Viewer I
  340. Description:    PCX Viewer For Foxpro 2.00
  341. Recent Version: 1.01 Dated 1/18/91
  342. Price:          U.S. $20.00 + $3.00 Shipping
  343. Description:    View 2,16,256 Color PCX Images On EGA and VGA displays. 
  344.                 Includes PLB file and Docs with Examples. Allows Background
  345.                 proccessing when picture is displayed. Registerd version 
  346.                 supports  memo fields directly, and the Flash View Option.. 
  347.  
  348.  
  349. Product Name:   FOXPCX (NEW FOR 1993 !)
  350. Description:    PCX Viewer II For Foxpro 2.0 & 2.5
  351. Recent Version: 2.2 Dated 1/25/93
  352. Price:          U.S. $35.00 + $5.00 Shipping
  353. Description:    View any size B&W or Color PCX Image On VGA & SVGA displays. 
  354.                 Supports the panning of large images,resoulutions up to
  355.                 1024X768X256 in SVGA modes (VESA standard supported). Uses XMS 
  356.                 or Virtual memory to Handle LARGE images. Includes PLB file
  357.                 ,docs with Examples and Screen drivers for Most VGA & SVGA cards.
  358.                 Registered users will receive PLB with evaluation message removed, Network
  359.                 version and complete screen driver set.
  360.                 
  361.  
  362.  
  363. Product Name:   FOXGIF (NEW FOR 1993 !)
  364. Description:    GIF Viewer For Foxpro 2.0 & 2.5
  365. Recent Version: 2.2 Dated 1/25/93
  366. Price:          U.S. $35.00 + $5.00 Shipping
  367. Description:    View any size B&W or Color GIF Image On VGA & SVGA displays. 
  368.                 Supports the panning of large images,resoulutions up to
  369.                 1024X768X256 in SVGA modes (VESA standard supported). Uses XMS 
  370.                 or Virtual memory to Handle LARGE images. Includes PLB file
  371.                 ,docs with Examples and Screen drivers for Most VGA & SVGA cards.
  372.                 Registered users will receive PLB with evaluation message removed, Network
  373.                 version and complete screen driver set.
  374.                 
  375.  
  376. Products I will have available by March 1993:
  377. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  378. Product Name:  FOXSQZ
  379. Description:   Data Compression/Decompression Archiver for Foxpro 2.0 & 2.5
  380. Recent Version:N/A
  381. Price:         N/A
  382. Description:   Compress and Decompress Multiple Files into one compact
  383.                archive file. Fast Execution with low memory requirements
  384.                CRC checking to ensure data integrity. Includes PLB file,
  385.                DOS EXE Version, and Docs with Examples. Function to Create                 
  386.                Add,List,Update,and delete files from Archive files. 
  387.                Multiple Compression methods, direct memo field support
  388.                ,Network Support,and DOS Wildcards may be used for File Selections.                
  389.    
  390.  
  391. Product Name:   FOXBLASTER
  392. Description:    Sound System for Foxpro 2.0 & 2.5 Supporting
  393.                 Creative Labs SounBlaster Board. 
  394. Recent Version: N/A
  395. Price:          N/A
  396. Description:    Play VOC (Voice) and CMF (Music) files from FOXPRO Memo
  397.                 fields and hear them on Creative Labs Sound
  398.                 Blaster Boards. Excellent for Multimedia
  399.                 Applications when combined with Image
  400.                 Viewers.
  401.  
  402.                     
  403. Demos of Each are available on Compuserve, GO FOXFORUM or GO DBADVISOR
  404.  
  405.  
  406. Thank you for your support!
  407.  
  408.  
  409. Warren Master (CIS) 70713,2002
  410.  
  411.  
  412.