ecore_wl2: enhance document of exported shell 05/259805/1
authorShinwoo Kim <cinoo.kim@samsung.com>
Tue, 15 Jun 2021 02:25:28 +0000 (11:25 +0900)
committerShinwoo Kim <cinoo.kim@samsung.com>
Tue, 15 Jun 2021 02:25:28 +0000 (11:25 +0900)
The parameter transform without any information is not kind.
We need to provide more information refering to:

  wayland-extension/protocol/tizen/wtz-foreign.xml

Change-Id: Ic1ab7dece1a1e6e3a19eeb313f012589ff6fc61e

src/lib/ecore_wl2/Ecore_Wl2.h
src/lib/ecore_wl2/ecore_wl2_subsurf.c

index 2c725c3..efe6990 100644 (file)
@@ -3408,6 +3408,13 @@ EAPI void ecore_wl2_subsurface_exported_surface_resize(Ecore_Wl2_Subsurface *sub
  *
  * @param subsurface the subsurface
  * @param transform The exported surface transform being requested
+ * The available values of transform are:
+ * <ul style="list-style-type:none">
+ *     <li>0 - no transform (WTZ_EXPORTED_SHELL_TRANSFORM_NORMAL)</li>
+ *     <li>1 - 90 degrees clockwise (WTZ_EXPORTED_SHELL_TRANSFORM_90)</li>
+ *     <li>2 - 180 degrees clockwise (WTZ_EXPORTED_SHELL_TRANSFORM_180)</li>
+ *     <li>3 - 270 degrees clockwise (WTZ_EXPORTED_SHELL_TRANSFORM_270)</li>
+ * </ul>
  *
  * @ingroup Ecore_Wl2_Subsurface_Group
  * @since_tizen 6.5
index 37bf58f..c1cd0a2 100644 (file)
@@ -385,6 +385,10 @@ ecore_wl2_subsurface_exported_surface_transform_set(Ecore_Wl2_Subsurface *subsur
 {
    EINA_SAFETY_ON_NULL_RETURN(subsurface);
    EINA_SAFETY_ON_NULL_RETURN(subsurface->wl.fs);
+
+   if (transform < WTZ_EXPORTED_SHELL_TRANSFORM_NORMAL ||
+       transform > WTZ_EXPORTED_SHELL_TRANSFORM_270) return;
+
    wtz_exported_shell_set_transform(subsurface->wl.fs, transform);
 }