Clipador: grupo dev (camadas só do vídeo de revisão) e render com dev=False

Base comum para três frentes em paralelo (vídeo final ao aprovar, dublagem, falantes):
- layout: grupo `dev` {translation, dub}; `dev_flags(cfg, dev)` desliga tudo no vídeo final;
  `caption.translation` vira legado de `dev.translation`.
- editor_render.build_project_ass / render_project e editor_api.translation_for: parâmetro
  `dev` (padrão True = revisão; False = final, sem camadas de desenvolvimento).
- Painel: switch da tradução passa a gravar em `dev.translation`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-18 03:09:31 -03:00
co-authored by Claude Opus 5.5
parent 20a9805d2a
commit 54eac7cebf
6 changed files with 55 additions and 16 deletions
+4 -4
View File
@@ -121,11 +121,11 @@ def render_clip_edit(engine, clip: dict, session: dict, edit: dict, out: Path, t
return cover.relative_to(REPO_ROOT).as_posix() if cover else None return cover.relative_to(REPO_ROOT).as_posix() if cover else None
def translation_for(engine, clip: dict, project: dict, base: dict) -> list[dict] | None: def translation_for(engine, clip: dict, project: dict, base: dict, dev: bool = True) -> list[dict] | None:
"""Frases traduzidas para a legenda de desenvolvimento (doc/clipador/IDIOMAS.md): só com `caption.translation` """Frases traduzidas para a legenda de desenvolvimento (doc/clipador/IDIOMAS.md): só com `dev.translation`
ligado e fonte em inglês. Traduz o trecho do projeto se ainda não houver tradução que o cubra.""" ligado, render de desenvolvimento e fonte em inglês. Traduz o trecho do projeto se ainda não houver tradução."""
cfg = editor.effective_settings(base, project) cfg = editor.effective_settings(base, project)
if not cfg["caption"].get("translation"): if not layout.dev_flags(cfg, dev)["translation"]:
return None return None
ps = editor.pieces(project["cuts"]) ps = editor.pieces(project["cuts"])
if not ps: if not ps:
+8 -6
View File
@@ -200,11 +200,13 @@ def chat_events(project: dict, chat: list | None, total: float,
def build_project_ass(project: dict, cfg: dict, credit: str, t0: float = 0.0, t1: float | None = None, def build_project_ass(project: dict, cfg: dict, credit: str, t0: float = 0.0, t1: float | None = None,
chat: list | None = None, translation: list[dict] | None = None) -> str: chat: list | None = None, translation: list[dict] | None = None, dev: bool = True) -> str:
"""ASS do projeto em tempo de saída. [t0, t1] recorta a janela (prévia real de poucos segundos). """ASS do projeto em tempo de saída. [t0, t1] recorta a janela (prévia real de poucos segundos).
`chat` = mensagens da sessão (ChatMessage) para o bloco de chat na tela, se o projeto pedir. `chat` = mensagens da sessão (ChatMessage) para o bloco de chat na tela, se o projeto pedir.
`translation` = frases da fala com tradução ({s, e, text, pt}, tempo da sessão; `clips.translation_json`): `translation` = frases da fala com tradução ({s, e, text, pt}, tempo da sessão; `clips.translation_json`):
com `caption.translation` ligado, o português sai embaixo da legenda (só para desenvolver, IDIOMAS.md).""" com `dev.translation` ligado, o português sai embaixo da legenda (só para desenvolver, IDIOMAS.md).
`dev=False` = vídeo final (depois de aprovar): nenhuma camada de desenvolvimento (`layout.dev_flags`)."""
flags = layout.dev_flags(cfg, dev)
cap, cred = cfg["caption"], cfg["credit"] cap, cred = cfg["caption"], cfg["credit"]
total = output_duration(project["cuts"]) total = output_duration(project["cuts"])
t1 = total if t1 is None else min(t1, total) t1 = total if t1 is None else min(t1, total)
@@ -217,7 +219,7 @@ def build_project_ass(project: dict, cfg: dict, credit: str, t0: float = 0.0, t1
# normal fica idêntico ao de antes). # normal fica idêntico ao de antes).
tsize = max(30, int(size * 0.5)) tsize = max(30, int(size * 0.5))
trans_style = (f"Style: Trans,Arial,{tsize},&H00FFE79B,&H00FFE79B,&H00000000,&H80000000,-1,0,0,0,100,100,0,0,1," trans_style = (f"Style: Trans,Arial,{tsize},&H00FFE79B,&H00FFE79B,&H00000000,&H80000000,-1,0,0,0,100,100,0,0,1,"
f"{max(3, ow // 2)},2,8,60,60,0,1\n") if cap.get("translation") and translation else "" f"{max(3, ow // 2)},2,8,60,60,0,1\n") if flags["translation"] and translation else ""
header = f"""[Script Info] header = f"""[Script Info]
ScriptType: v4.00+ ScriptType: v4.00+
PlayResX: {cw} PlayResX: {cw}
@@ -315,7 +317,7 @@ Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
intro = "\\fscx85\\fscy85\\t(0,90,\\fscx100\\fscy100)" if preset == "pop" and i == 0 else "" intro = "\\fscx85\\fscy85\\t(0,90,\\fscx100\\fscy100)" if preset == "pop" and i == 0 else ""
event(0, start, end, "Caption", f"{{{at(start)}{intro}}}" + " ".join(parts)) event(0, start, end, "Caption", f"{{{at(start)}{intro}}}" + " ".join(parts))
if cap.get("translation") and translation: if flags["translation"] and translation:
# Só para desenvolver (doc/clipador/IDIOMAS.md): a frase traduzida em português, menor e em azul claro, # Só para desenvolver (doc/clipador/IDIOMAS.md): a frase traduzida em português, menor e em azul claro,
# logo embaixo da legenda em inglês (\\an8 = cresce para baixo; \\q0 = quebra a linha se for longa). # logo embaixo da legenda em inglês (\\an8 = cresce para baixo; \\q0 = quebra a linha se for longa).
for line in translation: for line in translation:
@@ -609,7 +611,7 @@ def has_audio_stream(ffprobe: str | None, file: Path) -> bool:
def render_project(ffmpeg: str, ffprobe: str | None, encoder: list[str], segments: list[tuple[Path, float, float]], def render_project(ffmpeg: str, ffprobe: str | None, encoder: list[str], segments: list[tuple[Path, float, float]],
project: dict, base_cfg: dict, credit: str, out_file: Path, repo_root: Path, project: dict, base_cfg: dict, credit: str, out_file: Path, repo_root: Path,
out_range: tuple[float, float] | None = None, timeout: float = 900, chat: list | None = None, out_range: tuple[float, float] | None = None, timeout: float = 900, chat: list | None = None,
cover_file: Path | None = None, translation: list[dict] | None = None) -> None: cover_file: Path | None = None, translation: list[dict] | None = None, dev: bool = True) -> None:
"""Renderiza o projeto (ou só a saída [a, b] para a prévia real). `segments` = (arquivo, início, fim) da sessão. """Renderiza o projeto (ou só a saída [a, b] para a prévia real). `segments` = (arquivo, início, fim) da sessão.
`chat` = mensagens da sessão (para o chat na tela); `cover_file` = capa já renderizada, posta nos 2 primeiros `chat` = mensagens da sessão (para o chat na tela); `cover_file` = capa já renderizada, posta nos 2 primeiros
quadros quando o projeto pede (`cover.atStart`).""" quadros quando o projeto pede (`cover.atStart`)."""
@@ -628,7 +630,7 @@ def render_project(ffmpeg: str, ffprobe: str | None, encoder: list[str], segment
stem = out_file.stem stem = out_file.stem
segs, uniform = uniform_segments(ffmpeg, ffprobe, segs, work, stem) # emenda de resolução/codec (retomada) segs, uniform = uniform_segments(ffmpeg, ffprobe, segs, work, stem) # emenda de resolução/codec (retomada)
ass_file = work / f"{stem}.ass" ass_file = work / f"{stem}.ass"
ass_text = build_project_ass(project, cfg, credit, t0, t1, chat, translation) ass_text = build_project_ass(project, cfg, credit, t0, t1, chat, translation, dev)
ass_file.write_text(ass_text, encoding="utf-8") ass_file.write_text(ass_text, encoding="utf-8")
input0, concat = _concat_input(work, stem, segs, in0, in1 - in0) input0, concat = _concat_input(work, stem, segs, in0, in1 - in0)
+20 -2
View File
@@ -91,10 +91,13 @@ DEFAULTS: dict = {
"caption": { "caption": {
"enabled": True, "font": "Arial Black", "size": 84, "color": "#FFFFFF", "highlight": "#FFE500", "enabled": True, "font": "Arial Black", "size": 84, "color": "#FFFFFF", "highlight": "#FFE500",
"outline": "#000000", "outlineWidth": 7, "y": None, "uppercase": True, "maxWords": 3, "outline": "#000000", "outlineWidth": 7, "y": None, "uppercase": True, "maxWords": 3,
# Só para desenvolver (fonte em inglês, doc/clipador/IDIOMAS.md): a tradução em português da fala embaixo # Legado (18/11/2026, manhã): virou `dev.translation`. Ainda lido por `dev_flags` (camadas já salvas).
# da legenda em inglês. Desligado = o vídeo publicável; nunca publicar com isto ligado.
"translation": False, "translation": False,
}, },
# Camadas SÓ DE DESENVOLVIMENTO (doc/clipador/IDIOMAS.md): entram no vídeo de revisão (antes de aprovar) e NUNCA no
# vídeo final — o render com `dev=False` ignora este grupo inteiro. `translation`: português embaixo da legenda;
# `dub`: dublagem em português por TTS com a voz original abaixada.
"dev": {"translation": False, "dub": False},
"credit": {"enabled": True, "position": "top", "size": 44}, "credit": {"enabled": True, "position": "top", "size": 44},
"duration": {"minS": 60, "maxS": 90, "backtrackS": 120}, "duration": {"minS": 60, "maxS": 90, "backtrackS": 120},
"format": {"aspect": "vertical"}, "format": {"aspect": "vertical"},
@@ -122,6 +125,16 @@ def merge(*layers: dict | None) -> dict:
return out return out
def dev_flags(settings: dict, dev: bool = True) -> dict:
"""Camadas de desenvolvimento ligadas neste render. `dev=False` (vídeo final, depois de aprovar) = tudo desligado.
`caption.translation` (legado) conta como `dev.translation`."""
if not dev:
return {"translation": False, "dub": False}
group = {**DEFAULTS["dev"], **(settings.get("dev") or {})}
return {"translation": bool(group["translation"] or (settings.get("caption") or {}).get("translation")),
"dub": bool(group["dub"])}
def _rect(value, name: str) -> dict | None: def _rect(value, name: str) -> dict | None:
if value is None: if value is None:
return None return None
@@ -180,6 +193,11 @@ def validate(settings: dict) -> dict:
if key in cap: if key in cap:
o[key] = bool(cap[key]) o[key] = bool(cap[key])
out["caption"] = o out["caption"] = o
dev = settings.get("dev")
if dev is not None:
if not isinstance(dev, dict):
raise LayoutError("dev precisa ser um objeto")
out["dev"] = {k: bool(dev[k]) for k in ("translation", "dub") if k in dev}
cred = settings.get("credit") cred = settings.get("credit")
if cred is not None: if cred is not None:
o = {} o = {}
+17
View File
@@ -148,3 +148,20 @@ def test_voice_language_maps_audience_codes_to_whisper_codes():
from app.worker import voice_language from app.worker import voice_language
assert voice_language("en-US") == "en" and voice_language("es-419") == "es" and voice_language("pt-BR") == "pt-BR" assert voice_language("en-US") == "en" and voice_language("es-419") == "es" and voice_language("pt-BR") == "pt-BR"
assert voice_language("en-GB") == "en" and voice_language("") == "pt-BR" assert voice_language("en-GB") == "en" and voice_language("") == "pt-BR"
def test_dev_layers_never_reach_the_final_render(tmp_path):
"""Contrato `dev` (18/11/2026): camadas de desenvolvimento só no vídeo de revisão; `dev=False` = vídeo final limpo."""
assert layout.DEFAULTS["dev"] == {"translation": False, "dub": False}
assert layout.validate({"dev": {"translation": True, "dub": True, "x": 1}})["dev"] == {"translation": True, "dub": True}
cfg = layout.merge({"dev": {"translation": True, "dub": True}})
assert layout.dev_flags(cfg) == {"translation": True, "dub": True}
assert layout.dev_flags(cfg, dev=False) == {"translation": False, "dub": False}
assert layout.dev_flags(layout.merge({"caption": {"translation": True}}))["translation"] is True # legado
clip = {"session_id": 1, "start_s": 10.0, "end_s": 75.0, "peak_s": 50.0, "title": "x", "source": "chat"}
words = [Word(20, 20.4, "No"), Word(20.4, 20.8, "way")]
lines = [{"s": 20.0, "e": 20.8, "text": "No way", "pt": "Não acredito"}]
p = validate(editor.auto_project(clip, None, words, [], 100.0, cfg), tmp_path)
eff = editor.effective_settings(cfg, p)
assert "Não acredito" in editor_render.build_project_ass(p, eff, "x", translation=lines)
assert "Não acredito" not in editor_render.build_project_ass(p, eff, "x", translation=lines, dev=False)
+3 -1
View File
@@ -212,9 +212,11 @@ export type CutSettings = {
caption: { caption: {
enabled: boolean; font: string; size: number; color: string; highlight: string; outline: string; enabled: boolean; font: string; size: number; color: string; highlight: string; outline: string;
outlineWidth: number; y: number | null; uppercase: boolean; maxWords: number; outlineWidth: number; y: number | null; uppercase: boolean; maxWords: number;
/** Só para desenvolver (fonte em inglês): a tradução em português embaixo da legenda. Nunca publicar ligado. */ /** Legado: virou `dev.translation`. */
translation?: boolean; translation?: boolean;
}; };
/** Camadas só de desenvolvimento (vídeo de revisão); o vídeo final, depois de aprovar, sai sem elas. */
dev?: { translation: boolean; dub: boolean };
credit: { enabled: boolean; position: "top" | "bottom"; size: number }; credit: { enabled: boolean; position: "top" | "bottom"; size: number };
duration: { minS: number; maxS: number; backtrackS: number }; duration: { minS: number; maxS: number; backtrackS: number };
/** O serviço antigo não manda este grupo: use `withFormat` para preencher com vertical. */ /** O serviço antigo não manda este grupo: use `withFormat` para preencher com vertical. */
@@ -510,9 +510,9 @@ function CutSettingsEditor({ scope, onDirty, onClose, onSaved }: {
<h4 className="text-eyebrow font-semibold text-fg-subtle uppercase">Ritmo e posição</h4> <h4 className="text-eyebrow font-semibold text-fg-subtle uppercase">Ritmo e posição</h4>
<RangeField label="Palavras por vez" min={1} max={6} step={1} value={draft.caption.maxWords} onChange={(maxWords) => update("caption", { maxWords })} /> <RangeField label="Palavras por vez" min={1} max={6} step={1} value={draft.caption.maxWords} onChange={(maxWords) => update("caption", { maxWords })} />
<Switch label="Caixa alta" checked={draft.caption.uppercase} onChange={(uppercase) => update("caption", { uppercase })} /> <Switch label="Caixa alta" checked={draft.caption.uppercase} onChange={(uppercase) => update("caption", { uppercase })} />
<Switch label="Tradução em português embaixo (teste)" checked={draft.caption.translation ?? false} <Switch label="Tradução em português embaixo (teste)" checked={draft.dev?.translation ?? draft.caption.translation ?? false}
onChange={(translation) => update("caption", { translation })} onChange={(translation) => update("dev", { translation })}
hint="Só para desenvolver, em fonte em inglês: a fala traduzida aparece embaixo da legenda. Desligue antes de publicar." /> hint="Só no vídeo de revisão (fonte em inglês): a fala traduzida aparece embaixo da legenda. O vídeo final, ao aprovar, sai sem ela." />
<Switch label="Posição automática" checked={draft.caption.y === null} <Switch label="Posição automática" checked={draft.caption.y === null}
onChange={(auto) => update("caption", { y: auto ? null : 0.74 })} onChange={(auto) => update("caption", { y: auto ? null : 0.74 })}
hint={horizontal ? "O serviço escolhe a altura no quadro horizontal." : "Na emenda entre câmera e jogo, ou a cerca de 74% da altura."} /> hint={horizontal ? "O serviço escolhe a altura no quadro horizontal." : "Na emenda entre câmera e jogo, ou a cerca de 74% da altura."} />