Inherits Glib::Object.
Public Member Functions | |
virtual | ~Image () |
GdkImage* | gobj () |
Provides access to the underlying C GObject. | |
const GdkImage* | gobj () const |
Provides access to the underlying C GObject. | |
GdkImage* | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
void | put_pixel (int x, int y, guint32 pixel) |
guint32 | get_pixel (int x, int y) const |
void | set_colormap (const Glib::RefPtr< Colormap >& colormap) |
Sets the colormap for the image to the given colormap. | |
Glib::RefPtr< Colormap > | get_colormap () |
Retrieves the colormap for a given image, if it exists. | |
Glib::RefPtr< const Colormap > | get_colormap () const |
Retrieves the colormap for a given image, if it exists. | |
ImageType | get_image_type () const |
Glib::RefPtr< Visual > | get_visual () |
Glib::RefPtr< const Visual > | get_visual () const |
ByteOrder | get_byte_order () const |
int | get_width () const |
int | get_height () const |
guint16 | get_bpp () const |
guint16 | get_bpl () const |
guint16 | get_bits_per_pixel () const |
void* | get_mem () |
const void* | get_mem () const |
void* | get_windowing_data () const |
Static Public Member Functions | |
static Glib::RefPtr< Image > | create (ImageType type, const Glib::RefPtr< Visual >& visual, int width, int height) |
Protected Member Functions | |
Image (ImageType type, const Glib::RefPtr< Visual >& visual, int width, int height) | |
Instantiate a new Gdk::Image. | |
Related Functions | |
(Note that these are not member functions.) | |
Glib::RefPtr< Gdk::Image > | wrap (GdkImage* object, bool take_copy=false) |
A Glib::wrap() method for this object. |
It has now been superceded to a large extent by the much more flexible Gdk::Drawable RGB functions. To create an image from part of a Gdk::Window use Gdk::Drawable::get_image().
The image can be manipulated with get_pixel() and put_pixel(), or alternatively by changing the actual pixel data, though manipulating the pixel data requires complicated code to cope with the different formats that may be used. To draw a Gdk::Image in a Gdk::Window or Gdk::Pixmap use Gdk::Drawable::draw_image().
virtual Gdk::Image::~Image | ( | ) | [virtual] |
Gdk::Image::Image | ( | ImageType | type, | |
const Glib::RefPtr< Visual >& | visual, | |||
int | width, | |||
int | height | |||
) | [protected] |
Instantiate a new Gdk::Image.
type | The type of the Gdk::Image. Gdk::IMAGE_FASTEST is probably the best choice, since it will try to create a Gdk::IMAGE_SHARED image first and if that fails it will then use Gdk::IMAGE_NORMAL. | |
visual | The Gdk::Visual to use for the image. | |
width | The width of the image in pixels. | |
height | The height of the image in pixels. |
static Glib::RefPtr<Image> Gdk::Image::create | ( | ImageType | type, | |
const Glib::RefPtr< Visual >& | visual, | |||
int | width, | |||
int | height | |||
) | [static] |
guint16 Gdk::Image::get_bits_per_pixel | ( | ) | const |
guint16 Gdk::Image::get_bpl | ( | ) | const |
guint16 Gdk::Image::get_bpp | ( | ) | const |
ByteOrder Gdk::Image::get_byte_order | ( | ) | const |
Glib::RefPtr<const Colormap> Gdk::Image::get_colormap | ( | ) | const |
Retrieves the colormap for a given image, if it exists.
An image will have a colormap if the drawable from which it was created has a colormap, or if a colormap was set explicitely with set_colormap().
Glib::RefPtr<Colormap> Gdk::Image::get_colormap | ( | ) |
Retrieves the colormap for a given image, if it exists.
An image will have a colormap if the drawable from which it was created has a colormap, or if a colormap was set explicitely with set_colormap().
int Gdk::Image::get_height | ( | ) | const |
ImageType Gdk::Image::get_image_type | ( | ) | const |
const void* Gdk::Image::get_mem | ( | ) | const |
void* Gdk::Image::get_mem | ( | ) |
guint32 Gdk::Image::get_pixel | ( | int | x, | |
int | y | |||
) | const |
Glib::RefPtr<const Visual> Gdk::Image::get_visual | ( | ) | const |
Glib::RefPtr<Visual> Gdk::Image::get_visual | ( | ) |
int Gdk::Image::get_width | ( | ) | const |
void* Gdk::Image::get_windowing_data | ( | ) | const |
const GdkImage* Gdk::Image::gobj | ( | ) | const [inline] |
GdkImage* Gdk::Image::gobj | ( | ) | [inline] |
GdkImage* Gdk::Image::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
void Gdk::Image::put_pixel | ( | int | x, | |
int | y, | |||
guint32 | pixel | |||
) |
void Gdk::Image::set_colormap | ( | const Glib::RefPtr< Colormap >& | colormap | ) |
Sets the colormap for the image to the given colormap.
Normally there's no need to use this function, images are created with the correct colormap if you get the image from a drawable. If you create the image from scratch, use the colormap of the drawable you intend to render the image to.
colormap | A Gdk::Colormap. |
Glib::RefPtr< Gdk::Image > wrap | ( | GdkImage * | object, | |
bool | take_copy = false | |||
) | [related] |
A Glib::wrap() method for this object.
object | The C instance. | |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |