seal 0.1.1 → 0.1.2

data/README.md

@@ -29,10 +29,20 @@ Change the position of the source:
 source.position = 3, 2, -4
 ```
 
+Or change the position of the source based on velocity:
+
+```ruby
+source.velocity = 1, 2, -1
+source.move # automatically add the velocity vector to the position vector
+```
+
 Change the position of the listener (a singleton of Seal::Listener):
 
 ```ruby
 Seal.listener.position = -1, -1, 0
+# ...
+Seal.listener.velocity = 3, 1, -1
+seal.listener.move
 ```
 
 Play the source:
@@ -69,6 +79,7 @@ Apply a reverberation effect to the sound source:
 
 ```ruby
 # Allocate an effect slot and associate a specific reverb object.
+# Here we are using a predefined reverb effect. See doc for `Reverb::Preset`.
 slot = EffectSlot.new(Reverb.new(Reverb::Preset::FOREST))
 # Start feeding the slot.
 source.feed(slot, 0)
@@ -115,6 +126,10 @@ seal_destroy_rvb(&rvb);
 seal_cleanup();
 ```
 
+For detailed documentation, refer to:  
+[http://rubydoc.info/gems/seal](http://rubydoc.info/gems/seal)  
+[zhang.su/seal](http://zhang.su/seal)  
+
 ## Platforms
 
 Linux, Windows and Mac OS X are officially tested and supported. Seal should
@@ -208,6 +223,10 @@ Use `rake demo:<demo_name>` to run the demos under the `demo/` directory.
 
     3D audio positioning (attenuation).
 
+-   doppler
+
+    Doppler Effect demonstration.
+
 -   reverb
 
     Audio reverberation. There are lots of built-in reverb presets, but this

data/include/seal/buf.h

@@ -35,14 +35,14 @@ extern "C" {
  *
  * @param buf   the buffer to initialize
  */
-seal_err_t seal_init_buf(seal_buf_t*);
+seal_err_t SEAL_API seal_init_buf(seal_buf_t*);
 
 /*
  * Destroys a buffer that is not currently used by any source.
  *
  * @param buf   the buffer to destroy
  */
-seal_err_t seal_destroy_buf(seal_buf_t*);
+seal_err_t SEAL_API seal_destroy_buf(seal_buf_t*);
 
 /*
  * Loads audio from a file to a buffer that is not currently used by any
@@ -54,7 +54,11 @@ seal_err_t seal_destroy_buf(seal_buf_t*);
  *                  audio format will be attempted if `fmt' is
  *                  `SEAL_UNKNOWN_FMT'
  */
-seal_err_t seal_load2buf(seal_buf_t*, const char* /*filename*/, seal_fmt_t);
+seal_err_t SEAL_API seal_load2buf(
+    seal_buf_t*,
+    const char* /*filename*/,
+    seal_fmt_t
+);
 
 /*
  * Copies raw PCM data to a buffer that is not currently used by any source.
@@ -63,7 +67,7 @@ seal_err_t seal_load2buf(seal_buf_t*, const char* /*filename*/, seal_fmt_t);
  * @param buf   the destination buffer to receive the copied data
  * @param raw   the source raw data to copy
  */
-seal_err_t seal_raw2buf(seal_buf_t*, seal_raw_t*);
+seal_err_t SEAL_API seal_raw2buf(seal_buf_t*, seal_raw_t*);
 
 /*
  * Gets the size, in bytes, of a buffer. The default is 0.
@@ -71,7 +75,7 @@ seal_err_t seal_raw2buf(seal_buf_t*, seal_raw_t*);
  * @param buf   the buffer to retrive the size of
  * @param psize the receiver of the size
  */
-seal_err_t seal_get_buf_size(seal_buf_t*, int* /*psize*/);
+seal_err_t SEAL_API seal_get_buf_size(seal_buf_t*, int* /*psize*/);
 
 /*
  * Gets the frequency (sample rate) of the audio contained in a buffer. The
@@ -80,7 +84,7 @@ seal_err_t seal_get_buf_size(seal_buf_t*, int* /*psize*/);
  * @param buf   the buffer to retrive the frequency of
  * @param pfreq the receiver of the frequency
  */
-seal_err_t seal_get_buf_freq(seal_buf_t*, int* /*pfreq*/);
+seal_err_t SEAL_API seal_get_buf_freq(seal_buf_t*, int* /*pfreq*/);
 
 /*
  * Gets the bit depth (bits per sample) of the audio contained in a buffer.
@@ -89,7 +93,7 @@ seal_err_t seal_get_buf_freq(seal_buf_t*, int* /*pfreq*/);
  * @param buf   the buffer to retrive the bit depth of
  * @param pbps  the receiver of the bit depth
  */
-seal_err_t seal_get_buf_bps(seal_buf_t*, int* /*pbps*/);
+seal_err_t SEAL_API seal_get_buf_bps(seal_buf_t*, int* /*pbps*/);
 
 /*
  * Gets the number of channels of the audio contained in a buffer. The default
@@ -98,7 +102,7 @@ seal_err_t seal_get_buf_bps(seal_buf_t*, int* /*pbps*/);
  * @param buf           the buffer to retrive the number of channels of
  * @param pnchannels    the receiver of the number of channels
  */
-seal_err_t seal_get_buf_nchannels(seal_buf_t*, int* /*pnchannels*/);
+seal_err_t SEAL_API seal_get_buf_nchannels(seal_buf_t*, int* /*pnchannels*/);
 
 /*
  * Loads an audio file and extracts the whole PCM data to memory. This is the
@@ -112,7 +116,11 @@ seal_err_t seal_get_buf_nchannels(seal_buf_t*, int* /*pnchannels*/);
  *                  audio format will be attempted if the passed-in `fmt' is
  *                  `SEAL_UNKNOWN_FMT'
  */
-seal_err_t seal_load(seal_raw_t*, const char* /*filename*/, seal_fmt_t);
+seal_err_t SEAL_API seal_load(
+    seal_raw_t*,
+    const char* /*filename*/,
+    seal_fmt_t
+);
 
 #ifdef __cplusplus
 }

data/include/seal/core.h

@@ -20,22 +20,22 @@ extern "C" {
  *
  * @param device_name   the name of a device; 0 to use the default one
  */
-seal_err_t seal_startup(const char* /*device_name*/);
+seal_err_t SEAL_API seal_startup(const char* /*device_name*/);
 
 /* Uninitializes Seal and invalidate all Seal objects. Thread-unsafe. */
-void seal_cleanup(void);
+void SEAL_API seal_cleanup(void);
 
 /*
  * @return  the maximum number of effect slots a source can feed concurrently.
  */
-int seal_get_per_src_effect_limit(void);
+int SEAL_API seal_get_per_src_effect_limit(void);
 
 /*
  * Gets the Seal version string.
  *
  * @return  the version string
  */
-const char* seal_get_version(void);
+const char* SEAL_API seal_get_version(void);
 
 #ifdef __cplusplus
 }
@@ -61,11 +61,17 @@ typedef void _seal_openal_getteri(unsigned int, int, int*);
 /* Common helpers. */
 unsigned int _seal_openal_id(void*);
 seal_err_t _seal_gen_objs(int, unsigned int*, _seal_openal_initializer_t*);
-seal_err_t _seal_delete_objs(int, const unsigned int*,
-                             _seal_openal_destroyer_t*);
+seal_err_t _seal_delete_objs(
+    int,
+    const unsigned int*,
+    _seal_openal_destroyer_t*
+);
 seal_err_t _seal_init_obj(void*, _seal_openal_initializer_t*);
-seal_err_t _seal_destroy_obj(void*, _seal_openal_destroyer_t*,
-                             _seal_openal_validator_t*);
+seal_err_t _seal_destroy_obj(
+    void*,
+    _seal_openal_destroyer_t*,
+    _seal_openal_validator_t*
+);
 seal_err_t _seal_setf(void*, int, float, _seal_openal_setterf*);
 seal_err_t _seal_getf(void*, int, float*, _seal_openal_getterf*);
 seal_err_t _seal_seti(void*, int, int, _seal_openal_setteri*);

data/include/seal/efs.h

@@ -31,14 +31,14 @@ typedef struct seal_efs_t seal_efs_t;
  *
  * @param efs   the effect slot to initialize
  */
-seal_err_t seal_init_efs(seal_efs_t*);
+seal_err_t SEAL_API seal_init_efs(seal_efs_t*);
 
 /*
  * Destroys an effect slot.
  *
  * @param efs   the effect slot to destroy
  */
-seal_err_t seal_destroy_efs(seal_efs_t*);
+seal_err_t SEAL_API seal_destroy_efs(seal_efs_t*);
 
 /*
  * Fills an effect slot with an effect object, then the effect Slot will
@@ -51,7 +51,7 @@ seal_err_t seal_destroy_efs(seal_efs_t*);
  * @param efs       the effect slot to fill
  * @param effect    the effect to fill the effect slot with
  */
-seal_err_t seal_set_efs_effect(seal_efs_t*, void* /*effect*/);
+seal_err_t SEAL_API seal_set_efs_effect(seal_efs_t*, void* /*effect*/);
 
 /*
  * Sets the output level of an effect Slot in the interval [0.0f, 1.0f]. A
@@ -60,7 +60,7 @@ seal_err_t seal_set_efs_effect(seal_efs_t*, void* /*effect*/);
  * @param efs   the effect slot to set the gain of
  * @param gain  the gain
  */
-seal_err_t seal_set_efs_gain(seal_efs_t*, float /*gain*/);
+seal_err_t SEAL_API seal_set_efs_gain(seal_efs_t*, float /*gain*/);
 
 /*
  * Sets whether the effect should have automatic adjustments based on the
@@ -69,7 +69,7 @@ seal_err_t seal_set_efs_gain(seal_efs_t*, float /*gain*/);
  * @param efs       the effect slot to set the auto adjust flag of
  * @param automatic 1 to set it auto adjust or otherwise 0
  */
-seal_err_t seal_set_efs_auto(seal_efs_t*, char /*automatic*/);
+seal_err_t SEAL_API seal_set_efs_auto(seal_efs_t*, char /*automatic*/);
 
 /*
  * Gets the effect object in an effect slot. The default is 0 (null pointer).
@@ -77,7 +77,7 @@ seal_err_t seal_set_efs_auto(seal_efs_t*, char /*automatic*/);
  * @param efs   the effect slot to get the effect object of
  * @return      the effect object
  */
-void* seal_get_efs_effect(seal_efs_t*);
+void* SEAL_API seal_get_efs_effect(seal_efs_t*);
 
 /*
  * Gets the output level of an effect Slot in the interval. The default is
@@ -86,7 +86,7 @@ void* seal_get_efs_effect(seal_efs_t*);
  * @param efs   the effect slot to get the gain of
  * @param pgain the receiver of the gain
  */
-seal_err_t seal_get_efs_gain(seal_efs_t*, float* /*pgain*/);
+seal_err_t SEAL_API seal_get_efs_gain(seal_efs_t*, float* /*pgain*/);
 
 /*
  * Determines if the effect is automatically adjusted. The default is true
@@ -95,7 +95,7 @@ seal_err_t seal_get_efs_gain(seal_efs_t*, float* /*pgain*/);
  * @param efs   the effect slot to determine
  * @param pauto the receiver of the auto adjust flag
  */
-seal_err_t seal_is_efs_auto(seal_efs_t*, char* /*pauto*/);
+seal_err_t SEAL_API seal_is_efs_auto(seal_efs_t*, char* /*pauto*/);
 
 /*
  *****************************************************************************

data/include/seal/err.h

@@ -7,6 +7,8 @@
 #ifndef _SEAL_ERR_H_
 #define _SEAL_ERR_H_
 
+#define SEAL_API
+
 enum seal_err_t
 {
     SEAL_OK,
@@ -68,7 +70,7 @@ extern "C" {
  * @param err   the error to get the message associated with
  * @return      the error message if there is any or otherwise 0
  */
-const char* seal_get_err_msg(seal_err_t);
+const char* SEAL_API seal_get_err_msg(seal_err_t);
 
 #ifdef __cplusplus
 }

data/include/seal/fmt.h

@@ -43,8 +43,10 @@ seal_err_t seal_recognize_fmt(const char* /*filename*/, seal_fmt_t* /*pfmt*/);
  *                  otherwise the file format is checked and `pfmt' receives
  *                  the known format
  */
