SaveAudio method (IDicomWaveformGroup Interface)

VB.NET example

C# example

Visual Basic example

Visual C++ 6.0 example

 

Syntax

short SaveAudio(BSTR bstrFilename, short nFlags);

Overview

Refer to Working with DICOM Waveforms.

Remarks

The SaveAudio method creates an audio (wave) file from the channels in the waveform group.

This method is very useful for extracting audio (wave) data from a DICOM object of type "Basic Voice Audio" (1.2.840.10008.5.1.4.1.1.9.4.1), which is typically used for report dictation.

The resulting wave file has the following characteristics:

Number of channels: This will be either 1 or 2, depending on the number of channels in the waveform group. The Count property (IDicomWaveformChannels), accessed through the Channels property (lDicomWaveformGroup) contains the number of channels in the waveform group.

Bits per sample (sample size) will always be 8.

Samples per second (sampling rate): This will be the same as the sampling frequency for the waveform group, which is specified by the SamplingFrequency property.

Format category: PCM, mu-law or A-law, based on the value of the waveform sample interpretation, which is specified by the SampleInterpretation property.

See Also

Elements:

SetNumberOfSamplesPerChannel method, Reset method, LoadAudio method, Channels property, EnableMethodErrors property, MultiplexGroupLabel property, MultiplexGroupTimeOffset property, NumberOfSamplesPerChannel property, SampleInterpretation property, SamplingFrequency property, TriggerSamplePosition property, TriggerTimeOffset property, ValueDefined property, WaveformOriginality property, WaveformPaddingValue property

Topics:

DICOM Waveform Groups: Supporting Audio