L_DicomWaveGrpSaveAudio

Summary

Creates an audio (wave) file from the channels in the waveform group.

Syntax

L_LTDIC_API L_UINT16 L_DicomWaveGrpSaveAudio(hDICOMWaveFormGroup, pszFilename, uFlags)

Parameters

HDICOMWAVEFORMGROUP hDICOMWaveFormGroup

A DICOM waveform group handle.

L_TCHAR * pszFilename

Name of the audio file to be created.

L_UINT16 uFlags

Reserved for future use. Pass 0.

Returns

Comments

This function 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:

1. Number of channels: will either be 1 or 2, based on the value of the number of channels for this multiplex group. You can call L_DicomWaveGrpGetNumberOfChannels to get the number of channels in a multiplex group.
2. Bits per sample (sample size) will always be 8.
3. Samples per second (sampling rate): This will be the same as the sampling frequency for the waveform group, call L_DicomWaveGrpGetSamplingFrequency to get this value.
4. Format category: PCM, mu-Law or a-Law, based on the value of the waveform sample interpretation which can be retrieved by calling L_DicomWaveGrpGetSampleInterpretation.

Required DLLs and Libraries

• LTDIC
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64, Linux.

See Also

Functions

• L_DicomWaveGrpLoadAudio

Topics

• Working with DICOM Waveforms

Example

The following sample shows how to extract a wave stream from a dataset.

BOOL GetWaveFileFromDataset(HDICOMDS hInputDS, L_CHAR * pszResultingWaveFileName) 
{ 
	HDICOMWAVEFORMGROUP hAudioWaveformGroup = NULL; 
 
	// Our new waveform group 
	hAudioWaveformGroup = L_DicomWaveGrpCreate(); 
	if (hAudioWaveformGroup == NULL) 
	{ 
		return FALSE; 
	} 
 
	// Do we have any waveforms in the dataset? 
	if (L_DicomGetWaveformGroupCount(hInputDS) < 1) 
	{ 
 
		L_DicomWaveGrpFree(hAudioWaveformGroup); 
		return FALSE; 
	} 
 
	// Extract the first waveform group 
	if (L_DicomGetWaveformGroup(hInputDS, 0, hAudioWaveformGroup) != DICOM_SUCCESS) 
	{ 
		L_DicomWaveGrpFree(hAudioWaveformGroup); 
		return FALSE; 
	} 
 
	// Extract the wave stream from the waveform group and save it to disk 
	if (L_DicomWaveGrpSaveAudio(hAudioWaveformGroup, pszResultingWaveFileName, 0) != DICOM_SUCCESS) 
	{ 
		L_DicomWaveGrpFree(hAudioWaveformGroup); 
		return FALSE; 
	} 
 
	L_DicomWaveGrpFree(hAudioWaveformGroup); 
 
	return TRUE; 
}