1998-10-24 13:12:05 -04:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Name: image.h
|
|
|
|
// Purpose: wxImage class
|
|
|
|
// Author: Robert Roebling
|
|
|
|
// RCS-ID: $Id$
|
|
|
|
// Copyright: (c) Robert Roebling
|
1999-07-07 11:11:09 -04:00
|
|
|
// Licence: wxWindows licence
|
1998-10-24 13:12:05 -04:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
|
|
#ifndef _WX_IMAGE_H_
|
|
|
|
#define _WX_IMAGE_H_
|
|
|
|
|
|
|
|
#ifdef __GNUG__
|
|
|
|
#pragma interface "image.h"
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#include "wx/setup.h"
|
|
|
|
#include "wx/object.h"
|
|
|
|
#include "wx/string.h"
|
|
|
|
#include "wx/gdicmn.h"
|
1999-07-07 11:11:09 -04:00
|
|
|
#include "wx/bitmap.h"
|
2002-02-07 13:11:39 -05:00
|
|
|
#include "wx/hashmap.h"
|
1999-01-22 06:06:20 -05:00
|
|
|
|
|
|
|
#if wxUSE_STREAMS
|
1999-08-27 07:31:07 -04:00
|
|
|
# include "wx/stream.h"
|
1999-01-22 06:06:20 -05:00
|
|
|
#endif
|
1998-10-24 13:12:05 -04:00
|
|
|
|
2001-04-22 18:21:21 -04:00
|
|
|
#if wxUSE_IMAGE
|
|
|
|
|
2002-02-15 20:45:30 -05:00
|
|
|
#define wxIMAGE_OPTION_FILENAME wxString(_T("FileName"))
|
|
|
|
|
1998-10-24 13:12:05 -04:00
|
|
|
//-----------------------------------------------------------------------------
|
|
|
|
// classes
|
|
|
|
//-----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class WXDLLEXPORT wxImageHandler;
|
|
|
|
class WXDLLEXPORT wxImage;
|
|
|
|
|
|
|
|
//-----------------------------------------------------------------------------
|
|
|
|
// wxImageHandler
|
|
|
|
//-----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class WXDLLEXPORT wxImageHandler: public wxObject
|
|
|
|
{
|
|
|
|
public:
|
1999-12-27 08:01:07 -05:00
|
|
|
wxImageHandler() { m_name = ""; m_extension = ""; m_type = 0; }
|
1998-10-24 13:12:05 -04:00
|
|
|
|
1999-01-22 06:06:20 -05:00
|
|
|
#if wxUSE_STREAMS
|
2002-01-03 18:08:59 -05:00
|
|
|
virtual bool LoadFile( wxImage *image, wxInputStream& stream, bool verbose=TRUE, int index=-1 );
|
1999-12-27 08:01:07 -05:00
|
|
|
virtual bool SaveFile( wxImage *image, wxOutputStream& stream, bool verbose=TRUE );
|
1999-12-16 16:29:54 -05:00
|
|
|
|
2002-01-02 12:09:43 -05:00
|
|
|
virtual int GetImageCount( wxInputStream& stream );
|
1999-08-18 17:22:54 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
bool CanRead( wxInputStream& stream ) { return DoCanRead(stream); }
|
|
|
|
bool CanRead( const wxString& name );
|
1999-12-16 16:29:54 -05:00
|
|
|
#endif // wxUSE_STREAMS
|
1998-10-24 13:12:05 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
void SetName(const wxString& name) { m_name = name; }
|
|
|
|
void SetExtension(const wxString& ext) { m_extension = ext; }
|
|
|
|
void SetType(long type) { m_type = type; }
|
|
|
|
void SetMimeType(const wxString& type) { m_mime = type; }
|
|
|
|
wxString GetName() const { return m_name; }
|
|
|
|
wxString GetExtension() const { return m_extension; }
|
|
|
|
long GetType() const { return m_type; }
|
|
|
|
wxString GetMimeType() const { return m_mime; }
|
1999-04-11 15:07:17 -04:00
|
|
|
|
1998-10-24 13:12:05 -04:00
|
|
|
protected:
|
1999-12-16 16:29:54 -05:00
|
|
|
#if wxUSE_STREAMS
|
1999-12-27 08:01:07 -05:00
|
|
|
virtual bool DoCanRead( wxInputStream& stream ) = 0;
|
1999-12-16 16:29:54 -05:00
|
|
|
#endif // wxUSE_STREAMS
|
1999-10-15 12:59:32 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
wxString m_name;
|
|
|
|
wxString m_extension;
|
|
|
|
wxString m_mime;
|
|
|
|
long m_type;
|
2001-12-30 17:26:15 -05:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
private:
|
|
|
|
DECLARE_CLASS(wxImageHandler)
|
1999-12-16 16:29:54 -05:00
|
|
|
};
|
|
|
|
|
1998-10-24 13:12:05 -04:00
|
|
|
//-----------------------------------------------------------------------------
|
2002-02-07 13:11:39 -05:00
|
|
|
// wxImageHistogram
|
1998-10-24 13:12:05 -04:00
|
|
|
//-----------------------------------------------------------------------------
|
|
|
|
|
2002-02-07 13:11:39 -05:00
|
|
|
class WXDLLEXPORT wxImageHistogramEntry
|
1999-12-15 06:45:32 -05:00
|
|
|
{
|
|
|
|
public:
|
2002-02-07 13:11:39 -05:00
|
|
|
wxImageHistogramEntry() : index(0), value(0) {}
|
1999-12-15 06:45:32 -05:00
|
|
|
unsigned long index;
|
|
|
|
unsigned long value;
|
|
|
|
};
|
|
|
|
|
2002-02-07 13:11:39 -05:00
|
|
|
WX_DECLARE_EXPORTED_HASH_MAP(unsigned long, wxImageHistogramEntry,
|
|
|
|
wxIntegerHash, wxIntegerEqual,
|
|
|
|
wxImageHistogram);
|
|
|
|
|
|
|
|
//-----------------------------------------------------------------------------
|
|
|
|
// wxImage
|
|
|
|
//-----------------------------------------------------------------------------
|
|
|
|
|
1998-10-24 13:12:05 -04:00
|
|
|
class WXDLLEXPORT wxImage: public wxObject
|
|
|
|
{
|
|
|
|
public:
|
1999-12-27 08:01:07 -05:00
|
|
|
wxImage();
|
|
|
|
wxImage( int width, int height );
|
2000-07-15 15:51:35 -04:00
|
|
|
wxImage( int width, int height, unsigned char* data, bool static_data = FALSE );
|
2002-01-01 18:13:37 -05:00
|
|
|
wxImage( const wxString& name, long type = wxBITMAP_TYPE_ANY, int index = -1 );
|
|
|
|
wxImage( const wxString& name, const wxString& mimetype, int index = -1 );
|
2001-12-30 17:26:15 -05:00
|
|
|
|
|
|
|
#if wxUSE_STREAMS
|
2002-01-01 18:13:37 -05:00
|
|
|
wxImage( wxInputStream& stream, long type = wxBITMAP_TYPE_ANY, int index = -1 );
|
|
|
|
wxImage( wxInputStream& stream, const wxString& mimetype, int index = -1 );
|
2001-12-30 17:26:15 -05:00
|
|
|
#endif // wxUSE_STREAMS
|
1998-10-24 13:12:05 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
wxImage( const wxImage& image );
|
|
|
|
wxImage( const wxImage* image );
|
1999-04-11 15:07:17 -04:00
|
|
|
|
2001-04-04 19:15:36 -04:00
|
|
|
#if wxUSE_GUI
|
|
|
|
// convertion to/from wxBitmap (deprecated, use wxBitmap's methods instead):
|
1999-12-27 08:01:07 -05:00
|
|
|
wxImage( const wxBitmap &bitmap );
|
|
|
|
wxBitmap ConvertToBitmap() const;
|
2000-01-12 12:57:18 -05:00
|
|
|
#ifdef __WXGTK__
|
2001-04-06 18:15:34 -04:00
|
|
|
wxBitmap ConvertToMonoBitmap( unsigned char red, unsigned char green, unsigned char blue ) const;
|
2001-04-04 19:15:36 -04:00
|
|
|
#endif
|
2000-01-12 12:57:18 -05:00
|
|
|
#endif
|
1999-07-07 11:11:09 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
void Create( int width, int height );
|
2000-07-15 15:51:35 -04:00
|
|
|
void Create( int width, int height, unsigned char* data, bool static_data = FALSE );
|
1999-12-27 08:01:07 -05:00
|
|
|
void Destroy();
|
1998-10-24 13:12:05 -04:00
|
|
|
|
2000-07-15 15:51:35 -04:00
|
|
|
// creates an identical copy of the image (the = operator
|
|
|
|
// just raises the ref count)
|
|
|
|
wxImage Copy() const;
|
2001-12-30 17:26:15 -05:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
// return the new image with size width*height
|
|
|
|
wxImage GetSubImage( const wxRect& ) const;
|
2001-12-30 17:26:15 -05:00
|
|
|
|
2000-07-15 15:51:35 -04:00
|
|
|
// pastes image into this instance and takes care of
|
|
|
|
// the mask colour and out of bounds problems
|
2001-12-30 17:26:15 -05:00
|
|
|
void Paste( const wxImage &image, int x, int y );
|
1999-07-07 11:11:09 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
// return the new image with size width*height
|
|
|
|
wxImage Scale( int width, int height ) const;
|
1999-08-18 13:01:47 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
// rescales the image in place
|
|
|
|
wxImage& Rescale( int width, int height ) { return *this = Scale(width, height); }
|
1999-07-05 17:08:29 -04:00
|
|
|
|
2000-02-06 09:51:36 -05:00
|
|
|
// Rotates the image about the given point, 'angle' radians.
|
|
|
|
// Returns the rotated image, leaving this image intact.
|
|
|
|
wxImage Rotate(double angle, const wxPoint & centre_of_rotation,
|
2000-07-15 15:51:35 -04:00
|
|
|
bool interpolating = TRUE, wxPoint * offset_after_rotation = (wxPoint*) NULL) const;
|
|
|
|
|
|
|
|
wxImage Rotate90( bool clockwise = TRUE ) const;
|
|
|
|
wxImage Mirror( bool horizontally = TRUE ) const;
|
2000-02-06 09:51:36 -05:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
// replace one colour with another
|
|
|
|
void Replace( unsigned char r1, unsigned char g1, unsigned char b1,
|
|
|
|
unsigned char r2, unsigned char g2, unsigned char b2 );
|
2001-12-30 17:26:15 -05:00
|
|
|
|
2001-04-04 19:15:36 -04:00
|
|
|
// convert to monochrome image (<r,g,b> will be replaced by white, everything else by black)
|
2001-04-06 18:15:34 -04:00
|
|
|
wxImage ConvertToMono( unsigned char r, unsigned char g, unsigned char b ) const;
|
1999-07-05 17:08:29 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
// these routines are slow but safe
|
|
|
|
void SetRGB( int x, int y, unsigned char r, unsigned char g, unsigned char b );
|
2000-07-15 15:51:35 -04:00
|
|
|
unsigned char GetRed( int x, int y ) const;
|
|
|
|
unsigned char GetGreen( int x, int y ) const;
|
|
|
|
unsigned char GetBlue( int x, int y ) const;
|
1999-07-07 11:11:09 -04:00
|
|
|
|
2001-11-20 18:55:44 -05:00
|
|
|
// find first colour that is not used in the image and has higher
|
|
|
|
// RGB values than <startR,startG,startB>
|
|
|
|
bool FindFirstUnusedColour( unsigned char *r, unsigned char *g, unsigned char *b,
|
2001-12-30 17:26:15 -05:00
|
|
|
unsigned char startR = 1, unsigned char startG = 0,
|
2002-02-07 19:17:25 -05:00
|
|
|
unsigned char startB = 0 ) const;
|
2001-11-20 18:55:44 -05:00
|
|
|
// Set image's mask to the area of 'mask' that has <r,g,b> colour
|
2001-12-30 17:26:15 -05:00
|
|
|
bool SetMaskFromImage(const wxImage & mask,
|
2001-11-20 18:55:44 -05:00
|
|
|
unsigned char mr, unsigned char mg, unsigned char mb);
|
2001-11-18 04:43:06 -05:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
static bool CanRead( const wxString& name );
|
2002-01-02 12:09:43 -05:00
|
|
|
static int GetImageCount( const wxString& name, long type = wxBITMAP_TYPE_ANY );
|
2002-01-01 18:13:37 -05:00
|
|
|
virtual bool LoadFile( const wxString& name, long type = wxBITMAP_TYPE_ANY, int index = -1 );
|
|
|
|
virtual bool LoadFile( const wxString& name, const wxString& mimetype, int index = -1 );
|
1999-01-22 06:06:20 -05:00
|
|
|
|
|
|
|
#if wxUSE_STREAMS
|
1999-12-27 08:01:07 -05:00
|
|
|
static bool CanRead( wxInputStream& stream );
|
2002-01-02 12:09:43 -05:00
|
|
|
static int GetImageCount( wxInputStream& stream, long type = wxBITMAP_TYPE_ANY );
|
2002-01-01 18:13:37 -05:00
|
|
|
virtual bool LoadFile( wxInputStream& stream, long type = wxBITMAP_TYPE_ANY, int index = -1 );
|
|
|
|
virtual bool LoadFile( wxInputStream& stream, const wxString& mimetype, int index = -1 );
|
1999-01-22 06:06:20 -05:00
|
|
|
#endif
|
|
|
|
|
2002-02-07 19:17:25 -05:00
|
|
|
virtual bool SaveFile( const wxString& name, int type ) const;
|
|
|
|
virtual bool SaveFile( const wxString& name, const wxString& mimetype ) const;
|
1999-01-22 06:06:20 -05:00
|
|
|
|
|
|
|
#if wxUSE_STREAMS
|
2002-02-07 19:17:25 -05:00
|
|
|
virtual bool SaveFile( wxOutputStream& stream, int type ) const;
|
|
|
|
virtual bool SaveFile( wxOutputStream& stream, const wxString& mimetype ) const;
|
1999-01-22 06:06:20 -05:00
|
|
|
#endif
|
1998-10-24 13:12:05 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
bool Ok() const;
|
|
|
|
int GetWidth() const;
|
|
|
|
int GetHeight() const;
|
|
|
|
|
|
|
|
char unsigned *GetData() const;
|
|
|
|
void SetData( char unsigned *data );
|
2000-07-15 15:51:35 -04:00
|
|
|
void SetData( char unsigned *data, int new_width, int new_height );
|
2000-07-29 07:44:57 -04:00
|
|
|
|
|
|
|
// Mask functions
|
1999-12-27 08:01:07 -05:00
|
|
|
void SetMaskColour( unsigned char r, unsigned char g, unsigned char b );
|
|
|
|
unsigned char GetMaskRed() const;
|
|
|
|
unsigned char GetMaskGreen() const;
|
|
|
|
unsigned char GetMaskBlue() const;
|
|
|
|
void SetMask( bool mask = TRUE );
|
|
|
|
bool HasMask() const;
|
|
|
|
|
2001-09-30 18:06:39 -04:00
|
|
|
#if wxUSE_PALETTE
|
2000-07-29 07:44:57 -04:00
|
|
|
// Palette functions
|
|
|
|
bool HasPalette() const;
|
|
|
|
const wxPalette& GetPalette() const;
|
|
|
|
void SetPalette(const wxPalette& palette);
|
2001-09-30 18:06:39 -04:00
|
|
|
#endif // wxUSE_PALETTE
|
2000-07-29 07:44:57 -04:00
|
|
|
|
|
|
|
// Option functions (arbitrary name/value mapping)
|
|
|
|
void SetOption(const wxString& name, const wxString& value);
|
|
|
|
void SetOption(const wxString& name, int value);
|
|
|
|
wxString GetOption(const wxString& name) const;
|
|
|
|
int GetOptionInt(const wxString& name) const;
|
|
|
|
bool HasOption(const wxString& name) const;
|
2000-07-28 13:53:25 -04:00
|
|
|
|
2002-02-07 19:17:25 -05:00
|
|
|
unsigned long CountColours( unsigned long stopafter = (unsigned long) -1 ) const;
|
2002-02-07 13:11:39 -05:00
|
|
|
|
|
|
|
// Computes the histogram of the image and fills a hash table, indexed
|
|
|
|
// with integer keys built as 0xRRGGBB, containing wxImageHistogramEntry
|
|
|
|
// objects. Each of them contains an 'index' (useful to build a palette
|
|
|
|
// with the image colours) and a 'value', which is the number of pixels
|
|
|
|
// in the image with that colour.
|
|
|
|
// Returned value: # of entries in the histogram
|
2002-02-07 19:17:25 -05:00
|
|
|
unsigned long ComputeHistogram( wxImageHistogram &h ) const;
|
1999-12-27 08:01:07 -05:00
|
|
|
|
|
|
|
wxImage& operator = (const wxImage& image)
|
|
|
|
{
|
|
|
|
if ( (*this) != image )
|
|
|
|
Ref(image);
|
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool operator == (const wxImage& image)
|
|
|
|
{ return m_refData == image.m_refData; }
|
|
|
|
bool operator != (const wxImage& image)
|
|
|
|
{ return m_refData != image.m_refData; }
|
|
|
|
|
|
|
|
static wxList& GetHandlers() { return sm_handlers; }
|
|
|
|
static void AddHandler( wxImageHandler *handler );
|
|
|
|
static void InsertHandler( wxImageHandler *handler );
|
|
|
|
static bool RemoveHandler( const wxString& name );
|
|
|
|
static wxImageHandler *FindHandler( const wxString& name );
|
|
|
|
static wxImageHandler *FindHandler( const wxString& extension, long imageType );
|
|
|
|
static wxImageHandler *FindHandler( long imageType );
|
|
|
|
static wxImageHandler *FindHandlerMime( const wxString& mimetype );
|
|
|
|
|
|
|
|
static void CleanUpHandlers();
|
|
|
|
static void InitStandardHandlers();
|
1999-12-15 06:45:32 -05:00
|
|
|
|
1998-10-24 13:12:05 -04:00
|
|
|
protected:
|
2000-07-29 07:44:57 -04:00
|
|
|
static wxList sm_handlers;
|
1998-10-24 13:12:05 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
private:
|
|
|
|
friend class WXDLLEXPORT wxImageHandler;
|
1999-07-07 11:11:09 -04:00
|
|
|
|
1999-12-27 08:01:07 -05:00
|
|
|
DECLARE_DYNAMIC_CLASS(wxImage)
|
1998-10-24 13:12:05 -04:00
|
|
|
};
|
|
|
|
|
1999-12-15 17:38:02 -05:00
|
|
|
|
1999-10-09 17:16:45 -04:00
|
|
|
extern void WXDLLEXPORT wxInitAllImageHandlers();
|
1999-09-20 15:05:49 -04:00
|
|
|
|
2001-04-04 19:15:36 -04:00
|
|
|
WXDLLEXPORT_DATA(extern wxImage) wxNullImage;
|
1999-12-15 17:38:02 -05:00
|
|
|
|
|
|
|
//-----------------------------------------------------------------------------
|
|
|
|
// wxImage handlers
|
|
|
|
//-----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
#include "wx/imagbmp.h"
|
|
|
|
#include "wx/imagpng.h"
|
|
|
|
#include "wx/imaggif.h"
|
|
|
|
#include "wx/imagpcx.h"
|
|
|
|
#include "wx/imagjpeg.h"
|
|
|
|
#include "wx/imagtiff.h"
|
|
|
|
#include "wx/imagpnm.h"
|
2001-04-22 18:21:21 -04:00
|
|
|
#include "wx/imagxpm.h"
|
2002-01-15 12:57:08 -05:00
|
|
|
#include "wx/imagiff.h"
|
2001-04-22 18:21:21 -04:00
|
|
|
|
|
|
|
#endif // wxUSE_IMAGE
|
1999-12-15 17:38:02 -05:00
|
|
|
|
1998-10-24 13:12:05 -04:00
|
|
|
#endif
|
|
|
|
// _WX_IMAGE_H_
|
1999-04-11 15:07:17 -04:00
|
|
|
|