From 9186ac83b3187a87c17b15a80f0e3cedf2b46700 Mon Sep 17 00:00:00 2001
From: Hendry <hendry197@gmail.com>
Date: Sun, 16 Jun 2024 18:14:22 -0700
Subject: [PATCH] Updated the software manual to describe what the
 configuration is about to better align them with the spec. Also updated their
 default values.

---
 cfg/sei_vui/encoder_optimization_info.cfg | 10 +++---
 doc/software-manual.tex                   | 43 +++++++++++++++++++----
 2 files changed, 42 insertions(+), 11 deletions(-)

diff --git a/cfg/sei_vui/encoder_optimization_info.cfg b/cfg/sei_vui/encoder_optimization_info.cfg
index 73b4f601b..76e4ac086 100644
--- a/cfg/sei_vui/encoder_optimization_info.cfg
+++ b/cfg/sei_vui/encoder_optimization_info.cfg
@@ -6,9 +6,9 @@ SEIEOIPersistenceFlag:          1
 SEIEOIForHumanViewingIdc:          1
 SEIEOIForMachineAnalysisIdc:          3
 SEIEOIType:          39
-SEIEOIObjectBasedIdc: 1
+SEIEOIObjectBasedIdc: 0
 SEIEOITemporalResamplingTypeFlag: 1
-SEIEOINumIntPics: 4
-SEIEOISpatialResamplingTypeFlag: 1
-SEIEOIPrivacyProtectionTypeIdc: 3
-SEIEOIPrivacyProtectedInfoType: 3
\ No newline at end of file
+SEIEOINumIntPics: 2
+SEIEOISpatialResamplingTypeFlag: 0
+SEIEOIPrivacyProtectionTypeIdc: 0
+SEIEOIPrivacyProtectedInfoType: 128
\ No newline at end of file
diff --git a/doc/software-manual.tex b/doc/software-manual.tex
index 792af783b..602b4ec1f 100644
--- a/doc/software-manual.tex
+++ b/doc/software-manual.tex
@@ -6010,12 +6010,29 @@ Specifies whether the optimized result is suitable for human viewing.
 Specifies whether the optimized result is intended for machine task / analysis.
 \\
 \Option{SEIEOIType} &
-\Default{39} &
+\Default{0} &
 Specifies the type of optimization(s).
+\par
+\begin{tabular}{cp{0.35\textwidth}}
+ 0 & Determined by the application \\
+ (SEIEOIType \& 0x01)  !=  0 & Object-based optimization. \\
+ (SEIEOIType \& 0x02)  !=  0 & Temporal resampling optimization. \\
+ (SEIEOIType \& 0x04)  !=  0 & Spatial resampling optimization. \\
+ (SEIEOIType \& 0x08)  !=  0 & Temporal quality optimization in a manner that quality fluctuates temporally. \\
+ (SEIEOIType \& 0x10)  !=  0 & Spatial quality optimization. \\
+ (SEIEOIType \& 0x20)  !=  0 & Privacy protection optimization. \\
+\end{tabular}
 \\
 \Option{SEIEOIObjectBasedIdc} &
-\Default{1} &
+\Default{0} &
 Specifies the value of object based indication.
+\par
+\begin{tabular}{cp{0.35\textwidth}}
+ 0 & Determined by the application \\
+ (SEIEOIObjectBasedIdc \& 0x01)  !=  0 & Areas outside the detected objects have been blurred prior to encoding. \\
+ (SEIEOIObjectBasedIdc \& 0x02)  !=  0 & Areas outside the detected objects have been encoded with coarser transform-domain quantization than the quantization used for the detected objects. \\
+ (SEIEOIObjectBasedIdc \& 0x04)  !=  0 & Areas outside the detected objects have been overwritten. For example, an encoding system can overwrite areas outside the detected objects with a constant sample value. \\
+\end{tabular}
 \\
 \Option{SEIEOITemporalResamplingTypeFlag} &
 \Default{1} &
@@ -6030,12 +6047,26 @@ Specifies the number of added picture between two pics when temporal resampling
 Specifies whether spatial resampling type optimization is enabled.
 \\
 \Option{SEIEOIPrivacyProtectionTypeIdc} &
-\Default{3} &
-Specifies type of privacy protection optimization when applied.
+\Default{0} &
+Specifies method of privacy protection optimization, when applied.
+\par
+\begin{tabular}{cp{0.35\textwidth}}
+ 0 & Unknown or determined by the application \\
+ 1 & Blurring; personal information is blurred to make it unidentifiable. \\
+ 2 & Replacing; personal information is replaced with something different from the original to make it unidentifiable. \\
+ 3 & Masking; personal information is masked so that it cannot be identified. \\
+\end{tabular}
 \\
 \Option{SEIEOIPrivacyProtectedInfoType} &
-\Default{3} &
-Specifies information on the of privacy protection optimization that is applied.
+\Default{128} &
+Specifies type of information the of privacy protection optimization that is applied.
+\par
+\begin{tabular}{cp{0.35\textwidth}}
+ 0 & Determined by the application \\
+ (SEIEOIPrivacyProtectedInfoType \& 0x01)  !=  0 & Information that identifies a person is protected. For example, the face of the person. \\
+ (SEIEOIPrivacyProtectedInfoType \& 0x02)  !=  0 & Information that can identify vehicles is protected. For example, the license plate of the vehicle. \\
+ (SEIEOIPrivacyProtectedInfoType \& 0x04)  !=  0 & Information that can infer locations is protected. For example text or images on signs. \\
+\end{tabular}
 \\
 \end{OptionTableNoShorthand}
 
-- 
GitLab