Re: [Intel-gfx] [PATCH 4/5] Documentation: drm: Convert KMS Properties HTML table to CALS

25 Aug 2015

On Tue, 2015-08-25 at 16:29 +0200, Daniel Vetter wrote:
...
On Tue, Aug 25, 2015 at 10:26:44AM +0100, Graham Whaley wrote:
...
The KMS Properties table is in HTML format, which is not supported
for building pdfdocs, resulting in the following types of errors:
jade:/Documentation/DocBook/drm.xml:34413:15:E: there is no
attribute
 "border"
 jade:/Documentation/DocBook/drm.xml:34413:31:E: there is no
attribute
 "cellpadding"
 jade:/Documentation/DocBook/drm.xml:34413:47:E: there is no
attribute
 "cellspacing"
 jade:/Documentation/DocBook/drm.xml:34414:7:E: document type does
not
 allow element "tbody" here
Convert the table over to a CALS format table
Hm, long-term plan was to move this table into DOC: comments in the
source-code using markdown, which we now have (at least in
drm-intel-nightly and also planned to be merged into 4.4). Since this
is
both a lot of churn I'd like to get there in just 1 step ...
-Daniel
First - I've just noted an erroneous debug comment (or two) left in
this patch as well, so looks like I will have to re-issue the series
anyway.
OK. I guess this comes down to a matter of timing...
...
From Danilos patch of: f6d6913 (drm/doc: Convert to markdown)
we can see markdown does not natively support tables, and we'd have to
make this a fixed width layout like the one in that patch I suspect.
Danilo - any advice on how you did that other table conversion? I just
did a pandoc docbook->markdown_github and it looks some way there - but
of course seems to have not honored the multi-column items, of which
there are a few. It's probably not too bad to fix up by hand - I'll see
if I can get that to work...
Any clue to where in the source file DOC: sections it would want to
live if I get it formatted - I don't see an obvious !include near the
table in the .tmpl file to piggyback.
Graham
...
...
Signed-off-by: Graham Whaley graham.whaley@linux.intel.com
Documentation/DocBook/drm.tmpl | 1866 ++++++++++++++++++++--------
1 file changed, 937 insertions(+), 929 deletions(-)

diff --git a/Documentation/DocBook/drm.tmpl
b/Documentation/DocBook/drm.tmpl
index 2e05a79..e5bfdd8 100644
--- a/Documentation/DocBook/drm.tmpl
+++ b/Documentation/DocBook/drm.tmpl
@@ -2580,935 +2580,943 @@ void intel_crt_init(struct drm_device
*dev)
       and an initial instance value.
     </para>
     <sect2>

<title>Existing KMS Properties</title>

<para>

The following table gives description of drm properties

exposed by various

modules/drivers.
</para>

<table border="1" cellpadding="0" cellspacing="0">

<tbody>

<tr style="font-weight: bold;">

<td valign="top" >Owner Module/Drivers</td>

<td valign="top" >Group</td>

<td valign="top" >Property Name</td>

<td valign="top" >Type</td>

<td valign="top" >Property Values</td>

<td valign="top" >Object attached</td>

<td valign="top" >Description/Restrictions</td>

</tr>

<tr>

<td rowspan="37" valign="top" >DRM</td>

<td valign="top" >Generic</td>

<td valign="top" >“rotation”</td>

<td valign="top" >BITMASK</td>

<td valign="top" >{ 0, "rotate-0" },

{ 1, "rotate-90" },
{ 2, "rotate-180" },
{ 3, "rotate-270" },
{ 4, "reflect-x" },
{ 5, "reflect-y" }</td>
<td valign="top" >CRTC, Plane</td>

<td valign="top" >rotate-(degrees) rotates the image by


the specified amount in degrees

in counter clockwise direction. reflect-x and reflect-y

reflects the

image along the specified axis prior to rotation</td>
</tr>

<tr>

<td rowspan="5" valign="top" >Connector</td>

<td valign="top" >“EDID”</td>

<td valign="top" >BLOB | IMMUTABLE</td>

<td valign="top" >0</td>

