Version: 3.0.2
image.h File Reference

Classes

class  wxImageHandler
 This is the base class for implementing image file loading/saving, and image creation from data. More...
 
class  wxImage
 This class encapsulates a platform-independent image. More...
 
class  wxImage::RGBValue
 A simple class which stores red, green and blue values as 8 bit unsigned integers in the range of 0-255. More...
 
class  wxImage::HSVValue
 A simple class which stores hue, saturation and value as doubles in the range 0.0-1.0. More...
 
class  wxImageHistogram
 

Macros

#define wxIMAGE_OPTION_QUALITY   wxString("quality")
 Image option names.
 
#define wxIMAGE_OPTION_FILENAME   wxString("FileName")
 
#define wxIMAGE_OPTION_RESOLUTION   wxString("Resolution")
 
#define wxIMAGE_OPTION_RESOLUTIONX   wxString("ResolutionX")
 
#define wxIMAGE_OPTION_RESOLUTIONY   wxString("ResolutionY")
 
#define wxIMAGE_OPTION_RESOLUTIONUNIT   wxString("ResolutionUnit")
 
#define wxIMAGE_OPTION_MAX_WIDTH   wxString("MaxWidth")
 
#define wxIMAGE_OPTION_MAX_HEIGHT   wxString("MaxHeight")
 
#define wxIMAGE_OPTION_ORIGINAL_WIDTH   wxString("OriginalWidth")
 
#define wxIMAGE_OPTION_ORIGINAL_HEIGHT   wxString("OriginalHeight")
 
#define wxIMAGE_OPTION_BMP_FORMAT   wxString("wxBMP_FORMAT")
 
#define wxIMAGE_OPTION_CUR_HOTSPOT_X   wxString("HotSpotX")
 
#define wxIMAGE_OPTION_CUR_HOTSPOT_Y   wxString("HotSpotY")
 
#define wxIMAGE_OPTION_GIF_COMMENT   wxString("GifComment")
 
#define wxIMAGE_OPTION_PNG_FORMAT   wxString("PngFormat")
 
#define wxIMAGE_OPTION_PNG_BITDEPTH   wxString("PngBitDepth")
 
#define wxIMAGE_OPTION_PNG_FILTER   wxString("PngF")
 
#define wxIMAGE_OPTION_PNG_COMPRESSION_LEVEL   wxString("PngZL")
 
#define wxIMAGE_OPTION_PNG_COMPRESSION_MEM_LEVEL   wxString("PngZM")
 
#define wxIMAGE_OPTION_PNG_COMPRESSION_STRATEGY   wxString("PngZS")
 
#define wxIMAGE_OPTION_PNG_COMPRESSION_BUFFER_SIZE   wxString("PngZB")
 
#define wxIMAGE_OPTION_TIFF_BITSPERSAMPLE   wxString("BitsPerSample")
 
#define wxIMAGE_OPTION_TIFF_SAMPLESPERPIXEL   wxString("SamplesPerPixel")
 
#define wxIMAGE_OPTION_TIFF_COMPRESSION   wxString("Compression")
 
#define wxIMAGE_OPTION_TIFF_PHOTOMETRIC   wxString("Photometric")
 
#define wxIMAGE_OPTION_TIFF_IMAGEDESCRIPTOR   wxString("ImageDescriptor")
 

Enumerations

enum  wxImageResolution {
  wxIMAGE_RESOLUTION_NONE = 0,
  wxIMAGE_RESOLUTION_INCHES = 1,
  wxIMAGE_RESOLUTION_CM = 2
}
 Possible values for the image resolution option. More...
 
enum  wxImageResizeQuality {
  wxIMAGE_QUALITY_NEAREST,
  wxIMAGE_QUALITY_BILINEAR,
  wxIMAGE_QUALITY_BICUBIC,
  wxIMAGE_QUALITY_BOX_AVERAGE,
  wxIMAGE_QUALITY_NORMAL,
  wxIMAGE_QUALITY_HIGH
}
 Image resize algorithm. More...
 
enum  wxImagePNGType {
  wxPNG_TYPE_COLOUR = 0,
  wxPNG_TYPE_GREY = 2,
  wxPNG_TYPE_GREY_RED = 3,
  wxPNG_TYPE_PALETTE = 4
}
 Possible values for PNG image type option. More...
 
enum  {
  wxBMP_24BPP = 24,
  wxBMP_8BPP = 8,
  wxBMP_8BPP_GREY = 9,
  wxBMP_8BPP_GRAY = wxBMP_8BPP_GREY,
  wxBMP_8BPP_RED = 10,
  wxBMP_8BPP_PALETTE = 11,
  wxBMP_4BPP = 4,
  wxBMP_1BPP = 1,
  wxBMP_1BPP_BW = 2
}
 

Functions

void wxInitAllImageHandlers ()
 Initializes all available image handlers.
 

Variables

const unsigned char wxIMAGE_ALPHA_TRANSPARENT = 0
 Constant used to indicate the alpha value conventionally defined as the complete transparency.
 
const unsigned char wxIMAGE_ALPHA_OPAQUE = 0xff
 Constant used to indicate the alpha value conventionally defined as the complete opacity.
 
const unsigned char wxIMAGE_ALPHA_THRESHOLD = 0x80
 
wxImage wxNullImage
 An instance of an empty image without an alpha channel.
 

Macro Definition Documentation

