summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorChris Wilson <chris@chris-wilson.co.uk>2013-09-17 09:15:40 +0100
committerChris Wilson <chris@chris-wilson.co.uk>2013-09-17 09:29:42 +0100
commitf99e49f7642545f75bac682274767c45c2e6192a (patch)
treef1ab3e74eadd42c97f60581c91a873e2fd49cd1f /man
parent76790db4e6b33a439a6426ec73547904a50047c5 (diff)
intel: Make the option to control VSync and PageFlip explict
Too often our implementation of vsync or pageflip is buggy, or for some other reason it is desired by the user to disable those code paths. Make it possible once again by restoring the Options for the user to control. Signed-off-by: Chris Wilson <chris@chris-wilson.co.uk>
Diffstat (limited to 'man')
-rw-r--r--man/intel.man22
1 files changed, 20 insertions, 2 deletions
diff --git a/man/intel.man b/man/intel.man
index 0a265114..cd217b1a 100644
--- a/man/intel.man
+++ b/man/intel.man
@@ -196,13 +196,31 @@ i.e. perform synchronous rendering.
Default: Disabled
.TP
.TP
+.BI "Option \*qVSync\*q \*q" boolean \*q
+This option controls the use of commands to synchronise rendering with the
+vertical refresh of the display. Some rendering commands have the option
+to be performed in a "tear-free" fashion by stalling the GPU to wait for
+the display to be outside of the region to be updated. This slows down all
+rendering, and historically has been the source of many GPU hangs.
+.IP
+Default: enabled.
+.TP
+.BI "Option \*qPageFlip\*q \*q" boolean \*q
+This option controls the use of commands to flip the scanout address on a
+VBlank. This is used by glXSwapBuffers to efficiently perform the back-to-front
+exchange at the end of a frame without incurring the penalty of a copy, or
+stalling the render pipeline (the flip is performed asynchronrously to the
+render command stream by the display engine). However, it has historically
+been the source of many GPU hangs.
+.IP
+Default: enabled.
+.TP
.BI "Option \*qSwapbuffersWait\*q \*q" boolean \*q
This option controls the behavior of glXSwapBuffers and glXCopySubBufferMESA
calls by GL applications. If enabled, the calls will avoid tearing by making
sure the display scanline is outside of the area to be copied before the copy
occurs. If disabled, no scanline synchronization is performed, meaning tearing
-will likely occur. Note that when enabled, this option can adversely affect
-the framerate of applications that render frames at less than refresh rate.
+will likely occur.
.IP
Default: enabled.
.TP