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, Linux.

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C API Help