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