test(M00): refine Goldshire camera framing

tools/sweep_render_checkpoint_camera_pose.ps1

@@ -9,6 +9,7 @@ param(
     [double[]]$YawOffsets = @(-10.0, 0.0, 10.0),
     [double[]]$PitchOffsets = @(-10.0, 0.0, 10.0),
     [double]$CameraFov = 62.0,
+    [double[]]$CameraFovValues = @(),
     [int]$ViewportWidth = 1280,
     [int]$ViewportHeight = 900,
     [double]$WaitSeconds = 8.0,
@@ -34,7 +35,8 @@ if (-not (Test-Path -LiteralPath $ReferenceDirectory)) {
 }
 
 $invariantCulture = [Globalization.CultureInfo]::InvariantCulture
-$cameraFovText = $CameraFov.ToString($invariantCulture)
+$isJointFovSweep = $CameraFovValues.Count -gt 0
+$effectiveCameraFovValues = if ($isJointFovSweep) { $CameraFovValues } else { @($CameraFov) }
 $waitSecondsText = $WaitSeconds.ToString($invariantCulture)
 $measureSecondsText = $MeasureSeconds.ToString($invariantCulture)
 $absoluteOutput = if ($Output.StartsWith("user://")) {
@@ -46,11 +48,16 @@ $ranking = [Collections.Generic.List[object]]::new()
 
 Push-Location $repoRoot
 try {
-    foreach ($yawOffset in $YawOffsets) {
-        foreach ($pitchOffset in $PitchOffsets) {
+    foreach ($cameraFovValue in $effectiveCameraFovValues) {
+        foreach ($yawOffset in $YawOffsets) {
+            foreach ($pitchOffset in $PitchOffsets) {
+            $cameraFovText = $cameraFovValue.ToString("0.###", $invariantCulture)
             $yawText = $yawOffset.ToString("0.###", $invariantCulture)
             $pitchText = $pitchOffset.ToString("0.###", $invariantCulture)
             $candidateName = "yaw_$($yawText.Replace('-', 'n').Replace('.', '_'))__pitch_$($pitchText.Replace('-', 'n').Replace('.', '_'))"
+            if ($isJointFovSweep) {
+                $candidateName = "fov_$($cameraFovText.Replace('.', '_'))__$candidateName"
+            }
             $candidateOutput = "$Output/$candidateName"
             $comparisonReport = Join-Path $absoluteOutput "$candidateName.json"
 
@@ -58,7 +65,7 @@ try {
                 $ranking.Add([pscustomobject]@{
                     yaw_offset_degrees = $yawOffset
                     pitch_offset_degrees = $pitchOffset
-                    camera_fov_degrees = $CameraFov
+                    camera_fov_degrees = $cameraFovValue
                     candidate_directory = $candidateOutput
                 })
                 continue
@@ -101,12 +108,13 @@ try {
             $ranking.Add([pscustomobject]@{
                 yaw_offset_degrees = $yawOffset
                 pitch_offset_degrees = $pitchOffset
-                camera_fov_degrees = $CameraFov
+                camera_fov_degrees = $cameraFovValue
                 mean_perceptual_error = $meanError
                 changed_pixel_ratio = $changedRatio
                 candidate_directory = $candidateOutput
                 comparison_report = $comparisonReport
             })
+            }
         }
     }
 
@@ -127,7 +135,7 @@ try {
     }
     New-Item -ItemType Directory -Force -Path $absoluteOutput | Out-Null
     $rankingDocument | ConvertTo-Json -Depth 6 | Set-Content -Encoding UTF8 -LiteralPath $rankingPath
-    $rankedCandidates | Format-Table yaw_offset_degrees, pitch_offset_degrees, mean_perceptual_error, changed_pixel_ratio
+    $rankedCandidates | Format-Table camera_fov_degrees, yaw_offset_degrees, pitch_offset_degrees, mean_perceptual_error, changed_pixel_ratio
     $completionKind = if ($PlanOnly) { "plan" } else { "ranking" }
     Write-Output "Camera pose sweep $completionKind completed: $rankingPath"
 } finally {