In This Topic ▼

L_DicomInsertTag

#include "Ltdic.h"

L_LTDIC_APIpDICOMTAGL_DicomInsertTag(nCode, nMask, pszName, nVR, nMinVM, nMaxVM, nDivideVM)

Inserts a new item in the Data Element Tag Table.

Parameters

L_UINT32nCode

Code that indicates the tag. For a list of default values, refer toData Element Tag Constants.

L_UINT32nMask

Masking value. Masking allows you to insert multiple elements in the same entry in the table.

L_TCHAR* pszName

Character string that contains the name of the tag. To see the default values for the Tag Names, refer to theDefault Data Element Tag Table.

L_UINT16nVR

Value representation code that indicates the type of value stored in the data element. For a list of default values supported by DICOM, refer toValue Representation Constants.

L_UINT32nMinVM

Value that indicates the minimum number of values that may be stored in the Value Field of the Data Element.

L_UINT32nMaxVM

Value that indicates the maximum number of values that may be stored in the Value Field of the Data Element.

L_UINT32nDivideVM

Value used to divide the value multiplicity. When multiple values are stored in the value field of a data element, the number of values present must be evenly divisible by nDivideVM. For most items nDivideVM will be 1. However, if the values stored in the value field are RGB triplets, for example, you would have to store three values for each triplet. You could store 12 values, since 12 values would be 4 triplets, however, you could not store 13 values. In this case nDivideVM would be 3.

Returns

Value	Meaning
!NULL	A pointer to a DICOMVR structure containing the newly inserted item.
NULL	Not enough memory to insert the item.

Comments

All items are inserted at the bottom of the table.

To see the default values for the Data Element Tag Table, refer to theDefault Data Element Tag Table.

For more information on the DICOM file format, refer toAn Overview of Dicomor theDICOM Spec.

Required DLLs and Libraries

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

Platforms

Win32, x64, Linux.

Functions

Topics

工作的智慧h Tags

Example

This example inserts 2 new items in the Tag table

L_INT DicomInsertTagExample(L_VOID){pDICOMTAG pTemp = NULL;pTemp = L_DicomInsertTag(0x12345678, 0xFFFFFFFF, TEXT("New XXX Tag"), VR_US, 1, 1, 1);if(pTemp == NULL)returnDICOM_ERROR_MEMORY;pTemp = L_DicomInsertTag(0x87654321, 0xFFFFFFFF, TEXT("New YYY Tag"), VR_LO, 1, 1, 1);if(pTemp == NULL)returnDICOM_ERROR_MEMORY;returnDICOM_SUCCESS;}

Download our FREE evaluation

Help Version 21.0.2021.7.2

LEADTOOLS DICOM C API Help

Introduction

Version History

Getting Started

Features of LEADTOOLS DICOM

Redistributables/Files To Be Included With Your Application

Quick Reference

Function References

Appendix