dcmdictionary.c File Reference

DICOM dictionary for TPCCLIB. More...

#include "tpcclibConfig.h"
#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include <time.h>
#include <string.h>
#include "tpcextensions.h"
#include "tpcdcm.h"

Go to the source code of this file.

Functions
unsigned int	dcmDictSize ()
int	dcmDictIndexTag (unsigned int i, unsigned short int *group, unsigned short int *element)
char *	dcmDictIndexVR (unsigned int i)
char *	dcmDictIndexDescr (unsigned int i)
char *	dcmDictIndexType (unsigned int i)
unsigned int	dcmDictFindTag (DCMTAG *tag)

Detailed Description

DICOM dictionary for TPCCLIB.

Definition in file dcmdictionary.c.

Function Documentation

dcmDictFindTag()

unsigned int dcmDictFindTag

(

DCMTAG *

tag

)

Get the dictionary index for given tag.

Returns

If tag is found, returns its dictionary index; otherwise returns the length of the dictionary.

See also

dcmDictSize, dcmDictIndexTag, dcmDictIndexVR, dcmDictIndexType, dcmDictIndexDescr

Parameters

tag	Pointer to DICOM tag.

Definition at line 2820 of file dcmdictionary.c.

  {
  unsigned int i, n=dcmDictSize();
  if(tag==NULL) return(n);
  for(i=0; i<n; i++)
    if(tag->group==dcmdict[i].group && tag->element==dcmdict[i].element) break;
  return(i);
}

Referenced by dcmFileReadNextElement().

dcmDictIndexDescr()

char * dcmDictIndexDescr

(

unsigned int

i

)

Get the DICOM tag description, based on given dictionary index.

Returns

Returns pointer to description string, which is 'Unknown' if index equals dictionary length, or NULL in case of an error.

See also

dcmDictSize, dcmDictIndexTag, dcmDictFindTag

Parameters

i	Dictionary index [0..n-1].

Definition at line 2780 of file dcmdictionary.c.

  {
  if(i>dcmDictSize()) return(char*)NULL;
  else return(dcmdict[i].descr);
}

Referenced by dcmFileReadNextElement().

dcmDictIndexTag()

int dcmDictIndexTag	(	unsigned int	i,
		unsigned short int *	group,
		unsigned short int *	element )

Get the DICOM tag group and element, based on given dictionary index.

Returns

Returns 0 when successful, 1 if invalid index.

See also

dcmDictSize, dcmDictIndexVR, dcmDictIndexType, dcmDictIndexDescr, dcmDictFindTag

Parameters

i	Dictionary index [0..n-1].
group	Pointer to tag group; enter NULL if not needed.
element	Pointer to tag element; enter NULL if not needed.

Definition at line 2744 of file dcmdictionary.c.

  {
  if(group!=NULL) *group=0;
  if(element!=NULL) *element=0;
  if(i>=dcmDictSize()) return(1);
  if(group!=NULL) *group=dcmdict[i].group;
  if(element!=NULL) *element=dcmdict[i].element;
  return(0);
}

dcmDictIndexType()

char * dcmDictIndexType

(

unsigned int

i

)

Get the DICOM Tag Type, based on given dictionary index.

Tag Type is a NULL terminated string.

• 1: mandatory.
• 1C: mandatory only under certain conditions.
• 2: required to exist, but can have a null value.
• 2C: required to exist only under certain conditions.
• 3: optional.

Reference: DICOM PS3.3

Returns

Returns pointer to the tag type string, or NULL in case of an error.

See also

dcmDictSize, dcmDictIndexTag, dcmDictFindTag

Parameters

i	Dictionary index [0..n-1].

Definition at line 2804 of file dcmdictionary.c.

  {
  if(i>=dcmDictSize()) return(char*)NULL;
  else return(dcmdict[i].type);
}

dcmDictIndexVR()

char * dcmDictIndexVR

(

unsigned int

i

)

Get the DICOM tag VR string, based on given dictionary index.

Returns

Returns pointer to VR string, or NULL in case of an error.

See also

dcmDictSize, dcmDictIndexTag, dcmDictFindTag

Definition at line 2766 of file dcmdictionary.c.

  {
  if(i>=dcmDictSize()) return(char*)NULL;
  else return(dcmdict[i].vr);
}

Referenced by dcmFileReadNextElement().

dcmDictSize()

unsigned int dcmDictSize

(

)

Get the size of DICOM dictionary.

Returns

Returns the size of the dictionary.

Definition at line 2730 of file dcmdictionary.c.

{
  unsigned int n=1;
  while(dcmdict[n].group<0xFFFF && dcmdict[n].element<0xFFFF) n++;
  return(n);
}

Referenced by dcmDictFindTag(), dcmDictIndexDescr(), dcmDictIndexTag(), dcmDictIndexType(), and dcmDictIndexVR().