

        A program to play sound data in the clipboard
                  Cliplay Version 1.00a
             Copyright (C) 1995 Hiroyuki Sekiya


[1] What is Cliplay?

  Cliplay is a playback program for sound data, to be used
  in combination with the Database, with the same style as
  MAPPOT does for graphic data.  It directly plays the sound
  data copied to the clipboard, or indirectly from the file
  specified in the clipboard.  Sound data format is the same as
  .SND files used by the ApptBook, a built-in application of
  the 100/200LX.


[2] Hardware/Software Requirement

  Cliplay runs on the System Manager of the 100/200LX.


[3] Installation

  Add this program to AppManager or MoreEXM.  You can use any
  start key.  My recommendation is [Alt]+(any numeric key), not
  used by other applications.  Let us assume that [Alt]+[8] is
  assigned.

  Cliplay displays a music note in the center of the screen to
  indicate that the sound playback is on.  Since a blank
  background in this case is not very attractive, you may want
  to activate 'suppress clear-screen' option of MoreEXM.  Add
  the following line to MOREEXM.INI:
      a:\bin\cliplay.exm,7F00,1,Cliplay
  where '7F00' is a key code for [ALT]+[8] as its start key and
  '1' is 'suppress clear-screen' option.


[4] Playback of the data in the clipboard

  You can make a first trial as follows:
   - Start Memo editor
   - Enter "CDEFGABC+", and COPY it to the clipboard.
   - Press [ALT]+[8] and you should hear the sound.
  This is an example of the most basic usage of Cliplay.  It
  reads the text in the clipboard, interprets it as sound data
  and plays it back.

  Since Cliplay ignores the Line Feed code, it can play long
  sound data spanning several lines.  The maximum length of the
  data is the same as for ApptBook, normally 512 bytes.


[5] Playback from the file specified in the clipboard

  You can make Cliplay to play the sound data stored in a file,
  by copying its filename to the clipboard. You should put
  "SND:" (all in upper case) in front of the filename before
  copying, as follows.
          SND:c:\_dat\alarm.snd

  You can specify the default directory name used by the
  Cliplay.  Create an environment file named CLIPLAY.ENV in
  A:\_DAT or C:\_DAT and write the directory name in it, then
  you can skip the directory name as follows:
          SND:sample.snd

  If "a:\snd" is written in CLIPLAY.ENV in this case, then
  Cliplay plays from a:\snd\sample.snd.


[6] To interrupt the playback

  Pressing any key during the playback will make Cliplay to
  stop playing the sound and quit running.


[7] Advanced usage -- Creation of a sound database --

  You can easily create an alarm sound database, by combining
  NoteTaker and Cliplay.  You can enter the title of the
  music to "Title" box, its genre (rock, classic, pop, etc)
  to "Category" and its sound data to "Note".  Please ignore
  the word wrapping within Note window.  You can also import
  from other sound data files by pressing [F3](Note) to
  maximize the Note window, and then [F3](Insert).

  If you use EXkey, you can replay a music database item with
  one key stroke.  Make a setup as follows.

      1) Press [f5](Clip) within NoteTaker, make the following
         SmartClip and save as "Cliplay".
             >Note<
      2) Add the following macro to exkey.ini
             <NoteTaker>
             {Fn+p}={F5}c{F10}{Alt+8}
                 Note: This <NoteTaker> line -- conditional
                 substitution of EXkey -- works only if you are
                 using JKIT (Japanese language kit).  Remove
                 this line in other cases.
      3) Reboot the system and you can replay the current
         item by pressing [Fn]+[P].

  To create an ApptBook sound file from this database, a System
  Macro such as
          {F3}{F2}c:\_dat\alarm.snd{F10}{Esc}
  does not work as expected, since the ApptBook does not permit
  Line Feed code within its SND file.  Long data are truncated.
  The program cb2snd.exm, included in this package, was created
  to overcome this drawback. This program reads the text
  stored in the clipboard, removes Line Feed codes from it and
  saves it to c:\_dat\alarm.snd. Add cb2snd.exm with [ALT]+[9]
  as its start key and add the following line to your
  exkey.ini:
          {Fn+s}={F5}c{F10}{Alt+9}
  Then you can save the current sound data to alarm.snd by
  pressing [Fn]+[S].


[8] Copyright, disclaimer and distribution policy

  This program is a copyrighted freeware.  Its copyright is
  owned by its author, Hiroyuki Sekiya.  You can freely copy
  and use it for your non-commercial and private use.

  Prior permission from the author is necessary, if you want to
  post it on other information services, web sites, FTP sites,
  or similar locations, or to include it in electronic storage
  media.  Please contact the author by e-mail in such cases.

  The author is in no way responsible for any damages, which
  may be caused by using, or by inability to use, this
  software.


[9] History of this software

  This software was originally developed as one of the 9 new
  programs bundled with the book "HP200LX Software Bible",
  co-authored by Hiroyuki Sekiya and Hirotaka Hamada, published
  by Softbank, Tokyo, in April 1996 (ISBN4-89052-911-X).  As
  such, the programs should not be distributed on networks nor
  regarded as freeware.  In short, you needed to buy the book
  to use them.

  Fortunately the book received an enthusiastic acceptance
  within the HP200LX user community in Japan and it reached an
  out-of-print status two years after its publication, in 1998.
  Now that the book is no more available easily, the author of
  these programs decided to release them as copyrighted
  freeware.


[10] Contact address of the author

  The author of this program, Hiroyuki Sekiya, can be contacted
  at the following addresses.

  E-Mail:
    hiroyuki.sekiya@nifty.ne.jp
    JBD00432@nifty.ne.jp
    SDI00992@nifty.ne.jp
  WWW:
    http://member.nifty.ne.jp/~sekiya/


                                                Hiroyuki Sekiya



                                Translated from the Japanese by
                                Toshiki Sasabe
                                toshiki@j.email.ne.jp

    Note from the translator:
    This document is a translation of the original Japanese
    document cliplay.txt (included in this package as
    cliplay.jpn).

