From 70269a5aee61674ba9f8d2ae16950d1e7bb2ec5e Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sun, 2 Apr 2023 13:17:36 -0400 Subject: [PATCH] docs: Add some details --- gdk/gdksurface.c | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/gdk/gdksurface.c b/gdk/gdksurface.c index b7e285f2ae..7120da78db 100644 --- a/gdk/gdksurface.c +++ b/gdk/gdksurface.c @@ -572,6 +572,9 @@ gdk_surface_class_init (GdkSurfaceClass *klass) * GdkSurface:scale-factor: (attributes org.gtk.Property.get=gdk_surface_get_scale_factor) * * The scale factor of the surface. + * + * The scale factor is the next larger integer, + * compared to [property@Gdk.Surface:scale]. */ properties[PROP_SCALE_FACTOR] = g_param_spec_int ("scale-factor", NULL, NULL, @@ -2622,7 +2625,7 @@ gdk_surface_get_frame_clock (GdkSurface *surface) * pixel-based data the scale value can be used to determine whether to * use a pixel resource with higher resolution data. * - * The scale may change during the lifetime of the surface. + * The scale factor may change during the lifetime of the surface. * * Returns: the scale factor */ @@ -2641,6 +2644,13 @@ gdk_surface_get_scale_factor (GdkSurface *surface) * Returns the internal scale that maps from surface coordinates * to the actual device pixels. * + * When the scale is bigger than 1, the windowing system prefers to get + * buffers with a resolution that is bigger than the surface size (e.g. + * to show the surface on a high-resolution display, or in a magnifier). + * + * Compare with [method@Gdk.Surface.get_scale_factor], which returns the + * next larger integer. + * * The scale may change during the lifetime of the surface. * * Returns: the scale -- 2.30.2