#define wxIMAGE_OPTION_BMP_FORMAT   wxString("wxBMP_FORMAT")
#define wxIMAGE_OPTION_CUR_HOTSPOT_X   wxString("HotSpotX")
#define wxIMAGE_OPTION_CUR_HOTSPOT_Y   wxString("HotSpotY")
#define wxIMAGE_OPTION_FILENAME   wxString("FileName")
#define wxIMAGE_OPTION_GIF_COMMENT   wxString("GifComment")
#define wxIMAGE_OPTION_MAX_HEIGHT   wxString("MaxHeight")
#define wxIMAGE_OPTION_MAX_WIDTH   wxString("MaxWidth")
#define wxIMAGE_OPTION_ORIGINAL_HEIGHT   wxString("OriginalHeight")
#define wxIMAGE_OPTION_ORIGINAL_WIDTH   wxString("OriginalWidth")
#define wxIMAGE_OPTION_PNG_BITDEPTH   wxString("PngBitDepth")
#define wxIMAGE_OPTION_PNG_COMPRESSION_BUFFER_SIZE   wxString("PngZB")
#define wxIMAGE_OPTION_PNG_COMPRESSION_LEVEL   wxString("PngZL")
#define wxIMAGE_OPTION_PNG_COMPRESSION_MEM_LEVEL   wxString("PngZM")
#define wxIMAGE_OPTION_PNG_COMPRESSION_STRATEGY   wxString("PngZS")
#define wxIMAGE_OPTION_PNG_FILTER   wxString("PngF")
#define wxIMAGE_OPTION_PNG_FORMAT   wxString("PngFormat")
#define wxIMAGE_OPTION_QUALITY   wxString("quality")

Image option names.

#define wxIMAGE_OPTION_RESOLUTION   wxString("Resolution")
#define wxIMAGE_OPTION_RESOLUTIONUNIT   wxString("ResolutionUnit")
#define wxIMAGE_OPTION_RESOLUTIONX   wxString("ResolutionX")
#define wxIMAGE_OPTION_RESOLUTIONY   wxString("ResolutionY")
#define wxIMAGE_OPTION_TIFF_BITSPERSAMPLE   wxString("BitsPerSample")
#define wxIMAGE_OPTION_TIFF_COMPRESSION   wxString("Compression")
#define wxIMAGE_OPTION_TIFF_IMAGEDESCRIPTOR   wxString("ImageDescriptor")
#define wxIMAGE_OPTION_TIFF_PHOTOMETRIC   wxString("Photometric")
#define wxIMAGE_OPTION_TIFF_SAMPLESPERPIXEL   wxString("SamplesPerPixel")

Enumeration Type Documentation

anonymous enum
Enumerator:
wxBMP_24BPP 
wxBMP_8BPP 
wxBMP_8BPP_GREY 
wxBMP_8BPP_GRAY 
wxBMP_8BPP_RED 
wxBMP_8BPP_PALETTE 
wxBMP_4BPP 
wxBMP_1BPP 
wxBMP_1BPP_BW 

Possible values for PNG image type option.

See Also
wxImage::GetOptionInt().
Enumerator:
wxPNG_TYPE_COLOUR 

Colour PNG image.

wxPNG_TYPE_GREY 

Greyscale PNG image converted from RGB.

wxPNG_TYPE_GREY_RED 

Greyscale PNG image using red as grey.

wxPNG_TYPE_PALETTE 

Palette encoding.

Image resize algorithm.

This is used with wxImage::Scale() and wxImage::Rescale().

Enumerator:
wxIMAGE_QUALITY_NEAREST 

Simplest and fastest algorithm.

wxIMAGE_QUALITY_BILINEAR 

Compromise between wxIMAGE_QUALITY_NEAREST and wxIMAGE_QUALITY_BICUBIC.

wxIMAGE_QUALITY_BICUBIC 

Highest quality but slowest execution time.

wxIMAGE_QUALITY_BOX_AVERAGE 

Use surrounding pixels to calculate an average that will be used for new pixels.

This method is typically used when reducing the size of an image.

wxIMAGE_QUALITY_NORMAL 

Default image resizing algorithm used by wxImage::Scale().

Currently the same as wxIMAGE_QUALITY_NEAREST.

wxIMAGE_QUALITY_HIGH 

Best image resizing algorithm.

Since version 2.9.2 this results in wxIMAGE_QUALITY_BOX_AVERAGE being used when reducing the size of the image (meaning that both the new width and height will be smaller than the original size). Otherwise wxIMAGE_QUALITY_BICUBIC is used.

Possible values for the image resolution option.

See Also
wxImage::GetOptionInt().
Enumerator:
wxIMAGE_RESOLUTION_NONE 

Resolution not specified.

wxIMAGE_RESOLUTION_INCHES 

Resolution specified in inches.

wxIMAGE_RESOLUTION_CM 

Resolution specified in centimetres.

Variable Documentation

const unsigned char wxIMAGE_ALPHA_OPAQUE = 0xff

Constant used to indicate the alpha value conventionally defined as the complete opacity.

const unsigned char wxIMAGE_ALPHA_THRESHOLD = 0x80
const unsigned char wxIMAGE_ALPHA_TRANSPARENT = 0

Constant used to indicate the alpha value conventionally defined as the complete transparency.

wxImage wxNullImage

An instance of an empty image without an alpha channel.