home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 19 / AACD19.BIN / AACD / Programming / AWNP / AWNP-Docs / Sound.doc < prev    next >
Encoding:
Text File  |  2000-10-04  |  1.9 KB  |  72 lines
  1. Sound objects do not generate events
  2. -------------------------
  3.  
  4. Sound object parameters.
  5. -------------------------
  6.  
  7. FileName="path:file"
  8.  
  9. Specify the file file containing the audio data. This parameter MUST be given. Datatypes are used to generate the sound object.
  10.  
  11. Volume=NUM
  12.  
  13. The volume to play the sound at 0-64. Defaults to 64.
  14.  
  15. Period=NUM
  16.  
  17. The period for playback of the sound. Defaults to natural period for the sample.
  18.  
  19. Cycles=NUM
  20.  
  21. The amount of cycles of the sound to play. Defaults to 1.
  22.  
  23. Definition Reply
  24. -----------------
  25.  
  26.  When the object creation is successful the pipe replies with
  27.  
  28. 'ok GID'
  29.  
  30. Sound object modify parameters.
  31. -------------------------
  32.  
  33. Period=NUM
  34.  
  35. The period for playback of the sound.
  36.  
  37. Volume=NUM
  38.  
  39. The volume to play the sound at 0-64. Defaults to 64.
  40.  
  41. NOTE: To work around a pre-ADOS 3.5 sound.dataype bug you can change the volume or frequency at the same time playback is triggered.
  42.  
  43. topipe('ID soundGID Volume new_volume Period new_period S 2')
  44.  
  45. Under OS3.5 volume and frequency can  be changed any time, but period may not work as expected.
  46.  
  47. Selected=TriggerMethod   (s=)
  48.  
  49. Cause the sound object to react. Most sound objects only support the trigger method Play (2) and method Stop (14).
  50.  
  51. Some other trigger methods for future compatability.
  52.  
  53. PAUSE        1
  54. PLAY        2
  55. REWIND        12
  56. FASTFORWARD    13
  57. STOP        14
  58. RESUME        15
  59.  
  60. Select is replied to with 'ok RESULT' where result =1 when the trigger method was supported and result=0 when it is not supported.
  61.  
  62. NOTE: Trigger method 14 (stop) appears to be broken under ADOS 3.x and can hang the system. It should not use it at present.
  63.  
  64. FreeSound
  65.  
  66. FreeSound will dispose of the sound object. Under ADOS 3.1 the command may wait until the sound finishes playing. Under ADOS 3.5 the sound is stopped immedaitly and the object freed.
  67.  
  68. Sound objects are disposed of automaticaly when the GUI host is closed. Uses this function when it is better to free the sound object sooner.
  69.  
  70.  
  71.  
  72.