<td valign="top" >Connector</td>

<td valign="top" >Contains id of edid blob ptr


object.</td>

</tr>

<tr>

<td valign="top" >“DPMS”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ “On”, “Standby”, “Suspend”, “Off”


}</td>

<td valign="top" >Connector</td>

<td valign="top" >Contains DPMS operation mode value.</td>

</tr>

<tr>

<td valign="top" >“PATH”</td>

<td valign="top" >BLOB | IMMUTABLE</td>

<td valign="top" >0</td>

<td valign="top" >Connector</td>

<td valign="top" >Contains topology path to a


connector.</td>

</tr>

<tr>

<td valign="top" >“TILE”</td>

<td valign="top" >BLOB | IMMUTABLE</td>

<td valign="top" >0</td>

<td valign="top" >Connector</td>

<td valign="top" >Contains tiling information for a


connector.</td>

</tr>

<tr>

<td valign="top" >“CRTC_ID”</td>

<td valign="top" >OBJECT</td>

<td valign="top" >DRM_MODE_OBJECT_CRTC</td>

<td valign="top" >Connector</td>

<td valign="top" >CRTC that connector is attached to


(atomic)</td>

</tr>

<tr>

<td rowspan="11" valign="top" >Plane</td>

<td valign="top" >“type”</td>

<td valign="top" >ENUM | IMMUTABLE</td>

<td valign="top" >{ "Overlay", "Primary", "Cursor" }</td>

<td valign="top" >Plane</td>

<td valign="top" >Plane type</td>

</tr>

<tr>

<td valign="top" >“SRC_X”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout source x coordinate in 16.16


fixed point (atomic)</td>

</tr>

<tr>

<td valign="top" >“SRC_Y”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout source y coordinate in 16.16


fixed point (atomic)</td>

</tr>

<tr>

<td valign="top" >“SRC_W”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout source width in 16.16 fixed


point (atomic)</td>

</tr>

<tr>

<td valign="top" >“SRC_H”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout source height in 16.16 fixed


point (atomic)</td>

</tr>

<tr>

<td valign="top" >“CRTC_X”</td>

<td valign="top" >SIGNED_RANGE</td>

<td valign="top" >Min=INT_MIN, Max=INT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout CRTC (destination) x coordinate


(atomic)</td>

</tr>

<tr>

<td valign="top" >“CRTC_Y”</td>

<td valign="top" >SIGNED_RANGE</td>

<td valign="top" >Min=INT_MIN, Max=INT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout CRTC (destination) y coordinate


(atomic)</td>

</tr>

<tr>

<td valign="top" >“CRTC_W”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout CRTC (destination) width


(atomic)</td>

</tr>

<tr>

<td valign="top" >“CRTC_H”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=UINT_MAX</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout CRTC (destination) height


(atomic)</td>

</tr>

<tr>

<td valign="top" >“FB_ID”</td>

<td valign="top" >OBJECT</td>

<td valign="top" >DRM_MODE_OBJECT_FB</td>

<td valign="top" >Plane</td>

<td valign="top" >Scanout framebuffer (atomic)</td>

</tr>

<tr>

<td valign="top" >“CRTC_ID”</td>

<td valign="top" >OBJECT</td>

<td valign="top" >DRM_MODE_OBJECT_CRTC</td>

<td valign="top" >Plane</td>

<td valign="top" >CRTC that plane is attached to


(atomic)</td>

</tr>

<tr>

<td rowspan="2" valign="top" >DVI-I</td>

<td valign="top" >“subconnector”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ “Unknown”, “DVI-D”, “DVI-A” }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“select subconnector”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ “Automatic”, “DVI-D”, “DVI-A” }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="13" valign="top" >TV</td>

<td valign="top" >“subconnector”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "Unknown", "Composite", "SVIDEO",


"Component", "SCART" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“select subconnector”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "Automatic", "Composite", "SVIDEO",


"Component", "SCART" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "NTSC_M", "NTSC_J", "NTSC_443",


