Methods > Init and info > EnableInternalEncoders method

Remarks

Enables/disables the usage of internal encoders for MP3, Ogg Vorbis and Opus formats.

When internal encoders are enabled, which is the default behaviour starting from version 11 of the component, the encoding speed is around 60% faster.

IMPORTANT: Internal encoders are not compatible with a stereo recording session which splits the input audio data into two separate files as seen for the StartSplitFromDirectSoundDevice, StartSplitFromWasapiCaptureDevice, StartSplitFromWasapiLoopbackDevice and any other splitting method: in this case external encoders still need to be available.

Syntax

[Visual Basic]

control.EnableInternalEncoders (

bEnable as enumBoolean

)

[C++]

void control.EnableInternalEncoders (

short bEnable

);

Parameter

Description

bEnable

Boolean value that specifies if the control must enable internal encoders.

Supported values are the following:

Value

Meaning

BOOL_FALSE

Disable internal encoders and use the external encoders Lame.exe (for MP3 format), OggEnc.exe (for OGG Vorbis format) and OpusEnc.exe (for Opus format): this was the default behaviour up to version 10 of the component.

BOOL_TRUE (default)

Enable internal encoders.

When internal encoders are enabled, the following properties are ignored:

- EncodeFormats.MP3.EncodeMode set to MP3_ENCODE_CUSTOM

- EncodeFormats.MP3.CustomString

- EncodeFormats.MP3.Downmix

- EncodeFormats.OGG.EncodeMode set to OGG_ENCODE_CUSTOM

- EncodeFormats.OGG.CustomString

- EncodeFormats.OGG.Downmix

- EncodeFormats.OGG.ResampleFrequency

- EncodeFormats.OPUS.EncodeMode set to OPUS_ENCODE_CUSTOM

- EncodeFormats.OPUS.CustomString

- EncodeFormats.OPUS.DownmixMode

Return value

None