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.

Syntax

[Visual Basic]

Public Function EnableInternalEncoders (

bEnable as Boolean

)

[C#]

public void EnableInternalEncoders (

bool bEnable

);

[C++]

public: void EnableInternalEncoders (

bool bEnable

);

Parameter

Description

bEnable

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

Supported values are the following:

Value

Meaning

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.

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