-seal_err_t seal_ensure_fmt_known(const char* /*filename*/,
-                                 seal_fmt_t* /*pfmt*/);
+seal_err_t seal_ensure_fmt_known(
+    const char* /*filename*/,
+    seal_fmt_t* /*pfmt*/
+);
 
 #ifdef __cplusplus
 }

data/include/seal/listener.h

@@ -17,6 +17,13 @@
 extern "C" {
 #endif
 
+/*
+ * Moves the listener (changes the position) based on the listener velocity.
+ * This is a syntactic sugar for adding the velocity vector and position
+ * vector.
+ */
+seal_err_t SEAL_API seal_move_listener(void);
+
 /*
  * Sets the master scalar amplitude multiplier of the listener which applies
  * to all the sources. 1.0f means that the sound is unattenuated; 0.5f means
@@ -24,7 +31,7 @@ extern "C" {
  *
  * @param gain  the scalar amplitude multiplier in the interval [0.0f, +inf.)
  */
-seal_err_t seal_set_listener_gain(float /*gain*/);
+seal_err_t SEAL_API seal_set_listener_gain(float /*gain*/);
 
 /*
  * Sets the position of the listener in a right-handed Cartesian coordinate
@@ -34,7 +41,11 @@ seal_err_t seal_set_listener_gain(float /*gain*/);
  * @param y     the y position to set
  * @param z     the z position to set
  */
