docs: Mention textures in the GtkImage docs

This is now the preferred way to load images.
This commit is contained in:
Matthias Clasen 2018-01-10 16:43:17 -05:00
parent 185525a58d
commit 0f76228c15

View File

@ -43,11 +43,11 @@
* SECTION:gtkimage * SECTION:gtkimage
* @Short_description: A widget displaying an image * @Short_description: A widget displaying an image
* @Title: GtkImage * @Title: GtkImage
* @See_also:#GdkPixbuf * @SeeAlso: #GdkTexture
* *
* The #GtkImage widget displays an image. Various kinds of object * The #GtkImage widget displays an image. Various kinds of object
* can be displayed as an image; most typically, you would load a * can be displayed as an image; most typically, you would load a
* #GdkPixbuf ("pixel buffer") from a file, and then display that. * #GdkTexture from a file, and then display that.
* Theres a convenience function to do this, gtk_image_new_from_file(), * Theres a convenience function to do this, gtk_image_new_from_file(),
* used as follows: * used as follows:
* |[<!-- language="C" --> * |[<!-- language="C" -->
@ -58,8 +58,8 @@
* broken image icon similar to that used in many web browsers. * broken image icon similar to that used in many web browsers.
* If you want to handle errors in loading the file yourself, * If you want to handle errors in loading the file yourself,
* for example by displaying an error message, then load the image with * for example by displaying an error message, then load the image with
* gdk_pixbuf_new_from_file(), then create the #GtkImage with * gdk_texture_new_from_file(), then create the #GtkImage with
* gtk_image_new_from_pixbuf(). * gtk_image_new_from_texture().
* *
* Sometimes an application will want to avoid depending on external data * Sometimes an application will want to avoid depending on external data
* files, such as image files. See the documentation of #GResource for details. * files, such as image files. See the documentation of #GResource for details.