"PAL_B" } etc.</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“left margin”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“right margin”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“top margin”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“bottom margin”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“brightness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“contrast”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker reduction”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“overscan”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“saturation”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hue”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="2" valign="top" >Virtual GPU</td>

<td valign="top" >“suggested X”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffffff</td>

<td valign="top" >Connector</td>

<td valign="top" >property to suggest an X offset for a


connector</td>

</tr>

<tr>

<td valign="top" >“suggested Y”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffffff</td>

<td valign="top" >Connector</td>

<td valign="top" >property to suggest an Y offset for a


connector</td>

</tr>

<tr>

<td rowspan="3" valign="top" >Optional</td>

<td valign="top" >“scaling mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "None", "Full", "Center", "Full


aspect" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"aspect ratio"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "None", "4:3", "16:9" }</td>

<td valign="top" >Connector</td>

<td valign="top" >DRM property to set aspect ratio from


user space app.

This enum is made generic to allow addition of



custom aspect

ratios.</td>


</tr>

<tr>

<td valign="top" >“dirty”</td>

<td valign="top" >ENUM | IMMUTABLE</td>

<td valign="top" >{ "Off", "On", "Annotate" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="20" valign="top" >i915</td>

<td rowspan="2" valign="top" >Generic</td>

<td valign="top" >"Broadcast RGB"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "Automatic", "Full", "Limited 16:235"


}</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“audio”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "force-dvi", "off", "auto", "on"


}</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="17" valign="top" >SDVO-TV</td>

<td valign="top" >“mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "NTSC_M", "NTSC_J", "NTSC_443",


"PAL_B" } etc.</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"left_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"right_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"top_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"bottom_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hpos”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“vpos”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“contrast”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“saturation”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hue”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“sharpness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter_adaptive”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter_2d”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“tv_chroma_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“tv_luma_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“dot_crawl”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >SDVO-TV/LVDS</td>

<td valign="top" >“brightness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="2" valign="top" >CDV gma-500</td>

<td rowspan="2" valign="top" >Generic</td>

<td valign="top" >"Broadcast RGB"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ “Full”, “Limited 16:235” }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"Broadcast RGB"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ “off”, “auto”, “on” }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="19" valign="top" >Poulsbo</td>

<td rowspan="1" valign="top" >Generic</td>

<td valign="top" >“backlight”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=100</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="17" valign="top" >SDVO-TV</td>

<td valign="top" >“mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "NTSC_M", "NTSC_J", "NTSC_443",


"PAL_B" } etc.</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"left_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"right_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"top_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"bottom_margin"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hpos”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“vpos”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“contrast”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“saturation”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hue”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“sharpness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter_adaptive”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“flicker_filter_2d”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“tv_chroma_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“tv_luma_filter”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“dot_crawl”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >SDVO-TV/LVDS</td>

<td valign="top" >“brightness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max= SDVO dependent</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="11" valign="top" >armada</td>

<td rowspan="2" valign="top" >CRTC</td>

<td valign="top" >"CSC_YUV"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "Auto" , "CCIR601", "CCIR709" }</td>

<td valign="top" >CRTC</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"CSC_RGB"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "Auto", "Computer system", "Studio"


}</td>

<td valign="top" >CRTC</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="9" valign="top" >Overlay</td>

<td valign="top" >"colorkey"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey_min"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey_max"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey_val"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey_alpha"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0xffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey_mode"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "disabled", "Y component", "U


component"

, "V component", "RGB", “R component", "G component", "B

component" }</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"brightness"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=256 + 255</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"contrast"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0x7fff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"saturation"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0x7fff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="2" valign="top" >exynos</td>

<td valign="top" >CRTC</td>

<td valign="top" >“mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "normal", "blank" }</td>

<td valign="top" >CRTC</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >Overlay</td>

<td valign="top" >“zpos”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=MAX_PLANE-1</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="2" valign="top" >i2c/ch7006_drv</td>

<td valign="top" >Generic</td>

<td valign="top" >“scale”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=2</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="1" valign="top" >TV</td>

<td valign="top" >“mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "PAL", "PAL-M","PAL-N"}, ”PAL-Nc"

