]> git.saurik.com Git - wxWidgets.git/blob - src/common/image.cpp
89f35d5d5743ba4a0360fb514f6ea69f1a134aed
[wxWidgets.git] / 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 #include "wx/image.h"
20
21 #ifndef WX_PRECOMP
22 #include "wx/log.h"
23 #include "wx/hash.h"
24 #include "wx/utils.h"
25 #include "wx/math.h"
26 #include "wx/module.h"
27 #include "wx/palette.h"
28 #include "wx/intl.h"
29 #include "wx/colour.h"
30 #endif
31
32 #include "wx/wfstream.h"
33 #include "wx/xpmdecod.h"
34
35 // For memcpy
36 #include <string.h>
37
38 // make the code compile with either wxFile*Stream or wxFFile*Stream:
39 #define HAS_FILE_STREAMS (wxUSE_STREAMS && (wxUSE_FILE || wxUSE_FFILE))
40
41 #if HAS_FILE_STREAMS
42 #if wxUSE_FFILE
43 typedef wxFFileInputStream wxImageFileInputStream;
44 typedef wxFFileOutputStream wxImageFileOutputStream;
45 #elif wxUSE_FILE
46 typedef wxFileInputStream wxImageFileInputStream;
47 typedef wxFileOutputStream wxImageFileOutputStream;
48 #endif // wxUSE_FILE/wxUSE_FFILE
49 #endif // HAS_FILE_STREAMS
50
51 #if wxUSE_VARIANT
52 IMPLEMENT_VARIANT_OBJECT_EXPORTED_SHALLOWCMP(wxImage,WXDLLEXPORT)
53 #endif
54
55 //-----------------------------------------------------------------------------
56 // global data
57 //-----------------------------------------------------------------------------
58
59 wxList wxImage::sm_handlers;
60 wxImage wxNullImage;
61
62 //-----------------------------------------------------------------------------
63 // wxImageRefData
64 //-----------------------------------------------------------------------------
65
66 class wxImageRefData: public wxObjectRefData
67 {
68 public:
69 wxImageRefData();
70 virtual ~wxImageRefData();
71
72 int m_width;
73 int m_height;
74 wxBitmapType m_type;
75 unsigned char *m_data;
76
77 bool m_hasMask;
78 unsigned char m_maskRed,m_maskGreen,m_maskBlue;
79
80 // alpha channel data, may be NULL for the formats without alpha support
81 unsigned char *m_alpha;
82
83 bool m_ok;
84
85 // if true, m_data is pointer to static data and shouldn't be freed
86 bool m_static;
87
88 // same as m_static but for m_alpha
89 bool m_staticAlpha;
90
91 #if wxUSE_PALETTE
92 wxPalette m_palette;
93 #endif // wxUSE_PALETTE
94
95 wxArrayString m_optionNames;
96 wxArrayString m_optionValues;
97
98 wxDECLARE_NO_COPY_CLASS(wxImageRefData);
99 };
100
101 wxImageRefData::wxImageRefData()
102 {
103 m_width = 0;
104 m_height = 0;
105 m_type = wxBITMAP_TYPE_INVALID;
106 m_data =
107 m_alpha = (unsigned char *) NULL;
108
109 m_maskRed = 0;
110 m_maskGreen = 0;
111 m_maskBlue = 0;
112 m_hasMask = false;
113
114 m_ok = false;
115 m_static =
116 m_staticAlpha = false;
117 }
118
119 wxImageRefData::~wxImageRefData()
120 {
121 if ( !m_static )
122 free( m_data );
123 if ( !m_staticAlpha )
124 free( m_alpha );
125 }
126
127
128 //-----------------------------------------------------------------------------
129 // wxImage
130 //-----------------------------------------------------------------------------
131
132 #define M_IMGDATA static_cast<wxImageRefData*>(m_refData)
133
134 IMPLEMENT_DYNAMIC_CLASS(wxImage, wxObject)
135
136 bool wxImage::Create(const char* const* xpmData)
137 {
138 #if wxUSE_XPM
139 UnRef();
140
141 wxXPMDecoder decoder;
142 (*this) = decoder.ReadData(xpmData);
143 return Ok();
144 #else
145 return false;
146 #endif
147 }
148
149 bool wxImage::Create( int width, int height, bool clear )
150 {
151 UnRef();
152
153 m_refData = new wxImageRefData();
154
155 M_IMGDATA->m_data = (unsigned char *) malloc( width*height*3 );
156 if (!M_IMGDATA->m_data)
157 {
158 UnRef();
159 return false;
160 }
161
162 M_IMGDATA->m_width = width;
163 M_IMGDATA->m_height = height;
164 M_IMGDATA->m_ok = true;
165
166 if (clear)
167 {
168 Clear();
169 }
170
171 return true;
172 }
173
174 bool wxImage::Create( int width, int height, unsigned char* data, bool static_data )
175 {
176 UnRef();
177
178 wxCHECK_MSG( data, false, wxT("NULL data in wxImage::Create") );
179
180 m_refData = new wxImageRefData();
181
182 M_IMGDATA->m_data = data;
183 M_IMGDATA->m_width = width;
184 M_IMGDATA->m_height = height;
185 M_IMGDATA->m_ok = true;
186 M_IMGDATA->m_static = static_data;
187
188 return true;
189 }
190
191 bool wxImage::Create( int width, int height, unsigned char* data, unsigned char* alpha, bool static_data )
192 {
193 UnRef();
194
195 wxCHECK_MSG( data, false, wxT("NULL data in wxImage::Create") );
196
197 m_refData = new wxImageRefData();
198
199 M_IMGDATA->m_data = data;
200 M_IMGDATA->m_alpha = alpha;
201 M_IMGDATA->m_width = width;
202 M_IMGDATA->m_height = height;
203 M_IMGDATA->m_ok = true;
204 M_IMGDATA->m_static = static_data;
205 M_IMGDATA->m_staticAlpha = static_data;
206
207 return true;
208 }
209
210 void wxImage::Destroy()
211 {
212 UnRef();
213 }
214
215 void wxImage::Clear(unsigned char value)
216 {
217 memset(M_IMGDATA->m_data, value, M_IMGDATA->m_width*M_IMGDATA->m_height*3);
218 }
219
220 wxObjectRefData* wxImage::CreateRefData() const
221 {
222 return new wxImageRefData;
223 }
224
225 wxObjectRefData* wxImage::CloneRefData(const wxObjectRefData* that) const
226 {
227 const wxImageRefData* refData = static_cast<const wxImageRefData*>(that);
228 wxCHECK_MSG(refData->m_ok, NULL, wxT("invalid image") );
229
230 wxImageRefData* refData_new = new wxImageRefData;
231 refData_new->m_width = refData->m_width;
232 refData_new->m_height = refData->m_height;
233 refData_new->m_maskRed = refData->m_maskRed;
234 refData_new->m_maskGreen = refData->m_maskGreen;
235 refData_new->m_maskBlue = refData->m_maskBlue;
236 refData_new->m_hasMask = refData->m_hasMask;
237 refData_new->m_ok = true;
238 unsigned size = unsigned(refData->m_width) * unsigned(refData->m_height);
239 if (refData->m_alpha != NULL)
240 {
241 refData_new->m_alpha = (unsigned char*)malloc(size);
242 memcpy(refData_new->m_alpha, refData->m_alpha, size);
243 }
244 size *= 3;
245 refData_new->m_data = (unsigned char*)malloc(size);
246 memcpy(refData_new->m_data, refData->m_data, size);
247 #if wxUSE_PALETTE
248 refData_new->m_palette = refData->m_palette;
249 #endif
250 refData_new->m_optionNames = refData->m_optionNames;
251 refData_new->m_optionValues = refData->m_optionValues;
252 return refData_new;
253 }
254
255 // returns a new image with the same dimensions, alpha, and mask as *this
256 // if on_its_side is true, width and height are swapped
257 wxImage wxImage::MakeEmptyClone(int flags) const
258 {
259 wxImage image;
260
261 wxCHECK_MSG( Ok(), image, wxS("invalid image") );
262
263 long height = M_IMGDATA->m_height;
264 long width = M_IMGDATA->m_width;
265
266 if ( flags & Clone_SwapOrientation )
267 wxSwap( width, height );
268
269 if ( !image.Create( width, height, false ) )
270 {
271 wxFAIL_MSG( wxS("unable to create image") );
272 return image;
273 }
274
275 if ( M_IMGDATA->m_alpha )
276 {
277 image.SetAlpha();
278 wxCHECK2_MSG( image.GetAlpha(), return wxImage(),
279 wxS("unable to create alpha channel") );
280 }
281
282 if ( M_IMGDATA->m_hasMask )
283 {
284 image.SetMaskColour( M_IMGDATA->m_maskRed,
285 M_IMGDATA->m_maskGreen,
286 M_IMGDATA->m_maskBlue );
287 }
288
289 return image;
290 }
291
292 wxImage wxImage::Copy() const
293 {
294 wxImage image;
295
296 wxCHECK_MSG( Ok(), image, wxT("invalid image") );
297
298 image.m_refData = CloneRefData(m_refData);
299
300 return image;
301 }
302
303 wxImage wxImage::ShrinkBy( int xFactor , int yFactor ) const
304 {
305 if( xFactor == 1 && yFactor == 1 )
306 return *this;
307
308 wxImage image;
309
310 wxCHECK_MSG( Ok(), image, wxT("invalid image") );
311
312 // can't scale to/from 0 size
313 wxCHECK_MSG( (xFactor > 0) && (yFactor > 0), image,
314 wxT("invalid new image size") );
315
316 long old_height = M_IMGDATA->m_height,
317 old_width = M_IMGDATA->m_width;
318
319 wxCHECK_MSG( (old_height > 0) && (old_width > 0), image,
320 wxT("invalid old image size") );
321
322 long width = old_width / xFactor ;
323 long height = old_height / yFactor ;
324
325 image.Create( width, height, false );
326
327 char unsigned *data = image.GetData();
328
329 wxCHECK_MSG( data, image, wxT("unable to create image") );
330
331 bool hasMask = false ;
332 unsigned char maskRed = 0;
333 unsigned char maskGreen = 0;
334 unsigned char maskBlue = 0 ;
335
336 const unsigned char *source_data = M_IMGDATA->m_data;
337 unsigned char *target_data = data;
338 const unsigned char *source_alpha = 0 ;
339 unsigned char *target_alpha = 0 ;
340 if (M_IMGDATA->m_hasMask)
341 {
342 hasMask = true ;
343 maskRed = M_IMGDATA->m_maskRed;
344 maskGreen = M_IMGDATA->m_maskGreen;
345 maskBlue =M_IMGDATA->m_maskBlue ;
346
347 image.SetMaskColour( M_IMGDATA->m_maskRed,
348 M_IMGDATA->m_maskGreen,
349 M_IMGDATA->m_maskBlue );
350 }
351 else
352 {
353 source_alpha = M_IMGDATA->m_alpha ;
354 if ( source_alpha )
355 {
356 image.SetAlpha() ;
357 target_alpha = image.GetAlpha() ;
358 }
359 }
360
361 for (long y = 0; y < height; y++)
362 {
363 for (long x = 0; x < width; x++)
364 {
365 unsigned long avgRed = 0 ;
366 unsigned long avgGreen = 0;
367 unsigned long avgBlue = 0;
368 unsigned long avgAlpha = 0 ;
369 unsigned long counter = 0 ;
370 // determine average
371 for ( int y1 = 0 ; y1 < yFactor ; ++y1 )
372 {
373 long y_offset = (y * yFactor + y1) * old_width;
374 for ( int x1 = 0 ; x1 < xFactor ; ++x1 )
375 {
376 const unsigned char *pixel = source_data + 3 * ( y_offset + x * xFactor + x1 ) ;
377 unsigned char red = pixel[0] ;
378 unsigned char green = pixel[1] ;
379 unsigned char blue = pixel[2] ;
380 unsigned char alpha = 255 ;
381 if ( source_alpha )
382 alpha = *(source_alpha + y_offset + x * xFactor + x1) ;
383 if ( !hasMask || red != maskRed || green != maskGreen || blue != maskBlue )
384 {
385 if ( alpha > 0 )
386 {
387 avgRed += red ;
388 avgGreen += green ;
389 avgBlue += blue ;
390 }
391 avgAlpha += alpha ;
392 counter++ ;
393 }
394 }
395 }
396 if ( counter == 0 )
397 {
398 *(target_data++) = M_IMGDATA->m_maskRed ;
399 *(target_data++) = M_IMGDATA->m_maskGreen ;
400 *(target_data++) = M_IMGDATA->m_maskBlue ;
401 }
402 else
403 {
404 if ( source_alpha )
405 *(target_alpha++) = (unsigned char)(avgAlpha / counter ) ;
406 *(target_data++) = (unsigned char)(avgRed / counter);
407 *(target_data++) = (unsigned char)(avgGreen / counter);
408 *(target_data++) = (unsigned char)(avgBlue / counter);
409 }
410 }
411 }
412
413 // In case this is a cursor, make sure the hotspot is scaled accordingly:
414 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_X) )
415 image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X,
416 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_X))/xFactor);
417 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y) )
418 image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y,
419 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_Y))/yFactor);
420
421 return image;
422 }
423
424 wxImage
425 wxImage::Scale( int width, int height, wxImageResizeQuality quality ) const
426 {
427 wxImage image;
428
429 wxCHECK_MSG( Ok(), image, wxT("invalid image") );
430
431 // can't scale to/from 0 size
432 wxCHECK_MSG( (width > 0) && (height > 0), image,
433 wxT("invalid new image size") );
434
435 long old_height = M_IMGDATA->m_height,
436 old_width = M_IMGDATA->m_width;
437 wxCHECK_MSG( (old_height > 0) && (old_width > 0), image,
438 wxT("invalid old image size") );
439
440 // If the image's new width and height are the same as the original, no
441 // need to waste time or CPU cycles
442 if ( old_width == width && old_height == height )
443 return *this;
444
445 // resample the image using either the nearest neighbourhood, bilinear or
446 // bicubic method as specified
447 switch ( quality )
448 {
449 case wxIMAGE_QUALITY_BICUBIC:
450 case wxIMAGE_QUALITY_BILINEAR:
451 // both of these algorithms should be used for up-sampling the
452 // image only, when down-sampling always use box averaging for best
453 // results
454 if ( width < old_width && height < old_height )
455 image = ResampleBox(width, height);
456 else if ( quality == wxIMAGE_QUALITY_BILINEAR )
457 image = ResampleBilinear(width, height);
458 else if ( quality == wxIMAGE_QUALITY_BICUBIC )
459 image = ResampleBicubic(width, height);
460 break;
461
462 case wxIMAGE_QUALITY_NEAREST:
463 if ( old_width % width == 0 && old_width >= width &&
464 old_height % height == 0 && old_height >= height )
465 {
466 return ShrinkBy( old_width / width , old_height / height );
467 }
468
469 image = ResampleNearest(width, height);
470 break;
471 }
472
473 // If the original image has a mask, apply the mask to the new image
474 if (M_IMGDATA->m_hasMask)
475 {
476 image.SetMaskColour( M_IMGDATA->m_maskRed,
477 M_IMGDATA->m_maskGreen,
478 M_IMGDATA->m_maskBlue );
479 }
480
481 // In case this is a cursor, make sure the hotspot is scaled accordingly:
482 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_X) )
483 image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X,
484 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_X)*width)/old_width);
485 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y) )
486 image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y,
487 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_Y)*height)/old_height);
488
489 return image;
490 }
491
492 wxImage wxImage::ResampleNearest(int width, int height) const
493 {
494 wxImage image;
495 image.Create( width, height, false );
496
497 unsigned char *data = image.GetData();
498
499 wxCHECK_MSG( data, image, wxT("unable to create image") );
500
501 const unsigned char *source_data = M_IMGDATA->m_data;
502 unsigned char *target_data = data;
503 const unsigned char *source_alpha = 0 ;
504 unsigned char *target_alpha = 0 ;
505
506 if ( !M_IMGDATA->m_hasMask )
507 {
508 source_alpha = M_IMGDATA->m_alpha ;
509 if ( source_alpha )
510 {
511 image.SetAlpha() ;
512 target_alpha = image.GetAlpha() ;
513 }
514 }
515
516 long old_height = M_IMGDATA->m_height,
517 old_width = M_IMGDATA->m_width;
518 long x_delta = (old_width<<16) / width;
519 long y_delta = (old_height<<16) / height;
520
521 unsigned char* dest_pixel = target_data;
522
523 long y = 0;
524 for ( long j = 0; j < height; j++ )
525 {
526 const unsigned char* src_line = &source_data[(y>>16)*old_width*3];
527 const unsigned char* src_alpha_line = source_alpha ? &source_alpha[(y>>16)*old_width] : 0 ;
528
529 long x = 0;
530 for ( long i = 0; i < width; i++ )
531 {
532 const unsigned char* src_pixel = &src_line[(x>>16)*3];
533 const unsigned char* src_alpha_pixel = source_alpha ? &src_alpha_line[(x>>16)] : 0 ;
534 dest_pixel[0] = src_pixel[0];
535 dest_pixel[1] = src_pixel[1];
536 dest_pixel[2] = src_pixel[2];
537 dest_pixel += 3;
538 if ( source_alpha )
539 *(target_alpha++) = *src_alpha_pixel ;
540 x += x_delta;
541 }
542
543 y += y_delta;
544 }
545
546 return image;
547 }
548
549 wxImage wxImage::ResampleBox(int width, int height) const
550 {
551 // This function implements a simple pre-blur/box averaging method for
552 // downsampling that gives reasonably smooth results To scale the image
553 // down we will need to gather a grid of pixels of the size of the scale
554 // factor in each direction and then do an averaging of the pixels.
555
556 wxImage ret_image(width, height, false);
557
558 const double scale_factor_x = double(M_IMGDATA->m_width) / width;
559 const double scale_factor_y = double(M_IMGDATA->m_height) / height;
560
561 const int scale_factor_x_2 = (int)(scale_factor_x / 2);
562 const int scale_factor_y_2 = (int)(scale_factor_y / 2);
563
564 const unsigned char* src_data = M_IMGDATA->m_data;
565 const unsigned char* src_alpha = M_IMGDATA->m_alpha;
566 unsigned char* dst_data = ret_image.GetData();
567 unsigned char* dst_alpha = NULL;
568
569 if ( src_alpha )
570 {
571 ret_image.SetAlpha();
572 dst_alpha = ret_image.GetAlpha();
573 }
574
575 int averaged_pixels, src_pixel_index;
576 double sum_r, sum_g, sum_b, sum_a;
577
578 for ( int y = 0; y < height; y++ ) // Destination image - Y direction
579 {
580 // Source pixel in the Y direction
581 int src_y = (int)(y * scale_factor_y);
582
583 for ( int x = 0; x < width; x++ ) // Destination image - X direction
584 {
585 // Source pixel in the X direction
586 int src_x = (int)(x * scale_factor_x);
587
588 // Box of pixels to average
589 averaged_pixels = 0;
590 sum_r = sum_g = sum_b = sum_a = 0.0;
591
592 for ( int j = int(src_y - scale_factor_y/2.0 + 1);
593 j <= int(src_y + scale_factor_y_2);
594 j++ )
595 {
596 // We don't care to average pixels that don't exist (edges)
597 if ( j < 0 || j > M_IMGDATA->m_height - 1 )
598 continue;
599
600 for ( int i = int(src_x - scale_factor_x/2.0 + 1);
601 i <= src_x + scale_factor_x_2;
602 i++ )
603 {
604 // Don't average edge pixels
605 if ( i < 0 || i > M_IMGDATA->m_width - 1 )
606 continue;
607
608 // Calculate the actual index in our source pixels
609 src_pixel_index = j * M_IMGDATA->m_width + i;
610
611 sum_r += src_data[src_pixel_index * 3 + 0];
612 sum_g += src_data[src_pixel_index * 3 + 1];
613 sum_b += src_data[src_pixel_index * 3 + 2];
614 if ( src_alpha )
615 sum_a += src_alpha[src_pixel_index];
616
617 averaged_pixels++;
618 }
619 }
620
621 // Calculate the average from the sum and number of averaged pixels
622 dst_data[0] = (unsigned char)(sum_r / averaged_pixels);
623 dst_data[1] = (unsigned char)(sum_g / averaged_pixels);
624 dst_data[2] = (unsigned char)(sum_b / averaged_pixels);
625 dst_data += 3;
626 if ( src_alpha )
627 *dst_alpha++ = (unsigned char)(sum_a / averaged_pixels);
628 }
629 }
630
631 return ret_image;
632 }
633
634 wxImage wxImage::ResampleBilinear(int width, int height) const
635 {
636 // This function implements a Bilinear algorithm for resampling.
637 wxImage ret_image(width, height, false);
638 const unsigned char* src_data = M_IMGDATA->m_data;
639 const unsigned char* src_alpha = M_IMGDATA->m_alpha;
640 unsigned char* dst_data = ret_image.GetData();
641 unsigned char* dst_alpha = NULL;
642
643 if ( src_alpha )
644 {
645 ret_image.SetAlpha();
646 dst_alpha = ret_image.GetAlpha();
647 }
648 double HFactor = double(M_IMGDATA->m_height) / height;
649 double WFactor = double(M_IMGDATA->m_width) / width;
650
651 int srcpixymax = M_IMGDATA->m_height - 1;
652 int srcpixxmax = M_IMGDATA->m_width - 1;
653
654 double srcpixy, srcpixy1, srcpixy2, dy, dy1;
655 double srcpixx, srcpixx1, srcpixx2, dx, dx1;
656
657 // initialize alpha values to avoid g++ warnings about possibly
658 // uninitialized variables
659 double r1, g1, b1, a1 = 0;
660 double r2, g2, b2, a2 = 0;
661
662 for ( int dsty = 0; dsty < height; dsty++ )
663 {
664 // We need to calculate the source pixel to interpolate from - Y-axis
665 srcpixy = double(dsty) * HFactor;
666 srcpixy1 = int(srcpixy);
667 srcpixy2 = ( srcpixy1 == srcpixymax ) ? srcpixy1 : srcpixy1 + 1.0;
668 dy = srcpixy - (int)srcpixy;
669 dy1 = 1.0 - dy;
670
671
672 for ( int dstx = 0; dstx < width; dstx++ )
673 {
674 // X-axis of pixel to interpolate from
675 srcpixx = double(dstx) * WFactor;
676 srcpixx1 = int(srcpixx);
677 srcpixx2 = ( srcpixx1 == srcpixxmax ) ? srcpixx1 : srcpixx1 + 1.0;
678 dx = srcpixx - (int)srcpixx;
679 dx1 = 1.0 - dx;
680
681 int x_offset1 = srcpixx1 < 0.0 ? 0 : srcpixx1 > srcpixxmax ? srcpixxmax : (int)srcpixx1;
682 int x_offset2 = srcpixx2 < 0.0 ? 0 : srcpixx2 > srcpixxmax ? srcpixxmax : (int)srcpixx2;
683 int y_offset1 = srcpixy1 < 0.0 ? 0 : srcpixy1 > srcpixymax ? srcpixymax : (int)srcpixy1;
684 int y_offset2 = srcpixy2 < 0.0 ? 0 : srcpixy2 > srcpixymax ? srcpixymax : (int)srcpixy2;
685
686 int src_pixel_index00 = y_offset1 * M_IMGDATA->m_width + x_offset1;
687 int src_pixel_index01 = y_offset1 * M_IMGDATA->m_width + x_offset2;
688 int src_pixel_index10 = y_offset2 * M_IMGDATA->m_width + x_offset1;
689 int src_pixel_index11 = y_offset2 * M_IMGDATA->m_width + x_offset2;
690
691 // first line
692 r1 = src_data[src_pixel_index00 * 3 + 0] * dx1 + src_data[src_pixel_index01 * 3 + 0] * dx;
693 g1 = src_data[src_pixel_index00 * 3 + 1] * dx1 + src_data[src_pixel_index01 * 3 + 1] * dx;
694 b1 = src_data[src_pixel_index00 * 3 + 2] * dx1 + src_data[src_pixel_index01 * 3 + 2] * dx;
695 if ( src_alpha )
696 a1 = src_alpha[src_pixel_index00] * dx1 + src_alpha[src_pixel_index01] * dx;
697
698 // second line
699 r2 = src_data[src_pixel_index10 * 3 + 0] * dx1 + src_data[src_pixel_index11 * 3 + 0] * dx;
700 g2 = src_data[src_pixel_index10 * 3 + 1] * dx1 + src_data[src_pixel_index11 * 3 + 1] * dx;
701 b2 = src_data[src_pixel_index10 * 3 + 2] * dx1 + src_data[src_pixel_index11 * 3 + 2] * dx;
702 if ( src_alpha )
703 a2 = src_alpha[src_pixel_index10] * dx1 + src_alpha[src_pixel_index11] * dx;
704
705 // result lines
706
707 dst_data[0] = static_cast<unsigned char>(r1 * dy1 + r2 * dy);
708 dst_data[1] = static_cast<unsigned char>(g1 * dy1 + g2 * dy);
709 dst_data[2] = static_cast<unsigned char>(b1 * dy1 + b2 * dy);
710 dst_data += 3;
711
712 if ( src_alpha )
713 *dst_alpha++ = static_cast<unsigned char>(a1 * dy1 + a2 * dy);
714 }
715 }
716
717 return ret_image;
718 }
719
720 // The following two local functions are for the B-spline weighting of the
721 // bicubic sampling algorithm
722 static inline double spline_cube(double value)
723 {
724 return value <= 0.0 ? 0.0 : value * value * value;
725 }
726
727 static inline double spline_weight(double value)
728 {
729 return (spline_cube(value + 2) -
730 4 * spline_cube(value + 1) +
731 6 * spline_cube(value) -
732 4 * spline_cube(value - 1)) / 6;
733 }
734
735 // This is the bicubic resampling algorithm
736 wxImage wxImage::ResampleBicubic(int width, int height) const
737 {
738 // This function implements a Bicubic B-Spline algorithm for resampling.
739 // This method is certainly a little slower than wxImage's default pixel
740 // replication method, however for most reasonably sized images not being
741 // upsampled too much on a fairly average CPU this difference is hardly
742 // noticeable and the results are far more pleasing to look at.
743 //
744 // This particular bicubic algorithm does pixel weighting according to a
745 // B-Spline that basically implements a Gaussian bell-like weighting
746 // kernel. Because of this method the results may appear a bit blurry when
747 // upsampling by large factors. This is basically because a slight
748 // gaussian blur is being performed to get the smooth look of the upsampled
749 // image.
750
751 // Edge pixels: 3-4 possible solutions
752 // - (Wrap/tile) Wrap the image, take the color value from the opposite
753 // side of the image.
754 // - (Mirror) Duplicate edge pixels, so that pixel at coordinate (2, n),
755 // where n is nonpositive, will have the value of (2, 1).
756 // - (Ignore) Simply ignore the edge pixels and apply the kernel only to
757 // pixels which do have all neighbours.
758 // - (Clamp) Choose the nearest pixel along the border. This takes the
759 // border pixels and extends them out to infinity.
760 //
761 // NOTE: below the y_offset and x_offset variables are being set for edge
762 // pixels using the "Mirror" method mentioned above
763
764 wxImage ret_image;
765
766 ret_image.Create(width, height, false);
767
768 const unsigned char* src_data = M_IMGDATA->m_data;
769 const unsigned char* src_alpha = M_IMGDATA->m_alpha;
770 unsigned char* dst_data = ret_image.GetData();
771 unsigned char* dst_alpha = NULL;
772
773 if ( src_alpha )
774 {
775 ret_image.SetAlpha();
776 dst_alpha = ret_image.GetAlpha();
777 }
778
779 for ( int dsty = 0; dsty < height; dsty++ )
780 {
781 // We need to calculate the source pixel to interpolate from - Y-axis
782 double srcpixy = double(dsty * M_IMGDATA->m_height) / height;
783 double dy = srcpixy - (int)srcpixy;
784
785 for ( int dstx = 0; dstx < width; dstx++ )
786 {
787 // X-axis of pixel to interpolate from
788 double srcpixx = double(dstx * M_IMGDATA->m_width) / width;
789 double dx = srcpixx - (int)srcpixx;
790
791 // Sums for each color channel
792 double sum_r = 0, sum_g = 0, sum_b = 0, sum_a = 0;
793
794 // Here we actually determine the RGBA values for the destination pixel
795 for ( int k = -1; k <= 2; k++ )
796 {
797 // Y offset
798 int y_offset = srcpixy + k < 0.0
799 ? 0
800 : srcpixy + k >= M_IMGDATA->m_height
801 ? M_IMGDATA->m_height - 1
802 : (int)(srcpixy + k);
803
804 // Loop across the X axis
805 for ( int i = -1; i <= 2; i++ )
806 {
807 // X offset
808 int x_offset = srcpixx + i < 0.0
809 ? 0
810 : srcpixx + i >= M_IMGDATA->m_width
811 ? M_IMGDATA->m_width - 1
812 : (int)(srcpixx + i);
813
814 // Calculate the exact position where the source data
815 // should be pulled from based on the x_offset and y_offset
816 int src_pixel_index = y_offset*M_IMGDATA->m_width + x_offset;
817
818 // Calculate the weight for the specified pixel according
819 // to the bicubic b-spline kernel we're using for
820 // interpolation
821 double
822 pixel_weight = spline_weight(i - dx)*spline_weight(k - dy);
823
824 // Create a sum of all velues for each color channel
825 // adjusted for the pixel's calculated weight
826 sum_r += src_data[src_pixel_index * 3 + 0] * pixel_weight;
827 sum_g += src_data[src_pixel_index * 3 + 1] * pixel_weight;
828 sum_b += src_data[src_pixel_index * 3 + 2] * pixel_weight;
829 if ( src_alpha )
830 sum_a += src_alpha[src_pixel_index] * pixel_weight;
831 }
832 }
833
834 // Put the data into the destination image. The summed values are
835 // of double data type and are rounded here for accuracy
836 dst_data[0] = (unsigned char)(sum_r + 0.5);
837 dst_data[1] = (unsigned char)(sum_g + 0.5);
838 dst_data[2] = (unsigned char)(sum_b + 0.5);
839 dst_data += 3;
840
841 if ( src_alpha )
842 *dst_alpha++ = (unsigned char)sum_a;
843 }
844 }
845
846 return ret_image;
847 }
848
849 // Blur in the horizontal direction
850 wxImage wxImage::BlurHorizontal(int blurRadius) const
851 {
852 wxImage ret_image(MakeEmptyClone());
853
854 wxCHECK( ret_image.Ok(), ret_image );
855
856 const unsigned char* src_data = M_IMGDATA->m_data;
857 unsigned char* dst_data = ret_image.GetData();
858 const unsigned char* src_alpha = M_IMGDATA->m_alpha;
859 unsigned char* dst_alpha = ret_image.GetAlpha();
860
861 // number of pixels we average over
862 const int blurArea = blurRadius*2 + 1;
863
864 // Horizontal blurring algorithm - average all pixels in the specified blur
865 // radius in the X or horizontal direction
866 for ( int y = 0; y < M_IMGDATA->m_height; y++ )
867 {
868 // Variables used in the blurring algorithm
869 long sum_r = 0,
870 sum_g = 0,
871 sum_b = 0,
872 sum_a = 0;
873
874 long pixel_idx;
875 const unsigned char *src;
876 unsigned char *dst;
877
878 // Calculate the average of all pixels in the blur radius for the first
879 // pixel of the row
880 for ( int kernel_x = -blurRadius; kernel_x <= blurRadius; kernel_x++ )
881 {
882 // To deal with the pixels at the start of a row so it's not
883 // grabbing GOK values from memory at negative indices of the
884 // image's data or grabbing from the previous row
885 if ( kernel_x < 0 )
886 pixel_idx = y * M_IMGDATA->m_width;
887 else
888 pixel_idx = kernel_x + y * M_IMGDATA->m_width;
889
890 src = src_data + pixel_idx*3;
891 sum_r += src[0];
892 sum_g += src[1];
893 sum_b += src[2];
894 if ( src_alpha )
895 sum_a += src_alpha[pixel_idx];
896 }
897
898 dst = dst_data + y * M_IMGDATA->m_width*3;
899 dst[0] = (unsigned char)(sum_r / blurArea);
900 dst[1] = (unsigned char)(sum_g / blurArea);
901 dst[2] = (unsigned char)(sum_b / blurArea);
902 if ( src_alpha )
903 dst_alpha[y * M_IMGDATA->m_width] = (unsigned char)(sum_a / blurArea);
904
905 // Now average the values of the rest of the pixels by just moving the
906 // blur radius box along the row
907 for ( int x = 1; x < M_IMGDATA->m_width; x++ )
908 {
909 // Take care of edge pixels on the left edge by essentially
910 // duplicating the edge pixel
911 if ( x - blurRadius - 1 < 0 )
912 pixel_idx = y * M_IMGDATA->m_width;
913 else
914 pixel_idx = (x - blurRadius - 1) + y * M_IMGDATA->m_width;
915
916 // Subtract the value of the pixel at the left side of the blur
917 // radius box
918 src = src_data + pixel_idx*3;
919 sum_r -= src[0];
920 sum_g -= src[1];
921 sum_b -= src[2];
922 if ( src_alpha )
923 sum_a -= src_alpha[pixel_idx];
924
925 // Take care of edge pixels on the right edge
926 if ( x + blurRadius > M_IMGDATA->m_width - 1 )
927 pixel_idx = M_IMGDATA->m_width - 1 + y * M_IMGDATA->m_width;
928 else
929 pixel_idx = x + blurRadius + y * M_IMGDATA->m_width;
930
931 // Add the value of the pixel being added to the end of our box
932 src = src_data + pixel_idx*3;
933 sum_r += src[0];
934 sum_g += src[1];
935 sum_b += src[2];
936 if ( src_alpha )
937 sum_a += src_alpha[pixel_idx];
938
939 // Save off the averaged data
940 dst = dst_data + x*3 + y*M_IMGDATA->m_width*3;
941 dst[0] = (unsigned char)(sum_r / blurArea);
942 dst[1] = (unsigned char)(sum_g / blurArea);
943 dst[2] = (unsigned char)(sum_b / blurArea);
944 if ( src_alpha )
945 dst_alpha[x + y * M_IMGDATA->m_width] = (unsigned char)(sum_a / blurArea);
946 }
947 }
948
949 return ret_image;
950 }
951
952 // Blur in the vertical direction
953 wxImage wxImage::BlurVertical(int blurRadius) const
954 {
955 wxImage ret_image(MakeEmptyClone());
956
957 wxCHECK( ret_image.Ok(), ret_image );
958
959 const unsigned char* src_data = M_IMGDATA->m_data;
960 unsigned char* dst_data = ret_image.GetData();
961 const unsigned char* src_alpha = M_IMGDATA->m_alpha;
962 unsigned char* dst_alpha = ret_image.GetAlpha();
963
964 // number of pixels we average over
965 const int blurArea = blurRadius*2 + 1;
966
967 // Vertical blurring algorithm - same as horizontal but switched the
968 // opposite direction
969 for ( int x = 0; x < M_IMGDATA->m_width; x++ )
970 {
971 // Variables used in the blurring algorithm
972 long sum_r = 0,
973 sum_g = 0,
974 sum_b = 0,
975 sum_a = 0;
976
977 long pixel_idx;
978 const unsigned char *src;
979 unsigned char *dst;
980
981 // Calculate the average of all pixels in our blur radius box for the
982 // first pixel of the column
983 for ( int kernel_y = -blurRadius; kernel_y <= blurRadius; kernel_y++ )
984 {
985 // To deal with the pixels at the start of a column so it's not
986 // grabbing GOK values from memory at negative indices of the
987 // image's data or grabbing from the previous column
988 if ( kernel_y < 0 )
989 pixel_idx = x;
990 else
991 pixel_idx = x + kernel_y * M_IMGDATA->m_width;
992
993 src = src_data + pixel_idx*3;
994 sum_r += src[0];
995 sum_g += src[1];
996 sum_b += src[2];
997 if ( src_alpha )
998 sum_a += src_alpha[pixel_idx];
999 }
1000
1001 dst = dst_data + x*3;
1002 dst[0] = (unsigned char)(sum_r / blurArea);
1003 dst[1] = (unsigned char)(sum_g / blurArea);
1004 dst[2] = (unsigned char)(sum_b / blurArea);
1005 if ( src_alpha )
1006 dst_alpha[x] = (unsigned char)(sum_a / blurArea);
1007
1008 // Now average the values of the rest of the pixels by just moving the
1009 // box along the column from top to bottom
1010 for ( int y = 1; y < M_IMGDATA->m_height; y++ )
1011 {
1012 // Take care of pixels that would be beyond the top edge by
1013 // duplicating the top edge pixel for the column
1014 if ( y - blurRadius - 1 < 0 )
1015 pixel_idx = x;
1016 else
1017 pixel_idx = x + (y - blurRadius - 1) * M_IMGDATA->m_width;
1018
1019 // Subtract the value of the pixel at the top of our blur radius box
1020 src = src_data + pixel_idx*3;
1021 sum_r -= src[0];
1022 sum_g -= src[1];
1023 sum_b -= src[2];
1024 if ( src_alpha )
1025 sum_a -= src_alpha[pixel_idx];
1026
1027 // Take care of the pixels that would be beyond the bottom edge of
1028 // the image similar to the top edge
1029 if ( y + blurRadius > M_IMGDATA->m_height - 1 )
1030 pixel_idx = x + (M_IMGDATA->m_height - 1) * M_IMGDATA->m_width;
1031 else
1032 pixel_idx = x + (blurRadius + y) * M_IMGDATA->m_width;
1033
1034 // Add the value of the pixel being added to the end of our box
1035 src = src_data + pixel_idx*3;
1036 sum_r += src[0];
1037 sum_g += src[1];
1038 sum_b += src[2];
1039 if ( src_alpha )
1040 sum_a += src_alpha[pixel_idx];
1041
1042 // Save off the averaged data
1043 dst = dst_data + (x + y * M_IMGDATA->m_width) * 3;
1044 dst[0] = (unsigned char)(sum_r / blurArea);
1045 dst[1] = (unsigned char)(sum_g / blurArea);
1046 dst[2] = (unsigned char)(sum_b / blurArea);
1047 if ( src_alpha )
1048 dst_alpha[x + y * M_IMGDATA->m_width] = (unsigned char)(sum_a / blurArea);
1049 }
1050 }
1051
1052 return ret_image;
1053 }
1054
1055 // The new blur function
1056 wxImage wxImage::Blur(int blurRadius) const
1057 {
1058 wxImage ret_image;
1059 ret_image.Create(M_IMGDATA->m_width, M_IMGDATA->m_height, false);
1060
1061 // Blur the image in each direction
1062 ret_image = BlurHorizontal(blurRadius);
1063 ret_image = ret_image.BlurVertical(blurRadius);
1064
1065 return ret_image;
1066 }
1067
1068 wxImage wxImage::Rotate90( bool clockwise ) const
1069 {
1070 wxImage image(MakeEmptyClone(Clone_SwapOrientation));
1071
1072 wxCHECK( image.Ok(), image );
1073
1074 long height = M_IMGDATA->m_height;
1075 long width = M_IMGDATA->m_width;
1076
1077 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_X) )
1078 {
1079 int hot_x = GetOptionInt( wxIMAGE_OPTION_CUR_HOTSPOT_X );
1080 image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y,
1081 clockwise ? hot_x : width - 1 - hot_x);
1082 }
1083
1084 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y) )
1085 {
1086 int hot_y = GetOptionInt( wxIMAGE_OPTION_CUR_HOTSPOT_Y );
1087 image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X,
1088 clockwise ? height - 1 - hot_y : hot_y);
1089 }
1090
1091 unsigned char *data = image.GetData();
1092 const unsigned char *source_data = M_IMGDATA->m_data;
1093 unsigned char *target_data;
1094 unsigned char *alpha_data = image.GetAlpha();
1095 const unsigned char *source_alpha = M_IMGDATA->m_alpha;
1096 unsigned char *target_alpha = 0 ;
1097
1098 for (long j = 0; j < height; j++)
1099 {
1100 for (long i = 0; i < width; i++)
1101 {
1102 if (clockwise)
1103 {
1104 target_data = data + (((i+1)*height) - j - 1)*3;
1105 if (source_alpha)
1106 target_alpha = alpha_data + (((i+1)*height) - j - 1);
1107 }
1108 else
1109 {
1110 target_data = data + ((height*(width-1)) + j - (i*height))*3;
1111 if (source_alpha)
1112 target_alpha = alpha_data + ((height*(width-1)) + j - (i*height));
1113 }
1114 memcpy( target_data, source_data, 3 );
1115 source_data += 3;
1116
1117 if (source_alpha)
1118 {
1119 memcpy( target_alpha, source_alpha, 1 );
1120 source_alpha += 1;
1121 }
1122 }
1123 }
1124
1125 return image;
1126 }
1127
1128 wxImage wxImage::Rotate180() const
1129 {
1130 wxImage image(MakeEmptyClone());
1131
1132 wxCHECK( image.Ok(), image );
1133
1134 long height = M_IMGDATA->m_height;
1135 long width = M_IMGDATA->m_width;
1136
1137 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_X) )
1138 {
1139 image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X,
1140 width - 1 - GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_X));
1141 }
1142
1143 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y) )
1144 {
1145 image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y,
1146 height - 1 - GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_Y));
1147 }
1148
1149 unsigned char *data = image.GetData();
1150 unsigned char *alpha = image.GetAlpha();
1151 const unsigned char *source_data = M_IMGDATA->m_data;
1152 unsigned char *target_data = data + width * height * 3;
1153
1154 for (long j = 0; j < height; j++)
1155 {
1156 for (long i = 0; i < width; i++)
1157 {
1158 target_data -= 3;
1159 memcpy( target_data, source_data, 3 );
1160 source_data += 3;
1161 }
1162 }
1163
1164 if ( alpha )
1165 {
1166 const unsigned char *src_alpha = M_IMGDATA->m_alpha;
1167 unsigned char *dest_alpha = alpha + width * height;
1168
1169 for (long j = 0; j < height; ++j)
1170 {
1171 for (long i = 0; i < width; ++i)
1172 {
1173 *(--dest_alpha) = *(src_alpha++);
1174 }
1175 }
1176 }
1177
1178 return image;
1179 }
1180
1181 wxImage wxImage::Mirror( bool horizontally ) const
1182 {
1183 wxImage image(MakeEmptyClone());
1184
1185 wxCHECK( image.Ok(), image );
1186
1187 long height = M_IMGDATA->m_height;
1188 long width = M_IMGDATA->m_width;
1189
1190 unsigned char *data = image.GetData();
1191 unsigned char *alpha = image.GetAlpha();
1192 const unsigned char *source_data = M_IMGDATA->m_data;
1193 unsigned char *target_data;
1194
1195 if (horizontally)
1196 {
1197 for (long j = 0; j < height; j++)
1198 {
1199 data += width*3;
1200 target_data = data-3;
1201 for (long i = 0; i < width; i++)
1202 {
1203 memcpy( target_data, source_data, 3 );
1204 source_data += 3;
1205 target_data -= 3;
1206 }
1207 }
1208
1209 if (alpha != NULL)
1210 {
1211 // src_alpha starts at the first pixel and increases by 1 after each step
1212 // (a step here is the copy of the alpha value of one pixel)
1213 const unsigned char *src_alpha = M_IMGDATA->m_alpha;
1214 // dest_alpha starts just beyond the first line, decreases before each step,
1215 // and after each line is finished, increases by 2 widths (skipping the line
1216 // just copied and the line that will be copied next)
1217 unsigned char *dest_alpha = alpha + width;
1218
1219 for (long jj = 0; jj < height; ++jj)
1220 {
1221 for (long i = 0; i < width; ++i) {
1222 *(--dest_alpha) = *(src_alpha++); // copy one pixel
1223 }
1224 dest_alpha += 2 * width; // advance beyond the end of the next line
1225 }
1226 }
1227 }
1228 else
1229 {
1230 for (long i = 0; i < height; i++)
1231 {
1232 target_data = data + 3*width*(height-1-i);
1233 memcpy( target_data, source_data, (size_t)3*width );
1234 source_data += 3*width;
1235 }
1236
1237 if ( alpha )
1238 {
1239 // src_alpha starts at the first pixel and increases by 1 width after each step
1240 // (a step here is the copy of the alpha channel of an entire line)
1241 const unsigned char *src_alpha = M_IMGDATA->m_alpha;
1242 // dest_alpha starts just beyond the last line (beyond the whole image)
1243 // and decreases by 1 width before each step
1244 unsigned char *dest_alpha = alpha + width * height;
1245
1246 for (long jj = 0; jj < height; ++jj)
1247 {
1248 dest_alpha -= width;
1249 memcpy( dest_alpha, src_alpha, (size_t)width );
1250 src_alpha += width;
1251 }
1252 }
1253 }
1254
1255 return image;
1256 }
1257
1258 wxImage wxImage::GetSubImage( const wxRect &rect ) const
1259 {
1260 wxImage image;
1261
1262 wxCHECK_MSG( Ok(), image, wxT("invalid image") );
1263
1264 wxCHECK_MSG( (rect.GetLeft()>=0) && (rect.GetTop()>=0) &&
1265 (rect.GetRight()<=GetWidth()) && (rect.GetBottom()<=GetHeight()),
1266 image, wxT("invalid subimage size") );
1267
1268 const int subwidth = rect.GetWidth();
1269 const int subheight = rect.GetHeight();
1270
1271 image.Create( subwidth, subheight, false );
1272
1273 const unsigned char *src_data = GetData();
1274 const unsigned char *src_alpha = M_IMGDATA->m_alpha;
1275 unsigned char *subdata = image.GetData();
1276 unsigned char *subalpha = NULL;
1277
1278 wxCHECK_MSG( subdata, image, wxT("unable to create image") );
1279
1280 if ( src_alpha ) {
1281 image.SetAlpha();
1282 subalpha = image.GetAlpha();
1283 wxCHECK_MSG( subalpha, image, wxT("unable to create alpha channel"));
1284 }
1285
1286 if (M_IMGDATA->m_hasMask)
1287 image.SetMaskColour( M_IMGDATA->m_maskRed, M_IMGDATA->m_maskGreen, M_IMGDATA->m_maskBlue );
1288
1289 const int width = GetWidth();
1290 const int pixsoff = rect.GetLeft() + width * rect.GetTop();
1291
1292 src_data += 3 * pixsoff;
1293 src_alpha += pixsoff; // won't be used if was NULL, so this is ok
1294
1295 for (long j = 0; j < subheight; ++j)
1296 {
1297 memcpy( subdata, src_data, 3 * subwidth );
1298 subdata += 3 * subwidth;
1299 src_data += 3 * width;
1300 if (subalpha != NULL) {
1301 memcpy( subalpha, src_alpha, subwidth );
1302 subalpha += subwidth;
1303 src_alpha += width;
1304 }
1305 }
1306
1307 return image;
1308 }
1309
1310 wxImage wxImage::Size( const wxSize& size, const wxPoint& pos,
1311 int r_, int g_, int b_ ) const
1312 {
1313 wxImage image;
1314
1315 wxCHECK_MSG( Ok(), image, wxT("invalid image") );
1316 wxCHECK_MSG( (size.GetWidth() > 0) && (size.GetHeight() > 0), image, wxT("invalid size") );
1317
1318 int width = GetWidth(), height = GetHeight();
1319 image.Create(size.GetWidth(), size.GetHeight(), false);
1320
1321 unsigned char r = (unsigned char)r_;
1322 unsigned char g = (unsigned char)g_;
1323 unsigned char b = (unsigned char)b_;
1324 if ((r_ == -1) && (g_ == -1) && (b_ == -1))
1325 {
1326 GetOrFindMaskColour( &r, &g, &b );
1327 image.SetMaskColour(r, g, b);
1328 }
1329
1330 image.SetRGB(wxRect(), r, g, b);
1331
1332 // we have two coordinate systems:
1333 // source: starting at 0,0 of source image
1334 // destination starting at 0,0 of destination image
1335 // Documentation says:
1336 // "The image is pasted into a new image [...] at the position pos relative
1337 // to the upper left of the new image." this means the transition rule is:
1338 // "dest coord" = "source coord" + pos;
1339
1340 // calculate the intersection using source coordinates:
1341 wxRect srcRect(0, 0, width, height);
1342 wxRect dstRect(-pos, size);
1343
1344 srcRect.Intersect(dstRect);
1345
1346 if (!srcRect.IsEmpty())
1347 {
1348 // insertion point is needed in destination coordinates.
1349 // NB: it is not always "pos"!
1350 wxPoint ptInsert = srcRect.GetTopLeft() + pos;
1351
1352 if ((srcRect.GetWidth() == width) && (srcRect.GetHeight() == height))
1353 image.Paste(*this, ptInsert.x, ptInsert.y);
1354 else
1355 image.Paste(GetSubImage(srcRect), ptInsert.x, ptInsert.y);
1356 }
1357
1358 return image;
1359 }
1360
1361 void wxImage::Paste( const wxImage &image, int x, int y )
1362 {
1363 wxCHECK_RET( Ok(), wxT("invalid image") );
1364 wxCHECK_RET( image.Ok(), wxT("invalid image") );
1365
1366 AllocExclusive();
1367
1368 int xx = 0;
1369 int yy = 0;
1370 int width = image.GetWidth();
1371 int height = image.GetHeight();
1372
1373 if (x < 0)
1374 {
1375 xx = -x;
1376 width += x;
1377 }
1378 if (y < 0)
1379 {
1380 yy = -y;
1381 height += y;
1382 }
1383
1384 if ((x+xx)+width > M_IMGDATA->m_width)
1385 width = M_IMGDATA->m_width - (x+xx);
1386 if ((y+yy)+height > M_IMGDATA->m_height)
1387 height = M_IMGDATA->m_height - (y+yy);
1388
1389 if (width < 1) return;
1390 if (height < 1) return;
1391
1392 if ((!HasMask() && !image.HasMask()) ||
1393 (HasMask() && !image.HasMask()) ||
1394 ((HasMask() && image.HasMask() &&
1395 (GetMaskRed()==image.GetMaskRed()) &&
1396 (GetMaskGreen()==image.GetMaskGreen()) &&
1397 (GetMaskBlue()==image.GetMaskBlue()))))
1398 {
1399 const unsigned char* source_data = image.GetData() + 3*(xx + yy*image.GetWidth());
1400 int source_step = image.GetWidth()*3;
1401
1402 unsigned char* target_data = GetData() + 3*((x+xx) + (y+yy)*M_IMGDATA->m_width);
1403 int target_step = M_IMGDATA->m_width*3;
1404 for (int j = 0; j < height; j++)
1405 {
1406 memcpy( target_data, source_data, width*3 );
1407 source_data += source_step;
1408 target_data += target_step;
1409 }
1410 }
1411
1412 // Copy over the alpha channel from the original image
1413 if ( image.HasAlpha() )
1414 {
1415 if ( !HasAlpha() )
1416 InitAlpha();
1417
1418 const unsigned char* source_data = image.GetAlpha() + xx + yy*image.GetWidth();
1419 int source_step = image.GetWidth();
1420
1421 unsigned char* target_data = GetAlpha() + (x+xx) + (y+yy)*M_IMGDATA->m_width;
1422 int target_step = M_IMGDATA->m_width;
1423
1424 for (int j = 0; j < height; j++,
1425 source_data += source_step,
1426 target_data += target_step)
1427 {
1428 memcpy( target_data, source_data, width );
1429 }
1430 }
1431
1432 if (!HasMask() && image.HasMask())
1433 {
1434 unsigned char r = image.GetMaskRed();
1435 unsigned char g = image.GetMaskGreen();
1436 unsigned char b = image.GetMaskBlue();
1437
1438 const unsigned char* source_data = image.GetData() + 3*(xx + yy*image.GetWidth());
1439 int source_step = image.GetWidth()*3;
1440
1441 unsigned char* target_data = GetData() + 3*((x+xx) + (y+yy)*M_IMGDATA->m_width);
1442 int target_step = M_IMGDATA->m_width*3;
1443
1444 for (int j = 0; j < height; j++)
1445 {
1446 for (int i = 0; i < width*3; i+=3)
1447 {
1448 if ((source_data[i] != r) ||
1449 (source_data[i+1] != g) ||
1450 (source_data[i+2] != b))
1451 {
1452 memcpy( target_data+i, source_data+i, 3 );
1453 }
1454 }
1455 source_data += source_step;
1456 target_data += target_step;
1457 }
1458 }
1459 }
1460
1461 void wxImage::Replace( unsigned char r1, unsigned char g1, unsigned char b1,
1462 unsigned char r2, unsigned char g2, unsigned char b2 )
1463 {
1464 wxCHECK_RET( Ok(), wxT("invalid image") );
1465
1466 AllocExclusive();
1467
1468 unsigned char *data = GetData();
1469
1470 const int w = GetWidth();
1471 const int h = GetHeight();
1472
1473 for (int j = 0; j < h; j++)
1474 for (int i = 0; i < w; i++)
1475 {
1476 if ((data[0] == r1) && (data[1] == g1) && (data[2] == b1))
1477 {
1478 data[0] = r2;
1479 data[1] = g2;
1480 data[2] = b2;
1481 }
1482 data += 3;
1483 }
1484 }
1485
1486 wxImage wxImage::ConvertToGreyscale(void) const
1487 {
1488 return ConvertToGreyscale(0.299, 0.587, 0.114);
1489 }
1490
1491 wxImage wxImage::ConvertToGreyscale(double weight_r, double weight_g, double weight_b) const
1492 {
1493 wxImage image(MakeEmptyClone());
1494
1495 wxCHECK( image.Ok(), image );
1496
1497 const unsigned char *src = M_IMGDATA->m_data;
1498 unsigned char *dest = image.GetData();
1499
1500 const bool hasMask = M_IMGDATA->m_hasMask;
1501 const unsigned char maskRed = M_IMGDATA->m_maskRed;
1502 const unsigned char maskGreen = M_IMGDATA->m_maskGreen;
1503 const unsigned char maskBlue = M_IMGDATA->m_maskBlue;
1504
1505 const long size = M_IMGDATA->m_width * M_IMGDATA->m_height;
1506 for ( long i = 0; i < size; i++, src += 3, dest += 3 )
1507 {
1508 memcpy(dest, src, 3);
1509 // only modify non-masked pixels
1510 if ( !hasMask || src[0] != maskRed || src[1] != maskGreen || src[2] != maskBlue )
1511 {
1512 wxColour::MakeGrey(dest + 0, dest + 1, dest + 2, weight_r, weight_g, weight_b);
1513 }
1514 }
1515
1516 // copy the alpha channel, if any
1517 if ( image.HasAlpha() )
1518 {
1519 memcpy( image.GetAlpha(), GetAlpha(), GetWidth() * GetHeight() );
1520 }
1521
1522 return image;
1523 }
1524
1525 wxImage wxImage::ConvertToMono( unsigned char r, unsigned char g, unsigned char b ) const
1526 {
1527 wxImage image;
1528
1529 wxCHECK_MSG( Ok(), image, wxT("invalid image") );
1530
1531 image.Create( M_IMGDATA->m_width, M_IMGDATA->m_height, false );
1532
1533 unsigned char *data = image.GetData();
1534
1535 wxCHECK_MSG( data, image, wxT("unable to create image") );
1536
1537 if (M_IMGDATA->m_hasMask)
1538 {
1539 if (M_IMGDATA->m_maskRed == r && M_IMGDATA->m_maskGreen == g &&
1540 M_IMGDATA->m_maskBlue == b)
1541 image.SetMaskColour( 255, 255, 255 );
1542 else
1543 image.SetMaskColour( 0, 0, 0 );
1544 }
1545
1546 long size = M_IMGDATA->m_height * M_IMGDATA->m_width;
1547
1548 unsigned char *srcd = M_IMGDATA->m_data;
1549 unsigned char *tard = image.GetData();
1550
1551 for ( long i = 0; i < size; i++, srcd += 3, tard += 3 )
1552 {
1553 bool on = (srcd[0] == r) && (srcd[1] == g) && (srcd[2] == b);
1554 wxColourBase::MakeMono(tard + 0, tard + 1, tard + 2, on);
1555 }
1556
1557 return image;
1558 }
1559
1560 wxImage wxImage::ConvertToDisabled(unsigned char brightness) const
1561 {
1562 wxImage image = *this;
1563
1564 unsigned char mr = image.GetMaskRed();
1565 unsigned char mg = image.GetMaskGreen();
1566 unsigned char mb = image.GetMaskBlue();
1567
1568 int width = image.GetWidth();
1569 int height = image.GetHeight();
1570 bool has_mask = image.HasMask();
1571
1572 for (int y = height-1; y >= 0; --y)
1573 {
1574 for (int x = width-1; x >= 0; --x)
1575 {
1576 unsigned char* data = image.GetData() + (y*(width*3))+(x*3);
1577 unsigned char* r = data;
1578 unsigned char* g = data+1;
1579 unsigned char* b = data+2;
1580
1581 if (has_mask && (*r == mr) && (*g == mg) && (*b == mb))
1582 continue;
1583
1584 wxColour::MakeDisabled(r, g, b, brightness);
1585 }
1586 }
1587 return image;
1588 }
1589
1590 int wxImage::GetWidth() const
1591 {
1592 wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1593
1594 return M_IMGDATA->m_width;
1595 }
1596
1597 int wxImage::GetHeight() const
1598 {
1599 wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1600
1601 return M_IMGDATA->m_height;
1602 }
1603
1604 wxBitmapType wxImage::GetType() const
1605 {
1606 wxCHECK_MSG( IsOk(), wxBITMAP_TYPE_INVALID, wxT("invalid image") );
1607
1608 return M_IMGDATA->m_type;
1609 }
1610
1611 void wxImage::SetType(wxBitmapType type)
1612 {
1613 wxCHECK_RET( IsOk(), "must create the image before setting its type");
1614
1615 // type can be wxBITMAP_TYPE_INVALID to reset the image type to default
1616 wxASSERT_MSG( type != wxBITMAP_TYPE_MAX, "invalid bitmap type" );
1617
1618 M_IMGDATA->m_type = type;
1619 }
1620
1621 long wxImage::XYToIndex(int x, int y) const
1622 {
1623 if ( Ok() &&
1624 x >= 0 && y >= 0 &&
1625 x < M_IMGDATA->m_width && y < M_IMGDATA->m_height )
1626 {
1627 return y*M_IMGDATA->m_width + x;
1628 }
1629
1630 return -1;
1631 }
1632
1633 void wxImage::SetRGB( int x, int y, unsigned char r, unsigned char g, unsigned char b )
1634 {
1635 long pos = XYToIndex(x, y);
1636 wxCHECK_RET( pos != -1, wxT("invalid image coordinates") );
1637
1638 AllocExclusive();
1639
1640 pos *= 3;
1641
1642 M_IMGDATA->m_data[ pos ] = r;
1643 M_IMGDATA->m_data[ pos+1 ] = g;
1644 M_IMGDATA->m_data[ pos+2 ] = b;
1645 }
1646
1647 void wxImage::SetRGB( const wxRect& rect_, unsigned char r, unsigned char g, unsigned char b )
1648 {
1649 wxCHECK_RET( Ok(), wxT("invalid image") );
1650
1651 AllocExclusive();
1652
1653 wxRect rect(rect_);
1654 wxRect imageRect(0, 0, GetWidth(), GetHeight());
1655 if ( rect == wxRect() )
1656 {
1657 rect = imageRect;
1658 }
1659 else
1660 {
1661 wxCHECK_RET( imageRect.Contains(rect.GetTopLeft()) &&
1662 imageRect.Contains(rect.GetBottomRight()),
1663 wxT("invalid bounding rectangle") );
1664 }
1665
1666 int x1 = rect.GetLeft(),
1667 y1 = rect.GetTop(),
1668 x2 = rect.GetRight() + 1,
1669 y2 = rect.GetBottom() + 1;
1670
1671 unsigned char *data wxDUMMY_INITIALIZE(NULL);
1672 int x, y, width = GetWidth();
1673 for (y = y1; y < y2; y++)
1674 {
1675 data = M_IMGDATA->m_data + (y*width + x1)*3;
1676 for (x = x1; x < x2; x++)
1677 {
1678 *data++ = r;
1679 *data++ = g;
1680 *data++ = b;
1681 }
1682 }
1683 }
1684
1685 unsigned char wxImage::GetRed( int x, int y ) const
1686 {
1687 long pos = XYToIndex(x, y);
1688 wxCHECK_MSG( pos != -1, 0, wxT("invalid image coordinates") );
1689
1690 pos *= 3;
1691
1692 return M_IMGDATA->m_data[pos];
1693 }
1694
1695 unsigned char wxImage::GetGreen( int x, int y ) const
1696 {
1697 long pos = XYToIndex(x, y);
1698 wxCHECK_MSG( pos != -1, 0, wxT("invalid image coordinates") );
1699
1700 pos *= 3;
1701
1702 return M_IMGDATA->m_data[pos+1];
1703 }
1704
1705 unsigned char wxImage::GetBlue( int x, int y ) const
1706 {
1707 long pos = XYToIndex(x, y);
1708 wxCHECK_MSG( pos != -1, 0, wxT("invalid image coordinates") );
1709
1710 pos *= 3;
1711
1712 return M_IMGDATA->m_data[pos+2];
1713 }
1714
1715 bool wxImage::IsOk() const
1716 {
1717 // image of 0 width or height can't be considered ok - at least because it
1718 // causes crashes in ConvertToBitmap() if we don't catch it in time
1719 wxImageRefData *data = M_IMGDATA;
1720 return data && data->m_ok && data->m_width && data->m_height;
1721 }
1722
1723 unsigned char *wxImage::GetData() const
1724 {
1725 wxCHECK_MSG( Ok(), (unsigned char *)NULL, wxT("invalid image") );
1726
1727 return M_IMGDATA->m_data;
1728 }
1729
1730 void wxImage::SetData( unsigned char *data, bool static_data )
1731 {
1732 wxCHECK_RET( Ok(), wxT("invalid image") );
1733
1734 wxImageRefData *newRefData = new wxImageRefData();
1735
1736 newRefData->m_width = M_IMGDATA->m_width;
1737 newRefData->m_height = M_IMGDATA->m_height;
1738 newRefData->m_data = data;
1739 newRefData->m_ok = true;
1740 newRefData->m_maskRed = M_IMGDATA->m_maskRed;
1741 newRefData->m_maskGreen = M_IMGDATA->m_maskGreen;
1742 newRefData->m_maskBlue = M_IMGDATA->m_maskBlue;
1743 newRefData->m_hasMask = M_IMGDATA->m_hasMask;
1744 newRefData->m_static = static_data;
1745
1746 UnRef();
1747
1748 m_refData = newRefData;
1749 }
1750
1751 void wxImage::SetData( unsigned char *data, int new_width, int new_height, bool static_data )
1752 {
1753 wxImageRefData *newRefData = new wxImageRefData();
1754
1755 if (m_refData)
1756 {
1757 newRefData->m_width = new_width;
1758 newRefData->m_height = new_height;
1759 newRefData->m_data = data;
1760 newRefData->m_ok = true;
1761 newRefData->m_maskRed = M_IMGDATA->m_maskRed;
1762 newRefData->m_maskGreen = M_IMGDATA->m_maskGreen;
1763 newRefData->m_maskBlue = M_IMGDATA->m_maskBlue;
1764 newRefData->m_hasMask = M_IMGDATA->m_hasMask;
1765 }
1766 else
1767 {
1768 newRefData->m_width = new_width;
1769 newRefData->m_height = new_height;
1770 newRefData->m_data = data;
1771 newRefData->m_ok = true;
1772 }
1773 newRefData->m_static = static_data;
1774
1775 UnRef();
1776
1777 m_refData = newRefData;
1778 }
1779
1780 // ----------------------------------------------------------------------------
1781 // alpha channel support
1782 // ----------------------------------------------------------------------------
1783
1784 void wxImage::SetAlpha(int x, int y, unsigned char alpha)
1785 {
1786 wxCHECK_RET( HasAlpha(), wxT("no alpha channel") );
1787
1788 long pos = XYToIndex(x, y);
1789 wxCHECK_RET( pos != -1, wxT("invalid image coordinates") );
1790
1791 AllocExclusive();
1792
1793 M_IMGDATA->m_alpha[pos] = alpha;
1794 }
1795
1796 unsigned char wxImage::GetAlpha(int x, int y) const
1797 {
1798 wxCHECK_MSG( HasAlpha(), 0, wxT("no alpha channel") );
1799
1800 long pos = XYToIndex(x, y);
1801 wxCHECK_MSG( pos != -1, 0, wxT("invalid image coordinates") );
1802
1803 return M_IMGDATA->m_alpha[pos];
1804 }
1805
1806 bool
1807 wxImage::ConvertColourToAlpha(unsigned char r, unsigned char g, unsigned char b)
1808 {
1809 SetAlpha(NULL);
1810
1811 const int w = M_IMGDATA->m_width;
1812 const int h = M_IMGDATA->m_height;
1813
1814 unsigned char *alpha = GetAlpha();
1815 unsigned char *data = GetData();
1816
1817 for ( int y = 0; y < h; y++ )
1818 {
1819 for ( int x = 0; x < w; x++ )
1820 {
1821 *alpha++ = *data;
1822 *data++ = r;
1823 *data++ = g;
1824 *data++ = b;
1825 }
1826 }
1827
1828 return true;
1829 }
1830
1831 void wxImage::SetAlpha( unsigned char *alpha, bool static_data )
1832 {
1833 wxCHECK_RET( Ok(), wxT("invalid image") );
1834
1835 AllocExclusive();
1836
1837 if ( !alpha )
1838 {
1839 alpha = (unsigned char *)malloc(M_IMGDATA->m_width*M_IMGDATA->m_height);
1840 }
1841
1842 if( !M_IMGDATA->m_staticAlpha )
1843 free(M_IMGDATA->m_alpha);
1844
1845 M_IMGDATA->m_alpha = alpha;
1846 M_IMGDATA->m_staticAlpha = static_data;
1847 }
1848
1849 unsigned char *wxImage::GetAlpha() const
1850 {
1851 wxCHECK_MSG( Ok(), (unsigned char *)NULL, wxT("invalid image") );
1852
1853 return M_IMGDATA->m_alpha;
1854 }
1855
1856 void wxImage::InitAlpha()
1857 {
1858 wxCHECK_RET( !HasAlpha(), wxT("image already has an alpha channel") );
1859
1860 // initialize memory for alpha channel
1861 SetAlpha();
1862
1863 unsigned char *alpha = M_IMGDATA->m_alpha;
1864 const size_t lenAlpha = M_IMGDATA->m_width * M_IMGDATA->m_height;
1865
1866 if ( HasMask() )
1867 {
1868 // use the mask to initialize the alpha channel.
1869 const unsigned char * const alphaEnd = alpha + lenAlpha;
1870
1871 const unsigned char mr = M_IMGDATA->m_maskRed;
1872 const unsigned char mg = M_IMGDATA->m_maskGreen;
1873 const unsigned char mb = M_IMGDATA->m_maskBlue;
1874 for ( unsigned char *src = M_IMGDATA->m_data;
1875 alpha < alphaEnd;
1876 src += 3, alpha++ )
1877 {
1878 *alpha = (src[0] == mr && src[1] == mg && src[2] == mb)
1879 ? wxIMAGE_ALPHA_TRANSPARENT
1880 : wxIMAGE_ALPHA_OPAQUE;
1881 }
1882
1883 M_IMGDATA->m_hasMask = false;
1884 }
1885 else // no mask
1886 {
1887 // make the image fully opaque
1888 memset(alpha, wxIMAGE_ALPHA_OPAQUE, lenAlpha);
1889 }
1890 }
1891
1892 void wxImage::ClearAlpha()
1893 {
1894 wxCHECK_RET( HasAlpha(), wxT("image already doesn't have an alpha channel") );
1895
1896 if ( !M_IMGDATA->m_staticAlpha )
1897 free( M_IMGDATA->m_alpha );
1898
1899 M_IMGDATA->m_alpha = NULL;
1900 }
1901
1902
1903 // ----------------------------------------------------------------------------
1904 // mask support
1905 // ----------------------------------------------------------------------------
1906
1907 void wxImage::SetMaskColour( unsigned char r, unsigned char g, unsigned char b )
1908 {
1909 wxCHECK_RET( Ok(), wxT("invalid image") );
1910
1911 AllocExclusive();
1912
1913 M_IMGDATA->m_maskRed = r;
1914 M_IMGDATA->m_maskGreen = g;
1915 M_IMGDATA->m_maskBlue = b;
1916 M_IMGDATA->m_hasMask = true;
1917 }
1918
1919 bool wxImage::GetOrFindMaskColour( unsigned char *r, unsigned char *g, unsigned char *b ) const
1920 {
1921 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1922
1923 if (M_IMGDATA->m_hasMask)
1924 {
1925 if (r) *r = M_IMGDATA->m_maskRed;
1926 if (g) *g = M_IMGDATA->m_maskGreen;
1927 if (b) *b = M_IMGDATA->m_maskBlue;
1928 return true;
1929 }
1930 else
1931 {
1932 FindFirstUnusedColour(r, g, b);
1933 return false;
1934 }
1935 }
1936
1937 unsigned char wxImage::GetMaskRed() const
1938 {
1939 wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1940
1941 return M_IMGDATA->m_maskRed;
1942 }
1943
1944 unsigned char wxImage::GetMaskGreen() const
1945 {
1946 wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1947
1948 return M_IMGDATA->m_maskGreen;
1949 }
1950
1951 unsigned char wxImage::GetMaskBlue() const
1952 {
1953 wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1954
1955 return M_IMGDATA->m_maskBlue;
1956 }
1957
1958 void wxImage::SetMask( bool mask )
1959 {
1960 wxCHECK_RET( Ok(), wxT("invalid image") );
1961
1962 AllocExclusive();
1963
1964 M_IMGDATA->m_hasMask = mask;
1965 }
1966
1967 bool wxImage::HasMask() const
1968 {
1969 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1970
1971 return M_IMGDATA->m_hasMask;
1972 }
1973
1974 bool wxImage::IsTransparent(int x, int y, unsigned char threshold) const
1975 {
1976 long pos = XYToIndex(x, y);
1977 wxCHECK_MSG( pos != -1, false, wxT("invalid image coordinates") );
1978
1979 // check mask
1980 if ( M_IMGDATA->m_hasMask )
1981 {
1982 const unsigned char *p = M_IMGDATA->m_data + 3*pos;
1983 if ( p[0] == M_IMGDATA->m_maskRed &&
1984 p[1] == M_IMGDATA->m_maskGreen &&
1985 p[2] == M_IMGDATA->m_maskBlue )
1986 {
1987 return true;
1988 }
1989 }
1990
1991 // then check alpha
1992 if ( M_IMGDATA->m_alpha )
1993 {
1994 if ( M_IMGDATA->m_alpha[pos] < threshold )
1995 {
1996 // transparent enough
1997 return true;
1998 }
1999 }
2000
2001 // not transparent
2002 return false;
2003 }
2004
2005 bool wxImage::SetMaskFromImage(const wxImage& mask,
2006 unsigned char mr, unsigned char mg, unsigned char mb)
2007 {
2008 // check that the images are the same size
2009 if ( (M_IMGDATA->m_height != mask.GetHeight() ) || (M_IMGDATA->m_width != mask.GetWidth () ) )
2010 {
2011 wxLogError( _("Image and mask have different sizes.") );
2012 return false;
2013 }
2014
2015 // find unused colour
2016 unsigned char r,g,b ;
2017 if (!FindFirstUnusedColour(&r, &g, &b))
2018 {
2019 wxLogError( _("No unused colour in image being masked.") );
2020 return false ;
2021 }
2022
2023 AllocExclusive();
2024
2025 unsigned char *imgdata = GetData();
2026 unsigned char *maskdata = mask.GetData();
2027
2028 const int w = GetWidth();
2029 const int h = GetHeight();
2030
2031 for (int j = 0; j < h; j++)
2032 {
2033 for (int i = 0; i < w; i++)
2034 {
2035 if ((maskdata[0] == mr) && (maskdata[1] == mg) && (maskdata[2] == mb))
2036 {
2037 imgdata[0] = r;
2038 imgdata[1] = g;
2039 imgdata[2] = b;
2040 }
2041 imgdata += 3;
2042 maskdata += 3;
2043 }
2044 }
2045
2046 SetMaskColour(r, g, b);
2047 SetMask(true);
2048
2049 return true;
2050 }
2051
2052 bool wxImage::ConvertAlphaToMask(unsigned char threshold)
2053 {
2054 if ( !HasAlpha() )
2055 return false;
2056
2057 unsigned char mr, mg, mb;
2058 if ( !FindFirstUnusedColour(&mr, &mg, &mb) )
2059 {
2060 wxLogError( _("No unused colour in image being masked.") );
2061 return false;
2062 }
2063
2064 return ConvertAlphaToMask(mr, mg, mb, threshold);
2065 }
2066
2067 bool wxImage::ConvertAlphaToMask(unsigned char mr,
2068 unsigned char mg,
2069 unsigned char mb,
2070 unsigned char threshold)
2071 {
2072 if ( !HasAlpha() )
2073 return false;
2074
2075 AllocExclusive();
2076
2077 SetMask(true);
2078 SetMaskColour(mr, mg, mb);
2079
2080 unsigned char *imgdata = GetData();
2081 unsigned char *alphadata = GetAlpha();
2082
2083 int w = GetWidth();
2084 int h = GetHeight();
2085
2086 for (int y = 0; y < h; y++)
2087 {
2088 for (int x = 0; x < w; x++, imgdata += 3, alphadata++)
2089 {
2090 if (*alphadata < threshold)
2091 {
2092 imgdata[0] = mr;
2093 imgdata[1] = mg;
2094 imgdata[2] = mb;
2095 }
2096 }
2097 }
2098
2099 if ( !M_IMGDATA->m_staticAlpha )
2100 free(M_IMGDATA->m_alpha);
2101
2102 M_IMGDATA->m_alpha = NULL;
2103 M_IMGDATA->m_staticAlpha = false;
2104
2105 return true;
2106 }
2107
2108 // ----------------------------------------------------------------------------
2109 // Palette functions
2110 // ----------------------------------------------------------------------------
2111
2112 #if wxUSE_PALETTE
2113
2114 bool wxImage::HasPalette() const
2115 {
2116 if (!Ok())
2117 return false;
2118
2119 return M_IMGDATA->m_palette.Ok();
2120 }
2121
2122 const wxPalette& wxImage::GetPalette() const
2123 {
2124 wxCHECK_MSG( Ok(), wxNullPalette, wxT("invalid image") );
2125
2126 return M_IMGDATA->m_palette;
2127 }
2128
2129 void wxImage::SetPalette(const wxPalette& palette)
2130 {
2131 wxCHECK_RET( Ok(), wxT("invalid image") );
2132
2133 AllocExclusive();
2134
2135 M_IMGDATA->m_palette = palette;
2136 }
2137
2138 #endif // wxUSE_PALETTE
2139
2140 // ----------------------------------------------------------------------------
2141 // Option functions (arbitrary name/value mapping)
2142 // ----------------------------------------------------------------------------
2143
2144 void wxImage::SetOption(const wxString& name, const wxString& value)
2145 {
2146 AllocExclusive();
2147
2148 int idx = M_IMGDATA->m_optionNames.Index(name, false);
2149 if ( idx == wxNOT_FOUND )
2150 {
2151 M_IMGDATA->m_optionNames.Add(name);
2152 M_IMGDATA->m_optionValues.Add(value);
2153 }
2154 else
2155 {
2156 M_IMGDATA->m_optionNames[idx] = name;
2157 M_IMGDATA->m_optionValues[idx] = value;
2158 }
2159 }
2160
2161 void wxImage::SetOption(const wxString& name, int value)
2162 {
2163 wxString valStr;
2164 valStr.Printf(wxT("%d"), value);
2165 SetOption(name, valStr);
2166 }
2167
2168 wxString wxImage::GetOption(const wxString& name) const
2169 {
2170 if ( !M_IMGDATA )
2171 return wxEmptyString;
2172
2173 int idx = M_IMGDATA->m_optionNames.Index(name, false);
2174 if ( idx == wxNOT_FOUND )
2175 return wxEmptyString;
2176 else
2177 return M_IMGDATA->m_optionValues[idx];
2178 }
2179
2180 int wxImage::GetOptionInt(const wxString& name) const
2181 {
2182 return wxAtoi(GetOption(name));
2183 }
2184
2185 bool wxImage::HasOption(const wxString& name) const
2186 {
2187 return M_IMGDATA ? M_IMGDATA->m_optionNames.Index(name, false) != wxNOT_FOUND
2188 : false;
2189 }
2190
2191 // ----------------------------------------------------------------------------
2192 // image I/O
2193 // ----------------------------------------------------------------------------
2194
2195 bool wxImage::LoadFile( const wxString& WXUNUSED_UNLESS_STREAMS(filename),
2196 wxBitmapType WXUNUSED_UNLESS_STREAMS(type),
2197 int WXUNUSED_UNLESS_STREAMS(index) )
2198 {
2199 #if HAS_FILE_STREAMS
2200 wxImageFileInputStream stream(filename);
2201 if ( stream.IsOk() )
2202 {
2203 wxBufferedInputStream bstream( stream );
2204 if ( LoadFile(bstream, type, index) )
2205 return true;
2206 }
2207
2208 wxLogError(_("Failed to load image from file \"%s\"."), filename);
2209 #endif // HAS_FILE_STREAMS
2210
2211 return false;
2212 }
2213
2214 bool wxImage::LoadFile( const wxString& WXUNUSED_UNLESS_STREAMS(filename),
2215 const wxString& WXUNUSED_UNLESS_STREAMS(mimetype),
2216 int WXUNUSED_UNLESS_STREAMS(index) )
2217 {
2218 #if HAS_FILE_STREAMS
2219 wxImageFileInputStream stream(filename);
2220 if ( stream.IsOk() )
2221 {
2222 wxBufferedInputStream bstream( stream );
2223 if ( LoadFile(bstream, mimetype, index) )
2224 return true;
2225 }
2226
2227 wxLogError(_("Failed to load image from file \"%s\"."), filename);
2228 #endif // HAS_FILE_STREAMS
2229
2230 return false;
2231 }
2232
2233
2234 bool wxImage::SaveFile( const wxString& filename ) const
2235 {
2236 wxString ext = filename.AfterLast('.').Lower();
2237
2238 wxImageHandler *handler = FindHandler(ext, wxBITMAP_TYPE_ANY);
2239 if ( !handler)
2240 {
2241 wxLogError(_("Can't save image to file '%s': unknown extension."),
2242 filename);
2243 return false;
2244 }
2245
2246 return SaveFile(filename, handler->GetType());
2247 }
2248
2249 bool wxImage::SaveFile( const wxString& WXUNUSED_UNLESS_STREAMS(filename),
2250 wxBitmapType WXUNUSED_UNLESS_STREAMS(type) ) const
2251 {
2252 #if HAS_FILE_STREAMS
2253 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
2254
2255 ((wxImage*)this)->SetOption(wxIMAGE_OPTION_FILENAME, filename);
2256
2257 wxImageFileOutputStream stream(filename);
2258
2259 if ( stream.IsOk() )
2260 {
2261 wxBufferedOutputStream bstream( stream );
2262 return SaveFile(bstream, type);
2263 }
2264 #endif // HAS_FILE_STREAMS
2265
2266 return false;
2267 }
2268
2269 bool wxImage::SaveFile( const wxString& WXUNUSED_UNLESS_STREAMS(filename),
2270 const wxString& WXUNUSED_UNLESS_STREAMS(mimetype) ) const
2271 {
2272 #if HAS_FILE_STREAMS
2273 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
2274
2275 ((wxImage*)this)->SetOption(wxIMAGE_OPTION_FILENAME, filename);
2276
2277 wxImageFileOutputStream stream(filename);
2278
2279 if ( stream.IsOk() )
2280 {
2281 wxBufferedOutputStream bstream( stream );
2282 return SaveFile(bstream, mimetype);
2283 }
2284 #endif // HAS_FILE_STREAMS
2285
2286 return false;
2287 }
2288
2289 bool wxImage::CanRead( const wxString& WXUNUSED_UNLESS_STREAMS(name) )
2290 {
2291 #if HAS_FILE_STREAMS
2292 wxImageFileInputStream stream(name);
2293 return CanRead(stream);
2294 #else
2295 return false;
2296 #endif
2297 }
2298
2299 int wxImage::GetImageCount( const wxString& WXUNUSED_UNLESS_STREAMS(name),
2300 wxBitmapType WXUNUSED_UNLESS_STREAMS(type) )
2301 {
2302 #if HAS_FILE_STREAMS
2303 wxImageFileInputStream stream(name);
2304 if (stream.Ok())
2305 return GetImageCount(stream, type);
2306 #endif
2307
2308 return 0;
2309 }
2310
2311 #if wxUSE_STREAMS
2312
2313 bool wxImage::CanRead( wxInputStream &stream )
2314 {
2315 const wxList& list = GetHandlers();
2316
2317 for ( wxList::compatibility_iterator node = list.GetFirst(); node; node = node->GetNext() )
2318 {
2319 wxImageHandler *handler=(wxImageHandler*)node->GetData();
2320 if (handler->CanRead( stream ))
2321 return true;
2322 }
2323
2324 return false;
2325 }
2326
2327 int wxImage::GetImageCount( wxInputStream &stream, wxBitmapType type )
2328 {
2329 wxImageHandler *handler;
2330
2331 if ( type == wxBITMAP_TYPE_ANY )
2332 {
2333 const wxList& list = GetHandlers();
2334
2335 for ( wxList::compatibility_iterator node = list.GetFirst();
2336 node;
2337 node = node->GetNext() )
2338 {
2339 handler = (wxImageHandler*)node->GetData();
2340 if ( handler->CanRead(stream) )
2341 {
2342 const int count = handler->GetImageCount(stream);
2343 if ( count >= 0 )
2344 return count;
2345 }
2346
2347 }
2348
2349 wxLogWarning(_("No handler found for image type."));
2350 return 0;
2351 }
2352
2353 handler = FindHandler(type);
2354
2355 if ( !handler )
2356 {
2357 wxLogWarning(_("No image handler for type %d defined."), type);
2358 return false;
2359 }
2360
2361 if ( handler->CanRead(stream) )
2362 {
2363 return handler->GetImageCount(stream);
2364 }
2365 else
2366 {
2367 wxLogError(_("Image file is not of type %d."), type);
2368 return 0;
2369 }
2370 }
2371
2372 bool wxImage::DoLoad(wxImageHandler& handler, wxInputStream& stream, int index)
2373 {
2374 // save the options values which can be clobbered by the handler (e.g. many
2375 // of them call Destroy() before trying to load the file)
2376 const unsigned maxWidth = GetOptionInt(wxIMAGE_OPTION_MAX_WIDTH),
2377 maxHeight = GetOptionInt(wxIMAGE_OPTION_MAX_HEIGHT);
2378
2379 // Preserve the original stream position if possible to rewind back to it
2380 // if we failed to load the file -- maybe the next handler that we try can
2381 // succeed after us then.
2382 wxFileOffset posOld = wxInvalidOffset;
2383 if ( stream.IsSeekable() )
2384 posOld = stream.TellI();
2385
2386 if ( !handler.LoadFile(this, stream, true/*verbose*/, index) )
2387 {
2388 if ( posOld != wxInvalidOffset )
2389 stream.SeekI(posOld);
2390
2391 return false;
2392 }
2393
2394 // rescale the image to the specified size if needed
2395 if ( maxWidth || maxHeight )
2396 {
2397 const unsigned widthOrig = GetWidth(),
2398 heightOrig = GetHeight();
2399
2400 // this uses the same (trivial) algorithm as the JPEG handler
2401 unsigned width = widthOrig,
2402 height = heightOrig;
2403 while ( (maxWidth && width > maxWidth) ||
2404 (maxHeight && height > maxHeight) )
2405 {
2406 width /= 2;
2407 height /= 2;
2408 }
2409
2410 if ( width != widthOrig || height != heightOrig )
2411 Rescale(width, height, wxIMAGE_QUALITY_HIGH);
2412 }
2413
2414 // Set this after Rescale, which currently does not preserve it
2415 M_IMGDATA->m_type = handler.GetType();
2416
2417 return true;
2418 }
2419
2420 bool wxImage::LoadFile( wxInputStream& stream, wxBitmapType type, int index )
2421 {
2422 AllocExclusive();
2423
2424 wxImageHandler *handler;
2425
2426 if ( type == wxBITMAP_TYPE_ANY )
2427 {
2428 if ( !stream.IsSeekable() )
2429 {
2430 // The error message about image data format being unknown below
2431 // would be misleading in this case as we are not even going to try
2432 // any handlers because CanRead() never does anything for not
2433 // seekable stream, so try to be more precise here.
2434 wxLogError(_("Can't automatically determine the image format "
2435 "for non-seekable input."));
2436 return false;
2437 }
2438
2439 const wxList& list = GetHandlers();
2440 for ( wxList::compatibility_iterator node = list.GetFirst();
2441 node;
2442 node = node->GetNext() )
2443 {
2444 handler = (wxImageHandler*)node->GetData();
2445 if ( handler->CanRead(stream) && DoLoad(*handler, stream, index) )
2446 return true;
2447 }
2448
2449 wxLogWarning( _("Unknown image data format.") );
2450
2451 return false;
2452 }
2453 //else: have specific type
2454
2455 handler = FindHandler(type);
2456 if ( !handler )
2457 {
2458 wxLogWarning( _("No image handler for type %d defined."), type );
2459 return false;
2460 }
2461
2462 if ( stream.IsSeekable() && !handler->CanRead(stream) )
2463 {
2464 wxLogError(_("This is not a %s."), handler->GetName());
2465 return false;
2466 }
2467
2468 return DoLoad(*handler, stream, index);
2469 }
2470
2471 bool wxImage::LoadFile( wxInputStream& stream, const wxString& mimetype, int index )
2472 {
2473 UnRef();
2474
2475 m_refData = new wxImageRefData;
2476
2477 wxImageHandler *handler = FindHandlerMime(mimetype);
2478
2479 if ( !handler )
2480 {
2481 wxLogWarning( _("No image handler for type %s defined."), mimetype.GetData() );
2482 return false;
2483 }
2484
2485 if ( stream.IsSeekable() && !handler->CanRead(stream) )
2486 {
2487 wxLogError(_("Image is not of type %s."), mimetype);
2488 return false;
2489 }
2490
2491 return DoLoad(*handler, stream, index);
2492 }
2493
2494 bool wxImage::DoSave(wxImageHandler& handler, wxOutputStream& stream) const
2495 {
2496 wxImage * const self = const_cast<wxImage *>(this);
2497 if ( !handler.SaveFile(self, stream) )
2498 return false;
2499
2500 M_IMGDATA->m_type = handler.GetType();
2501 return true;
2502 }
2503
2504 bool wxImage::SaveFile( wxOutputStream& stream, wxBitmapType type ) const
2505 {
2506 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
2507
2508 wxImageHandler *handler = FindHandler(type);
2509 if ( !handler )
2510 {
2511 wxLogWarning( _("No image handler for type %d defined."), type );
2512 return false;
2513 }
2514
2515 return DoSave(*handler, stream);
2516 }
2517
2518 bool wxImage::SaveFile( wxOutputStream& stream, const wxString& mimetype ) const
2519 {
2520 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
2521
2522 wxImageHandler *handler = FindHandlerMime(mimetype);
2523 if ( !handler )
2524 {
2525 wxLogWarning( _("No image handler for type %s defined."), mimetype.GetData() );
2526 }
2527
2528 return DoSave(*handler, stream);
2529 }
2530
2531 #endif // wxUSE_STREAMS
2532
2533 // ----------------------------------------------------------------------------
2534 // image I/O handlers
2535 // ----------------------------------------------------------------------------
2536
2537 void wxImage::AddHandler( wxImageHandler *handler )
2538 {
2539 // Check for an existing handler of the type being added.
2540 if (FindHandler( handler->GetType() ) == 0)
2541 {
2542 sm_handlers.Append( handler );
2543 }
2544 else
2545 {
2546 // This is not documented behaviour, merely the simplest 'fix'
2547 // for preventing duplicate additions. If someone ever has
2548 // a good reason to add and remove duplicate handlers (and they
2549 // may) we should probably refcount the duplicates.
2550 // also an issue in InsertHandler below.
2551
2552 wxLogDebug( wxT("Adding duplicate image handler for '%s'"),
2553 handler->GetName().c_str() );
2554 delete handler;
2555 }
2556 }
2557
2558 void wxImage::InsertHandler( wxImageHandler *handler )
2559 {
2560 // Check for an existing handler of the type being added.
2561 if (FindHandler( handler->GetType() ) == 0)
2562 {
2563 sm_handlers.Insert( handler );
2564 }
2565 else
2566 {
2567 // see AddHandler for additional comments.
2568 wxLogDebug( wxT("Inserting duplicate image handler for '%s'"),
2569 handler->GetName().c_str() );
2570 delete handler;
2571 }
2572 }
2573
2574 bool wxImage::RemoveHandler( const wxString& name )
2575 {
2576 wxImageHandler *handler = FindHandler(name);
2577 if (handler)
2578 {
2579 sm_handlers.DeleteObject(handler);
2580 delete handler;
2581 return true;
2582 }
2583 else
2584 return false;
2585 }
2586
2587 wxImageHandler *wxImage::FindHandler( const wxString& name )
2588 {
2589 wxList::compatibility_iterator node = sm_handlers.GetFirst();
2590 while (node)
2591 {
2592 wxImageHandler *handler = (wxImageHandler*)node->GetData();
2593 if (handler->GetName().Cmp(name) == 0) return handler;
2594
2595 node = node->GetNext();
2596 }
2597 return NULL;
2598 }
2599
2600 wxImageHandler *wxImage::FindHandler( const wxString& extension, wxBitmapType bitmapType )
2601 {
2602 wxList::compatibility_iterator node = sm_handlers.GetFirst();
2603 while (node)
2604 {
2605 wxImageHandler *handler = (wxImageHandler*)node->GetData();
2606 if ((bitmapType == wxBITMAP_TYPE_ANY) || (handler->GetType() == bitmapType))
2607 {
2608 if (handler->GetExtension() == extension)
2609 return handler;
2610 if (handler->GetAltExtensions().Index(extension, false) != wxNOT_FOUND)
2611 return handler;
2612 }
2613 node = node->GetNext();
2614 }
2615 return NULL;
2616 }
2617
2618 wxImageHandler *wxImage::FindHandler(wxBitmapType bitmapType )
2619 {
2620 wxList::compatibility_iterator node = sm_handlers.GetFirst();
2621 while (node)
2622 {
2623 wxImageHandler *handler = (wxImageHandler *)node->GetData();
2624 if (handler->GetType() == bitmapType) return handler;
2625 node = node->GetNext();
2626 }
2627 return NULL;
2628 }
2629
2630 wxImageHandler *wxImage::FindHandlerMime( const wxString& mimetype )
2631 {
2632 wxList::compatibility_iterator node = sm_handlers.GetFirst();
2633 while (node)
2634 {
2635 wxImageHandler *handler = (wxImageHandler *)node->GetData();
2636 if (handler->GetMimeType().IsSameAs(mimetype, false)) return handler;
2637 node = node->GetNext();
2638 }
2639 return NULL;
2640 }
2641
2642 void wxImage::InitStandardHandlers()
2643 {
2644 #if wxUSE_STREAMS
2645 AddHandler(new wxBMPHandler);
2646 #endif // wxUSE_STREAMS
2647 }
2648
2649 void wxImage::CleanUpHandlers()
2650 {
2651 wxList::compatibility_iterator node = sm_handlers.GetFirst();
2652 while (node)
2653 {
2654 wxImageHandler *handler = (wxImageHandler *)node->GetData();
2655 wxList::compatibility_iterator next = node->GetNext();
2656 delete handler;
2657 node = next;
2658 }
2659
2660 sm_handlers.Clear();
2661 }
2662
2663 wxString wxImage::GetImageExtWildcard()
2664 {
2665 wxString fmts;
2666
2667 wxList& Handlers = wxImage::GetHandlers();
2668 wxList::compatibility_iterator Node = Handlers.GetFirst();
2669 while ( Node )
2670 {
2671 wxImageHandler* Handler = (wxImageHandler*)Node->GetData();
2672 fmts += wxT("*.") + Handler->GetExtension();
2673 for (size_t i = 0; i < Handler->GetAltExtensions().size(); i++)
2674 fmts += wxT(";*.") + Handler->GetAltExtensions()[i];
2675 Node = Node->GetNext();
2676 if ( Node ) fmts += wxT(";");
2677 }
2678
2679 return wxT("(") + fmts + wxT(")|") + fmts;
2680 }
2681
2682 wxImage::HSVValue wxImage::RGBtoHSV(const RGBValue& rgb)
2683 {
2684 const double red = rgb.red / 255.0,
2685 green = rgb.green / 255.0,
2686 blue = rgb.blue / 255.0;
2687
2688 // find the min and max intensity (and remember which one was it for the
2689 // latter)
2690 double minimumRGB = red;
2691 if ( green < minimumRGB )
2692 minimumRGB = green;
2693 if ( blue < minimumRGB )
2694 minimumRGB = blue;
2695
2696 enum { RED, GREEN, BLUE } chMax = RED;
2697 double maximumRGB = red;
2698 if ( green > maximumRGB )
2699 {
2700 chMax = GREEN;
2701 maximumRGB = green;
2702 }
2703 if ( blue > maximumRGB )
2704 {
2705 chMax = BLUE;
2706 maximumRGB = blue;
2707 }
2708
2709 const double value = maximumRGB;
2710
2711 double hue = 0.0, saturation;
2712 const double deltaRGB = maximumRGB - minimumRGB;
2713 if ( wxIsNullDouble(deltaRGB) )
2714 {
2715 // Gray has no color
2716 hue = 0.0;
2717 saturation = 0.0;
2718 }
2719 else
2720 {
2721 switch ( chMax )
2722 {
2723 case RED:
2724 hue = (green - blue) / deltaRGB;
2725 break;
2726
2727 case GREEN:
2728 hue = 2.0 + (blue - red) / deltaRGB;
2729 break;
2730
2731 case BLUE:
2732 hue = 4.0 + (red - green) / deltaRGB;
2733 break;
2734
2735 default:
2736 wxFAIL_MSG(wxT("hue not specified"));
2737 break;
2738 }
2739
2740 hue /= 6.0;
2741
2742 if ( hue < 0.0 )
2743 hue += 1.0;
2744
2745 saturation = deltaRGB / maximumRGB;
2746 }
2747
2748 return HSVValue(hue, saturation, value);
2749 }
2750
2751 wxImage::RGBValue wxImage::HSVtoRGB(const HSVValue& hsv)
2752 {
2753 double red, green, blue;
2754
2755 if ( wxIsNullDouble(hsv.saturation) )
2756 {
2757 // Grey
2758 red = hsv.value;
2759 green = hsv.value;
2760 blue = hsv.value;
2761 }
2762 else // not grey
2763 {
2764 double hue = hsv.hue * 6.0; // sector 0 to 5
2765 int i = (int)floor(hue);
2766 double f = hue - i; // fractional part of h
2767 double p = hsv.value * (1.0 - hsv.saturation);
2768
2769 switch (i)
2770 {
2771 case 0:
2772 red = hsv.value;
2773 green = hsv.value * (1.0 - hsv.saturation * (1.0 - f));
2774 blue = p;
2775 break;
2776
2777 case 1:
2778 red = hsv.value * (1.0 - hsv.saturation * f);
2779 green = hsv.value;
2780 blue = p;
2781 break;
2782
2783 case 2:
2784 red = p;
2785 green = hsv.value;
2786 blue = hsv.value * (1.0 - hsv.saturation * (1.0 - f));
2787 break;
2788
2789 case 3:
2790 red = p;
2791 green = hsv.value * (1.0 - hsv.saturation * f);
2792 blue = hsv.value;
2793 break;
2794
2795 case 4:
2796 red = hsv.value * (1.0 - hsv.saturation * (1.0 - f));
2797 green = p;
2798 blue = hsv.value;
2799 break;
2800
2801 default: // case 5:
2802 red = hsv.value;
2803 green = p;
2804 blue = hsv.value * (1.0 - hsv.saturation * f);
2805 break;
2806 }
2807 }
2808
2809 return RGBValue((unsigned char)(red * 255.0),
2810 (unsigned char)(green * 255.0),
2811 (unsigned char)(blue * 255.0));
2812 }
2813
2814 /*
2815 * Rotates the hue of each pixel of the image. angle is a double in the range
2816 * -1.0..1.0 where -1.0 is -360 degrees and 1.0 is 360 degrees
2817 */
2818 void wxImage::RotateHue(double angle)
2819 {
2820 AllocExclusive();
2821
2822 unsigned char *srcBytePtr;
2823 unsigned char *dstBytePtr;
2824 unsigned long count;
2825 wxImage::HSVValue hsv;
2826 wxImage::RGBValue rgb;
2827
2828 wxASSERT (angle >= -1.0 && angle <= 1.0);
2829 count = M_IMGDATA->m_width * M_IMGDATA->m_height;
2830 if ( count > 0 && !wxIsNullDouble(angle) )
2831 {
2832 srcBytePtr = M_IMGDATA->m_data;
2833 dstBytePtr = srcBytePtr;
2834 do
2835 {
2836 rgb.red = *srcBytePtr++;
2837 rgb.green = *srcBytePtr++;
2838 rgb.blue = *srcBytePtr++;
2839 hsv = RGBtoHSV(rgb);
2840
2841 hsv.hue = hsv.hue + angle;
2842 if (hsv.hue > 1.0)
2843 hsv.hue = hsv.hue - 1.0;
2844 else if (hsv.hue < 0.0)
2845 hsv.hue = hsv.hue + 1.0;
2846
2847 rgb = HSVtoRGB(hsv);
2848 *dstBytePtr++ = rgb.red;
2849 *dstBytePtr++ = rgb.green;
2850 *dstBytePtr++ = rgb.blue;
2851 } while (--count != 0);
2852 }
2853 }
2854
2855 //-----------------------------------------------------------------------------
2856 // wxImageHandler
2857 //-----------------------------------------------------------------------------
2858
2859 IMPLEMENT_ABSTRACT_CLASS(wxImageHandler,wxObject)
2860
2861 #if wxUSE_STREAMS
2862 int wxImageHandler::GetImageCount( wxInputStream& stream )
2863 {
2864 // NOTE: this code is the same of wxAnimationDecoder::CanRead and
2865 // wxImageHandler::CallDoCanRead
2866
2867 if ( !stream.IsSeekable() )
2868 return false; // can't test unseekable stream
2869
2870 wxFileOffset posOld = stream.TellI();
2871 int n = DoGetImageCount(stream);
2872
2873 // restore the old position to be able to test other formats and so on
2874 if ( stream.SeekI(posOld) == wxInvalidOffset )
2875 {
2876 wxLogDebug(wxT("Failed to rewind the stream in wxImageHandler!"));
2877
2878 // reading would fail anyhow as we're not at the right position
2879 return false;
2880 }
2881
2882 return n;
2883 }
2884
2885 bool wxImageHandler::CanRead( const wxString& name )
2886 {
2887 wxImageFileInputStream stream(name);
2888 if ( !stream.IsOk() )
2889 {
2890 wxLogError(_("Failed to check format of image file \"%s\"."), name);
2891
2892 return false;
2893 }
2894
2895 return CanRead(stream);
2896 }
2897
2898 bool wxImageHandler::CallDoCanRead(wxInputStream& stream)
2899 {
2900 // NOTE: this code is the same of wxAnimationDecoder::CanRead and
2901 // wxImageHandler::GetImageCount
2902
2903 if ( !stream.IsSeekable() )
2904 return false; // can't test unseekable stream
2905
2906 wxFileOffset posOld = stream.TellI();
2907 bool ok = DoCanRead(stream);
2908
2909 // restore the old position to be able to test other formats and so on
2910 if ( stream.SeekI(posOld) == wxInvalidOffset )
2911 {
2912 wxLogDebug(wxT("Failed to rewind the stream in wxImageHandler!"));
2913
2914 // reading would fail anyhow as we're not at the right position
2915 return false;
2916 }
2917
2918 return ok;
2919 }
2920
2921 #endif // wxUSE_STREAMS
2922
2923 /* static */
2924 wxImageResolution
2925 wxImageHandler::GetResolutionFromOptions(const wxImage& image, int *x, int *y)
2926 {
2927 wxCHECK_MSG( x && y, wxIMAGE_RESOLUTION_NONE, wxT("NULL pointer") );
2928
2929 if ( image.HasOption(wxIMAGE_OPTION_RESOLUTIONX) &&
2930 image.HasOption(wxIMAGE_OPTION_RESOLUTIONY) )
2931 {
2932 *x = image.GetOptionInt(wxIMAGE_OPTION_RESOLUTIONX);
2933 *y = image.GetOptionInt(wxIMAGE_OPTION_RESOLUTIONY);
2934 }
2935 else if ( image.HasOption(wxIMAGE_OPTION_RESOLUTION) )
2936 {
2937 *x =
2938 *y = image.GetOptionInt(wxIMAGE_OPTION_RESOLUTION);
2939 }
2940 else // no resolution options specified
2941 {
2942 *x =
2943 *y = 0;
2944
2945 return wxIMAGE_RESOLUTION_NONE;
2946 }
2947
2948 // get the resolution unit too
2949 int resUnit = image.GetOptionInt(wxIMAGE_OPTION_RESOLUTIONUNIT);
2950 if ( !resUnit )
2951 {
2952 // this is the default
2953 resUnit = wxIMAGE_RESOLUTION_INCHES;
2954 }
2955
2956 return (wxImageResolution)resUnit;
2957 }
2958
2959 // ----------------------------------------------------------------------------
2960 // image histogram stuff
2961 // ----------------------------------------------------------------------------
2962
2963 bool
2964 wxImageHistogram::FindFirstUnusedColour(unsigned char *r,
2965 unsigned char *g,
2966 unsigned char *b,
2967 unsigned char r2,
2968 unsigned char b2,
2969 unsigned char g2) const
2970 {
2971 unsigned long key = MakeKey(r2, g2, b2);
2972
2973 while ( find(key) != end() )
2974 {
2975 // color already used
2976 r2++;
2977 if ( r2 >= 255 )
2978 {
2979 r2 = 0;
2980 g2++;
2981 if ( g2 >= 255 )
2982 {
2983 g2 = 0;
2984 b2++;
2985 if ( b2 >= 255 )
2986 {
2987 wxLogError(_("No unused colour in image.") );
2988 return false;
2989 }
2990 }
2991 }
2992
2993 key = MakeKey(r2, g2, b2);
2994 }
2995
2996 if ( r )
2997 *r = r2;
2998 if ( g )
2999 *g = g2;
3000 if ( b )
3001 *b = b2;
3002
3003 return true;
3004 }
3005
3006 bool
3007 wxImage::FindFirstUnusedColour(unsigned char *r,
3008 unsigned char *g,
3009 unsigned char *b,
3010 unsigned char r2,
3011 unsigned char b2,
3012 unsigned char g2) const
3013 {
3014 wxImageHistogram histogram;
3015
3016 ComputeHistogram(histogram);
3017
3018 return histogram.FindFirstUnusedColour(r, g, b, r2, g2, b2);
3019 }
3020
3021
3022
3023 // GRG, Dic/99
3024 // Counts and returns the number of different colours. Optionally stops
3025 // when it exceeds 'stopafter' different colours. This is useful, for
3026 // example, to see if the image can be saved as 8-bit (256 colour or
3027 // less, in this case it would be invoked as CountColours(256)). Default
3028 // value for stopafter is -1 (don't care).
3029 //
3030 unsigned long wxImage::CountColours( unsigned long stopafter ) const
3031 {
3032 wxHashTable h;
3033 wxObject dummy;
3034 unsigned char r, g, b;
3035 unsigned char *p;
3036 unsigned long size, nentries, key;
3037
3038 p = GetData();
3039 size = GetWidth() * GetHeight();
3040 nentries = 0;
3041
3042 for (unsigned long j = 0; (j < size) && (nentries <= stopafter) ; j++)
3043 {
3044 r = *(p++);
3045 g = *(p++);
3046 b = *(p++);
3047 key = wxImageHistogram::MakeKey(r, g, b);
3048
3049 if (h.Get(key) == NULL)
3050 {
3051 h.Put(key, &dummy);
3052 nentries++;
3053 }
3054 }
3055
3056 return nentries;
3057 }
3058
3059
3060 unsigned long wxImage::ComputeHistogram( wxImageHistogram &h ) const
3061 {
3062 unsigned char *p = GetData();
3063 unsigned long nentries = 0;
3064
3065 h.clear();
3066
3067 const unsigned long size = GetWidth() * GetHeight();
3068
3069 unsigned char r, g, b;
3070 for ( unsigned long n = 0; n < size; n++ )
3071 {
3072 r = *p++;
3073 g = *p++;
3074 b = *p++;
3075
3076 wxImageHistogramEntry& entry = h[wxImageHistogram::MakeKey(r, g, b)];
3077
3078 if ( entry.value++ == 0 )
3079 entry.index = nentries++;
3080 }
3081
3082 return nentries;
3083 }
3084
3085 /*
3086 * Rotation code by Carlos Moreno
3087 */
3088
3089 static const double wxROTATE_EPSILON = 1e-10;
3090
3091 // Auxiliary function to rotate a point (x,y) with respect to point p0
3092 // make it inline and use a straight return to facilitate optimization
3093 // also, the function receives the sine and cosine of the angle to avoid
3094 // repeating the time-consuming calls to these functions -- sin/cos can
3095 // be computed and stored in the calling function.
3096
3097 static inline wxRealPoint
3098 wxRotatePoint(const wxRealPoint& p, double cos_angle, double sin_angle,
3099 const wxRealPoint& p0)
3100 {
3101 return wxRealPoint(p0.x + (p.x - p0.x) * cos_angle - (p.y - p0.y) * sin_angle,
3102 p0.y + (p.y - p0.y) * cos_angle + (p.x - p0.x) * sin_angle);
3103 }
3104
3105 static inline wxRealPoint
3106 wxRotatePoint(double x, double y, double cos_angle, double sin_angle,
3107 const wxRealPoint & p0)
3108 {
3109 return wxRotatePoint (wxRealPoint(x,y), cos_angle, sin_angle, p0);
3110 }
3111
3112 wxImage wxImage::Rotate(double angle,
3113 const wxPoint& centre_of_rotation,
3114 bool interpolating,
3115 wxPoint *offset_after_rotation) const
3116 {
3117 // screen coordinates are a mirror image of "real" coordinates
3118 angle = -angle;
3119
3120 const bool has_alpha = HasAlpha();
3121
3122 const int w = GetWidth();
3123 const int h = GetHeight();
3124
3125 int i;
3126
3127 // Create pointer-based array to accelerate access to wxImage's data
3128 unsigned char ** data = new unsigned char * [h];
3129 data[0] = GetData();
3130 for (i = 1; i < h; i++)
3131 data[i] = data[i - 1] + (3 * w);
3132
3133 // Same for alpha channel
3134 unsigned char ** alpha = NULL;
3135 if (has_alpha)
3136 {
3137 alpha = new unsigned char * [h];
3138 alpha[0] = GetAlpha();
3139 for (i = 1; i < h; i++)
3140 alpha[i] = alpha[i - 1] + w;
3141 }
3142
3143 // precompute coefficients for rotation formula
3144 const double cos_angle = cos(angle);
3145 const double sin_angle = sin(angle);
3146
3147 // Create new Image to store the result
3148 // First, find rectangle that covers the rotated image; to do that,
3149 // rotate the four corners
3150
3151 const wxRealPoint p0(centre_of_rotation.x, centre_of_rotation.y);
3152
3153 wxRealPoint p1 = wxRotatePoint (0, 0, cos_angle, sin_angle, p0);
3154 wxRealPoint p2 = wxRotatePoint (0, h, cos_angle, sin_angle, p0);
3155 wxRealPoint p3 = wxRotatePoint (w, 0, cos_angle, sin_angle, p0);
3156 wxRealPoint p4 = wxRotatePoint (w, h, cos_angle, sin_angle, p0);
3157
3158 int x1a = (int) floor (wxMin (wxMin(p1.x, p2.x), wxMin(p3.x, p4.x)));
3159 int y1a = (int) floor (wxMin (wxMin(p1.y, p2.y), wxMin(p3.y, p4.y)));
3160 int x2a = (int) ceil (wxMax (wxMax(p1.x, p2.x), wxMax(p3.x, p4.x)));
3161 int y2a = (int) ceil (wxMax (wxMax(p1.y, p2.y), wxMax(p3.y, p4.y)));
3162
3163 // Create rotated image
3164 wxImage rotated (x2a - x1a + 1, y2a - y1a + 1, false);
3165 // With alpha channel
3166 if (has_alpha)
3167 rotated.SetAlpha();
3168
3169 if (offset_after_rotation != NULL)
3170 {
3171 *offset_after_rotation = wxPoint (x1a, y1a);
3172 }
3173
3174 // the rotated (destination) image is always accessed sequentially via this
3175 // pointer, there is no need for pointer-based arrays here
3176 unsigned char *dst = rotated.GetData();
3177
3178 unsigned char *alpha_dst = has_alpha ? rotated.GetAlpha() : NULL;
3179
3180 // if the original image has a mask, use its RGB values as the blank pixel,
3181 // else, fall back to default (black).
3182 unsigned char blank_r = 0;
3183 unsigned char blank_g = 0;
3184 unsigned char blank_b = 0;
3185
3186 if (HasMask())
3187 {
3188 blank_r = GetMaskRed();
3189 blank_g = GetMaskGreen();
3190 blank_b = GetMaskBlue();
3191 rotated.SetMaskColour( blank_r, blank_g, blank_b );
3192 }
3193
3194 // Now, for each point of the rotated image, find where it came from, by
3195 // performing an inverse rotation (a rotation of -angle) and getting the
3196 // pixel at those coordinates
3197
3198 const int rH = rotated.GetHeight();
3199 const int rW = rotated.GetWidth();
3200
3201 // do the (interpolating) test outside of the loops, so that it is done
3202 // only once, instead of repeating it for each pixel.
3203 if (interpolating)
3204 {
3205 for (int y = 0; y < rH; y++)
3206 {
3207 for (int x = 0; x < rW; x++)
3208 {
3209 wxRealPoint src = wxRotatePoint (x + x1a, y + y1a, cos_angle, -sin_angle, p0);
3210
3211 if (-0.25 < src.x && src.x < w - 0.75 &&
3212 -0.25 < src.y && src.y < h - 0.75)
3213 {
3214 // interpolate using the 4 enclosing grid-points. Those
3215 // points can be obtained using floor and ceiling of the
3216 // exact coordinates of the point
3217 int x1, y1, x2, y2;
3218
3219 if (0 < src.x && src.x < w - 1)
3220 {
3221 x1 = wxRound(floor(src.x));
3222 x2 = wxRound(ceil(src.x));
3223 }
3224 else // else means that x is near one of the borders (0 or width-1)
3225 {
3226 x1 = x2 = wxRound (src.x);
3227 }
3228
3229 if (0 < src.y && src.y < h - 1)
3230 {
3231 y1 = wxRound(floor(src.y));
3232 y2 = wxRound(ceil(src.y));
3233 }
3234 else
3235 {
3236 y1 = y2 = wxRound (src.y);
3237 }
3238
3239 // get four points and the distances (square of the distance,
3240 // for efficiency reasons) for the interpolation formula
3241
3242 // GRG: Do not calculate the points until they are
3243 // really needed -- this way we can calculate
3244 // just one, instead of four, if d1, d2, d3
3245 // or d4 are < wxROTATE_EPSILON
3246
3247 const double d1 = (src.x - x1) * (src.x - x1) + (src.y - y1) * (src.y - y1);
3248 const double d2 = (src.x - x2) * (src.x - x2) + (src.y - y1) * (src.y - y1);
3249 const double d3 = (src.x - x2) * (src.x - x2) + (src.y - y2) * (src.y - y2);
3250 const double d4 = (src.x - x1) * (src.x - x1) + (src.y - y2) * (src.y - y2);
3251
3252 // Now interpolate as a weighted average of the four surrounding
3253 // points, where the weights are the distances to each of those points
3254
3255 // If the point is exactly at one point of the grid of the source
3256 // image, then don't interpolate -- just assign the pixel
3257
3258 // d1,d2,d3,d4 are positive -- no need for abs()
3259 if (d1 < wxROTATE_EPSILON)
3260 {
3261 unsigned char *p = data[y1] + (3 * x1);
3262 *(dst++) = *(p++);
3263 *(dst++) = *(p++);
3264 *(dst++) = *p;
3265
3266 if (has_alpha)
3267 *(alpha_dst++) = *(alpha[y1] + x1);
3268 }
3269 else if (d2 < wxROTATE_EPSILON)
3270 {
3271 unsigned char *p = data[y1] + (3 * x2);
3272 *(dst++) = *(p++);
3273 *(dst++) = *(p++);
3274 *(dst++) = *p;
3275
3276 if (has_alpha)
3277 *(alpha_dst++) = *(alpha[y1] + x2);
3278 }
3279 else if (d3 < wxROTATE_EPSILON)
3280 {
3281 unsigned char *p = data[y2] + (3 * x2);
3282 *(dst++) = *(p++);
3283 *(dst++) = *(p++);
3284 *(dst++) = *p;
3285
3286 if (has_alpha)
3287 *(alpha_dst++) = *(alpha[y2] + x2);
3288 }
3289 else if (d4 < wxROTATE_EPSILON)
3290 {
3291 unsigned char *p = data[y2] + (3 * x1);
3292 *(dst++) = *(p++);
3293 *(dst++) = *(p++);
3294 *(dst++) = *p;
3295
3296 if (has_alpha)
3297 *(alpha_dst++) = *(alpha[y2] + x1);
3298 }
3299 else
3300 {
3301 // weights for the weighted average are proportional to the inverse of the distance
3302 unsigned char *v1 = data[y1] + (3 * x1);
3303 unsigned char *v2 = data[y1] + (3 * x2);
3304 unsigned char *v3 = data[y2] + (3 * x2);
3305 unsigned char *v4 = data[y2] + (3 * x1);
3306
3307 const double w1 = 1/d1, w2 = 1/d2, w3 = 1/d3, w4 = 1/d4;
3308
3309 // GRG: Unrolled.
3310
3311 *(dst++) = (unsigned char)
3312 ( (w1 * *(v1++) + w2 * *(v2++) +
3313 w3 * *(v3++) + w4 * *(v4++)) /
3314 (w1 + w2 + w3 + w4) );
3315 *(dst++) = (unsigned char)
3316 ( (w1 * *(v1++) + w2 * *(v2++) +
3317 w3 * *(v3++) + w4 * *(v4++)) /
3318 (w1 + w2 + w3 + w4) );
3319 *(dst++) = (unsigned char)
3320 ( (w1 * *v1 + w2 * *v2 +
3321 w3 * *v3 + w4 * *v4) /
3322 (w1 + w2 + w3 + w4) );
3323
3324 if (has_alpha)
3325 {
3326 v1 = alpha[y1] + (x1);
3327 v2 = alpha[y1] + (x2);
3328 v3 = alpha[y2] + (x2);
3329 v4 = alpha[y2] + (x1);
3330
3331 *(alpha_dst++) = (unsigned char)
3332 ( (w1 * *v1 + w2 * *v2 +
3333 w3 * *v3 + w4 * *v4) /
3334 (w1 + w2 + w3 + w4) );
3335 }
3336 }
3337 }
3338 else
3339 {
3340 *(dst++) = blank_r;
3341 *(dst++) = blank_g;
3342 *(dst++) = blank_b;
3343
3344 if (has_alpha)
3345 *(alpha_dst++) = 0;
3346 }
3347 }
3348 }
3349 }
3350 else // not interpolating
3351 {
3352 for (int y = 0; y < rH; y++)
3353 {
3354 for (int x = 0; x < rW; x++)
3355 {
3356 wxRealPoint src = wxRotatePoint (x + x1a, y + y1a, cos_angle, -sin_angle, p0);
3357
3358 const int xs = wxRound (src.x); // wxRound rounds to the
3359 const int ys = wxRound (src.y); // closest integer
3360
3361 if (0 <= xs && xs < w && 0 <= ys && ys < h)
3362 {
3363 unsigned char *p = data[ys] + (3 * xs);
3364 *(dst++) = *(p++);
3365 *(dst++) = *(p++);
3366 *(dst++) = *p;
3367
3368 if (has_alpha)
3369 *(alpha_dst++) = *(alpha[ys] + (xs));
3370 }
3371 else
3372 {
3373 *(dst++) = blank_r;
3374 *(dst++) = blank_g;
3375 *(dst++) = blank_b;
3376
3377 if (has_alpha)
3378 *(alpha_dst++) = 255;
3379 }
3380 }
3381 }
3382 }
3383
3384 delete [] data;
3385 delete [] alpha;
3386
3387 return rotated;
3388 }
3389
3390
3391
3392
3393
3394 // A module to allow wxImage initialization/cleanup
3395 // without calling these functions from app.cpp or from
3396 // the user's application.
3397
3398 class wxImageModule: public wxModule
3399 {
3400 DECLARE_DYNAMIC_CLASS(wxImageModule)
3401 public:
3402 wxImageModule() {}
3403 bool OnInit() { wxImage::InitStandardHandlers(); return true; }
3404 void OnExit() { wxImage::CleanUpHandlers(); }
3405 };
3406
3407 IMPLEMENT_DYNAMIC_CLASS(wxImageModule, wxModule)
3408
3409
3410 #endif // wxUSE_IMAGE