speech-dispatcher: Sound Icons in C

 
 4.1.5 Sound Icons
 -----------------
 
  -- C API function: int spd_sound_icon(SPDConnection* connection,
           SPDPriority priority, const char* icon_name);
 
      Sends a sound icon ICON_NAME. These are symbolic names that are
      mapped to a sound or to a text string (in the particular language)
      according to Speech Dispatcher tables and user settings.  Each
      program can also define its own icons.
 
      'connection' is the SPDConnection* connection created by
      spd_open().
 
      'priority' is the desired priority for this message.  ⇒Message
      Priority Model (ssip)Top.
 
      'icon_name' is the name of the icon.  It can't contain spaces,
      instead use underscores ('_').  Icon names starting with an
      underscore are considered internal and shouldn't be used.