rinkplanner/tools/rotoscope.sh
torsten be754c1d34 fix: Testreferenz ohne ffmpeg-9-Filterdatei erzeugen
ffmpeg 9 hat -filter_script entfernt; die Filterkette geht jetzt direkt
ueber -vf. Builds ohne libfreetype (Homebrew) haben kein drawtext, dann
entsteht die Referenz nur mit Rahmen und Mittellinie.
2026-11-17 19:54:53 +01:00

202 lines
5.8 KiB
Bash
Executable file

#!/usr/bin/env bash
# Rotoscoping-Werkbank für den Rinkplanner-Skater.
#
# Erzeugt eine vorbereitete Blender-Arbeitsdatei, lädt Referenzvideos und
# exportiert alle Animationsclips als GLB. Das Rig und die Referenzen bleiben
# im Workbench-Archiv, nicht im Repo.
set -euo pipefail
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
# shellcheck source=tools/_paths.sh
source "$REPO_ROOT/tools/_paths.sh"
WORKBENCH="$(workbench_dir)"
BLENDER="${BLENDER:-$(command -v blender || true)}"
SCRIPT="$REPO_ROOT/tools/blender/rotoscope.py"
RIG="${RINKPLANNER_RIG:-$WORKBENCH/source/characters/skater/skater_rig_v008.blend}"
ROTOSCOPE_DIR="$WORKBENCH/source/characters/skater/rotoscope"
WORK="$ROTOSCOPE_DIR/rotoscope_work.blend"
REFERENCES="$ROTOSCOPE_DIR/references"
DEFAULT_EXPORT="$WORKBENCH/library/characters/skater_figure_clips_v004.glb"
usage() {
cat <<'EOF'
Aufruf: tools/rotoscope.sh <befehl> [optionen]
setup [--reference PFAD] [--force]
Legt die Arbeitsdatei aus dem Rig an und lädt optional eine Referenz.
--force überschreibt eine vorhandene Arbeitsdatei samt Animationen.
reference PFAD
Lädt ein Video oder Standbild in die bestehende Arbeitsdatei.
open
Öffnet die Arbeitsdatei in Blender.
export [--out PFAD]
Exportiert alle Aktionen als GLB und schreibt eine JSON-Metadatendatei.
promote [--version N] [--publish] [--dry-run]
Exportiert nach library/characters/skater_figure_clips_vNNN.glb,
aktualisiert das Manifest und synchronisiert nach assets/external.
--publish lädt den Stand zusätzlich auf den FTP-Spiegel.
test-reference
Erzeugt einen synthetischen Testfilm unter references/test_reference.mp4.
status
Zeigt die verwendeten Pfade.
Umgebung:
RINKPLANNER_WORKBENCH Workbench-Archiv
(Standard: <Dokumente>/workbench_rinkplanner)
BLENDER Blender-Binary
RINKPLANNER_RIG Quell-Rig (Standard: skater_rig_v008.blend)
EOF
}
require_blender() {
if [[ -z "$BLENDER" || ! -x "$BLENDER" ]]; then
echo "Blender nicht gefunden. Setze BLENDER=/pfad/zu/blender." >&2
exit 1
fi
}
command="${1:-help}"
if [[ $# -gt 0 ]]; then
shift
fi
case "$command" in
setup)
require_blender
"$BLENDER" -b --python "$SCRIPT" -- setup \
--rig "$RIG" --out "$WORK" "$@"
;;
reference)
require_blender
if [[ $# -lt 1 ]]; then
echo "Pfad zur Referenz fehlt." >&2
exit 2
fi
"$BLENDER" -b --python "$SCRIPT" -- reference \
--blend "$WORK" --reference "$1"
;;
open)
require_blender
if [[ ! -f "$WORK" ]]; then
echo "Arbeitsdatei fehlt: $WORK" >&2
echo "Zuerst: tools/rotoscope.sh setup" >&2
exit 1
fi
"$BLENDER" "$WORK"
;;
export)
require_blender
has_out=0
for argument in "$@"; do
if [[ "$argument" == "--out" ]]; then
has_out=1
fi
done
if [[ "$has_out" -eq 0 ]]; then
set -- "$@" --out "$DEFAULT_EXPORT"
fi
"$BLENDER" -b --python "$SCRIPT" -- export \
--blend "$WORK" "$@"
;;
promote)
require_blender
if ! command -v python3 >/dev/null 2>&1; then
echo "python3 nicht gefunden." >&2
exit 1
fi
version=""
publish=0
dry_run=0
while [[ $# -gt 0 ]]; do
case "$1" in
--version) version="${2:-}"; shift 2 ;;
--publish) publish=1; shift ;;
--dry-run) dry_run=1; shift ;;
*) echo "Unbekannte Option: $1" >&2; exit 2 ;;
esac
done
if [[ -z "$version" ]]; then
version="$(python3 - "$REPO_ROOT/rinkplanner/assets/asset_manifest.json" <<'PY'
import json
import sys
with open(sys.argv[1], encoding="utf-8") as handle:
document = json.load(handle)
entry = next(
(asset for asset in document.get("assets", [])
if asset.get("id") == "character.skater.figure_tripo_glide"),
None,
)
print(int(entry.get("version", 0)) + 1 if entry else 1)
PY
)"
fi
if [[ ! "$version" =~ ^[0-9]+$ ]]; then
echo "Ungültige Version: $version" >&2
exit 2
fi
output="$WORKBENCH/library/characters/skater_figure_clips_v$(printf '%03d' "$version").glb"
"$BLENDER" -b --python "$SCRIPT" -- export \
--blend "$WORK" --out "$output"
promote_args=(--glb "$output" --version "$version")
if [[ "$dry_run" -eq 1 ]]; then
promote_args+=(--dry-run)
fi
if [[ "$publish" -eq 1 ]]; then
promote_args+=(--publish)
fi
python3 "$REPO_ROOT/tools/promote_rotoscope.py" "${promote_args[@]}"
;;
test-reference)
if ! command -v ffmpeg >/dev/null 2>&1; then
echo "ffmpeg nicht gefunden." >&2
exit 1
fi
mkdir -p "$REFERENCES"
output="$REFERENCES/test_reference.mp4"
# Filter direkt übergeben: -filter_script wurde in ffmpeg 9 entfernt.
filter="drawbox=x=20:y=20:w=1240:h=680:color=0x7fa8c9:t=8"
filter+=",drawbox=x=638:y=20:w=4:h=680:color=0x7fa8c9:t=fill"
# drawtext fehlt in Builds ohne libfreetype (z. B. Homebrew); dann nur Rahmen.
if ffmpeg -hide_banner -filters 2>/dev/null | grep -Eq '^ [A-Z.]{3} drawtext '; then
filter+=",drawtext=text='ROTOSCOPE TEST':fontcolor=0x1f3a5f:fontsize=48:x=(w-text_w)/2:y=60"
filter+=",drawtext=text='O':fontcolor=0xc0392b:fontsize=64"
filter+=":x='w/2+320*sin(2*PI*t/4)':y='h/2+160*cos(2*PI*t/4)'"
fi
ffmpeg -y -f lavfi -i "color=c=0xdfefff:s=1280x720:r=24:d=8" \
-vf "$filter" \
-c:v libx264 -pix_fmt yuv420p -movflags +faststart "$output" \
>/dev/null 2>&1
echo "Testreferenz: $output"
;;
status)
printf 'Workbench: %s\n' "$WORKBENCH"
printf 'Rig: %s\n' "$RIG"
printf 'Arbeitsdatei: %s\n' "$WORK"
printf 'Referenzen: %s\n' "$REFERENCES"
printf 'Export: %s\n' "$DEFAULT_EXPORT"
;;
help|-h|--help)
usage
;;
*)
echo "Unbekannter Befehl: $command" >&2
usage >&2
exit 2
;;
esac