QMed_GetElementDataInfo

QMed_GetElementDataInfo(imageRef; elementRef; dataSize; numItems; dataType):error
	imageRef	Longint	Reference to the image
	elementRef	Longint	Element reference
	dataSize	Longint	Data size
	numItems	Longint	Number of items
	dataType	Longint	Data type
	error	Longint	Error result

Returns information about a data element instance in a DICOM file.

The DICOM image file is specified by imageRef. If imageRef is not a valid image reference, error qmed_paramErr is returned. If imageRef is a valid image reference but the image is not in the DICOM format, error qmed_badComponentType is returned.

Parameter elementRef specifies the data element. The element reference must have been previously obtained with a call to QMed_GetElements or QMed_FindElement. If elementRef is not a valid element reference, error qmed_badDataElementRef is returned.

Parameter dataSize receives the size of the element data in bytes.

Parameter numItems receives the number of items in the data element (the element multiplicity in DICOM parlance).

Parameter dataType receives the element data type (value representation) as specified by the DICOM standard. QMedical defines the following constants:

qmed_UndefinedVR	0	Undefined value representation
qmed_SignedShortVR	19	Signed short (2 bytes fixed)
qmed_UnsignedShortVR	25	Unsigned short (2 bytes fixed)
qmed_SignedLongVR	17	Signed long (4 bytes fixed)
qmed_UnsignedLongVR	23	Unsigned long (4 bytes fixed)
qmed_FloatingPointSingleVR	8	Single precision floating point (4 bytes fixed)
qmed_FloatingPointDoubleVR	9	Double precision floating point (8 bytes fixed)
qmed_ShortStringVR	16	Short string (16 chars max)
qmed_LongStringVR	11	Long string (64 chars max)
qmed_ShortTextVR	20	Short text (1024 chars max)
qmed_LongTextVR	12	Long text (10240 chars max)
qmed_UnlimitedTextVR	26	Unlimited text (up to 2^32 - 2 chars)
qmed_DateVR	5	Date (8 or 10 bytes fixed)
qmed_TimeVR	21	Time (16 bytes max)
qmed_DateTimeVR	7	Date and time (26 bytes max)
qmed_OtherByteStringVR	13	Other byte string (unlimited even byte length, endian insensitive)
qmed_OtherWordStringVR	14	Other word string (unlimited even byte length, endian sensitive)
qmed_IntegerStringVR	10	Integer string (12 bytes max)
qmed_DecimalStringVR	6	Decimal string (16 bytes max)
qmed_CodeStringVR	4	Code string (16 bytes max)
qmed_AgeStringVR	2	Age string (4 bytes fixed)
qmed_PersonNameVR	15	Person name (64 chars max)
qmed_ApplicationEntityVR	1	Application entity (16 bytes max)
qmed_UniqueIdentifierVR	22	Unique identifier (64 bytes max)
qmed_AttributeTagVR	3	Attribute tag (4 bytes fixed)
qmed_SequenceVR	18	Sequence of elements (used for nested data)
qmed_UnknownVR	24	Unknown (any valid length of other VR)
qmed_US_SS_VR	27	Unsigned short or signed short
qmed_US_SS_OW_VR	28	Unsigned short or signed short or other word
qmed_OW_OB_VR	29	Other word or other byte
qmed_SequenceItemVR	30	Sequence item

Note 1:

The DICOM data dictionary specifies a multiplicity range for elements which have not been retired. However this may be ambiguous. In most cases where the multiplicity of a value is ambiguous or unavailable (in the case of private data elements or retired) in the DICOM data dictinoary, it can be determined during the parsing of the file by QMedical. This is the reason for which the number of items is returned by QMed_GetElementDataInfo and not QMed_GetDictElementInfo.

Note 2:

The type of several standard elements is ambiguously defined in the DICOM dictionary and may be unavailable for private elements. In most cases where the type cannot be unambiguously determined from the DICOM data dictionary it can be determined during the parsing of the file by QMedical. This is the reason for which the data element type is returned by QMed_GetElementDataInfo and not QMed_GetDictElementInfo.