-seal_err_t seal_set_listener_pos(float /*x*/, float /*y*/, float /*z*/);
+seal_err_t SEAL_API seal_set_listener_pos(
+    float /*x*/,
+    float /*y*/,
+    float /*z*/
+);
 
 /*
  * Sets the velocity of the listener in a right-handed Cartesian coordinate
@@ -45,7 +56,11 @@ seal_err_t seal_set_listener_pos(float /*x*/, float /*y*/, float /*z*/);
  * @param y     the y velocity to set
  * @param z     the z velocity to set
  */
-seal_err_t seal_set_listener_vel(float /*x*/, float /*y*/, float /*z*/);
+seal_err_t SEAL_API seal_set_listener_vel(
+    float /*x*/,
+    float /*y*/,
+    float /*z*/
+);
 
 /*
  * Sets the orientation of the listener.
@@ -57,7 +72,7 @@ seal_err_t seal_set_listener_vel(float /*x*/, float /*y*/, float /*z*/);
  *              linearly independent, must not be NaN and must not be
  *              normalized. Otherwise, the operation is undefined
  */
-seal_err_t seal_set_listener_orien(float* /*orien*/);
+seal_err_t SEAL_API seal_set_listener_orien(float* /*orien*/);
 
 /*
  * Gets the gain of the listener. The default is 1.0f.
@@ -65,7 +80,7 @@ seal_err_t seal_set_listener_orien(float* /*orien*/);
  * @see         seal_set_listener_gain
  * @param pgain the receiver of the gain
  */