, "PAL-60", "NTSC-M", "NTSC-J" }</td>
<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="15" valign="top" >nouveau</td>

<td rowspan="6" valign="top" >NV10 Overlay</td>

<td valign="top" >"colorkey"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0x01ffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“contrast”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=8192-1</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“brightness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1024</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“hue”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=359</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“saturation”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=8192-1</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“iturbt_709”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="2" valign="top" >Nv04 Overlay</td>

<td valign="top" >“colorkey”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0x01ffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“brightness”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1024</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="7" valign="top" >Display</td>

<td valign="top" >“dithering mode”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "auto", "off", "on" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“dithering depth”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "auto", "off", "on", "static 2x2",


"dynamic 2x2", "temporal" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“underscan”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "auto", "6 bpc", "8 bpc" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“underscan hborder”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=128</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“underscan vborder”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=128</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“vibrant hue”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=180</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >“color vibrance”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=200</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >omap</td>

<td valign="top" >Generic</td>

<td valign="top" >“zorder”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=3</td>

<td valign="top" >CRTC, Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >qxl</td>

<td valign="top" >Generic</td>

<td valign="top" >“hotplug_mode_update"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="9" valign="top" >radeon</td>

<td valign="top" >DVI-I</td>

<td valign="top" >“coherent”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >DAC enable load detect</td>

<td valign="top" >“load detection”</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=1</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >TV Standard</td>

<td valign="top" >"tv standard"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "ntsc", "pal", "pal-m", "pal-60",


"ntsc-j"

, "scart-pal", "pal-cn", "secam" }</td>
<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >legacy TMDS PLL detect</td>

<td valign="top" >"tmds_pll"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "driver", "bios" }</td>

<td valign="top" >-</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="3" valign="top" >Underscan</td>

<td valign="top" >"underscan"</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "off", "on", "auto" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"underscan hborder"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=128</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"underscan vborder"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=128</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >Audio</td>

<td valign="top" >“audio”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "off", "on", "auto" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >FMT Dithering</td>

<td valign="top" >“dither”</td>

<td valign="top" >ENUM</td>

<td valign="top" >{ "off", "on" }</td>

<td valign="top" >Connector</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td rowspan="3" valign="top" >rcar-du</td>

<td rowspan="3" valign="top" >Generic</td>

<td valign="top" >"alpha"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=255</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"colorkey"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=0, Max=0x01ffffff</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

<tr>

<td valign="top" >"zpos"</td>

<td valign="top" >RANGE</td>

<td valign="top" >Min=1, Max=7</td>

<td valign="top" >Plane</td>

<td valign="top" >TBD</td>

</tr>

</tbody>

</table>


+<!-- Graham -->

 <title>Existing KMS Properties</title>


 <para>


   The following table gives description of drm properties



exposed by various

   modules/drivers.


 </para>


 <table>


   <title>Existing KMS Properties</title>


   <tgroup cols="7">


     <thead>


       <row>


         <entry>Owner Module/Drivers</entry>


         <entry>Group</entry>


         <entry>Property Name</entry>


         <entry>Type</entry>


         <entry>Property Values</entry>


         <entry>Object attached</entry>


         <entry>Description/Restrictions</entry>


       </row>


     </thead>


     <tbody valign="top">


     <row>


       <entry morerows="36">DRM</entry>


       <entry>Generic</entry>


       <entry>“rotation”</entry>


       <entry>BITMASK</entry>


       <entry>{ 0, &quot;rotate-0&quot; },


         { 1, &quot;rotate-90&quot; },


         { 2, &quot;rotate-180&quot; },


         { 3, &quot;rotate-270&quot; },


         { 4, &quot;reflect-x&quot; },


         { 5, &quot;reflect-y&quot; }</entry>


       <entry>CRTC, Plane</entry>


       <entry>rotate-(degrees) rotates the image by the



specified amount

         in degrees in counter clockwise direction. reflect-x



