L_DicomWaveGrpSetSampleInterpretation

#include "Ltdic.h"

L_LTDIC_API L_BOOL L_DicomWaveGrpSetSampleInterpretation(hDICOMWaveFormGroup, uInterpretation)

HDICOMWAVEFORMGROUP hDICOMWaveFormGroup;

/* a DICOM waveform group handle */

L_UINT16 uInterpretation;

/* new sample interpretation */

Sets the waveform sample interpretation.

Parameter

Description

hDICOMWaveFormGroup

A DICOM waveform group handle

uInterpretation

The new waveform sample interpretation. Possible values are:

 

Value

Meaning

 

DICOM_SAMPLE_INTERPRETATION_SS

[0x00] signed 16-bit linear

 

DICOM_SAMPLE_INTERPRETATION_US

[0x01] unsigned 16-bit linear

 

DICOM_SAMPLE_INTERPRETATION_SB

[0x02] signed 8-bit linear

 

DICOM_SAMPLE_INTERPRETATION_UB

[0x03] unsigned 8-bit linear

 

DICOM_SAMPLE_INTERPRETATION_MB

[0x04] 8-bit mu-law

 

DICOM_SAMPLE_INTERPRETATION_AB

[0x05] 8-bit A-law

Returns

TRUE

The waveform sample interpretation was set successfully.

FALSE

An error occurred.

Comments

In DICOM all channels within a multiplex group are synchronously digitized at a common sampling frequency and have the same sample interpretation. Use this function to set the waveform sample interpretation, which applies to all channels in the waveform group.

For more information about sample interpretation refer to the "Waveform Sample Interpretation" (5400,1006) element in the DICOM standard.

The default value for sample interpretation is DICOM_SAMPLE_INTERPRETATION_SS.

Make sure to call this function before you call any functions that are used to set the data for a channel that is included in the waveform group. Such functions include L_DicomChannelSetSamples8, L_DicomChannelSetSamples16 and L_DicomChannelSetSamples32.

If you call this function after setting the data for one or more channels that are included in this group, then the function will convert the data for each of the channels to match the new sample interpretation.

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

See Also

Functions:

L_DicomWaveGrpGetSampleInterpretation, L_DicomChannelSetSamples8, L_DicomChannelSetSamples16, L_DicomChannelSetSamples32, L_DicomChannelGetSamples

Topics:

Working with DICOM Waveforms

Example

For an example, refer to L_DicomChannelSetSamples8.