The DXVUMeterNETGDI type exposes the following members.
Constructors
Name | Description | |
---|---|---|
DXVUMeterNETGDI | Initializes a new instance of the DXVUMeterNETGDI class |
Methods
Name | Description | |
---|---|---|
DTMFToneToValue |
This function converts a tone into its corresponding string value.
| |
FFTAverageFromFrequency |
Returns the average power at a given frequency
| |
FFTAverageFromIndex |
Returns the average power at a given frequency
| |
FFTIdx2Freq |
Returns the frequency at the given FFT index
| |
FFTIdx2X |
Returns the "x" (horizontal) position within the control's graphic area given the FFT index
| |
FFTPowerFromIndex |
Returns the frequency response at a given FFT index
| |
Freq2FFTIdx |
Returns the FFT index for a given frequency
| |
LicenseControl |
This subroutine must be called in order to "register" the control and prevent it from displaying the "DEMO" message.
| |
NormalizeBuffer |
Converts an array of bytes into an array of integers with values ranging from -32768 to 32767
This function is used, internally by the control, but you may also use it when handling the PeakValues event.
| |
PausePlaying | Pauses the playback | |
SetCustomBufferProvider |
This is an advanced feature that allows you to use your own buffer provider.
When a custom provider is set, DXVUMeterNETGDI will query the provider to obtain the buffer data, instead of using its internal audio monitoring routines.
This can be useful if your application is gathering the buffer data from a non standard source or if, for example, you want to plot some data that is not directly provided by a sound card.
| |
StartMonitoring | Starts monitoring and rendering the monitored audio | |
StartPlaying |
Starts playing the file passed as a parameter
| |
StartRecording |
Starts recording so the monitored audio will be saved into the file passed as a parameter
NOTE: DXVUMeterNETGDI uses the LAME encoder to encode the PCM audio into MP3 format.
Please refer to http://www.mp3dev.org/ for more information about the LAME encoder.
| |
StopMonitoring | Stops monitoring and rendering | |
StopPlaying | Stops playing | |
StopRecording | Stops recording |
Fields
Name | Description | |
---|---|---|
Devices | Collection of devices, that can record audio, currently available on the system |
Properties
Name | Description | |
---|---|---|
BitDepth | Sets or returns the quality at which the audio will be monitored | |
Channels | Sets or returns the number of chanels to monitor (1 for mono and 2 for stereo) | |
EnableRendering | Enables or disables the internal rendering engine | |
FFTDetectDTMF | When enabled and when the Style property is set to FFT, the control will raise a DTMFToneDown event when a DTMF tone is detected | |
FFTHistorySize | Sets or returns the size of the data history used to render the FFT | |
FFTHoldMaxPeaks | When enabled, the FFT will hold the highest peaks for a few milliseconds
This setting is valid for all FFTPStyle values
| |
FFTHoldMinPeaks |
When enabled, the FFT will hold the lowest peaks for a few milliseconds
This setting is only valid for the FFTStyleConstants.Line FFTPStyle
| |
FFTLineChannelMode | Sets or returns the style used to render Fast Fourier Transform when in Line mode | |
FFTPeaksDecayDelay |
Controls the decay delay for the peaks
| |
FFTPeaksDecaySpeed |
Controls the decay speed for the peaks
| |
FFTPlotNoiseReduction |
This option can be useful to reduce the visual noise that can be generated
when rendering a zoomeded plot in log scale
This setting is only valid for the FFTStyleConstants.Line and FFTStyleConstants.Filled styles
| |
FFTRenderScales |
Sets or returns which scales to render while in FFT mode
| |
FFTScaleFont |
Sets or retrieves the font used in the FFT scale
| |
FFTShowDecay |
When enabled, the the FFT will leave a small trail behind as it changes
This setting is only valid for the FFTStyleConstants.Line FFTPStyle
| |
FFTShowMinMaxRange |
When enabled, the FFT will display a shaded area showing the valleys and peaks
This setting is only valid for the FFTStyleConstants.Line FFTPStyle
| |
FFTSize | Sets or returns the size (bands) of the Fast Fourier Transform | |
FFTSmoothing |
This option controls the smoothing ammount applied to the FFT waveform
This setting is only valid for the FFTStyleConstants.Line and FFTStyleConstants.Filled styles
| |
FFTStyle | Sets or returns the every time | |
FFTWindow | Sets or returns the windowing type used to render the Fast Fourier Transform | |
FFTXMax |
Sets or returns the maximum frequency to be displayed
| |
FFTXMin |
Sets or returns the minimum frequency to be displayed
| |
FFTXScale | Sets or returns the style used to render the X (time) scale | |
FFTXZoom |
When enabled, the rendered FFT range will occupy the whole width of the control
| |
FFTXZoomWindowPos | ||
FFTYScale | Sets or returns the style used to render the Y (level) scale | |
Frequency | Sets or returns the frequency at which the audio will be monitored | |
GreenOff | Sets or returns the inactive low-level color of the monitored audio | |
GreenOn | Sets or returns the active low-level color of the monitored audio | |
LinesThickness |
Sets or returns the thickness of the lines used to render the Oscilloscope and the
FFT when using the Line style
| |
MonitoringState | Returns the monitoring state of the control | |
NumVUs | ||
Orientation | ||
PlaybackPosition | This property sets or returns the playback position within the file | |
PlaybackPositionTotal | This property returns the total size of the audio data in the file | |
PlaybackState | Returns the playback state of the control | |
PlaybackTime | This property sets or returns the current playback position within the file in hh:mm:ss format | |
PlaybackTimeTotal | Returns the total playback time in hh:mm:ss format | |
PlaybackVolume | This property can be used to adjust the volume of the Playback without affecting the Main/Wave output volumes of the sound card | |
RecordingState | Returns the recording state of the control | |
RecordingTime | Returns the total recording time in hh:mm:ss format | |
RedOff | Sets or returns the inactive high-level color of the monitored audio | |
RedOn | Sets or returns the active high-level color of the monitored audio | |
State | Returns the state of the control | |
Style | Sets or returns the rendering style that will be used to represent the audio being monitored | |
Version | Returns the control's version number | |
WAVHistorySize | Sets or returns the size of the input data (audio signal) history used to generate the FFT | |
YellowOff | Sets or returns the inactive middle-level color of the monitored audio | |
YellowOn | Sets or returns the active middle-level color of the monitored audio |
Events
Name | Description | |
---|---|---|
ControlIsReady |
Occurs when the control has finished loading and initializing
| |
DTMFToneDown |
Occurs when a DTMF is detected
| |
DTMFToneUp |
Occurs when a previously detected DTMF is lost
| |
Error | Occurs every time the control encounters a problem | |
FFTFrame | ||
MonitoringStateChanged | Occurs every time the monitoring state of the control changes | |
PaintGDI |
When the Style property is set to UserPaintGDI this event will be fired when the control needs to be painted
| |
PeakValues |
Occurs every time a new chunk of audio is monitored
| |
PlaybackStateChanged | Occurs every time the playback state of the control changes | |
RecordingStateChanged | Occurs every time the recording state of the control changes |