-seal_err_t seal_get_listener_gain(float* /*pgain*/);
+seal_err_t SEAL_API seal_get_listener_gain(float* /*pgain*/);
 
 /*
  * Gets the position of the listener. The default is ( 0.0f, 0.0f, 0.0f ).
@@ -75,7 +90,11 @@ seal_err_t seal_get_listener_gain(float* /*pgain*/);
  * @param py    the receiver of the y position
  * @param pz    the receiver of the z position
  */
-seal_err_t seal_get_listener_pos(float* /*px*/, float* /*py*/, float* /*pz*/);
+seal_err_t SEAL_API seal_get_listener_pos(
+    float* /*px*/,
+    float* /*py*/,
+    float* /*pz*/
+);
 
 /*
  * Gets the velocity of the listener. The default is ( 0.0f, 0.0f, 0.0f ).
@@ -85,7 +104,11 @@ seal_err_t seal_get_listener_pos(float* /*px*/, float* /*py*/, float* /*pz*/);
  * @param py    the receiver of the y velocity
  * @param pz    the receiver of the z velocity
  */
-seal_err_t seal_get_listener_vel(float* /*px*/, float* /*py*/, float* /*pz*/);
+seal_err_t SEAL_API seal_get_listener_vel(
+    float* /*px*/,
+    float* /*py*/,
+    float* /*pz*/
+);
 
 /*
  * Gets the orientation of the listener. The default is
@@ -95,10 +118,10 @@ seal_err_t seal_get_listener_vel(float* /*px*/, float* /*py*/, float* /*pz*/);
  * @param orien the array of a pair of 3-tuple that receives the 'at' vector
  *              and the 'up' vector
  */
