EQPro 1.5 Documentation

Introduction Properties Methods Events Constants Code Samples

EQPro's properties are used to give information about every aspect of every mixer device in the system, such as the number of mixers, input, output and advanced lines, plus the ability to change every possible property of any of these components.

ActiveLine As Long

Used to set or retrieve the active line ID.

EQPro's slider will be attached to this line.
Changes to the slider will be reflected to the line's value, and changes to the line's value will be reflected to the slider position.


ActiveLineName([ShotName As Boolean]) As String

Used to retrieve the active line name.

If the property is called with the ShortName parameter as True, it will return the short name version.


ActiveMixer As Integer

Sets or returns the active mixer index.

A system may have one or more sound cards installed and this property should be used to select the mixer from the available installed mixers. Every sound card, properly installed, should have its own mixer driver.

The property MixerCount will return the total number of mixers installed, being 0 the first mixer and MixerCount - 1 the last one.


ActiveMixerName As String

Returns the active mixer name.


AdvancedLinesCount As Integer

Returns the number, minus one, of advanced lines available in the active mixer.

Advanced lines are those that control some custom property or feature a sound card, such as the 3D Sound of the SoundBlaster AWE32/64.


AdvancedLinesDirection(idx As Integer) As DirectionConstants

Returns the direction, input or output, of the advanced line referenced by the idx value.


AdvancedLinesID(idx As Integer) As Long

Returns the ID of the advanced line referenced by the idx value.


AdvancedLinesList(idx As Integer, [ShortName As Boolean]) As String

Returns the name of the advanced line referenced by the idx value.

If the property is called with the ShortName parameter as True, it will return the short name version.


AdvancedLinesRange(idx As Integer) As Long()

Returns the range of valid values that the advanced line, referenced by the idx value can return.

This property returns an array, where:

AdvancedLinesRange(1) is the lowest value
AdvancedLinesRange(2) is the highest value


AdvancedLinesType(idx As Integer) As LineTypeConstants

Returns the type of the advanced line referenced by rge idx value.

The possible values are fader, switch and numeric.
Some non-standard, or proprietary line types other than the supported by EQPro will be available as numeric line types. It is not guaranteed that these special kind of lines will work with EQPro.


AdvancedLinesValue(idx As Integer) As Long

Returns the value of the advanced line referenced by the idx value.

This value will be in the range specified by the AdvancedLinesRange property.


HasMute(LineID As Long) As Boolean

Returns True whether if the line referenced by the LineID value supports muting.


InputLineCount As Integer

Returns the number, minus one, of available input lines.

Input lines are those that can be used as recording sources, such as the Microphone, Line In, etc..


InputLineID(idx As Integer) As Long

Returns the ID of the input line referenced by the idx value.


InputLineList(idx As Integer) As String

Returns the name of the input line referenced by the idx value.


Layout As Alignment

Sets or returns the layout of EQPro's slider.

The EQPro's slider supports two layouts: vertical and horizontal.


MixerCount As Integer

Returns the number, minus one, of available mixers installed.

Usually, every properly installed sound card should have its one mixer driver.
The ActiveMixer property can be used to make EQPro use one of the available installed mixers.

As a reference, you can see all the available mixer devices in the Multimedia Control Panel application.
Select START->Settings->Control Panel, double click the Multimedia icon and choose the Devices tab. Then, expand the Mixer Devices item to see a list of installed mixer drivers.


MixerList(idx As Integer) As String

Returns the name of the mixer device referenced by the idx value.


Mute As Boolean

Sets or returns the mute state of the ActiveLine.

Before changing the value of this property you should check if the ActiveLine supports muting by reading the value in the HasMute property:

EQProCtrl.HasMute(EQProCtrl.ActiveLine)

OutputLineCount As Integer

Returns the number, minus one, of available output lines.

Output lines are those that are used to produce some sort of audio output, such as the WaveOut, Speaker, LineOut, etc...


OutputLineID(idx As Integer) As Long

Returns the ID of the output line referenced by the idx value.


OutputLineList(idx As Integer) As String

Returns the name of the output line referenced by the idx value.


Panning As Integer

Sets or returns the panning value of the ActiveLine.

The value returned is a number from -100 to 100.
Where:

-100 is full panning to the left
0 is at its default center position
100 is full panning to the right


RaiseErrors As Boolean

Sets or returns whether EQPro should display its own error messages.

This property should be turned on (set to True) at development stages, then set it to False when the application will be distributed to end users.


RefreshPriority As Priority

Sets or returns how often EQPro should refresh it self and fetch the new values for every monitored line.


SelectForRecording As Boolean

Sets or returns whether the ActiveLine is a recording source.

Some sound cards, such as the Sound Blaster series support selecting multiple lines for recording, other sound cards will only accept one source at a time. For this type of sound cards, EQPro will handle automatically the dis-selection of any previously selected line in order to allow selecting a new one.


TickStyle As TickStyleConstants

Sets or returns the style of the tick markers on the EQPro's slider.


ToolTip As String

Sets or returns the text that will be displayed when the mouse pointer is over the control.


Value As Long

Sets or returns the value of the ActiveLine.


Version As String

Returns the internal version of the EQPro control.