include/pwlib/pixels8.h

   1 /*
   2  * pixels8.h
   3  *
   4  * 8 bit pixel image.
   5  *
   6  * Portable Windows Library
   7  *
   8  * Copyright (c) 1993-1998 Equivalence Pty. Ltd.
   9  *
  10  * The contents of this file are subject to the Mozilla Public License
  11  * Version 1.0 (the "License"); you may not use this file except in
  12  * compliance with the License. You may obtain a copy of the License at
  13  * http://www.mozilla.org/MPL/
  14  *
  15  * Software distributed under the License is distributed on an "AS IS"
  16  * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
  17  * the License for the specific language governing rights and limitations
  18  * under the License.
  19  *
  20  * The Original Code is Portable Windows Library.
  21  *
  22  * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
  23  *
  24  * Portions are Copyright (C) 1993 Free Software Foundation, Inc.
  25  * All Rights Reserved.
  26  *
  27  * Contributor(s): ______________________________________.
  28  *
  29  * $Log$
  30  * Revision 1.11  2001/05/22 12:49:33  robertj
  31  * Did some seriously wierd rewrite of platform headers to eliminate the
  32  *   stupid GNU compiler warning about braces not matching.
  33  *
  34  * Revision 1.10  1999/03/10 03:49:52  robertj
  35  * More documentation adjustments.
  36  *
  37  * Revision 1.9  1999/03/09 08:01:49  robertj
  38  * Changed comments for doc++ support (more to come).
  39  *
  40  * Revision 1.8  1999/02/16 08:08:46  robertj
  41  * MSVC 6.0 compatibility changes.
  42  *
  43  * Revision 1.7  1998/09/23 06:28:08  robertj
  44  * Added open source copyright license.
  45  *
  46  * Revision 1.6  1995/06/17 11:13:00  robertj
  47  * Documentation update.
  48  *
  49  * Revision 1.5  1995/03/14 12:42:09  robertj
  50  * Updated documentation to use HTML codes.
  51  *
  52  * Revision 1.4  1995/01/09  12:39:14  robertj
  53  * Documentation.
  54  *
  55  * Revision 1.3  1994/12/12  10:07:14  robertj
  56  * Made depth member of PPixels and removed virtual function.
  57  *
  58  * Revision 1.2  1994/12/05  11:34:20  robertj
  59  * Major rewrite of images, pictures and pixmaps.
  60  * Renamed PPict, PPixels and PImage to make sure all uses are found.
  61  *
  62  * Revision 1.1  1994/10/23  04:52:20  robertj
  63  * Initial revision
  64  *
  65  */
  66
  67
  68 #define _PPIXELS8
  69
  70 #ifdef __GNUC__
  71 #pragma interface
  72 #endif
  73
  74
  75 ///////////////////////////////////////////////////////////////////////////////
  76 // PPixels8
  77
  78 /**An 8 bit per pixel image. This is a non true colour rendition of the image
  79    with 8 bits ber pixel allowing 256 colours to be represented. The palette
  80    is mandatory with pixel images of this class.
  81  */
  82 class PPixels8 : public PPixelBase
  83 {
  84   PCLASSINFO(PPixels8, PPixelBase);
  85
  86   public:
  87     /** Create an 8 bit per pixel image. */
  88     PPixels8(
  89       PDIMENSION dx,  /// Width of image in pixels.
  90       PDIMENSION dy   /// Height of image in pixels.
  91     );
  92
  93
  94   /**@name Overrides from class PPixelBase */
  95    /**Set the pixel at the location to the specified value. This sets the
  96        colour of the pixel to that in the palette at the index position.
  97      */
  98     virtual void SetPixel(
  99       PORDINATE x,   /// Horizontal position of pixel in raster.
 100       PORDINATE y,   /// Vertical raster line.
 101       BYTE value     /// New value for pixel.
 102     );
 103
 104    /**Get the pixel at the location. This returns the index into the palette
 105        that the pixel value represents.
 106
 107        @return
 108        current value of pixel.
 109      */
 110     virtual BYTE GetPixel(
 111       PORDINATE x,    /// Horizontal position of pixel in raster.
 112       PORDINATE y     /// Vertical raster line.
 113     ) const;
 114
 115
 116   protected:
 117    /**Set the colours of a raster line in the pixel image. This is the
 118        polymorphic form of the \Ref{SetRaster()} functions.
 119      */
 120     virtual void SetRasterValues(
 121       PORDINATE x,     /// Horizontal position of start pixel in raster.
 122       PORDINATE y,     /// Vertical raster line.
 123       const BYTE * raster,  /// Pointer to array of values for pixels.
 124       PDIMENSION width /// Number of pixels in raster to set.
 125     );
 126
 127    /**Get the colours of a raster line in the pixel image. This is the
 128        polymorphic form of the \Ref{GetRaster()} functions.
 129      */
 130     virtual void GetRasterValues(
 131       PORDINATE x,     /// Horizontal position of start pixel in raster.
 132       PORDINATE y,     /// Vertical raster line.
 133       BYTE * raster,   /// Pointer to array of values for pixels.
 134       PDIMENSION width /// Number of pixels in raster to get.
 135     ) const;
 136
 137
 138 // Include platform dependent part of class
 139 #include <pwlib/pixels8.h>
 140 };
 141
 142
 143 // End Of File ///////////////////////////////////////////////////////////////