include/vcl/bmpacc.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef _SV_BMPACC_HXX
  21 #define _SV_BMPACC_HXX
  22
  23 #include <tools/solar.h>
  24 #include <vcl/dllapi.h>
  25 #include <vcl/salbtype.hxx>
  26 #include <vcl/bitmap.hxx>
  27
  28 // --------------------
  29 // - Access defines -
  30 // --------------------
  31
  32 #define DECL_FORMAT_GETPIXEL( Format ) \
  33 static BitmapColor GetPixelFor##Format( ConstScanline pScanline, long nX, const ColorMask& rMask );
  34
  35 #define DECL_FORMAT_SETPIXEL( Format ) \
  36 static void SetPixelFor##Format( Scanline pScanline, long nX, const BitmapColor& rBitmapColor, const ColorMask& rMask );
  37
  38 #define DECL_FORMAT( Format )   \
  39 DECL_FORMAT_GETPIXEL( Format )  \
  40 DECL_FORMAT_SETPIXEL( Format )
  41
  42 #define IMPL_FORMAT_GETPIXEL( Format ) \
  43 BitmapColor BitmapReadAccess::GetPixelFor##Format( ConstScanline pScanline, long nX, const ColorMask& rMask )
  44
  45 #define IMPL_FORMAT_GETPIXEL_NOMASK( Format ) \
  46 BitmapColor BitmapReadAccess::GetPixelFor##Format( ConstScanline pScanline, long nX, const ColorMask& )
  47
  48 #define IMPL_FORMAT_SETPIXEL( Format ) \
  49 void BitmapReadAccess::SetPixelFor##Format( Scanline pScanline, long nX, const BitmapColor& rBitmapColor, const ColorMask& rMask )
  50
  51 #define IMPL_FORMAT_SETPIXEL_NOMASK( Format ) \
  52 void BitmapReadAccess::SetPixelFor##Format( Scanline pScanline, long nX, const BitmapColor& rBitmapColor, const ColorMask& )
  53
  54 #define CASE_FORMAT( Format )           \
  55 case( BMP_FORMAT##Format ):            \
  56 {                                       \
  57     mFncGetPixel = GetPixelFor##Format;\
  58     mFncSetPixel = SetPixelFor##Format;\
  59 }                                       \
  60 break;
  61
  62
  63 // --------------------
  64 // - Access functions -
  65 // --------------------
  66
  67 typedef BitmapColor (*FncGetPixel)( ConstScanline pScanline, long nX, const ColorMask& rMask );
  68 typedef void (*FncSetPixel)( Scanline pScanline, long nX, const BitmapColor& rBitmapColor, const ColorMask& rMask );
  69
  70 // --------------------
  71 // - BitmapReadAccess -
  72 // --------------------
  73
  74 class VCL_DLLPUBLIC BitmapReadAccess
  75 {
  76     friend class BitmapWriteAccess;
  77
  78 private:
  79
  80                                 BitmapReadAccess() {}
  81                                 BitmapReadAccess( const BitmapReadAccess& ) {}
  82     BitmapReadAccess&           operator=( const BitmapReadAccess& ) { return *this; }
  83
  84 protected:
  85     Bitmap                      maBitmap;
  86     BitmapBuffer*               mpBuffer;
  87     Scanline*                   mpScanBuf;
  88     ColorMask                   maColorMask;
  89     FncGetPixel                 mFncGetPixel;
  90     FncSetPixel                 mFncSetPixel;
  91     sal_Bool                        mbModify;
  92
  93
  94 SAL_DLLPRIVATE  void            ImplCreate( Bitmap& rBitmap );
  95 SAL_DLLPRIVATE  void            ImplDestroy();
  96 SAL_DLLPRIVATE  sal_Bool            ImplSetAccessPointers( sal_uLong nFormat );
  97
  98 public:
  99
 100 SAL_DLLPRIVATE  void            ImplZeroInitUnusedBits();
 101 SAL_DLLPRIVATE  BitmapBuffer*   ImplGetBitmapBuffer() const { return mpBuffer; }
 102
 103                                 DECL_FORMAT( _1BIT_MSB_PAL )
 104                                 DECL_FORMAT( _1BIT_LSB_PAL )
 105                                 DECL_FORMAT( _4BIT_MSN_PAL )
 106                                 DECL_FORMAT( _4BIT_LSN_PAL )
 107                                 DECL_FORMAT( _8BIT_PAL )
 108                                 DECL_FORMAT( _8BIT_TC_MASK )
 109                                 DECL_FORMAT( _16BIT_TC_MSB_MASK )
 110                                 DECL_FORMAT( _16BIT_TC_LSB_MASK )
 111                                 DECL_FORMAT( _24BIT_TC_BGR )
 112                                 DECL_FORMAT( _24BIT_TC_RGB )
 113                                 DECL_FORMAT( _24BIT_TC_MASK )
 114                                 DECL_FORMAT( _32BIT_TC_ABGR )
 115                                 DECL_FORMAT( _32BIT_TC_ARGB )
 116                                 DECL_FORMAT( _32BIT_TC_BGRA )
 117                                 DECL_FORMAT( _32BIT_TC_RGBA )
 118                                 DECL_FORMAT( _32BIT_TC_MASK )
 119 protected:
 120                                 BitmapReadAccess( Bitmap& rBitmap, sal_Bool bModify );
 121
 122 public:
 123                                 BitmapReadAccess( Bitmap& rBitmap );
 124     virtual                     ~BitmapReadAccess();
 125
 126     inline sal_Bool                 operator!() const;
 127
 128     inline long                 Width() const;
 129     inline long                 Height() const;
 130     inline Point                TopLeft() const;
 131     inline Point                BottomRight() const;
 132
 133     inline sal_Bool                 IsTopDown() const;
 134     inline sal_Bool                 IsBottomUp() const;
 135
 136     inline sal_uLong                GetScanlineFormat() const;
 137     inline sal_uLong                GetScanlineSize() const;
 138
 139     inline sal_uInt16               GetBitCount() const;
 140     inline BitmapColor          GetBestMatchingColor( const BitmapColor& rBitmapColor );
 141
 142     inline Scanline             GetBuffer() const;
 143     inline Scanline             GetScanline( long nY ) const;
 144
 145     inline sal_Bool                 HasPalette() const;
 146     inline const BitmapPalette& GetPalette() const;
 147     inline sal_uInt16               GetPaletteEntryCount() const;
 148     inline const BitmapColor&   GetPaletteColor( sal_uInt16 nColor ) const;
 149     inline const BitmapColor&   GetBestPaletteColor( const BitmapColor& rBitmapColor ) const;
 150     sal_uInt16                      GetBestPaletteIndex( const BitmapColor& rBitmapColor ) const;
 151
 152     inline sal_Bool                 HasColorMask() const;
 153     inline ColorMask&           GetColorMask() const;
 154
 155     inline BitmapColor          GetPixelFromData( const sal_uInt8* pData, long nX ) const;
 156     inline void                 SetPixelOnData( sal_uInt8* pData, long nX, const BitmapColor& rBitmapColor );
 157     inline BitmapColor          GetPixel( long nY, long nX ) const;
 158     inline BitmapColor          GetColor( long nY, long nX ) const;
 159     inline sal_uInt8            GetPixelIndex( long nY, long nX ) const;
 160     inline sal_uInt8            GetLuminance( long nY, long nX ) const;
 161 };
 162
 163 // ---------------------
 164 // - BitmapWriteAccess -
 165 // ---------------------
 166
 167 class VCL_DLLPUBLIC BitmapWriteAccess : public BitmapReadAccess
 168 {
 169 public:
 170
 171                                 BitmapWriteAccess( Bitmap& rBitmap );
 172     virtual                     ~BitmapWriteAccess();
 173
 174     void                        CopyScanline( long nY, const BitmapReadAccess& rReadAcc );
 175     void                        CopyScanline( long nY, ConstScanline aSrcScanline,
 176                                               sal_uLong nSrcScanlineFormat, sal_uLong nSrcScanlineSize );
 177
 178     void                        CopyBuffer( const BitmapReadAccess& rReadAcc );
 179
 180     inline void                 SetPalette( const BitmapPalette& rPalette );
 181     inline void                 SetPaletteEntryCount( sal_uInt16 nCount );
 182     inline void                 SetPaletteColor( sal_uInt16 nColor, const BitmapColor& rBitmapColor );
 183
 184     inline void                 SetPixel( long nY, long nX, const BitmapColor& rBitmapColor );
 185     inline void                 SetPixelIndex( long nY, long nX, sal_uInt8 cIndex );
 186
 187     void                        SetLineColor( const Color& rColor );
 188
 189     void                        SetFillColor( const Color& rColor );
 190
 191     void                        Erase( const Color& rColor );
 192
 193     void                        DrawLine( const Point& rStart, const Point& rEnd );
 194
 195     void                        FillRect( const Rectangle& rRect );
 196     void                        DrawRect( const Rectangle& rRect );
 197
 198 private:
 199
 200     BitmapColor*                mpLineColor;
 201     BitmapColor*                mpFillColor;
 202
 203                                 BitmapWriteAccess() {}
 204                                 BitmapWriteAccess( const BitmapWriteAccess& ) : BitmapReadAccess() {}
 205     BitmapWriteAccess&          operator=( const BitmapWriteAccess& ) { return *this; }
 206 };
 207
 208 // -----------
 209 // - Inlines -
 210 // -----------
 211
 212 inline sal_Bool BitmapReadAccess::operator!() const
 213 {
 214     return( mpBuffer == NULL );
 215 }
 216
 217 // ------------------------------------------------------------------
 218
 219 inline long BitmapReadAccess::Width() const
 220 {
 221     return( mpBuffer ? mpBuffer->mnWidth : 0L );
 222 }
 223
 224 // ------------------------------------------------------------------
 225
 226 inline long BitmapReadAccess::Height() const
 227 {
 228     return( mpBuffer ? mpBuffer->mnHeight : 0L );
 229 }
 230
 231 // ------------------------------------------------------------------
 232
 233 inline Point BitmapReadAccess::TopLeft() const
 234 {
 235     return Point();
 236 }
 237
 238 // ------------------------------------------------------------------
 239
 240 inline Point BitmapReadAccess::BottomRight() const
 241 {
 242     return Point( Width() - 1L, Height() - 1L );
 243 }
 244
 245 // ------------------------------------------------------------------
 246
 247 inline sal_Bool BitmapReadAccess::IsTopDown() const
 248 {
 249     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 250     return( mpBuffer ? sal::static_int_cast<sal_Bool>( BMP_SCANLINE_ADJUSTMENT( mpBuffer->mnFormat ) == BMP_FORMAT_TOP_DOWN ) : sal_False );
 251 }
 252
 253 // ------------------------------------------------------------------
 254
 255 inline sal_Bool BitmapReadAccess::IsBottomUp() const
 256 {
 257     return !IsTopDown();
 258 }
 259
 260 // ------------------------------------------------------------------
 261
 262 inline sal_uLong BitmapReadAccess::GetScanlineFormat() const
 263 {
 264     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 265     return( mpBuffer ? BMP_SCANLINE_FORMAT( mpBuffer->mnFormat ) : 0UL );
 266 }
 267
 268 // ------------------------------------------------------------------
 269
 270 inline sal_uLong BitmapReadAccess::GetScanlineSize() const
 271 {
 272     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 273     return( mpBuffer ? mpBuffer->mnScanlineSize : 0UL );
 274 }
 275
 276 // ------------------------------------------------------------------
 277
 278 inline sal_uInt16  BitmapReadAccess::GetBitCount() const
 279 {
 280     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 281     return( mpBuffer ? mpBuffer->mnBitCount : 0 );
 282 }
 283
 284 // ------------------------------------------------------------------
 285
 286 inline BitmapColor BitmapReadAccess::GetBestMatchingColor( const BitmapColor& rBitmapColor )
 287 {
 288     if( HasPalette() )
 289         return BitmapColor( (sal_uInt8) GetBestPaletteIndex( rBitmapColor ) );
 290     else
 291         return rBitmapColor;
 292 }
 293
 294 // ------------------------------------------------------------------
 295
 296 inline Scanline BitmapReadAccess::GetBuffer() const
 297 {
 298     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 299     return( mpBuffer ? mpBuffer->mpBits : NULL );
 300 }
 301
 302 // ------------------------------------------------------------------
 303
 304 inline Scanline BitmapReadAccess::GetScanline( long nY ) const
 305 {
 306     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 307     DBG_ASSERT( nY < mpBuffer->mnHeight, "y-coordinate out of range!" );
 308     return( mpBuffer ? mpScanBuf[ nY ] : NULL );
 309 }
 310
 311 // ------------------------------------------------------------------
 312
 313 inline sal_Bool BitmapReadAccess::HasPalette() const
 314 {
 315     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 316     return( mpBuffer && !!mpBuffer->maPalette );
 317 }
 318
 319 // ------------------------------------------------------------------
 320
 321 inline const BitmapPalette& BitmapReadAccess::GetPalette() const
 322 {
 323     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 324     return mpBuffer->maPalette;
 325 }
 326
 327 // ------------------------------------------------------------------
 328
 329 inline sal_uInt16 BitmapReadAccess::GetPaletteEntryCount() const
 330 {
 331     DBG_ASSERT( HasPalette(), "Bitmap has no palette!" );
 332     return( HasPalette() ? mpBuffer->maPalette.GetEntryCount() : 0 );
 333 }
 334
 335 // ------------------------------------------------------------------
 336
 337 inline const BitmapColor& BitmapReadAccess::GetPaletteColor( sal_uInt16 nColor ) const
 338 {
 339     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 340     DBG_ASSERT( HasPalette(), "Bitmap has no palette!" );
 341     return mpBuffer->maPalette[ nColor ];
 342 }
 343
 344 // ------------------------------------------------------------------
 345
 346 inline const BitmapColor& BitmapReadAccess::GetBestPaletteColor( const BitmapColor& rBitmapColor ) const
 347 {
 348     return GetPaletteColor( GetBestPaletteIndex( rBitmapColor ) );
 349 }
 350
 351 // ------------------------------------------------------------------
 352
 353 inline sal_Bool BitmapReadAccess::HasColorMask() const
 354 {
 355     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 356     const sal_uLong nFormat = BMP_SCANLINE_FORMAT( mpBuffer->mnFormat );
 357
 358     return( nFormat == BMP_FORMAT_8BIT_TC_MASK  ||
 359             nFormat == BMP_FORMAT_16BIT_TC_MSB_MASK ||
 360             nFormat == BMP_FORMAT_16BIT_TC_LSB_MASK ||
 361             nFormat == BMP_FORMAT_24BIT_TC_MASK ||
 362             nFormat == BMP_FORMAT_32BIT_TC_MASK );
 363 }
 364
 365 // ------------------------------------------------------------------
 366
 367 inline ColorMask& BitmapReadAccess::GetColorMask() const
 368 {
 369     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 370     return mpBuffer->maColorMask;
 371 }
 372
 373 // ------------------------------------------------------------------
 374
 375 inline BitmapColor BitmapReadAccess::GetPixel( long nY, long nX ) const
 376 {
 377     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 378     DBG_ASSERT( nX < mpBuffer->mnWidth, "x-coordinate out of range!" );
 379     DBG_ASSERT( nY < mpBuffer->mnHeight, "y-coordinate out of range!" );
 380     return mFncGetPixel( mpScanBuf[ nY ], nX, maColorMask );
 381 }
 382
 383 inline sal_uInt8 BitmapReadAccess::GetPixelIndex( long nY, long nX ) const
 384 {
 385     return GetPixel( nY, nX ).GetBlueOrIndex();
 386 }
 387
 388 // ------------------------------------------------------------------
 389
 390 inline BitmapColor BitmapReadAccess::GetPixelFromData( const sal_uInt8* pData, long nX ) const
 391 {
 392     DBG_ASSERT( pData, "Access is not valid!" );
 393     return mFncGetPixel( pData, nX, maColorMask );
 394 }
 395
 396 // ------------------------------------------------------------------
 397
 398 inline void BitmapReadAccess::SetPixelOnData( sal_uInt8* pData, long nX, const BitmapColor& rBitmapColor )
 399 {
 400     DBG_ASSERT( pData, "Access is not valid!" );
 401     mFncSetPixel( pData, nX, rBitmapColor, maColorMask );
 402 }
 403
 404 // ------------------------------------------------------------------
 405
 406 inline BitmapColor BitmapReadAccess::GetColor( long nY, long nX ) const
 407 {
 408     if( HasPalette() )
 409         return mpBuffer->maPalette[ GetPixelIndex( nY, nX ) ];
 410     else
 411         return GetPixel( nY, nX );
 412 }
 413
 414 // ------------------------------------------------------------------
 415
 416 inline sal_uInt8 BitmapReadAccess::GetLuminance( long nY, long nX ) const
 417 {
 418     return GetColor( nY, nX ).GetLuminance();
 419 }
 420
 421 // ------------------------------------------------------------------
 422
 423 inline void BitmapWriteAccess::SetPalette( const BitmapPalette& rPalette )
 424 {
 425     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 426     mpBuffer->maPalette = rPalette;
 427 }
 428
 429 // ------------------------------------------------------------------
 430
 431 inline void BitmapWriteAccess::SetPaletteEntryCount( sal_uInt16 nCount )
 432 {
 433     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 434     mpBuffer->maPalette.SetEntryCount( nCount );
 435 }
 436
 437 // ------------------------------------------------------------------
 438
 439 inline void BitmapWriteAccess::SetPaletteColor( sal_uInt16 nColor, const BitmapColor& rBitmapColor )
 440 {
 441     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 442     DBG_ASSERT( HasPalette(), "Bitmap has no palette!" );
 443     mpBuffer->maPalette[ nColor ] = rBitmapColor;
 444 }
 445
 446 // ------------------------------------------------------------------
 447
 448 inline void BitmapWriteAccess::SetPixel( long nY, long nX, const BitmapColor& rBitmapColor )
 449 {
 450     DBG_ASSERT( mpBuffer, "Access is not valid!" );
 451     DBG_ASSERT( nX < mpBuffer->mnWidth, "x-coordinate out of range!" );
 452     DBG_ASSERT( nY < mpBuffer->mnHeight, "y-coordinate out of range!" );
 453     mFncSetPixel( mpScanBuf[ nY ], nX, rBitmapColor, maColorMask );
 454 }
 455
 456 inline void BitmapWriteAccess::SetPixelIndex( long nY, long nX, sal_uInt8 cIndex )
 457 {
 458     SetPixel( nY, nX, BitmapColor( cIndex ));
 459 }
 460
 461 // ------------------------------------------------------------------
 462
 463 #endif // _SV_BMPACC_HXX
 464
 465 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */