1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
|
/********************************************************************************/
/* */
/* Papyrus 3 library. */
/* This library constitutes a DICOM file system which helps reading and writing */
/* DICOM files and DICOMDIR files. */
/* */
/* Copyright (C) 2004 - Service of Medical Informatics - */
/* University Hospitals of Geneva (HUG), Geneva, Switzerland */
/* */
/* This library is a free software; you can redistribute it and/or modify it */
/* under the terms of the GNU Lesser General Public License as published by the */
/* Free Software Foundation; either version 2.1 of the License, or */
/* (at your option) any later version. */
/* */
/* This library is distributed in the hope that it will be useful, */
/* but WITHOUT ANY WARRANTY; without even the implied warranty of */
/* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. */
/* See the GNU Lesser General Public License for more details. */
/* */
/* You should have received a copy of the GNU Lesser General Public License */
/* along with this library; if not, write to */
/* the Free Software Foundation, Inc., */
/* 59 Temple Place, Suite 330, */
/* Boston, MA 02111-1307 USA */
/* */
/* You can contact us for more information at osiris@sim.hcuge.ch */
/* or by writing to Papyrus, */
/* Unite d'Imagerie Numerique / Service d'Informatique Medicale / HUG, */
/* 24, Micheli-du-Crest street, 1211 Geneva 14, Switzerland. */
/* */
/* The University Hopitals of Geneva, hereby disclaims all copyright interest */
/* in the library `Papyrus' (a library for reading and writing DICOM files). */
/* */
/* Geneva, april 2004 */
/* Antoine Geissbuhler, head of the Service of Medical Informatics, */
/* University Hospitals of Geneva, Switzerland */
/* */
/********************************************************************************/
/********************************************************************************/
/* */
/* Project : P A P Y R U S Toolkit */
/* File : PapyDataSetRead3.c */
/* Function : contains the functions that will manage the reading of */
/* the Data Sets and the modules. */
/* Authors : Christian Girard */
/* Marianne Logean */
/* */
/* History : 07.1994 version 3.0 */
/* 06.1995 version 3.1 */
/* 02.1996 version 3.3 */
/* 02.1999 version 3.6 */
/* 04.2001 version 3.7 */
/* 09.2001 version 3.7 on CVS */
/* 10.2001 version 3.71 MAJ Dicom par CHG */
/* */
/********************************************************************************/
#ifdef Mac
#pragma segment papy3
#endif
/* ------------------------- includes -----------------------------------------*/
#include <stdio.h>
#include <string.h>
#ifndef Papyrus3H
#include "Papyrus3.h"
#endif
/********************************************************************************/
/* */
/* ExtractGroup28Information : Extracts some elements from the group 28 */
/* that will be needed further. */
/* return : standard error message. */
/* */
/********************************************************************************/
PapyShort
ExtractGroup28Information (PapyShort inFileNb)
{
char thePhotoInterpret [16];
PapyShort theErr;
int theElemType, theNbIm = 1;
PapyULong theNbVal;
UValue_T *theValP;
SElement *theGroup28P;
/* goto group 28 and read it */
if ((theErr = Papy3GotoGroupNb (inFileNb, 0x0028)) < 0)
RETURN (theErr);
if ((theErr = Papy3GroupRead (inFileNb, &theGroup28P)) < 0)
RETURN (theErr);
/* *** save the value of the needed elements *** */
/* extract number of frames only if DICOM file */
if (gIsPapyFile [inFileNb] == DICOM10 || gIsPapyFile [inFileNb] == DICOM_NOT10)
{
theValP = Papy3GetElement (theGroup28P, papNumberofFramesGr, &theNbVal, &theElemType);
if (theValP != NULL)
sscanf (theValP->a, "%d", &theNbIm);
gArrNbImages [inFileNb] = (PapyShort) theNbIm;
} /* if */
/* number of ROWS */
gx0028Rows [inFileNb] = theGroup28P [papRowsGr].value->us;
/* number of COLUMNS */
gx0028Columns [inFileNb] = theGroup28P [papColumnsGr].value->us;
/* the image format */
if (theGroup28P [papImageFormatGr].nb_val > 0L)
gx0028ImageFormat [inFileNb] = PapyStrDup (theGroup28P [papImageFormatGr].value->a);
/* the BITS ALLOCATED */
if (theGroup28P [papBitsAllocatedGr].nb_val > 0L)
{
gx0028BitsAllocated [inFileNb] = theGroup28P [papBitsAllocatedGr].value->us;
/* 24 bits images (RGB) should be seen as 8 bits allocated by channel... */
if (gx0028BitsAllocated [inFileNb] == 24)
gx0028BitsAllocated [inFileNb] = 8;
} /* if */
/* the BITS STORED */
if (theGroup28P [papBitsStoredGr].nb_val > 0L)
gx0028BitsStored [inFileNb] = theGroup28P [papBitsStoredGr].value->us;
/* the photometric interpretation */
theValP = Papy3GetElement (theGroup28P, papPhotometricInterpretationGr, &theNbVal, &theElemType);
if (theValP != NULL)
strcpy (thePhotoInterpret, theValP->a);
else /* default value */
strcpy (thePhotoInterpret, "MONOCHROME2");
/* free the group 28 */
theErr = Papy3GroupFree (&theGroup28P, TRUE);
/* set the PAPYRUS global var according to the extracted value */
if (strcmp (thePhotoInterpret, "MONOCHROME1") == 0)
gArrPhotoInterpret [inFileNb] = MONOCHROME1;
else if (strcmp (thePhotoInterpret, "MONOCHROME2") == 0)
gArrPhotoInterpret [inFileNb] = MONOCHROME2;
else if (strcmp (thePhotoInterpret, "PALETTE COLOR") == 0)
gArrPhotoInterpret [inFileNb] = PALETTE;
else if (strcmp (thePhotoInterpret, "RGB") == 0)
gArrPhotoInterpret [inFileNb] = RGB;
else if (strcmp (thePhotoInterpret, "HSV") == 0)
gArrPhotoInterpret [inFileNb] = HSV;
else if (strcmp (thePhotoInterpret, "ARGB") == 0)
gArrPhotoInterpret [inFileNb] = ARGB;
else if (strcmp (thePhotoInterpret, "CMYK") == 0)
gArrPhotoInterpret [inFileNb] = CMYK;
else if (strcmp (thePhotoInterpret, "YBR_FULL") == 0)
gArrPhotoInterpret [inFileNb] = YBR_FULL;
else if (strcmp (thePhotoInterpret, "YBR_FULL_422") == 0)
gArrPhotoInterpret [inFileNb] = YBR_FULL_422;
else if (strcmp (thePhotoInterpret, "YBR_PARTIAL_422") == 0)
gArrPhotoInterpret [inFileNb] = YBR_PARTIAL_422;
RETURN (papNoError);
} /* endofmethod ExtractGroup28Information */
/********************************************************************************/
/* */
/* ExtractFileMetaInformation3 : Extracts the file meta information for the*/
/* given file. It reads group2 and extract the modality as well as the */
/* transfert syntax that will be used in the rest of the file */
/* return : standard error message. */
/* */
/********************************************************************************/
PapyShort
ExtractFileMetaInformation3 (PapyShort inFileNb)
{
int found, i;
PapyShort theErr;
PapyULong theNbVal;
PapyLong theFilePos;
int theElemType, theElength;
SElement *theGroup2P = NULL, *theGroupTmpP;
UValue_T *theValP;
/* Read group 0x0002 */
if ((theErr = Papy3GroupRead (inFileNb, &theGroup2P)) < 0)
{theErr = Papy3GroupFree (&theGroup2P, TRUE); RETURN (papReadGroup);}
/* extract the transfert syntax used for the rest of the file */
theValP = Papy3GetElement (theGroup2P, papTransferSyntaxUIDGr, &theNbVal, &theElemType);
if (theValP == NULL)
{theErr = Papy3GroupFree (&theGroup2P, TRUE); RETURN (papElemOfTypeOneNotFilled);}
/* 1.2.840.10008.1.20 is to avoid a bug with the old files... */
if (strcmp (theValP->a, "1.2.840.10008.1.2") == 0 || strcmp (theValP->a, "1.2.840.10008.1.20") == 0)
{
gArrTransfSyntax [inFileNb] = LITTLE_ENDIAN_IMPL;
gArrCompression [inFileNb] = NONE;
}
else if (strcmp (theValP->a, "1.2.840.10008.1.2.1") == 0)
{
gArrTransfSyntax [inFileNb] = LITTLE_ENDIAN_EXPL;
gArrCompression [inFileNb] = NONE;
}
else if (strcmp (theValP->a, "1.2.840.10008.1.2.2") == 0)
{
gArrTransfSyntax [inFileNb] = BIG_ENDIAN_EXPL;
gArrCompression [inFileNb] = NONE;
}
else if (strcmp (theValP->a, "1.2.840.10008.1.2.5") == 0)
{
gArrTransfSyntax [inFileNb] = LITTLE_ENDIAN_EXPL;
gArrCompression [inFileNb] = RLE;
}
else if ((strcmp (theValP->a, "1.2.840.10008.1.2.4.70") == 0) ||
(strcmp (theValP->a, "1.2.840.10008.1.2.4.57") == 0) ||
(strcmp (theValP->a, "1.2.840.10008.1.2.4.58") == 0))
{
gArrTransfSyntax [inFileNb] = LITTLE_ENDIAN_EXPL;
gArrCompression [inFileNb] = JPEG_LOSSLESS;
}
else if (strcmp (theValP->a, "1.2.840.10008.1.2.4.51") == 0)
{
gArrTransfSyntax [inFileNb] = LITTLE_ENDIAN_EXPL;
gArrCompression [inFileNb] = JPEG_LOSSY;
}
else if (strcmp (theValP->a, "1.2.840.10008.1.2.4.50") == 0)
{
gArrTransfSyntax [inFileNb] = LITTLE_ENDIAN_EXPL;
gArrCompression [inFileNb] = JPEG_LOSSY;
}
else if (strcmp (theValP->a, "1.2.756.777.1.2.4.70") == 0) /* PAPYRUS defined transfert syntax */
{
gArrTransfSyntax [inFileNb] = LITTLE_ENDIAN_IMPL;
gArrCompression [inFileNb] = JPEG_LOSSLESS;
}
#ifdef MAYO_WAVE /* WARNING this is defined in DICOM as JPEG-LS lossless image compression */
/* whereas 1.2.840.10008.1.2.4.81 is JPEG-LS Lossy (near-Lossless) image compression */
else if (strcmp (theValP->a, "1.2.840.10008.1.2.4.80") == 0)
{
gArrTransfSyntax [inFileNb] = LITTLE_ENDIAN_EXPL;
gArrCompression [inFileNb] = MAYO_WAVELET;
}
#endif
else
{
theErr = Papy3GroupFree (&theGroup2P, TRUE);
RETURN (papSyntaxNotImplemented);
}
/* extract the SOP Class UID in order to know the modality of the file */
theValP = Papy3GetElement (theGroup2P, papMediaStorageSOPClassUIDGr, &theNbVal, &theElemType);
/* find the modality */
found = FALSE;
i = 0;
if (theValP != NULL)
{
/* DICOMDIR defined SOP Class UID */
if (gIsPapyFile [inFileNb] == DICOMDIR)
if (strcmp (theValP->a, "1.2.840.10008.1.3.10") == 0)
{
/* free group 2 as we do not need it anymore */
theErr = Papy3GroupFree (&theGroup2P, TRUE);
RETURN (theErr);
} /* if */
else RETURN (papNotPapyrusFile);
/* avoid a bug with the old version of PAPYRUS ( < 3.3) */
theElength = strlen (theValP->a);
if (theValP->a [theElength - 1] == '0' &&
strcmp (theValP->a, gArrUIDs [NM_IM]) != 0 ) theValP->a [theElength - 1] = '\0';
while (!found && i < END_MODALITY)
{
if (strcmp (theValP->a, gArrUIDs [(int) i]) == 0)
{
found = TRUE;
/* set the modality of the file */
gFileModality [inFileNb] = (int)i;
}
else i++;
} /* while */
} /* if ...there is a value for getting the modality in group 2 */
/* if theValP NULL or not found or untrustable file (...) */
/* look for the element 0x0008:0x0060 modality */
/*if ((theValP == NULL) || (!found) || gIsPapyFile [inFileNb] == DICOM10)*/
if (!found)
{
i = 0;
/* keep the position in the file */
theErr = Papy3FTell (gPapyFile [inFileNb], &theFilePos);
/* reset the file pointer to its previous position */
theErr = Papy3FSeek (gPapyFile [inFileNb], SEEK_SET, 132L);
/* goto group 8 and read it */
if ((theErr = Papy3GotoGroupNb (inFileNb, 0x0008)) < 0)
{ Papy3GroupFree (&theGroup2P, TRUE); RETURN (theErr); }
if ((theErr = Papy3GroupRead (inFileNb, &theGroupTmpP)) < 0)
{ Papy3GroupFree (&theGroup2P, TRUE); RETURN (theErr); }
/* extract the modality */
theValP = Papy3GetElement (theGroupTmpP, papModalityGr, &theNbVal, &theElemType);
if (theValP != NULL)
ExtractModality (theValP, inFileNb);
/* else this file will not live */
else
{
/* free the group 8 */
theErr = Papy3GroupFree (&theGroupTmpP, TRUE);
theErr = Papy3GroupFree (&theGroup2P, TRUE);
RETURN (papElemOfTypeOneNotFilled);
}
/* free the group 8 */
theErr = Papy3GroupFree (&theGroupTmpP, TRUE);
/* reset the file pointer to its previous position */
theErr = Papy3FSeek (gPapyFile [inFileNb], SEEK_SET, theFilePos);
} /* if ...theValP is NULL or unknown UID */
/* free group 2 as we do not need it anymore */
theErr = Papy3GroupFree (&theGroup2P, TRUE);
RETURN (theErr);
} /* endof ExtractFileMetaInformation3 */
/********************************************************************************/
/* */
/* ExtractPapyDataSetInformation3 : Extracts the data sets relativ */
/* information i.e. the number of images, and the offsets to the data sets */
/* and the pixel datas for a PAPYRUS 3 file. */
/* return : standard error message. */
/* */
/********************************************************************************/
PapyShort
ExtractPapyDataSetInformation3 (PapyShort inFileNb)
{
PapyShort theErr, i;
PapyUShort theElemCreator, theElemNb;
PapyULong theNbVal, theSavedFilePos, theItemLength, theULong;
int theElemType;
SElement *theGroupP;
UValue_T *theValP;
/* move the file pointer to group 41 */
if ((theErr = Papy3GotoGroupNb (inFileNb, 0x0041)) < 0) RETURN (theErr);
/* find the creator element number for the PAPYRUS 3.0 elements */
if ((theElemCreator = Papy3FindOwnerRange (inFileNb, 0x0041, "PAPYRUS 3.0")) == 0)
RETURN (papNotFound);
/* look for the position of the pointer and the image sequence */
/* save the current file pos */
Papy3FTell (gPapyFile [inFileNb], (PapyLong *) &theSavedFilePos);
/* elem (0x0041, 0x??10) = pointer sequence */
theElemNb = theElemCreator << 8;
theElemNb |= 0x0010;
if ((theErr = Papy3GotoElemNb (inFileNb, 0x0041, theElemNb, &theULong)) < 0) RETURN (theErr);
Papy3FTell (gPapyFile [inFileNb], (PapyLong *) &gOffsetToPtrSeq [inFileNb]);
/* elem (0x0041, 0x??50) = image sequence */
theElemNb = theElemCreator << 8;
theElemNb |= 0x0050;
if ((theErr = Papy3GotoElemNb (inFileNb, 0x0041, theElemNb, &theULong)) < 0) RETURN (theErr);
Papy3FTell (gPapyFile [inFileNb], (PapyLong *) &gOffsetToImageSeq [inFileNb]);
/* reset the file pointer to the begining of group 41 */
Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, (PapyLong) theSavedFilePos);
/* read THE group 41 and stores it */
if ((theErr = Papy3GroupRead (inFileNb, &gArrGroup41 [inFileNb])) < 0) RETURN (papReadGroup);
/* extracts the number of images in the file */
theValP = Papy3GetElement (gArrGroup41 [inFileNb], papNumberofimagesGr, &theNbVal, &theElemType);
gArrNbImages [inFileNb] = theValP->us;
/* allocate room for the offsets to the data set and pixel data of the file */
gRefImagePointer [inFileNb] = (PapyULong *) ecalloc3 ((PapyULong) gArrNbImages [inFileNb],
(PapyULong) sizeof (PapyULong));
gRefPixelOffset [inFileNb] = (PapyULong *) ecalloc3 ((PapyULong) gArrNbImages [inFileNb],
(PapyULong) sizeof (PapyULong));
/* allocate room for the SOP instance UID of the images */
gImageSOPinstUID [inFileNb] = (char **) ecalloc3 ((PapyULong) gArrNbImages [inFileNb],
(PapyULong) sizeof (char *));
/* extraction of the offsets to the data set(s) and the image(s) */
/* so points to the first element of the pointer sequence */
if (gArrTransfSyntax [inFileNb] == LITTLE_ENDIAN_IMPL)
Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, (PapyLong) (gOffsetToPtrSeq [inFileNb] + 8L));
else if (gArrTransfSyntax [inFileNb] == LITTLE_ENDIAN_EXPL)
Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, (PapyLong) (gOffsetToPtrSeq [inFileNb] + 12L));
/* extract the offset to data set and the image and the UID for each image */
for (i = 0; i < gArrNbImages [inFileNb]; i++)
{
/* extract the length of this item of the pointer sequence */
theItemLength = Papy3ExtractItemLength (inFileNb);
if ((int) theItemLength < 0) RETURN ((int) theItemLength);
Papy3FTell (gPapyFile [inFileNb], (PapyLong *) &theULong);
theItemLength += theULong;
/* move the file pointer to the group 41 of the pointer sequence */
if ((theErr = Papy3GotoGroupNb (inFileNb, 0x0041)) < 0) RETURN (theErr);
/* read the group */
if ((theErr = Papy3GroupRead (inFileNb, &theGroupP)) < 0) RETURN (theErr);
/* extract the offset to the data set */
theValP = Papy3GetElement (theGroupP, papImagePointerGr, &theNbVal, &theElemType);
*(gRefImagePointer [inFileNb] + i) = theValP->ul;
/* extract the offset to the pixel datas */
theValP = Papy3GetElement (theGroupP, papPixelOffsetGr, &theNbVal, &theElemType);
*(gRefPixelOffset [inFileNb] + i) = theValP->ul;
/* extract the SOP instance UID of the image */
theValP = Papy3GetElement (theGroupP, papReferencedImageSOPClassUIDGr, &theNbVal, &theElemType);
if (theValP != NULL)
*(gImageSOPinstUID [inFileNb] + i) = (char *) PapyStrDup (theValP->a);
/* free the group */
theErr = Papy3GroupFree (&theGroupP, TRUE);
/* go to the end of this item of the pointer sequence */
Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, (PapyLong) theItemLength);
} /* for ...extraction of the offsets to data set and the images */
RETURN (theErr);
} /* endof ExtractPapyDataSetInformation3 */
/********************************************************************************/
/* */
/* ExtractDicomDataSetInformation3 : Extracts the data sets relativ */
/* information i.e. the offsets to the data sets and the pixel datas for */
/* a DICOM file. */
/* return : standard error message. */
/* */
/********************************************************************************/
PapyShort
ExtractDicomDataSetInformation3 (PapyShort inFileNb)
{
PapyShort theErr, i;
PapyULong theULong;
PapyULong theOffsetDataSet, theOffsetImage;
/* move the file pointer to group 0x7FE0 */
if ((theErr = Papy3GotoGroupNb (inFileNb, 0x7FE0)) < 0) RETURN (theErr);
/* look for the position of the image pixel element */
/* elem (0x7FE0, 0x0010) = image pixel */
if ((theErr = Papy3GotoElemNb (inFileNb, 0x7FE0, 0x0010, &theULong)) < 0) RETURN (theErr);
/* get the position of the element */
Papy3FTell (gPapyFile [inFileNb], (PapyLong *) &theOffsetImage);
/* add something depending on the transfert syntax */
if (gArrTransfSyntax [inFileNb] == LITTLE_ENDIAN_EXPL ||
gArrTransfSyntax [inFileNb] == BIG_ENDIAN_EXPL) theOffsetImage += 12L;
else theOffsetImage += 8L;
/* set the position of the unique data set */
/* part 10 compliant DICOM file */
if (gIsPapyFile [inFileNb] == DICOM10) theOffsetDataSet = 132L;
/* non-part 10 DICOM file */
else if (gIsPapyFile [inFileNb] == DICOM_NOT10) theOffsetDataSet = 0L;
/* allocate room for the offsets to the data set and pixel data of the file */
gRefImagePointer [inFileNb] = (PapyULong *) ecalloc3 ((PapyULong) gArrNbImages [inFileNb],
(PapyULong) sizeof (PapyULong));
gRefPixelOffset [inFileNb] = (PapyULong *) ecalloc3 ((PapyULong) gArrNbImages [inFileNb],
(PapyULong) sizeof (PapyULong));
/* put the offset to data set and the image for each image */
for (i = 0; i < gArrNbImages [inFileNb]; i++)
{
/* put the offset to the data set */
*(gRefImagePointer [inFileNb] + i) = theOffsetDataSet;
/* put the offset to the pixel datas */
*(gRefPixelOffset [inFileNb] + i) = theOffsetImage;
} /* for ...putting the offsets to data set and the images */
return 0;
} /* endof ExtractDicomDataSetInformation3 */
/********************************************************************************/
/* */
/* Papy3GetModule : Get the specified module from the specified data set. */
/* Beware : this routine DO NOT extract the pixel data from the file for */
/* optimization reasons. To get the image, get the module, the call the */
/* Papy3GetPixelData routine. */
/* return : the read module or NULL. */
/* */
/********************************************************************************/
Module * CALLINGCONV
Papy3GetModule (PapyShort inFileNb, PapyShort inImageNb, int inModuleID)
{
int i, j, theElemType, theEnumTag, found, theOddGroup;
int *theListOfGroupsP, *theFooP, theElem = FALSE;
PapyShort theErr;
PapyUShort theElemTag, theElemCreator, theTmpTag;
PapyULong theItemLength, theNbVal, theLoopVal;
UValue_T *theValP, *theTmpValP;
SElement *theGrP, *theTmpGrP, *theZouzouteP;
Module *theModuleP, *theElemP;
/* if it is a PAPYRUS 3 file */
switch (gIsPapyFile [inFileNb])
{
case DICOMDIR : /* DICOMDIR file */
case DICOM10 : /* DICOM file */
/* it is a basic part 10 DICOM file so jump past the file preamble */
if (Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, 132L) != 0) return NULL;
break;
case PAPYRUS3 : /* PAPYRUS 3 file */
/* a usefull test */
if (inImageNb > gArrNbImages [inFileNb] || inModuleID > END_MODULE) return NULL;
/* position the file pointer at the right position */
switch (inModuleID)
{
case GeneralPatientSummary :
case GeneralVisitSummary :
case GeneralStudySummary :
case GeneralSeriesSummary :
/* go to the begining of the first group of the summaries */
if (Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, 132L) != 0) return NULL;
if ((theErr = Papy3GotoGroupNb (inFileNb, 0x0008)) < 0) return NULL;
break;
case ImageIdentification :
case IconImage :
case ImagePointer :
case PixelOffset :
/* it is one of the pointer sequence module, so go to the given ptr sequence */
if (Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, (PapyLong) gOffsetToPtrSeq [inFileNb] + 8L) != 0)
return NULL;
/* look for the given item of the ptr seq */
for (i = 1; i < inImageNb; i++)
{
theItemLength = Papy3ExtractItemLength (inFileNb);
if ((int) theItemLength < 0) return NULL;
if (Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_CUR, (PapyLong) theItemLength) != 0)
return NULL;
} /* for */
/* then points to the first element of the item */
if (Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_CUR, (PapyLong) 8L) != 0)
return NULL;
break;
case InternalImagePointerSequence :
/* get the whole pointer sequence so points to the begining of the ptr seq */
if (Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, (PapyLong) gOffsetToPtrSeq [inFileNb]) != 0)
return NULL;
break;
case ImageSequencePap :
/* get the whole image sequence, so points to the begining of the image seq */
if (Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, (PapyLong) gOffsetToImageSeq [inFileNb]) != 0)
return NULL;
break;
default :
/* it is a module of the specified data set, so go to the begining of it */
if ((theErr = Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, (PapyLong) *(gRefImagePointer [inFileNb] + inImageNb - 1))) < 0)
return NULL;
break;
} /* switch ...positioning the file pointer at the right place */
break; /* PAPYRUS file */
case DICOM_NOT10 : /* non-part 10 DICOM file */
/* it is a basic non-part 10 DICOM file so set the file pointer at the begining */
if (Papy3FSeek (gPapyFile [inFileNb], (int) SEEK_SET, 0L) != 0) return NULL;
break;
default :
/* do nothing */
break;
} /* switch ...file type */
/* creation of the module */
theModuleP = CreateModule3 (inModuleID);
/* initialize the lists of groups contained in the module to empty */
theListOfGroupsP = (int *) ecalloc3 ((PapyULong) END_GROUP, (PapyULong) sizeof (int));
theFooP = NULL;
/* scan the module to find its group composition */
LookForGroupsInModule3 (theModuleP, inModuleID, theFooP, theListOfGroupsP);
/* loop on the groups */
for (i = 0; i < END_GROUP; i++)
{
/* read only the needed groups */
if (theListOfGroupsP [i] == 1)
{
/* look for the group */
if ((theErr = Papy3GotoGroupNb (inFileNb, (PapyShort) (gArrGroup [i].number))) == 0)
{
/* test wether it is an odd group number or not */
if (gArrGroup [i].number % 2 != 0)
{
theOddGroup = TRUE;
/* look for the owner range of the PAPYRUS 3.0 elements */
theElemCreator = Papy3FindOwnerRange (inFileNb, gArrGroup [i].number, "PAPYRUS 3.0");
} /* if ...odd group number */
else theOddGroup = FALSE;
/* read the group */
if ((theErr = Papy3GroupRead (inFileNb, &theGrP)) < 0)
{Papy3ModuleFree (&theModuleP, inModuleID, TRUE); efree3 ((void **) &theListOfGroupsP); return NULL;}
theElemP = theModuleP;
/* test each element of the module to see if it belongs to the group */
for (j = 0; j < gArrModule [inModuleID]; j++, theElemP++)
{
/* does the element belongs to the group ? */
if (theElemP->group == theGrP->group)
{
/* locate the enum place of the element given its tag */
theTmpGrP = theGrP;
found = FALSE;
theEnumTag = 0;
theElemTag = theElemP->element;
/* if it is an odd group number */
if (theOddGroup && theElemTag >= 0x0100)
{
/* convert the element range to the one extracted from the file */
/* 0xaabb -> 0x00bb */
theTmpTag = theElemTag << 8;
theTmpTag = theTmpTag >> 8;
/* put the theElemP creator in the 2 most significant bytes... */
/* 0x00cc -> 0xcc00 */
theElemTag = theElemCreator << 8;
/* ...and the element tag in the 2 less significant bytes */
/* 0xccbb */
theElemTag |= theTmpTag;
} /* if ...odd group number */
while (!found && (theEnumTag <= (long) gArrGroup [i].size))
{
if (theTmpGrP->element == theElemTag) found = TRUE;
else
{
theEnumTag++;
theTmpGrP++;
} /* else */
} /* while */
/* if it is the pixel data element do not read it */
if (found && !(theElemP->group == 0x7FE0 && theElemTag == 0x0010))
{
/* extract the element */
theValP = Papy3GetElement (theGrP, theEnumTag, &theNbVal, &theElemType);
/* put the element in the module */
if (theValP != NULL)
{
/* test that it has found at least one element */
if (!theElem) theElem = TRUE;
/* loop on the values of the element */
for (theLoopVal = 0L, theTmpValP = theValP; theLoopVal < theNbVal; theLoopVal++, theTmpValP++)
{
/* depending on the VR of the element put it to the group */
switch (theElemType)
{
case SS :
Papy3PutElement (theModuleP, j, &(theTmpValP->ss));
break;
case USS :
case AT :
Papy3PutElement (theModuleP, j, &(theTmpValP->us));
break;
case OB :
Papy3PutImage (inFileNb, theModuleP, j, (PapyUShort *) theTmpValP->a, 0, 0, 8, (theGrP + theEnumTag)->length);
break;
case OW :
Papy3PutImage (inFileNb, theModuleP, j, theTmpValP->ow, 0, 0, 16, (theGrP + theEnumTag)->length);
break;
case SL :
Papy3PutElement (theModuleP, j, &(theTmpValP->sl));
break;
case UL :
Papy3PutElement (theModuleP, j, &(theTmpValP->ul));
break;
case FL :
Papy3PutElement (theModuleP, j, &(theTmpValP->fl));
break;
case FD :
Papy3PutElement (theModuleP, j, &(theTmpValP->fd));
break;
case AE :
case AS :
case CS :
case DA :
case DS :
case DT :
case IS :
case LO :
case LT :
case PN :
case SH :
case ST :
case TM :
case UI :
case UT :
Papy3PutElement (theModuleP, j, &(theTmpValP->a));
break;
case UN :
Papy3PutUnknown (theModuleP, j, theTmpValP->a, (theGrP + theEnumTag)->length);
break;
case SQ :
Papy3PutElement (theModuleP, j, &(theTmpValP->sq));
break;
} /* switch */
} /* for ...loop on the values of the element */
} /* if ...the element exists */
} /* if ...the element is not pixel data */
else /* it is the pixel data element */
{
/* put the element length and number of value if any */
theZouzouteP = theGrP + theEnumTag;
theElemP->nb_val = theZouzouteP->nb_val;
theElemP->length = theZouzouteP->length;
} /* else ...pixel data element */
} /* if ...the element belongs to this group */
} /* for ...loop on the elements of the module */
/* free the group */
/* first free the unused SQ element from the group */
theErr = Papy3FreeSQElement (&theGrP, theModuleP, inModuleID);
theErr = Papy3GroupFree (&theGrP, FALSE);
} /* if ...the group exists */
} /* if ...group has to be read */
} /* for ...reading of the needed groups */
/* delete the lists of groups number of the module */
efree3 ((void **) &theListOfGroupsP);
/* if no element found we have to assume the module is empty ... */
if (!theElem)
{
Papy3ModuleFree (&theModuleP, inModuleID, TRUE);
return NULL;
} /* if */
else
return theModuleP;
} /* endof Papy3GetModule */
|
