feat: Rotoscoping-Werkbank ohne vorhandenes Videomaterial
- Blender-Setup mit Kamera, Rink-Guide und Video-Referenz - CLI fuer setup/reference/open/export/promote/test-reference - Multi-Clip-GLB-Export und Manifest-Uebernahme inkl. FTP-Option - synthetischer Testfilm validiert Szene, Export und Promote - Doku, Architektur (D15) und Roadmap aktualisiert
This commit is contained in:
parent
723e1bc84a
commit
7f35162966
10 changed files with 1091 additions and 3 deletions
198
tools/rotoscope.sh
Executable file
198
tools/rotoscope.sh
Executable file
|
|
@ -0,0 +1,198 @@
|
|||
#!/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)"
|
||||
WORKBENCH="${RINKPLANNER_WORKBENCH:-$HOME/Documents/workbench_rinkplanner}"
|
||||
BLENDER="${BLENDER:-$(command -v blender || true)}"
|
||||
SCRIPT="$REPO_ROOT/tools/blender/rotoscope.py"
|
||||
|
||||
RIG="${RINKPLANNER_RIG:-$WORKBENCH/source/characters/skater/skater_rig_v003.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
|
||||
BLENDER Blender-Binary
|
||||
RINKPLANNER_RIG Quell-Rig (Standard: skater_rig_v003.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
|
||||
Loading…
Add table
Add a link
Reference in a new issue