Sets up an Ogg Vorbis encoder on a channel, writing the output to a file.
HENCODE BASS_Encode_OGG_StartFile( DWORD handle, char *options, DWORD flags, char *filename );
handle | The channel handle... a HSTREAM, HMUSIC, or HRECORD. |
options | Encoder options... NULL = use defaults. The following OGGENC style options are supported: -b / --bitrate, -m / --min-bitrate, -M / --max-bitrate, -q / --quality, -s / --serial, -t / --title, -a / --artist, -G / --genre, -d / --date, -l / --album, -N / --tracknum, -c / --comment. See the OGGENC documentation for details on the aforementioned options and defaults. Also available is a "--picture" option that is the same as the FLAC and OPUSENC encoders option of the same name, and a "--no-reorder" option to disable reordering channels to the Vorbis specification's order. Anything else that is included will be ignored. |
flags | The flags supported by BASS_Encode_StartUser may be used here, but the floating-point conversion flags are ignored. |
filename | Output filename... NULL = no output file. |
BASS_ERROR_HANDLE | handle is not valid. |
BASS_ERROR_FORMAT | The channel's sample format is not supported by the encoder. |
BASS_ERROR_CREATE | The file could not be created. |
BASS_ERROR_MEM | There is insufficient memory. |
BASS_ERROR_NOTAVAIL | This function is not available on platforms/architectures without an FPU. |
BASS_ERROR_UNKNOWN | Some other mystery problem! |
Tags/comments should be in UTF-8 form. This function will take care of that when the BASS_UNICODE flag is used, but otherwise you will need to make sure that any tags included in options are UTF-8 (not ISO-8859-1/etc).
BASS_Encode_IsActive, BASS_Encode_SetNotify, BASS_Encode_SetPaused, BASS_Encode_Stop, BASS_Encode_Write, BASS_CONFIG_ENCODE_PRIORITY