stlab.adobe.com

Documentation Overview Building ASL Documentation Library Wiki Docs Indices Browse Perforce More Info Release Notes Wiki Site Search License Success Stories Contributors Media Download Perforce Depots Support ASL SourceForge Home Mailing Lists Discussion Forums Report Bugs Suggest Features Contribute to ASL RSS Short-text news Full-text news File releases Other Adobe Projects Adobe Air Adobe GIL Adobe Labs Adobe Media Gallery Adobe XMP Tamarin project (Mozilla Foundation) Other Resources Boost RIAForge SGI STL

dng_camera_profile.h Go to the documentation of this file. /******************************************************************************/ // Copyright 2006-2007 Adobe Systems Incorporated // All Rights Reserved. // // NOTICE: Adobe permits you to use, modify, and distribute this file in // accordance with the terms of the Adobe license agreement accompanying it. /******************************************************************************/ /* $Id: //mondo/dng_sdk_1_2/dng_sdk/source/dng_camera_profile.h#1 $ */ /* $DateTime: 2008/03/09 14:29:54 $ */ /* $Change: 431850 $ */ /* $Author: tknoll $ */ #ifndef __dng_camera_profile__ #define __dng_camera_profile__ /******************************************************************************/ #include "dng_assertions.h" #include "dng_classes.h" #include "dng_fingerprint.h" #include "dng_hue_sat_map.h" #include "dng_matrix.h" #include "dng_string.h" #include "dng_tag_values.h" #include "dng_tone_curve.h" /******************************************************************************/ extern const char * kProfileName_Embedded; extern const char * kAdobeCalibrationSignature; /******************************************************************************/ class dng_camera_profile_id { private: dng_string fName; dng_fingerprint fFingerprint; public: dng_camera_profile_id () : fName () , fFingerprint () { } dng_camera_profile_id (const char *name) : fName () , fFingerprint () { fName.Set (name); } dng_camera_profile_id (const dng_string &name) : fName (name) , fFingerprint () { } dng_camera_profile_id (const char *name, const dng_fingerprint &fingerprint) : fName () , fFingerprint (fingerprint) { fName.Set (name); DNG_ASSERT (!fFingerprint.IsValid () || fName.NotEmpty (), "Cannot have profile fingerprint without name"); } dng_camera_profile_id (const dng_string &name, const dng_fingerprint &fingerprint) : fName (name) , fFingerprint (fingerprint) { DNG_ASSERT (!fFingerprint.IsValid () || fName.NotEmpty (), "Cannot have profile fingerprint without name"); } const dng_string & Name () const { return fName; } const dng_fingerprint & Fingerprint () const { return fFingerprint; } bool operator== (const dng_camera_profile_id &id) const { return fName == id.fName && fFingerprint == id.fFingerprint; } bool operator!= (const dng_camera_profile_id &id) const { return !(*this == id); } bool IsValid () const { return fName.NotEmpty (); // Fingerprint is optional. } void Clear () { *this = dng_camera_profile_id (); } }; /******************************************************************************/ class dng_camera_profile { protected: // Name of this camera profile. dng_string fName; // Light sources for up to two calibrations. These use the EXIF // encodings for illuminant and are used to distinguish which // matrix to use. uint32 fCalibrationIlluminant1; uint32 fCalibrationIlluminant2; // Color matrices for up to two calibrations. // These matrices map XYZ values to non-white balanced camera values. // Adobe needs to go that direction in order to determine the clipping // points for highlight recovery logic based on the white point. If // cameras were all 3-color, the matrix could be stored as a forward matrix, // but we need the backwards matrix to deal with 4-color cameras. dng_matrix fColorMatrix1; dng_matrix fColorMatrix2; // These matrices map white balanced camera values to XYZ chromatically // adapted to D50 (the ICC profile PCS white point). If the matrices // exist, then this implies that white balancing should be done by scaling // camera values with a diagonal matrix. dng_matrix fForwardMatrix1; dng_matrix fForwardMatrix2; // Dimensionality reduction hints for more than three color cameras. // This is an optional matrix that maps the camera's color components // to 3 components. These are only used if the forward matrices don't // exist, and are used invert the color matrices. dng_matrix fReductionMatrix1; dng_matrix fReductionMatrix2; // MD5 hash for all data bits of the profile. mutable dng_fingerprint fFingerprint; // Copyright notice from creator of profile. dng_string fCopyright; // Rules for how this profile can be embedded and/or copied. uint32 fEmbedPolicy; // 2-D hue/sat tables to modify colors. dng_hue_sat_map fHueSatDeltas1; dng_hue_sat_map fHueSatDeltas2; // The "as shot" tone curve for this profile. Check IsValid method // to tell if one exists in profile. dng_tone_curve fToneCurve; // If this string matches the fCameraCalibrationSignature of the // negative, then use the calibration matrix values from the negative. dng_string fProfileCalibrationSignature; // If non-empty, only allow use of this profile with camera having // same unique model name. dng_string fUniqueCameraModelRestriction; // Was this profile read from inside a DNG file? (If so, we wnat // to be sure to include it again when writing out an updated // DNG file) bool fWasReadFromDNG; public: dng_camera_profile (); virtual ~dng_camera_profile (); // API for profile name: void SetName (const char *name) { fName.Set (name); ClearFingerprint (); } const dng_string & Name () const { return fName; } bool NameIsEmbedded () const { return fName.Matches (kProfileName_Embedded, true); } // API for calibration illuminants: void SetCalibrationIlluminant1 (uint32 light) { fCalibrationIlluminant1 = light; ClearFingerprint (); } void SetCalibrationIlluminant2 (uint32 light) { fCalibrationIlluminant2 = light; ClearFingerprint (); } uint32 CalibrationIlluminant1 () const { return fCalibrationIlluminant1; } uint32 CalibrationIlluminant2 () const { return fCalibrationIlluminant2; } real64 CalibrationTemperature1 () const { return IlluminantToTemperature (CalibrationIlluminant1 ()); } real64 CalibrationTemperature2 () const { return IlluminantToTemperature (CalibrationIlluminant2 ()); } // API for color matrices: static void NormalizeColorMatrix (dng_matrix &m); void SetColorMatrix1 (const dng_matrix &m); void SetColorMatrix2 (const dng_matrix &m); bool HasColorMatrix1 () const; bool HasColorMatrix2 () const; const dng_matrix & ColorMatrix1 () const { return fColorMatrix1; } const dng_matrix & ColorMatrix2 () const { return fColorMatrix2; } // API for forward matrices: static void NormalizeForwardMatrix (dng_matrix &m); void SetForwardMatrix1 (const dng_matrix &m); void SetForwardMatrix2 (const dng_matrix &m); const dng_matrix & ForwardMatrix1 () const { return fForwardMatrix1; } const dng_matrix & ForwardMatrix2 () const { return fForwardMatrix2; } // API for reduction matrices: void SetReductionMatrix1 (const dng_matrix &m); void SetReductionMatrix2 (const dng_matrix &m); const dng_matrix & ReductionMatrix1 () const { return fReductionMatrix1; } const dng_matrix & ReductionMatrix2 () const { return fReductionMatrix2; } const dng_fingerprint &Fingerprint () const { if (!fFingerprint.IsValid ()) CalculateFingerprint (); return fFingerprint; } dng_camera_profile_id ProfileID () const { return dng_camera_profile_id (Name (), Fingerprint ()); } void SetCopyright (const char *copyright) { fCopyright.Set (copyright); ClearFingerprint (); } const dng_string & Copyright () const { return fCopyright; } // Accessors for embed policy. void SetEmbedPolicy (uint32 policy) { fEmbedPolicy = policy; ClearFingerprint (); } uint32 EmbedPolicy () const { return fEmbedPolicy; } bool IsLegalToEmbed () const { return WasReadFromDNG () || EmbedPolicy () == pepAllowCopying || EmbedPolicy () == pepEmbedIfUsed || EmbedPolicy () == pepNoRestrictions; } // Accessors for hue sat maps. bool HasHueSatDeltas () const { return fHueSatDeltas1.IsValid (); } const dng_hue_sat_map &HueSatDeltas1 () const { return fHueSatDeltas1; } void SetHueSatDeltas1 (dng_hue_sat_map &deltas1); const dng_hue_sat_map &HueSatDeltas2 () const { return fHueSatDeltas2; } void SetHueSatDeltas2 (dng_hue_sat_map &deltas2); // Accessors for tone curve. const dng_tone_curve & ToneCurve () const { return fToneCurve; } void SetToneCurve (const dng_tone_curve &curve) { fToneCurve = curve; ClearFingerprint (); } // Accessors for profile calibration signature. void SetProfileCalibrationSignature (const char *signature) { fProfileCalibrationSignature.Set (signature); } const dng_string & ProfileCalibrationSignature () const { return fProfileCalibrationSignature; } void SetUniqueCameraModelRestriction (const char *camera) { fUniqueCameraModelRestriction.Set (camera); // Not included in fingerprint, so don't need ClearFingerprint (). } const dng_string & UniqueCameraModelRestriction () const { return fUniqueCameraModelRestriction; } // Accessors for was read from DNG flag. void SetWasReadFromDNG (bool state = true) { fWasReadFromDNG = state; } bool WasReadFromDNG () const { return fWasReadFromDNG; } bool IsValid (uint32 channels) const; bool EqualData (const dng_camera_profile &profile) const; void Parse (dng_stream &stream, dng_camera_profile_info &profileInfo); bool ParseExtended (dng_stream &stream); virtual void SetFourColorBayer (); dng_hue_sat_map * HueSatMapForWhite (const dng_xy_coord &white) const; protected: static real64 IlluminantToTemperature (uint32 light); void ClearFingerprint () { fFingerprint.Clear (); } void CalculateFingerprint () const; static bool ValidForwardMatrix (const dng_matrix &m); static void ReadHueSatMap (dng_stream &stream, dng_hue_sat_map &hueSatMap, uint32 hues, uint32 sats, uint32 vals, bool skipSat0); }; /******************************************************************************/ #endif /******************************************************************************/

• Company | 
• Online Privacy Policy | 
• Terms of Use | 
• Contact Us | 
• Accessibility | 
• Report Piracy | 
• Permissions & Trademarks | 
• Product License Agreements | 
• Send Feedback

Copyright © 2006-2008 Adobe Systems Incorporated.

Use of this website signifies your agreement to the Terms of Use and Online Privacy Policy.

Search powered by Google