xref: /aosp_15_r20/external/igt-gpu-tools/man/intel_panel_fitter.rst (revision d83cc019efdc2edc6c4b16e9034a3ceb8d35d77c)
1*d83cc019SAndroid Build Coastguard Worker==================
2*d83cc019SAndroid Build Coastguard Workerintel_panel_fitter
3*d83cc019SAndroid Build Coastguard Worker==================
4*d83cc019SAndroid Build Coastguard Worker
5*d83cc019SAndroid Build Coastguard Worker--------------------------------
6*d83cc019SAndroid Build Coastguard WorkerChange the panel fitter settings
7*d83cc019SAndroid Build Coastguard Worker--------------------------------
8*d83cc019SAndroid Build Coastguard Worker.. include:: defs.rst
9*d83cc019SAndroid Build Coastguard Worker:Author: IGT Developers <[email protected]>
10*d83cc019SAndroid Build Coastguard Worker:Date: 2016-03-01
11*d83cc019SAndroid Build Coastguard Worker:Version: |PACKAGE_STRING|
12*d83cc019SAndroid Build Coastguard Worker:Copyright: 2012,2016 Intel Corporation
13*d83cc019SAndroid Build Coastguard Worker:Manual section: |MANUAL_SECTION|
14*d83cc019SAndroid Build Coastguard Worker:Manual group: |MANUAL_GROUP|
15*d83cc019SAndroid Build Coastguard Worker
16*d83cc019SAndroid Build Coastguard WorkerSYNOPSIS
17*d83cc019SAndroid Build Coastguard Worker========
18*d83cc019SAndroid Build Coastguard Worker
19*d83cc019SAndroid Build Coastguard Worker**intel_panel_fitter** [*OPTIONS*]
20*d83cc019SAndroid Build Coastguard Worker
21*d83cc019SAndroid Build Coastguard WorkerDESCRIPTION
22*d83cc019SAndroid Build Coastguard Worker===========
23*d83cc019SAndroid Build Coastguard Worker
24*d83cc019SAndroid Build Coastguard Worker**intel_panel_fitter** is a tool that allows you to change the panel fitter
25*d83cc019SAndroid Build Coastguard Workersettings, so you can change the size of the screen being displayed on your
26*d83cc019SAndroid Build Coastguard Workermonitor without changing the real pixel size of your desktop. The biggest use
27*d83cc019SAndroid Build Coastguard Workercase for this tool is to work around overscan done by TVs and some monitors in
28*d83cc019SAndroid Build Coastguard Workerinterlaced mode.
29*d83cc019SAndroid Build Coastguard Worker
30*d83cc019SAndroid Build Coastguard WorkerOPTIONS
31*d83cc019SAndroid Build Coastguard Worker=======
32*d83cc019SAndroid Build Coastguard Worker
33*d83cc019SAndroid Build Coastguard Worker-p PIPE
34*d83cc019SAndroid Build Coastguard Worker    Pipe to be used (A, B or C, but C is only present on Ivy Bridge and newer).
35*d83cc019SAndroid Build Coastguard Worker
36*d83cc019SAndroid Build Coastguard Worker-x WIDTH
37*d83cc019SAndroid Build Coastguard Worker    Final screen width size in pixels (needs -p option).
38*d83cc019SAndroid Build Coastguard Worker
39*d83cc019SAndroid Build Coastguard Worker-y HEIGHT
40*d83cc019SAndroid Build Coastguard Worker    Final screen height size in pixels (needs -p option).
41*d83cc019SAndroid Build Coastguard Worker
42*d83cc019SAndroid Build Coastguard Worker-d
43*d83cc019SAndroid Build Coastguard Worker    Disable panel fitter (needs -p option, ignores -x and -y options).
44*d83cc019SAndroid Build Coastguard Worker
45*d83cc019SAndroid Build Coastguard Worker-l
46*d83cc019SAndroid Build Coastguard Worker    List current state of each pipe.
47*d83cc019SAndroid Build Coastguard Worker
48*d83cc019SAndroid Build Coastguard Worker-h
49*d83cc019SAndroid Build Coastguard Worker    Print the help message.
50*d83cc019SAndroid Build Coastguard Worker
51*d83cc019SAndroid Build Coastguard WorkerEXAMPLES
52*d83cc019SAndroid Build Coastguard Worker========
53*d83cc019SAndroid Build Coastguard Worker
54*d83cc019SAndroid Build Coastguard Workerintel_panel_fitter -l
55*d83cc019SAndroid Build Coastguard Worker    List the current status of each pipe, so you can decide what to do.
56*d83cc019SAndroid Build Coastguard Worker
57*d83cc019SAndroid Build Coastguard Workerintel_panel_fitter -p A -x 1850 -y 1040
58*d83cc019SAndroid Build Coastguard Worker    Change the pipe A size to 1850x1040 pixels.
59*d83cc019SAndroid Build Coastguard Worker
60*d83cc019SAndroid Build Coastguard Workerintel_panel_fitter -p A -d
61*d83cc019SAndroid Build Coastguard Worker    Disable the panel fitter for pipe A.
62*d83cc019SAndroid Build Coastguard Worker
63*d83cc019SAndroid Build Coastguard WorkerNOTES
64*d83cc019SAndroid Build Coastguard Worker=====
65*d83cc019SAndroid Build Coastguard Worker
66*d83cc019SAndroid Build Coastguard WorkerIn the future, there will be support for this feature inside the Linux Kernel.
67*d83cc019SAndroid Build Coastguard Worker
68*d83cc019SAndroid Build Coastguard WorkerLIMITATIONS
69*d83cc019SAndroid Build Coastguard Worker===========
70*d83cc019SAndroid Build Coastguard Worker
71*d83cc019SAndroid Build Coastguard WorkerMachines older than Ironlake are still not supported, but support may be
72*d83cc019SAndroid Build Coastguard Workerpossible to implement.
73*d83cc019SAndroid Build Coastguard Worker
74*d83cc019SAndroid Build Coastguard WorkerREPORTING BUGS
75*d83cc019SAndroid Build Coastguard Worker==============
76*d83cc019SAndroid Build Coastguard Worker
77*d83cc019SAndroid Build Coastguard WorkerReport bugs to https://bugs.freedesktop.org.
78