and reflect-y

         reflects the image along the specified axis prior to


         rotation</entry>


     </row>


     <row>


       <entry morerows="4" >Connector</entry>


       <entry>“EDID”</entry>


       <entry>BLOB | IMMUTABLE</entry>


       <entry>0</entry>


       <entry>Connector</entry>


       <entry>Contains id of edid blob ptr object.</entry>


     </row>


     <row>


       <entry>“DPMS”</entry>


       <entry>ENUM</entry>


       <entry>{ “On”, “Standby”, “Suspend”, “Off” }</entry>


       <entry>Connector</entry>


       <entry>Contains DPMS operation mode value.</entry>


     </row>


     <row>


       <entry>“PATH”</entry>


       <entry>BLOB | IMMUTABLE</entry>


       <entry>0</entry>


       <entry>Connector</entry>


       <entry>Contains topology path to a connector.</entry>


     </row>


     <row>


       <entry>“TILE”</entry>


       <entry>BLOB | IMMUTABLE</entry>


       <entry>0</entry>


       <entry>Connector</entry>


       <entry>Contains tiling information for a



connector.</entry>

     </row>


     <row>


       <entry>“CRTC_ID”</entry>


       <entry>OBJECT</entry>


       <entry>DRM_MODE_OBJECT_CRTC</entry>


       <entry>Connector</entry>


       <entry>CRTC that connector is attached to



(atomic)</entry>

     </row>


     <row>


       <entry morerows="10">Plane</entry>


       <entry>“type”</entry>


       <entry>ENUM | IMMUTABLE</entry>


       <entry>{ &quot;Overlay&quot;, &quot;Primary&quot;,



&quot;Cursor&quot; }</entry>

       <entry>Plane</entry>


       <entry>Plane type</entry>


     </row>


     <row>


       <entry>“SRC_X”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout source x coordinate in 16.16 fixed



point (atomic)</entry>

     </row>


     <row>


       <entry>“SRC_Y”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout source y coordinate in 16.16 fixed



point (atomic)</entry>

     </row>


     <row>


       <entry>“SRC_W”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout source width in 16.16 fixed point



(atomic)</entry>

     </row>


     <row>


       <entry>“SRC_H”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout source height in 16.16 fixed point



(atomic)</entry>

     </row>


     <row>


       <entry>“CRTC_X”</entry>


       <entry>SIGNED_RANGE</entry>


       <entry>Min=INT_MIN, Max=INT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout CRTC (destination) x coordinate



(atomic)</entry>

     </row>


     <row>


       <entry>“CRTC_Y”</entry>


       <entry>SIGNED_RANGE</entry>


       <entry>Min=INT_MIN, Max=INT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout CRTC (destination) y coordinate



(atomic)</entry>

     </row>


     <row>


       <entry>“CRTC_W”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout CRTC (destination) width



(atomic)</entry>

     </row>


     <row>


       <entry>“CRTC_H”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=UINT_MAX</entry>


       <entry>Plane</entry>


       <entry>Scanout CRTC (destination) height



(atomic)</entry>

     </row>


     <row>


       <entry>“FB_ID”</entry>


       <entry>OBJECT</entry>


       <entry>DRM_MODE_OBJECT_FB</entry>


       <entry>Plane</entry>


       <entry>Scanout framebuffer (atomic)</entry>


     </row>


     <row>


       <entry>“CRTC_ID”</entry>


       <entry>OBJECT</entry>


       <entry>DRM_MODE_OBJECT_CRTC</entry>


       <entry>Plane</entry>


       <entry>CRTC that plane is attached to (atomic)</entry>


     </row>


     <row>


       <entry morerows="1">DVI-I</entry>


       <entry>“subconnector”</entry>


       <entry>ENUM</entry>


       <entry>{ “Unknown”, “DVI-D”, “DVI-A” }</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“select subconnector”</entry>


       <entry>ENUM</entry>


       <entry>{ “Automatic”, “DVI-D”, “DVI-A” }</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="12">TV</entry>


       <entry>“subconnector”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;Unknown&quot;, &quot;Composite&quot;,



&quot;SVIDEO&quot;, &quot;Component&quot;, &quot;SCART&quot;
}</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“select subconnector”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;Automatic&quot;, &quot;Composite&quot;,



