// ==========================================================

// Photoshop Loader

//

// Design and implementation by

// - Hervé Drolon (drolon@infonie.fr)

// - Mihail Naydenov (mnaydenov@users.sourceforge.net)

// - Garrick Meeker (garrickmeeker@users.sourceforge.net)

//

// Based on LGPL code created and published by http://sourceforge.net/projects/elynx/

//

// This file is part of FreeImage 3

//

// COVERED CODE IS PROVIDED UNDER THIS LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTY

// OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES

// THAT THE COVERED CODE IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE

// OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE COVERED

// CODE IS WITH YOU. SHOULD ANY COVERED CODE PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT

// THE INITIAL DEVELOPER OR ANY OTHER CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY

// SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL

// PART OF THIS LICENSE. NO USE OF ANY COVERED CODE IS AUTHORIZED HEREUNDER EXCEPT UNDER

// THIS DISCLAIMER.

//

// Use at your own risk!

// ==========================================================

#ifndef FREEIMAGE_PSDPARSER_H

#define FREEIMAGE_PSDPARSER_H

/**

Table 2-12: File header section. 

The file header contains the basic properties of the image. 

*/

typedef struct psdHeader {

  BYTE Signature[4];  //! Always equal 8BPS, do not try to read the file if the signature does not match this value.

  BYTE Version[2];  //! Version of file, PSD=1, PSB=2.

  char Reserved[6]; //! Must be zero.

  BYTE Channels[2]; //! Number of channels including any alpha channels, supported range is 1 to 24.

  BYTE Rows[4];   //! The height of the image in pixels. Supported range is 1 to 30,000.

  BYTE Columns[4];  //! The width of the image in pixels. Supported range is 1 to 30,000.

  BYTE Depth[2];    //! The number of bits per channel. Supported values are 1, 8, and 16.

  BYTE Mode[2];   //! Colour mode of the file, Bitmap=0, Grayscale=1, Indexed=2, RGB=3, CMYK=4, Multichannel=7, Duotone=8, Lab=9. 

} psdHeader;

/**

Table 2-12: HeaderInfo Color spaces

@see psdHeader

*/

class psdHeaderInfo {

public:

  short _Version;     //! Version of file, PSD=1, PSB=2.

  short _Channels;  //! Number of channels including any alpha channels, supported range is 1 to 24.

  int   _Height;    //! The height of the image in pixels. Supported range is 1 to 30,000.

  int   _Width;   //! The width of the image in pixels. Supported range is 1 to 30,000.

  short _BitsPerChannel;//! The number of bits per channel. Supported values are 1, 8, and 16.

  short _ColourMode;  //! Colour mode of the file, Bitmap=0, Grayscale=1, Indexed=2, RGB=3, CMYK=4, Multichannel=7, Duotone=8, Lab=9. 

public:

  //! Default constructor

  psdHeaderInfo();

  //! Destructor

  ~psdHeaderInfo();

  /**

  Read the psdHeader structure

  @return Returns true if successful, false otherwise

  */

  bool Read(FreeImageIO *io, fi_handle handle);

  /**

  Write the psdHeader structure

  @return Returns true if successful, false otherwise

  */

  bool Write(FreeImageIO *io, fi_handle handle);

};

/**

Table 2-13 Color mode data section

Only indexed color and duotone have color mode data. For all other modes,

this section is just 4 bytes: the length field, which is set to zero.

For indexed color images, the length will be equal to 768, and the color data

will contain the color table for the image, in non-interleaved order.

For duotone images, the color data will contain the duotone specification,

the format of which is not documented. Other applications that read

Photoshop files can treat a duotone image as a grayscale image, and just

preserve the contents of the duotone information when reading and writing

the file.

*/

class psdColourModeData {

public:

  int _Length;      //! The length of the following color data

  BYTE * _plColourData; //! The color data

public:

  psdColourModeData();

  ~psdColourModeData();

  /**

  @return Returns true if successful, false otherwise

  */

  bool Read(FreeImageIO *io, fi_handle handle);

  /**

  @return Returns true if successful, false otherwise

  */

  bool Write(FreeImageIO *io, fi_handle handle);

  bool FillPalette(FIBITMAP *dib);

};

