CRE_TRON API Details

CRE_TRON^TM API 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.

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.

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.

int cre_define_medium (int id, int prm, int pts, const void *data);

Sets properties for the given propagation medium object.

cre_open_wave
```
wavFt *cre_open_wave (const char *wavefile, int mode);
```
Opens the specified wavefile with the given mode. Returns a handle to the wavefile.

cre_ctrl_wave
```
int cre_ctrl_wave (int src, wavFt *wave, int cmd, void *data);
```
Controls the play, loop, rewind, seek, etc. of a wavefile on a particular sound source.

cre_close_wave
```
int cre_close_wave (wavFt *wave);
```
Closes the specified wavefile.


	Products	Search	Last update: 26 Sep 2002