&quot;SVIDEO&quot;, &quot;Component&quot;, &quot;SCART&quot;
}</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;NTSC_M&quot;, &quot;NTSC_J&quot;,



&quot;NTSC_443&quot;, &quot;PAL_B&quot; } etc.</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“left margin”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“right margin”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“top margin”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“bottom margin”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“brightness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“contrast”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker reduction”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“overscan”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“saturation”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hue”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="1">Virtual GPU</entry>


       <entry>“suggested X”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffffff</entry>


       <entry>Connector</entry>


       <entry>property to suggest an X offset for a



connector</entry>

     </row>


     <row>


       <entry>“suggested Y”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffffff</entry>


       <entry>Connector</entry>


       <entry>property to suggest an Y offset for a



connector</entry>

     </row>


     <row>


       <entry morerows="2">Optional</entry>


       <entry>“scaling mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;None&quot;, &quot;Full&quot;,



&quot;Center&quot;, &quot;Full aspect&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;aspect ratio&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;None&quot;, &quot;4:3&quot;,



&quot;16:9&quot; }</entry>

       <entry>Connector</entry>


       <entry>DRM property to set aspect ratio from user



space app.

         This enum is made generic to allow addition of



custom aspect

         ratios.</entry>


     </row>


     <row>


       <entry>“dirty”</entry>


       <entry>ENUM | IMMUTABLE</entry>


       <entry>{ &quot;Off&quot;, &quot;On&quot;,



&quot;Annotate&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="19">i915</entry>


       <entry morerows="1">Generic</entry>


       <entry>&quot;Broadcast RGB&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;Automatic&quot;, &quot;Full&quot;,



&quot;Limited 16:235&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“audio”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;force-dvi&quot;, &quot;off&quot;,



&quot;auto&quot;, &quot;on&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="16">SDVO-TV</entry>


       <entry>“mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;NTSC_M&quot;, &quot;NTSC_J&quot;,



&quot;NTSC_443&quot;, &quot;PAL_B&quot; } etc.</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;left_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;right_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;top_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;bottom_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hpos”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“vpos”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“contrast”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“saturation”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hue”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“sharpness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter_adaptive”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter_2d”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“tv_chroma_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“tv_luma_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“dot_crawl”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>SDVO-TV/LVDS</entry>


       <entry>“brightness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="1">CDV gma-500</entry>


       <entry morerows="1">Generic</entry>


       <entry>&quot;Broadcast RGB&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ “Full”, “Limited 16:235” }</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;Broadcast RGB&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ “off”, “auto”, “on” }</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="18">Poulsbo</entry>


       <entry>Generic</entry>


       <entry>“backlight”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=100</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="16">SDVO-TV</entry>


       <entry>“mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;NTSC_M&quot;, &quot;NTSC_J&quot;,



&quot;NTSC_443&quot;, &quot;PAL_B&quot; } etc.</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;left_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;right_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;top_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;bottom_margin&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hpos”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“vpos”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“contrast”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“saturation”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hue”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“sharpness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter_adaptive”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“flicker_filter_2d”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“tv_chroma_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“tv_luma_filter”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“dot_crawl”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>SDVO-TV/LVDS</entry>


       <entry>“brightness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max= SDVO dependent</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="10">armada</entry>


       <entry morerows="1">CRTC</entry>


       <entry>&quot;CSC_YUV&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;Auto&quot; , &quot;CCIR601&quot;,



&quot;CCIR709&quot; }</entry>

       <entry>CRTC</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;CSC_RGB&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;Auto&quot;, &quot;Computer



system&quot;, &quot;Studio&quot; }</entry>

       <entry>CRTC</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="8">Overlay</entry>


       <entry>&quot;colorkey&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey_min&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey_max&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey_val&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey_alpha&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0xffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey_mode&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;disabled&quot;, &quot;Y



component&quot;, &quot;U component&quot;

   , &quot;V component&quot;, &quot;RGB&quot;, “R



