Welcome to AuSIM; leaders in 3D sound technology
Home < Support < Tech < CRE API < CRE_TRON Function Details
CRE_TRON API
Application Programming Technical Details
  • cre_init
      int cre_init (int driver, int head, int sources, int mode);
              
    Initializes the AuSIM3D renderer with the designated driver type ("driver"), allocating resources to support the designated listener ("head") with the specified number of sound sources ("sources"). 
    • driver
      Historically, the "driver" parameter selected the DSP binary to download to the DSP silicon.  AuSIM systems recognize all of the CRE driver types and emulates them.  Additional new AuSIM driver types extend functionality to new sample rates and other features.
    • head
      The "head" parameter specifies which listener is being initialized.  The CRE_TRON API supports as many listeners in a shared virtual aural environment as the hardware will support.  AuSIM allows listeners to be initialized in any order.  A head ID of "0" allocates the first pair of audio outputs. 
    • sources
      The "sources" parameter specifies how many sound sources in the aural environment that the specified listener will be listening to.  The total number of sound sources in a shared virtual aural environment will be the max of all listeners initialized. 
    • mode
      The "mode" parameter controls advanced features of initialization and client-server settings.  Please see the AuSIM user guide for details. 
  • cre_close
      int cre_close (int driver, int head);
              
    Closes the open simulation session, either all or by driver/listener combination. 
  • cre_update_audio
      int cre_update_audio (void);
              
    Many object properties are cached in the server until the end of a simulation frame.  Demarks the end of a frame and thus synchronizes all property changes since the last frame to be set into the audio stream simultaneously. 
  • cre_define_head
      int cre_define_head (int id, int prm, int pts, const void *data);
              
    Sets properties for the given listener object. 
  • cre_locate_head
      int cre_locate_head (int id, const float *hloc);
              
    Sets listener object position and orientation. 
  • cre_select_source
      int cre_select_source (int id, int input);
              
    Selects a signal source for a sound source.  The parameter input = -1 selects no real-time channel.  Wavefiles may be mixed independent of this selection. 
  • cre_define_source
      int cre_define_source (int id, int prm, int pts, const void *data);
              
  • cre_locate_source
      int cre_locate_source (int id, const float *sloc);
              
    Sets properties for the given sound source object. 
  • cre_amplfy_source
      int cre_amplfy_source (int id, float dB);
              
    Sets the gain relative to zero decibels (0 dB) for the given sound source. 
  • cre_define_medium
      int cre_define_medium (int id, int prm, int pts, const void *data);
              
    Sets properties for the given propagation medium object. 
Footer Bar
AuSIM Inc., the experts in 3D sound [Home] [About AuSIM] [Products] [Services] [Applications]

[Support] [Contacts] [Buy Online] [Downloads] [News & Events]
© AuSIM Inc. 1998-2011.    Last updated on