From c64c97581c8a0102b74ae9b53ef872bc29e203bd Mon Sep 17 00:00:00 2001 From: Cedrick Emond Date: Tue, 4 Nov 2025 10:55:59 -0500 Subject: [PATCH 01/10] 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 02/10] 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 03/10] 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 04/10] 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 05/10] 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 06/10] 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 07/10] 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 From 890ab226d39165a4b47a762de997979568e4670a Mon Sep 17 00:00:00 2001 From: Cedrick Emond Date: Fri, 23 Jan 2026 16:03:18 -0500 Subject: [PATCH 08/10] Add clarification for the Scale calculation for the centered crop example --- doc/Analytics.xml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/Analytics.xml b/doc/Analytics.xml index 79da8a5de..e5c33f26d 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -671,7 +671,11 @@ ]]> - 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: + If the transformation is a centered crop on one axis, no Translate vector is needed and Scale vector is calculated with this formula. + For the rendered aspect ratios greater than the video source aspect ratio, fix ScaleX = 1 and compute ScaleY = RenderedAspectRatio / VideoSourceAspectRatio. + For the rendered aspect ratios less than the video source aspect ratio, fix ScaleY = 1 and compute ScaleX = VideoSourceAspectRatio / RenderedAspectRatio. + 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 (1920,1440). The video source aspect ratio is 4:3. The device supports resolutions 1920x1080 and 960x576 corresponding aspect ratio 16:9 = 1.77777778 and 5:3 = 1.66666667. + The frame node resembles the following code, where the scale is set to crop the image to other supported aspect ratios: From c39dfa96d7fd13f1880b8d45c7e384cbab5fd1d4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A9drick=20Emond?= Date: Fri, 13 Feb 2026 14:34:19 -0500 Subject: [PATCH 09/10] Add missing required ratio attribute in AspectRatioTransformation type --- doc/Analytics.xml | 1 + wsdl/ver10/schema/common.xsd | 1 + 2 files changed, 2 insertions(+) diff --git a/doc/Analytics.xml b/doc/Analytics.xml index e5c33f26d..65d24ed82 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -665,6 +665,7 @@ The aspect ratio transformation node can contain the following elements: + ... diff --git a/wsdl/ver10/schema/common.xsd b/wsdl/ver10/schema/common.xsd index 849f23e30..0a9d68943 100644 --- a/wsdl/ver10/schema/common.xsd +++ b/wsdl/ver10/schema/common.xsd @@ -269,6 +269,7 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO + From 33746e8284e3245ad7004339f88c034be27e213f Mon Sep 17 00:00:00 2001 From: Cedrick Emond Date: Thu, 19 Feb 2026 13:24:09 -0500 Subject: [PATCH 10/10] Move ratio attribute of AspectRatioTransformation out of the sequence --- doc/Analytics.xml | 2 +- wsdl/ver10/schema/common.xsd | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/Analytics.xml b/doc/Analytics.xml index 65d24ed82..27b0d2eac 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -665,11 +665,11 @@ The aspect ratio transformation node can contain the following elements: - ... + ]]> If the transformation is a centered crop on one axis, no Translate vector is needed and Scale vector is calculated with this formula. diff --git a/wsdl/ver10/schema/common.xsd b/wsdl/ver10/schema/common.xsd index 0a9d68943..1279e4f13 100644 --- a/wsdl/ver10/schema/common.xsd +++ b/wsdl/ver10/schema/common.xsd @@ -269,11 +269,11 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO - +