Home Explore Blog CI



man-pages

3rd chunk of `xrandr.man`
97591b8cf9203f16c0cb05228bf7a97e53498dcfb41348830000000100000fe3
 superset of the options for RandR
       1.2.

       --current
              Return the current  screen  configuration,  without  polling  for
              hardware changes.

       --noprimary
              Don’t define a primary output.

       Per‐output options

       --panning widthxheight[+x+y[/track_widthx‐
       track_height+track_x+track_y[/border_left/border_top/border_right/bor‐
       der_bottom]]]
              This  option  sets the panning parameters.  As soon as panning is
              enabled, the CRTC position can change with  every  pointer  move.
              The  first  four  parameters  specify the total panning area, the
              next four the pointer tracking area (which defaults to  the  same
              area). The last four parameters specify the border and default to
              0.  A width or height set to zero disables panning on the accord‐
              ing axis. You typically have to set the screen size with ‐‐fb si‐
              multaneously.

       --transform a,b,c,d,e,f,g,h,i
              Specifies a transformation matrix to apply on the output.  A  bi‐
              linear filter is selected automatically unless the --filter para‐
              meter is also specified.  The mathematical form corresponds to:
                     a b c
                     d e f
                     g h i
              The  transformation  is based on homogeneous coordinates. The ma‐
              trix multiplied by the coordinate vector of a pixel of the output
              gives the transformed coordinate vector of a pixel in the graphic
              buffer.  More precisely, the vector (x y) of the output pixel  is
              extended to 3 values (x y w), with 1 as the w coordinate and mul‐
              tiplied  against  the matrix. The final device coordinates of the
              pixel are then calculated with the so‐called  homogenic  division
              by  the transformed w coordinate.  In other words, the device co‐
              ordinates (x’ y’) of the transformed pixel are:
                     x’ = (ax + by + c) / w’   and
                     y’ = (dx + ey + f) / w’   ,
                     with  w’ = (gx + hy + i)  .
              Typically, a and e corresponds to the scaling  on  the  X  and  Y
              axes,  c  and f corresponds to the translation on those axes, and
              g, h, and i are respectively 0, 0 and 1. The matrix can  also  be
              used  to  express  more  complex transformations such as keystone
              correction, or rotation.  For a rotation of an angle T, this for‐
              mula can be used:
                     cos T  ‐sin T   0
                     sin T   cos T   0
                      0       0      1
              As a special argument, instead of passing a matrix, one can  pass
              the  string  none,  in  which case the default values are used (a
              unit matrix without filter).

       --filter filtermode
              Chooses the scaling filter method to be applied when  the  screen
              is scaled or transformed.  Can be either ’bilinear’ or ’nearest’.

       --scale x[xy]
              Changes  the dimensions of the output picture.  If the y value is
              omitted, the x value will be used for  both  dimensions.   Values
              larger  than 1 lead to a compressed screen (screen dimension big‐
              ger than the dimension of the output mode), and values less  than
              1  lead  to  a  zoom in on the output.  This option is actually a
              shortcut version of the --transform option.

       --scale‐from wxh
              Specifies the size in pixels of the area of the framebuffer to be
              displayed on this output.  This option  is  actually  a  shortcut
              version of the --transform option.

       --primary
              Set  the  output as primary.  It will be sorted first in Xinerama
              and RANDR geometry requests.

Title: xrandr: RandR 1.3 Per-Output Options - Panning, Transformation, Filter, Scaling, and Primary Output
Summary
This section details per-output options available in xrandr, specifically related to RandR version 1.3. These options include: setting panning parameters to adjust the visible area, applying transformation matrices for operations like scaling, rotation, and keystone correction, selecting scaling filter methods (bilinear or nearest), scaling the output picture dimensions, specifying the size of the framebuffer area to be displayed, and designating an output as the primary output for Xinerama and RANDR geometry requests.