-seal_err_t seal_get_listener_orien(float* /*orien*/);
+seal_err_t SEAL_API seal_get_listener_orien(float* /*orien*/);
 
 #ifdef __cplusplus
 }
 #endif
 
-#endif /* _SEAL_LISTENER_H_ */
+#endif /* _SEAL_LISTENER_H_ */

data/include/seal/rvb.h

@@ -177,14 +177,14 @@ extern "C" {
  *
  * @param reverb    the reverb object to initialize
  */
-seal_err_t seal_init_rvb(seal_rvb_t*);
+seal_err_t SEAL_API seal_init_rvb(seal_rvb_t*);
 
 /*
  * Destroys a reverb effect.
  *
  * @param reverb    the reverb to destroy
  */
-seal_err_t seal_destroy_rvb(seal_rvb_t*);
+seal_err_t SEAL_API seal_destroy_rvb(seal_rvb_t*);
 
 /*
  * Loads the specified reverb paramter preset into a reverb object.
@@ -192,7 +192,7 @@ seal_err_t seal_destroy_rvb(seal_rvb_t*);
  * @param reverb    the reverb to load the preset into
  * @param preset    the preset to load
  */
-seal_err_t seal_load_rvb(seal_rvb_t*, seal_rvb_preset_t);
+seal_err_t SEAL_API seal_load_rvb(seal_rvb_t*, seal_rvb_preset_t);
 
 /*
  * Sets the modal density of a reverb in the interval [0.0f, 1.0f]. The
@@ -202,7 +202,7 @@ seal_err_t seal_load_rvb(seal_rvb_t*, seal_rvb_preset_t);
  * @param reverb    the reverb to set the density of
  * @param density   the density
  */
-seal_err_t seal_set_rvb_density(seal_rvb_t*, float /*density*/);
+seal_err_t SEAL_API seal_set_rvb_density(seal_rvb_t*, float /*density*/);
 
 /*
  * Sets the diffusion of a reverb in the interval [0.0f, 1.0f]. The diffusion
@@ -214,7 +214,7 @@ seal_err_t seal_set_rvb_density(seal_rvb_t*, float /*density*/);
  * @param reverb    the reverb to set the diffusion of
  * @param diffusion the diffusion
  */
-seal_err_t seal_set_rvb_diffusion(seal_rvb_t*, float /*diffusion*/);
+seal_err_t SEAL_API seal_set_rvb_diffusion(seal_rvb_t*, float /*diffusion*/);
 
 /*
  * Sets the gain of a reverb in the interval [0.0f, 1.0f], or from -100 dB (no
@@ -227,7 +227,7 @@ seal_err_t seal_set_rvb_diffusion(seal_rvb_t*, float /*diffusion*/);
  * @param reverb    the reverb to set the gain of
  * @param gain      the gain
  */
-seal_err_t seal_set_rvb_gain(seal_rvb_t*, float /*gain*/);
+seal_err_t SEAL_API seal_set_rvb_gain(seal_rvb_t*, float /*gain*/);
 
 /*
  * Sets the high-frequency gain of a reverb in the interval [0.0f, 1.0f], or
@@ -240,7 +240,7 @@ seal_err_t seal_set_rvb_gain(seal_rvb_t*, float /*gain*/);
  * @param reverb    the reverb to set the high-frequency gain of
  * @param hfgain    the high-frequency gain
  */
-seal_err_t seal_set_rvb_hfgain(seal_rvb_t*, float /*hfgain*/);
+seal_err_t SEAL_API seal_set_rvb_hfgain(seal_rvb_t*, float /*hfgain*/);
 
 /*
  * Sets the decay time of a reverb in the interval [0.1f, 20.0f], typically
@@ -250,7 +250,7 @@ seal_err_t seal_set_rvb_hfgain(seal_rvb_t*, float /*hfgain*/);
  * @param reverb    the reverb to set the decay time of
  * @param time      the decay time
  */
