home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsm / psionconv / ReadMe! < prev   
Text File  |  1995-04-13  |  6KB  |  146 lines
  1.  
  2. PsionConv - The Amazing Armadeus<->Psion 3a Sound Format Conversion Program
  3. ===========================================================================
  4.  
  5. Version 0.02 (13-Apr-95)
  6.  
  7. Are YOU the kind of person who sings Puff The Magic Dragon in pubs, and
  8. records it on your pocket organiser?
  9.  
  10. Are YOU the kind of person who cherishes the compliment your girlfriend
  11. sampled on your organiser in a hotel room at 5am?, the sample you always
  12. wanted your desktop machine to play as part of it's boot sequence?
  13.  
  14. Hmm... someone other than Piers and me must want this...
  15.  
  16. Err... allright then.. Do YOU have a collection of interesting sound samples
  17. recorded on your pocket organiser/computer, that you've always wanted to play
  18. on your Desktop machine?
  19.  
  20. Do YOU have a Psion 3a? (this is quite an important point I guess)
  21.  
  22. If any of the above apply to you, then you want this utility. Oh yes.
  23.  
  24.  
  25. PsionConv
  26. =========
  27.  
  28. Yup... it converts Psion 3a format WVE files to Armadeus files, and you can
  29. also convert Armadeus files to Psion 3a WVE files. Amazing.
  30.  
  31. You'll need a Acorn machine with SharedCLibrary 3.75 or greater in order to
  32. run PsionConv. I don't ask much.
  33.  
  34. Psion 3a WVE files are 13-bit a-Law format files - that is, they are a pain
  35. to convert to say the least.  But this does the job nicely, so you don't need
  36. to listen to the sob-story behind coding the thing.. just type the following
  37. (you might want to press F12 or something first)..
  38.  
  39. PsionConv -input ALAW file1 -output ARMADEUS file2
  40.  
  41. This converts Psion 3a WVE file 'file1' to Armadeus-format file 'file2'.
  42.  
  43. And, amazingly enough...
  44.  
  45. PsionConv -input ARMADEUS file1 -output ALAW file2
  46.  
  47. Will do the opposite.
  48.  
  49. Due to the amazing design of PsionConv,
  50.  
  51. PsionConv -input ARMADEUS file1 -output ARMADEUS file2
  52.  
  53. Will convert from an Armadeus file to an Armadeus file (always a handy thing
  54. to have in the house) wheras:
  55.  
  56. PsionConv -input ALAW file1 -output ALAW file2
  57.  
  58. Will generate a knackered 'file2'. That's a bug I can't be bothered to
  59. fix yet, but somehow it didn't seem too important to me at the time.
  60.  
  61. PsionConv -d gives a short description, and PsionConv -h gives help on
  62. command syntax.
  63.  
  64. And there you go... Actually, the internals of the program are quite nice -
  65. it's built from an internal project I had to do (I design Arcade machines
  66. which use different sound formats) and it's very easy to add support for
  67. transferring to and from different formats - all internal sound processing is
  68. at 32-bit signed level, and in theory you can convert from any one source
  69. format to multiple object formats at once (-output ALAW one WAV two
  70. ADPCM4MS three...though I doubt that works properly right now... never tried
  71. it)
  72.  
  73. Future Changes
  74. ==============
  75.  
  76. * Support for import and export to WAV format and others. Probably all of
  77. them eventually, especially the compressed ones because I have a bit of a
  78. sound compression fetish.
  79.  
  80. Note that due to the way the program is designed, you can convert from any
  81. format to any format, so it won't be just a Psion conversion program. My
  82. build of the program already does some formats which won't really be of
  83. interest to anyone outside the games machine industry.
  84.  
  85. Conversion to WAV and other 16-bit formats means that you don't lose quality
  86. during the conversion.. the initial 13->8 bit conversion when going to
  87. Armadeus is slightly lossy, but you'd be unlikely to notice it. There is no
  88. loss on further conversions between Armadeus<->Psion WVE format after the
  89. initial 13->8 bit conversion.
  90.  
  91. * Proper DeskTop front end... yeah right :-) Maybe.. we'll see.. the beauty
  92. of the source code at the moment is that it'll compile on any machine with an
  93. ANSI C compiler (even Acorn machines have one of those..:-) ).. Any front end
  94. I do will call PsionConv in the same way that DDE stuff calls appications.
  95.  
  96. * Name change...'¥' - The Application Formerly Known As PsionConv.
  97.  
  98. * Bugs to fix... Most definitely. One day.
  99.  
  100. * SpellCheck this ReadMe file, and add basic support for english grammar.
  101.  
  102.  
  103.    ***********************************
  104.    ***    C h a n g e   L i s t    ***
  105.    ***********************************
  106.    Date       Name   Description
  107.    ----       ----   -----------
  108.                      0.01
  109.    06-Apr-95  GSL    Started. Doesn't compile or work
  110.    06-Apr-95  GSL    Now it compiles
  111.    06-Apr-95  GSL    Now it works. Kinda.
  112.    10-Apr-95  GSL    Deleted the object files and recompiled - I was bored
  113.                      0.02
  114.    13-Apr-95  GSL    Armadeus replay rate now fully accurate
  115.                      Slight click at end of sample removed
  116.  
  117. NOTE: THIS APPLICATION IS 'I DON'T CARE-WARE'
  118. =============================================
  119.  
  120. You can do with it what you like. I don't particularly care. I hope you find
  121. it useful in some way. In honesty I got bored with it soon after I got it to
  122. compile, link and work roughly okay, and I had converted some of my more
  123. unusual ansaphone messages.
  124.  
  125. It also means that I don't accept responsibility for any loss, damage,
  126. injury, or death caused as a result of using this application or reading
  127. this file. I've run it lots of times and my machine hasn't caught fire yet.
  128.  
  129. If you have any problems with it, or want some improvements made, then
  130. contact me... I guess if people are interested then I might do something...
  131. you never know.
  132.  
  133. If anyone wants the A-Law conversion table generators then I'll oblige...
  134.  
  135. I can be contacted on Arcade (User #999 - Gareth S. Long) (groovesome BBS...
  136. You can get everything you want out of life from it :-) ) or on the net as
  137. gatch@elecslns.demon.co.uk.. You'll also find my account on Chaos, TWoC,
  138. DigiBank etc.
  139.  
  140. Hi to all of those I know, and dedicated to whom I know the most.
  141.  
  142. Have fun - and remember, if things don't change, they'll stay the same.
  143.  
  144. Get Funky
  145.  
  146. Gatch