home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / convert3.zip / Convert.HLP (.txt) < prev    next >
OS/2 Help File  |  1998-04-30  |  9KB  |  177 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Purpose ΓòÉΓòÉΓòÉ
  3.  
  4. Convert 4 and 8 Byte values between various data formats. 
  5.  
  6.  
  7. ΓòÉΓòÉΓòÉ 2. Data Entry & Results ΓòÉΓòÉΓòÉ
  8.  
  9. Data in any of the fields can be edited. 
  10.  
  11. The data entry format is the same as the display format.  Thus hex values are 
  12. expected in blank delimited form, binary values are 8 characters per byte, etc. 
  13. If the user enters too few values in the ASCII, Hex, and 8bit Decimal fields 
  14. the entry will be left padded with the hex value 00 (refer to Precision). 
  15.  
  16. For special notes regarding ASCII see ASCII and Meaning 
  17.  
  18.  
  19. ΓòÉΓòÉΓòÉ 2.1. ASCII ΓòÉΓòÉΓòÉ
  20.  
  21. Representing hex values in ASCII is a little tricky and there are impacts on 
  22. how both for Convert displays and how the user enters values.  First, Convert 
  23. must prevent the display from responding to what the Hex code is saying.  For 
  24. example, the hex value may be that for a carriage return.  In Convert the only 
  25. code that is problematic for display is '00'x.  This is displayed as a "?". 
  26. The only way for a user to tell whether or not a literal "?" is meant is to 
  27. look at one of the other fields.  The question mark is hex code '3F'. 
  28.  
  29. Note:  This all depends on the code page being used.  Mine is set at the 
  30. default for United States. 
  31.  
  32. Display is one thing, data entry is another.  Few keyboards have keys for all 
  33. the 256 ASCII values.  To allow the user to enter values which do not have 
  34. keyboard equivalents I have added the following twist to the ASCII entry field. 
  35.  
  36. ASCII values may be entered either by typing the ASCII value or by entering the 
  37. hex code for value.  To discriminate a hex value from a simple ASCII value the 
  38. hex must be preceded by the string  ||'  and followed by the string  'x||  . 
  39. Thus one could enter:  a||'13'x||||'09'x||4 to get the hex value  61 13 09 34 
  40.  
  41.  
  42. ΓòÉΓòÉΓòÉ 2.2. Meaning ΓòÉΓòÉΓòÉ
  43.  
  44. If the user highlights a single character in the ASCII field and then hits 
  45. Meaning the program will check if that character has a special meaning.  If no 
  46. meaning is found then the highlight is turned off and nothing happens. 
  47.  
  48. Note that only the first 33 ASCII values have been entered in this table. 
  49. Where I understand the codes I've generally given a little more meaningful 
  50. explanation than the 2 or 3 letter, standard definition. 
  51.  
  52.  
  53. ΓòÉΓòÉΓòÉ 3. Convert ΓòÉΓòÉΓòÉ
  54.  
  55. Which ever field was last edited will be read when the Convert button is hit. 
  56. The value in that field is then converted to hexadecimal form and the 
  57. appropriate values for the other fields are computed and displayed. 
  58.  
  59.  
  60. ΓòÉΓòÉΓòÉ 4. Swap ΓòÉΓòÉΓòÉ
  61.  
  62. Swap will read the current value in the "Hex" field, reverse the bytes and then 
  63. do the convert operation. 
  64.  
  65.  
  66. ΓòÉΓòÉΓòÉ 5. Precision ΓòÉΓòÉΓòÉ
  67.  
  68. Conversions are done on either 4 Bytes or 8 Bytes of data.  This corresponds to 
  69. single double precision, floating point values. 
  70.  
  71.  
  72. ΓòÉΓòÉΓòÉ 6. Requirements ΓòÉΓòÉΓòÉ
  73.  
  74. Convert is a REXX program that used VisProREXX by HockWare and REXXLIB by 
  75. Quercus.   Convert uses a private release of REXXLib.  I have included a copy 
  76. of the necessary DLL. This DLL must be placed somewhere in your path.  I 
  77. vehemently recommend that if you wish to use the DLL to write your own code, 
  78. buy a license for REXXLIB.  I consider it very cheap. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 7. Credits ΓòÉΓòÉΓòÉ
  82.  
  83. Convert was written by: 
  84.  
  85.       Doug Rickman 
  86.       Global Hydrology and Climate Center, Marshall Space Flight Center/NASA 
  87.       977 Explorer Blvd. 
  88.       Huntsville, Alabama 35806 
  89.       256-922-5889 
  90.       doug@hotrocks.msfc.nasa.gov 
  91.  
  92.  Documentation revision date: April 29, 1998 
  93.  
  94.  Contact information: 
  95.  
  96.  VisProREXX 
  97.  
  98.    o Fax:  (919) 380-0757
  99.    o Compuserve: Mail can be sent directly to us at  71333,3226
  100.     Technical questions can be directed to our forum.  You can access the HOCKWARE forum by using the GO command in this form:
  101.     GO HOCKWARE
  102.    o Internet: Our Internet address is:
  103.     support@vispro.com
  104.    o World Wide Web: General sales information, product announcements, and patches are available from our site on the world wide web. The URL is:
  105.     http://www.vispro.com
  106.  
  107.  REXXLIB 
  108.  
  109.    Quercus Systems
  110.      P. O. Box 2157
  111.      Saratoga, CA 95070
  112.  
  113.      Phone: (408) 867-7399, (800) 440-5944
  114.      Fax:  (408) 867-7489
  115.      BBS:  (408) 867-7488
  116.  
  117.      For up-to-date information on the latest releases of REXXLIB and
  118.      our other products, check our Web page, http://www.quercus-sys.com/
  119.  
  120.  
  121. ΓòÉΓòÉΓòÉ 8. License and Warranties ΓòÉΓòÉΓòÉ
  122.  
  123. Convert is copyrighted.  It may be freely distributed provided this copyright 
  124. is retained with the program. 
  125.  
  126. REXXLIB is copyrighted software belonging to Quercus Systems and is included in 
  127. Convert by permission of Quercus Systems.  Users of Convert are not permitted 
  128. to use REXXLIB except in conjunction with Convert. Any further use by an end 
  129. user (except for evaluation) requires purchase of at least a basic registration 
  130. from Quercus Systems. 
  131.  
  132. VisProREXX is copyrighted software belonging to Hockware, Inc. and is included 
  133. in Convert by permission of Hockware.  Users of Convert are not permitted to 
  134. use VisProREXX except in conjunction with Convert. Any further use by an end 
  135. user (except for evaluation) requires purchase of at least a registration from 
  136. Hockware, Inc. 
  137.  
  138. This program is provided free of charge and with no warranty of any kind. 
  139.  
  140. For copies of the software licenses which cover the included code within 
  141. Convert see REXXLIB and  VisProREXX. 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 8.1. REXXLIB License ΓòÉΓòÉΓòÉ
  145.  
  146.  Use of REXXLIB in this program is according to the following terms from my 
  147. (Doug Rickman) REXXLIB license  - 
  148.  
  149.  The executable portions (only) of REXXLIB may be included with commercial, "shareware", or "freeware" application software or applications distributed "in house"
  150.  as long as you pay for one full registration and agree to the following terms and conditions:
  151.  
  152.  1. Only executable .EXE and .DLL files may be included. No other copyrighted files of Quercus Systems (including all or any portion of the online documentation)
  153.    may be included with the product.
  154.  
  155.  2. Included files must not be modified in any way. In particular, embedded copyright notices must be left intact.
  156.  
  157.  3. Your documentation should explicitly state that REXXLIB is copyrighted software belonging to Quercus Systems and is included with your software by permission
  158.    of Quercus Systems.
  159.  
  160.  4. Users of your product are not permitted to use REXXLIB except in conjunction with your product. Any further use by an end user (except for evaluation)
  161.    requires purchase of at least a basic registration.
  162.  
  163.  5. No part of REXXLIB may be included with other collections of tools or libraries intended primarily for use by programmers.
  164.  
  165.  
  166. ΓòÉΓòÉΓòÉ 8.2. VisProREXX License ΓòÉΓòÉΓòÉ
  167.  
  168.  Use of VisProREXX in this program is according to the following terms from my 
  169. (Doug Rickman) VisProREXX license  - 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ 9. Change History ΓòÉΓòÉΓòÉ
  173.  
  174.    1. April 29, 1998 First release.  Good luck. 
  175.    2. April 30, 1998 Added Packed Binary Coded Decimal with sign bit. 
  176.