component&quot;, &quot;G component&quot;, &quot;B component&quot;
}</entry>

       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;brightness&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=256 + 255</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;contrast&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0x7fff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;saturation&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0x7fff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="1">exynos</entry>


       <entry>CRTC</entry>


       <entry>“mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;normal&quot;, &quot;blank&quot;



}</entry>

       <entry>CRTC</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>Overlay</entry>


       <entry>“zpos”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=MAX_PLANE-1</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="1">i2c/ch7006_drv</entry>


       <entry>Generic</entry>


       <entry>“scale”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=2</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>TV</entry>


       <entry>“mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;PAL&quot;, &quot;PAL-M&quot;,&quot;PAL



-N&quot;}, ”PAL-Nc&quot;

   , &quot;PAL-60&quot;, &quot;NTSC-M&quot;, &quot;NTSC



-J&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="14">nouveau</entry>


       <entry morerows="5">NV10 Overlay</entry>


       <entry>&quot;colorkey&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0x01ffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“contrast”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=8192-1</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“brightness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1024</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“hue”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=359</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“saturation”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=8192-1</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“iturbt_709”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="1">Nv04 Overlay</entry>


       <entry>“colorkey”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0x01ffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“brightness”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1024</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="6">Display</entry>


       <entry>“dithering mode”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;auto&quot;, &quot;off&quot;,



&quot;on&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“dithering depth”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;auto&quot;, &quot;off&quot;,



&quot;on&quot;, &quot;static 2x2&quot;, &quot;dynamic 2x2&quot;,
&quot;temporal&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“underscan”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;auto&quot;, &quot;6 bpc&quot;, &quot;8



bpc&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“underscan hborder”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=128</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“underscan vborder”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=128</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“vibrant hue”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=180</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>“color vibrance”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=200</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>omap</entry>


       <entry>Generic</entry>


       <entry>“zorder”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=3</entry>


       <entry>CRTC, Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>qxl</entry>


       <entry>Generic</entry>


       <entry>“hotplug_mode_update&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="8">radeon</entry>


       <entry>DVI-I</entry>


       <entry>“coherent”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>DAC enable load detect</entry>


       <entry>“load detection”</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=1</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>TV Standard</entry>


       <entry>&quot;tv standard&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;ntsc&quot;, &quot;pal&quot;, &quot;pal



-m&quot;, &quot;pal-60&quot;, &quot;ntsc-j&quot;

   , &quot;scart-pal&quot;, &quot;pal-cn&quot;,



&quot;secam&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>legacy TMDS PLL detect</entry>


       <entry>&quot;tmds_pll&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;driver&quot;, &quot;bios&quot;



}</entry>

       <entry>-</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="2">Underscan</entry>


       <entry>&quot;underscan&quot;</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;off&quot;, &quot;on&quot;,



&quot;auto&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;underscan hborder&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=128</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;underscan vborder&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=128</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>Audio</entry>


       <entry>“audio”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;off&quot;, &quot;on&quot;,



&quot;auto&quot; }</entry>

       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>FMT Dithering</entry>


       <entry>“dither”</entry>


       <entry>ENUM</entry>


       <entry>{ &quot;off&quot;, &quot;on&quot; }</entry>


       <entry>Connector</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry morerows="2">rcar-du</entry>


       <entry morerows="2">Generic</entry>


       <entry>&quot;alpha&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=255</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;colorkey&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=0, Max=0x01ffffff</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


     <row>


       <entry>&quot;zpos&quot;</entry>


       <entry>RANGE</entry>


       <entry>Min=1, Max=7</entry>


       <entry>Plane</entry>


       <entry>TBD</entry>


     </row>


   </tbody>


 </tgroup>


</table>


+<!-- Graham -->
     </sect2>
   </sect1>
-- 
2.4.3

Intel-gfx mailing list
Intel-gfx@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/intel-gfx

    

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

Re: [Intel-gfx] [PATCH 4/5] Documentation: drm: Convert KMS Properties HTML table to CALS

Signed-off-by: Graham Whaley graham.whaley@linux.intel.com

Documentation/DocBook/drm.tmpl | 1866 ++++++++++++++++++++--------