src/common/image.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/common/image.cpp
   3 // Purpose:     wxImage
   4 // Author:      Robert Roebling
   5 // RCS-ID:      $Id$
   6 // Copyright:   (c) Robert Roebling
   7 // Licence:     wxWindows licence
   8 /////////////////////////////////////////////////////////////////////////////
   9
  10 // For compilers that support precompilation, includes "wx.h".
  11 #include "wx/wxprec.h"
  12
  13 #ifdef __BORLANDC__
  14     #pragma hdrstop
  15 #endif
  16
  17 #if wxUSE_IMAGE
  18
  19 #ifndef WX_PRECOMP
  20     #include "wx/log.h"
  21     #include "wx/app.h"
  22     #include "wx/hash.h"
  23     #include "wx/utils.h"
  24 #endif
  25
  26 #include "wx/image.h"
  27 #include "wx/bitmap.h"
  28 #include "wx/filefn.h"
  29 #include "wx/wfstream.h"
  30 #include "wx/intl.h"
  31 #include "wx/module.h"
  32 #include "wx/math.h"
  33
  34 #if wxUSE_XPM
  35     #include "wx/xpmdecod.h"
  36 #endif
  37
  38 // For memcpy
  39 #include <string.h>
  40
  41 //-----------------------------------------------------------------------------
  42 // wxImage
  43 //-----------------------------------------------------------------------------
  44
  45 class wxImageRefData: public wxObjectRefData
  46 {
  47 public:
  48     wxImageRefData();
  49     virtual ~wxImageRefData();
  50
  51     int             m_width;
  52     int             m_height;
  53     unsigned char  *m_data;
  54
  55     bool            m_hasMask;
  56     unsigned char   m_maskRed,m_maskGreen,m_maskBlue;
  57
  58     // alpha channel data, may be NULL for the formats without alpha support
  59     unsigned char  *m_alpha;
  60
  61     bool            m_ok;
  62
  63     // if true, m_data is pointer to static data and shouldn't be freed
  64     bool            m_static;
  65
  66     // same as m_static but for m_alpha
  67     bool            m_staticAlpha;
  68
  69 #if wxUSE_PALETTE
  70     wxPalette       m_palette;
  71 #endif // wxUSE_PALETTE
  72
  73     wxArrayString   m_optionNames;
  74     wxArrayString   m_optionValues;
  75
  76     DECLARE_NO_COPY_CLASS(wxImageRefData)
  77 };
  78
  79 wxImageRefData::wxImageRefData()
  80 {
  81     m_width = 0;
  82     m_height = 0;
  83     m_data =
  84     m_alpha = (unsigned char *) NULL;
  85
  86     m_maskRed = 0;
  87     m_maskGreen = 0;
  88     m_maskBlue = 0;
  89     m_hasMask = false;
  90
  91     m_ok = false;
  92     m_static =
  93     m_staticAlpha = false;
  94 }
  95
  96 wxImageRefData::~wxImageRefData()
  97 {
  98     if ( !m_static )
  99         free( m_data );
 100     if ( !m_staticAlpha )
 101         free( m_alpha );
 102 }
 103
 104 wxList wxImage::sm_handlers;
 105
 106 wxImage wxNullImage;
 107
 108 //-----------------------------------------------------------------------------
 109
 110 #define M_IMGDATA ((wxImageRefData *)m_refData)
 111
 112 IMPLEMENT_DYNAMIC_CLASS(wxImage, wxObject)
 113
 114 wxImage::wxImage( int width, int height, bool clear )
 115 {
 116     Create( width, height, clear );
 117 }
 118
 119 wxImage::wxImage( int width, int height, unsigned char* data, bool static_data )
 120 {
 121     Create( width, height, data, static_data );
 122 }
 123
 124 wxImage::wxImage( int width, int height, unsigned char* data, unsigned char* alpha, bool static_data )
 125 {
 126     Create( width, height, data, alpha, static_data );
 127 }
 128
 129 wxImage::wxImage( const wxString& name, long type, int index )
 130 {
 131     LoadFile( name, type, index );
 132 }
 133
 134 wxImage::wxImage( const wxString& name, const wxString& mimetype, int index )
 135 {
 136     LoadFile( name, mimetype, index );
 137 }
 138
 139 #if wxUSE_STREAMS
 140 wxImage::wxImage( wxInputStream& stream, long type, int index )
 141 {
 142     LoadFile( stream, type, index );
 143 }
 144
 145 wxImage::wxImage( wxInputStream& stream, const wxString& mimetype, int index )
 146 {
 147     LoadFile( stream, mimetype, index );
 148 }
 149 #endif // wxUSE_STREAMS
 150
 151 wxImage::wxImage( const char** xpmData )
 152 {
 153     Create(xpmData);
 154 }
 155
 156 wxImage::wxImage( char** xpmData )
 157 {
 158     Create((const char**) xpmData);
 159 }
 160
 161 bool wxImage::Create( const char** xpmData )
 162 {
 163 #if wxUSE_XPM
 164     UnRef();
 165
 166     wxXPMDecoder decoder;
 167     (*this) = decoder.ReadData(xpmData);
 168     return Ok();
 169 #else
 170     return false;
 171 #endif
 172 }
 173
 174 bool wxImage::Create( int width, int height, bool clear )
 175 {
 176     UnRef();
 177
 178     m_refData = new wxImageRefData();
 179
 180     M_IMGDATA->m_data = (unsigned char *) malloc( width*height*3 );
 181     if (!M_IMGDATA->m_data)
 182     {
 183         UnRef();
 184         return false;
 185     }
 186
 187     if (clear)
 188         memset(M_IMGDATA->m_data, 0, width*height*3);
 189
 190     M_IMGDATA->m_width = width;
 191     M_IMGDATA->m_height = height;
 192     M_IMGDATA->m_ok = true;
 193
 194     return true;
 195 }
 196
 197 bool wxImage::Create( int width, int height, unsigned char* data, bool static_data )
 198 {
 199     UnRef();
 200
 201     wxCHECK_MSG( data, false, _T("NULL data in wxImage::Create") );
 202
 203     m_refData = new wxImageRefData();
 204
 205     M_IMGDATA->m_data = data;
 206     M_IMGDATA->m_width = width;
 207     M_IMGDATA->m_height = height;
 208     M_IMGDATA->m_ok = true;
 209     M_IMGDATA->m_static = static_data;
 210
 211     return true;
 212 }
 213
 214 bool wxImage::Create( int width, int height, unsigned char* data, unsigned char* alpha, bool static_data )
 215 {
 216     UnRef();
 217
 218     wxCHECK_MSG( data, false, _T("NULL data in wxImage::Create") );
 219
 220     m_refData = new wxImageRefData();
 221
 222     M_IMGDATA->m_data = data;
 223     M_IMGDATA->m_alpha = alpha;
 224     M_IMGDATA->m_width = width;
 225     M_IMGDATA->m_height = height;
 226     M_IMGDATA->m_ok = true;
 227     M_IMGDATA->m_static = static_data;
 228
 229     return true;
 230 }
 231
 232 void wxImage::Destroy()
 233 {
 234     UnRef();
 235 }
 236
 237 wxImage wxImage::Copy() const
 238 {
 239     wxImage image;
 240
 241     wxCHECK_MSG( Ok(), image, wxT("invalid image") );
 242
 243     image.Create( M_IMGDATA->m_width, M_IMGDATA->m_height, false );
 244
 245     unsigned char *data = image.GetData();
 246
 247     wxCHECK_MSG( data, image, wxT("unable to create image") );
 248
 249     image.SetMaskColour( M_IMGDATA->m_maskRed, M_IMGDATA->m_maskGreen, M_IMGDATA->m_maskBlue );
 250     image.SetMask( M_IMGDATA->m_hasMask );
 251
 252     memcpy( data, GetData(), M_IMGDATA->m_width*M_IMGDATA->m_height*3 );
 253
 254     wxImageRefData *imgData = (wxImageRefData *)image.m_refData;
 255
 256     // also copy the alpha channel
 257     if (HasAlpha())
 258     {
 259         image.SetAlpha();
 260         unsigned char* alpha = image.GetAlpha();
 261         memcpy( alpha, GetAlpha(), M_IMGDATA->m_width*M_IMGDATA->m_height );
 262     }
 263
 264     // also copy the image options
 265     imgData->m_optionNames = M_IMGDATA->m_optionNames;
 266     imgData->m_optionValues = M_IMGDATA->m_optionValues;
 267
 268     return image;
 269 }
 270
 271 wxImage wxImage::ShrinkBy( int xFactor , int yFactor ) const
 272 {
 273     if( xFactor == 1 && yFactor == 1 )
 274         return Copy() ;
 275
 276     wxImage image;
 277
 278     wxCHECK_MSG( Ok(), image, wxT("invalid image") );
 279
 280     // can't scale to/from 0 size
 281     wxCHECK_MSG( (xFactor > 0) && (yFactor > 0), image,
 282                  wxT("invalid new image size") );
 283
 284     long old_height = M_IMGDATA->m_height,
 285          old_width  = M_IMGDATA->m_width;
 286
 287     wxCHECK_MSG( (old_height > 0) && (old_width > 0), image,
 288                  wxT("invalid old image size") );
 289
 290     long width = old_width / xFactor ;
 291     long height = old_height / yFactor ;
 292
 293     image.Create( width, height, false );
 294
 295     char unsigned *data = image.GetData();
 296
 297     wxCHECK_MSG( data, image, wxT("unable to create image") );
 298
 299     bool hasMask = false ;
 300     unsigned char maskRed = 0;
 301     unsigned char maskGreen = 0;
 302     unsigned char maskBlue =0 ;
 303
 304     unsigned char *source_data = M_IMGDATA->m_data;
 305     unsigned char *target_data = data;
 306     unsigned char *source_alpha = 0 ;
 307     unsigned char *target_alpha = 0 ;
 308     if (M_IMGDATA->m_hasMask)
 309     {
 310         hasMask = true ;
 311         maskRed = M_IMGDATA->m_maskRed;
 312         maskGreen = M_IMGDATA->m_maskGreen;
 313         maskBlue =M_IMGDATA->m_maskBlue ;
 314
 315         image.SetMaskColour( M_IMGDATA->m_maskRed,
 316                              M_IMGDATA->m_maskGreen,
 317                              M_IMGDATA->m_maskBlue );
 318     }
 319     else
 320     {
 321         source_alpha = M_IMGDATA->m_alpha ;
 322         if ( source_alpha )
 323         {
 324             image.SetAlpha() ;
 325             target_alpha = image.GetAlpha() ;
 326         }
 327     }
 328
 329     for (long y = 0; y < height; y++)
 330     {
 331         for (long x = 0; x < width; x++)
 332         {
 333             unsigned long avgRed = 0 ;
 334             unsigned long avgGreen = 0;
 335             unsigned long avgBlue = 0;
 336             unsigned long avgAlpha = 0 ;
 337             unsigned long counter = 0 ;
 338             // determine average
 339             for ( int y1 = 0 ; y1 < yFactor ; ++y1 )
 340             {
 341                 long y_offset = (y * yFactor + y1) * old_width;
 342                 for ( int x1 = 0 ; x1 < xFactor ; ++x1 )
 343                 {
 344                     unsigned char *pixel = source_data + 3 * ( y_offset + x * xFactor + x1 ) ;
 345                     unsigned char red = pixel[0] ;
 346                     unsigned char green = pixel[1] ;
 347                     unsigned char blue = pixel[2] ;
 348                     unsigned char alpha = 255  ;
 349                     if ( source_alpha )
 350                         alpha = *(source_alpha + y_offset + x * xFactor + x1) ;
 351                     if ( !hasMask || red != maskRed || green != maskGreen || blue != maskBlue )
 352                     {
 353                         if ( alpha > 0 )
 354                         {
 355                             avgRed += red ;
 356                             avgGreen += green ;
 357                             avgBlue += blue ;
 358                         }
 359                         avgAlpha += alpha ;
 360                         counter++ ;
 361                     }
 362                 }
 363             }
 364             if ( counter == 0 )
 365             {
 366                 *(target_data++) = M_IMGDATA->m_maskRed ;
 367                 *(target_data++) = M_IMGDATA->m_maskGreen ;
 368                 *(target_data++) = M_IMGDATA->m_maskBlue ;
 369             }
 370             else
 371             {
 372                 if ( source_alpha )
 373                     *(target_alpha++) = (unsigned char)(avgAlpha / counter ) ;
 374                 *(target_data++) = (unsigned char)(avgRed / counter);
 375                 *(target_data++) = (unsigned char)(avgGreen / counter);
 376                 *(target_data++) = (unsigned char)(avgBlue / counter);
 377             }
 378         }
 379     }
 380
 381     // In case this is a cursor, make sure the hotspot is scaled accordingly:
 382     if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_X) )
 383         image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X,
 384                 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_X))/xFactor);
 385     if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y) )
 386         image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y,
 387                 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_Y))/yFactor);
 388
 389     return image;
 390 }
 391
 392 wxImage wxImage::Scale( int width, int height ) const
 393 {
 394     wxImage image;
 395
 396     wxCHECK_MSG( Ok(), image, wxT("invalid image") );
 397
 398     // can't scale to/from 0 size
 399     wxCHECK_MSG( (width > 0) && (height > 0), image,
 400                  wxT("invalid new image size") );
 401
 402     long old_height = M_IMGDATA->m_height,
 403          old_width  = M_IMGDATA->m_width;
 404     wxCHECK_MSG( (old_height > 0) && (old_width > 0), image,
 405                  wxT("invalid old image size") );
 406
 407     if ( old_width % width == 0 && old_width >= width &&
 408         old_height % height == 0 && old_height >= height )
 409     {
 410         return ShrinkBy( old_width / width , old_height / height ) ;
 411     }
 412     image.Create( width, height, false );
 413
 414     unsigned char *data = image.GetData();
 415
 416     wxCHECK_MSG( data, image, wxT("unable to create image") );
 417
 418     unsigned char *source_data = M_IMGDATA->m_data;
 419     unsigned char *target_data = data;
 420     unsigned char *source_alpha = 0 ;
 421     unsigned char *target_alpha = 0 ;
 422
 423     if (M_IMGDATA->m_hasMask)
 424     {
 425         image.SetMaskColour( M_IMGDATA->m_maskRed,
 426                              M_IMGDATA->m_maskGreen,
 427                              M_IMGDATA->m_maskBlue );
 428     }
 429     else
 430     {
 431         source_alpha = M_IMGDATA->m_alpha ;
 432         if ( source_alpha )
 433         {
 434             image.SetAlpha() ;
 435             target_alpha = image.GetAlpha() ;
 436         }
 437     }
 438
 439     long x_delta = (old_width<<16) / width;
 440     long y_delta = (old_height<<16) / height;
 441
 442     unsigned char* dest_pixel = target_data;
 443
 444     long y = 0;
 445     for ( long j = 0; j < height; j++ )
 446         {
 447         unsigned char* src_line = &source_data[(y>>16)*old_width*3];
 448         unsigned char* src_alpha_line = source_alpha ? &source_alpha[(y>>16)*old_width] : 0 ;
 449
 450         long x = 0;
 451         for ( long i = 0; i < width; i++ )
 452         {
 453              unsigned char* src_pixel = &src_line[(x>>16)*3];
 454              unsigned char* src_alpha_pixel = source_alpha ? &src_alpha_line[(x>>16)] : 0 ;
 455              dest_pixel[0] = src_pixel[0];
 456              dest_pixel[1] = src_pixel[1];
 457              dest_pixel[2] = src_pixel[2];
 458              dest_pixel += 3;
 459              if ( source_alpha )
 460                 *(target_alpha++) = *src_alpha_pixel ;
 461              x += x_delta;
 462         }
 463
 464         y += y_delta;
 465     }
 466
 467     // In case this is a cursor, make sure the hotspot is scaled accordingly:
 468     if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_X) )
 469         image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X,
 470                 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_X)*width)/old_width);
 471     if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y) )
 472         image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y,
 473                 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_Y)*height)/old_height);
 474
 475     return image;
 476 }
 477
 478 wxImage wxImage::Rotate90( bool clockwise ) const
 479 {
 480     wxImage image;
 481
 482     wxCHECK_MSG( Ok(), image, wxT("invalid image") );
 483
 484     image.Create( M_IMGDATA->m_height, M_IMGDATA->m_width, false );
 485
 486     unsigned char *data = image.GetData();
 487
 488     wxCHECK_MSG( data, image, wxT("unable to create image") );
 489
 490     unsigned char *source_data = M_IMGDATA->m_data;
 491     unsigned char *target_data;
 492     unsigned char *alpha_data = 0 ;
 493     unsigned char *source_alpha = 0 ;
 494     unsigned char *target_alpha = 0 ;
 495
 496     if (M_IMGDATA->m_hasMask)
 497     {
 498         image.SetMaskColour( M_IMGDATA->m_maskRed, M_IMGDATA->m_maskGreen, M_IMGDATA->m_maskBlue );
 499     }
 500     else
 501     {
 502         source_alpha = M_IMGDATA->m_alpha ;
 503         if ( source_alpha )
 504         {
 505             image.SetAlpha() ;
 506             alpha_data = image.GetAlpha() ;
 507         }
 508     }
 509
 510     long height = M_IMGDATA->m_height;
 511     long width  = M_IMGDATA->m_width;
 512
 513     for (long j = 0; j < height; j++)
 514     {
 515         for (long i = 0; i < width; i++)
 516         {
 517             if (clockwise)
 518             {
 519                 target_data = data + (((i+1)*height) - j - 1)*3;
 520                 if(source_alpha)
 521                     target_alpha = alpha_data + (((i+1)*height) - j - 1);
 522             }
 523             else
 524             {
 525                 target_data = data + ((height*(width-1)) + j - (i*height))*3;
 526                 if(source_alpha)
 527                     target_alpha = alpha_data + ((height*(width-1)) + j - (i*height));
 528             }
 529             memcpy( target_data, source_data, 3 );
 530             source_data += 3;
 531
 532             if(source_alpha)
 533             {
 534                 memcpy( target_alpha, source_alpha, 1 );
 535                 source_alpha += 1;
 536             }
 537         }
 538     }
 539
 540     return image;
 541 }
 542
 543 wxImage wxImage::Mirror( bool horizontally ) const
 544 {
 545     wxImage image;
 546
 547     wxCHECK_MSG( Ok(), image, wxT("invalid image") );
 548
 549     image.Create( M_IMGDATA->m_width, M_IMGDATA->m_height, false );
 550
 551     unsigned char *data = image.GetData();
 552     unsigned char *alpha = NULL;
 553
 554     wxCHECK_MSG( data, image, wxT("unable to create image") );
 555
 556     if (M_IMGDATA->m_alpha != NULL) {
 557         image.SetAlpha();
 558         alpha = image.GetAlpha();
 559         wxCHECK_MSG( alpha, image, wxT("unable to create alpha channel") );
 560     }
 561
 562     if (M_IMGDATA->m_hasMask)
 563         image.SetMaskColour( M_IMGDATA->m_maskRed, M_IMGDATA->m_maskGreen, M_IMGDATA->m_maskBlue );
 564
 565     long height = M_IMGDATA->m_height;
 566     long width  = M_IMGDATA->m_width;
 567
 568     unsigned char *source_data = M_IMGDATA->m_data;
 569     unsigned char *target_data;
 570
 571     if (horizontally)
 572     {
 573         for (long j = 0; j < height; j++)
 574         {
 575             data += width*3;
 576             target_data = data-3;
 577             for (long i = 0; i < width; i++)
 578             {
 579                 memcpy( target_data, source_data, 3 );
 580                 source_data += 3;
 581                 target_data -= 3;
 582             }
 583         }
 584
 585         if (alpha != NULL)
 586         {
 587             // src_alpha starts at the first pixel and increases by 1 after each step
 588             // (a step here is the copy of the alpha value of one pixel)
 589             const unsigned char *src_alpha = M_IMGDATA->m_alpha;
 590             // dest_alpha starts just beyond the first line, decreases before each step,
 591             // and after each line is finished, increases by 2 widths (skipping the line
 592             // just copied and the line that will be copied next)
 593             unsigned char *dest_alpha = alpha + width;
 594
 595             for (long jj = 0; jj < height; ++jj)
 596             {
 597                 for (long i = 0; i < width; ++i) {
 598                     *(--dest_alpha) = *(src_alpha++); // copy one pixel
 599                 }
 600                 dest_alpha += 2 * width; // advance beyond the end of the next line
 601             }
 602         }
 603     }
 604     else
 605     {
 606         for (long i = 0; i < height; i++)
 607         {
 608             target_data = data + 3*width*(height-1-i);
 609             memcpy( target_data, source_data, (size_t)3*width );
 610             source_data += 3*width;
 611         }
 612
 613         if (alpha != NULL)
 614         {
 615             // src_alpha starts at the first pixel and increases by 1 width after each step
 616             // (a step here is the copy of the alpha channel of an entire line)
 617             const unsigned char *src_alpha = M_IMGDATA->m_alpha;
 618             // dest_alpha starts just beyond the last line (beyond the whole image)
 619             // and decreases by 1 width before each step
 620             unsigned char *dest_alpha = alpha + width * height;
 621
 622             for (long jj = 0; jj < height; ++jj)
 623             {
 624                 dest_alpha -= width;
 625                 memcpy( dest_alpha, src_alpha, (size_t)width );
 626                 src_alpha += width;
 627             }
 628         }
 629     }
 630
 631     return image;
 632 }
 633
 634 wxImage wxImage::GetSubImage( const wxRect &rect ) const
 635 {
 636     wxImage image;
 637
 638     wxCHECK_MSG( Ok(), image, wxT("invalid image") );
 639
 640     wxCHECK_MSG( (rect.GetLeft()>=0) && (rect.GetTop()>=0) &&
 641                  (rect.GetRight()<=GetWidth()) && (rect.GetBottom()<=GetHeight()),
 642                  image, wxT("invalid subimage size") );
 643
 644     const int subwidth = rect.GetWidth();
 645     const int subheight = rect.GetHeight();
 646
 647     image.Create( subwidth, subheight, false );
 648
 649     const unsigned char *src_data = GetData();
 650     const unsigned char *src_alpha = M_IMGDATA->m_alpha;
 651     unsigned char *subdata = image.GetData();
 652     unsigned char *subalpha = NULL;
 653
 654     wxCHECK_MSG( subdata, image, wxT("unable to create image") );
 655
 656     if (src_alpha != NULL) {
 657         image.SetAlpha();
 658         subalpha = image.GetAlpha();
 659         wxCHECK_MSG( subalpha, image, wxT("unable to create alpha channel"));
 660     }
 661
 662     if (M_IMGDATA->m_hasMask)
 663         image.SetMaskColour( M_IMGDATA->m_maskRed, M_IMGDATA->m_maskGreen, M_IMGDATA->m_maskBlue );
 664
 665     const int width = GetWidth();
 666     const int pixsoff = rect.GetLeft() + width * rect.GetTop();
 667
 668     src_data += 3 * pixsoff;
 669     src_alpha += pixsoff; // won't be used if was NULL, so this is ok
 670
 671     for (long j = 0; j < subheight; ++j)
 672     {
 673         memcpy( subdata, src_data, 3 * subwidth );
 674         subdata += 3 * subwidth;
 675         src_data += 3 * width;
 676         if (subalpha != NULL) {
 677             memcpy( subalpha, src_alpha, subwidth );
 678             subalpha += subwidth;
 679             src_alpha += width;
 680         }
 681     }
 682
 683     return image;
 684 }
 685
 686 wxImage wxImage::Size( const wxSize& size, const wxPoint& pos,
 687                        int r_, int g_, int b_ ) const
 688 {
 689     wxImage image;
 690
 691     wxCHECK_MSG( Ok(), image, wxT("invalid image") );
 692     wxCHECK_MSG( (size.GetWidth() > 0) && (size.GetHeight() > 0), image, wxT("invalid size") );
 693
 694     int width = GetWidth(), height = GetHeight();
 695     image.Create(size.GetWidth(), size.GetHeight(), false);
 696
 697     unsigned char r = (unsigned char)r_;
 698     unsigned char g = (unsigned char)g_;
 699     unsigned char b = (unsigned char)b_;
 700     if ((r_ == -1) && (g_ == -1) && (b_ == -1))
 701     {
 702         GetOrFindMaskColour( &r, &g, &b );
 703         image.SetMaskColour(r, g, b);
 704     }
 705
 706     image.SetRGB(wxRect(), r, g, b);
 707
 708     wxRect subRect(pos.x, pos.y, width, height);
 709     wxRect finalRect(0, 0, size.GetWidth(), size.GetHeight());
 710     if (pos.x < 0)
 711         finalRect.width -= pos.x;
 712     if (pos.y < 0)
 713         finalRect.height -= pos.y;
 714
 715     subRect.Intersect(finalRect);
 716
 717     if (!subRect.IsEmpty())
 718     {
 719         if ((subRect.GetWidth() == width) && (subRect.GetHeight() == height))
 720             image.Paste(*this, pos.x, pos.y);
 721         else
 722             image.Paste(GetSubImage(subRect), pos.x, pos.y);
 723     }
 724
 725     return image;
 726 }
 727
 728 void wxImage::Paste( const wxImage &image, int x, int y )
 729 {
 730     wxCHECK_RET( Ok(), wxT("invalid image") );
 731     wxCHECK_RET( image.Ok(), wxT("invalid image") );
 732
 733     int xx = 0;
 734     int yy = 0;
 735     int width = image.GetWidth();
 736     int height = image.GetHeight();
 737
 738     if (x < 0)
 739     {
 740         xx = -x;
 741         width += x;
 742     }
 743     if (y < 0)
 744     {
 745         yy = -y;
 746         height += y;
 747     }
 748
 749     if ((x+xx)+width > M_IMGDATA->m_width)
 750         width = M_IMGDATA->m_width - (x+xx);
 751     if ((y+yy)+height > M_IMGDATA->m_height)
 752         height = M_IMGDATA->m_height - (y+yy);
 753
 754     if (width < 1) return;
 755     if (height < 1) return;
 756
 757     if ((!HasMask() && !image.HasMask()) ||
 758         (HasMask() && !image.HasMask()) ||
 759        ((HasMask() && image.HasMask() &&
 760          (GetMaskRed()==image.GetMaskRed()) &&
 761          (GetMaskGreen()==image.GetMaskGreen()) &&
 762          (GetMaskBlue()==image.GetMaskBlue()))))
 763     {
 764         width *= 3;
 765         unsigned char* source_data = image.GetData() + xx*3 + yy*3*image.GetWidth();
 766         int source_step = image.GetWidth()*3;
 767
 768         unsigned char* target_data = GetData() + (x+xx)*3 + (y+yy)*3*M_IMGDATA->m_width;
 769         int target_step = M_IMGDATA->m_width*3;
 770         for (int j = 0; j < height; j++)
 771         {
 772             memcpy( target_data, source_data, width );
 773             source_data += source_step;
 774             target_data += target_step;
 775         }
 776         return;
 777     }
 778
 779     if (!HasMask() && image.HasMask())
 780     {
 781         unsigned char r = image.GetMaskRed();
 782         unsigned char g = image.GetMaskGreen();
 783         unsigned char b = image.GetMaskBlue();
 784
 785         width *= 3;
 786         unsigned char* source_data = image.GetData() + xx*3 + yy*3*image.GetWidth();
 787         int source_step = image.GetWidth()*3;
 788
 789         unsigned char* target_data = GetData() + (x+xx)*3 + (y+yy)*3*M_IMGDATA->m_width;
 790         int target_step = M_IMGDATA->m_width*3;
 791
 792         for (int j = 0; j < height; j++)
 793         {
 794             for (int i = 0; i < width; i+=3)
 795             {
 796                 if ((source_data[i]   != r) &&
 797                     (source_data[i+1] != g) &&
 798                     (source_data[i+2] != b))
 799                 {
 800                     memcpy( target_data+i, source_data+i, 3 );
 801                 }
 802             }
 803             source_data += source_step;
 804             target_data += target_step;
 805         }
 806     }
 807 }
 808
 809 void wxImage::Replace( unsigned char r1, unsigned char g1, unsigned char b1,
 810                        unsigned char r2, unsigned char g2, unsigned char b2 )
 811 {
 812     wxCHECK_RET( Ok(), wxT("invalid image") );
 813
 814     unsigned char *data = GetData();
 815
 816     const int w = GetWidth();
 817     const int h = GetHeight();
 818
 819     for (int j = 0; j < h; j++)
 820         for (int i = 0; i < w; i++)
 821         {
 822             if ((data[0] == r1) && (data[1] == g1) && (data[2] == b1))
 823             {
 824                 data[0] = r2;
 825                 data[1] = g2;
 826                 data[2] = b2;
 827             }
 828             data += 3;
 829         }
 830 }
 831
 832 wxImage wxImage::ConvertToGreyscale( double lr, double lg, double lb ) const
 833 {
 834     wxImage image;
 835
 836     wxCHECK_MSG( Ok(), image, wxT("invalid image") );
 837
 838     image.Create(M_IMGDATA->m_width, M_IMGDATA->m_height, false);
 839
 840     unsigned char *dest = image.GetData();
 841
 842     wxCHECK_MSG( dest, image, wxT("unable to create image") );
 843
 844     unsigned char *src = M_IMGDATA->m_data;
 845     bool hasMask = M_IMGDATA->m_hasMask;
 846     unsigned char maskRed = M_IMGDATA->m_maskRed;
 847     unsigned char maskGreen = M_IMGDATA->m_maskGreen;
 848     unsigned char maskBlue = M_IMGDATA->m_maskBlue;
 849
 850     if ( hasMask )
 851         image.SetMaskColour(maskRed, maskGreen, maskBlue);
 852
 853     const long size = M_IMGDATA->m_width * M_IMGDATA->m_height;
 854     for ( long i = 0; i < size; i++, src += 3, dest += 3 )
 855     {
 856         // don't modify the mask
 857         if ( hasMask && src[0] == maskRed && src[1] == maskGreen && src[2] == maskBlue )
 858         {
 859             memcpy(dest, src, 3);
 860         }
 861         else
 862         {
 863             // calculate the luma
 864             double luma = (src[0] * lr + src[1] * lg + src[2] * lb) + 0.5;
 865             dest[0] = dest[1] = dest[2] = wx_static_cast(unsigned char, luma);
 866         }
 867     }
 868
 869     return image;
 870 }
 871
 872 wxImage wxImage::ConvertToMono( unsigned char r, unsigned char g, unsigned char b ) const
 873 {
 874     wxImage image;
 875
 876     wxCHECK_MSG( Ok(), image, wxT("invalid image") );
 877
 878     image.Create( M_IMGDATA->m_width, M_IMGDATA->m_height, false );
 879
 880     unsigned char *data = image.GetData();
 881
 882     wxCHECK_MSG( data, image, wxT("unable to create image") );
 883
 884     if (M_IMGDATA->m_hasMask)
 885     {
 886         if (M_IMGDATA->m_maskRed == r && M_IMGDATA->m_maskGreen == g &&
 887                                          M_IMGDATA->m_maskBlue == b)
 888             image.SetMaskColour( 255, 255, 255 );
 889         else
 890             image.SetMaskColour( 0, 0, 0 );
 891     }
 892
 893     long size = M_IMGDATA->m_height * M_IMGDATA->m_width;
 894
 895     unsigned char *srcd = M_IMGDATA->m_data;
 896     unsigned char *tard = image.GetData();
 897
 898     for ( long i = 0; i < size; i++, srcd += 3, tard += 3 )
 899     {
 900         if (srcd[0] == r && srcd[1] == g && srcd[2] == b)
 901             tard[0] = tard[1] = tard[2] = 255;
 902         else
 903             tard[0] = tard[1] = tard[2] = 0;
 904     }
 905
 906     return image;
 907 }
 908
 909 int wxImage::GetWidth() const
 910 {
 911     wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
 912
 913     return M_IMGDATA->m_width;
 914 }
 915
 916 int wxImage::GetHeight() const
 917 {
 918     wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
 919
 920     return M_IMGDATA->m_height;
 921 }
 922
 923 long wxImage::XYToIndex(int x, int y) const
 924 {
 925     if ( Ok() &&
 926             x >= 0 && y >= 0 &&
 927                 x < M_IMGDATA->m_width && y < M_IMGDATA->m_height )
 928     {
 929         return y*M_IMGDATA->m_width + x;
 930     }
 931
 932     return -1;
 933 }
 934
 935 void wxImage::SetRGB( int x, int y, unsigned char r, unsigned char g, unsigned char b )
 936 {
 937     long pos = XYToIndex(x, y);
 938     wxCHECK_RET( pos != -1, wxT("invalid image coordinates") );
 939
 940     pos *= 3;
 941
 942     M_IMGDATA->m_data[ pos   ] = r;
 943     M_IMGDATA->m_data[ pos+1 ] = g;
 944     M_IMGDATA->m_data[ pos+2 ] = b;
 945 }
 946
 947 void wxImage::SetRGB( const wxRect& rect_, unsigned char r, unsigned char g, unsigned char b )
 948 {
 949     wxCHECK_RET( Ok(), wxT("invalid image") );
 950
 951     wxRect rect(rect_);
 952     wxRect imageRect(0, 0, GetWidth(), GetHeight());
 953     if ( rect == wxRect() )
 954     {
 955         rect = imageRect;
 956     }
 957     else
 958     {
 959         wxCHECK_RET( imageRect.Inside(rect.GetTopLeft()) &&
 960                      imageRect.Inside(rect.GetBottomRight()),
 961                      wxT("invalid bounding rectangle") );
 962     }
 963
 964     int x1 = rect.GetLeft(),
 965         y1 = rect.GetTop(),
 966         x2 = rect.GetRight() + 1,
 967         y2 = rect.GetBottom() + 1;
 968
 969     unsigned char *data wxDUMMY_INITIALIZE(NULL);
 970     int x, y, width = GetWidth();
 971     for (y = y1; y < y2; y++)
 972     {
 973         data = M_IMGDATA->m_data + (y*width + x1)*3;
 974         for (x = x1; x < x2; x++)
 975         {
 976             *data++ = r;
 977             *data++ = g;
 978             *data++ = b;
 979         }
 980     }
 981 }
 982
 983 unsigned char wxImage::GetRed( int x, int y ) const
 984 {
 985     long pos = XYToIndex(x, y);
 986     wxCHECK_MSG( pos != -1, 0, wxT("invalid image coordinates") );
 987
 988     pos *= 3;
 989
 990     return M_IMGDATA->m_data[pos];
 991 }
 992
 993 unsigned char wxImage::GetGreen( int x, int y ) const
 994 {
 995     long pos = XYToIndex(x, y);
 996     wxCHECK_MSG( pos != -1, 0, wxT("invalid image coordinates") );
 997
 998     pos *= 3;
 999
1000     return M_IMGDATA->m_data[pos+1];
1001 }
1002
1003 unsigned char wxImage::GetBlue( int x, int y ) const
1004 {
1005     long pos = XYToIndex(x, y);
1006     wxCHECK_MSG( pos != -1, 0, wxT("invalid image coordinates") );
1007
1008     pos *= 3;
1009
1010     return M_IMGDATA->m_data[pos+2];
1011 }
1012
1013 bool wxImage::Ok() const
1014 {
1015     // image of 0 width or height can't be considered ok - at least because it
1016     // causes crashes in ConvertToBitmap() if we don't catch it in time
1017     wxImageRefData *data = M_IMGDATA;
1018     return data && data->m_ok && data->m_width && data->m_height;
1019 }
1020
1021 unsigned char *wxImage::GetData() const
1022 {
1023     wxCHECK_MSG( Ok(), (unsigned char *)NULL, wxT("invalid image") );
1024
1025     return M_IMGDATA->m_data;
1026 }
1027
1028 void wxImage::SetData( unsigned char *data, bool static_data  )
1029 {
1030     wxCHECK_RET( Ok(), wxT("invalid image") );
1031
1032     wxImageRefData *newRefData = new wxImageRefData();
1033
1034     newRefData->m_width = M_IMGDATA->m_width;
1035     newRefData->m_height = M_IMGDATA->m_height;
1036     newRefData->m_data = data;
1037     newRefData->m_ok = true;
1038     newRefData->m_maskRed = M_IMGDATA->m_maskRed;
1039     newRefData->m_maskGreen = M_IMGDATA->m_maskGreen;
1040     newRefData->m_maskBlue = M_IMGDATA->m_maskBlue;
1041     newRefData->m_hasMask = M_IMGDATA->m_hasMask;
1042     newRefData->m_static = static_data;
1043
1044     UnRef();
1045
1046     m_refData = newRefData;
1047 }
1048
1049 void wxImage::SetData( unsigned char *data, int new_width, int new_height, bool static_data )
1050 {
1051     wxImageRefData *newRefData = new wxImageRefData();
1052
1053     if (m_refData)
1054     {
1055         newRefData->m_width = new_width;
1056         newRefData->m_height = new_height;
1057         newRefData->m_data = data;
1058         newRefData->m_ok = true;
1059         newRefData->m_maskRed = M_IMGDATA->m_maskRed;
1060         newRefData->m_maskGreen = M_IMGDATA->m_maskGreen;
1061         newRefData->m_maskBlue = M_IMGDATA->m_maskBlue;
1062         newRefData->m_hasMask = M_IMGDATA->m_hasMask;
1063     }
1064     else
1065     {
1066         newRefData->m_width = new_width;
1067         newRefData->m_height = new_height;
1068         newRefData->m_data = data;
1069         newRefData->m_ok = true;
1070     }
1071     newRefData->m_static = static_data;
1072
1073     UnRef();
1074
1075     m_refData = newRefData;
1076 }
1077
1078 // ----------------------------------------------------------------------------
1079 // alpha channel support
1080 // ----------------------------------------------------------------------------
1081
1082 void wxImage::SetAlpha(int x, int y, unsigned char alpha)
1083 {
1084     wxCHECK_RET( HasAlpha(), wxT("no alpha channel") );
1085
1086     long pos = XYToIndex(x, y);
1087     wxCHECK_RET( pos != -1, wxT("invalid image coordinates") );
1088
1089     M_IMGDATA->m_alpha[pos] = alpha;
1090 }
1091
1092 unsigned char wxImage::GetAlpha(int x, int y) const
1093 {
1094     wxCHECK_MSG( HasAlpha(), 0, wxT("no alpha channel") );
1095
1096     long pos = XYToIndex(x, y);
1097     wxCHECK_MSG( pos != -1, 0, wxT("invalid image coordinates") );
1098
1099     return M_IMGDATA->m_alpha[pos];
1100 }
1101
1102 bool
1103 wxImage::ConvertColourToAlpha(unsigned char r, unsigned char g, unsigned char b)
1104 {
1105     SetAlpha(NULL);
1106
1107     const int w = M_IMGDATA->m_width;
1108     const int h = M_IMGDATA->m_height;
1109
1110     unsigned char *alpha = GetAlpha();
1111     unsigned char *data = GetData();
1112
1113     for ( int y = 0; y < h; y++ )
1114     {
1115         for ( int x = 0; x < w; x++ )
1116         {
1117             *alpha++ = *data;
1118             *data++ = r;
1119             *data++ = g;
1120             *data++ = b;
1121         }
1122     }
1123
1124     return true;
1125 }
1126
1127 void wxImage::SetAlpha( unsigned char *alpha, bool static_data )
1128 {
1129     wxCHECK_RET( Ok(), wxT("invalid image") );
1130
1131     if ( !alpha )
1132     {
1133         alpha = (unsigned char *)malloc(M_IMGDATA->m_width*M_IMGDATA->m_height);
1134     }
1135
1136     free(M_IMGDATA->m_alpha);
1137     M_IMGDATA->m_alpha = alpha;
1138     M_IMGDATA->m_staticAlpha = static_data;
1139 }
1140
1141 unsigned char *wxImage::GetAlpha() const
1142 {
1143     wxCHECK_MSG( Ok(), (unsigned char *)NULL, wxT("invalid image") );
1144
1145     return M_IMGDATA->m_alpha;
1146 }
1147
1148 void wxImage::InitAlpha()
1149 {
1150     wxCHECK_RET( !HasAlpha(), wxT("image already has an alpha channel") );
1151
1152     // initialize memory for alpha channel
1153     SetAlpha();
1154
1155     unsigned char *alpha = M_IMGDATA->m_alpha;
1156     const size_t lenAlpha = M_IMGDATA->m_width * M_IMGDATA->m_height;
1157
1158     if ( HasMask() )
1159     {
1160         // use the mask to initialize the alpha channel.
1161         const unsigned char * const alphaEnd = alpha + lenAlpha;
1162
1163         const unsigned char mr = M_IMGDATA->m_maskRed;
1164         const unsigned char mg = M_IMGDATA->m_maskGreen;
1165         const unsigned char mb = M_IMGDATA->m_maskBlue;
1166         for ( unsigned char *src = M_IMGDATA->m_data;
1167               alpha < alphaEnd;
1168               src += 3, alpha++ )
1169         {
1170             *alpha = (src[0] == mr && src[1] == mg && src[2] == mb)
1171                             ? wxIMAGE_ALPHA_TRANSPARENT
1172                             : wxIMAGE_ALPHA_OPAQUE;
1173         }
1174
1175         M_IMGDATA->m_hasMask = false;
1176     }
1177     else // no mask
1178     {
1179         // make the image fully opaque
1180         memset(alpha, wxIMAGE_ALPHA_OPAQUE, lenAlpha);
1181     }
1182 }
1183
1184 // ----------------------------------------------------------------------------
1185 // mask support
1186 // ----------------------------------------------------------------------------
1187
1188 void wxImage::SetMaskColour( unsigned char r, unsigned char g, unsigned char b )
1189 {
1190     wxCHECK_RET( Ok(), wxT("invalid image") );
1191
1192     M_IMGDATA->m_maskRed = r;
1193     M_IMGDATA->m_maskGreen = g;
1194     M_IMGDATA->m_maskBlue = b;
1195     M_IMGDATA->m_hasMask = true;
1196 }
1197
1198 bool wxImage::GetOrFindMaskColour( unsigned char *r, unsigned char *g, unsigned char *b ) const
1199 {
1200     wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1201
1202     if (M_IMGDATA->m_hasMask)
1203     {
1204         if (r) *r = M_IMGDATA->m_maskRed;
1205         if (g) *g = M_IMGDATA->m_maskGreen;
1206         if (b) *b = M_IMGDATA->m_maskBlue;
1207         return true;
1208     }
1209     else
1210     {
1211         FindFirstUnusedColour(r, g, b);
1212         return false;
1213     }
1214 }
1215
1216 unsigned char wxImage::GetMaskRed() const
1217 {
1218     wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1219
1220     return M_IMGDATA->m_maskRed;
1221 }
1222
1223 unsigned char wxImage::GetMaskGreen() const
1224 {
1225     wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1226
1227     return M_IMGDATA->m_maskGreen;
1228 }
1229
1230 unsigned char wxImage::GetMaskBlue() const
1231 {
1232     wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1233
1234     return M_IMGDATA->m_maskBlue;
1235 }
1236
1237 void wxImage::SetMask( bool mask )
1238 {
1239     wxCHECK_RET( Ok(), wxT("invalid image") );
1240
1241     M_IMGDATA->m_hasMask = mask;
1242 }
1243
1244 bool wxImage::HasMask() const
1245 {
1246     wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1247
1248     return M_IMGDATA->m_hasMask;
1249 }
1250
1251 bool wxImage::IsTransparent(int x, int y, unsigned char threshold) const
1252 {
1253     long pos = XYToIndex(x, y);
1254     wxCHECK_MSG( pos != -1, false, wxT("invalid image coordinates") );
1255
1256     // check mask
1257     if ( M_IMGDATA->m_hasMask )
1258     {
1259         const unsigned char *p = M_IMGDATA->m_data + 3*pos;
1260         if ( p[0] == M_IMGDATA->m_maskRed &&
1261                 p[1] == M_IMGDATA->m_maskGreen &&
1262                     p[2] == M_IMGDATA->m_maskBlue )
1263         {
1264             return true;
1265         }
1266     }
1267
1268     // then check alpha
1269     if ( M_IMGDATA->m_alpha )
1270     {
1271         if ( M_IMGDATA->m_alpha[pos] < threshold )
1272         {
1273             // transparent enough
1274             return true;
1275         }
1276     }
1277
1278     // not transparent
1279     return false;
1280 }
1281
1282 bool wxImage::SetMaskFromImage(const wxImage& mask,
1283                                unsigned char mr, unsigned char mg, unsigned char mb)
1284 {
1285     // check that the images are the same size
1286     if ( (M_IMGDATA->m_height != mask.GetHeight() ) || (M_IMGDATA->m_width != mask.GetWidth () ) )
1287     {
1288         wxLogError( _("Image and mask have different sizes.") );
1289         return false;
1290     }
1291
1292     // find unused colour
1293     unsigned char r,g,b ;
1294     if (!FindFirstUnusedColour(&r, &g, &b))
1295     {
1296         wxLogError( _("No unused colour in image being masked.") );
1297         return false ;
1298     }
1299
1300     unsigned char *imgdata = GetData();
1301     unsigned char *maskdata = mask.GetData();
1302
1303     const int w = GetWidth();
1304     const int h = GetHeight();
1305
1306     for (int j = 0; j < h; j++)
1307     {
1308         for (int i = 0; i < w; i++)
1309         {
1310             if ((maskdata[0] == mr) && (maskdata[1]  == mg) && (maskdata[2] == mb))
1311             {
1312                 imgdata[0] = r;
1313                 imgdata[1] = g;
1314                 imgdata[2] = b;
1315             }
1316             imgdata  += 3;
1317             maskdata += 3;
1318         }
1319     }
1320
1321     SetMaskColour(r, g, b);
1322     SetMask(true);
1323
1324     return true;
1325 }
1326
1327 bool wxImage::ConvertAlphaToMask(unsigned char threshold)
1328 {
1329     if (!HasAlpha())
1330         return true;
1331
1332     unsigned char mr, mg, mb;
1333     if (!FindFirstUnusedColour(&mr, &mg, &mb))
1334     {
1335         wxLogError( _("No unused colour in image being masked.") );
1336         return false;
1337     }
1338
1339     SetMask(true);
1340     SetMaskColour(mr, mg, mb);
1341
1342     unsigned char *imgdata = GetData();
1343     unsigned char *alphadata = GetAlpha();
1344
1345     int w = GetWidth();
1346     int h = GetHeight();
1347
1348     for (int y = 0; y < h; y++)
1349     {
1350         for (int x = 0; x < w; x++, imgdata += 3, alphadata++)
1351         {
1352             if (*alphadata < threshold)
1353             {
1354                 imgdata[0] = mr;
1355                 imgdata[1] = mg;
1356                 imgdata[2] = mb;
1357             }
1358         }
1359     }
1360
1361     free(M_IMGDATA->m_alpha);
1362     M_IMGDATA->m_alpha = NULL;
1363
1364     return true;
1365 }
1366
1367 // ----------------------------------------------------------------------------
1368 // Palette functions
1369 // ----------------------------------------------------------------------------
1370
1371 #if wxUSE_PALETTE
1372
1373 bool wxImage::HasPalette() const
1374 {
1375     if (!Ok())
1376         return false;
1377
1378     return M_IMGDATA->m_palette.Ok();
1379 }
1380
1381 const wxPalette& wxImage::GetPalette() const
1382 {
1383     wxCHECK_MSG( Ok(), wxNullPalette, wxT("invalid image") );
1384
1385     return M_IMGDATA->m_palette;
1386 }
1387
1388 void wxImage::SetPalette(const wxPalette& palette)
1389 {
1390     wxCHECK_RET( Ok(), wxT("invalid image") );
1391
1392     M_IMGDATA->m_palette = palette;
1393 }
1394
1395 #endif // wxUSE_PALETTE
1396
1397 // ----------------------------------------------------------------------------
1398 // Option functions (arbitrary name/value mapping)
1399 // ----------------------------------------------------------------------------
1400
1401 void wxImage::SetOption(const wxString& name, const wxString& value)
1402 {
1403     wxCHECK_RET( Ok(), wxT("invalid image") );
1404
1405     int idx = M_IMGDATA->m_optionNames.Index(name, false);
1406     if (idx == wxNOT_FOUND)
1407     {
1408         M_IMGDATA->m_optionNames.Add(name);
1409         M_IMGDATA->m_optionValues.Add(value);
1410     }
1411     else
1412     {
1413         M_IMGDATA->m_optionNames[idx] = name;
1414         M_IMGDATA->m_optionValues[idx] = value;
1415     }
1416 }
1417
1418 void wxImage::SetOption(const wxString& name, int value)
1419 {
1420     wxString valStr;
1421     valStr.Printf(wxT("%d"), value);
1422     SetOption(name, valStr);
1423 }
1424
1425 wxString wxImage::GetOption(const wxString& name) const
1426 {
1427     wxCHECK_MSG( Ok(), wxEmptyString, wxT("invalid image") );
1428
1429     int idx = M_IMGDATA->m_optionNames.Index(name, false);
1430     if (idx == wxNOT_FOUND)
1431         return wxEmptyString;
1432     else
1433         return M_IMGDATA->m_optionValues[idx];
1434 }
1435
1436 int wxImage::GetOptionInt(const wxString& name) const
1437 {
1438     return wxAtoi(GetOption(name));
1439 }
1440
1441 bool wxImage::HasOption(const wxString& name) const
1442 {
1443     wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1444
1445     return (M_IMGDATA->m_optionNames.Index(name, false) != wxNOT_FOUND);
1446 }
1447
1448 // ----------------------------------------------------------------------------
1449 // image I/O
1450 // ----------------------------------------------------------------------------
1451
1452 bool wxImage::LoadFile( const wxString& filename, long type, int index )
1453 {
1454 #if wxUSE_STREAMS
1455     if (wxFileExists(filename))
1456     {
1457         wxFileInputStream stream(filename);
1458         wxBufferedInputStream bstream( stream );
1459         return LoadFile(bstream, type, index);
1460     }
1461     else
1462     {
1463         wxLogError( _("Can't load image from file '%s': file does not exist."), filename.c_str() );
1464
1465         return false;
1466     }
1467 #else // !wxUSE_STREAMS
1468     return false;
1469 #endif // wxUSE_STREAMS
1470 }
1471
1472 bool wxImage::LoadFile( const wxString& filename, const wxString& mimetype, int index )
1473 {
1474 #if wxUSE_STREAMS
1475     if (wxFileExists(filename))
1476     {
1477         wxFileInputStream stream(filename);
1478         wxBufferedInputStream bstream( stream );
1479         return LoadFile(bstream, mimetype, index);
1480     }
1481     else
1482     {
1483         wxLogError( _("Can't load image from file '%s': file does not exist."), filename.c_str() );
1484
1485         return false;
1486     }
1487 #else // !wxUSE_STREAMS
1488     return false;
1489 #endif // wxUSE_STREAMS
1490 }
1491
1492
1493
1494 bool wxImage::SaveFile( const wxString& filename ) const
1495 {
1496     wxString ext = filename.AfterLast('.').Lower();
1497
1498     wxImageHandler * pHandler = FindHandler(ext, -1);
1499     if (pHandler)
1500     {
1501         SaveFile(filename, pHandler->GetType());
1502         return true;
1503     }
1504
1505     wxLogError(_("Can't save image to file '%s': unknown extension."), filename.c_str());
1506
1507     return false;
1508 }
1509
1510 bool wxImage::SaveFile( const wxString& filename, int type ) const
1511 {
1512 #if wxUSE_STREAMS
1513     wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1514
1515     ((wxImage*)this)->SetOption(wxIMAGE_OPTION_FILENAME, filename);
1516
1517     wxFileOutputStream stream(filename);
1518
1519     if ( stream.IsOk() )
1520     {
1521         wxBufferedOutputStream bstream( stream );
1522         return SaveFile(bstream, type);
1523     }
1524 #endif // wxUSE_STREAMS
1525
1526     return false;
1527 }
1528
1529 bool wxImage::SaveFile( const wxString& filename, const wxString& mimetype ) const
1530 {
1531 #if wxUSE_STREAMS
1532     wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1533
1534     ((wxImage*)this)->SetOption(wxIMAGE_OPTION_FILENAME, filename);
1535
1536     wxFileOutputStream stream(filename);
1537
1538     if ( stream.IsOk() )
1539     {
1540         wxBufferedOutputStream bstream( stream );
1541         return SaveFile(bstream, mimetype);
1542     }
1543 #endif // wxUSE_STREAMS
1544
1545     return false;
1546 }
1547
1548 bool wxImage::CanRead( const wxString &name )
1549 {
1550 #if wxUSE_STREAMS
1551   wxFileInputStream stream(name);
1552   return CanRead(stream);
1553 #else
1554   return false;
1555 #endif
1556 }
1557
1558 int wxImage::GetImageCount( const wxString &name, long type )
1559 {
1560 #if wxUSE_STREAMS
1561   wxFileInputStream stream(name);
1562   if (stream.Ok())
1563       return GetImageCount(stream, type);
1564 #endif
1565
1566   return 0;
1567 }
1568
1569 #if wxUSE_STREAMS
1570
1571 bool wxImage::CanRead( wxInputStream &stream )
1572 {
1573     const wxList& list = GetHandlers();
1574
1575     for ( wxList::compatibility_iterator node = list.GetFirst(); node; node = node->GetNext() )
1576     {
1577         wxImageHandler *handler=(wxImageHandler*)node->GetData();
1578         if (handler->CanRead( stream ))
1579             return true;
1580     }
1581
1582     return false;
1583 }
1584
1585 int wxImage::GetImageCount( wxInputStream &stream, long type )
1586 {
1587     wxImageHandler *handler;
1588
1589     if ( type == wxBITMAP_TYPE_ANY )
1590     {
1591         wxList &list=GetHandlers();
1592
1593         for (wxList::compatibility_iterator node = list.GetFirst(); node; node = node->GetNext())
1594         {
1595              handler=(wxImageHandler*)node->GetData();
1596              if ( handler->CanRead(stream) )
1597                  return handler->GetImageCount(stream);
1598
1599         }
1600
1601         wxLogWarning(_("No handler found for image type."));
1602         return 0;
1603     }
1604
1605     handler = FindHandler(type);
1606
1607     if ( !handler )
1608     {
1609         wxLogWarning(_("No image handler for type %d defined."), type);
1610         return false;
1611     }
1612
1613     if ( handler->CanRead(stream) )
1614     {
1615         return handler->GetImageCount(stream);
1616     }
1617     else
1618     {
1619         wxLogError(_("Image file is not of type %d."), type);
1620         return 0;
1621     }
1622 }
1623
1624 bool wxImage::LoadFile( wxInputStream& stream, long type, int index )
1625 {
1626     UnRef();
1627
1628     m_refData = new wxImageRefData;
1629
1630     wxImageHandler *handler;
1631
1632     if ( type == wxBITMAP_TYPE_ANY )
1633     {
1634         wxList &list=GetHandlers();
1635
1636         for ( wxList::compatibility_iterator node = list.GetFirst(); node; node = node->GetNext() )
1637         {
1638              handler=(wxImageHandler*)node->GetData();
1639              if ( handler->CanRead(stream) )
1640                  return handler->LoadFile(this, stream, true/*verbose*/, index);
1641
1642         }
1643
1644         wxLogWarning( _("No handler found for image type.") );
1645         return false;
1646     }
1647
1648     handler = FindHandler(type);
1649
1650     if (handler == 0)
1651     {
1652         wxLogWarning( _("No image handler for type %d defined."), type );
1653
1654         return false;
1655     }
1656
1657     if (stream.IsSeekable() && !handler->CanRead(stream))
1658     {
1659         wxLogError(_("Image file is not of type %d."), type);
1660         return false;
1661     }
1662     else
1663         return handler->LoadFile(this, stream, true/*verbose*/, index);
1664 }
1665
1666 bool wxImage::LoadFile( wxInputStream& stream, const wxString& mimetype, int index )
1667 {
1668     UnRef();
1669
1670     m_refData = new wxImageRefData;
1671
1672     wxImageHandler *handler = FindHandlerMime(mimetype);
1673
1674     if (handler == 0)
1675     {
1676         wxLogWarning( _("No image handler for type %s defined."), mimetype.GetData() );
1677
1678         return false;
1679     }
1680
1681     if (stream.IsSeekable() && !handler->CanRead(stream))
1682     {
1683         wxLogError(_("Image file is not of type %s."), (const wxChar*) mimetype);
1684         return false;
1685     }
1686     else
1687         return handler->LoadFile( this, stream, true/*verbose*/, index );
1688 }
1689
1690 bool wxImage::SaveFile( wxOutputStream& stream, int type ) const
1691 {
1692     wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1693
1694     wxImageHandler *handler = FindHandler(type);
1695     if ( !handler )
1696     {
1697         wxLogWarning( _("No image handler for type %d defined."), type );
1698
1699         return false;
1700     }
1701
1702     return handler->SaveFile( (wxImage*)this, stream );
1703 }
1704
1705 bool wxImage::SaveFile( wxOutputStream& stream, const wxString& mimetype ) const
1706 {
1707     wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1708
1709     wxImageHandler *handler = FindHandlerMime(mimetype);
1710     if ( !handler )
1711     {
1712         wxLogWarning( _("No image handler for type %s defined."), mimetype.GetData() );
1713
1714         return false;
1715     }
1716
1717     return handler->SaveFile( (wxImage*)this, stream );
1718 }
1719 #endif // wxUSE_STREAMS
1720
1721 // ----------------------------------------------------------------------------
1722 // image I/O handlers
1723 // ----------------------------------------------------------------------------
1724
1725 void wxImage::AddHandler( wxImageHandler *handler )
1726 {
1727     // Check for an existing handler of the type being added.
1728     if (FindHandler( handler->GetType() ) == 0)
1729     {
1730         sm_handlers.Append( handler );
1731     }
1732     else
1733     {
1734         // This is not documented behaviour, merely the simplest 'fix'
1735         // for preventing duplicate additions.  If someone ever has
1736         // a good reason to add and remove duplicate handlers (and they
1737         // may) we should probably refcount the duplicates.
1738         //   also an issue in InsertHandler below.
1739
1740         wxLogDebug( _T("Adding duplicate image handler for '%s'"),
1741                     handler->GetName().c_str() );
1742         delete handler;
1743     }
1744 }
1745
1746 void wxImage::InsertHandler( wxImageHandler *handler )
1747 {
1748     // Check for an existing handler of the type being added.
1749     if (FindHandler( handler->GetType() ) == 0)
1750     {
1751         sm_handlers.Insert( handler );
1752     }
1753     else
1754     {
1755         // see AddHandler for additional comments.
1756         wxLogDebug( _T("Inserting duplicate image handler for '%s'"),
1757                     handler->GetName().c_str() );
1758         delete handler;
1759     }
1760 }
1761
1762 bool wxImage::RemoveHandler( const wxString& name )
1763 {
1764     wxImageHandler *handler = FindHandler(name);
1765     if (handler)
1766     {
1767         sm_handlers.DeleteObject(handler);
1768         delete handler;
1769         return true;
1770     }
1771     else
1772         return false;
1773 }
1774
1775 wxImageHandler *wxImage::FindHandler( const wxString& name )
1776 {
1777     wxList::compatibility_iterator node = sm_handlers.GetFirst();
1778     while (node)
1779     {
1780         wxImageHandler *handler = (wxImageHandler*)node->GetData();
1781         if (handler->GetName().Cmp(name) == 0) return handler;
1782
1783         node = node->GetNext();
1784     }
1785     return 0;
1786 }
1787
1788 wxImageHandler *wxImage::FindHandler( const wxString& extension, long bitmapType )
1789 {
1790     wxList::compatibility_iterator node = sm_handlers.GetFirst();
1791     while (node)
1792     {
1793         wxImageHandler *handler = (wxImageHandler*)node->GetData();
1794         if ( (handler->GetExtension().Cmp(extension) == 0) &&
1795             (bitmapType == -1 || handler->GetType() == bitmapType) )
1796             return handler;
1797         node = node->GetNext();
1798     }
1799     return 0;
1800 }
1801
1802 wxImageHandler *wxImage::FindHandler( long bitmapType )
1803 {
1804     wxList::compatibility_iterator node = sm_handlers.GetFirst();
1805     while (node)
1806     {
1807         wxImageHandler *handler = (wxImageHandler *)node->GetData();
1808         if (handler->GetType() == bitmapType) return handler;
1809         node = node->GetNext();
1810     }
1811     return 0;
1812 }
1813
1814 wxImageHandler *wxImage::FindHandlerMime( const wxString& mimetype )
1815 {
1816     wxList::compatibility_iterator node = sm_handlers.GetFirst();
1817     while (node)
1818     {
1819         wxImageHandler *handler = (wxImageHandler *)node->GetData();
1820         if (handler->GetMimeType().IsSameAs(mimetype, false)) return handler;
1821         node = node->GetNext();
1822     }
1823     return 0;
1824 }
1825
1826 void wxImage::InitStandardHandlers()
1827 {
1828 #if wxUSE_STREAMS
1829     AddHandler(new wxBMPHandler);
1830 #endif // wxUSE_STREAMS
1831 }
1832
1833 void wxImage::CleanUpHandlers()
1834 {
1835     wxList::compatibility_iterator node = sm_handlers.GetFirst();
1836     while (node)
1837     {
1838         wxImageHandler *handler = (wxImageHandler *)node->GetData();
1839         wxList::compatibility_iterator next = node->GetNext();
1840         delete handler;
1841         node = next;
1842     }
1843
1844     sm_handlers.Clear();
1845 }
1846
1847 wxString wxImage::GetImageExtWildcard()
1848 {
1849     wxString fmts;
1850
1851     wxList& Handlers = wxImage::GetHandlers();
1852     wxList::compatibility_iterator Node = Handlers.GetFirst();
1853     while ( Node )
1854     {
1855         wxImageHandler* Handler = (wxImageHandler*)Node->GetData();
1856         fmts += wxT("*.") + Handler->GetExtension();
1857         Node = Node->GetNext();
1858         if ( Node ) fmts += wxT(";");
1859     }
1860
1861     return wxT("(") + fmts + wxT(")|") + fmts;
1862 }
1863
1864 wxImage::HSVValue wxImage::RGBtoHSV(const RGBValue& rgb)
1865 {
1866     const double red = rgb.red / 255.0,
1867                  green = rgb.green / 255.0,
1868                  blue = rgb.blue / 255.0;
1869
1870     // find the min and max intensity (and remember which one was it for the
1871     // latter)
1872     double minimumRGB = red;
1873     if ( green < minimumRGB )
1874         minimumRGB = green;
1875     if ( blue < minimumRGB )
1876         minimumRGB = blue;
1877
1878     enum { RED, GREEN, BLUE } chMax = RED;
1879     double maximumRGB = red;
1880     if ( green > maximumRGB )
1881     {
1882         chMax = GREEN;
1883         maximumRGB = green;
1884     }
1885     if ( blue > maximumRGB )
1886     {
1887         chMax = BLUE;
1888         maximumRGB = blue;
1889     }
1890
1891     const double value = maximumRGB;
1892
1893     double hue = 0.0, saturation;
1894     const double deltaRGB = maximumRGB - minimumRGB;
1895     if ( wxIsNullDouble(deltaRGB) )
1896     {
1897         // Gray has no color
1898         hue = 0.0;
1899         saturation = 0.0;
1900     }
1901     else
1902     {
1903         switch ( chMax )
1904         {
1905             case RED:
1906                 hue = (green - blue) / deltaRGB;
1907                 break;
1908
1909             case GREEN:
1910                 hue = 2.0 + (blue - red) / deltaRGB;
1911                 break;
1912
1913             case BLUE:
1914                 hue = 4.0 + (red - green) / deltaRGB;
1915                 break;
1916
1917             default:
1918                 wxFAIL_MSG(wxT("hue not specified"));
1919                 break;
1920         }
1921
1922         hue /= 6.0;
1923
1924         if ( hue < 0.0 )
1925             hue += 1.0;
1926
1927         saturation = deltaRGB / maximumRGB;
1928     }
1929
1930     return HSVValue(hue, saturation, value);
1931 }
1932
1933 wxImage::RGBValue wxImage::HSVtoRGB(const HSVValue& hsv)
1934 {
1935     double red, green, blue;
1936
1937     if ( wxIsNullDouble(hsv.saturation) )
1938     {
1939         // Grey
1940         red = hsv.value;
1941         green = hsv.value;
1942         blue = hsv.value;
1943     }
1944     else // not grey
1945     {
1946         double hue = hsv.hue * 6.0;      // sector 0 to 5
1947         int i = (int)floor(hue);
1948         double f = hue - i;          // fractional part of h
1949         double p = hsv.value * (1.0 - hsv.saturation);
1950
1951         switch (i)
1952         {
1953             case 0:
1954                 red = hsv.value;
1955                 green = hsv.value * (1.0 - hsv.saturation * (1.0 - f));
1956                 blue = p;
1957                 break;
1958
1959             case 1:
1960                 red = hsv.value * (1.0 - hsv.saturation * f);
1961                 green = hsv.value;
1962                 blue = p;
1963                 break;
1964
1965             case 2:
1966                 red = p;
1967                 green = hsv.value;
1968                 blue = hsv.value * (1.0 - hsv.saturation * (1.0 - f));
1969                 break;
1970
1971             case 3:
1972                 red = p;
1973                 green = hsv.value * (1.0 - hsv.saturation * f);
1974                 blue = hsv.value;
1975                 break;
1976
1977             case 4:
1978                 red = hsv.value * (1.0 - hsv.saturation * (1.0 - f));
1979                 green = p;
1980                 blue = hsv.value;
1981                 break;
1982
1983             default:    // case 5:
1984                 red = hsv.value;
1985                 green = p;
1986                 blue = hsv.value * (1.0 - hsv.saturation * f);
1987                 break;
1988         }
1989     }
1990
1991     return RGBValue((unsigned char)(red * 255.0),
1992                     (unsigned char)(green * 255.0),
1993                     (unsigned char)(blue * 255.0));
1994 }
1995
1996 /*
1997  * Rotates the hue of each pixel of the image. angle is a double in the range
1998  * -1.0..1.0 where -1.0 is -360 degrees and 1.0 is 360 degrees
1999  */
2000 void wxImage::RotateHue(double angle)
2001 {
2002     unsigned char *srcBytePtr;
2003     unsigned char *dstBytePtr;
2004     unsigned long count;
2005     wxImage::HSVValue hsv;
2006     wxImage::RGBValue rgb;
2007
2008     wxASSERT (angle >= -1.0 && angle <= 1.0);
2009     count = M_IMGDATA->m_width * M_IMGDATA->m_height;
2010     if ( count > 0 && !wxIsNullDouble(angle) )
2011     {
2012         srcBytePtr = M_IMGDATA->m_data;
2013         dstBytePtr = srcBytePtr;
2014         do
2015         {
2016             rgb.red = *srcBytePtr++;
2017             rgb.green = *srcBytePtr++;
2018             rgb.blue = *srcBytePtr++;
2019             hsv = RGBtoHSV(rgb);
2020
2021             hsv.hue = hsv.hue + angle;
2022             if (hsv.hue > 1.0)
2023                 hsv.hue = hsv.hue - 1.0;
2024             else if (hsv.hue < 0.0)
2025                 hsv.hue = hsv.hue + 1.0;
2026
2027             rgb = HSVtoRGB(hsv);
2028             *dstBytePtr++ = rgb.red;
2029             *dstBytePtr++ = rgb.green;
2030             *dstBytePtr++ = rgb.blue;
2031         } while (--count != 0);
2032     }
2033 }
2034
2035 //-----------------------------------------------------------------------------
2036 // wxImageHandler
2037 //-----------------------------------------------------------------------------
2038
2039 IMPLEMENT_ABSTRACT_CLASS(wxImageHandler,wxObject)
2040
2041 #if wxUSE_STREAMS
2042 bool wxImageHandler::LoadFile( wxImage *WXUNUSED(image), wxInputStream& WXUNUSED(stream), bool WXUNUSED(verbose), int WXUNUSED(index) )
2043 {
2044     return false;
2045 }
2046
2047 bool wxImageHandler::SaveFile( wxImage *WXUNUSED(image), wxOutputStream& WXUNUSED(stream), bool WXUNUSED(verbose) )
2048 {
2049     return false;
2050 }
2051
2052 int wxImageHandler::GetImageCount( wxInputStream& WXUNUSED(stream) )
2053 {
2054     return 1;
2055 }
2056
2057 bool wxImageHandler::CanRead( const wxString& name )
2058 {
2059     if (wxFileExists(name))
2060     {
2061         wxFileInputStream stream(name);
2062         return CanRead(stream);
2063     }
2064
2065     wxLogError( _("Can't check image format of file '%s': file does not exist."), name.c_str() );
2066
2067     return false;
2068 }
2069
2070 bool wxImageHandler::CallDoCanRead(wxInputStream& stream)
2071 {
2072     wxFileOffset posOld = stream.TellI();
2073     if ( posOld == wxInvalidOffset )
2074     {
2075         // can't test unseekable stream
2076         return false;
2077     }
2078
2079     bool ok = DoCanRead(stream);
2080
2081     // restore the old position to be able to test other formats and so on
2082     if ( stream.SeekI(posOld) == wxInvalidOffset )
2083     {
2084         wxLogDebug(_T("Failed to rewind the stream in wxImageHandler!"));
2085
2086         // reading would fail anyhow as we're not at the right position
2087         return false;
2088     }
2089
2090     return ok;
2091 }
2092
2093 #endif // wxUSE_STREAMS
2094
2095 // ----------------------------------------------------------------------------
2096 // image histogram stuff
2097 // ----------------------------------------------------------------------------
2098
2099 bool
2100 wxImageHistogram::FindFirstUnusedColour(unsigned char *r,
2101                                         unsigned char *g,
2102                                         unsigned char *b,
2103                                         unsigned char r2,
2104                                         unsigned char b2,
2105                                         unsigned char g2) const
2106 {
2107     unsigned long key = MakeKey(r2, g2, b2);
2108
2109     while ( find(key) != end() )
2110     {
2111         // color already used
2112         r2++;
2113         if ( r2 >= 255 )
2114         {
2115             r2 = 0;
2116             g2++;
2117             if ( g2 >= 255 )
2118             {
2119                 g2 = 0;
2120                 b2++;
2121                 if ( b2 >= 255 )
2122                 {
2123                     wxLogError(_("No unused colour in image.") );
2124                     return false;
2125                 }
2126             }
2127         }
2128
2129         key = MakeKey(r2, g2, b2);
2130     }
2131
2132     if ( r )
2133         *r = r2;
2134     if ( g )
2135         *g = g2;
2136     if ( b )
2137         *b = b2;
2138
2139     return true;
2140 }
2141
2142 bool
2143 wxImage::FindFirstUnusedColour(unsigned char *r,
2144                                unsigned char *g,
2145                                unsigned char *b,
2146                                unsigned char r2,
2147                                unsigned char b2,
2148                                unsigned char g2) const
2149 {
2150     wxImageHistogram histogram;
2151
2152     ComputeHistogram(histogram);
2153
2154     return histogram.FindFirstUnusedColour(r, g, b, r2, g2, b2);
2155 }
2156
2157
2158
2159 // GRG, Dic/99
2160 // Counts and returns the number of different colours. Optionally stops
2161 // when it exceeds 'stopafter' different colours. This is useful, for
2162 // example, to see if the image can be saved as 8-bit (256 colour or
2163 // less, in this case it would be invoked as CountColours(256)). Default
2164 // value for stopafter is -1 (don't care).
2165 //
2166 unsigned long wxImage::CountColours( unsigned long stopafter ) const
2167 {
2168     wxHashTable h;
2169     wxObject dummy;
2170     unsigned char r, g, b;
2171     unsigned char *p;
2172     unsigned long size, nentries, key;
2173
2174     p = GetData();
2175     size = GetWidth() * GetHeight();
2176     nentries = 0;
2177
2178     for (unsigned long j = 0; (j < size) && (nentries <= stopafter) ; j++)
2179     {
2180         r = *(p++);
2181         g = *(p++);
2182         b = *(p++);
2183         key = wxImageHistogram::MakeKey(r, g, b);
2184
2185         if (h.Get(key) == NULL)
2186         {
2187             h.Put(key, &dummy);
2188             nentries++;
2189         }
2190     }
2191
2192     return nentries;
2193 }
2194
2195
2196 unsigned long wxImage::ComputeHistogram( wxImageHistogram &h ) const
2197 {
2198     unsigned char *p = GetData();
2199     unsigned long nentries = 0;
2200
2201     h.clear();
2202
2203     const unsigned long size = GetWidth() * GetHeight();
2204
2205     unsigned char r, g, b;
2206     for ( unsigned long n = 0; n < size; n++ )
2207     {
2208         r = *p++;
2209         g = *p++;
2210         b = *p++;
2211
2212         wxImageHistogramEntry& entry = h[wxImageHistogram::MakeKey(r, g, b)];
2213
2214         if ( entry.value++ == 0 )
2215             entry.index = nentries++;
2216     }
2217
2218     return nentries;
2219 }
2220
2221 /*
2222  * Rotation code by Carlos Moreno
2223  */
2224
2225 // GRG: I've removed wxRotationPoint - we already have wxRealPoint which
2226 //      does exactly the same thing. And I also got rid of wxRotationPixel
2227 //      bacause of potential problems in architectures where alignment
2228 //      is an issue, so I had to rewrite parts of the code.
2229
2230 static const double gs_Epsilon = 1e-10;
2231
2232 static inline int wxCint (double x)
2233 {
2234     return (x > 0) ? (int) (x + 0.5) : (int) (x - 0.5);
2235 }
2236
2237
2238 // Auxiliary function to rotate a point (x,y) with respect to point p0
2239 // make it inline and use a straight return to facilitate optimization
2240 // also, the function receives the sine and cosine of the angle to avoid
2241 // repeating the time-consuming calls to these functions -- sin/cos can
2242 // be computed and stored in the calling function.
2243
2244 inline wxRealPoint rotated_point (const wxRealPoint & p, double cos_angle, double sin_angle, const wxRealPoint & p0)
2245 {
2246     return wxRealPoint (p0.x + (p.x - p0.x) * cos_angle - (p.y - p0.y) * sin_angle,
2247                         p0.y + (p.y - p0.y) * cos_angle + (p.x - p0.x) * sin_angle);
2248 }
2249
2250 inline wxRealPoint rotated_point (double x, double y, double cos_angle, double sin_angle, const wxRealPoint & p0)
2251 {
2252     return rotated_point (wxRealPoint(x,y), cos_angle, sin_angle, p0);
2253 }
2254
2255 wxImage wxImage::Rotate(double angle, const wxPoint & centre_of_rotation, bool interpolating, wxPoint * offset_after_rotation) const
2256 {
2257     int i;
2258     angle = -angle;     // screen coordinates are a mirror image of "real" coordinates
2259
2260     bool has_alpha = HasAlpha();
2261
2262     // Create pointer-based array to accelerate access to wxImage's data
2263     unsigned char ** data = new unsigned char * [GetHeight()];
2264     data[0] = GetData();
2265     for (i = 1; i < GetHeight(); i++)
2266         data[i] = data[i - 1] + (3 * GetWidth());
2267
2268     // Same for alpha channel
2269     unsigned char ** alpha = NULL;
2270     if (has_alpha)
2271     {
2272         alpha = new unsigned char * [GetHeight()];
2273         alpha[0] = GetAlpha();
2274         for (i = 1; i < GetHeight(); i++)
2275             alpha[i] = alpha[i - 1] + GetWidth();
2276     }
2277
2278     // precompute coefficients for rotation formula
2279     // (sine and cosine of the angle)
2280     const double cos_angle = cos(angle);
2281     const double sin_angle = sin(angle);
2282
2283     // Create new Image to store the result
2284     // First, find rectangle that covers the rotated image;  to do that,
2285     // rotate the four corners
2286
2287     const wxRealPoint p0(centre_of_rotation.x, centre_of_rotation.y);
2288
2289     wxRealPoint p1 = rotated_point (0, 0, cos_angle, sin_angle, p0);
2290     wxRealPoint p2 = rotated_point (0, GetHeight(), cos_angle, sin_angle, p0);
2291     wxRealPoint p3 = rotated_point (GetWidth(), 0, cos_angle, sin_angle, p0);
2292     wxRealPoint p4 = rotated_point (GetWidth(), GetHeight(), cos_angle, sin_angle, p0);
2293
2294     int x1a = (int) floor (wxMin (wxMin(p1.x, p2.x), wxMin(p3.x, p4.x)));
2295     int y1a = (int) floor (wxMin (wxMin(p1.y, p2.y), wxMin(p3.y, p4.y)));
2296     int x2a = (int) ceil (wxMax (wxMax(p1.x, p2.x), wxMax(p3.x, p4.x)));
2297     int y2a = (int) ceil (wxMax (wxMax(p1.y, p2.y), wxMax(p3.y, p4.y)));
2298
2299     // Create rotated image
2300     wxImage rotated (x2a - x1a + 1, y2a - y1a + 1, false);
2301     // With alpha channel
2302     if (has_alpha)
2303         rotated.SetAlpha();
2304
2305     if (offset_after_rotation != NULL)
2306     {
2307         *offset_after_rotation = wxPoint (x1a, y1a);
2308     }
2309
2310     // GRG: The rotated (destination) image is always accessed
2311     //      sequentially, so there is no need for a pointer-based
2312     //      array here (and in fact it would be slower).
2313     //
2314     unsigned char * dst = rotated.GetData();
2315
2316     unsigned char * alpha_dst = NULL;
2317     if (has_alpha)
2318         alpha_dst = rotated.GetAlpha();
2319
2320     // GRG: if the original image has a mask, use its RGB values
2321     //      as the blank pixel, else, fall back to default (black).
2322     //
2323     unsigned char blank_r = 0;
2324     unsigned char blank_g = 0;
2325     unsigned char blank_b = 0;
2326
2327     if (HasMask())
2328     {
2329         blank_r = GetMaskRed();
2330         blank_g = GetMaskGreen();
2331         blank_b = GetMaskBlue();
2332         rotated.SetMaskColour( blank_r, blank_g, blank_b );
2333     }
2334
2335     // Now, for each point of the rotated image, find where it came from, by
2336     // performing an inverse rotation (a rotation of -angle) and getting the
2337     // pixel at those coordinates
2338
2339     // GRG: I've taken the (interpolating) test out of the loops, so that
2340     //      it is done only once, instead of repeating it for each pixel.
2341
2342     int x;
2343     if (interpolating)
2344     {
2345         for (int y = 0; y < rotated.GetHeight(); y++)
2346         {
2347             for (x = 0; x < rotated.GetWidth(); x++)
2348             {
2349                 wxRealPoint src = rotated_point (x + x1a, y + y1a, cos_angle, -sin_angle, p0);
2350
2351                 if (-0.25 < src.x && src.x < GetWidth() - 0.75 &&
2352                     -0.25 < src.y && src.y < GetHeight() - 0.75)
2353                 {
2354                     // interpolate using the 4 enclosing grid-points.  Those
2355                     // points can be obtained using floor and ceiling of the
2356                     // exact coordinates of the point
2357                     int x1, y1, x2, y2;
2358
2359                     if (0 < src.x && src.x < GetWidth() - 1)
2360                     {
2361                         x1 = wxCint(floor(src.x));
2362                         x2 = wxCint(ceil(src.x));
2363                     }
2364                     else    // else means that x is near one of the borders (0 or width-1)
2365                     {
2366                         x1 = x2 = wxCint (src.x);
2367                     }
2368
2369                     if (0 < src.y && src.y < GetHeight() - 1)
2370                     {
2371                         y1 = wxCint(floor(src.y));
2372                         y2 = wxCint(ceil(src.y));
2373                     }
2374                     else
2375                     {
2376                         y1 = y2 = wxCint (src.y);
2377                     }
2378
2379                     // get four points and the distances (square of the distance,
2380                     // for efficiency reasons) for the interpolation formula
2381
2382                     // GRG: Do not calculate the points until they are
2383                     //      really needed -- this way we can calculate
2384                     //      just one, instead of four, if d1, d2, d3
2385                     //      or d4 are < gs_Epsilon
2386
2387                     const double d1 = (src.x - x1) * (src.x - x1) + (src.y - y1) * (src.y - y1);
2388                     const double d2 = (src.x - x2) * (src.x - x2) + (src.y - y1) * (src.y - y1);
2389                     const double d3 = (src.x - x2) * (src.x - x2) + (src.y - y2) * (src.y - y2);
2390                     const double d4 = (src.x - x1) * (src.x - x1) + (src.y - y2) * (src.y - y2);
2391
2392                     // Now interpolate as a weighted average of the four surrounding
2393                     // points, where the weights are the distances to each of those points
2394
2395                     // If the point is exactly at one point of the grid of the source
2396                     // image, then don't interpolate -- just assign the pixel
2397
2398                     if (d1 < gs_Epsilon)        // d1,d2,d3,d4 are positive -- no need for abs()
2399                     {
2400                         unsigned char *p = data[y1] + (3 * x1);
2401                         *(dst++) = *(p++);
2402                         *(dst++) = *(p++);
2403                         *(dst++) = *p;
2404
2405                         if (has_alpha)
2406                             *(alpha_dst++) = *(alpha[y1] + x1);
2407                     }
2408                     else if (d2 < gs_Epsilon)
2409                     {
2410                         unsigned char *p = data[y1] + (3 * x2);
2411                         *(dst++) = *(p++);
2412                         *(dst++) = *(p++);
2413                         *(dst++) = *p;
2414
2415                         if (has_alpha)
2416                             *(alpha_dst++) = *(alpha[y1] + x2);
2417                     }
2418                     else if (d3 < gs_Epsilon)
2419                     {
2420                         unsigned char *p = data[y2] + (3 * x2);
2421                         *(dst++) = *(p++);
2422                         *(dst++) = *(p++);
2423                         *(dst++) = *p;
2424
2425                         if (has_alpha)
2426                             *(alpha_dst++) = *(alpha[y2] + x2);
2427                     }
2428                     else if (d4 < gs_Epsilon)
2429                     {
2430                         unsigned char *p = data[y2] + (3 * x1);
2431                         *(dst++) = *(p++);
2432                         *(dst++) = *(p++);
2433                         *(dst++) = *p;
2434
2435                         if (has_alpha)
2436                             *(alpha_dst++) = *(alpha[y2] + x1);
2437                     }
2438                     else
2439                     {
2440                         // weights for the weighted average are proportional to the inverse of the distance
2441                         unsigned char *v1 = data[y1] + (3 * x1);
2442                         unsigned char *v2 = data[y1] + (3 * x2);
2443                         unsigned char *v3 = data[y2] + (3 * x2);
2444                         unsigned char *v4 = data[y2] + (3 * x1);
2445
2446                         const double w1 = 1/d1, w2 = 1/d2, w3 = 1/d3, w4 = 1/d4;
2447
2448                         // GRG: Unrolled.
2449
2450                         *(dst++) = (unsigned char)
2451                             ( (w1 * *(v1++) + w2 * *(v2++) +
2452                                w3 * *(v3++) + w4 * *(v4++)) /
2453                               (w1 + w2 + w3 + w4) );
2454                         *(dst++) = (unsigned char)
2455                             ( (w1 * *(v1++) + w2 * *(v2++) +
2456                                w3 * *(v3++) + w4 * *(v4++)) /
2457                               (w1 + w2 + w3 + w4) );
2458                         *(dst++) = (unsigned char)
2459                             ( (w1 * *v1 + w2 * *v2 +
2460                                w3 * *v3 + w4 * *v4) /
2461                               (w1 + w2 + w3 + w4) );
2462
2463                         if (has_alpha)
2464                         {
2465                             v1 = alpha[y1] + (x1);
2466                             v2 = alpha[y1] + (x2);
2467                             v3 = alpha[y2] + (x2);
2468                             v4 = alpha[y2] + (x1);
2469
2470                             *(alpha_dst++) = (unsigned char)
2471                                 ( (w1 * *v1 + w2 * *v2 +
2472                                    w3 * *v3 + w4 * *v4) /
2473                                   (w1 + w2 + w3 + w4) );
2474                         }
2475                     }
2476                 }
2477                 else
2478                 {
2479                     *(dst++) = blank_r;
2480                     *(dst++) = blank_g;
2481                     *(dst++) = blank_b;
2482
2483                     if (has_alpha)
2484                         *(alpha_dst++) = 0;
2485                 }
2486             }
2487         }
2488     }
2489     else    // not interpolating
2490     {
2491         for (int y = 0; y < rotated.GetHeight(); y++)
2492         {
2493             for (x = 0; x < rotated.GetWidth(); x++)
2494             {
2495                 wxRealPoint src = rotated_point (x + x1a, y + y1a, cos_angle, -sin_angle, p0);
2496
2497                 const int xs = wxCint (src.x);      // wxCint rounds to the
2498                 const int ys = wxCint (src.y);      // closest integer
2499
2500                 if (0 <= xs && xs < GetWidth() &&
2501                     0 <= ys && ys < GetHeight())
2502                 {
2503                     unsigned char *p = data[ys] + (3 * xs);
2504                     *(dst++) = *(p++);
2505                     *(dst++) = *(p++);
2506                     *(dst++) = *p;
2507
2508                     if (has_alpha)
2509                         *(alpha_dst++) = *(alpha[ys] + (xs));
2510                 }
2511                 else
2512                 {
2513                     *(dst++) = blank_r;
2514                     *(dst++) = blank_g;
2515                     *(dst++) = blank_b;
2516
2517                     if (has_alpha)
2518                         *(alpha_dst++) = 255;
2519                 }
2520             }
2521         }
2522     }
2523
2524     delete [] data;
2525
2526     if (has_alpha)
2527         delete [] alpha;
2528
2529     return rotated;
2530 }
2531
2532
2533
2534
2535
2536 // A module to allow wxImage initialization/cleanup
2537 // without calling these functions from app.cpp or from
2538 // the user's application.
2539
2540 class wxImageModule: public wxModule
2541 {
2542 DECLARE_DYNAMIC_CLASS(wxImageModule)
2543 public:
2544     wxImageModule() {}
2545     bool OnInit() { wxImage::InitStandardHandlers(); return true; };
2546     void OnExit() { wxImage::CleanUpHandlers(); };
2547 };
2548
2549 IMPLEMENT_DYNAMIC_CLASS(wxImageModule, wxModule)
2550
2551
2552 #endif // wxUSE_IMAGE