/**

Table 2-1: Image resource block

NB: Resource data is padded to make size even

*/

class psdImageResource {

public:

  int     _Length;

  char    _OSType[4]; //! Photoshop always uses its signature, 8BIM

  short   _ID;    //! Unique identifier. Image resource IDs on page 8

  BYTE * _plName;   //! A pascal string, padded to make size even (a null name consists of two bytes of 0)

  int     _Size;    //! Actual size of resource data. This does not include the Type, ID, Name or Size fields.

public:

  psdImageResource();

  ~psdImageResource();

  void Reset();

  bool Write(FreeImageIO *io, fi_handle handle, int ID, int Size);

};

/**

Table A-6: ResolutionInfo structure

This structure contains information about the resolution of an image. It is

written as an image resource. See the Document file formats chapter for more

details.

*/

class psdResolutionInfo {

public:

  short _widthUnit; //! Display width as 1=inches; 2=cm; 3=points; 4=picas; 5=columns.

  short _heightUnit;  //! Display height as 1=inches; 2=cm; 3=points; 4=picas; 5=columns.

  short _hRes;    //! Horizontal resolution in pixels per inch.

  short _vRes;    //! Vertical resolution in pixels per inch.

  int _hResUnit;    //! 1=display horizontal resolution in pixels per inch; 2=display horizontal resolution in pixels per cm.

  int _vResUnit;    //! 1=display vertical resolution in pixels per inch; 2=display vertical resolution in pixels per cm.

public:

  psdResolutionInfo();

  ~psdResolutionInfo(); 

  /**

  @return Returns the number of bytes read

  */

  int Read(FreeImageIO *io, fi_handle handle);

  /**

  @return Returns true if successful, false otherwise

  */

  bool Write(FreeImageIO *io, fi_handle handle);

  /**

  @param res_x [out] X resolution in pixels/meter

  @param res_y [out] Y resolution in pixels/meter

  */

  void GetResolutionInfo(unsigned &res_x, unsigned &res_y);

};

// Obsolete - Photoshop 2.0

class psdResolutionInfo_v2 {

public:

  short _Channels;

  short _Rows;

  short _Columns;

  short _Depth;

  short _Mode;

public:

  psdResolutionInfo_v2();

  ~psdResolutionInfo_v2();

  /**

  @return Returns the number of bytes read

  */

  int Read(FreeImageIO *io, fi_handle handle);

  /**

  @return Returns true if successful, false otherwise

  */

  bool Write(FreeImageIO *io, fi_handle handle);

};

/**

Table A-7: DisplayInfo Color spaces

This structure contains display information about each channel. It is written as an image resource.

*/

class psdDisplayInfo {

public:

  short _ColourSpace;

  short _Colour[4];

  short _Opacity;  //! 0..100

  BYTE _Kind;     //! selected = 0, protected = 1

  BYTE _padding;  //! should be zero

public:

  psdDisplayInfo();

  ~psdDisplayInfo();

  /**

  @return Returns the number of bytes read

  */

  int Read(FreeImageIO *io, fi_handle handle);

  /**

  @return Returns true if successful, false otherwise

  */

  bool Write(FreeImageIO *io, fi_handle handle);

};

/**

Table 2-5: Thumbnail resource header

Adobe Photoshop 5.0 and later stores thumbnail information for preview

display in an image resource block. These resource blocks consist of an initial

28 byte header, followed by a JFIF thumbnail in RGB (red, green, blue) order

for both Macintosh and Windows. Adobe Photoshop 4.0 stored the

thumbnail information in the same format except the data section is BGR

(blue, green, red). The Adobe Photoshop 4.0 format is at resource ID 1033

and the Adobe Photoshop 5.0 format is at resource ID 1036.

*/

class psdThumbnail {

public:

  int _Format;      //! = 1 (kJpegRGB). Also supports kRawRGB (0).

  int _Width;       //! Width of thumbnail in pixels.

  int _Height;      //! Height of thumbnail in pixels.

  int _WidthBytes;    //! Padded row bytes as (width * bitspixel + 31) / 32 * 4.

  int _Size;        //! Total size as widthbytes * height * planes

  int _CompressedSize;  //! Size after compression. Used for consistentcy check. 

  short _BitPerPixel;   //! = 24. Bits per pixel.

  short _Planes;      //! = 1. Number of planes.

  FIBITMAP * _dib;    //! JFIF data as uncompressed dib. Note: For resource ID 1033 the data is in BGR format.

  bool _owned;

public:

  psdThumbnail();

  ~psdThumbnail();

  FIBITMAP* getDib() { return _dib; }

  void Init();

  /**

  @return Returns the number of bytes read

  */

  int Read(FreeImageIO *io, fi_handle handle, int iResourceSize, bool isBGR);

  /**

  @return Returns true if successful, false otherwise

  */

  bool Write(FreeImageIO *io, fi_handle handle, bool isBGR);

private:

  psdThumbnail(const psdThumbnail&);

  psdThumbnail& operator=(const psdThumbnail&);

};

class psdICCProfile {

public:

  int _ProfileSize;

  BYTE * _ProfileData;

  bool _owned;

public:

  psdICCProfile();

  ~psdICCProfile();

  void clear();

  /**

  @return Returns the number of bytes read

  */

  int Read(FreeImageIO *io, fi_handle handle, int size);

  /**

  @return Returns true if successful, false otherwise

  */

  bool Write(FreeImageIO *io, fi_handle handle);

};

class psdData {

public:

  unsigned _Size;

  BYTE * _Data;

  bool _owned;

public:

  psdData();

  ~psdData();

  void clear();

  /**

  @return Returns the number of bytes read

  */

  int Read(FreeImageIO *io, fi_handle handle, int size);

  /**

  @return Returns true if successful, false otherwise

  */

  bool Write(FreeImageIO *io, fi_handle handle, int ID);

};

/**

PSD loader

*/

class psdParser {

private:

  psdHeaderInfo     _headerInfo;

  psdColourModeData   _colourModeData;

  psdResolutionInfo   _resolutionInfo;

  psdResolutionInfo_v2  _resolutionInfo_v2;

  psdDisplayInfo      _displayInfo;

  psdThumbnail      _thumbnail;

  psdICCProfile     _iccProfile;

  psdData         _iptc;

  psdData         _exif1;

  psdData         _exif3;

  psdData         _xmp;

  short _ColourCount;

  short _TransparentIndex;

  int _GlobalAngle;

  bool _bResolutionInfoFilled;

  bool _bResolutionInfoFilled_v2;

  bool _bDisplayInfoFilled;

  bool _bThumbnailFilled;

  bool _bCopyright;

  int _fi_flags;

  int _fi_format_id;

private:

  unsigned GetChannelOffset(FIBITMAP* bitmap, unsigned c) const;

  /** Actually ignore it */

  bool ReadLayerAndMaskInfoSection(FreeImageIO *io, fi_handle handle);

  void ReadImageLine(BYTE* dst, const BYTE* src, unsigned lineSize, unsigned dstBpp, unsigned bytes);

  void UnpackRLE(BYTE* dst, const BYTE* src, BYTE* dst_end, unsigned srcSize);

  FIBITMAP* ReadImageData(FreeImageIO *io, fi_handle handle);

  bool WriteLayerAndMaskInfoSection(FreeImageIO *io, fi_handle handle);

  void WriteImageLine(BYTE* dst, const BYTE* src, unsigned lineSize, unsigned srcBpp, unsigned bytes);

  unsigned PackRLE(BYTE* line_start, const BYTE* src_line, unsigned srcSize);

  bool WriteImageData(FreeImageIO *io, fi_handle handle, FIBITMAP* dib);

public:

  psdParser();

  ~psdParser();

  FIBITMAP* Load(FreeImageIO *io, fi_handle handle, int s_format_id, int flags=0);

  bool Save(FreeImageIO *io, FIBITMAP *dib, fi_handle handle, int page, int flags, void *data);

  /** Also used by the TIFF plugin */

  bool ReadImageResources(FreeImageIO *io, fi_handle handle, LONG length=0);

  /** Used by the TIFF plugin */

  FIBITMAP* GetThumbnail() {

    return _thumbnail.getDib();

  }

};

#endif // FREEIMAGE_PSDPARSER_H