-seal_err_t seal_set_rvb_decay_time(seal_rvb_t*, float /*time*/);
+seal_err_t SEAL_API seal_set_rvb_decay_time(seal_rvb_t*, float /*time*/);
 
 /*
  * Sets the high-frequency decay ratio, or the spectral quality of the decay
@@ -267,7 +267,7 @@ seal_err_t seal_set_rvb_decay_time(seal_rvb_t*, float /*time*/);
  * @param reverb        the reverb to set the decay high-frequency ratio of
  * @param ratio         the decay high-frequency ratio
  */
-seal_err_t seal_set_rvb_hfdecay_ratio(seal_rvb_t*, float /*ratio*/);
+seal_err_t SEAL_API seal_set_rvb_hfdecay_ratio(seal_rvb_t*, float /*ratio*/);
 
 /*
  * Sets the reflections gain, or the overall amount of initial reflections
@@ -287,7 +287,10 @@ seal_err_t seal_set_rvb_hfdecay_ratio(seal_rvb_t*, float /*ratio*/);
  * @param reverb    the reverb to set the reflections gain of
  * @param gain      the reflections gain
  */
-seal_err_t seal_set_rvb_reflections_gain(seal_rvb_t*, float /*gain*/);
+seal_err_t SEAL_API seal_set_rvb_reflections_gain(
+    seal_rvb_t*,
+    float /*gain*/
+);
 
 /*
  * Sets the reflections delay of a reverb in the interval [0.0f, 0.3f] (in
@@ -299,7 +302,10 @@ seal_err_t seal_set_rvb_reflections_gain(seal_rvb_t*, float /*gain*/);
  * @param reverb    the reverb to set the reflections delay of
  * @param delay     the reflections delay
  */
-seal_err_t seal_set_rvb_reflections_delay(seal_rvb_t*, float /*delay*/);
+seal_err_t SEAL_API seal_set_rvb_reflections_delay(
+    seal_rvb_t*,
+    float /*delay*/
+);
 
 /*
  * Sets the late gain, or the overall amount of later reverberation relative
@@ -314,7 +320,10 @@ seal_err_t seal_set_rvb_reflections_delay(seal_rvb_t*, float /*delay*/);
  * @param reverb    the reverb to set the late gain of
  * @param gain      the late gain
  */
-seal_err_t seal_set_rvb_late_gain(seal_rvb_t*, float /*gain*/);
+seal_err_t SEAL_API seal_set_rvb_late_gain(
+    seal_rvb_t*,
+    float /*gain*/
+);
 
 /*
  * Sets the late delay of a reverb in the interval [0.0f, 0.1f] (in second)
@@ -325,7 +334,10 @@ seal_err_t seal_set_rvb_late_gain(seal_rvb_t*, float /*gain*/);
  * @param reverb    the reverb to set the late delay of
  * @param delay     the late delay
  */
-seal_err_t seal_set_rvb_late_delay(seal_rvb_t*, float /*delay*/);
+seal_err_t SEAL_API seal_set_rvb_late_delay(
+    seal_rvb_t*,
+    float /*delay*/
+);
 
 /*
  * Sets the air absorption high-frequency gain of a reverb in the interval
@@ -341,7 +353,10 @@ seal_err_t seal_set_rvb_late_delay(seal_rvb_t*, float /*delay*/);
  * @param reverb    the reverb to set the air absorption gain of
  * @param gain      the air absorption high-frequency gain
  */
-seal_err_t seal_set_rvb_air_absorbtion_hfgain(seal_rvb_t*, float /*hfgain*/);
+seal_err_t SEAL_API seal_set_rvb_air_absorbtion_hfgain(
+    seal_rvb_t*,
+    float /*hfgain*/
+);
 
 /*
  * Sets the room rolloff factor of a reverb in the interval [0.0f, 10.0f]. It
@@ -369,7 +384,10 @@ seal_err_t seal_set_rvb_air_absorbtion_hfgain(seal_rvb_t*, float /*hfgain*/);
  * @param reverb    the reverb to set the room rolloff factor of
  * @param factor    the room rolloff factor
  */
