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