1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/common/image.cpp
4 // Author: Robert Roebling
6 // Copyright: (c) Robert Roebling
7 // Licence: wxWindows licence
8 /////////////////////////////////////////////////////////////////////////////
10 // For compilers that support precompilation, includes "wx.h".
11 #include "wx/wxprec.h"
26 #include "wx/module.h"
27 #include "wx/palette.h"
31 #include "wx/filefn.h"
32 #include "wx/wfstream.h"
33 #include "wx/xpmdecod.h"
38 // make the code compile with either wxFile*Stream or wxFFile*Stream:
39 #define HAS_FILE_STREAMS (wxUSE_STREAMS && (wxUSE_FILE || wxUSE_FFILE))
43 typedef wxFFileInputStream wxImageFileInputStream
;
44 typedef wxFFileOutputStream wxImageFileOutputStream
;
46 typedef wxFileInputStream wxImageFileInputStream
;
47 typedef wxFileOutputStream wxImageFileOutputStream
;
48 #endif // wxUSE_FILE/wxUSE_FFILE
49 #endif // HAS_FILE_STREAMS
52 IMPLEMENT_VARIANT_OBJECT_EXPORTED_SHALLOWCMP(wxImage
,WXDLLEXPORT
)
55 //-----------------------------------------------------------------------------
57 //-----------------------------------------------------------------------------
59 class wxImageRefData
: public wxObjectRefData
63 virtual ~wxImageRefData();
68 unsigned char *m_data
;
71 unsigned char m_maskRed
,m_maskGreen
,m_maskBlue
;
73 // alpha channel data, may be NULL for the formats without alpha support
74 unsigned char *m_alpha
;
78 // if true, m_data is pointer to static data and shouldn't be freed
81 // same as m_static but for m_alpha
86 #endif // wxUSE_PALETTE
88 wxArrayString m_optionNames
;
89 wxArrayString m_optionValues
;
91 DECLARE_NO_COPY_CLASS(wxImageRefData
)
94 wxImageRefData::wxImageRefData()
98 m_type
= wxBITMAP_TYPE_INVALID
;
100 m_alpha
= (unsigned char *) NULL
;
109 m_staticAlpha
= false;
112 wxImageRefData::~wxImageRefData()
116 if ( !m_staticAlpha
)
120 wxList
wxImage::sm_handlers
;
124 //-----------------------------------------------------------------------------
126 #define M_IMGDATA static_cast<wxImageRefData*>(m_refData)
128 IMPLEMENT_DYNAMIC_CLASS(wxImage
, wxObject
)
130 wxImage::wxImage( int width
, int height
, bool clear
)
132 Create( width
, height
, clear
);
135 wxImage::wxImage( int width
, int height
, unsigned char* data
, bool static_data
)
137 Create( width
, height
, data
, static_data
);
140 wxImage::wxImage( int width
, int height
, unsigned char* data
, unsigned char* alpha
, bool static_data
)
142 Create( width
, height
, data
, alpha
, static_data
);
145 wxImage::wxImage( const wxString
& name
, wxBitmapType type
, int index
)
147 LoadFile( name
, type
, index
);
150 wxImage::wxImage( const wxString
& name
, const wxString
& mimetype
, int index
)
152 LoadFile( name
, mimetype
, index
);
156 wxImage::wxImage( wxInputStream
& stream
, wxBitmapType type
, int index
)
158 LoadFile( stream
, type
, index
);
161 wxImage::wxImage( wxInputStream
& stream
, const wxString
& mimetype
, int index
)
163 LoadFile( stream
, mimetype
, index
);
165 #endif // wxUSE_STREAMS
167 wxImage::wxImage(const char* const* xpmData
)
172 bool wxImage::Create(const char* const* xpmData
)
177 wxXPMDecoder decoder
;
178 (*this) = decoder
.ReadData(xpmData
);
185 bool wxImage::Create( int width
, int height
, bool clear
)
189 m_refData
= new wxImageRefData();
191 M_IMGDATA
->m_data
= (unsigned char *) malloc( width
*height
*3 );
192 if (!M_IMGDATA
->m_data
)
199 memset(M_IMGDATA
->m_data
, 0, width
*height
*3);
201 M_IMGDATA
->m_width
= width
;
202 M_IMGDATA
->m_height
= height
;
203 M_IMGDATA
->m_ok
= true;
208 bool wxImage::Create( int width
, int height
, unsigned char* data
, bool static_data
)
212 wxCHECK_MSG( data
, false, _T("NULL data in wxImage::Create") );
214 m_refData
= new wxImageRefData();
216 M_IMGDATA
->m_data
= data
;
217 M_IMGDATA
->m_width
= width
;
218 M_IMGDATA
->m_height
= height
;
219 M_IMGDATA
->m_ok
= true;
220 M_IMGDATA
->m_static
= static_data
;
225 bool wxImage::Create( int width
, int height
, unsigned char* data
, unsigned char* alpha
, bool static_data
)
229 wxCHECK_MSG( data
, false, _T("NULL data in wxImage::Create") );
231 m_refData
= new wxImageRefData();
233 M_IMGDATA
->m_data
= data
;
234 M_IMGDATA
->m_alpha
= alpha
;
235 M_IMGDATA
->m_width
= width
;
236 M_IMGDATA
->m_height
= height
;
237 M_IMGDATA
->m_ok
= true;
238 M_IMGDATA
->m_static
= static_data
;
243 void wxImage::Destroy()
248 wxObjectRefData
* wxImage::CreateRefData() const
250 return new wxImageRefData
;
253 wxObjectRefData
* wxImage::CloneRefData(const wxObjectRefData
* that
) const
255 const wxImageRefData
* refData
= static_cast<const wxImageRefData
*>(that
);
256 wxCHECK_MSG(refData
->m_ok
, NULL
, wxT("invalid image") );
258 wxImageRefData
* refData_new
= new wxImageRefData
;
259 refData_new
->m_width
= refData
->m_width
;
260 refData_new
->m_height
= refData
->m_height
;
261 refData_new
->m_maskRed
= refData
->m_maskRed
;
262 refData_new
->m_maskGreen
= refData
->m_maskGreen
;
263 refData_new
->m_maskBlue
= refData
->m_maskBlue
;
264 refData_new
->m_hasMask
= refData
->m_hasMask
;
265 refData_new
->m_ok
= true;
266 unsigned size
= unsigned(refData
->m_width
) * unsigned(refData
->m_height
);
267 if (refData
->m_alpha
!= NULL
)
269 refData_new
->m_alpha
= (unsigned char*)malloc(size
);
270 memcpy(refData_new
->m_alpha
, refData
->m_alpha
, size
);
273 refData_new
->m_data
= (unsigned char*)malloc(size
);
274 memcpy(refData_new
->m_data
, refData
->m_data
, size
);
276 refData_new
->m_palette
= refData
->m_palette
;
278 refData_new
->m_optionNames
= refData
->m_optionNames
;
279 refData_new
->m_optionValues
= refData
->m_optionValues
;
283 wxImage
wxImage::Copy() const
287 wxCHECK_MSG( Ok(), image
, wxT("invalid image") );
289 image
.m_refData
= CloneRefData(m_refData
);
294 wxImage
wxImage::ShrinkBy( int xFactor
, int yFactor
) const
296 if( xFactor
== 1 && yFactor
== 1 )
301 wxCHECK_MSG( Ok(), image
, wxT("invalid image") );
303 // can't scale to/from 0 size
304 wxCHECK_MSG( (xFactor
> 0) && (yFactor
> 0), image
,
305 wxT("invalid new image size") );
307 long old_height
= M_IMGDATA
->m_height
,
308 old_width
= M_IMGDATA
->m_width
;
310 wxCHECK_MSG( (old_height
> 0) && (old_width
> 0), image
,
311 wxT("invalid old image size") );
313 long width
= old_width
/ xFactor
;
314 long height
= old_height
/ yFactor
;
316 image
.Create( width
, height
, false );
318 char unsigned *data
= image
.GetData();
320 wxCHECK_MSG( data
, image
, wxT("unable to create image") );
322 bool hasMask
= false ;
323 unsigned char maskRed
= 0;
324 unsigned char maskGreen
= 0;
325 unsigned char maskBlue
=0 ;
327 unsigned char *source_data
= M_IMGDATA
->m_data
;
328 unsigned char *target_data
= data
;
329 unsigned char *source_alpha
= 0 ;
330 unsigned char *target_alpha
= 0 ;
331 if (M_IMGDATA
->m_hasMask
)
334 maskRed
= M_IMGDATA
->m_maskRed
;
335 maskGreen
= M_IMGDATA
->m_maskGreen
;
336 maskBlue
=M_IMGDATA
->m_maskBlue
;
338 image
.SetMaskColour( M_IMGDATA
->m_maskRed
,
339 M_IMGDATA
->m_maskGreen
,
340 M_IMGDATA
->m_maskBlue
);
344 source_alpha
= M_IMGDATA
->m_alpha
;
348 target_alpha
= image
.GetAlpha() ;
352 for (long y
= 0; y
< height
; y
++)
354 for (long x
= 0; x
< width
; x
++)
356 unsigned long avgRed
= 0 ;
357 unsigned long avgGreen
= 0;
358 unsigned long avgBlue
= 0;
359 unsigned long avgAlpha
= 0 ;
360 unsigned long counter
= 0 ;
362 for ( int y1
= 0 ; y1
< yFactor
; ++y1
)
364 long y_offset
= (y
* yFactor
+ y1
) * old_width
;
365 for ( int x1
= 0 ; x1
< xFactor
; ++x1
)
367 unsigned char *pixel
= source_data
+ 3 * ( y_offset
+ x
* xFactor
+ x1
) ;
368 unsigned char red
= pixel
[0] ;
369 unsigned char green
= pixel
[1] ;
370 unsigned char blue
= pixel
[2] ;
371 unsigned char alpha
= 255 ;
373 alpha
= *(source_alpha
+ y_offset
+ x
* xFactor
+ x1
) ;
374 if ( !hasMask
|| red
!= maskRed
|| green
!= maskGreen
|| blue
!= maskBlue
)
389 *(target_data
++) = M_IMGDATA
->m_maskRed
;
390 *(target_data
++) = M_IMGDATA
->m_maskGreen
;
391 *(target_data
++) = M_IMGDATA
->m_maskBlue
;
396 *(target_alpha
++) = (unsigned char)(avgAlpha
/ counter
) ;
397 *(target_data
++) = (unsigned char)(avgRed
/ counter
);
398 *(target_data
++) = (unsigned char)(avgGreen
/ counter
);
399 *(target_data
++) = (unsigned char)(avgBlue
/ counter
);
404 // In case this is a cursor, make sure the hotspot is scaled accordingly:
405 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_X
) )
406 image
.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X
,
407 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_X
))/xFactor
);
408 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y
) )
409 image
.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y
,
410 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_Y
))/yFactor
);
415 wxImage
wxImage::Scale( int width
, int height
, int quality
) const
419 wxCHECK_MSG( Ok(), image
, wxT("invalid image") );
421 // can't scale to/from 0 size
422 wxCHECK_MSG( (width
> 0) && (height
> 0), image
,
423 wxT("invalid new image size") );
425 long old_height
= M_IMGDATA
->m_height
,
426 old_width
= M_IMGDATA
->m_width
;
427 wxCHECK_MSG( (old_height
> 0) && (old_width
> 0), image
,
428 wxT("invalid old image size") );
430 // If the image's new width and height are the same as the original, no
431 // need to waste time or CPU cycles
432 if ( old_width
== width
&& old_height
== height
)
435 // Scale the image (...or more appropriately, resample the image) using
436 // either the high-quality or normal method as specified
437 if ( quality
== wxIMAGE_QUALITY_HIGH
)
439 // We need to check whether we are downsampling or upsampling the image
440 if ( width
< old_width
&& height
< old_height
)
442 // Downsample the image using the box averaging method for best results
443 image
= ResampleBox(width
, height
);
447 // For upsampling or other random/wierd image dimensions we'll use
448 // a bicubic b-spline scaling method
449 image
= ResampleBicubic(width
, height
);
452 else // Default scaling method == simple pixel replication
454 if ( old_width
% width
== 0 && old_width
>= width
&&
455 old_height
% height
== 0 && old_height
>= height
)
457 return ShrinkBy( old_width
/ width
, old_height
/ height
) ;
459 image
.Create( width
, height
, false );
461 unsigned char *data
= image
.GetData();
463 wxCHECK_MSG( data
, image
, wxT("unable to create image") );
465 unsigned char *source_data
= M_IMGDATA
->m_data
;
466 unsigned char *target_data
= data
;
467 unsigned char *source_alpha
= 0 ;
468 unsigned char *target_alpha
= 0 ;
470 if ( !M_IMGDATA
->m_hasMask
)
472 source_alpha
= M_IMGDATA
->m_alpha
;
476 target_alpha
= image
.GetAlpha() ;
480 long x_delta
= (old_width
<<16) / width
;
481 long y_delta
= (old_height
<<16) / height
;
483 unsigned char* dest_pixel
= target_data
;
486 for ( long j
= 0; j
< height
; j
++ )
488 unsigned char* src_line
= &source_data
[(y
>>16)*old_width
*3];
489 unsigned char* src_alpha_line
= source_alpha
? &source_alpha
[(y
>>16)*old_width
] : 0 ;
492 for ( long i
= 0; i
< width
; i
++ )
494 unsigned char* src_pixel
= &src_line
[(x
>>16)*3];
495 unsigned char* src_alpha_pixel
= source_alpha
? &src_alpha_line
[(x
>>16)] : 0 ;
496 dest_pixel
[0] = src_pixel
[0];
497 dest_pixel
[1] = src_pixel
[1];
498 dest_pixel
[2] = src_pixel
[2];
501 *(target_alpha
++) = *src_alpha_pixel
;
509 // If the original image has a mask, apply the mask to the new image
510 if (M_IMGDATA
->m_hasMask
)
512 image
.SetMaskColour( M_IMGDATA
->m_maskRed
,
513 M_IMGDATA
->m_maskGreen
,
514 M_IMGDATA
->m_maskBlue
);
517 // In case this is a cursor, make sure the hotspot is scaled accordingly:
518 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_X
) )
519 image
.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X
,
520 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_X
)*width
)/old_width
);
521 if ( HasOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y
) )
522 image
.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y
,
523 (GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_Y
)*height
)/old_height
);
528 wxImage
wxImage::ResampleBox(int width
, int height
) const
530 // This function implements a simple pre-blur/box averaging method for
531 // downsampling that gives reasonably smooth results To scale the image
532 // down we will need to gather a grid of pixels of the size of the scale
533 // factor in each direction and then do an averaging of the pixels.
535 wxImage
ret_image(width
, height
, false);
537 const double scale_factor_x
= double(M_IMGDATA
->m_width
) / width
;
538 const double scale_factor_y
= double(M_IMGDATA
->m_height
) / height
;
540 const int scale_factor_x_2
= (int)(scale_factor_x
/ 2);
541 const int scale_factor_y_2
= (int)(scale_factor_y
/ 2);
543 unsigned char* src_data
= M_IMGDATA
->m_data
;
544 unsigned char* src_alpha
= M_IMGDATA
->m_alpha
;
545 unsigned char* dst_data
= ret_image
.GetData();
546 unsigned char* dst_alpha
= NULL
;
550 ret_image
.SetAlpha();
551 dst_alpha
= ret_image
.GetAlpha();
554 int averaged_pixels
, src_pixel_index
;
555 double sum_r
, sum_g
, sum_b
, sum_a
;
557 for ( int y
= 0; y
< height
; y
++ ) // Destination image - Y direction
559 // Source pixel in the Y direction
560 int src_y
= (int)(y
* scale_factor_y
);
562 for ( int x
= 0; x
< width
; x
++ ) // Destination image - X direction
564 // Source pixel in the X direction
565 int src_x
= (int)(x
* scale_factor_x
);
567 // Box of pixels to average
569 sum_r
= sum_g
= sum_b
= sum_a
= 0.0;
571 for ( int j
= int(src_y
- scale_factor_y
/2.0 + 1);
572 j
<= int(src_y
+ scale_factor_y_2
);
575 // We don't care to average pixels that don't exist (edges)
576 if ( j
< 0 || j
> M_IMGDATA
->m_height
- 1 )
579 for ( int i
= int(src_x
- scale_factor_x
/2.0 + 1);
580 i
<= src_x
+ scale_factor_x_2
;
583 // Don't average edge pixels
584 if ( i
< 0 || i
> M_IMGDATA
->m_width
- 1 )
587 // Calculate the actual index in our source pixels
588 src_pixel_index
= j
* M_IMGDATA
->m_width
+ i
;
590 sum_r
+= src_data
[src_pixel_index
* 3 + 0];
591 sum_g
+= src_data
[src_pixel_index
* 3 + 1];
592 sum_b
+= src_data
[src_pixel_index
* 3 + 2];
594 sum_a
+= src_alpha
[src_pixel_index
];
600 // Calculate the average from the sum and number of averaged pixels
601 dst_data
[0] = (unsigned char)(sum_r
/ averaged_pixels
);
602 dst_data
[1] = (unsigned char)(sum_g
/ averaged_pixels
);
603 dst_data
[2] = (unsigned char)(sum_b
/ averaged_pixels
);
606 *dst_alpha
++ = (unsigned char)(sum_a
/ averaged_pixels
);
613 // The following two local functions are for the B-spline weighting of the
614 // bicubic sampling algorithm
615 static inline double spline_cube(double value
)
617 return value
<= 0.0 ? 0.0 : value
* value
* value
;
620 static inline double spline_weight(double value
)
622 return (spline_cube(value
+ 2) -
623 4 * spline_cube(value
+ 1) +
624 6 * spline_cube(value
) -
625 4 * spline_cube(value
- 1)) / 6;
628 // This is the bicubic resampling algorithm
629 wxImage
wxImage::ResampleBicubic(int width
, int height
) const
631 // This function implements a Bicubic B-Spline algorithm for resampling.
632 // This method is certainly a little slower than wxImage's default pixel
633 // replication method, however for most reasonably sized images not being
634 // upsampled too much on a fairly average CPU this difference is hardly
635 // noticeable and the results are far more pleasing to look at.
637 // This particular bicubic algorithm does pixel weighting according to a
638 // B-Spline that basically implements a Gaussian bell-like weighting
639 // kernel. Because of this method the results may appear a bit blurry when
640 // upsampling by large factors. This is basically because a slight
641 // gaussian blur is being performed to get the smooth look of the upsampled
644 // Edge pixels: 3-4 possible solutions
645 // - (Wrap/tile) Wrap the image, take the color value from the opposite
646 // side of the image.
647 // - (Mirror) Duplicate edge pixels, so that pixel at coordinate (2, n),
648 // where n is nonpositive, will have the value of (2, 1).
649 // - (Ignore) Simply ignore the edge pixels and apply the kernel only to
650 // pixels which do have all neighbours.
651 // - (Clamp) Choose the nearest pixel along the border. This takes the
652 // border pixels and extends them out to infinity.
654 // NOTE: below the y_offset and x_offset variables are being set for edge
655 // pixels using the "Mirror" method mentioned above
659 ret_image
.Create(width
, height
, false);
661 unsigned char* src_data
= M_IMGDATA
->m_data
;
662 unsigned char* src_alpha
= M_IMGDATA
->m_alpha
;
663 unsigned char* dst_data
= ret_image
.GetData();
664 unsigned char* dst_alpha
= NULL
;
668 ret_image
.SetAlpha();
669 dst_alpha
= ret_image
.GetAlpha();
672 for ( int dsty
= 0; dsty
< height
; dsty
++ )
674 // We need to calculate the source pixel to interpolate from - Y-axis
675 double srcpixy
= double(dsty
* M_IMGDATA
->m_height
) / height
;
676 double dy
= srcpixy
- (int)srcpixy
;
678 for ( int dstx
= 0; dstx
< width
; dstx
++ )
680 // X-axis of pixel to interpolate from
681 double srcpixx
= double(dstx
* M_IMGDATA
->m_width
) / width
;
682 double dx
= srcpixx
- (int)srcpixx
;
684 // Sums for each color channel
685 double sum_r
= 0, sum_g
= 0, sum_b
= 0, sum_a
= 0;
687 // Here we actually determine the RGBA values for the destination pixel
688 for ( int k
= -1; k
<= 2; k
++ )
691 int y_offset
= srcpixy
+ k
< 0.0
693 : srcpixy
+ k
>= M_IMGDATA
->m_height
694 ? M_IMGDATA
->m_height
- 1
695 : (int)(srcpixy
+ k
);
697 // Loop across the X axis
698 for ( int i
= -1; i
<= 2; i
++ )
701 int x_offset
= srcpixx
+ i
< 0.0
703 : srcpixx
+ i
>= M_IMGDATA
->m_width
704 ? M_IMGDATA
->m_width
- 1
705 : (int)(srcpixx
+ i
);
707 // Calculate the exact position where the source data
708 // should be pulled from based on the x_offset and y_offset
709 int src_pixel_index
= y_offset
*M_IMGDATA
->m_width
+ x_offset
;
711 // Calculate the weight for the specified pixel according
712 // to the bicubic b-spline kernel we're using for
715 pixel_weight
= spline_weight(i
- dx
)*spline_weight(k
- dy
);
717 // Create a sum of all velues for each color channel
718 // adjusted for the pixel's calculated weight
719 sum_r
+= src_data
[src_pixel_index
* 3 + 0] * pixel_weight
;
720 sum_g
+= src_data
[src_pixel_index
* 3 + 1] * pixel_weight
;
721 sum_b
+= src_data
[src_pixel_index
* 3 + 2] * pixel_weight
;
723 sum_a
+= src_alpha
[src_pixel_index
] * pixel_weight
;
727 // Put the data into the destination image. The summed values are
728 // of double data type and are rounded here for accuracy
729 dst_data
[0] = (unsigned char)(sum_r
+ 0.5);
730 dst_data
[1] = (unsigned char)(sum_g
+ 0.5);
731 dst_data
[2] = (unsigned char)(sum_b
+ 0.5);
735 *dst_alpha
++ = (unsigned char)sum_a
;
742 // Blur in the horizontal direction
743 wxImage
wxImage::BlurHorizontal(int blurRadius
) const
746 ret_image
.Create(M_IMGDATA
->m_width
, M_IMGDATA
->m_height
, false);
748 unsigned char* src_data
= M_IMGDATA
->m_data
;
749 unsigned char* dst_data
= ret_image
.GetData();
750 unsigned char* src_alpha
= M_IMGDATA
->m_alpha
;
751 unsigned char* dst_alpha
= NULL
;
753 // Check for a mask or alpha
756 ret_image
.SetAlpha();
757 dst_alpha
= ret_image
.GetAlpha();
759 else if ( M_IMGDATA
->m_hasMask
)
761 ret_image
.SetMaskColour(M_IMGDATA
->m_maskRed
,
762 M_IMGDATA
->m_maskGreen
,
763 M_IMGDATA
->m_maskBlue
);
766 // number of pixels we average over
767 const int blurArea
= blurRadius
*2 + 1;
769 // Horizontal blurring algorithm - average all pixels in the specified blur
770 // radius in the X or horizontal direction
771 for ( int y
= 0; y
< M_IMGDATA
->m_height
; y
++ )
773 // Variables used in the blurring algorithm
780 const unsigned char *src
;
783 // Calculate the average of all pixels in the blur radius for the first
785 for ( int kernel_x
= -blurRadius
; kernel_x
<= blurRadius
; kernel_x
++ )
787 // To deal with the pixels at the start of a row so it's not
788 // grabbing GOK values from memory at negative indices of the
789 // image's data or grabbing from the previous row
791 pixel_idx
= y
* M_IMGDATA
->m_width
;
793 pixel_idx
= kernel_x
+ y
* M_IMGDATA
->m_width
;
795 src
= src_data
+ pixel_idx
*3;
800 sum_a
+= src_alpha
[pixel_idx
];
803 dst
= dst_data
+ y
* M_IMGDATA
->m_width
*3;
804 dst
[0] = (unsigned char)(sum_r
/ blurArea
);
805 dst
[1] = (unsigned char)(sum_g
/ blurArea
);
806 dst
[2] = (unsigned char)(sum_b
/ blurArea
);
808 dst_alpha
[y
* M_IMGDATA
->m_width
] = (unsigned char)(sum_a
/ blurArea
);
810 // Now average the values of the rest of the pixels by just moving the
811 // blur radius box along the row
812 for ( int x
= 1; x
< M_IMGDATA
->m_width
; x
++ )
814 // Take care of edge pixels on the left edge by essentially
815 // duplicating the edge pixel
816 if ( x
- blurRadius
- 1 < 0 )
817 pixel_idx
= y
* M_IMGDATA
->m_width
;
819 pixel_idx
= (x
- blurRadius
- 1) + y
* M_IMGDATA
->m_width
;
821 // Subtract the value of the pixel at the left side of the blur
823 src
= src_data
+ pixel_idx
*3;
828 sum_a
-= src_alpha
[pixel_idx
];
830 // Take care of edge pixels on the right edge
831 if ( x
+ blurRadius
> M_IMGDATA
->m_width
- 1 )
832 pixel_idx
= M_IMGDATA
->m_width
- 1 + y
* M_IMGDATA
->m_width
;
834 pixel_idx
= x
+ blurRadius
+ y
* M_IMGDATA
->m_width
;
836 // Add the value of the pixel being added to the end of our box
837 src
= src_data
+ pixel_idx
*3;
842 sum_a
+= src_alpha
[pixel_idx
];
844 // Save off the averaged data
845 dst
= dst_data
+ x
*3 + y
*M_IMGDATA
->m_width
*3;
846 dst
[0] = (unsigned char)(sum_r
/ blurArea
);
847 dst
[1] = (unsigned char)(sum_g
/ blurArea
);
848 dst
[2] = (unsigned char)(sum_b
/ blurArea
);
850 dst_alpha
[x
+ y
* M_IMGDATA
->m_width
] = (unsigned char)(sum_a
/ blurArea
);
857 // Blur in the vertical direction
858 wxImage
wxImage::BlurVertical(int blurRadius
) const
861 ret_image
.Create(M_IMGDATA
->m_width
, M_IMGDATA
->m_height
, false);
863 unsigned char* src_data
= M_IMGDATA
->m_data
;
864 unsigned char* dst_data
= ret_image
.GetData();
865 unsigned char* src_alpha
= M_IMGDATA
->m_alpha
;
866 unsigned char* dst_alpha
= NULL
;
868 // Check for a mask or alpha
871 ret_image
.SetAlpha();
872 dst_alpha
= ret_image
.GetAlpha();
874 else if ( M_IMGDATA
->m_hasMask
)
876 ret_image
.SetMaskColour(M_IMGDATA
->m_maskRed
,
877 M_IMGDATA
->m_maskGreen
,
878 M_IMGDATA
->m_maskBlue
);
881 // number of pixels we average over
882 const int blurArea
= blurRadius
*2 + 1;
884 // Vertical blurring algorithm - same as horizontal but switched the
885 // opposite direction
886 for ( int x
= 0; x
< M_IMGDATA
->m_width
; x
++ )
888 // Variables used in the blurring algorithm
895 const unsigned char *src
;
898 // Calculate the average of all pixels in our blur radius box for the
899 // first pixel of the column
900 for ( int kernel_y
= -blurRadius
; kernel_y
<= blurRadius
; kernel_y
++ )
902 // To deal with the pixels at the start of a column so it's not
903 // grabbing GOK values from memory at negative indices of the
904 // image's data or grabbing from the previous column
908 pixel_idx
= x
+ kernel_y
* M_IMGDATA
->m_width
;
910 src
= src_data
+ pixel_idx
*3;
915 sum_a
+= src_alpha
[pixel_idx
];
918 dst
= dst_data
+ x
*3;
919 dst
[0] = (unsigned char)(sum_r
/ blurArea
);
920 dst
[1] = (unsigned char)(sum_g
/ blurArea
);
921 dst
[2] = (unsigned char)(sum_b
/ blurArea
);
923 dst_alpha
[x
] = (unsigned char)(sum_a
/ blurArea
);
925 // Now average the values of the rest of the pixels by just moving the
926 // box along the column from top to bottom
927 for ( int y
= 1; y
< M_IMGDATA
->m_height
; y
++ )
929 // Take care of pixels that would be beyond the top edge by
930 // duplicating the top edge pixel for the column
931 if ( y
- blurRadius
- 1 < 0 )
934 pixel_idx
= x
+ (y
- blurRadius
- 1) * M_IMGDATA
->m_width
;
936 // Subtract the value of the pixel at the top of our blur radius box
937 src
= src_data
+ pixel_idx
*3;
942 sum_a
-= src_alpha
[pixel_idx
];
944 // Take care of the pixels that would be beyond the bottom edge of
945 // the image similar to the top edge
946 if ( y
+ blurRadius
> M_IMGDATA
->m_height
- 1 )
947 pixel_idx
= x
+ (M_IMGDATA
->m_height
- 1) * M_IMGDATA
->m_width
;
949 pixel_idx
= x
+ (blurRadius
+ y
) * M_IMGDATA
->m_width
;
951 // Add the value of the pixel being added to the end of our box
952 src
= src_data
+ pixel_idx
*3;
957 sum_a
+= src_alpha
[pixel_idx
];
959 // Save off the averaged data
960 dst
= dst_data
+ (x
+ y
* M_IMGDATA
->m_width
) * 3;
961 dst
[0] = (unsigned char)(sum_r
/ blurArea
);
962 dst
[1] = (unsigned char)(sum_g
/ blurArea
);
963 dst
[2] = (unsigned char)(sum_b
/ blurArea
);
965 dst_alpha
[x
+ y
* M_IMGDATA
->m_width
] = (unsigned char)(sum_a
/ blurArea
);
972 // The new blur function
973 wxImage
wxImage::Blur(int blurRadius
) const
976 ret_image
.Create(M_IMGDATA
->m_width
, M_IMGDATA
->m_height
, false);
978 // Blur the image in each direction
979 ret_image
= BlurHorizontal(blurRadius
);
980 ret_image
= ret_image
.BlurVertical(blurRadius
);
985 wxImage
wxImage::Rotate90( bool clockwise
) const
989 wxCHECK_MSG( Ok(), image
, wxT("invalid image") );
991 image
.Create( M_IMGDATA
->m_height
, M_IMGDATA
->m_width
, false );
993 unsigned char *data
= image
.GetData();
995 wxCHECK_MSG( data
, image
, wxT("unable to create image") );
997 unsigned char *source_data
= M_IMGDATA
->m_data
;
998 unsigned char *target_data
;
999 unsigned char *alpha_data
= 0 ;
1000 unsigned char *source_alpha
= 0 ;
1001 unsigned char *target_alpha
= 0 ;
1003 if (M_IMGDATA
->m_hasMask
)
1005 image
.SetMaskColour( M_IMGDATA
->m_maskRed
, M_IMGDATA
->m_maskGreen
, M_IMGDATA
->m_maskBlue
);
1009 source_alpha
= M_IMGDATA
->m_alpha
;
1013 alpha_data
= image
.GetAlpha() ;
1017 long height
= M_IMGDATA
->m_height
;
1018 long width
= M_IMGDATA
->m_width
;
1020 for (long j
= 0; j
< height
; j
++)
1022 for (long i
= 0; i
< width
; i
++)
1026 target_data
= data
+ (((i
+1)*height
) - j
- 1)*3;
1028 target_alpha
= alpha_data
+ (((i
+1)*height
) - j
- 1);
1032 target_data
= data
+ ((height
*(width
-1)) + j
- (i
*height
))*3;
1034 target_alpha
= alpha_data
+ ((height
*(width
-1)) + j
- (i
*height
));
1036 memcpy( target_data
, source_data
, 3 );
1041 memcpy( target_alpha
, source_alpha
, 1 );
1050 wxImage
wxImage::Mirror( bool horizontally
) const
1054 wxCHECK_MSG( Ok(), image
, wxT("invalid image") );
1056 image
.Create( M_IMGDATA
->m_width
, M_IMGDATA
->m_height
, false );
1058 unsigned char *data
= image
.GetData();
1059 unsigned char *alpha
= NULL
;
1061 wxCHECK_MSG( data
, image
, wxT("unable to create image") );
1063 if (M_IMGDATA
->m_alpha
!= NULL
) {
1065 alpha
= image
.GetAlpha();
1066 wxCHECK_MSG( alpha
, image
, wxT("unable to create alpha channel") );
1069 if (M_IMGDATA
->m_hasMask
)
1070 image
.SetMaskColour( M_IMGDATA
->m_maskRed
, M_IMGDATA
->m_maskGreen
, M_IMGDATA
->m_maskBlue
);
1072 long height
= M_IMGDATA
->m_height
;
1073 long width
= M_IMGDATA
->m_width
;
1075 unsigned char *source_data
= M_IMGDATA
->m_data
;
1076 unsigned char *target_data
;
1080 for (long j
= 0; j
< height
; j
++)
1083 target_data
= data
-3;
1084 for (long i
= 0; i
< width
; i
++)
1086 memcpy( target_data
, source_data
, 3 );
1094 // src_alpha starts at the first pixel and increases by 1 after each step
1095 // (a step here is the copy of the alpha value of one pixel)
1096 const unsigned char *src_alpha
= M_IMGDATA
->m_alpha
;
1097 // dest_alpha starts just beyond the first line, decreases before each step,
1098 // and after each line is finished, increases by 2 widths (skipping the line
1099 // just copied and the line that will be copied next)
1100 unsigned char *dest_alpha
= alpha
+ width
;
1102 for (long jj
= 0; jj
< height
; ++jj
)
1104 for (long i
= 0; i
< width
; ++i
) {
1105 *(--dest_alpha
) = *(src_alpha
++); // copy one pixel
1107 dest_alpha
+= 2 * width
; // advance beyond the end of the next line
1113 for (long i
= 0; i
< height
; i
++)
1115 target_data
= data
+ 3*width
*(height
-1-i
);
1116 memcpy( target_data
, source_data
, (size_t)3*width
);
1117 source_data
+= 3*width
;
1122 // src_alpha starts at the first pixel and increases by 1 width after each step
1123 // (a step here is the copy of the alpha channel of an entire line)
1124 const unsigned char *src_alpha
= M_IMGDATA
->m_alpha
;
1125 // dest_alpha starts just beyond the last line (beyond the whole image)
1126 // and decreases by 1 width before each step
1127 unsigned char *dest_alpha
= alpha
+ width
* height
;
1129 for (long jj
= 0; jj
< height
; ++jj
)
1131 dest_alpha
-= width
;
1132 memcpy( dest_alpha
, src_alpha
, (size_t)width
);
1141 wxImage
wxImage::GetSubImage( const wxRect
&rect
) const
1145 wxCHECK_MSG( Ok(), image
, wxT("invalid image") );
1147 wxCHECK_MSG( (rect
.GetLeft()>=0) && (rect
.GetTop()>=0) &&
1148 (rect
.GetRight()<=GetWidth()) && (rect
.GetBottom()<=GetHeight()),
1149 image
, wxT("invalid subimage size") );
1151 const int subwidth
= rect
.GetWidth();
1152 const int subheight
= rect
.GetHeight();
1154 image
.Create( subwidth
, subheight
, false );
1156 const unsigned char *src_data
= GetData();
1157 const unsigned char *src_alpha
= M_IMGDATA
->m_alpha
;
1158 unsigned char *subdata
= image
.GetData();
1159 unsigned char *subalpha
= NULL
;
1161 wxCHECK_MSG( subdata
, image
, wxT("unable to create image") );
1163 if (src_alpha
!= NULL
) {
1165 subalpha
= image
.GetAlpha();
1166 wxCHECK_MSG( subalpha
, image
, wxT("unable to create alpha channel"));
1169 if (M_IMGDATA
->m_hasMask
)
1170 image
.SetMaskColour( M_IMGDATA
->m_maskRed
, M_IMGDATA
->m_maskGreen
, M_IMGDATA
->m_maskBlue
);
1172 const int width
= GetWidth();
1173 const int pixsoff
= rect
.GetLeft() + width
* rect
.GetTop();
1175 src_data
+= 3 * pixsoff
;
1176 src_alpha
+= pixsoff
; // won't be used if was NULL, so this is ok
1178 for (long j
= 0; j
< subheight
; ++j
)
1180 memcpy( subdata
, src_data
, 3 * subwidth
);
1181 subdata
+= 3 * subwidth
;
1182 src_data
+= 3 * width
;
1183 if (subalpha
!= NULL
) {
1184 memcpy( subalpha
, src_alpha
, subwidth
);
1185 subalpha
+= subwidth
;
1193 wxImage
wxImage::Size( const wxSize
& size
, const wxPoint
& pos
,
1194 int r_
, int g_
, int b_
) const
1198 wxCHECK_MSG( Ok(), image
, wxT("invalid image") );
1199 wxCHECK_MSG( (size
.GetWidth() > 0) && (size
.GetHeight() > 0), image
, wxT("invalid size") );
1201 int width
= GetWidth(), height
= GetHeight();
1202 image
.Create(size
.GetWidth(), size
.GetHeight(), false);
1204 unsigned char r
= (unsigned char)r_
;
1205 unsigned char g
= (unsigned char)g_
;
1206 unsigned char b
= (unsigned char)b_
;
1207 if ((r_
== -1) && (g_
== -1) && (b_
== -1))
1209 GetOrFindMaskColour( &r
, &g
, &b
);
1210 image
.SetMaskColour(r
, g
, b
);
1213 image
.SetRGB(wxRect(), r
, g
, b
);
1215 wxRect
subRect(pos
.x
, pos
.y
, width
, height
);
1216 wxRect
finalRect(0, 0, size
.GetWidth(), size
.GetHeight());
1218 finalRect
.width
-= pos
.x
;
1220 finalRect
.height
-= pos
.y
;
1222 subRect
.Intersect(finalRect
);
1224 if (!subRect
.IsEmpty())
1226 if ((subRect
.GetWidth() == width
) && (subRect
.GetHeight() == height
))
1227 image
.Paste(*this, pos
.x
, pos
.y
);
1229 image
.Paste(GetSubImage(subRect
), pos
.x
, pos
.y
);
1235 void wxImage::Paste( const wxImage
&image
, int x
, int y
)
1237 wxCHECK_RET( Ok(), wxT("invalid image") );
1238 wxCHECK_RET( image
.Ok(), wxT("invalid image") );
1244 int width
= image
.GetWidth();
1245 int height
= image
.GetHeight();
1258 if ((x
+xx
)+width
> M_IMGDATA
->m_width
)
1259 width
= M_IMGDATA
->m_width
- (x
+xx
);
1260 if ((y
+yy
)+height
> M_IMGDATA
->m_height
)
1261 height
= M_IMGDATA
->m_height
- (y
+yy
);
1263 if (width
< 1) return;
1264 if (height
< 1) return;
1266 if ((!HasMask() && !image
.HasMask()) ||
1267 (HasMask() && !image
.HasMask()) ||
1268 ((HasMask() && image
.HasMask() &&
1269 (GetMaskRed()==image
.GetMaskRed()) &&
1270 (GetMaskGreen()==image
.GetMaskGreen()) &&
1271 (GetMaskBlue()==image
.GetMaskBlue()))))
1273 unsigned char* source_data
= image
.GetData() + xx
*3 + yy
*3*image
.GetWidth();
1274 int source_step
= image
.GetWidth()*3;
1276 unsigned char* target_data
= GetData() + (x
+xx
)*3 + (y
+yy
)*3*M_IMGDATA
->m_width
;
1277 int target_step
= M_IMGDATA
->m_width
*3;
1278 for (int j
= 0; j
< height
; j
++)
1280 memcpy( target_data
, source_data
, width
*3 );
1281 source_data
+= source_step
;
1282 target_data
+= target_step
;
1286 // Copy over the alpha channel from the original image
1287 if ( image
.HasAlpha() )
1292 unsigned char* source_data
= image
.GetAlpha() + xx
+ yy
*image
.GetWidth();
1293 int source_step
= image
.GetWidth();
1295 unsigned char* target_data
= GetAlpha() + (x
+xx
) + (y
+yy
)*M_IMGDATA
->m_width
;
1296 int target_step
= M_IMGDATA
->m_width
;
1298 for (int j
= 0; j
< height
; j
++,
1299 source_data
+= source_step
,
1300 target_data
+= target_step
)
1302 memcpy( target_data
, source_data
, width
);
1306 if (!HasMask() && image
.HasMask())
1308 unsigned char r
= image
.GetMaskRed();
1309 unsigned char g
= image
.GetMaskGreen();
1310 unsigned char b
= image
.GetMaskBlue();
1312 unsigned char* source_data
= image
.GetData() + xx
*3 + yy
*3*image
.GetWidth();
1313 int source_step
= image
.GetWidth()*3;
1315 unsigned char* target_data
= GetData() + (x
+xx
)*3 + (y
+yy
)*3*M_IMGDATA
->m_width
;
1316 int target_step
= M_IMGDATA
->m_width
*3;
1318 for (int j
= 0; j
< height
; j
++)
1320 for (int i
= 0; i
< width
*3; i
+=3)
1322 if ((source_data
[i
] != r
) ||
1323 (source_data
[i
+1] != g
) ||
1324 (source_data
[i
+2] != b
))
1326 memcpy( target_data
+i
, source_data
+i
, 3 );
1329 source_data
+= source_step
;
1330 target_data
+= target_step
;
1335 void wxImage::Replace( unsigned char r1
, unsigned char g1
, unsigned char b1
,
1336 unsigned char r2
, unsigned char g2
, unsigned char b2
)
1338 wxCHECK_RET( Ok(), wxT("invalid image") );
1342 unsigned char *data
= GetData();
1344 const int w
= GetWidth();
1345 const int h
= GetHeight();
1347 for (int j
= 0; j
< h
; j
++)
1348 for (int i
= 0; i
< w
; i
++)
1350 if ((data
[0] == r1
) && (data
[1] == g1
) && (data
[2] == b1
))
1360 wxImage
wxImage::ConvertToGreyscale( double lr
, double lg
, double lb
) const
1364 wxCHECK_MSG( Ok(), image
, wxT("invalid image") );
1366 image
.Create(M_IMGDATA
->m_width
, M_IMGDATA
->m_height
, false);
1368 unsigned char *dest
= image
.GetData();
1370 wxCHECK_MSG( dest
, image
, wxT("unable to create image") );
1372 unsigned char *src
= M_IMGDATA
->m_data
;
1373 bool hasMask
= M_IMGDATA
->m_hasMask
;
1374 unsigned char maskRed
= M_IMGDATA
->m_maskRed
;
1375 unsigned char maskGreen
= M_IMGDATA
->m_maskGreen
;
1376 unsigned char maskBlue
= M_IMGDATA
->m_maskBlue
;
1379 image
.SetMaskColour(maskRed
, maskGreen
, maskBlue
);
1381 const long size
= M_IMGDATA
->m_width
* M_IMGDATA
->m_height
;
1382 for ( long i
= 0; i
< size
; i
++, src
+= 3, dest
+= 3 )
1384 // don't modify the mask
1385 if ( hasMask
&& src
[0] == maskRed
&& src
[1] == maskGreen
&& src
[2] == maskBlue
)
1387 memcpy(dest
, src
, 3);
1391 // calculate the luma
1392 double luma
= (src
[0] * lr
+ src
[1] * lg
+ src
[2] * lb
) + 0.5;
1393 dest
[0] = dest
[1] = dest
[2] = static_cast<unsigned char>(luma
);
1397 // copy the alpha channel, if any
1400 const size_t alphaSize
= GetWidth() * GetHeight();
1401 unsigned char *alpha
= (unsigned char*)malloc(alphaSize
);
1402 memcpy(alpha
, GetAlpha(), alphaSize
);
1404 image
.SetAlpha(alpha
);
1410 wxImage
wxImage::ConvertToMono( unsigned char r
, unsigned char g
, unsigned char b
) const
1414 wxCHECK_MSG( Ok(), image
, wxT("invalid image") );
1416 image
.Create( M_IMGDATA
->m_width
, M_IMGDATA
->m_height
, false );
1418 unsigned char *data
= image
.GetData();
1420 wxCHECK_MSG( data
, image
, wxT("unable to create image") );
1422 if (M_IMGDATA
->m_hasMask
)
1424 if (M_IMGDATA
->m_maskRed
== r
&& M_IMGDATA
->m_maskGreen
== g
&&
1425 M_IMGDATA
->m_maskBlue
== b
)
1426 image
.SetMaskColour( 255, 255, 255 );
1428 image
.SetMaskColour( 0, 0, 0 );
1431 long size
= M_IMGDATA
->m_height
* M_IMGDATA
->m_width
;
1433 unsigned char *srcd
= M_IMGDATA
->m_data
;
1434 unsigned char *tard
= image
.GetData();
1436 for ( long i
= 0; i
< size
; i
++, srcd
+= 3, tard
+= 3 )
1438 if (srcd
[0] == r
&& srcd
[1] == g
&& srcd
[2] == b
)
1439 tard
[0] = tard
[1] = tard
[2] = 255;
1441 tard
[0] = tard
[1] = tard
[2] = 0;
1447 int wxImage::GetWidth() const
1449 wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1451 return M_IMGDATA
->m_width
;
1454 int wxImage::GetHeight() const
1456 wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1458 return M_IMGDATA
->m_height
;
1461 wxBitmapType
wxImage::GetType() const
1463 wxCHECK_MSG( IsOk(), wxBITMAP_TYPE_INVALID
, wxT("invalid image") );
1465 return M_IMGDATA
->m_type
;
1468 void wxImage::SetType(wxBitmapType type
)
1470 wxCHECK_RET( IsOk(), "must create the image before setting its type");
1472 // type can be wxBITMAP_TYPE_INVALID to reset the image type to default
1473 wxASSERT_MSG( type
!= wxBITMAP_TYPE_MAX
, "invalid bitmap type" );
1475 M_IMGDATA
->m_type
= type
;
1478 long wxImage::XYToIndex(int x
, int y
) const
1482 x
< M_IMGDATA
->m_width
&& y
< M_IMGDATA
->m_height
)
1484 return y
*M_IMGDATA
->m_width
+ x
;
1490 void wxImage::SetRGB( int x
, int y
, unsigned char r
, unsigned char g
, unsigned char b
)
1492 long pos
= XYToIndex(x
, y
);
1493 wxCHECK_RET( pos
!= -1, wxT("invalid image coordinates") );
1499 M_IMGDATA
->m_data
[ pos
] = r
;
1500 M_IMGDATA
->m_data
[ pos
+1 ] = g
;
1501 M_IMGDATA
->m_data
[ pos
+2 ] = b
;
1504 void wxImage::SetRGB( const wxRect
& rect_
, unsigned char r
, unsigned char g
, unsigned char b
)
1506 wxCHECK_RET( Ok(), wxT("invalid image") );
1511 wxRect
imageRect(0, 0, GetWidth(), GetHeight());
1512 if ( rect
== wxRect() )
1518 wxCHECK_RET( imageRect
.Contains(rect
.GetTopLeft()) &&
1519 imageRect
.Contains(rect
.GetBottomRight()),
1520 wxT("invalid bounding rectangle") );
1523 int x1
= rect
.GetLeft(),
1525 x2
= rect
.GetRight() + 1,
1526 y2
= rect
.GetBottom() + 1;
1528 unsigned char *data
wxDUMMY_INITIALIZE(NULL
);
1529 int x
, y
, width
= GetWidth();
1530 for (y
= y1
; y
< y2
; y
++)
1532 data
= M_IMGDATA
->m_data
+ (y
*width
+ x1
)*3;
1533 for (x
= x1
; x
< x2
; x
++)
1542 unsigned char wxImage::GetRed( int x
, int y
) const
1544 long pos
= XYToIndex(x
, y
);
1545 wxCHECK_MSG( pos
!= -1, 0, wxT("invalid image coordinates") );
1549 return M_IMGDATA
->m_data
[pos
];
1552 unsigned char wxImage::GetGreen( int x
, int y
) const
1554 long pos
= XYToIndex(x
, y
);
1555 wxCHECK_MSG( pos
!= -1, 0, wxT("invalid image coordinates") );
1559 return M_IMGDATA
->m_data
[pos
+1];
1562 unsigned char wxImage::GetBlue( int x
, int y
) const
1564 long pos
= XYToIndex(x
, y
);
1565 wxCHECK_MSG( pos
!= -1, 0, wxT("invalid image coordinates") );
1569 return M_IMGDATA
->m_data
[pos
+2];
1572 bool wxImage::IsOk() const
1574 // image of 0 width or height can't be considered ok - at least because it
1575 // causes crashes in ConvertToBitmap() if we don't catch it in time
1576 wxImageRefData
*data
= M_IMGDATA
;
1577 return data
&& data
->m_ok
&& data
->m_width
&& data
->m_height
;
1580 unsigned char *wxImage::GetData() const
1582 wxCHECK_MSG( Ok(), (unsigned char *)NULL
, wxT("invalid image") );
1584 return M_IMGDATA
->m_data
;
1587 void wxImage::SetData( unsigned char *data
, bool static_data
)
1589 wxCHECK_RET( Ok(), wxT("invalid image") );
1591 wxImageRefData
*newRefData
= new wxImageRefData();
1593 newRefData
->m_width
= M_IMGDATA
->m_width
;
1594 newRefData
->m_height
= M_IMGDATA
->m_height
;
1595 newRefData
->m_data
= data
;
1596 newRefData
->m_ok
= true;
1597 newRefData
->m_maskRed
= M_IMGDATA
->m_maskRed
;
1598 newRefData
->m_maskGreen
= M_IMGDATA
->m_maskGreen
;
1599 newRefData
->m_maskBlue
= M_IMGDATA
->m_maskBlue
;
1600 newRefData
->m_hasMask
= M_IMGDATA
->m_hasMask
;
1601 newRefData
->m_static
= static_data
;
1605 m_refData
= newRefData
;
1608 void wxImage::SetData( unsigned char *data
, int new_width
, int new_height
, bool static_data
)
1610 wxImageRefData
*newRefData
= new wxImageRefData();
1614 newRefData
->m_width
= new_width
;
1615 newRefData
->m_height
= new_height
;
1616 newRefData
->m_data
= data
;
1617 newRefData
->m_ok
= true;
1618 newRefData
->m_maskRed
= M_IMGDATA
->m_maskRed
;
1619 newRefData
->m_maskGreen
= M_IMGDATA
->m_maskGreen
;
1620 newRefData
->m_maskBlue
= M_IMGDATA
->m_maskBlue
;
1621 newRefData
->m_hasMask
= M_IMGDATA
->m_hasMask
;
1625 newRefData
->m_width
= new_width
;
1626 newRefData
->m_height
= new_height
;
1627 newRefData
->m_data
= data
;
1628 newRefData
->m_ok
= true;
1630 newRefData
->m_static
= static_data
;
1634 m_refData
= newRefData
;
1637 // ----------------------------------------------------------------------------
1638 // alpha channel support
1639 // ----------------------------------------------------------------------------
1641 void wxImage::SetAlpha(int x
, int y
, unsigned char alpha
)
1643 wxCHECK_RET( HasAlpha(), wxT("no alpha channel") );
1645 long pos
= XYToIndex(x
, y
);
1646 wxCHECK_RET( pos
!= -1, wxT("invalid image coordinates") );
1650 M_IMGDATA
->m_alpha
[pos
] = alpha
;
1653 unsigned char wxImage::GetAlpha(int x
, int y
) const
1655 wxCHECK_MSG( HasAlpha(), 0, wxT("no alpha channel") );
1657 long pos
= XYToIndex(x
, y
);
1658 wxCHECK_MSG( pos
!= -1, 0, wxT("invalid image coordinates") );
1660 return M_IMGDATA
->m_alpha
[pos
];
1664 wxImage::ConvertColourToAlpha(unsigned char r
, unsigned char g
, unsigned char b
)
1668 const int w
= M_IMGDATA
->m_width
;
1669 const int h
= M_IMGDATA
->m_height
;
1671 unsigned char *alpha
= GetAlpha();
1672 unsigned char *data
= GetData();
1674 for ( int y
= 0; y
< h
; y
++ )
1676 for ( int x
= 0; x
< w
; x
++ )
1688 void wxImage::SetAlpha( unsigned char *alpha
, bool static_data
)
1690 wxCHECK_RET( Ok(), wxT("invalid image") );
1696 alpha
= (unsigned char *)malloc(M_IMGDATA
->m_width
*M_IMGDATA
->m_height
);
1699 if( !M_IMGDATA
->m_staticAlpha
)
1700 free(M_IMGDATA
->m_alpha
);
1702 M_IMGDATA
->m_alpha
= alpha
;
1703 M_IMGDATA
->m_staticAlpha
= static_data
;
1706 unsigned char *wxImage::GetAlpha() const
1708 wxCHECK_MSG( Ok(), (unsigned char *)NULL
, wxT("invalid image") );
1710 return M_IMGDATA
->m_alpha
;
1713 void wxImage::InitAlpha()
1715 wxCHECK_RET( !HasAlpha(), wxT("image already has an alpha channel") );
1717 // initialize memory for alpha channel
1720 unsigned char *alpha
= M_IMGDATA
->m_alpha
;
1721 const size_t lenAlpha
= M_IMGDATA
->m_width
* M_IMGDATA
->m_height
;
1725 // use the mask to initialize the alpha channel.
1726 const unsigned char * const alphaEnd
= alpha
+ lenAlpha
;
1728 const unsigned char mr
= M_IMGDATA
->m_maskRed
;
1729 const unsigned char mg
= M_IMGDATA
->m_maskGreen
;
1730 const unsigned char mb
= M_IMGDATA
->m_maskBlue
;
1731 for ( unsigned char *src
= M_IMGDATA
->m_data
;
1735 *alpha
= (src
[0] == mr
&& src
[1] == mg
&& src
[2] == mb
)
1736 ? wxIMAGE_ALPHA_TRANSPARENT
1737 : wxIMAGE_ALPHA_OPAQUE
;
1740 M_IMGDATA
->m_hasMask
= false;
1744 // make the image fully opaque
1745 memset(alpha
, wxIMAGE_ALPHA_OPAQUE
, lenAlpha
);
1749 // ----------------------------------------------------------------------------
1751 // ----------------------------------------------------------------------------
1753 void wxImage::SetMaskColour( unsigned char r
, unsigned char g
, unsigned char b
)
1755 wxCHECK_RET( Ok(), wxT("invalid image") );
1759 M_IMGDATA
->m_maskRed
= r
;
1760 M_IMGDATA
->m_maskGreen
= g
;
1761 M_IMGDATA
->m_maskBlue
= b
;
1762 M_IMGDATA
->m_hasMask
= true;
1765 bool wxImage::GetOrFindMaskColour( unsigned char *r
, unsigned char *g
, unsigned char *b
) const
1767 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1769 if (M_IMGDATA
->m_hasMask
)
1771 if (r
) *r
= M_IMGDATA
->m_maskRed
;
1772 if (g
) *g
= M_IMGDATA
->m_maskGreen
;
1773 if (b
) *b
= M_IMGDATA
->m_maskBlue
;
1778 FindFirstUnusedColour(r
, g
, b
);
1783 unsigned char wxImage::GetMaskRed() const
1785 wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1787 return M_IMGDATA
->m_maskRed
;
1790 unsigned char wxImage::GetMaskGreen() const
1792 wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1794 return M_IMGDATA
->m_maskGreen
;
1797 unsigned char wxImage::GetMaskBlue() const
1799 wxCHECK_MSG( Ok(), 0, wxT("invalid image") );
1801 return M_IMGDATA
->m_maskBlue
;
1804 void wxImage::SetMask( bool mask
)
1806 wxCHECK_RET( Ok(), wxT("invalid image") );
1810 M_IMGDATA
->m_hasMask
= mask
;
1813 bool wxImage::HasMask() const
1815 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
1817 return M_IMGDATA
->m_hasMask
;
1820 bool wxImage::IsTransparent(int x
, int y
, unsigned char threshold
) const
1822 long pos
= XYToIndex(x
, y
);
1823 wxCHECK_MSG( pos
!= -1, false, wxT("invalid image coordinates") );
1826 if ( M_IMGDATA
->m_hasMask
)
1828 const unsigned char *p
= M_IMGDATA
->m_data
+ 3*pos
;
1829 if ( p
[0] == M_IMGDATA
->m_maskRed
&&
1830 p
[1] == M_IMGDATA
->m_maskGreen
&&
1831 p
[2] == M_IMGDATA
->m_maskBlue
)
1838 if ( M_IMGDATA
->m_alpha
)
1840 if ( M_IMGDATA
->m_alpha
[pos
] < threshold
)
1842 // transparent enough
1851 bool wxImage::SetMaskFromImage(const wxImage
& mask
,
1852 unsigned char mr
, unsigned char mg
, unsigned char mb
)
1854 // check that the images are the same size
1855 if ( (M_IMGDATA
->m_height
!= mask
.GetHeight() ) || (M_IMGDATA
->m_width
!= mask
.GetWidth () ) )
1857 wxLogError( _("Image and mask have different sizes.") );
1861 // find unused colour
1862 unsigned char r
,g
,b
;
1863 if (!FindFirstUnusedColour(&r
, &g
, &b
))
1865 wxLogError( _("No unused colour in image being masked.") );
1871 unsigned char *imgdata
= GetData();
1872 unsigned char *maskdata
= mask
.GetData();
1874 const int w
= GetWidth();
1875 const int h
= GetHeight();
1877 for (int j
= 0; j
< h
; j
++)
1879 for (int i
= 0; i
< w
; i
++)
1881 if ((maskdata
[0] == mr
) && (maskdata
[1] == mg
) && (maskdata
[2] == mb
))
1892 SetMaskColour(r
, g
, b
);
1898 bool wxImage::ConvertAlphaToMask(unsigned char threshold
)
1903 unsigned char mr
, mg
, mb
;
1904 if (!FindFirstUnusedColour(&mr
, &mg
, &mb
))
1906 wxLogError( _("No unused colour in image being masked.") );
1913 SetMaskColour(mr
, mg
, mb
);
1915 unsigned char *imgdata
= GetData();
1916 unsigned char *alphadata
= GetAlpha();
1919 int h
= GetHeight();
1921 for (int y
= 0; y
< h
; y
++)
1923 for (int x
= 0; x
< w
; x
++, imgdata
+= 3, alphadata
++)
1925 if (*alphadata
< threshold
)
1934 if( !M_IMGDATA
->m_staticAlpha
)
1935 free(M_IMGDATA
->m_alpha
);
1937 M_IMGDATA
->m_alpha
= NULL
;
1938 M_IMGDATA
->m_staticAlpha
= false;
1943 // ----------------------------------------------------------------------------
1944 // Palette functions
1945 // ----------------------------------------------------------------------------
1949 bool wxImage::HasPalette() const
1954 return M_IMGDATA
->m_palette
.Ok();
1957 const wxPalette
& wxImage::GetPalette() const
1959 wxCHECK_MSG( Ok(), wxNullPalette
, wxT("invalid image") );
1961 return M_IMGDATA
->m_palette
;
1964 void wxImage::SetPalette(const wxPalette
& palette
)
1966 wxCHECK_RET( Ok(), wxT("invalid image") );
1970 M_IMGDATA
->m_palette
= palette
;
1973 #endif // wxUSE_PALETTE
1975 // ----------------------------------------------------------------------------
1976 // Option functions (arbitrary name/value mapping)
1977 // ----------------------------------------------------------------------------
1979 void wxImage::SetOption(const wxString
& name
, const wxString
& value
)
1983 int idx
= M_IMGDATA
->m_optionNames
.Index(name
, false);
1984 if ( idx
== wxNOT_FOUND
)
1986 M_IMGDATA
->m_optionNames
.Add(name
);
1987 M_IMGDATA
->m_optionValues
.Add(value
);
1991 M_IMGDATA
->m_optionNames
[idx
] = name
;
1992 M_IMGDATA
->m_optionValues
[idx
] = value
;
1996 void wxImage::SetOption(const wxString
& name
, int value
)
1999 valStr
.Printf(wxT("%d"), value
);
2000 SetOption(name
, valStr
);
2003 wxString
wxImage::GetOption(const wxString
& name
) const
2006 return wxEmptyString
;
2008 int idx
= M_IMGDATA
->m_optionNames
.Index(name
, false);
2009 if ( idx
== wxNOT_FOUND
)
2010 return wxEmptyString
;
2012 return M_IMGDATA
->m_optionValues
[idx
];
2015 int wxImage::GetOptionInt(const wxString
& name
) const
2017 return wxAtoi(GetOption(name
));
2020 bool wxImage::HasOption(const wxString
& name
) const
2022 return M_IMGDATA
? M_IMGDATA
->m_optionNames
.Index(name
, false) != wxNOT_FOUND
2026 // ----------------------------------------------------------------------------
2028 // ----------------------------------------------------------------------------
2030 bool wxImage::LoadFile( const wxString
& WXUNUSED_UNLESS_STREAMS(filename
),
2031 wxBitmapType
WXUNUSED_UNLESS_STREAMS(type
),
2032 int WXUNUSED_UNLESS_STREAMS(index
) )
2034 #if HAS_FILE_STREAMS
2035 if (wxFileExists(filename
))
2037 wxImageFileInputStream
stream(filename
);
2038 wxBufferedInputStream
bstream( stream
);
2039 return LoadFile(bstream
, type
, index
);
2043 wxLogError( _("Can't load image from file '%s': file does not exist."), filename
.c_str() );
2047 #else // !HAS_FILE_STREAMS
2049 #endif // HAS_FILE_STREAMS
2052 bool wxImage::LoadFile( const wxString
& WXUNUSED_UNLESS_STREAMS(filename
),
2053 const wxString
& WXUNUSED_UNLESS_STREAMS(mimetype
),
2054 int WXUNUSED_UNLESS_STREAMS(index
) )
2056 #if HAS_FILE_STREAMS
2057 if (wxFileExists(filename
))
2059 wxImageFileInputStream
stream(filename
);
2060 wxBufferedInputStream
bstream( stream
);
2061 return LoadFile(bstream
, mimetype
, index
);
2065 wxLogError( _("Can't load image from file '%s': file does not exist."), filename
.c_str() );
2069 #else // !HAS_FILE_STREAMS
2071 #endif // HAS_FILE_STREAMS
2075 bool wxImage::SaveFile( const wxString
& filename
) const
2077 wxString ext
= filename
.AfterLast('.').Lower();
2079 wxImageHandler
*handler
= FindHandler(ext
, wxBITMAP_TYPE_ANY
);
2082 wxLogError(_("Can't save image to file '%s': unknown extension."),
2087 return SaveFile(filename
, handler
->GetType());
2090 bool wxImage::SaveFile( const wxString
& WXUNUSED_UNLESS_STREAMS(filename
),
2091 wxBitmapType
WXUNUSED_UNLESS_STREAMS(type
) ) const
2093 #if HAS_FILE_STREAMS
2094 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
2096 ((wxImage
*)this)->SetOption(wxIMAGE_OPTION_FILENAME
, filename
);
2098 wxImageFileOutputStream
stream(filename
);
2100 if ( stream
.IsOk() )
2102 wxBufferedOutputStream
bstream( stream
);
2103 return SaveFile(bstream
, type
);
2105 #endif // HAS_FILE_STREAMS
2110 bool wxImage::SaveFile( const wxString
& WXUNUSED_UNLESS_STREAMS(filename
),
2111 const wxString
& WXUNUSED_UNLESS_STREAMS(mimetype
) ) const
2113 #if HAS_FILE_STREAMS
2114 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
2116 ((wxImage
*)this)->SetOption(wxIMAGE_OPTION_FILENAME
, filename
);
2118 wxImageFileOutputStream
stream(filename
);
2120 if ( stream
.IsOk() )
2122 wxBufferedOutputStream
bstream( stream
);
2123 return SaveFile(bstream
, mimetype
);
2125 #endif // HAS_FILE_STREAMS
2130 bool wxImage::CanRead( const wxString
& WXUNUSED_UNLESS_STREAMS(name
) )
2132 #if HAS_FILE_STREAMS
2133 wxImageFileInputStream
stream(name
);
2134 return CanRead(stream
);
2140 int wxImage::GetImageCount( const wxString
& WXUNUSED_UNLESS_STREAMS(name
),
2141 wxBitmapType
WXUNUSED_UNLESS_STREAMS(type
) )
2143 #if HAS_FILE_STREAMS
2144 wxImageFileInputStream
stream(name
);
2146 return GetImageCount(stream
, type
);
2154 bool wxImage::CanRead( wxInputStream
&stream
)
2156 const wxList
& list
= GetHandlers();
2158 for ( wxList::compatibility_iterator node
= list
.GetFirst(); node
; node
= node
->GetNext() )
2160 wxImageHandler
*handler
=(wxImageHandler
*)node
->GetData();
2161 if (handler
->CanRead( stream
))
2168 int wxImage::GetImageCount( wxInputStream
&stream
, wxBitmapType type
)
2170 wxImageHandler
*handler
;
2172 if ( type
== wxBITMAP_TYPE_ANY
)
2174 const wxList
& list
= GetHandlers();
2176 for ( wxList::compatibility_iterator node
= list
.GetFirst();
2178 node
= node
->GetNext() )
2180 handler
= (wxImageHandler
*)node
->GetData();
2181 if ( handler
->CanRead(stream
) )
2183 const int count
= handler
->GetImageCount(stream
);
2190 wxLogWarning(_("No handler found for image type."));
2194 handler
= FindHandler(type
);
2198 wxLogWarning(_("No image handler for type %ld defined."), type
);
2202 if ( handler
->CanRead(stream
) )
2204 return handler
->GetImageCount(stream
);
2208 wxLogError(_("Image file is not of type %ld."), type
);
2213 bool wxImage::DoLoad(wxImageHandler
& handler
, wxInputStream
& stream
, int index
)
2215 // save the options values which can be clobbered by the handler (e.g. many
2216 // of them call Destroy() before trying to load the file)
2217 const unsigned maxWidth
= GetOptionInt(wxIMAGE_OPTION_MAX_WIDTH
),
2218 maxHeight
= GetOptionInt(wxIMAGE_OPTION_MAX_HEIGHT
);
2220 if ( !handler
.LoadFile(this, stream
, true/*verbose*/, index
) )
2223 M_IMGDATA
->m_type
= handler
.GetType();
2225 // rescale the image to the specified size if needed
2226 if ( maxWidth
|| maxHeight
)
2228 const unsigned widthOrig
= GetWidth(),
2229 heightOrig
= GetHeight();
2231 // this uses the same (trivial) algorithm as the JPEG handler
2232 unsigned width
= widthOrig
,
2233 height
= heightOrig
;
2234 while ( (maxWidth
&& width
> maxWidth
) ||
2235 (maxHeight
&& height
> maxHeight
) )
2241 if ( width
!= widthOrig
|| height
!= heightOrig
)
2242 Rescale(width
, height
, wxIMAGE_QUALITY_HIGH
);
2248 bool wxImage::LoadFile( wxInputStream
& stream
, wxBitmapType type
, int index
)
2252 wxImageHandler
*handler
;
2254 if ( type
== wxBITMAP_TYPE_ANY
)
2256 const wxList
& list
= GetHandlers();
2257 for ( wxList::compatibility_iterator node
= list
.GetFirst();
2259 node
= node
->GetNext() )
2261 handler
= (wxImageHandler
*)node
->GetData();
2262 if ( handler
->CanRead(stream
) && DoLoad(*handler
, stream
, index
) )
2266 wxLogWarning( _("No handler found for image type.") );
2270 //else: have specific type
2272 handler
= FindHandler(type
);
2275 wxLogWarning( _("No image handler for type %ld defined."), type
);
2279 if ( stream
.IsSeekable() && !handler
->CanRead(stream
) )
2281 wxLogError(_("Image file is not of type %ld."), type
);
2285 return DoLoad(*handler
, stream
, index
);
2288 bool wxImage::LoadFile( wxInputStream
& stream
, const wxString
& mimetype
, int index
)
2292 m_refData
= new wxImageRefData
;
2294 wxImageHandler
*handler
= FindHandlerMime(mimetype
);
2298 wxLogWarning( _("No image handler for type %s defined."), mimetype
.GetData() );
2302 if ( stream
.IsSeekable() && !handler
->CanRead(stream
) )
2304 wxLogError(_("Image file is not of type %s."), mimetype
);
2308 return DoLoad(*handler
, stream
, index
);
2311 bool wxImage::DoSave(wxImageHandler
& handler
, wxOutputStream
& stream
) const
2313 wxImage
* const self
= const_cast<wxImage
*>(this);
2314 if ( !handler
.SaveFile(self
, stream
) )
2317 M_IMGDATA
->m_type
= handler
.GetType();
2321 bool wxImage::SaveFile( wxOutputStream
& stream
, wxBitmapType type
) const
2323 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
2325 wxImageHandler
*handler
= FindHandler(type
);
2328 wxLogWarning( _("No image handler for type %d defined."), type
);
2332 return DoSave(*handler
, stream
);
2335 bool wxImage::SaveFile( wxOutputStream
& stream
, const wxString
& mimetype
) const
2337 wxCHECK_MSG( Ok(), false, wxT("invalid image") );
2339 wxImageHandler
*handler
= FindHandlerMime(mimetype
);
2342 wxLogWarning( _("No image handler for type %s defined."), mimetype
.GetData() );
2345 return DoSave(*handler
, stream
);
2348 #endif // wxUSE_STREAMS
2350 // ----------------------------------------------------------------------------
2351 // image I/O handlers
2352 // ----------------------------------------------------------------------------
2354 void wxImage::AddHandler( wxImageHandler
*handler
)
2356 // Check for an existing handler of the type being added.
2357 if (FindHandler( handler
->GetType() ) == 0)
2359 sm_handlers
.Append( handler
);
2363 // This is not documented behaviour, merely the simplest 'fix'
2364 // for preventing duplicate additions. If someone ever has
2365 // a good reason to add and remove duplicate handlers (and they
2366 // may) we should probably refcount the duplicates.
2367 // also an issue in InsertHandler below.
2369 wxLogDebug( _T("Adding duplicate image handler for '%s'"),
2370 handler
->GetName().c_str() );
2375 void wxImage::InsertHandler( wxImageHandler
*handler
)
2377 // Check for an existing handler of the type being added.
2378 if (FindHandler( handler
->GetType() ) == 0)
2380 sm_handlers
.Insert( handler
);
2384 // see AddHandler for additional comments.
2385 wxLogDebug( _T("Inserting duplicate image handler for '%s'"),
2386 handler
->GetName().c_str() );
2391 bool wxImage::RemoveHandler( const wxString
& name
)
2393 wxImageHandler
*handler
= FindHandler(name
);
2396 sm_handlers
.DeleteObject(handler
);
2404 wxImageHandler
*wxImage::FindHandler( const wxString
& name
)
2406 wxList::compatibility_iterator node
= sm_handlers
.GetFirst();
2409 wxImageHandler
*handler
= (wxImageHandler
*)node
->GetData();
2410 if (handler
->GetName().Cmp(name
) == 0) return handler
;
2412 node
= node
->GetNext();
2417 wxImageHandler
*wxImage::FindHandler( const wxString
& extension
, wxBitmapType bitmapType
)
2419 wxList::compatibility_iterator node
= sm_handlers
.GetFirst();
2422 wxImageHandler
*handler
= (wxImageHandler
*)node
->GetData();
2423 if ( (handler
->GetExtension().Cmp(extension
) == 0) &&
2424 ( (bitmapType
== wxBITMAP_TYPE_ANY
) || (handler
->GetType() == bitmapType
)) )
2428 node
= node
->GetNext();
2433 wxImageHandler
*wxImage::FindHandler(wxBitmapType bitmapType
)
2435 wxList::compatibility_iterator node
= sm_handlers
.GetFirst();
2438 wxImageHandler
*handler
= (wxImageHandler
*)node
->GetData();
2439 if (handler
->GetType() == bitmapType
) return handler
;
2440 node
= node
->GetNext();
2445 wxImageHandler
*wxImage::FindHandlerMime( const wxString
& mimetype
)
2447 wxList::compatibility_iterator node
= sm_handlers
.GetFirst();
2450 wxImageHandler
*handler
= (wxImageHandler
*)node
->GetData();
2451 if (handler
->GetMimeType().IsSameAs(mimetype
, false)) return handler
;
2452 node
= node
->GetNext();
2457 void wxImage::InitStandardHandlers()
2460 AddHandler(new wxBMPHandler
);
2461 #endif // wxUSE_STREAMS
2464 void wxImage::CleanUpHandlers()
2466 wxList::compatibility_iterator node
= sm_handlers
.GetFirst();
2469 wxImageHandler
*handler
= (wxImageHandler
*)node
->GetData();
2470 wxList::compatibility_iterator next
= node
->GetNext();
2475 sm_handlers
.Clear();
2478 wxString
wxImage::GetImageExtWildcard()
2482 wxList
& Handlers
= wxImage::GetHandlers();
2483 wxList::compatibility_iterator Node
= Handlers
.GetFirst();
2486 wxImageHandler
* Handler
= (wxImageHandler
*)Node
->GetData();
2487 fmts
+= wxT("*.") + Handler
->GetExtension();
2488 Node
= Node
->GetNext();
2489 if ( Node
) fmts
+= wxT(";");
2492 return wxT("(") + fmts
+ wxT(")|") + fmts
;
2495 wxImage::HSVValue
wxImage::RGBtoHSV(const RGBValue
& rgb
)
2497 const double red
= rgb
.red
/ 255.0,
2498 green
= rgb
.green
/ 255.0,
2499 blue
= rgb
.blue
/ 255.0;
2501 // find the min and max intensity (and remember which one was it for the
2503 double minimumRGB
= red
;
2504 if ( green
< minimumRGB
)
2506 if ( blue
< minimumRGB
)
2509 enum { RED
, GREEN
, BLUE
} chMax
= RED
;
2510 double maximumRGB
= red
;
2511 if ( green
> maximumRGB
)
2516 if ( blue
> maximumRGB
)
2522 const double value
= maximumRGB
;
2524 double hue
= 0.0, saturation
;
2525 const double deltaRGB
= maximumRGB
- minimumRGB
;
2526 if ( wxIsNullDouble(deltaRGB
) )
2528 // Gray has no color
2537 hue
= (green
- blue
) / deltaRGB
;
2541 hue
= 2.0 + (blue
- red
) / deltaRGB
;
2545 hue
= 4.0 + (red
- green
) / deltaRGB
;
2549 wxFAIL_MSG(wxT("hue not specified"));
2558 saturation
= deltaRGB
/ maximumRGB
;
2561 return HSVValue(hue
, saturation
, value
);
2564 wxImage::RGBValue
wxImage::HSVtoRGB(const HSVValue
& hsv
)
2566 double red
, green
, blue
;
2568 if ( wxIsNullDouble(hsv
.saturation
) )
2577 double hue
= hsv
.hue
* 6.0; // sector 0 to 5
2578 int i
= (int)floor(hue
);
2579 double f
= hue
- i
; // fractional part of h
2580 double p
= hsv
.value
* (1.0 - hsv
.saturation
);
2586 green
= hsv
.value
* (1.0 - hsv
.saturation
* (1.0 - f
));
2591 red
= hsv
.value
* (1.0 - hsv
.saturation
* f
);
2599 blue
= hsv
.value
* (1.0 - hsv
.saturation
* (1.0 - f
));
2604 green
= hsv
.value
* (1.0 - hsv
.saturation
* f
);
2609 red
= hsv
.value
* (1.0 - hsv
.saturation
* (1.0 - f
));
2617 blue
= hsv
.value
* (1.0 - hsv
.saturation
* f
);
2622 return RGBValue((unsigned char)(red
* 255.0),
2623 (unsigned char)(green
* 255.0),
2624 (unsigned char)(blue
* 255.0));
2628 * Rotates the hue of each pixel of the image. angle is a double in the range
2629 * -1.0..1.0 where -1.0 is -360 degrees and 1.0 is 360 degrees
2631 void wxImage::RotateHue(double angle
)
2635 unsigned char *srcBytePtr
;
2636 unsigned char *dstBytePtr
;
2637 unsigned long count
;
2638 wxImage::HSVValue hsv
;
2639 wxImage::RGBValue rgb
;
2641 wxASSERT (angle
>= -1.0 && angle
<= 1.0);
2642 count
= M_IMGDATA
->m_width
* M_IMGDATA
->m_height
;
2643 if ( count
> 0 && !wxIsNullDouble(angle
) )
2645 srcBytePtr
= M_IMGDATA
->m_data
;
2646 dstBytePtr
= srcBytePtr
;
2649 rgb
.red
= *srcBytePtr
++;
2650 rgb
.green
= *srcBytePtr
++;
2651 rgb
.blue
= *srcBytePtr
++;
2652 hsv
= RGBtoHSV(rgb
);
2654 hsv
.hue
= hsv
.hue
+ angle
;
2656 hsv
.hue
= hsv
.hue
- 1.0;
2657 else if (hsv
.hue
< 0.0)
2658 hsv
.hue
= hsv
.hue
+ 1.0;
2660 rgb
= HSVtoRGB(hsv
);
2661 *dstBytePtr
++ = rgb
.red
;
2662 *dstBytePtr
++ = rgb
.green
;
2663 *dstBytePtr
++ = rgb
.blue
;
2664 } while (--count
!= 0);
2668 //-----------------------------------------------------------------------------
2670 //-----------------------------------------------------------------------------
2672 IMPLEMENT_ABSTRACT_CLASS(wxImageHandler
,wxObject
)
2675 bool wxImageHandler::LoadFile( wxImage
*WXUNUSED(image
), wxInputStream
& WXUNUSED(stream
), bool WXUNUSED(verbose
), int WXUNUSED(index
) )
2680 bool wxImageHandler::SaveFile( wxImage
*WXUNUSED(image
), wxOutputStream
& WXUNUSED(stream
), bool WXUNUSED(verbose
) )
2685 int wxImageHandler::GetImageCount( wxInputStream
& WXUNUSED(stream
) )
2690 bool wxImageHandler::CanRead( const wxString
& name
)
2692 if (wxFileExists(name
))
2694 wxImageFileInputStream
stream(name
);
2695 return CanRead(stream
);
2698 wxLogError( _("Can't check image format of file '%s': file does not exist."), name
.c_str() );
2703 bool wxImageHandler::CallDoCanRead(wxInputStream
& stream
)
2705 wxFileOffset posOld
= stream
.TellI();
2706 if ( posOld
== wxInvalidOffset
)
2708 // can't test unseekable stream
2712 bool ok
= DoCanRead(stream
);
2714 // restore the old position to be able to test other formats and so on
2715 if ( stream
.SeekI(posOld
) == wxInvalidOffset
)
2717 wxLogDebug(_T("Failed to rewind the stream in wxImageHandler!"));
2719 // reading would fail anyhow as we're not at the right position
2726 #endif // wxUSE_STREAMS
2730 wxImageHandler::GetResolutionFromOptions(const wxImage
& image
, int *x
, int *y
)
2732 wxCHECK_MSG( x
&& y
, wxIMAGE_RESOLUTION_NONE
, _T("NULL pointer") );
2734 if ( image
.HasOption(wxIMAGE_OPTION_RESOLUTIONX
) &&
2735 image
.HasOption(wxIMAGE_OPTION_RESOLUTIONY
) )
2737 *x
= image
.GetOptionInt(wxIMAGE_OPTION_RESOLUTIONX
);
2738 *y
= image
.GetOptionInt(wxIMAGE_OPTION_RESOLUTIONY
);
2740 else if ( image
.HasOption(wxIMAGE_OPTION_RESOLUTION
) )
2743 *y
= image
.GetOptionInt(wxIMAGE_OPTION_RESOLUTION
);
2745 else // no resolution options specified
2750 return wxIMAGE_RESOLUTION_NONE
;
2753 // get the resolution unit too
2754 int resUnit
= image
.GetOptionInt(wxIMAGE_OPTION_RESOLUTIONUNIT
);
2757 // this is the default
2758 resUnit
= wxIMAGE_RESOLUTION_INCHES
;
2761 return (wxImageResolution
)resUnit
;
2764 // ----------------------------------------------------------------------------
2765 // image histogram stuff
2766 // ----------------------------------------------------------------------------
2769 wxImageHistogram::FindFirstUnusedColour(unsigned char *r
,
2774 unsigned char g2
) const
2776 unsigned long key
= MakeKey(r2
, g2
, b2
);
2778 while ( find(key
) != end() )
2780 // color already used
2792 wxLogError(_("No unused colour in image.") );
2798 key
= MakeKey(r2
, g2
, b2
);
2812 wxImage::FindFirstUnusedColour(unsigned char *r
,
2817 unsigned char g2
) const
2819 wxImageHistogram histogram
;
2821 ComputeHistogram(histogram
);
2823 return histogram
.FindFirstUnusedColour(r
, g
, b
, r2
, g2
, b2
);
2829 // Counts and returns the number of different colours. Optionally stops
2830 // when it exceeds 'stopafter' different colours. This is useful, for
2831 // example, to see if the image can be saved as 8-bit (256 colour or
2832 // less, in this case it would be invoked as CountColours(256)). Default
2833 // value for stopafter is -1 (don't care).
2835 unsigned long wxImage::CountColours( unsigned long stopafter
) const
2839 unsigned char r
, g
, b
;
2841 unsigned long size
, nentries
, key
;
2844 size
= GetWidth() * GetHeight();
2847 for (unsigned long j
= 0; (j
< size
) && (nentries
<= stopafter
) ; j
++)
2852 key
= wxImageHistogram::MakeKey(r
, g
, b
);
2854 if (h
.Get(key
) == NULL
)
2865 unsigned long wxImage::ComputeHistogram( wxImageHistogram
&h
) const
2867 unsigned char *p
= GetData();
2868 unsigned long nentries
= 0;
2872 const unsigned long size
= GetWidth() * GetHeight();
2874 unsigned char r
, g
, b
;
2875 for ( unsigned long n
= 0; n
< size
; n
++ )
2881 wxImageHistogramEntry
& entry
= h
[wxImageHistogram::MakeKey(r
, g
, b
)];
2883 if ( entry
.value
++ == 0 )
2884 entry
.index
= nentries
++;
2891 * Rotation code by Carlos Moreno
2894 static const double wxROTATE_EPSILON
= 1e-10;
2896 // Auxiliary function to rotate a point (x,y) with respect to point p0
2897 // make it inline and use a straight return to facilitate optimization
2898 // also, the function receives the sine and cosine of the angle to avoid
2899 // repeating the time-consuming calls to these functions -- sin/cos can
2900 // be computed and stored in the calling function.
2902 static inline wxRealPoint
2903 wxRotatePoint(const wxRealPoint
& p
, double cos_angle
, double sin_angle
,
2904 const wxRealPoint
& p0
)
2906 return wxRealPoint(p0
.x
+ (p
.x
- p0
.x
) * cos_angle
- (p
.y
- p0
.y
) * sin_angle
,
2907 p0
.y
+ (p
.y
- p0
.y
) * cos_angle
+ (p
.x
- p0
.x
) * sin_angle
);
2910 static inline wxRealPoint
2911 wxRotatePoint(double x
, double y
, double cos_angle
, double sin_angle
,
2912 const wxRealPoint
& p0
)
2914 return wxRotatePoint (wxRealPoint(x
,y
), cos_angle
, sin_angle
, p0
);
2917 wxImage
wxImage::Rotate(double angle
,
2918 const wxPoint
& centre_of_rotation
,
2920 wxPoint
*offset_after_rotation
) const
2922 // screen coordinates are a mirror image of "real" coordinates
2925 const bool has_alpha
= HasAlpha();
2927 const int w
= GetWidth();
2928 const int h
= GetHeight();
2932 // Create pointer-based array to accelerate access to wxImage's data
2933 unsigned char ** data
= new unsigned char * [h
];
2934 data
[0] = GetData();
2935 for (i
= 1; i
< h
; i
++)
2936 data
[i
] = data
[i
- 1] + (3 * w
);
2938 // Same for alpha channel
2939 unsigned char ** alpha
= NULL
;
2942 alpha
= new unsigned char * [h
];
2943 alpha
[0] = GetAlpha();
2944 for (i
= 1; i
< h
; i
++)
2945 alpha
[i
] = alpha
[i
- 1] + w
;
2948 // precompute coefficients for rotation formula
2949 const double cos_angle
= cos(angle
);
2950 const double sin_angle
= sin(angle
);
2952 // Create new Image to store the result
2953 // First, find rectangle that covers the rotated image; to do that,
2954 // rotate the four corners
2956 const wxRealPoint
p0(centre_of_rotation
.x
, centre_of_rotation
.y
);
2958 wxRealPoint p1
= wxRotatePoint (0, 0, cos_angle
, sin_angle
, p0
);
2959 wxRealPoint p2
= wxRotatePoint (0, h
, cos_angle
, sin_angle
, p0
);
2960 wxRealPoint p3
= wxRotatePoint (w
, 0, cos_angle
, sin_angle
, p0
);
2961 wxRealPoint p4
= wxRotatePoint (w
, h
, cos_angle
, sin_angle
, p0
);
2963 int x1a
= (int) floor (wxMin (wxMin(p1
.x
, p2
.x
), wxMin(p3
.x
, p4
.x
)));
2964 int y1a
= (int) floor (wxMin (wxMin(p1
.y
, p2
.y
), wxMin(p3
.y
, p4
.y
)));
2965 int x2a
= (int) ceil (wxMax (wxMax(p1
.x
, p2
.x
), wxMax(p3
.x
, p4
.x
)));
2966 int y2a
= (int) ceil (wxMax (wxMax(p1
.y
, p2
.y
), wxMax(p3
.y
, p4
.y
)));
2968 // Create rotated image
2969 wxImage
rotated (x2a
- x1a
+ 1, y2a
- y1a
+ 1, false);
2970 // With alpha channel
2974 if (offset_after_rotation
!= NULL
)
2976 *offset_after_rotation
= wxPoint (x1a
, y1a
);
2979 // the rotated (destination) image is always accessed sequentially via this
2980 // pointer, there is no need for pointer-based arrays here
2981 unsigned char *dst
= rotated
.GetData();
2983 unsigned char *alpha_dst
= has_alpha
? rotated
.GetAlpha() : NULL
;
2985 // if the original image has a mask, use its RGB values as the blank pixel,
2986 // else, fall back to default (black).
2987 unsigned char blank_r
= 0;
2988 unsigned char blank_g
= 0;
2989 unsigned char blank_b
= 0;
2993 blank_r
= GetMaskRed();
2994 blank_g
= GetMaskGreen();
2995 blank_b
= GetMaskBlue();
2996 rotated
.SetMaskColour( blank_r
, blank_g
, blank_b
);
2999 // Now, for each point of the rotated image, find where it came from, by
3000 // performing an inverse rotation (a rotation of -angle) and getting the
3001 // pixel at those coordinates
3003 const int rH
= rotated
.GetHeight();
3004 const int rW
= rotated
.GetWidth();
3006 // do the (interpolating) test outside of the loops, so that it is done
3007 // only once, instead of repeating it for each pixel.
3010 for (int y
= 0; y
< rH
; y
++)
3012 for (int x
= 0; x
< rW
; x
++)
3014 wxRealPoint src
= wxRotatePoint (x
+ x1a
, y
+ y1a
, cos_angle
, -sin_angle
, p0
);
3016 if (-0.25 < src
.x
&& src
.x
< w
- 0.75 &&
3017 -0.25 < src
.y
&& src
.y
< h
- 0.75)
3019 // interpolate using the 4 enclosing grid-points. Those
3020 // points can be obtained using floor and ceiling of the
3021 // exact coordinates of the point
3024 if (0 < src
.x
&& src
.x
< w
- 1)
3026 x1
= wxRound(floor(src
.x
));
3027 x2
= wxRound(ceil(src
.x
));
3029 else // else means that x is near one of the borders (0 or width-1)
3031 x1
= x2
= wxRound (src
.x
);
3034 if (0 < src
.y
&& src
.y
< h
- 1)
3036 y1
= wxRound(floor(src
.y
));
3037 y2
= wxRound(ceil(src
.y
));
3041 y1
= y2
= wxRound (src
.y
);
3044 // get four points and the distances (square of the distance,
3045 // for efficiency reasons) for the interpolation formula
3047 // GRG: Do not calculate the points until they are
3048 // really needed -- this way we can calculate
3049 // just one, instead of four, if d1, d2, d3
3050 // or d4 are < wxROTATE_EPSILON
3052 const double d1
= (src
.x
- x1
) * (src
.x
- x1
) + (src
.y
- y1
) * (src
.y
- y1
);
3053 const double d2
= (src
.x
- x2
) * (src
.x
- x2
) + (src
.y
- y1
) * (src
.y
- y1
);
3054 const double d3
= (src
.x
- x2
) * (src
.x
- x2
) + (src
.y
- y2
) * (src
.y
- y2
);
3055 const double d4
= (src
.x
- x1
) * (src
.x
- x1
) + (src
.y
- y2
) * (src
.y
- y2
);
3057 // Now interpolate as a weighted average of the four surrounding
3058 // points, where the weights are the distances to each of those points
3060 // If the point is exactly at one point of the grid of the source
3061 // image, then don't interpolate -- just assign the pixel
3063 // d1,d2,d3,d4 are positive -- no need for abs()
3064 if (d1
< wxROTATE_EPSILON
)
3066 unsigned char *p
= data
[y1
] + (3 * x1
);
3072 *(alpha_dst
++) = *(alpha
[y1
] + x1
);
3074 else if (d2
< wxROTATE_EPSILON
)
3076 unsigned char *p
= data
[y1
] + (3 * x2
);
3082 *(alpha_dst
++) = *(alpha
[y1
] + x2
);
3084 else if (d3
< wxROTATE_EPSILON
)
3086 unsigned char *p
= data
[y2
] + (3 * x2
);
3092 *(alpha_dst
++) = *(alpha
[y2
] + x2
);
3094 else if (d4
< wxROTATE_EPSILON
)
3096 unsigned char *p
= data
[y2
] + (3 * x1
);
3102 *(alpha_dst
++) = *(alpha
[y2
] + x1
);
3106 // weights for the weighted average are proportional to the inverse of the distance
3107 unsigned char *v1
= data
[y1
] + (3 * x1
);
3108 unsigned char *v2
= data
[y1
] + (3 * x2
);
3109 unsigned char *v3
= data
[y2
] + (3 * x2
);
3110 unsigned char *v4
= data
[y2
] + (3 * x1
);
3112 const double w1
= 1/d1
, w2
= 1/d2
, w3
= 1/d3
, w4
= 1/d4
;
3116 *(dst
++) = (unsigned char)
3117 ( (w1
* *(v1
++) + w2
* *(v2
++) +
3118 w3
* *(v3
++) + w4
* *(v4
++)) /
3119 (w1
+ w2
+ w3
+ w4
) );
3120 *(dst
++) = (unsigned char)
3121 ( (w1
* *(v1
++) + w2
* *(v2
++) +
3122 w3
* *(v3
++) + w4
* *(v4
++)) /
3123 (w1
+ w2
+ w3
+ w4
) );
3124 *(dst
++) = (unsigned char)
3125 ( (w1
* *v1
+ w2
* *v2
+
3126 w3
* *v3
+ w4
* *v4
) /
3127 (w1
+ w2
+ w3
+ w4
) );
3131 v1
= alpha
[y1
] + (x1
);
3132 v2
= alpha
[y1
] + (x2
);
3133 v3
= alpha
[y2
] + (x2
);
3134 v4
= alpha
[y2
] + (x1
);
3136 *(alpha_dst
++) = (unsigned char)
3137 ( (w1
* *v1
+ w2
* *v2
+
3138 w3
* *v3
+ w4
* *v4
) /
3139 (w1
+ w2
+ w3
+ w4
) );
3155 else // not interpolating
3157 for (int y
= 0; y
< rH
; y
++)
3159 for (int x
= 0; x
< rW
; x
++)
3161 wxRealPoint src
= wxRotatePoint (x
+ x1a
, y
+ y1a
, cos_angle
, -sin_angle
, p0
);
3163 const int xs
= wxRound (src
.x
); // wxRound rounds to the
3164 const int ys
= wxRound (src
.y
); // closest integer
3166 if (0 <= xs
&& xs
< w
&& 0 <= ys
&& ys
< h
)
3168 unsigned char *p
= data
[ys
] + (3 * xs
);
3174 *(alpha_dst
++) = *(alpha
[ys
] + (xs
));
3183 *(alpha_dst
++) = 255;
3199 // A module to allow wxImage initialization/cleanup
3200 // without calling these functions from app.cpp or from
3201 // the user's application.
3203 class wxImageModule
: public wxModule
3205 DECLARE_DYNAMIC_CLASS(wxImageModule
)
3208 bool OnInit() { wxImage::InitStandardHandlers(); return true; }
3209 void OnExit() { wxImage::CleanUpHandlers(); }
3212 IMPLEMENT_DYNAMIC_CLASS(wxImageModule
, wxModule
)
3215 #endif // wxUSE_IMAGE