source/dng_misc_opcodes.h - platform/external/dng_sdk - Git at Google

 /*****************************************************************************/
 // Copyright 2008-2009 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_4/dng_sdk/source/dng_misc_opcodes.h#2 $ */
 /* $DateTime: 2012/08/02 06:09:06 $ */
 /* $Change: 841096 $ */
 /* $Author: erichan $ */

 /** \file
  * Miscellaneous DNG opcodes.
  */

 /*****************************************************************************/

 #ifndef __dng_misc_opcodes__
 #define __dng_misc_opcodes__

 /*****************************************************************************/

 #include "dng_opcodes.h"

 /*****************************************************************************/

 /// \brief Opcode to trim image to a specified rectangle.

 class dng_opcode_TrimBounds: public dng_opcode
 	{

 	private:

 		dng_rect fBounds;

 	public:

 		/// Create opcode to trim image to the specified bounds.

 		dng_opcode_TrimBounds (const dng_rect &bounds);

 		dng_opcode_TrimBounds (dng_stream &stream);

 		virtual void PutData (dng_stream &stream) const;

 		virtual void Apply (dng_host &host,
 							dng_negative &negative,
 							AutoPtr<dng_image> &image);

 	};

 /*****************************************************************************/

 /// \brief A class to describe an area of an image, including a pixel subrectangle,
 /// plane range, and row/column pitch (e.g., for mosaic images). Useful for
 /// specifying opcodes that only apply to specific color planes or pixel types (e.g.,
 /// only one of the two green Bayer pixels).

 class dng_area_spec
 	{

 	public:

 		enum
 			{
 			kDataSize = 32
 			};

 	private:

 		dng_rect fArea;

 		uint32 fPlane;
 		uint32 fPlanes;

 		uint32 fRowPitch;
 		uint32 fColPitch;

 	public:

 		/// Create an empty area.

 		dng_area_spec (const dng_rect &area = dng_rect (),
 					   uint32 plane = 0,
 					   uint32 planes = 1,
 					   uint32 rowPitch = 1,
 					   uint32 colPitch = 1)

 			:	fArea     (area)
 			,	fPlane    (plane)
 			,	fPlanes   (planes)
 			,	fRowPitch (rowPitch)
 			,	fColPitch (colPitch)

 			{
 			}

 		/// The pixel area.

 		const dng_rect & Area () const
 			{
 			return fArea;
 			}

 		/// The first plane.

 		const uint32 Plane () const
 			{
 			return fPlane;
 			}

 		/// The total number of planes.

 		const uint32 Planes () const
 			{
 			return fPlanes;
 			}

 		/// The row pitch (i.e., stride). A pitch of 1 means all rows.

 		const uint32 RowPitch () const
 			{
 			return fRowPitch;
 			}

 		/// The column pitch (i.e., stride). A pitch of 1 means all columns.

 		const uint32 ColPitch () const
 			{
 			return fColPitch;
 			}

 		/// Read area data from the specified stream.

 		void GetData (dng_stream &stream);

 		/// Write area data to the specified stream.

 		void PutData (dng_stream &stream) const;

 		/// Compute and return pixel area overlap (i.e., intersection) between this
 		/// area and the specified tile.

 		dng_rect Overlap (const dng_rect &tile) const;

 	};

 /*****************************************************************************/

 /// \brief An opcode to apply a 1D function (represented as a 16-bit table) to an
 /// image area.

 class dng_opcode_MapTable: public dng_inplace_opcode
 	{

 	private:

 		dng_area_spec fAreaSpec;

 		AutoPtr<dng_memory_block> fTable;

 		uint32 fCount;

 	public:

 		/// Create a MapTable opcode with the specified area, table, and number of
 		/// table entries.

 		dng_opcode_MapTable (dng_host &host,
 							 const dng_area_spec &areaSpec,
 							 const uint16 *table,
 							 uint32 count = 0x10000);

 		dng_opcode_MapTable (dng_host &host,
 							 dng_stream &stream);

 		virtual void PutData (dng_stream &stream) const;

 		virtual uint32 BufferPixelType (uint32 imagePixelType);

 		virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

 		virtual void ProcessArea (dng_negative &negative,
 								  uint32 threadIndex,
 								  dng_pixel_buffer &buffer,
 								  const dng_rect &dstArea,
 								  const dng_rect &imageBounds);

 	private:

 		void ReplicateLastEntry ();

 	};

 /*****************************************************************************/

 /// \brief An opcode to apply a 1D function (represented as a polynomial) to an
 /// image area.

 class dng_opcode_MapPolynomial: public dng_inplace_opcode
 	{

 	public:

 		enum
 			{
 			kMaxDegree = 8
 			};

 	private:

 		dng_area_spec fAreaSpec;

 		uint32 fDegree;

 		real64 fCoefficient [kMaxDegree + 1];

 		real32 fCoefficient32 [kMaxDegree + 1];

 	public:

 		/// Create a MapPolynomial opcode with the specified area, polynomial
 		/// degree, and polynomial coefficients. The function that will be
 		/// applied to each pixel x is:
 		///
 		/// f (x) = coefficient [0] + ((x	* coefficient [1]) +
 		///							   (x^2 * coefficient [2]) +
 		///							   (x^3 * coefficient [3]) +
 		///							   (x^4 * coefficient [4]) ...

 		dng_opcode_MapPolynomial (const dng_area_spec &areaSpec,
 								  uint32 degree,
 								  const real64 *coefficient);

 		dng_opcode_MapPolynomial (dng_stream &stream);

 		virtual void PutData (dng_stream &stream) const;

 		virtual uint32 BufferPixelType (uint32 imagePixelType);

 		virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

 		virtual void ProcessArea (dng_negative &negative,
 								  uint32 threadIndex,
 								  dng_pixel_buffer &buffer,
 								  const dng_rect &dstArea,
 								  const dng_rect &imageBounds);

 	};

 /*****************************************************************************/

 /// \brief An opcode to apply a delta (i.e., offset) that varies per row. Within
 /// a row, the same delta value is applied to all specified pixels.

 class dng_opcode_DeltaPerRow: public dng_inplace_opcode
 	{

 	private:

 		dng_area_spec fAreaSpec;

 		AutoPtr<dng_memory_block> fTable;

 		real32 fScale;

 	public:

 		/// Create a DeltaPerRow opcode with the specified area and row deltas
 		/// (specified as a table of 32-bit floats).

 		dng_opcode_DeltaPerRow (const dng_area_spec &areaSpec,
 								AutoPtr<dng_memory_block> &table);

 		dng_opcode_DeltaPerRow (dng_host &host,
 								dng_stream &stream);

 		virtual void PutData (dng_stream &stream) const;

 		virtual uint32 BufferPixelType (uint32 imagePixelType);

 		virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

 		virtual void ProcessArea (dng_negative &negative,
 								  uint32 threadIndex,
 								  dng_pixel_buffer &buffer,
 								  const dng_rect &dstArea,
 								  const dng_rect &imageBounds);

 	};

 /*****************************************************************************/

 /// \brief An opcode to apply a delta (i.e., offset) that varies per column.
 /// Within a column, the same delta value is applied to all specified pixels.

 class dng_opcode_DeltaPerColumn: public dng_inplace_opcode
 	{

 	private:

 		dng_area_spec fAreaSpec;

 		AutoPtr<dng_memory_block> fTable;

 		real32 fScale;

 	public:

 		/// Create a DeltaPerColumn opcode with the specified area and column
 		/// deltas (specified as a table of 32-bit floats).

 		dng_opcode_DeltaPerColumn (const dng_area_spec &areaSpec,
 								   AutoPtr<dng_memory_block> &table);

 		dng_opcode_DeltaPerColumn (dng_host &host,
 								   dng_stream &stream);

 		virtual void PutData (dng_stream &stream) const;

 		virtual uint32 BufferPixelType (uint32 imagePixelType);

 		virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

 		virtual void ProcessArea (dng_negative &negative,
 								  uint32 threadIndex,
 								  dng_pixel_buffer &buffer,
 								  const dng_rect &dstArea,
 								  const dng_rect &imageBounds);

 	};

 /*****************************************************************************/

 /// \brief An opcode to apply a scale factor that varies per row. Within a row,
 /// the same scale factor is applied to all specified pixels.

 class dng_opcode_ScalePerRow: public dng_inplace_opcode
 	{

 	private:

 		dng_area_spec fAreaSpec;

 		AutoPtr<dng_memory_block> fTable;

 	public:

 		/// Create a ScalePerRow opcode with the specified area and row scale
 		/// factors (specified as a table of 32-bit floats).

 		dng_opcode_ScalePerRow (const dng_area_spec &areaSpec,
 								AutoPtr<dng_memory_block> &table);

 		dng_opcode_ScalePerRow (dng_host &host,
 								dng_stream &stream);

 		virtual void PutData (dng_stream &stream) const;

 		virtual uint32 BufferPixelType (uint32 imagePixelType);

 		virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

 		virtual void ProcessArea (dng_negative &negative,
 								  uint32 threadIndex,
 								  dng_pixel_buffer &buffer,
 								  const dng_rect &dstArea,
 								  const dng_rect &imageBounds);

 	};

 /*****************************************************************************/

 /// \brief An opcode to apply a scale factor that varies per column. Within a
 /// column, the same scale factor is applied to all specified pixels.

 class dng_opcode_ScalePerColumn: public dng_inplace_opcode
 	{

 	private:

 		dng_area_spec fAreaSpec;

 		AutoPtr<dng_memory_block> fTable;

 	public:

 		/// Create a ScalePerColumn opcode with the specified area and column
 		/// scale factors (specified as a table of 32-bit floats).

 		dng_opcode_ScalePerColumn (const dng_area_spec &areaSpec,
 								   AutoPtr<dng_memory_block> &table);

 		dng_opcode_ScalePerColumn (dng_host &host,
 								   dng_stream &stream);

 		virtual void PutData (dng_stream &stream) const;

 		virtual uint32 BufferPixelType (uint32 imagePixelType);

 		virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

 		virtual void ProcessArea (dng_negative &negative,
 								  uint32 threadIndex,
 								  dng_pixel_buffer &buffer,
 								  const dng_rect &dstArea,
 								  const dng_rect &imageBounds);

 	};

 /*****************************************************************************/

 #endif

 /*****************************************************************************/
	/*****************************************************************************/
	// Copyright 2008-2009 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_4/dng_sdk/source/dng_misc_opcodes.h#2 $ */
	/* $DateTime: 2012/08/02 06:09:06 $ */
	/* $Change: 841096 $ */
	/* $Author: erichan $ */

	/** \file
	* Miscellaneous DNG opcodes.
	*/

	/*****************************************************************************/

	#ifndef __dng_misc_opcodes__
	#define __dng_misc_opcodes__

	/*****************************************************************************/

	#include "dng_opcodes.h"

	/*****************************************************************************/

	/// \brief Opcode to trim image to a specified rectangle.

	class dng_opcode_TrimBounds: public dng_opcode
	{

	private:

	dng_rect fBounds;

	public:

	/// Create opcode to trim image to the specified bounds.

	dng_opcode_TrimBounds (const dng_rect &bounds);

	dng_opcode_TrimBounds (dng_stream &stream);

	virtual void PutData (dng_stream &stream) const;

	virtual void Apply (dng_host &host,
	dng_negative &negative,
	AutoPtr<dng_image> &image);

	};

	/*****************************************************************************/

	/// \brief A class to describe an area of an image, including a pixel subrectangle,
	/// plane range, and row/column pitch (e.g., for mosaic images). Useful for
	/// specifying opcodes that only apply to specific color planes or pixel types (e.g.,
	/// only one of the two green Bayer pixels).

	class dng_area_spec
	{

	public:

	enum
	{
	kDataSize = 32
	};

	private:

	dng_rect fArea;

	uint32 fPlane;
	uint32 fPlanes;

	uint32 fRowPitch;
	uint32 fColPitch;

	public:

	/// Create an empty area.

	dng_area_spec (const dng_rect &area = dng_rect (),
	uint32 plane = 0,
	uint32 planes = 1,
	uint32 rowPitch = 1,
	uint32 colPitch = 1)

	: fArea (area)
	, fPlane (plane)
	, fPlanes (planes)
	, fRowPitch (rowPitch)
	, fColPitch (colPitch)

	{
	}

	/// The pixel area.

	const dng_rect & Area () const
	{
	return fArea;
	}

	/// The first plane.

	const uint32 Plane () const
	{
	return fPlane;
	}

	/// The total number of planes.

	const uint32 Planes () const
	{
	return fPlanes;
	}

	/// The row pitch (i.e., stride). A pitch of 1 means all rows.

	const uint32 RowPitch () const
	{
	return fRowPitch;
	}

	/// The column pitch (i.e., stride). A pitch of 1 means all columns.

	const uint32 ColPitch () const
	{
	return fColPitch;
	}

	/// Read area data from the specified stream.

	void GetData (dng_stream &stream);

	/// Write area data to the specified stream.

	void PutData (dng_stream &stream) const;

	/// Compute and return pixel area overlap (i.e., intersection) between this
	/// area and the specified tile.

	dng_rect Overlap (const dng_rect &tile) const;

	};

	/*****************************************************************************/

	/// \brief An opcode to apply a 1D function (represented as a 16-bit table) to an
	/// image area.

	class dng_opcode_MapTable: public dng_inplace_opcode
	{

	private:

	dng_area_spec fAreaSpec;

	AutoPtr<dng_memory_block> fTable;

	uint32 fCount;

	public:

	/// Create a MapTable opcode with the specified area, table, and number of
	/// table entries.

	dng_opcode_MapTable (dng_host &host,
	const dng_area_spec &areaSpec,
	const uint16 *table,
	uint32 count = 0x10000);

	dng_opcode_MapTable (dng_host &host,
	dng_stream &stream);

	virtual void PutData (dng_stream &stream) const;

	virtual uint32 BufferPixelType (uint32 imagePixelType);

	virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

	virtual void ProcessArea (dng_negative &negative,
	uint32 threadIndex,
	dng_pixel_buffer &buffer,
	const dng_rect &dstArea,
	const dng_rect &imageBounds);

	private:

	void ReplicateLastEntry ();

	};

	/*****************************************************************************/

	/// \brief An opcode to apply a 1D function (represented as a polynomial) to an
	/// image area.

	class dng_opcode_MapPolynomial: public dng_inplace_opcode
	{

	public:

	enum
	{
	kMaxDegree = 8
	};

	private:

	dng_area_spec fAreaSpec;

	uint32 fDegree;

	real64 fCoefficient [kMaxDegree + 1];

	real32 fCoefficient32 [kMaxDegree + 1];

	public:

	/// Create a MapPolynomial opcode with the specified area, polynomial
	/// degree, and polynomial coefficients. The function that will be
	/// applied to each pixel x is:
	///
	/// f (x) = coefficient [0] + ((x * coefficient [1]) +
	/// (x^2 * coefficient [2]) +
	/// (x^3 * coefficient [3]) +
	/// (x^4 * coefficient [4]) ...

	dng_opcode_MapPolynomial (const dng_area_spec &areaSpec,
	uint32 degree,
	const real64 *coefficient);

	dng_opcode_MapPolynomial (dng_stream &stream);

	virtual void PutData (dng_stream &stream) const;

	virtual uint32 BufferPixelType (uint32 imagePixelType);

	virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

	virtual void ProcessArea (dng_negative &negative,
	uint32 threadIndex,
	dng_pixel_buffer &buffer,
	const dng_rect &dstArea,
	const dng_rect &imageBounds);

	};

	/*****************************************************************************/

	/// \brief An opcode to apply a delta (i.e., offset) that varies per row. Within
	/// a row, the same delta value is applied to all specified pixels.

	class dng_opcode_DeltaPerRow: public dng_inplace_opcode
	{

	private:

	dng_area_spec fAreaSpec;

	AutoPtr<dng_memory_block> fTable;

	real32 fScale;

	public:

	/// Create a DeltaPerRow opcode with the specified area and row deltas
	/// (specified as a table of 32-bit floats).

	dng_opcode_DeltaPerRow (const dng_area_spec &areaSpec,
	AutoPtr<dng_memory_block> &table);

	dng_opcode_DeltaPerRow (dng_host &host,
	dng_stream &stream);

	virtual void PutData (dng_stream &stream) const;

	virtual uint32 BufferPixelType (uint32 imagePixelType);

	virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

	virtual void ProcessArea (dng_negative &negative,
	uint32 threadIndex,
	dng_pixel_buffer &buffer,
	const dng_rect &dstArea,
	const dng_rect &imageBounds);

	};

	/*****************************************************************************/

	/// \brief An opcode to apply a delta (i.e., offset) that varies per column.
	/// Within a column, the same delta value is applied to all specified pixels.

	class dng_opcode_DeltaPerColumn: public dng_inplace_opcode
	{

	private:

	dng_area_spec fAreaSpec;

	AutoPtr<dng_memory_block> fTable;

	real32 fScale;

	public:

	/// Create a DeltaPerColumn opcode with the specified area and column
	/// deltas (specified as a table of 32-bit floats).

	dng_opcode_DeltaPerColumn (const dng_area_spec &areaSpec,
	AutoPtr<dng_memory_block> &table);

	dng_opcode_DeltaPerColumn (dng_host &host,
	dng_stream &stream);

	virtual void PutData (dng_stream &stream) const;

	virtual uint32 BufferPixelType (uint32 imagePixelType);

	virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

	virtual void ProcessArea (dng_negative &negative,
	uint32 threadIndex,
	dng_pixel_buffer &buffer,
	const dng_rect &dstArea,
	const dng_rect &imageBounds);

	};

	/*****************************************************************************/

	/// \brief An opcode to apply a scale factor that varies per row. Within a row,
	/// the same scale factor is applied to all specified pixels.

	class dng_opcode_ScalePerRow: public dng_inplace_opcode
	{

	private:

	dng_area_spec fAreaSpec;

	AutoPtr<dng_memory_block> fTable;

	public:

	/// Create a ScalePerRow opcode with the specified area and row scale
	/// factors (specified as a table of 32-bit floats).

	dng_opcode_ScalePerRow (const dng_area_spec &areaSpec,
	AutoPtr<dng_memory_block> &table);

	dng_opcode_ScalePerRow (dng_host &host,
	dng_stream &stream);

	virtual void PutData (dng_stream &stream) const;

	virtual uint32 BufferPixelType (uint32 imagePixelType);

	virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

	virtual void ProcessArea (dng_negative &negative,
	uint32 threadIndex,
	dng_pixel_buffer &buffer,
	const dng_rect &dstArea,
	const dng_rect &imageBounds);

	};

	/*****************************************************************************/

	/// \brief An opcode to apply a scale factor that varies per column. Within a
	/// column, the same scale factor is applied to all specified pixels.

	class dng_opcode_ScalePerColumn: public dng_inplace_opcode
	{

	private:

	dng_area_spec fAreaSpec;

	AutoPtr<dng_memory_block> fTable;

	public:

	/// Create a ScalePerColumn opcode with the specified area and column
	/// scale factors (specified as a table of 32-bit floats).

	dng_opcode_ScalePerColumn (const dng_area_spec &areaSpec,
	AutoPtr<dng_memory_block> &table);

	dng_opcode_ScalePerColumn (dng_host &host,
	dng_stream &stream);

	virtual void PutData (dng_stream &stream) const;

	virtual uint32 BufferPixelType (uint32 imagePixelType);

	virtual dng_rect ModifiedBounds (const dng_rect &imageBounds);

	virtual void ProcessArea (dng_negative &negative,
	uint32 threadIndex,
	dng_pixel_buffer &buffer,
	const dng_rect &dstArea,
	const dng_rect &imageBounds);

	};

	/*****************************************************************************/

	#endif

	/*****************************************************************************/