BassEnc_Mp3BASS_Encode_MP3_StartFile Method

public static int BASS_Encode_MP3_StartFile(
	int handle,
	string options,
	BASSEncode flags,
	string filename
)

Public Shared Function BASS_Encode_MP3_StartFile ( 
	handle As Integer,
	options As String,
	flags As BASSEncode,
	filename As String
) As Integer

Parameters

handle

Type: SystemInt32
The channel handle... a HSTREAM, HMUSIC, or HRECORD.

options

Type: SystemString
Encoder options... =use defaults. The following LAME style options are supported:

-b, -B, -v, -V, -q, -m, --abr, --preset, --alt-preset, -Y, --resample, -p, -t, --tt, --ta, --tl, --ty, --tc, --tn, --tg, --ti, --tv, --add-id3v2, --id3v1-only, --id3v2-only, --pad-id3v2, --pad-id3v2-size, --noreplaygain. Anything else that is included will be ignored. See the LAME documentation for details on the aforementioned options and defaults.

flags

Type: Un4seen.Bass.AddOn.EncBASSEncode
A combination of these flags (see BASSEncode):

BASS_ENCODE_QUEUE	Queue data to feed the encoder asynchronously. This prevents the data source (DSP system or BASS_Encode_Write call) getting blocked by the encoder, but if data is queud more quickly than the encoder can process it, that could result in lost data.
BASS_ENCODE_LIMIT	Limit the data rate to real-time speed, by introducing a delay when the rate is too high. With BASS 2.4.6 or above, this flag is ignored when the encoder is fed in a playback buffer update cycle (including BASS_Update(Int32) and BASS_ChannelUpdate(Int32, Int32) calls), to avoid possibly causing playback buffer underruns. Except for in those instances, this flag is applied automatically when the encoder is feeding a Shoutcast or Icecast server.
BASS_ENCODE_CAST_NOLIMIT	Don't limit the data rate (to real-time speed) when sending to a Shoutcast or Icecast server.
BASS_ENCODE_PAUSE	Start the encoder paused.
BASS_ENCODE_AUTOFREE	Automatically free the encoder when the source channel is freed.

filename

Type: SystemString
Output filename... =no output file.

Return Value

BASS_Encode_StartUser(Int32, String, BASSEncode, ENCODERPROC, IntPtr) is used internally to apply the encoder to the source channel, so the remarks in its documentation also apply to this function.

Each tag should be in UTF-16 (as the BASS_UNICODE flag is used). Unicode tags can only be stored in ID3v2 tag blocks. An ID3v2 tags block will be added automatically when required by the tags; this can be changed in options.

MP3 encoding involves extensive floating-point operations, so it is not supported on platforms/architectures that do not have an FPU, eg. older ARM platforms/architectures.

Reference