From c64c97581c8a0102b74ae9b53ef872bc29e203bd Mon Sep 17 00:00:00 2001 From: Cedrick Emond Date: Tue, 4 Nov 2025 10:55:59 -0500 Subject: [PATCH 1/7] Analytics: Added aspect ratio transformation for metadata frame --- doc/Analytics.xml | 37 ++++++++++++++++++++++++++++ wsdl/ver10/schema/common.xsd | 8 ++++++ wsdl/ver10/schema/metadatastream.xsd | 1 + 3 files changed, 46 insertions(+) diff --git a/doc/Analytics.xml b/doc/Analytics.xml index 64630df7b..b47181f21 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -654,6 +654,43 @@ ... + +]]> + +
+ Aspect Ratio Dependant Transformation + This section describes the transformation specific to a scene aspect ratio. + Same as the transformation node, this node is used to apply geometric transformations to the scene elements. It allows for the adjustment of position, scale, and aspect ratio of the objects within the scene. + However, when the device offers more than one aspect ratio, this node lets the client choose which transformation to apply to match the metadata aspect ratio to the rendered aspect ratio + The aspect ratio transformation node can contain the following elements: + + + + + ... + + +]]> + For example, the coordinates of the scene description are given in a frame coordinate system, where the lower-left corner has coordinates (0,0) and the upper-right corner coordinates (320,240). The video source aspect is 4:3. The frame node resembles the following code where the scale is set to crop image to other supported aspect ratios: + + + 15:9 + + + + + + + 16:9 + + + + + + ... + +]]> + ]]>
diff --git a/wsdl/ver10/schema/common.xsd b/wsdl/ver10/schema/common.xsd index 152655db5..dc6a6a7dc 100644 --- a/wsdl/ver10/schema/common.xsd +++ b/wsdl/ver10/schema/common.xsd @@ -267,6 +267,14 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO + + + + + + + + diff --git a/wsdl/ver10/schema/metadatastream.xsd b/wsdl/ver10/schema/metadatastream.xsd index 83973628e..463122f6e 100644 --- a/wsdl/ver10/schema/metadatastream.xsd +++ b/wsdl/ver10/schema/metadatastream.xsd @@ -291,6 +291,7 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO + From b0380d52aa1e0fb5b5dc3d984cb49c234dbba75b Mon Sep 17 00:00:00 2001 From: Cedrick Emond Date: Wed, 5 Nov 2025 17:22:27 -0500 Subject: [PATCH 2/7] Simplify AspectRatioTransformation node and review doc --- doc/Analytics.xml | 28 +++++++++++----------------- wsdl/ver10/schema/common.xsd | 4 ++-- 2 files changed, 13 insertions(+), 19 deletions(-) diff --git a/doc/Analytics.xml b/doc/Analytics.xml index b47181f21..a49d4cdbb 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -660,32 +660,26 @@
Aspect Ratio Dependant Transformation This section describes the transformation specific to a scene aspect ratio. - Same as the transformation node, this node is used to apply geometric transformations to the scene elements. It allows for the adjustment of position, scale, and aspect ratio of the objects within the scene. - However, when the device offers more than one aspect ratio, this node lets the client choose which transformation to apply to match the metadata aspect ratio to the rendered aspect ratio + Same as the transformation node, this node is used to apply initial geometric transformations to the scene elements. It allows for the adjustment of the position, scale, and aspect ratio of the objects within the scene. + However, when the device supports more than one aspect ratio, this node allows the client to choose which transformation to apply, matching the metadata aspect ratio to the rendered aspect ratio. The aspect ratio transformation node can contain the following elements: - - + + ... ]]> - For example, the coordinates of the scene description are given in a frame coordinate system, where the lower-left corner has coordinates (0,0) and the upper-right corner coordinates (320,240). The video source aspect is 4:3. The frame node resembles the following code where the scale is set to crop image to other supported aspect ratios: + For example, the coordinates of the scene description are given in a frame coordinate system, where the lower-left corner has coordinates (0,0) and the upper-right corner coordinates (320,240). The video source aspect is 4:3. The frame node resembles the following code, where the scale is set to crop the image to other supported aspect ratios: - - 15:9 - - - - + + + - - 16:9 - - - - + + ... diff --git a/wsdl/ver10/schema/common.xsd b/wsdl/ver10/schema/common.xsd index dc6a6a7dc..849f23e30 100644 --- a/wsdl/ver10/schema/common.xsd +++ b/wsdl/ver10/schema/common.xsd @@ -269,8 +269,8 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO - - + + From 0f6b15c01757c687cce1fa51c66e14997350bce0 Mon Sep 17 00:00:00 2001 From: Cedrick Emond Date: Wed, 5 Nov 2025 17:45:02 -0500 Subject: [PATCH 3/7] Fix xml tags --- doc/Analytics.xml | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/doc/Analytics.xml b/doc/Analytics.xml index a49d4cdbb..d7474a9bc 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -660,8 +660,7 @@
Aspect Ratio Dependant Transformation This section describes the transformation specific to a scene aspect ratio. - Same as the transformation node, this node is used to apply initial geometric transformations to the scene elements. It allows for the adjustment of the position, scale, and aspect ratio of the objects within the scene. - However, when the device supports more than one aspect ratio, this node allows the client to choose which transformation to apply, matching the metadata aspect ratio to the rendered aspect ratio. + Same as the transformation node, this node is used to apply initial geometric transformations to the scene elements. However, when the device supports more than one aspect ratio, this node allows the client to choose which transformation to apply, matching the metadata aspect ratio to the rendered aspect ratio. The aspect ratio transformation node can contain the following elements: @@ -684,10 +683,6 @@ ... ]]> - - -]]> -
Scene Elements From b4968275c703df4e5cec69f0e9bd77bf7b308ac2 Mon Sep 17 00:00:00 2001 From: Cedrick Emond Date: Wed, 5 Nov 2025 17:47:27 -0500 Subject: [PATCH 4/7] Fix missing end section --- doc/Analytics.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/Analytics.xml b/doc/Analytics.xml index d7474a9bc..593daf42f 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -656,6 +656,7 @@ ... ]]> +
Aspect Ratio Dependant Transformation From 4ddddac8280ee8432b0e65f3481b641d76f4a702 Mon Sep 17 00:00:00 2001 From: Cedrick Emond Date: Thu, 6 Nov 2025 13:35:44 -0500 Subject: [PATCH 5/7] Indentation of aspect ratio transformation example --- doc/Analytics.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/Analytics.xml b/doc/Analytics.xml index 593daf42f..50e72c144 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -674,8 +674,8 @@ For example, the coordinates of the scene description are given in a frame coordinate system, where the lower-left corner has coordinates (0,0) and the upper-right corner coordinates (320,240). The video source aspect is 4:3. The frame node resembles the following code, where the scale is set to crop the image to other supported aspect ratios: - - + + From 6a2dce7f612addbbb162e05f2c26c441a39b5d8e Mon Sep 17 00:00:00 2001 From: Cedrick Emond Date: Wed, 12 Nov 2025 10:22:11 +0800 Subject: [PATCH 6/7] Fix aspect ratio transformation is final and simply the sentence --- doc/Analytics.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/Analytics.xml b/doc/Analytics.xml index 50e72c144..e6cd95308 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -661,7 +661,7 @@
Aspect Ratio Dependant Transformation This section describes the transformation specific to a scene aspect ratio. - Same as the transformation node, this node is used to apply initial geometric transformations to the scene elements. However, when the device supports more than one aspect ratio, this node allows the client to choose which transformation to apply, matching the metadata aspect ratio to the rendered aspect ratio. + Same as the transformation node, this node is used to apply final geometric transformations to the scene elements when the device supports more than one aspect ratio. This node allows the client to choose which transformation to apply, matching the metadata aspect ratio to the rendered aspect ratio. The aspect ratio transformation node can contain the following elements: From 7280587200af7658b540fbca865b2a5697872f19 Mon Sep 17 00:00:00 2001 From: Cedrick Emond Date: Wed, 12 Nov 2025 12:20:05 +0800 Subject: [PATCH 7/7] Add clarification when and which aspect ratio transformation is required --- doc/Analytics.xml | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/doc/Analytics.xml b/doc/Analytics.xml index e6cd95308..79da8a5de 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -671,19 +671,18 @@ ]]> - For example, the coordinates of the scene description are given in a frame coordinate system, where the lower-left corner has coordinates (0,0) and the upper-right corner coordinates (320,240). The video source aspect is 4:3. The frame node resembles the following code, where the scale is set to crop the image to other supported aspect ratios: + For example, the coordinates of the scene description are given in a frame coordinate system, where the lower-left corner has coordinates (0,0) and the upper-right corner coordinates (320,240). The video source aspect ratio is 4:3. The frame node resembles the following code, where the scale is set to crop the image to other supported aspect ratios: - ... ]]> + In every Frame, the device must add the nodes for at least the currently configured aspect ratios. The node for the video source aspect ratio should be omitted.
Scene Elements