Skip to content

Commit

Permalink
fix(docstring): #10
Browse files Browse the repository at this point in the history
  • Loading branch information
brglng committed Jul 17, 2024
1 parent c2d3144 commit fc64b1a
Showing 1 changed file with 6 additions and 6 deletions.
12 changes: 6 additions & 6 deletions include/wave.h
Original file line number Diff line number Diff line change
Expand Up @@ -128,7 +128,7 @@ typedef struct _WaveFile WaveFile;
*
* @param filename The name of the wav file
* @param mode The mode for open (same as {fopen})
* @return NULL if the memory allocation for the {WaveFile} object failed. Non-NULL means the memory allocation succeeded, but there can be other errors, which can be obtained using {wave_errno} or {wave_error}.
* @return NULL if the memory allocation for the {WaveFile} object failed. Non-NULL means the memory allocation succeeded, but there can be other errors, which can be obtained using {wave_err}.
*/
WAVE_API WaveFile* wave_open(WAVE_CONST char* filename, WaveU32 mode);
WAVE_API void wave_close(WaveFile* self);
Expand Down Expand Up @@ -177,39 +177,39 @@ WAVE_API int wave_flush(WaveFile* self);
*
* @param self The {WaveFile} object
* @param format The format code, which should be one of `WAVE_FORMAT_*`
* @remarks All data will be cleared after the call. {wave_errno} can be used to get the error code if there is an error.
* @remarks All data will be cleared after the call. {wave_err} can be used to get the error code if there is an error.
*/
WAVE_API void wave_set_format(WaveFile* self, WaveU16 format);

/** Set the number of channels
*
* @param self The {WaveFile} object
* @param num_channels The number of channels
* @remarks All data will be cleared after the call. {wave_errno} can be used to get the error code if there is an error.
* @remarks All data will be cleared after the call. {wave_err} can be used to get the error code if there is an error.
*/
WAVE_API void wave_set_num_channels(WaveFile* self, WaveU16 num_channels);

/** Set the sample rate
*
* @param self The {WaveFile} object
* @param sample_rate The sample rate
* @remarks All data will be cleared after the call. {wave_errno} can be used to get the error code if there is an error.
* @remarks All data will be cleared after the call. {wave_err} can be used to get the error code if there is an error.
*/
WAVE_API void wave_set_sample_rate(WaveFile* self, WaveU32 sample_rate);

/** Get the number of valid bits per sample
*
* @param self The {WaveFile} object
* @param bits The value of valid bits to set
* @remarks If {bits} is 0 or larger than 8*{sample_size}, an error will occur. All data will be cleared after the call. {wave_errno} can be used to get the error code if there is an error.
* @remarks If {bits} is 0 or larger than 8*{sample_size}, an error will occur. All data will be cleared after the call. {wave_err} can be used to get the error code if there is an error.
*/
WAVE_API void wave_set_valid_bits_per_sample(WaveFile* self, WaveU16 bits);

/** Set the size (in bytes) per sample
*
* @param self The WaveeFile object
* @param sample_size Number of bytes per sample
* @remarks When this function is called, the {BitsPerSample} and {ValidBitsPerSample} fields in the wav file will be set to 8*{sample_size}. All data will be cleared after the call. {wave_errno} can be used to get the error code if there is an error.
* @remarks When this function is called, the {BitsPerSample} and {ValidBitsPerSample} fields in the wav file will be set to 8*{sample_size}. All data will be cleared after the call. {wave_err} can be used to get the error code if there is an error.
*/
WAVE_API void wave_set_sample_size(WaveFile* self, size_t sample_size);

Expand Down

0 comments on commit fc64b1a

Please # to comment.