home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d09xx / d0964.lha / Angie / RawInsertUtil / RawInsert.dok < prev    next >
Text File  |  1993-11-24  |  5KB  |  135 lines
  1.  
  2.  -------------------------------------------------------------------------
  3.  RawInsert 1.1 (24.11.93) (w) Franz_Schwarz@mil.ka.sub.org - Public Domain
  4.  -------------------------------------------------------------------------
  5.   
  6. RawInsert ist ein Hilfsprogramm fⁿr die Shell ab Amiga-OS2.04 oder h÷her,
  7. das es Ihnen erm÷glicht, beliebigen Text und andere Eingabe-Ereignisse wie
  8. Mausbewegungen, Diskettenwechsel, Maus-Tasten-BetΣtigungen, etc, in den
  9. Eingabestrom einzufⁿgen.  Dies ist besonders bei der Arbeit mit Stefan
  10. Becker's Toolmanager nⁿtzlich, da so viele GUI-Applikationen ganz oder
  11. teilweise von ARexx-Skripten oder Stapelverarbeitungsdateien aus gesteuert
  12. werden k÷nnen.
  13.  
  14.  
  15. Die Kommandozeilen-Argument-Schablone von RawInsert lautet:
  16.  
  17.   "DELAY=MILLISECS=MS/K/N,DESCR=D/S,FROM=FILE/K,TEXT/F"
  18.                        
  19.  
  20. Dabei bedeuten:
  21.  
  22. DELAY=MILLISECS=MS/K/N - Hier kann angegeben, wieviel Zeit in Millisekunden
  23. zwischen dem Einfⁿgen von zwei InputEvents in den Eingabestrom gewartet
  24. werden soll.  Voreingestellt ist 2, gⁿltig sind Werte von 0 (keine Pause)
  25. bis 999.
  26.  
  27. DESCR=D/S - falls angegeben, interpretiert RawInsert die Quelldaten nicht
  28. als reinen ASCII-Text (Voreinstellung), sondern als Eingabe-Ereignis-
  29. Beschreibungsdaten.  Diese bestehen dabei aus normalem ASCII-Text, der
  30. zusΣtzlich folgende ESC-Sequenzen enthalten kann:
  31.       \n - Zeilenende (wird als Wagenrⁿcklauf eingefⁿgt)
  32.       \r - Wagenrⁿcklauf
  33.       \0 - nul
  34.       \t - horizontaler Tabulator
  35.       \f - Seitenende
  36.       \xff - ASCII-Code 0xff (f steht fⁿr beliebiges Hex-Nibble)
  37.       \' - Apostroph
  38.       \" - Anfⁿhrungszeichen
  39.       \< - linke spitze Klammer '<'
  40.       \\ - Backslash '\'
  41. Zudem k÷nnen einzelne Eingabe-Ereignisse innerhalb spitzer Klammern
  42. entsprechend Commodities' ParseIX() - Syntax spezifiziert werden.
  43. Gⁿltige Eingabe-Ereignis-Beschreibungsdaten wΣren z.B. 
  44. '<lcommand a><tab>Hello!<alt -capslock numericpad enter>\x06\t\5*x\<12\n'
  45.  
  46. FROM=FILE/K - Hier kann eine Datei angegeben werden, aus der die
  47. Quell-Daten gelesen werden sollen.  Darf nicht zusammen mit TEXT/F
  48. angegeben werden.
  49.  
  50. TEXT/F - Die Quelldaten als Kommandozeilen-Argument.  Inkompatibel mit
  51. FROM=FILE/K.
  52.  
  53. Falls keines der Argumente FROM=FILE/K und TEXT/F angegeben wurde, wird der
  54. aktuelle Eingabekanal als Daten-Quelle herangezogen.
  55.  
  56. Zeilenende-Zeichen (0x0a) werden von RawInsert automatisch in
  57. WagenrⁿcklΣufe umgewandelt.  Weiterhin werden WagenrⁿcklΣufe immer als
  58. BetΣtigung der einfachen Wagenrⁿcklauftaste in den Eingabestrom eingefⁿgt,
  59. sofern diese in der aktuellen System-Standard-Tastenbelegung mit
  60. dem Wagenrⁿcklauf-Zeichen belegt ist.
  61.  
  62. Falls der DESCR=D/S-Schalter angegeben wird, schlΣgt RawInsert fehl, meldet
  63. dies, und retourniert 20 (Dos.fail),  sobald ein Zeichen oder eine
  64. Eingabe-Ereignis-Beschreibung innerhalb spitzer Klammern nicht korrekt in
  65. ein Eingabe-Ereignis (InputEvent) umgesetzt werden kann.  RawInsert fⁿgt in
  66. diesem Fall auch kein einziges Eingabe-Ereignis in den Eingabestrom ein.
  67.  
  68. Ohne Anfⁿhrung des DESCR=D/S-Schalters setzt RawInsert hingegen, falls fⁿr
  69. ein ASCII-Zeichen mit der aktiven System-Standard-Tastaturbelegung kein
  70. entsprechendes Eingabe-Ereignis generiert werden kann, die Arbeit beim
  71. nΣchsten Zeichen fort, und terminiert nach der Umsetzung des letzten
  72. Zeichens mit dem Rⁿckgabewert 5 (Dos.warn).
  73.  
  74. Falls Fehler beim Lesen der Quelldaten auftreten, terminiert RawInsert
  75. und gibt Dos.fail (20) zurⁿck, ohne zuvor die bereits gelesenen 
  76. Quelldaten bearbeitet zu haben.
  77.  
  78. Zu den Quelldaten ist zu bemerken, da▀ sΣmtliche NUL-Zeichen (0x00)
  79. ausgefiltert werden, d.h.  Sie k÷nnen NUL nur dann in den Eingabestrom
  80. einfⁿgen, wenn Sie den DESCR=D/S-Schalter spezifizieren und das NUL-Zeichen
  81. mit einer ESCape-Sequenz oder mit einer Eingabe-Ereignis-Beschreibung
  82. innerhalb spitzer Klammern umschreiben.
  83.  
  84.  
  85.  
  86. Implementationshinweis:  RawInsert verwendet die vom Autor geschriebenen
  87. Module CxLib (entspricht Commodore's cx.lib) und BlackMagic (universelles
  88. Modul - in RawInsert werden v.a.  dessen Routinenn fⁿr dynamische Strings
  89. verwendet)
  90.  
  91.  
  92.  
  93. RawInsert ist reentrant, 'pure'.  Da es zudem trotz seiner
  94. LeistungsfΣhigkeit ziemlich klein ist, wird empfohlen, es resident zu
  95. machen.  ('resident c:RawInsert')
  96.  
  97.  
  98.  
  99.                           Evolution von RawInsert
  100.  
  101.   v1.0 25-Jul-93 fSchwarz 
  102.   v1.0a 22-Nov-93 fSchwarz adapted to 3.0 interface modules
  103.   v1.1 24-Nov-93 fSchwarz now sets the timeStamp of the
  104.     InputEvents
  105.  
  106.  
  107.  
  108.  
  109. RawInsert ist Public Domain, d.h., es ist frei kopierbar und verwendbar,
  110. der Autor ⁿbertrΣgt das Urheberrecht am Programm der Allgemeinheit.  Eine
  111. wie auch immer geartete Haftung des Autors fⁿr SchΣden, die unmittelbar
  112. oder mittelbar von dem Gebrauch von RawInsert herrⁿhren, ist schon deshalb
  113. selbstverstΣndlich definitiv ausgeschlossen.  Die Verwendung von RawInsert
  114. erfolgt auf Ihr eigenes Risiko.  In angelsΣchsischem Jargon wird dies
  115. gemeinhin als 'Use At Your Own Risk' bezeichnet.
  116.  
  117.  
  118.  
  119.     RawInsert geschrieben und nicht urheberrechtlich geschⁿtzt, 1993 by
  120.        Franz Schwarz, Mⁿhlenstra▀e 2, D-78591 Durchhausen, Germany.
  121.                     uucp: Franz_Schwarz@mil.ka.sub.org
  122.  
  123.  
  124. Anregungen, Kritik, Flames, Geld, Gold, Disketten, Bier, Schokolade,
  125. nette Postkarten, e-mails, etc.  sind jederzeit herzlich
  126. willkommen!;-)
  127.  
  128.  
  129.     Bye
  130.       Franz 'Blacky' Schwarz
  131.  
  132.  
  133.                -Girlfriend Is Better - Talking Heads-
  134.  
  135.