1 /*****************************************************************************/ 2 // Copyright 2006-2012 Adobe Systems Incorporated 3 // All Rights Reserved. 4 // 5 // NOTICE: Adobe permits you to use, modify, and distribute this file in 6 // accordance with the terms of the Adobe license agreement accompanying it. 7 /*****************************************************************************/ 8 9 /* $Id: //mondo/dng_sdk_1_4/dng_sdk/source/dng_image_writer.h#3 $ */ 10 /* $DateTime: 2012/07/31 22:04:34 $ */ 11 /* $Change: 840853 $ */ 12 /* $Author: tknoll $ */ 13 14 /** \file 15 * Support for writing DNG images to files. 16 */ 17 18 /*****************************************************************************/ 19 20 #ifndef __dng_image_writer__ 21 #define __dng_image_writer__ 22 23 /*****************************************************************************/ 24 25 #include "dng_auto_ptr.h" 26 #include "dng_classes.h" 27 #include "dng_fingerprint.h" 28 #include "dng_memory.h" 29 #include "dng_point.h" 30 #include "dng_rational.h" 31 #include "dng_sdk_limits.h" 32 #include "dng_string.h" 33 #include "dng_tag_types.h" 34 #include "dng_tag_values.h" 35 #include "dng_types.h" 36 37 /*****************************************************************************/ 38 39 /// \brief Image resolution. 40 41 class dng_resolution 42 { 43 44 public: 45 46 dng_urational fXResolution; 47 dng_urational fYResolution; 48 49 uint16 fResolutionUnit; 50 51 public: 52 53 dng_resolution (); 54 55 }; 56 57 /*****************************************************************************/ 58 59 class tiff_tag 60 { 61 62 protected: 63 64 uint16 fCode; 65 66 uint16 fType; 67 68 uint32 fCount; 69 70 protected: 71 tiff_tag(uint16 code,uint16 type,uint32 count)72 tiff_tag (uint16 code, 73 uint16 type, 74 uint32 count) 75 76 : fCode (code) 77 , fType (type) 78 , fCount (count) 79 80 { 81 } 82 83 public: 84 ~tiff_tag()85 virtual ~tiff_tag () 86 { 87 } 88 Code()89 uint16 Code () const 90 { 91 return fCode; 92 } 93 Type()94 uint16 Type () const 95 { 96 return fType; 97 } 98 Count()99 uint32 Count () const 100 { 101 return fCount; 102 } 103 SetCount(uint32 count)104 void SetCount (uint32 count) 105 { 106 fCount = count; 107 } 108 Size()109 uint32 Size () const 110 { 111 return TagTypeSize (Type ()) * Count (); 112 } 113 114 virtual void Put (dng_stream &stream) const = 0; 115 116 private: 117 118 // Hidden copy constructor and assignment operator. 119 120 tiff_tag (const tiff_tag &tag); 121 122 tiff_tag & operator= (const tiff_tag &tag); 123 124 }; 125 126 /******************************************************************************/ 127 128 class tag_data_ptr: public tiff_tag 129 { 130 131 protected: 132 133 const void *fData; 134 135 public: 136 tag_data_ptr(uint16 code,uint16 type,uint32 count,const void * data)137 tag_data_ptr (uint16 code, 138 uint16 type, 139 uint32 count, 140 const void *data) 141 142 : tiff_tag (code, type, count) 143 144 , fData (data) 145 146 { 147 } 148 SetData(const void * data)149 void SetData (const void *data) 150 { 151 fData = data; 152 } 153 154 virtual void Put (dng_stream &stream) const; 155 156 private: 157 158 // Hidden copy constructor and assignment operator. 159 160 tag_data_ptr (const tag_data_ptr &tag); 161 162 tag_data_ptr & operator= (const tag_data_ptr &tag); 163 164 }; 165 166 /******************************************************************************/ 167 168 class tag_string: public tiff_tag 169 { 170 171 protected: 172 173 dng_string fString; 174 175 public: 176 177 tag_string (uint16 code, 178 const dng_string &s, 179 bool forceASCII = true); 180 181 virtual void Put (dng_stream &stream) const; 182 183 }; 184 185 /******************************************************************************/ 186 187 class tag_encoded_text: public tiff_tag 188 { 189 190 private: 191 192 dng_string fText; 193 194 dng_memory_data fUTF16; 195 196 public: 197 198 tag_encoded_text (uint16 code, 199 const dng_string &text); 200 201 virtual void Put (dng_stream &stream) const; 202 203 }; 204 205 /******************************************************************************/ 206 207 class tag_uint8: public tag_data_ptr 208 { 209 210 private: 211 212 uint8 fValue; 213 214 public: 215 216 tag_uint8 (uint16 code, 217 uint8 value = 0) 218 219 : tag_data_ptr (code, ttByte, 1, &fValue) 220 221 , fValue (value) 222 223 { 224 } 225 Set(uint8 value)226 void Set (uint8 value) 227 { 228 fValue = value; 229 } 230 231 }; 232 233 /******************************************************************************/ 234 235 class tag_uint8_ptr: public tag_data_ptr 236 { 237 238 public: 239 240 tag_uint8_ptr (uint16 code, 241 const uint8 *data, 242 uint32 count = 1) 243 tag_data_ptr(code,ttByte,count,data)244 : tag_data_ptr (code, ttByte, count, data) 245 246 { 247 } 248 249 }; 250 251 /******************************************************************************/ 252 253 class tag_uint16: public tag_data_ptr 254 { 255 256 private: 257 258 uint16 fValue; 259 260 public: 261 262 tag_uint16 (uint16 code, 263 uint16 value = 0) 264 265 : tag_data_ptr (code, ttShort, 1, &fValue) 266 267 , fValue (value) 268 269 { 270 } 271 Set(uint16 value)272 void Set (uint16 value) 273 { 274 fValue = value; 275 } 276 277 }; 278 279 /******************************************************************************/ 280 281 class tag_int16_ptr: public tag_data_ptr 282 { 283 284 public: 285 286 tag_int16_ptr (uint16 code, 287 const int16 *data, 288 uint32 count = 1) 289 tag_data_ptr(code,ttSShort,count,data)290 : tag_data_ptr (code, ttSShort, count, data) 291 292 { 293 } 294 295 }; 296 297 /******************************************************************************/ 298 299 class tag_uint16_ptr: public tag_data_ptr 300 { 301 302 public: 303 304 tag_uint16_ptr (uint16 code, 305 const uint16 *data, 306 uint32 count = 1) 307 tag_data_ptr(code,ttShort,count,data)308 : tag_data_ptr (code, ttShort, count, data) 309 310 { 311 } 312 313 }; 314 315 /******************************************************************************/ 316 317 class tag_uint32: public tag_data_ptr 318 { 319 320 private: 321 322 uint32 fValue; 323 324 public: 325 326 tag_uint32 (uint16 code, 327 uint32 value = 0) 328 329 : tag_data_ptr (code, ttLong, 1, &fValue) 330 331 , fValue (value) 332 333 { 334 } 335 Set(uint32 value)336 void Set (uint32 value) 337 { 338 fValue = value; 339 } 340 341 }; 342 343 /******************************************************************************/ 344 345 class tag_uint32_ptr: public tag_data_ptr 346 { 347 348 public: 349 350 tag_uint32_ptr (uint16 code, 351 const uint32 *data, 352 uint32 count = 1) 353 tag_data_ptr(code,ttLong,count,data)354 : tag_data_ptr (code, ttLong, count, data) 355 356 { 357 } 358 359 }; 360 361 /******************************************************************************/ 362 363 class tag_urational: public tag_data_ptr 364 { 365 366 private: 367 368 const dng_urational fValue; 369 370 public: 371 tag_urational(uint16 code,const dng_urational & value)372 tag_urational (uint16 code, 373 const dng_urational &value) 374 375 : tag_data_ptr (code, ttRational, 1, &fValue) 376 377 , fValue (value) 378 379 { 380 } 381 382 }; 383 384 /******************************************************************************/ 385 386 class tag_urational_ptr: public tag_data_ptr 387 { 388 389 public: 390 391 tag_urational_ptr (uint16 code, 392 const dng_urational *data = NULL, 393 uint32 count = 1) 394 tag_data_ptr(code,ttRational,count,data)395 : tag_data_ptr (code, ttRational, count, data) 396 397 { 398 } 399 400 }; 401 402 /******************************************************************************/ 403 404 class tag_srational: public tag_data_ptr 405 { 406 407 private: 408 409 const dng_srational fValue; 410 411 public: 412 tag_srational(uint16 code,const dng_srational & value)413 tag_srational (uint16 code, 414 const dng_srational &value) 415 416 : tag_data_ptr (code, ttSRational, 1, &fValue) 417 418 , fValue (value) 419 420 { 421 } 422 423 }; 424 425 /******************************************************************************/ 426 427 class tag_srational_ptr: public tag_data_ptr 428 { 429 430 public: 431 432 tag_srational_ptr (uint16 code, 433 const dng_srational *data = NULL, 434 uint32 count = 1) 435 tag_data_ptr(code,ttSRational,count,data)436 : tag_data_ptr (code, ttSRational, count, data) 437 438 { 439 } 440 441 }; 442 443 /******************************************************************************/ 444 445 class tag_real64: public tag_data_ptr 446 { 447 448 private: 449 450 real64 fValue; 451 452 public: 453 454 tag_real64 (uint16 code, 455 real64 value = 0.0) 456 457 : tag_data_ptr (code, ttDouble, 1, &fValue) 458 459 , fValue (value) 460 461 { 462 } 463 Set(real64 value)464 void Set (real64 value) 465 { 466 fValue = value; 467 } 468 469 }; 470 471 /******************************************************************************/ 472 473 class tag_matrix: public tag_srational_ptr 474 { 475 476 private: 477 478 dng_srational fEntry [kMaxColorPlanes * 479 kMaxColorPlanes]; 480 481 public: 482 483 tag_matrix (uint16 code, 484 const dng_matrix &m); 485 486 }; 487 488 /******************************************************************************/ 489 490 class tag_icc_profile: public tag_data_ptr 491 { 492 493 public: 494 495 tag_icc_profile (const void *profileData, uint32 profileSize); 496 497 }; 498 499 /******************************************************************************/ 500 501 class tag_cfa_pattern: public tiff_tag 502 { 503 504 private: 505 506 uint32 fRows; 507 uint32 fCols; 508 509 const uint8 *fPattern; 510 511 public: 512 tag_cfa_pattern(uint16 code,uint32 rows,uint32 cols,const uint8 * pattern)513 tag_cfa_pattern (uint16 code, 514 uint32 rows, 515 uint32 cols, 516 const uint8 *pattern) 517 518 : tiff_tag (code, ttUndefined, 4 + rows * cols) 519 520 , fRows (rows ) 521 , fCols (cols ) 522 , fPattern (pattern) 523 524 { 525 } 526 527 virtual void Put (dng_stream &stream) const; 528 529 private: 530 531 // Hidden copy constructor and assignment operator. 532 533 tag_cfa_pattern (const tag_cfa_pattern &tag); 534 535 tag_cfa_pattern & operator= (const tag_cfa_pattern &tag); 536 537 }; 538 539 /******************************************************************************/ 540 541 class tag_exif_date_time: public tag_data_ptr 542 { 543 544 private: 545 546 char fData [20]; 547 548 public: 549 550 tag_exif_date_time (uint16 code, 551 const dng_date_time &dt); 552 553 }; 554 555 /******************************************************************************/ 556 557 class tag_iptc: public tiff_tag 558 { 559 560 private: 561 562 const void *fData; 563 564 uint32 fLength; 565 566 public: 567 568 tag_iptc (const void *data, 569 uint32 length); 570 571 virtual void Put (dng_stream &stream) const; 572 573 private: 574 575 // Hidden copy constructor and assignment operator. 576 577 tag_iptc (const tag_iptc &tag); 578 579 tag_iptc & operator= (const tag_iptc &tag); 580 581 }; 582 583 /******************************************************************************/ 584 585 class tag_xmp: public tag_uint8_ptr 586 { 587 588 private: 589 590 AutoPtr<dng_memory_block> fBuffer; 591 592 public: 593 594 tag_xmp (const dng_xmp *xmp); 595 596 private: 597 598 // Hidden copy constructor and assignment operator. 599 600 tag_xmp (const tag_xmp &tag); 601 602 tag_xmp & operator= (const tag_xmp &tag); 603 604 }; 605 606 /******************************************************************************/ 607 608 class dng_tiff_directory 609 { 610 611 private: 612 613 enum 614 { 615 kMaxEntries = 100 616 }; 617 618 uint32 fEntries; 619 620 const tiff_tag *fTag [kMaxEntries]; 621 622 uint32 fChained; 623 624 public: 625 dng_tiff_directory()626 dng_tiff_directory () 627 628 : fEntries (0) 629 , fChained (0) 630 631 { 632 } 633 ~dng_tiff_directory()634 virtual ~dng_tiff_directory () 635 { 636 } 637 638 void Add (const tiff_tag *tag); 639 SetChained(uint32 offset)640 void SetChained (uint32 offset) 641 { 642 fChained = offset; 643 } 644 645 uint32 Size () const; 646 647 enum OffsetsBase 648 { 649 offsetsRelativeToStream = 0, 650 offsetsRelativeToExplicitBase = 1, 651 offsetsRelativeToIFD = 2 652 }; 653 654 void Put (dng_stream &stream, 655 OffsetsBase offsetsBase = offsetsRelativeToStream, 656 uint32 explicitBase = 0) const; 657 658 private: 659 660 // Hidden copy constructor and assignment operator. 661 662 dng_tiff_directory (const dng_tiff_directory &dir); 663 664 dng_tiff_directory & operator= (const dng_tiff_directory &dir); 665 666 }; 667 668 /******************************************************************************/ 669 670 class dng_basic_tag_set 671 { 672 673 private: 674 675 tag_uint32 fNewSubFileType; 676 677 tag_uint32 fImageWidth; 678 tag_uint32 fImageLength; 679 680 tag_uint16 fPhotoInterpretation; 681 682 tag_uint16 fFillOrder; 683 684 tag_uint16 fSamplesPerPixel; 685 686 uint16 fBitsPerSampleData [kMaxSamplesPerPixel]; 687 688 tag_uint16_ptr fBitsPerSample; 689 690 bool fStrips; 691 692 tag_uint32 fTileWidth; 693 tag_uint32 fTileLength; 694 695 dng_memory_data fTileInfoBuffer; 696 697 uint32 *fTileOffsetData; 698 699 tag_uint32_ptr fTileOffsets; 700 701 uint32 *fTileByteCountData; 702 703 tag_uint32_ptr fTileByteCounts; 704 705 tag_uint16 fPlanarConfiguration; 706 707 tag_uint16 fCompression; 708 709 tag_uint16 fPredictor; 710 711 uint16 fExtraSamplesData [kMaxSamplesPerPixel]; 712 713 tag_uint16_ptr fExtraSamples; 714 715 uint16 fSampleFormatData [kMaxSamplesPerPixel]; 716 717 tag_uint16_ptr fSampleFormat; 718 719 tag_uint16 fRowInterleaveFactor; 720 721 uint16 fSubTileBlockSizeData [2]; 722 723 tag_uint16_ptr fSubTileBlockSize; 724 725 public: 726 727 dng_basic_tag_set (dng_tiff_directory &directory, 728 const dng_ifd &info); 729 ~dng_basic_tag_set()730 virtual ~dng_basic_tag_set () 731 { 732 } 733 SetTileOffset(uint32 index,uint32 offset)734 void SetTileOffset (uint32 index, 735 uint32 offset) 736 { 737 fTileOffsetData [index] = offset; 738 } 739 SetTileByteCount(uint32 index,uint32 count)740 void SetTileByteCount (uint32 index, 741 uint32 count) 742 { 743 fTileByteCountData [index] = count; 744 } 745 WritingStrips()746 bool WritingStrips () const 747 { 748 return fStrips; 749 } 750 751 private: 752 753 // Hidden copy constructor and assignment operator. 754 755 dng_basic_tag_set (const dng_basic_tag_set &set); 756 757 dng_basic_tag_set & operator= (const dng_basic_tag_set &set); 758 759 }; 760 761 /******************************************************************************/ 762 763 class exif_tag_set 764 { 765 766 protected: 767 768 dng_tiff_directory fExifIFD; 769 dng_tiff_directory fGPSIFD; 770 771 private: 772 773 tag_uint32 fExifLink; 774 tag_uint32 fGPSLink; 775 776 bool fAddedExifLink; 777 bool fAddedGPSLink; 778 779 uint8 fExifVersionData [4]; 780 781 tag_data_ptr fExifVersion; 782 783 tag_urational fExposureTime; 784 tag_srational fShutterSpeedValue; 785 786 tag_urational fFNumber; 787 tag_urational fApertureValue; 788 789 tag_srational fBrightnessValue; 790 791 tag_srational fExposureBiasValue; 792 793 tag_urational fMaxApertureValue; 794 795 tag_urational fSubjectDistance; 796 797 tag_urational fFocalLength; 798 799 tag_uint16 fISOSpeedRatings; 800 801 tag_uint16 fSensitivityType; 802 tag_uint32 fStandardOutputSensitivity; 803 tag_uint32 fRecommendedExposureIndex; 804 tag_uint32 fISOSpeed; 805 tag_uint32 fISOSpeedLatitudeyyy; 806 tag_uint32 fISOSpeedLatitudezzz; 807 808 tag_uint16 fFlash; 809 810 tag_uint16 fExposureProgram; 811 812 tag_uint16 fMeteringMode; 813 814 tag_uint16 fLightSource; 815 816 tag_uint16 fSensingMethod; 817 818 tag_uint16 fFocalLength35mm; 819 820 uint8 fFileSourceData; 821 tag_data_ptr fFileSource; 822 823 uint8 fSceneTypeData; 824 tag_data_ptr fSceneType; 825 826 tag_cfa_pattern fCFAPattern; 827 828 tag_uint16 fCustomRendered; 829 tag_uint16 fExposureMode; 830 tag_uint16 fWhiteBalance; 831 tag_uint16 fSceneCaptureType; 832 tag_uint16 fGainControl; 833 tag_uint16 fContrast; 834 tag_uint16 fSaturation; 835 tag_uint16 fSharpness; 836 tag_uint16 fSubjectDistanceRange; 837 838 tag_urational fDigitalZoomRatio; 839 840 tag_urational fExposureIndex; 841 842 tag_uint32 fImageNumber; 843 844 tag_uint16 fSelfTimerMode; 845 846 tag_string fBatteryLevelA; 847 tag_urational fBatteryLevelR; 848 849 tag_urational fFocalPlaneXResolution; 850 tag_urational fFocalPlaneYResolution; 851 852 tag_uint16 fFocalPlaneResolutionUnit; 853 854 uint16 fSubjectAreaData [4]; 855 856 tag_uint16_ptr fSubjectArea; 857 858 dng_urational fLensInfoData [4]; 859 860 tag_urational_ptr fLensInfo; 861 862 tag_exif_date_time fDateTime; 863 tag_exif_date_time fDateTimeOriginal; 864 tag_exif_date_time fDateTimeDigitized; 865 866 tag_string fSubsecTime; 867 tag_string fSubsecTimeOriginal; 868 tag_string fSubsecTimeDigitized; 869 870 tag_string fMake; 871 tag_string fModel; 872 tag_string fArtist; 873 tag_string fSoftware; 874 tag_string fCopyright; 875 tag_string fImageDescription; 876 877 tag_string fSerialNumber; 878 879 tag_uint16 fMakerNoteSafety; 880 881 tag_data_ptr fMakerNote; 882 883 tag_encoded_text fUserComment; 884 885 char fImageUniqueIDData [33]; 886 887 tag_data_ptr fImageUniqueID; 888 889 // EXIF 2.3 tags. 890 891 tag_string fCameraOwnerName; 892 tag_string fBodySerialNumber; 893 tag_urational_ptr fLensSpecification; 894 tag_string fLensMake; 895 tag_string fLensModel; 896 tag_string fLensSerialNumber; 897 898 uint8 fGPSVersionData [4]; 899 900 tag_uint8_ptr fGPSVersionID; 901 902 tag_string fGPSLatitudeRef; 903 tag_urational_ptr fGPSLatitude; 904 905 tag_string fGPSLongitudeRef; 906 tag_urational_ptr fGPSLongitude; 907 908 tag_uint8 fGPSAltitudeRef; 909 tag_urational fGPSAltitude; 910 911 tag_urational_ptr fGPSTimeStamp; 912 913 tag_string fGPSSatellites; 914 tag_string fGPSStatus; 915 tag_string fGPSMeasureMode; 916 917 tag_urational fGPSDOP; 918 919 tag_string fGPSSpeedRef; 920 tag_urational fGPSSpeed; 921 922 tag_string fGPSTrackRef; 923 tag_urational fGPSTrack; 924 925 tag_string fGPSImgDirectionRef; 926 tag_urational fGPSImgDirection; 927 928 tag_string fGPSMapDatum; 929 930 tag_string fGPSDestLatitudeRef; 931 tag_urational_ptr fGPSDestLatitude; 932 933 tag_string fGPSDestLongitudeRef; 934 tag_urational_ptr fGPSDestLongitude; 935 936 tag_string fGPSDestBearingRef; 937 tag_urational fGPSDestBearing; 938 939 tag_string fGPSDestDistanceRef; 940 tag_urational fGPSDestDistance; 941 942 tag_encoded_text fGPSProcessingMethod; 943 tag_encoded_text fGPSAreaInformation; 944 945 tag_string fGPSDateStamp; 946 947 tag_uint16 fGPSDifferential; 948 949 tag_urational fGPSHPositioningError; 950 951 public: 952 953 exif_tag_set (dng_tiff_directory &directory, 954 const dng_exif &exif, 955 bool makerNoteSafe = false, 956 const void *makerNoteData = NULL, 957 uint32 makerNoteLength = 0, 958 bool insideDNG = false); 959 Locate(uint32 offset)960 void Locate (uint32 offset) 961 { 962 fExifLink.Set (offset); 963 fGPSLink .Set (offset + fExifIFD.Size ()); 964 } 965 Size()966 uint32 Size () const 967 { 968 return fExifIFD.Size () + 969 fGPSIFD .Size (); 970 } 971 Put(dng_stream & stream)972 void Put (dng_stream &stream) const 973 { 974 fExifIFD.Put (stream); 975 fGPSIFD .Put (stream); 976 } 977 978 protected: 979 980 void AddLinks (dng_tiff_directory &directory); 981 982 private: 983 984 // Hidden copy constructor and assignment operator. 985 986 exif_tag_set (const exif_tag_set &set); 987 988 exif_tag_set & operator= (const exif_tag_set &set); 989 990 }; 991 992 /******************************************************************************/ 993 994 class tiff_dng_extended_color_profile: private dng_tiff_directory 995 { 996 997 protected: 998 999 const dng_camera_profile &fProfile; 1000 1001 public: 1002 1003 tiff_dng_extended_color_profile (const dng_camera_profile &profile); 1004 1005 void Put (dng_stream &stream, 1006 bool includeModelRestriction = true); 1007 1008 }; 1009 1010 /*****************************************************************************/ 1011 1012 class tag_dng_noise_profile: public tag_data_ptr 1013 { 1014 1015 protected: 1016 1017 real64 fValues [2 * kMaxColorPlanes]; 1018 1019 public: 1020 1021 explicit tag_dng_noise_profile (const dng_noise_profile &profile); 1022 1023 }; 1024 1025 /*****************************************************************************/ 1026 1027 // Enum to control the subset of metadata to save to a file. 1028 1029 enum dng_metadata_subset 1030 { 1031 1032 kMetadataSubset_CopyrightOnly = 0, 1033 kMetadataSubset_CopyrightAndContact, 1034 kMetadataSubset_AllExceptCameraInfo, 1035 kMetadataSubset_All, 1036 kMetadataSubset_AllExceptLocationInfo, 1037 kMetadataSubset_AllExceptCameraAndLocation, 1038 1039 kMetadataSubset_Last = kMetadataSubset_AllExceptCameraAndLocation 1040 1041 }; 1042 1043 /*****************************************************************************/ 1044 1045 /// \brief Support for writing dng_image or dng_negative instances to a 1046 /// dng_stream in TIFF or DNG format. 1047 1048 class dng_image_writer 1049 { 1050 1051 friend class dng_jpeg_image; 1052 friend class dng_jpeg_image_encode_task; 1053 friend class dng_write_tiles_task; 1054 1055 protected: 1056 1057 enum 1058 { 1059 1060 // Target size for buffer used to copy data to the image. 1061 1062 kImageBufferSize = 128 * 1024 1063 1064 }; 1065 1066 public: 1067 1068 dng_image_writer (); 1069 1070 virtual ~dng_image_writer (); 1071 1072 virtual void EncodeJPEGPreview (dng_host &host, 1073 const dng_image &image, 1074 dng_jpeg_preview &preview, 1075 int32 quality = -1); 1076 1077 virtual void WriteImage (dng_host &host, 1078 const dng_ifd &ifd, 1079 dng_basic_tag_set &basic, 1080 dng_stream &stream, 1081 const dng_image &image, 1082 uint32 fakeChannels = 1); 1083 1084 /// Write a dng_image to a dng_stream in TIFF format. 1085 /// \param host Host interface used for progress updates, abort testing, buffer allocation, etc. 1086 /// \param stream The dng_stream on which to write the TIFF. 1087 /// \param image The actual image data to be written. 1088 /// \param photometricInterpretation Either piBlackIsZero for monochrome or piRGB for RGB images. 1089 /// \param compression Must be ccUncompressed. 1090 /// \param negative or metadata If non-NULL, EXIF, IPTC, and XMP metadata from this negative is written to TIFF. 1091 /// \param space If non-null and color space has an ICC profile, TIFF will be tagged with this 1092 /// profile. No color space conversion of image data occurs. 1093 /// \param resolution If non-NULL, TIFF will be tagged with this resolution. 1094 /// \param thumbnail If non-NULL, will be stored in TIFF as preview image. 1095 /// \param imageResources If non-NULL, will image resources be stored in TIFF as well. 1096 /// \param metadataSubset The subset of metadata (e.g., copyright only) to include in the TIFF. 1097 1098 void WriteTIFF (dng_host &host, 1099 dng_stream &stream, 1100 const dng_image &image, 1101 uint32 photometricInterpretation, 1102 uint32 compression, 1103 dng_negative *negative, 1104 const dng_color_space *space = NULL, 1105 const dng_resolution *resolution = NULL, 1106 const dng_jpeg_preview *thumbnail = NULL, 1107 const dng_memory_block *imageResources = NULL, 1108 dng_metadata_subset metadataSubset = kMetadataSubset_All); 1109 1110 void WriteTIFF (dng_host &host, 1111 dng_stream &stream, 1112 const dng_image &image, 1113 uint32 photometricInterpretation = piBlackIsZero, 1114 uint32 compression = ccUncompressed, 1115 const dng_metadata *metadata = NULL, 1116 const dng_color_space *space = NULL, 1117 const dng_resolution *resolution = NULL, 1118 const dng_jpeg_preview *thumbnail = NULL, 1119 const dng_memory_block *imageResources = NULL, 1120 dng_metadata_subset metadataSubset = kMetadataSubset_All); 1121 1122 /// Write a dng_image to a dng_stream in TIFF format. 1123 /// \param host Host interface used for progress updates, abort testing, buffer allocation, etc. 1124 /// \param stream The dng_stream on which to write the TIFF. 1125 /// \param image The actual image data to be written. 1126 /// \param photometricInterpretation Either piBlackIsZero for monochrome or piRGB for RGB images. 1127 /// \param compression Must be ccUncompressed. 1128 /// \param negative or metadata If non-NULL, EXIF, IPTC, and XMP metadata from this negative is written to TIFF. 1129 /// \param profileData If non-null, TIFF will be tagged with this profile. No color space conversion 1130 /// of image data occurs. 1131 /// \param profileSize The size for the profile data. 1132 /// \param resolution If non-NULL, TIFF will be tagged with this resolution. 1133 /// \param thumbnail If non-NULL, will be stored in TIFF as preview image. 1134 /// \param imageResources If non-NULL, will image resources be stored in TIFF as well. 1135 /// \param metadataSubset The subset of metadata (e.g., copyright only) to include in the TIFF. 1136 1137 void WriteTIFFWithProfile (dng_host &host, 1138 dng_stream &stream, 1139 const dng_image &image, 1140 uint32 photometricInterpretation, 1141 uint32 compression, 1142 dng_negative *negative, 1143 const void *profileData = NULL, 1144 uint32 profileSize = 0, 1145 const dng_resolution *resolution = NULL, 1146 const dng_jpeg_preview *thumbnail = NULL, 1147 const dng_memory_block *imageResources = NULL, 1148 dng_metadata_subset metadataSubset = kMetadataSubset_All); 1149 1150 virtual void WriteTIFFWithProfile (dng_host &host, 1151 dng_stream &stream, 1152 const dng_image &image, 1153 uint32 photometricInterpretation = piBlackIsZero, 1154 uint32 compression = ccUncompressed, 1155 const dng_metadata *metadata = NULL, 1156 const void *profileData = NULL, 1157 uint32 profileSize = 0, 1158 const dng_resolution *resolution = NULL, 1159 const dng_jpeg_preview *thumbnail = NULL, 1160 const dng_memory_block *imageResources = NULL, 1161 dng_metadata_subset metadataSubset = kMetadataSubset_All); 1162 1163 /// Write a dng_image to a dng_stream in DNG format. 1164 /// \param host Host interface used for progress updates, abort testing, buffer allocation, etc. 1165 /// \param stream The dng_stream on which to write the TIFF. 1166 /// \param negative The image data and metadata (EXIF, IPTC, XMP) to be written. 1167 /// \param previewList List of previews (not counting thumbnail) to write to the file. Defaults to empty. 1168 /// \param maxBackwardVersion The DNG file should be readable by readers at least back to this version. 1169 /// \param uncompressed True to force uncompressed images. Otherwise use normal compression. 1170 1171 void WriteDNG (dng_host &host, 1172 dng_stream &stream, 1173 dng_negative &negative, 1174 const dng_preview_list *previewList = NULL, 1175 uint32 maxBackwardVersion = dngVersion_SaveDefault, 1176 bool uncompressed = false); 1177 1178 /// Write a dng_image to a dng_stream in DNG format. 1179 /// \param host Host interface used for progress updates, abort testing, buffer allocation, etc. 1180 /// \param stream The dng_stream on which to write the TIFF. 1181 /// \param negative The image data to be written. 1182 /// \param metadata The metadata (EXIF, IPTC, XMP) to be written. 1183 /// \param previewList List of previews (not counting thumbnail) to write to the file. Defaults to empty. 1184 /// \param maxBackwardVersion The DNG file should be readable by readers at least back to this version. 1185 /// \param uncompressed True to force uncompressed images. Otherwise use normal compression. 1186 1187 virtual void WriteDNG (dng_host &host, 1188 dng_stream &stream, 1189 const dng_negative &negative, 1190 const dng_metadata &metadata, 1191 const dng_preview_list *previewList = NULL, 1192 uint32 maxBackwardVersion = dngVersion_SaveDefault, 1193 bool uncompressed = false); 1194 1195 /// Resolve metadata conflicts and apply metadata policies in keeping 1196 /// with Metadata Working Group (MWG) guidelines. 1197 1198 virtual void CleanUpMetadata (dng_host &host, 1199 dng_metadata &metadata, 1200 dng_metadata_subset metadataSubset, 1201 const char *dstMIMI, 1202 const char *software = NULL); 1203 1204 protected: 1205 1206 virtual uint32 CompressedBufferSize (const dng_ifd &ifd, 1207 uint32 uncompressedSize); 1208 1209 virtual void EncodePredictor (dng_host &host, 1210 const dng_ifd &ifd, 1211 dng_pixel_buffer &buffer, 1212 AutoPtr<dng_memory_block> &tempBuffer); 1213 1214 virtual void ByteSwapBuffer (dng_host &host, 1215 dng_pixel_buffer &buffer); 1216 1217 void ReorderSubTileBlocks (const dng_ifd &ifd, 1218 dng_pixel_buffer &buffer, 1219 AutoPtr<dng_memory_block> &uncompressedBuffer, 1220 AutoPtr<dng_memory_block> &subTileBlockBuffer); 1221 1222 virtual void WriteData (dng_host &host, 1223 const dng_ifd &ifd, 1224 dng_stream &stream, 1225 dng_pixel_buffer &buffer, 1226 AutoPtr<dng_memory_block> &compressedBuffer); 1227 1228 virtual void WriteTile (dng_host &host, 1229 const dng_ifd &ifd, 1230 dng_stream &stream, 1231 const dng_image &image, 1232 const dng_rect &tileArea, 1233 uint32 fakeChannels, 1234 AutoPtr<dng_memory_block> &compressedBuffer, 1235 AutoPtr<dng_memory_block> &uncompressedBuffer, 1236 AutoPtr<dng_memory_block> &subTileBlockBuffer, 1237 AutoPtr<dng_memory_block> &tempBuffer); 1238 1239 }; 1240 1241 /*****************************************************************************/ 1242 1243 #endif 1244 1245 /*****************************************************************************/ 1246