-seal_err_t seal_set_rvb_room_rolloff_factor(seal_rvb_t*, float /*factor*/);
+seal_err_t SEAL_API seal_set_rvb_room_rolloff_factor(
+    seal_rvb_t*,
+    float /*factor*/
+);
 
 /*
  * Sets whether the high-frequency decay time automatically stays below a
@@ -385,7 +403,10 @@ seal_err_t seal_set_rvb_room_rolloff_factor(seal_rvb_t*, float /*factor*/);
  * @param reverb    the reverb to set the high-frequency decay limit flag of
  * @param limited   1 to set it limited or otherwise 0
  */
-seal_err_t seal_set_rvb_hfdecay_limited(seal_rvb_t*, char /*limited*/);
+seal_err_t SEAL_API seal_set_rvb_hfdecay_limited(
+    seal_rvb_t*,
+    char /*limited*/
+);
 
 /*
  * Gets the density of a reverb. The default is 1.0f.
@@ -394,7 +415,7 @@ seal_err_t seal_set_rvb_hfdecay_limited(seal_rvb_t*, char /*limited*/);
  * @param reverb    the source to get the density of
  * @param pdensity  the receiver of the density
  */
-seal_err_t seal_get_rvb_density(seal_rvb_t*, float* /*pdensity*/);
+seal_err_t SEAL_API seal_get_rvb_density(seal_rvb_t*, float* /*pdensity*/);
 
 /*
  * Gets the diffusion of a reverb. The default is 1.0f.
@@ -403,7 +424,10 @@ seal_err_t seal_get_rvb_density(seal_rvb_t*, float* /*pdensity*/);
  * @param reverb        the source to get the diffusion of
  * @param pdiffusion    the receiver of diffusion
  */
-seal_err_t seal_get_rvb_diffusion(seal_rvb_t*, float* /*pdiffusion*/);
+seal_err_t SEAL_API seal_get_rvb_diffusion(
+    seal_rvb_t*,
+    float* /*pdiffusion*/
+);
 
 /*
  * Gets the gain of a reverb. The default is 0.32f.
@@ -412,7 +436,7 @@ seal_err_t seal_get_rvb_diffusion(seal_rvb_t*, float* /*pdiffusion*/);
  * @param reverb    the source to get the gain of
  * @param pgain     the receiver of the gain
  */
-seal_err_t seal_get_rvb_gain(seal_rvb_t*, float* /*pgain*/);
+seal_err_t SEAL_API seal_get_rvb_gain(seal_rvb_t*, float* /*pgain*/);
 
 /*
  * Gets the high-frequency gain of a reverb. The default is 0.89f.
@@ -421,7 +445,7 @@ seal_err_t seal_get_rvb_gain(seal_rvb_t*, float* /*pgain*/);
  * @param reverb    the source to get the high-frequency gain of
  * @param phfgain   the receiver of the high-frequency gain
  */
-seal_err_t seal_get_rvb_hfgain(seal_rvb_t*, float* /*phfgain*/);
+seal_err_t SEAL_API seal_get_rvb_hfgain(seal_rvb_t*, float* /*phfgain*/);
 
 /*
  * Gets the decay time of a reverb. The default is 1.49f.
@@ -430,7 +454,7 @@ seal_err_t seal_get_rvb_hfgain(seal_rvb_t*, float* /*phfgain*/);
  * @param reverb    the source to get the decay time of
  * @param ptime     the receiver of the decay time
  */
-seal_err_t seal_get_rvb_decay_time(seal_rvb_t*, float* /*ptime*/);
+seal_err_t SEAL_API seal_get_rvb_decay_time(seal_rvb_t*, float* /*ptime*/);
 
 /*
  * Gets the high-frequency decay ratio of a reverb. The default is 0.83f.
@@ -439,7 +463,10 @@ seal_err_t seal_get_rvb_decay_time(seal_rvb_t*, float* /*ptime*/);
  * @param reverb    the source to get the high-frequency decay time of
  * @param pratio    the receiver of the high-frequency decay ratio
  */
