dcmvr.c File Reference

DICOM Value Representations (VRs). 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 char	dcmVRReserved (dcmvr id)
dcmvr	dcmVRId (const char *s)
char *	dcmVRName (dcmvr id)
size_t	dcmVRVLength (dcmvr id)
char *	dcmVRDescr (dcmvr id)
char *	dcmDA2intl (const char *orig, char *intl)
char *	dcmTM2intl (const char *orig, char *intl)
char *	dcmDT2intl (const char *orig, char *intl)

Detailed Description

DICOM Value Representations (VRs).

Definition in file dcmvr.c.

Function Documentation

dcmDA2intl()

char * dcmDA2intl	(	const char *	orig,
		char *	intl )

Convert DICOM date 'DA' to international format YYYY-MM-DD.

Returns

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

Parameters

orig	Pointer to original DICOM string.
intl	Pointer to string where date in international format will be written; must be allocated for at least 11 characters.

Definition at line 179 of file dcmvr.c.

  {
  if(orig==NULL || intl==NULL) return(NULL);
  if(strnlen(orig, 10)<8) return(NULL);
  if(isdigit(orig[4])) { // modern format YYYYMMDD
    sprintf(intl, "%4.4s-%2.2s-%2.2s", orig, orig+4, orig+6);
  } else { // old format YYYY.MM.DD
    sprintf(intl, "%4.4s-%2.2s-%2.2s", orig, orig+5, orig+8);
  }
  if(strDateValid(intl)) {intl[0]=(char)0; return(NULL);}
  return(intl);
}

Referenced by dcmMListRead().

dcmDT2intl()

char * dcmDT2intl	(	const char *	orig,
		char *	intl )

Convert DICOM datetime 'DT' to international format YYYY-MM-DD hh:mm:ss.

Returns

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

Parameters

orig	Pointer to original DICOM string. Should be in format YYYYMMDDhhmmss.FFFFFF+hhmm
intl	Pointer to string where date and time in international format will be written; must be allocated for at least 20 characters.

Definition at line 225 of file dcmvr.c.

  {
  if(orig==NULL || intl==NULL) return(NULL);
  if(strnlen(orig, 26)<14) return(NULL);
  sprintf(intl, "%4.4s-%2.2s-%2.2s %2.2s:%2.2s:%2.2s",
          orig, orig+4, orig+6, orig+8, orig+10, orig+12);
  if(strDateTimeValid(intl, NULL)) {intl[0]=(char)0; return(NULL);}
  return(intl);
}

Referenced by dcmMListRead(), and imgReadDICOM().

dcmTM2intl()

char * dcmTM2intl	(	const char *	orig,
		char *	intl )

Convert DICOM time 'TM' to international format hh:mm:ss.

Returns

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

Parameters

orig	Pointer to original DICOM string.
intl	Pointer to string where time in international format will be written; must be allocated for at least 9 characters.

Definition at line 202 of file dcmvr.c.

  {
  if(orig==NULL || intl==NULL) return(NULL);
  if(strnlen(orig, 14)<6) return(NULL);
  if(isdigit(orig[2])) { // modern format hhmmss.fract
    sprintf(intl, "%2.2s:%2.2s:%2.2s", orig, orig+2, orig+4);
  } else { // old format hh.mm.ss
    sprintf(intl, "%2.2s:%2.2s:%2.2s", orig, orig+3, orig+6);
  }
  if(strTimeValid(intl)) {intl[0]=(char)0; return(NULL);}
  return(intl);
}

Referenced by dcmMListRead().

dcmVRDescr()

char * dcmVRDescr

(

dcmvr

id

)

Get the DICOM VR description.

Returns

Returns pointer to the description string.

See also

dcmIdentifyVR

Parameters

id	VR id (DCM_VR_AE, ...).

Definition at line 162 of file dcmvr.c.

  {
  unsigned short int i=0;
  while(dcm_vr[i].vr!=DCM_VR_INVALID) {
    if(id==dcm_vr[i].vr) return(dcm_vr[i].descr);
    i++;
  }
  return(dcm_vr[DCM_VR_INVALID].descr);
}

Referenced by dcmFileReadNextElement().

dcmVRId()

dcmvr dcmVRId

(

const char *

s

)

Identify the DICOM VR based on the two-character long string.

Returns

Returns the VR id.

See also

dcmVRName

Parameters

s	VR string. Two first characters are used. String does not need to be null-terminated.

Definition at line 103 of file dcmvr.c.

  {
  if(s==NULL) return(DCM_VR_INVALID);
  char buf[3]; buf[0]=s[0]; buf[1]=s[1]; buf[2]=(char)0;
 
  /* Identify the VR */
  unsigned short int i=0;
  while(dcm_vr[i].vr!=DCM_VR_INVALID) {
    if(strncmp(dcm_vr[i].name, buf, 2)==0) return(dcm_vr[i].vr);
    i++;
  }
  return(DCM_VR_INVALID);
}

Referenced by dcmFileReadNextElement(), dcmReadFileVR(), and dcmReadFileVRVL().

dcmVRName()

char * dcmVRName

(

dcmvr

id

)

Get the DICOM VR name.

Returns

Returns pointer to the name string.

See also

dcmIdentifyVR

Parameters

id	VR id (DCM_VR_AE, ...).

Definition at line 126 of file dcmvr.c.

  {
  unsigned short int i=0;
  while(dcm_vr[i].vr!=DCM_VR_INVALID) {
    if(id==dcm_vr[i].vr) return(dcm_vr[i].name);
    i++;
  }
  return(dcm_vr[DCM_VR_INVALID].name);
}

Referenced by dcmAddItem(), dcmFileReadNextElement(), dcmitemPrint(), dcmReadFileVR(), and dcmWriteFileVRVL().

dcmVRReserved()

unsigned char dcmVRReserved

(

dcmvr

id

)

Is the explicit VR (2 bytes) followed by reserved 2 bytes? If yes, then the following Value Length is also given as 32-byte integer, if no, then as 16-bit integer.

Returns

Returns 0, if not, and 2, if it is.

Parameters

id	VR id (DCM_VR_AE, ...).

Definition at line 85 of file dcmvr.c.

  {
  unsigned short int i=0;
  while(dcm_vr[i].vr!=DCM_VR_INVALID) {
    if(id==dcm_vr[i].vr) return(dcm_vr[i].res);
    i++;
  }
  return(2);
}

Referenced by dcmReadFileVR(), dcmReadFileVRVL(), dcmReadTransferSyntaxUID(), and dcmWriteFileVRVL().

dcmVRVLength()

size_t dcmVRVLength

(

dcmvr

id

)

Get the DICOM VR max value length in bytes; 0 if not defined.

Returns

Returns the length in bytes.

See also

dcmIdentifyVR

Parameters

id	VR id (DCM_VR_AE, ...).

Definition at line 144 of file dcmvr.c.

  {
  unsigned short int i=0;
  while(dcm_vr[i].vr!=DCM_VR_INVALID) {
    if(id==dcm_vr[i].vr) return(dcm_vr[i].s);
    i++;
  }
  return(dcm_vr[DCM_VR_INVALID].s);
}

Referenced by dcmAddItem(), dcmFileReadNextElement(), dcmFileWrite(), and dcmValueString().