rinkplanner/tools/rotoscope.sh
torsten 0ac0624ba2 fix: Dokumente-Ordner sprachunabhaengig aufloesen
- neues tools/_paths.sh loest den Dokumente-Ordner zur Laufzeit auf:
  xdg-user-dir DOCUMENTS, sonst ~/Dokumente, sonst ~/Documents
- sync_assets.sh und rotoscope.sh nutzen workbench_dir statt
  $HOME/Documents/workbench_rinkplanner
- promote_rotoscope.py und blender/rotoscope.py loesen den Workbench-Pfad
  genauso auf und bevorzugen weiterhin RINKPLANNER_WORKBENCH
- Doku auf den tatsaechlichen Pfad ~/Dokumente/workbench_rinkplanner
  umgestellt
2026-11-01 13:57:02 +01:00

201 lines
5.6 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_v006.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_v006.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"),
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_file="$(mktemp "${TMPDIR:-/tmp}/rotoscope-filter.XXXXXX")"
trap 'rm -f "$filter_file"' EXIT
cat > "$filter_file" <<'FILTER'
drawbox=x=20:y=20:w=1240:h=680:color=0x7fa8c9:t=8,
drawbox=x=638:y=20:w=4:h=680:color=0x7fa8c9:t=fill,
drawtext=text='ROTOSCOPE TEST':fontcolor=0x1f3a5f:fontsize=48:x=(w-text_w)/2:y=60,
drawtext=text='O':fontcolor=0xc0392b:fontsize=64:x='w/2+320*sin(2*PI*t/4)':y='h/2+160*cos(2*PI*t/4)'
FILTER
ffmpeg -y -f lavfi -i "color=c=0xdfefff:s=1280x720:r=24:d=8" \
-filter_script:v "$filter_file" \
-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