diff --git a/staging/fractional-scale/fractional-scale-v1.xml b/staging/fractional-scale/fractional-scale-v1.xml index 350bfc0..916f9a7 100644 --- a/staging/fractional-scale/fractional-scale-v1.xml +++ b/staging/fractional-scale/fractional-scale-v1.xml @@ -23,9 +23,9 @@ DEALINGS IN THE SOFTWARE. - + This protocol allows a compositor to suggest for surfaces to render at - fractional scales. + fractional scales and determine the fractional scale factor of the outputs. A client can submit scaled content by utilizing wp_viewport. This is done by creating a wp_viewport object for the surface and setting the destination @@ -44,13 +44,13 @@ rounding algorithm for subsurface position and size is not defined. - - + + A global interface for requesting surfaces to use fractional scales. - + Informs the server that the client will not be using this protocol object anymore. This does not affect any other objects, wp_fractional_scale_v1 objects included. @@ -59,7 +59,7 @@ + summary="the surface or output already has a fractional_scale object associated"/> @@ -74,6 +74,30 @@ + + + + Create an add-on object for the the wl_output to let the compositor + request fractional scales. If the given wl_output already has a + wl_client associated with wp_fractional_scale_v1, + the fractional_scale_exists protocol error is raised. + + Please keep in mind that this output extension is provided for + backward compatibility for projects that have no feasible easy and fast way + to transition to per-surface scaling factor. + It is intended to provide a lightweight transition path to per-surface scaling. + It also aims to satisfy the needs of frameworks/systems + that historically expose output scale information, + so they need to continue doing that for compatibility. + + However, per-surface scale is the main Wayland way + to control scale factors of the client, and it should be preferred to use. + + + + @@ -83,7 +107,7 @@ - + Destroy the fractional scale object. When this object is destroyed, preferred_scale events will no longer be sent. @@ -91,8 +115,8 @@ - Notification of a new preferred scale for this surface that the - compositor suggests that the client should use. + Notification of a new preferred scale for this surface or output + that the compositor suggests that the client should use. The sent scale is the numerator of a fraction with a denominator of 120.