Add a blob property for plane CSC usage.

v2: Rebase

v3: Fixed Sean, Paul's review comments. Moved the property from
mode_config to drm_plane. Created a helper function to instantiate
these properties and removed from drm_mode_create_standard_properties
Added property documentation as suggested by Daniel, Vetter.

v4: Rebase

v5: Moved property creation to drm_color_mgmt.c file to have all
color operations consolidated at one place. No logical change.

Signed-off-by: Uma Shankar <[email protected]>
Reviewed-by: Alexandru Gheorghe <[email protected]>
---
 Documentation/gpu/drm-kms.rst       |  3 +++
 drivers/gpu/drm/drm_atomic.c        | 10 ++++++++++
 drivers/gpu/drm/drm_atomic_helper.c |  4 ++++
 drivers/gpu/drm/drm_color_mgmt.c    | 12 ++++++++++++
 include/drm/drm_plane.h             | 15 +++++++++++++++
 5 files changed, 44 insertions(+)

diff --git a/Documentation/gpu/drm-kms.rst b/Documentation/gpu/drm-kms.rst
index 253d546..d0391a9 100644
--- a/Documentation/gpu/drm-kms.rst
+++ b/Documentation/gpu/drm-kms.rst
@@ -647,6 +647,9 @@ Plane Color Management Properties
 .. kernel-doc:: drivers/gpu/drm/drm_color_mgmt.c
    :doc: export
 
+.. kernel-doc:: drivers/gpu/drm/drm_color_mgmt.c
+   :doc: ctm_property
+
 Tile Group Property
 -------------------
 
diff --git a/drivers/gpu/drm/drm_atomic.c b/drivers/gpu/drm/drm_atomic.c
index e716614..fd1d0d1 100644
--- a/drivers/gpu/drm/drm_atomic.c
+++ b/drivers/gpu/drm/drm_atomic.c
@@ -919,6 +919,14 @@ static int drm_atomic_plane_set_property(struct drm_plane 
*plane,
                                        &replaced);
                state->color_mgmt_changed |= replaced;
                return ret;
+       } else if (property == plane->ctm_property) {
+               ret = drm_atomic_replace_property_blob_from_id(dev,
+                                       &state->ctm,
+                                       val,
+                                       sizeof(struct drm_color_ctm), -1,
+                                       &replaced);
+               state->color_mgmt_changed |= replaced;
+               return ret;
        } else if (plane->funcs->atomic_set_property) {
                return plane->funcs->atomic_set_property(plane, state,
                                property, val);
@@ -992,6 +1000,8 @@ static int drm_atomic_plane_set_property(struct drm_plane 
*plane,
        } else if (property == plane->degamma_lut_property) {
                *val = (state->degamma_lut) ?
                        state->degamma_lut->base.id : 0;
+       } else if (property == plane->ctm_property) {
+               *val = (state->ctm) ? state->ctm->base.id : 0;
        } else if (plane->funcs->atomic_get_property) {
                return plane->funcs->atomic_get_property(plane, state, 
property, val);
        } else {
diff --git a/drivers/gpu/drm/drm_atomic_helper.c 
b/drivers/gpu/drm/drm_atomic_helper.c
index 203137e..75428425 100644
--- a/drivers/gpu/drm/drm_atomic_helper.c
+++ b/drivers/gpu/drm/drm_atomic_helper.c
@@ -3617,6 +3617,9 @@ void __drm_atomic_helper_plane_duplicate_state(struct 
drm_plane *plane,
 
        if (state->degamma_lut)
                drm_property_blob_get(state->degamma_lut);
+       if (state->ctm)
+               drm_property_blob_get(state->ctm);
+
        state->color_mgmt_changed = false;
 }
 EXPORT_SYMBOL(__drm_atomic_helper_plane_duplicate_state);
@@ -3664,6 +3667,7 @@ void __drm_atomic_helper_plane_destroy_state(struct 
drm_plane_state *state)
                drm_crtc_commit_put(state->commit);
 
        drm_property_blob_put(state->degamma_lut);
+       drm_property_blob_put(state->ctm);
 }
 EXPORT_SYMBOL(__drm_atomic_helper_plane_destroy_state);
 
diff --git a/drivers/gpu/drm/drm_color_mgmt.c b/drivers/gpu/drm/drm_color_mgmt.c
index d8a9e8b..be418e2 100644
--- a/drivers/gpu/drm/drm_color_mgmt.c
+++ b/drivers/gpu/drm/drm_color_mgmt.c
@@ -506,6 +506,11 @@ int drm_plane_create_color_properties(struct drm_plane 
*plane,
  *
  * degamma_lut_size_property:
  *     Range Property to indicate size of the plane degamma LUT.
+ *
+ * ctm_property:
+ *     Blob property which allows a userspace to provide CTM coefficients
+ *     to do color space conversion or any other enhancement by doing a
+ *     matrix multiplication using the h/w CTM processing engine
  */
 int drm_plane_color_create_prop(struct drm_device *dev,
                                struct drm_plane *plane)
@@ -526,6 +531,13 @@ int drm_plane_color_create_prop(struct drm_device *dev,
                return -ENOMEM;
        plane->degamma_lut_size_property = prop;
 
+       prop = drm_property_create(dev,
+                       DRM_MODE_PROP_BLOB,
+                       "PLANE_CTM", 0);
+       if (!prop)
+               return -ENOMEM;
+       plane->ctm_property = prop;
+
        return 0;
 }
 EXPORT_SYMBOL(drm_plane_color_create_prop);
diff --git a/include/drm/drm_plane.h b/include/drm/drm_plane.h
index 7f0d961..335632d 100644
--- a/include/drm/drm_plane.h
+++ b/include/drm/drm_plane.h
@@ -191,6 +191,14 @@ struct drm_plane_state {
        struct drm_property_blob *degamma_lut;
 
        /**
+        * @ctm:
+        *
+        * Color transformation matrix. See drm_plane_enable_color_mgmt(). The
+        * blob (if not NULL) is a &struct drm_color_ctm.
+        */
+       struct drm_property_blob *ctm;
+
+       /**
         * @commit: Tracks the pending commit to prevent use-after-free 
conditions,
         * and for async plane updates.
         *
@@ -714,6 +722,13 @@ struct drm_plane {
         * size of the degamma LUT as supported by the driver (read-only).
         */
        struct drm_property *degamma_lut_size_property;
+
+       /**
+        * @plane_ctm_property: Optional Plane property to set the
+        * matrix used to convert colors after the lookup in the
+        * degamma LUT.
+        */
+       struct drm_property *ctm_property;
 };
 
 #define obj_to_plane(x) container_of(x, struct drm_plane, base)
-- 
1.9.1

_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Reply via email to