From 29efb5431ae7f6aebbcc29085ccadacdbce057c6 Mon Sep 17 00:00:00 2001
From: Youngkwon Lim <yklwhite@gmail.com>
Date: Wed, 30 Apr 2025 11:14:47 -0500
Subject: [PATCH 1/2] Add files via upload

adding definition of codecs string structure and sub-parameters

Signed-off-by: Youngkwon Lim <yklwhite@gmail.com>
---
 readme/apv_isobmff.md | 95 +++++++++++++++++++++++++++----------------
 1 file changed, 60 insertions(+), 35 deletions(-)

diff --git a/readme/apv_isobmff.md b/readme/apv_isobmff.md
index 5b815d2..a191e71 100644
--- a/readme/apv_isobmff.md
+++ b/readme/apv_isobmff.md
@@ -26,9 +26,11 @@ The sample entry with APV1SampleEntry type specifies that the track contains APV
 
 ### Syntax
 ~~~~
+
 class APV1SampleEntry extends VisualSampleEntry('apv1'){
 	APVCodecConfigurationBox	config;
 }
+
 ~~~~
 
 ### Semantics
@@ -58,12 +60,14 @@ The box with APVCodecConfigurationBox shall contains APVDecoderConfigurationReco
 ### Syntax
 
 ~~~~
+
 aligned(8) class APVDecoderConfigurationBox extends FullBox('apvC',version=0, flags) {
-    APVDecoderConfigurationRecord apvConfig;
+   APVDecoderConfigurationRecord apvConfig;
 }
+
 ~~~~
 
-## APV Decoder Configuration Record {#APVDecoderConfigurationRecord}		
+## APV Decoder Configuration Record    {#APVDecoderConfigurationRecord}		
 
 The APVDecoderConfigurationRecord contains the information for initial configuration of a decoder which consumes the samples references the sample entry type of apv1. The information in this record is extracted from frame_header() of the bitstream stored in the track containing this record.
 
@@ -72,34 +76,35 @@ All variation of information required to decide appropriate resource for decodin
 ### Syntax
 
 ~~~~
+
 aligned(8) class APVDecoderConfigurationRecord {
-    unsigned int(8) configurationVersion = 1;
-    unsigned int(8) number_of_configuration_entry;
-    for (i=0; i<number_of_configuration_entry; i++) {
-        unsigned int(8) pbu_type[i];
-        unsigned int(8) number_of_frame_info[i];
-        for (j=0; j<number_of_frame_info[i]; j++) {
-            reserved_zero_6bits;
-            unsigned int(1) color_description_present_flag[i][j];
-            unsigned int(1) capture_time_distance_ignored[i][j];
-            unsigned int(8) profile_idc[i][j];
-            unsigned int(8) level_idc[i][j];
-            unsigned int(8) band_idc[i][j];
-            unsigned int(32) frame_width[i][j];
-            unsigned int(32) frame_height[i][j];
-            unsigned int(4) chroma_format_idc[i][j];
-            unsigned int(4) bit_depth_minus8[i][j];
-            unsigned int(8) capture_time_distance[i][j];
-            if (color_description_present_flag[i][j]) {
-                unsigned int(8) color_primaries[i][j];
-                unsigned int(8) transfer_characteristics[i][j];
-                unsigned int(8) matrix_coefficients[i][j];
-                unsigned int(1) full_range_flag[i][j];
-                reserved_zero_7bits;
-            }
-        }
-    }
+   unsigned int(8) configurationVersion = 1;
+   unsigned int(8) number_of_configuration_entry;
+   for (i=0; i<number_of_configuration_entry; i++) {
+      unsigned int(8) pbu_type[i];
+      unsigned int(8) number_of_frame_info[i];
+      for (j=0; j<number_of_frame_info[i]; j++) {
+         reserved_zero_6bits;
+         unsigned int(1) color_description_present_flag[i][j];
+         unsigned int(1) capture_time_distance_ignored[i][j];
+         unsigned int(8) profile_idc[i][j];
+         unsigned int(8) level_idc[i][j];
+         unsigned int(8) band_idc[i][j];
+         unsigned int(32) frame_width[i][j];
+         unsigned int(32) frame_height[i][j];
+         unsigned int(4) chroma_format_idc[i][j];
+         unsigned int(4) bit_depth_minus8[i][j];
+         unsigned int(8) capture_time_distance[i][j];
+         if (color_description_present_flag[i][j]) {
+            unsigned int(8) color_primaries[i][j];
+            unsigned int(8) transfer_characteristics[i][j];
+            unsigned int(8) matrix_coefficients[i][j];
+            unsigned int(1) full_range_flag[i][j];
+         }
+      }
+   }
 }
