1/*****************************************************************************/ 2// Copyright 2006-2007 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_mosaic_info.h#1 $ */ 10/* $DateTime: 2012/05/30 13:28:51 $ */ 11/* $Change: 832332 $ */ 12/* $Author: tknoll $ */ 13 14/** \file 15 * Support for descriptive information about color filter array patterns. 16 */ 17 18/*****************************************************************************/ 19 20#ifndef __dng_mosaic_info__ 21#define __dng_mosaic_info__ 22 23/*****************************************************************************/ 24 25#include "dng_classes.h" 26#include "dng_rect.h" 27#include "dng_sdk_limits.h" 28#include "dng_types.h" 29 30/*****************************************************************************/ 31 32/// \brief Support for describing color filter array patterns and manipulating mosaic sample data. 33/// 34/// See CFAPattern tag in \ref spec_tiff_ep "TIFF/EP specification" and CFAPlaneColor, CFALayout, and BayerGreenSplit 35/// tags in the \ref spec_dng "DNG 1.1.0 specification". 36 37class dng_mosaic_info 38 { 39 40 public: 41 42 /// Size of fCFAPattern. 43 44 dng_point fCFAPatternSize; 45 46 /// CFA pattern from CFAPattern tag in the \ref spec_tiff_ep "TIFF/EP specification." 47 48 uint8 fCFAPattern [kMaxCFAPattern] [kMaxCFAPattern]; 49 50 /// Number of color planes in DNG input. 51 52 uint32 fColorPlanes; 53 54 uint8 fCFAPlaneColor [kMaxColorPlanes]; 55 56 /// Value of CFALayout tag in the \ref spec_dng "DNG 1.3 specification." 57 /// CFALayout describes the spatial layout of the CFA. The currently defined values are: 58 /// - 1 = Rectangular (or square) layout. 59 /// - 2 = Staggered layout A: even columns are offset down by 1/2 row. 60 /// - 3 = Staggered layout B: even columns are offset up by 1/2 row. 61 /// - 4 = Staggered layout C: even rows are offset right by 1/2 column. 62 /// - 5 = Staggered layout D: even rows are offset left by 1/2 column. 63 /// - 6 = Staggered layout E: even rows are offset up by 1/2 row, even columns are offset left by 1/2 column. 64 /// - 7 = Staggered layout F: even rows are offset up by 1/2 row, even columns are offset right by 1/2 column. 65 /// - 8 = Staggered layout G: even rows are offset down by 1/2 row, even columns are offset left by 1/2 column. 66 /// - 9 = Staggered layout H: even rows are offset down by 1/2 row, even columns are offset right by 1/2 column. 67 68 uint32 fCFALayout; 69 70 /// Value of BayerGreeSplit tag in DNG file. 71 /// BayerGreenSplit only applies to CFA images using a Bayer pattern filter array. This tag 72 /// specifies, in arbitrary units, how closely the values of the green pixels in the blue/green rows 73 /// track the values of the green pixels in the red/green rows. 74 /// 75 /// A value of zero means the two kinds of green pixels track closely, while a non-zero value 76 /// means they sometimes diverge. The useful range for this tag is from 0 (no divergence) to about 77 /// 5000 (large divergence). 78 79 uint32 fBayerGreenSplit; 80 81 protected: 82 83 dng_point fSrcSize; 84 85 dng_point fCroppedSize; 86 87 real64 fAspectRatio; 88 89 public: 90 91 dng_mosaic_info (); 92 93 virtual ~dng_mosaic_info (); 94 95 virtual void Parse (dng_host &host, 96 dng_stream &stream, 97 dng_info &info); 98 99 virtual void PostParse (dng_host &host, 100 dng_negative &negative); 101 102 /// Returns whether the RAW data in this DNG file from a color filter array (mosaiced) source. 103 /// \retval true if this DNG file is from a color filter array (mosiaced) source. 104 105 bool IsColorFilterArray () const 106 { 107 return fCFAPatternSize != dng_point (0, 0); 108 } 109 110 /// Enable generating four-plane output from three-plane Bayer input. 111 /// Extra plane is a second version of the green channel. First green is produced 112 /// using green mosaic samples from one set of rows/columns (even/odd) and the second 113 /// green channel is produced using the other set of rows/columns. One can compare the 114 /// two versions to judge whether BayerGreenSplit needs to be set for a given input source. 115 116 virtual bool SetFourColorBayer (); 117 118 /// Returns scaling factor relative to input size needed to capture output data. 119 /// Staggered (or rotated) sensing arrays are produced to a larger output than the number of input samples. 120 /// This method indicates how much larger. 121 /// \retval a point with integer scaling factors for the horizotal and vertical dimensions. 122 123 virtual dng_point FullScale () const; 124 125 /// Returns integer factors by which mosaic data must be downsampled to produce an image which is as close 126 /// to prefSize as possible in longer dimension, but no smaller than minSize. 127 /// \param minSize Number of pixels as minium for longer dimension of downsampled image. 128 /// \param prefSize Number of pixels as target for longer dimension of downsampled image. 129 /// \param cropFactor Faction of the image to be used after cropping. 130 /// \retval Point containing integer factors by which image must be downsampled. 131 132 virtual dng_point DownScale (uint32 minSize, 133 uint32 prefSize, 134 real64 cropFactor) const; 135 136 /// Return size of demosaiced image for passed in downscaling factor. 137 /// \param downScale Integer downsampling factor obtained from DownScale method. 138 /// \retval Size of resulting demosaiced image. 139 140 virtual dng_point DstSize (const dng_point &downScale) const; 141 142 /// Demosaic interpolation of a single plane for non-downsampled case. 143 /// \param host dng_host to use for buffer allocation requests, user cancellation testing, and progress updates. 144 /// \param negative DNG negative of mosaiced data. 145 /// \param srcImage Source image for mosaiced data. 146 /// \param dstImage Destination image for resulting interpolated data. 147 /// \param srcPlane Which plane to interpolate. 148 149 virtual void InterpolateGeneric (dng_host &host, 150 dng_negative &negative, 151 const dng_image &srcImage, 152 dng_image &dstImage, 153 uint32 srcPlane = 0) const; 154 155 /// Demosaic interpolation of a single plane for downsampled case. 156 /// \param host dng_host to use for buffer allocation requests, user cancellation testing, and progress updates. 157 /// \param negative DNG negative of mosaiced data. 158 /// \param srcImage Source image for mosaiced data. 159 /// \param dstImage Destination image for resulting interpolated data. 160 /// \param downScale Amount (in horizontal and vertical) by which to subsample image. 161 /// \param srcPlane Which plane to interpolate. 162 163 virtual void InterpolateFast (dng_host &host, 164 dng_negative &negative, 165 const dng_image &srcImage, 166 dng_image &dstImage, 167 const dng_point &downScale, 168 uint32 srcPlane = 0) const; 169 170 /// Demosaic interpolation of a single plane. Chooses between generic and fast interpolators based on parameters. 171 /// \param host dng_host to use for buffer allocation requests, user cancellation testing, and progress updates. 172 /// \param negative DNG negative of mosaiced data. 173 /// \param srcImage Source image for mosaiced data. 174 /// \param dstImage Destination image for resulting interpolated data. 175 /// \param downScale Amount (in horizontal and vertical) by which to subsample image. 176 /// \param srcPlane Which plane to interpolate. 177 178 virtual void Interpolate (dng_host &host, 179 dng_negative &negative, 180 const dng_image &srcImage, 181 dng_image &dstImage, 182 const dng_point &downScale, 183 uint32 srcPlane = 0) const; 184 185 protected: 186 187 virtual bool IsSafeDownScale (const dng_point &downScale) const; 188 189 uint32 SizeForDownScale (const dng_point &downScale) const; 190 191 virtual bool ValidSizeDownScale (const dng_point &downScale, 192 uint32 minSize) const; 193 194 }; 195 196/*****************************************************************************/ 197 198#endif 199 200/*****************************************************************************/ 201