home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / sdk / bin / riffadd.txt < prev    next >
Encoding:
Text File  |  1995-07-11  |  2.1 KB  |  67 lines
  1. RIFFADD:
  2. ========
  3.  
  4. This is an utility that can be used to add text information 
  5. or Bitmaps to RIFF files.
  6.  
  7. Features:
  8. ---------
  9. Riffadd has both an interactive and batch mode. Riffadd works
  10. only on Windows 95 now. It can be used to set text into DISP
  11. and all known INFO chunks, and Bitmaps into DISP chunks. The 
  12. user needs to specify an input and an output file (and an optional
  13. script file for the batch mode). Riffadd adds/replaces info 
  14. in the input file and writes to the output file. Riffadd can
  15. handle text with extended characters or DBCS characters.
  16.  
  17. Command Line:
  18. -------------
  19. (1) Riffadd //prompts you for the Input and output files before 
  20.         //showing the UI
  21.  
  22. (2) Riffadd <input file> <output file>
  23.  
  24. (3) Riffadd /b <script file> //you will be prompted for other files
  25.  
  26. (4) Riffadd /b <script file> <input file> <output file>
  27.  
  28. Batch mode:
  29. -----------
  30. The batch mode uses a script file like the one shown below.
  31. TEST.SCR is a sample script file.
  32.  
  33. For INFO chunks the format is
  34.  
  35. <Chunk type>=<<STRING:>/<FILE:>>,<<TEXT>/<File name>>
  36.  
  37. For DISP chunks use DISP_DIB or DISP_TEXT depending
  38. on if you want CF_DIB or CF_TEXT to be the format of the
  39. DISP chunk.
  40.  
  41. Script file processing uses Profile String API's. So
  42. the script has to be in the [RIFFADD] section. Use 
  43. "\r\n" to force a line break in the text.
  44.  
  45.  
  46. [RIFFADD]
  47. ISBJ=STRING,"This is the Subject, dude"
  48. DISP_TEXT=FILE,e:\motown\riffadd\tmp\t1.txt
  49. ITCH=STRING,"Who cares who the technician is"
  50. ICMT=STRING,"This is the first line\r\nand this is next line"
  51. DISP_DIB=FILE,e:\motown\riffadd\tmp\s1.dib
  52. ICMS=FILE,e:\motown\riffadd\tmp\t2.txt
  53. IPLT=STRING,"Screw the palette"
  54.  
  55. Notes:
  56. ------
  57. (1) The maximum length of text is 512 bytes (not chars).
  58. (2) When entering text in the edit window of the UI, if you
  59.     need line breaks, use Ctrl+Return. If you just hit
  60.     return the Prop. Sheet code eats the Return.
  61. (3) We don't yet support other types of data (eg. Icons, Small
  62.     Icons, etc).
  63. (4) While the input and output files may have relative or absolute
  64. pathnames, the script file must have the absolute path name unless it is
  65. in the Windows directory.
  66.  
  67.