From 66c3a43e963b3a751ec272c5bfeaa93a69a10b77 Mon Sep 17 00:00:00 2001 From: Benjamin Otte Date: Fri, 4 Dec 2020 02:04:19 +0000 Subject: [PATCH] Add docs about sizing pictures Suggested by Christopher Davis. --- gtk/gtkpicture.c | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/gtk/gtkpicture.c b/gtk/gtkpicture.c index 78e5ba449a..bd4d9a91bb 100644 --- a/gtk/gtkpicture.c +++ b/gtk/gtkpicture.c @@ -56,6 +56,18 @@ * In this case, gtk_picture_new_for_resource() and gtk_picture_set_resource() * should be used. * + * # Sizing the paintable + * + * You can influence how the paintable is displayed inside the #GtkPicture. + * By turning off GtkPicture::keep-aspect-ratio you can allow the paintable + * to get stretched. GtkPicture::can-shrink can be unset to make + * sure that paintables are never made smaller than their ideal size - but be + * careful if you do not know the size of the paintable in use (like when + * displaying user-loaded images). This can easily cause the picture to grow larger + * than the screen. And GtkWidget::halign and GtkWidget::valign can be used + * to make sure the paintable doesn't fill all available space but is instead + * displayed at its original size. + * * # CSS nodes * * GtkPicture has a single CSS node with the name picture.