-seal_err_t seal_get_rvb_hfdecay_ratio(seal_rvb_t*, float* /*pratio*/);
+seal_err_t SEAL_API seal_get_rvb_hfdecay_ratio(
+    seal_rvb_t*,
+    float* /*pratio*/
+);
 
 /*
  * Gets the reflections gain of a reverb. The default is 0.05f.
@@ -448,7 +475,10 @@ seal_err_t seal_get_rvb_hfdecay_ratio(seal_rvb_t*, float* /*pratio*/);
  * @param reverb    the source to get the reflections gain of
  * @param pgain     the receiver of the reflections gain
  */
-seal_err_t seal_get_rvb_reflections_gain(seal_rvb_t*, float* /*pgain*/);
+seal_err_t SEAL_API seal_get_rvb_reflections_gain(
+    seal_rvb_t*,
+    float* /*pgain*/
+);
 
 /*
  * Gets the reflections delay of a reverb. The default is 0.007f.
@@ -457,7 +487,10 @@ seal_err_t seal_get_rvb_reflections_gain(seal_rvb_t*, float* /*pgain*/);
  * @param reverb    the source to get the reflections delay of
  * @param pdelay    the receiver of the reflections delay
  */
-seal_err_t seal_get_rvb_reflections_delay(seal_rvb_t*, float* /*pdelay*/);
+seal_err_t SEAL_API seal_get_rvb_reflections_delay(
+    seal_rvb_t*,
+    float* /*pdelay*/
+);
 
 /*
  * Gets the late gain of a reverb. The default is 1.26f.
@@ -466,7 +499,7 @@ seal_err_t seal_get_rvb_reflections_delay(seal_rvb_t*, float* /*pdelay*/);
  * @param reverb    the source to get the late gain of
  * @param pgain     the receiver of the late gain
  */
-seal_err_t seal_get_rvb_late_gain(seal_rvb_t*, float* /*pgain*/);
+seal_err_t SEAL_API seal_get_rvb_late_gain(seal_rvb_t*, float* /*pgain*/);
 
 /*
  * Gets the late delay of a reverb. The default is 0.011f.
@@ -475,7 +508,7 @@ seal_err_t seal_get_rvb_late_gain(seal_rvb_t*, float* /*pgain*/);
  * @param reverb    the source to get the late delay of
  * @param pdelay    the receiver of the late delay
  */
-seal_err_t seal_get_rvb_late_delay(seal_rvb_t*, float* /*pdelay*/);
+seal_err_t SEAL_API seal_get_rvb_late_delay(seal_rvb_t*, float* /*pdelay*/);
 
 /*
  * Gets the air absorbtion high-frequency gain of a reverb. The default is
@@ -485,8 +518,10 @@ seal_err_t seal_get_rvb_late_delay(seal_rvb_t*, float* /*pdelay*/);
  * @param reverb    the source to get the gain of
  * @param phfgain   the receiver of the air absorbtion high-frequency gain
  */
-seal_err_t seal_get_rvb_air_absorbtion_hfgain(seal_rvb_t*,
-                                                 float* /*phfgain*/);
+seal_err_t SEAL_API seal_get_rvb_air_absorbtion_hfgain(
+    seal_rvb_t*,
+    float* /*phfgain*/
+);
 
 /*
  * Gets the room rolloff factor of a reverb. The default is 0.0f.
@@ -495,8 +530,10 @@ seal_err_t seal_get_rvb_air_absorbtion_hfgain(seal_rvb_t*,
  * @param reverb    the source to get the factor of
  * @param pfactor   the receiver of the room rolloff factor
  */
-seal_err_t seal_get_rvb_room_rolloff_factor(seal_rvb_t*,
-                                               float* /*pfactor*/);
+seal_err_t SEAL_API seal_get_rvb_room_rolloff_factor(
+    seal_rvb_t*,
+    float* /*pfactor*/
+);
 
 /*
  * Determines if the high-frequency decay of a reverb is limited. The default
@@ -506,7 +543,10 @@ seal_err_t seal_get_rvb_room_rolloff_factor(seal_rvb_t*,
  * @param reverb    the source to get the limited flag of
  * @param plimited  the receiver of the limited flag
  */
-seal_err_t seal_is_rvb_hfdecay_limited(seal_rvb_t*, char* /*plimited*/);
+seal_err_t SEAL_API seal_is_rvb_hfdecay_limited(
+    seal_rvb_t*,
+    char* /*plimited*/
+);
 
 #ifdef __cplusplus
 }