eae09f4d83
2001-08-24 Havoc Pennington <hp@pobox.com> * gtk/gtkcompat.h: remove gtk_menu_* compat defines; these are already in gtkmenu.h, and the copies here were broken. Also, change GTK_DISABLE_COMPAT_H to GTK_DISABLE_DEPRECATED * gdk/gdkpixbuf-drawable.c (gdk_pixbuf_get_from_image): special-case bitmaps to allow no colormap (bitmap1): implement no-colormap bitmap-getting (bitmap1a): implement no-colormap bitmap-getting to pixbuf with alpha (rgb8): indentation (rgb1a, rgb1): change the way we read the data out of the image, old way didn't seem to work quite right. I'm pretty sure a lot of the rgbconvert code is still broken. * gtk/gtkwindow.c (gtk_window_move_resize): move hints comparison above position constraint (I really intended to do this before, don't know what's up with that) (gtk_XParseGeometry): shut up gcc * gdk/gdkpixbuf-drawable.c (rgb1a): fix bug where "x1" was used and "0" should have been. remove the attempted 4-bytes-at-once optimization, it was totally broken.
281 lines
4.2 KiB
Plaintext
281 lines
4.2 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkImage
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
A widget displaying a graphical image
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
The #GtkImage widget displays a graphical image. The image is typically created
|
|
using gdk_image_new.
|
|
</para>
|
|
<para>
|
|
The pixels in a #GtkImage may be manipulated by the application after creation,
|
|
as #GtkImage store the pixel data on the client side. If you wish to store the
|
|
pixel data on the server side (thus not allowing manipulation of the data after
|
|
creation) you should use #GtkPixmap.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
#GtkPixmap, #GdkRgb
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkImage ##### -->
|
|
<para>
|
|
This struct contain private data only and should be accessed by the functions
|
|
below.
|
|
</para>
|
|
|
|
|
|
<!-- ##### ENUM GtkImageType ##### -->
|
|
<para>
|
|
Describes the representation stored by a #GtkImage. If you want to get the image
|
|
from the widget, you can only get the currently-stored representation. e.g. if
|
|
the gtk_image_get_storage_type() returns #GTK_IMAGE_PIXBUF, then you can call
|
|
gtk_image_get_pixbuf() but not gtk_image_get_stock(). For empty images, you can
|
|
request any storage type (call any of the "get" functions), but they will all
|
|
return %NULL values.
|
|
</para>
|
|
|
|
@GTK_IMAGE_EMPTY: there is no image displayed by the widget
|
|
@GTK_IMAGE_PIXMAP: the widget contains a #GdkPixmap
|
|
@GTK_IMAGE_IMAGE: the widget contains a #GdkImage
|
|
@GTK_IMAGE_PIXBUF: the widget contains a #GdkPixbuf
|
|
@GTK_IMAGE_STOCK: the widget contains a stock icon name
|
|
@GTK_IMAGE_ICON_SET: the widget contains a #GtkIconSet
|
|
@GTK_IMAGE_ANIMATION:
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_icon_set ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@icon_set:
|
|
@size:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_image ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@gdk_image:
|
|
@mask:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_pixbuf ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_pixmap ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@pixmap:
|
|
@mask:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_stock ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@stock_id:
|
|
@size:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_animation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_storage_type ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_file ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@filename:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_icon_set ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@icon_set:
|
|
@size:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_image ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@mask:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_pixbuf ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pixbuf:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_pixmap ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pixmap:
|
|
@mask:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_stock ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@stock_id:
|
|
@size:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_animation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@animation:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_file ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@filename:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_icon_set ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@icon_set:
|
|
@size:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_image ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@gdk_image:
|
|
@mask:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_pixbuf ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@pixbuf:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_pixmap ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@pixmap:
|
|
@mask:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_stock ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@stock_id:
|
|
@size:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_animation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@animation:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new ##### -->
|
|
<para>
|
|
Creates the new GtkImage using the value and the mask.
|
|
</para>
|
|
|
|
@Returns: the GtkImage
|
|
<!-- # Unused Parameters # -->
|
|
@val:
|
|
@mask: a GDKBitmap that indicates which parts of the image should be transparent.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set ##### -->
|
|
<para>
|
|
Sets the GtkImage
|
|
</para>
|
|
|
|
@image: a #GdkPixmap
|
|
@val:
|
|
@mask: a GDKBitmap that indicates which parts of the image should be transparent.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get ##### -->
|
|
<para>
|
|
Gets the GtkImage
|
|
</para>
|
|
|
|
@image: a #GdkPixmap
|
|
@val:
|
|
@mask: a GDKBitmap that indicates which parts of the image should be transparent.
|
|
|
|
|