home *** CD-ROM | disk | FTP | other *** search
/ Chip 1995 March / CHIP3.mdf / utility / barcodes / readme.txt < prev    next >
Encoding:
Text File  |  1994-11-07  |  7.2 KB  |  221 lines
  1.         BARCODES.DLL DEMO PACK
  2.         ======================
  3.  
  4.           Product Version 3.5
  5.  
  6.     BARCODES.DLL was developed by HEX TECHNOLOGY
  7.     417 Manchester Street, Christchurch, New Zealand.
  8.     Fax: 64 3 3772255,  Compuserve: 100241,3550
  9.     From Internet:  100241.3550@COMPUSERVE.COM
  10.  
  11.  
  12. DESCRIPTION
  13. ===========
  14.  
  15. BARCODES.DLL is a Microsoft Windows compatible Dynamic
  16. Link Library for drawing barcodes.  
  17.  
  18. FUNCTIONS
  19. =========
  20.  
  21. It contains two functions that can be called by almost any Windows
  22. programming language.  The two functions are:
  23.  
  24.  
  25. (1) DrawBarcode(...)
  26.     This function returns the barcode as a memory
  27.     metafile (HMETAFILE) which you can then display
  28.     and scale for a screen or printer device context (HDC).
  29.  
  30.     For example;
  31.  
  32.     HMETAFILE hmf;
  33.     HDC hdc = GetDC(hWnd);
  34.     hmf = DrawBarcode( hdc, BARCODE_UPC_E, "123456", "Apples", .... );
  35.     SetWindowExt( x , y);
  36.     SetWindowOrg( ox, oy);
  37.     PlayMetaFile( hmf);
  38.     DeleteMetaFile( hmf);
  39.     ReleaseDC(hdc);
  40.  
  41. (2) CreatePlaceableBarcode(...)
  42.     This function saves the barcode as a placable metafile on disk.
  43.     This makes it possible to load the barcode into any Windows software
  44.     that can read .wmf graphic files.
  45.  
  46.     For example:
  47.  
  48.     CreatePlacableBarcode( "apples.wmf", hdc, BARCODE_UPC_E,"123456"....);
  49.     InsertPicture( "apples.wmf");
  50.  
  51.  
  52. NOTE:  The demo version of barcodes.dll places a line through the barcode
  53. picture and replaces the first digit of the barcode data with a different
  54. digit.  However, you should still be able to scan the barcodes for testing.
  55.  
  56.  
  57. SAMPLE CODE
  58. ===========
  59.  
  60. In this archive, you should find two sample applications:
  61.     
  62. (1)  Sample1.zip
  63.  
  64.     This is a Visual C++ application that lets you test all the parameters
  65.     to the drawbarcode function.  It has a preview function, and settings
  66.     can be loaded and saved to disk.  You can also print the specified
  67.     barcode.
  68.  
  69.     All of the work calling barcodes.dll is done in the file barvw.cpp.
  70.  
  71. (2)  Sample2.zip
  72.  
  73.     This is a Microsoft Word 6.0 template with a macro that will
  74.     insert a barcode picture into a document.  To use, copy the template
  75.     to your Word Template directory and start a new document bases on the
  76.     template. Type a number anywhere in the document, select it, then
  77.     run the InsertBarcode macro.   The macro calls the
  78.     CreatePlacableBarcode function to create a .wmf file on disk.
  79.     Then the Word Basic function to read and insert the .wmf file
  80.     is called. The selected text is replaced by the barcode picture.
  81.     The picture is scaled to exact measurements.
  82.  
  83.     If you do not have Word version 6.0 a copy of the macro in text
  84.     form is included in macro.txt.
  85.  
  86.  
  87. TECHNICAL INFORMATION
  88. =====================
  89.  
  90. Supported styles
  91. ----------------
  92.     
  93. UPC-A,   UPC-E,   EAN 8,  EAN 13,   EAN 128,  Code 128-Auto, Code 128-A,
  94. Code 128-B, Code 128-C, Codabar (NW7), Telepen, MSI, Interleaved 2 of 5 (ITF),
  95. Industrial 2 of 5 (Non interleaved), Code 3 of 9 (Code 39), Code 93, Code 11,
  96. Code B.  Others added on request.
  97.  
  98. Extended characters
  99. -------------------
  100.  
  101. Styles such as Code 128/Ean 128 and Code 39 accept extended 
  102. characters.  Codes are entered in the form ~Code~ eg: 123~CR~4567
  103. as barcode data would generate a barcode pattern of 123CR4567.
  104. See the help file of BAROLE 2.5 for more information.  BAROLE is
  105. available on Compuserve WINSHARE, or on CICA, win3/programmr dir.
  106.  
  107.  
  108. Functions
  109. ---------
  110.  
  111. Check digits,  Vertical and horizontal bearer bars, extra line of text,
  112. show data on/off, font face, italic, bold, bar color, background color,
  113. show spacer character ">",  adjustable ratios from 1.75 to 3.00. Font
  114. size adjustment from default.
  115.  
  116. Scaling
  117. -------
  118. The dll functions return measurement values that allow the programmer
  119. to determine how to scale the barcode to an exact size.  See the
  120. sample code for more information.  
  121.  
  122. Dynamic Link Library
  123. --------------------
  124. Size ~40K, compiled for 286 instruction set.
  125.  
  126.  
  127. FILES INCLUDED IN THIS ARCHIVE
  128. ==============================
  129.  
  130. (1) README.TXT            - This file
  131. (2) BARCODES.DLL        - The barcode library
  132. (3) CTL3D.DLL            - Microsoft's library for 3d controls
  133. (4) BARTEST.EXE            - A sample application to test barcodes.dll
  134. (5) SAMPLE1.ZIP            - Visual C++ source code for BARTEST.EXE
  135. (6) SAMPLE2.ZIP            - Microsoft Word 6.0 template and macro
  136.                   for inserting a barcode into a document.
  137. (7) *.BTS            - Files for loading into BARTEST.EXE
  138. BENEFITS OF USING BARCODES.DLL
  139. ==============================
  140.  
  141. Talking directly with the barcodes.dll provides the fastest and most
  142. efficient method to draw barcodes in Windows.  The dll is only 40K, and
  143. since it does not use OLE or DDE it requires very little memory.
  144.  
  145. Barcodes.dll supports all widely used barcode styles.
  146.  
  147. Barcodes.dll has been used successfully in our barcoding products, sold
  148. around the world, for over a year now.  
  149.  
  150. HEX Technology provides very fast service and technical support. We can
  151. provide a faxed or emailed response to your questions within a few hours.
  152.  
  153. In the event of bugs being found in the software, we fix and send free updates
  154. of the software to all licensed users within 24 hours.
  155.  
  156.  
  157. LICENSING BARCODES.DLL
  158. ======================
  159.  
  160. If you would like to use barcodes.dll in your software, then you must
  161. license it.  The fee is USD$810.  This is a once only payment, and therefore
  162. no royalties or update fees will be charged.  You can then, without restriction,
  163. ship barcodes.dll with your software applications.  However a license does not
  164. permit you to sell barcodes.dll on its own.
  165.  
  166. This is a very cheap way of providing barcode support in your software.  If
  167. for example, you expect to sell 200 copies of your software, then it is only
  168. costing you $4 USD per copy of your software.  
  169.  
  170. However, if you plan to sell only one copy of your software, then another
  171. one of our products, BAROLE 2.5 might be a cheaper alternative.  This sells
  172. for $160 US, and is a complete OLE/DDE based barcode server.  You can find
  173. BAROLE 2.5 on Internets CICA ftp site or GO WINSHARE on Compuserve.
  174.  
  175. To order a license, please make contact with:
  176.  
  177.     HEX TECHNOLOGY
  178.     417 Manchester Street
  179.     Christchurch 8001
  180.     NEW ZEALAND
  181.     
  182.     Voice: 64 3 3772255,  or,  64 25 358588
  183.     Fax: 64 3 3772255
  184.  
  185.     Compuserve: 100241,3550
  186.  
  187. If we receive a faxed order, we can email you a license pack
  188. immediately.  Otherwise orders are processed every 24 hours.
  189.  
  190. Payment can be made by:
  191.         
  192.     VISA,  MasterCard, American Express, DinersClub or a Bank Cheque
  193.     drawn on a US bank.
  194.  
  195. Please remember we are about 11 hours ahead of most time zones in the US 
  196. and Europe.
  197.  
  198. WHAT YOU GET IN A LICENSE PACK
  199. ==============================
  200.  
  201.     (1)  An unprotected version of barcodes.dll
  202.     (2)  A licensed serial number
  203.     (3)  Free technical support for any question or problems.
  204.     (4)  Free updates of barcodes.dll for at least 12 months.
  205.     (5)  Customisation of barcodes.dll if you require some
  206.          extra features.  This will not be charged for, if the
  207.          customised features can be added to the next version of
  208.          barcodes.dll.  However, if the charges are major or
  209.          not applicable to other users, then we may make a small
  210.          charge.
  211.  
  212. The license does not include source code to barcodes.dll.
  213.         
  214. If you require further information about barcodes.dll please
  215. drop us an email or fax message. 
  216.  
  217. Best Regards
  218.  
  219. HEX TECHNOLOGY.
  220. November 1994.    
  221.