+
 ~~~~
 
 ### Semantics
@@ -176,14 +181,34 @@ The subsample_priority field shall be set to a value in accordance with the spec
 The discardable field shall be set to 1 only if this sample would still be decodable if this sub-sample is discarded.
 
 The codec_specific_parameters field of the SubSampleInformationBox is defined for APV as follows:
-
 ~~~~
-if (flags == 0) {
-    unsigned int(32) tile_index;
-}
-else {
-    bit(32) reserved = 0;
-}
+
+		if (flags == 0) {
+			unsigned int(32) tile_index;
+                             }
+		else {
+			bit(32) reserved = 0;
+		}
 ~~~~
 
 tile_index for sub-samples based on tiles, this parameter indicates the tile index in raster order in a frame.
+
+# Sub-parameters for the MIME tyype 'codecs' parameter
+
+When the 'codecs' parameter of a MIME type is used for a track containing  APV bistream, as defined in IETF RFC 6381, the sub-parameters defined in this section is used. 
+
+The 'codecs' parameter string for the APV bitstream is defined as follows:
+
+~~~
+<4CC value of sample entry>.<key1><value1>.<key2><value2>.¡¦.<keyN><valueN>
+~~~
+
+The keys are defined as 4CC values and the value used for each keys are defined in the table below.
+
+|Key|Meaning|Value|
+|:-:|:-:|:-:|
+|'apvf'| profile | the largest value of the profile_idc in APVDecoderConfigurationRecord |
+|'apvl'| level | the largest value of the level_idc in APVDecoderConfigurationRecord |
+|'apvb'| band | the largest value of the band_idc in APVDecoderConfigurationRecord |
+
+For example, codecs="apv1.apvf44.apvl210.apvb3" indicates the track is compliant to 'apv1' sample entry type and the largest value of the profile in APVDecoderConfigurationRecord of the track is 422-12 profile, the level is 7 and the band is 3. 
\ No newline at end of file

From 52972c7cf4bb0af5fa1a6c569f1bf56f7ba7b780 Mon Sep 17 00:00:00 2001
From: Kwang Pyo Choi <kp5.choi@samsung.com>
Date: Tue, 6 May 2025 10:46:07 +0900
Subject: [PATCH 2/2] removed whitespaces

Signed-off-by: Kwang Pyo Choi <kp5.choi@samsung.com>
---
 readme/apv_isobmff.md | 77 ++++++++++++++++++++-----------------------
 1 file changed, 36 insertions(+), 41 deletions(-)

diff --git a/readme/apv_isobmff.md b/readme/apv_isobmff.md
index a191e71..a608d43 100644
--- a/readme/apv_isobmff.md
+++ b/readme/apv_isobmff.md
@@ -26,11 +26,9 @@ The sample entry with APV1SampleEntry type specifies that the track contains APV
 
 ### Syntax
 ~~~~
-
 class APV1SampleEntry extends VisualSampleEntry('apv1'){
 	APVCodecConfigurationBox	config;
 }
-
 ~~~~
 
 ### Semantics
@@ -60,14 +58,12 @@ The box with APVCodecConfigurationBox shall contains APVDecoderConfigurationReco
 ### Syntax
 
 ~~~~
-
 aligned(8) class APVDecoderConfigurationBox extends FullBox('apvC',version=0, flags) {
-   APVDecoderConfigurationRecord apvConfig;
+    APVDecoderConfigurationRecord apvConfig;
 }
-
 ~~~~
 
-## APV Decoder Configuration Record    {#APVDecoderConfigurationRecord}		
+## APV Decoder Configuration Record {#APVDecoderConfigurationRecord}		
 
 The APVDecoderConfigurationRecord contains the information for initial configuration of a decoder which consumes the samples references the sample entry type of apv1. The information in this record is extracted from frame_header() of the bitstream stored in the track containing this record.
 
