.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PHOC.INI"  "" ""
.SH NAME
phoc.ini \- Configuration file for phoc
.SH DESCRIPTION
.sp
Most of \fBphoc\fP\(aqs configuration is read from GSettings. Output and
core settings are read from \fBphoc.ini\fP\&. The configuration file is
searched in phoc\(aqs current working directory. It\(aqs path can also
be given on the command line via the \fI\-C\fP option.
.sp
The phoc.ini file is composed of multiple sections which can be in any
order. If values are not given then built in defaults are used. The main
purpose of \fIphoc.ini\fP is to specify output configuration and layouts.
Each section has the form:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[SectionHeader]
key1 = value1
key2 = value2
.EE
.UNINDENT
.UNINDENT
.sp
Lines starting with \fI#\fP are considered comments and are ignored. The section
headers might contain a colon in which case the part after the colon specifies
the configuration item e.g.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[output:DSI\-1]
.EE
.UNINDENT
.UNINDENT
.sp
is the configuration section for the output \fIDSI\-1\fP\&.
.sp
The available section headers are:
.INDENT 0.0
.IP \(bu 2
\fIcore\fP: core options
.IP \(bu 2
\fIoutput\fP: output configuration
.UNINDENT
.sp
Modifications to this file require a compositor restart to take effect.
.SH CORE SECTION
.sp
The core section can appear only once and has a single option:
.INDENT 0.0
.IP \(bu 2
\fBxwayland=[true|immediate|false]\fP: Whether to enable
XWayland. With \fItrue\fP XWayland is activated when,
needed. \fIimmediate\fP launches it immediately and \fIfalse\fP turns it off.
.UNINDENT
.SH OUTPUT SECTION
.sp
The output section can appear multiple times with different
configuration items
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[output:ITEM]
.EE
.UNINDENT
.UNINDENT
.sp
\fIITEM\fP is either the DRM connector name like \fIDSI\-1\fP or \fIDP\-2\fP \fIor\fP the make, model and serial
as obtained from EDID separated by \fI%\fP: \fI[output:A Vendor%The Model%Serial]\fP\&. Make, model and serial
can be specified as \fI*\fP to match any value. The configuration options are:
.INDENT 0.0
.IP \(bu 2
\fIenable=[true|false]\fP: Whether the output should be enabled
.IP \(bu 2
\fIx\fP, \fIy\fP: The \fIx\fP and \fIy\fP position in the output layout. This can be used to arrange outputs.
The default is to use automatic layout (new outputs are added to the right of the current layout).
.IP \(bu 2
\fIscale\fP: The outputs scale. The default \fIauto\fP calculates the scale based on the screen size.
.IP \(bu 2
\fIrotate\fP: The rotation. Valid values are \fInormal\fP, \fI90\fP, \fI180\fP,
\fI270\fP, \fIflipped\fP, \fIflipped\-90\fP, \fIflipped\-180\fP and \fIflipped\-270\fP\&. The default is to use
\fInormal\fP orientation.
.IP \(bu 2
\fImode\fP: The mode to use. The mode must be a valid mode for this output. See e.g. the output of \fIwlr\-randr\fP\&.
The default is to use the outputs preferred mode.
.IP \(bu 2
\fImodeline\fP: A custom video mode. This is only valid for the DRM backend
.IP \(bu 2
\fIscale\-filter\fP: Filter to use to scale down textures. Valid values are \fIbilinear\fP, \fInearest\fP and \fIauto\fP\&.
The later selects \fIbilinear\fP for fractional and \fInearest\fP for integer scales automatically. If unset
\fIauto\fP is assumed.
.UNINDENT
.sp
Example:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[output:DSI\-1]
scale = 2

[output:Some Vendor%Some Model%*]
scale = 1
rotate = 90
x = 300
.EE
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBphoc(1)\fP \fBwlr\-randr(1)\fP
.\" Generated by docutils manpage writer.
.