summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJakob Bornecrantz <jakob@vmware.com>2009-11-30 00:40:51 +0000
committerJakob Bornecrantz <jakob@vmware.com>2009-11-30 00:40:51 +0000
commit019a408a69896497ca728b703c349306efd1a225 (patch)
treef5006595865dfc8712bf3c5e18d924fd9215e940
parent3e48613b482a8ca01ea5719e9cc342a9d4b28db0 (diff)
Change the dirty ioctl a bit and comment it
-rw-r--r--include/drm/drm_mode.h34
1 files changed, 32 insertions, 2 deletions
diff --git a/include/drm/drm_mode.h b/include/drm/drm_mode.h
index 92526537..042da5c3 100644
--- a/include/drm/drm_mode.h
+++ b/include/drm/drm_mode.h
@@ -222,12 +222,42 @@ struct drm_mode_fb_cmd {
__u32 handle;
};
+#define DRM_MODE_FB_DIRTY_ANNOTATE_COPY 0x01
+#define DRM_MODE_FB_DIRTY_ANNOTATE_FILL 0x02
+#define DRM_MODE_FB_DIRTY_FLAGS 0x03
+
+/*
+ * Mark a region of a framebuffer as dirty.
+ *
+ * Some hardware does not automatically update display contents
+ * as a hardware or software draw to a framebuffer. This ioctl
+ * allows userspace to tell the kernel and the hardware what
+ * regions of the framebuffer have changed.
+ *
+ * The kernel or hardware is free to update more then just the
+ * region specified by the clip rects. The kernel or hardware
+ * may also delay and/or coalesce several calls to dirty into a
+ * single update.
+ *
+ * Userspace may annotate the updates, the annotates are a
+ * promise made by the caller that the change is either a copy
+ * of pixels or a fill of a single color in the region specified.
+ *
+ * If the DRM_MODE_FB_DIRTY_ANNOTATE_COPY flag is given then
+ * the number of updated regions are half of num_clips given,
+ * where the clip rects are paired in src and dst. The width and
+ * height of each one of the pairs must match.
+ *
+ * If the DRM_MODE_FB_DIRTY_ANNOTATE_FILL flag is given the caller
+ * promises that the region specified of the clip rects is filled
+ * completely with a single color as given in the color argument.
+ */
+
struct drm_mode_fb_dirty_cmd {
__u32 fb_id;
__u32 flags;
+ __u32 color;
__u32 num_clips;
- __u32 reserved1;
- __u64 reserved2;
__u64 clips_ptr;
};