@@ -76,35 +72,34 @@ All variation of information required to decide appropriate resource for decodin
 ### Syntax
 
 ~~~~
-
 aligned(8) class APVDecoderConfigurationRecord {
-   unsigned int(8) configurationVersion = 1;
-   unsigned int(8) number_of_configuration_entry;
-   for (i=0; i<number_of_configuration_entry; i++) {
-      unsigned int(8) pbu_type[i];
-      unsigned int(8) number_of_frame_info[i];
-      for (j=0; j<number_of_frame_info[i]; j++) {
-         reserved_zero_6bits;
-         unsigned int(1) color_description_present_flag[i][j];
-         unsigned int(1) capture_time_distance_ignored[i][j];
-         unsigned int(8) profile_idc[i][j];
-         unsigned int(8) level_idc[i][j];
-         unsigned int(8) band_idc[i][j];
-         unsigned int(32) frame_width[i][j];
-         unsigned int(32) frame_height[i][j];
-         unsigned int(4) chroma_format_idc[i][j];
-         unsigned int(4) bit_depth_minus8[i][j];
-         unsigned int(8) capture_time_distance[i][j];
-         if (color_description_present_flag[i][j]) {
-            unsigned int(8) color_primaries[i][j];
-            unsigned int(8) transfer_characteristics[i][j];
-            unsigned int(8) matrix_coefficients[i][j];
-            unsigned int(1) full_range_flag[i][j];
-         }
-      }
-   }
+    unsigned int(8) configurationVersion = 1;
+    unsigned int(8) number_of_configuration_entry;
+    for (i=0; i<number_of_configuration_entry; i++) {
+        unsigned int(8) pbu_type[i];
+        unsigned int(8) number_of_frame_info[i];
+        for (j=0; j<number_of_frame_info[i]; j++) {
+            reserved_zero_6bits;
+            unsigned int(1) color_description_present_flag[i][j];
+            unsigned int(1) capture_time_distance_ignored[i][j];
+            unsigned int(8) profile_idc[i][j];
+            unsigned int(8) level_idc[i][j];
+            unsigned int(8) band_idc[i][j];
+            unsigned int(32) frame_width[i][j];
+            unsigned int(32) frame_height[i][j];
+            unsigned int(4) chroma_format_idc[i][j];
+            unsigned int(4) bit_depth_minus8[i][j];
+            unsigned int(8) capture_time_distance[i][j];
+            if (color_description_present_flag[i][j]) {
+                unsigned int(8) color_primaries[i][j];
+                unsigned int(8) transfer_characteristics[i][j];
+                unsigned int(8) matrix_coefficients[i][j];
+                unsigned int(1) full_range_flag[i][j];
+                reserved_zero_7bits;
+            }
+        }
+    }
 }
-
 ~~~~
 
 ### Semantics
@@ -181,14 +176,14 @@ The subsample_priority field shall be set to a value in accordance with the spec
 The discardable field shall be set to 1 only if this sample would still be decodable if this sub-sample is discarded.
 
 The codec_specific_parameters field of the SubSampleInformationBox is defined for APV as follows:
-~~~~
 
-		if (flags == 0) {
-			unsigned int(32) tile_index;
-                             }
-		else {
-			bit(32) reserved = 0;
-		}
+~~~~
+if (flags == 0) {
+    unsigned int(32) tile_index;
+}
+else {
+    bit(32) reserved = 0;
+}
 ~~~~
 
 tile_index for sub-samples based on tiles, this parameter indicates the tile index in raster order in a frame.
@@ -211,4 +206,4 @@ The keys are defined as 4CC values and the value used for each keys are defined
 |'apvl'| level | the largest value of the level_idc in APVDecoderConfigurationRecord |
 |'apvb'| band | the largest value of the band_idc in APVDecoderConfigurationRecord |
 
-For example, codecs="apv1.apvf44.apvl210.apvb3" indicates the track is compliant to 'apv1' sample entry type and the largest value of the profile in APVDecoderConfigurationRecord of the track is 422-12 profile, the level is 7 and the band is 3. 
\ No newline at end of file
+For example, codecs="apv1.apvf44.apvl210.apvb3" indicates the track is compliant to 'apv1' sample entry type and the largest value of the profile in APVDecoderConfigurationRecord of the track is 422-12 profile, the level is 7 and the band is 3.