Skip to content

AI media harness for planning, generating, and editing locally

TypeScript

Move inspector help to label tooltips

Bittibc06d7dab344
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 19bc61a..14f1778 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -35,6 +35,7 @@ This alpha update adds LAN generation workers, Linux support, expanded color gra
## Fixes and improvements
+- Inspector instructions now appear as tooltips on field labels, keeping the right-side panels compact.
- Scene generation prompts now mark shot times as `[Shot 2] At 00:03.500,`.
- Still-image resolution and aspect ratio are saved separately from video project settings. Editing or selecting an image no longer changes the canvas used for video generation and continuation.
- Zoom the timeline video preview up to 400% with the zoom menu, buttons, or Ctrl+wheel, and scroll to inspect details. Choose Fit to see the whole frame again.
diff --git a/src/components/ui/PropRow.tsx b/src/components/ui/PropRow.tsx
index f5f7e48..eab051b 100644
--- a/src/components/ui/PropRow.tsx
+++ b/src/components/ui/PropRow.tsx
@@ -36,6 +36,8 @@ export interface ScrubOptions {
export interface PropRowProps {
label: ReactNode;
+ /** Help shown when hovering or focusing the row label. */
+ tooltip?: string;
/** Id of the control the label names. */
htmlFor?: string;
children?: ReactNode;
@@ -52,7 +54,7 @@ export interface PropRowProps {
const DRAG_THRESHOLD = 3;
-export function PropRow({ label, htmlFor, children, value, defaultValue, modified, onReset, resetLabel, scrub, className }: PropRowProps) {
+export function PropRow({ label, tooltip, htmlFor, children, value, defaultValue, modified, onReset, resetLabel, scrub, className }: PropRowProps) {
const drag = useRef<{ x: number; start: number; accumulated: number; moved: boolean; pointer: number } | null>(null);
const [scrubbing, setScrubbing] = useState(false);
const suppressClick = useRef(false);
@@ -98,6 +100,8 @@ export function PropRow({ label, htmlFor, children, value, defaultValue, modifie
<label
className={cx("ui-prop-row__label", scrub && "ui-prop-row__label--scrub")}
htmlFor={htmlFor}
+ data-tooltip={tooltip}
+ tabIndex={tooltip ? 0 : undefined}
onPointerDown={onPointerDown}
onPointerMove={onPointerMove}
onPointerUp={end}
@@ -125,6 +129,7 @@ export function PropRow({ label, htmlFor, children, value, defaultValue, modifie
export interface PropSectionProps {
title: ReactNode;
+ tooltip?: string;
children?: ReactNode;
/** Controlled open state. */
open?: boolean;
@@ -149,7 +154,7 @@ function readOpen(key: string | undefined, fallback: boolean) {
}
}
-export function PropSection({ title, children, open, defaultOpen = true, onOpenChange, persistKey, summary, actions, className }: PropSectionProps) {
+export function PropSection({ title, tooltip, children, open, defaultOpen = true, onOpenChange, persistKey, summary, actions, className }: PropSectionProps) {
const [inner, setInner] = useState(() => readOpen(persistKey, defaultOpen));
const isOpen = open ?? inner;
const contentId = useId();
@@ -164,7 +169,7 @@ export function PropSection({ title, children, open, defaultOpen = true, onOpenC
return (
<section className={cx("ui-prop-section", isOpen && "ui-prop-section--open", className)}>
<div className="ui-prop-section__header">
- <button type="button" className="ui-prop-section__toggle" aria-expanded={isOpen} aria-controls={contentId} onClick={toggle}>
+ <button type="button" className="ui-prop-section__toggle" data-tooltip={tooltip} aria-expanded={isOpen} aria-controls={contentId} onClick={toggle}>
<ChevronDown12 aria-hidden="true" className="ui-prop-section__chevron" />
<span className="ui-prop-section__title">{title}</span>
{summary !== undefined && summary !== null && summary !== false && <span className="ui-prop-section__summary">{summary}</span>}
diff --git a/src/components/workspace/CharacterSheetSettings.tsx b/src/components/workspace/CharacterSheetSettings.tsx
index 6292448..3deab12 100644
--- a/src/components/workspace/CharacterSheetSettings.tsx
+++ b/src/components/workspace/CharacterSheetSettings.tsx
@@ -39,23 +39,21 @@ export function CharacterSheetSettings({ config, source, references, missingLabe
}}>
<div className="image-inspector__fields image-template-settings__fields">
<p className="image-inspector__caption">Source: {source.name}</p>
- <p className="image-inspector__caption">Combine selected views into one image: a square waist-up close up and full-body front, side, or back views.</p>
- {CHARACTER_SHEET_VIEWS.map((view) => <PropRow key={view.id} label={view.label} htmlFor={`character-sheet-${view.id}`}>
+ {CHARACTER_SHEET_VIEWS.map((view) => <PropRow key={view.id} label={view.label} htmlFor={`character-sheet-${view.id}`}
+ tooltip={`Combine selected views into one image: a square waist-up close up and full-body front, side, or back views.${view.id === "front" ? " When enabled, the front view provides the outfit reference for other views; otherwise each view uses the source image." : ""}`}>
<ToggleSwitch id={`character-sheet-${view.id}`} aria-label={view.label} checked={selectedViews[view.id]} disabled={busy}
onChange={(checked) => update("views", { ...selectedViews, [view.id]: checked })} />
</PropRow>)}
- <PropRow label="Resolution" htmlFor="character-sheet-resolution"><ComboBox id="character-sheet-resolution" aria-label="Character sheet resolution" value={options.height} disabled={busy}
+ <PropRow label="Resolution" htmlFor="character-sheet-resolution" tooltip="Width follows the selected view proportions."><ComboBox id="character-sheet-resolution" aria-label="Character sheet resolution" value={options.height} disabled={busy}
options={CHARACTER_SHEET_HEIGHTS.map((height) => ({ value: height, label: `${height} px high` }))} onChange={(height) => update("height", height)} /></PropRow>
- <p className="image-inspector__caption">Sheet size: {indices.reduce((width, index) => width + dimensions[index].width, 0)} × {dimensions[0].height} px. Width follows the selected view proportions.</p>
- <PropRow label="Steps" htmlFor="character-sheet-steps"><input id="character-sheet-steps" className="text-field" type="number" min="2" max="1000" step="1" required disabled={busy}
+ <p className="image-inspector__caption">Sheet size: {indices.reduce((width, index) => width + dimensions[index].width, 0)} × {dimensions[0].height} px.</p>
+ <PropRow label="Steps" htmlFor="character-sheet-steps" tooltip="All selected views use the same step count."><input id="character-sheet-steps" className="text-field" type="number" min="2" max="1000" step="1" required disabled={busy}
value={Number.isNaN(options.steps) ? "" : options.steps} onChange={(event) => update("steps", event.target.valueAsNumber)} /></PropRow>
- <PropRow label="Seed" htmlFor="character-sheet-seed"><input id="character-sheet-seed" className="text-field" type="number" min="-1" max={Number.MAX_SAFE_INTEGER} step="1" required disabled={busy}
+ <PropRow label="Seed" htmlFor="character-sheet-seed" tooltip="Use -1 for a random seed. All selected views use the same seed."><input id="character-sheet-seed" className="text-field" type="number" min="-1" max={Number.MAX_SAFE_INTEGER} step="1" required disabled={busy}
value={Number.isNaN(options.seed) ? "" : options.seed} onChange={(event) => update("seed", event.target.valueAsNumber)} /></PropRow>
- <p className="image-inspector__caption">Use -1 for a random seed. All selected views use the same seed and step count.</p>
- <div className="image-inspector__area"><span>Prompt</span>
+ <div className="image-inspector__area"><span tabIndex={0} data-tooltip="Use the prompt and references for clothing and other details. Leave it blank to keep the source appearance.">Prompt</span>
<PromptTextField aria-label="Character sheet prompt" value={options.prompt} onChange={(value) => update("prompt", value)} references={references} missingLabel={missingLabel} disabled={busy} placeholder="Describe the character, clothing, accessories, style, or lighting…" />
</div>
- <p className="image-inspector__caption">Use the prompt and references for clothing and other details. Leave it blank to keep the source appearance. When enabled, the front view provides the outfit reference for other views; otherwise each view uses the source image.</p>
{(validation || error) && <InfoBar severity="error" title="Couldn't prepare the template" message={validation ?? error ?? ""} />}
</div>
<div className="image-template-settings__footer">
diff --git a/src/components/workspace/ExtendSettings.tsx b/src/components/workspace/ExtendSettings.tsx
index 0a83335..228ef13 100644
--- a/src/components/workspace/ExtendSettings.tsx
+++ b/src/components/workspace/ExtendSettings.tsx
@@ -22,10 +22,10 @@ export function ExtendSettings({ config, source, options, onChange, references,
<ItemHeader name="Extend" meta="Template" actions={<button type="button" className="icon-button" aria-label="Close template settings" data-tooltip="Back to image settings" onClick={onClose}><Dismiss16 aria-hidden="true" /></button>} />
<form className="image-template-settings__form" onSubmit={(event) => { event.preventDefault(); if (!busy && !disabledReason && !validation.message) onExecute(); }}>
<div className="image-inspector__fields image-template-settings__fields">
- <p className="image-inspector__caption">Drag the box or its handles, or drag outside it to draw a new box. Sizes use 32-pixel increments. The original is downscaled to make room for generated areas; output stays within the source pixel count and selected generation resolution.</p>
{validation.output && <p className="image-inspector__caption">Output: {validation.output.width} × {validation.output.height} px</p>}
<p className="image-inspector__caption">Source: {source.name} · {source.width} × {source.height} px</p>
- {(["x", "y", "width", "height"] as const).map((field) => <PropRow key={field} label={field === "x" ? "X" : field === "y" ? "Y" : field === "width" ? "Width" : "Height"} htmlFor={`extend-${field}`}>
+ {(["x", "y", "width", "height"] as const).map((field) => <PropRow key={field} label={field === "x" ? "X" : field === "y" ? "Y" : field === "width" ? "Width" : "Height"} htmlFor={`extend-${field}`}
+ tooltip={field === "x" || field === "y" ? "Drag the box or its handles, or drag outside it to draw a new box." : "Sizes use 32-pixel increments. The original is downscaled to make room for generated areas; output stays within the source pixel count and selected generation resolution."}>
<input id={`extend-${field}`} aria-label={`Extend ${field}`} className="text-field" type="number" step={field === "x" || field === "y" ? 1 : EXTEND_GRID} min={field === "x" || field === "y" ? -8192 : EXTEND_GRID} max={field === "x" || field === "y" ? 8192 : EXTEND_MAX_EDGE} required disabled={busy}
value={options.bounds[field]} onChange={(event) => {
const value = event.target.valueAsNumber; if (!Number.isFinite(value)) return;
@@ -36,9 +36,8 @@ export function ExtendSettings({ config, source, options, onChange, references,
<button type="button" className="secondary-button" disabled={busy} onClick={() => onChange({ ...options, bounds: initialExtendBounds(source.width!, source.height!) })}>Reset box</button>
<PropRow label="Steps" htmlFor="extend-steps"><input id="extend-steps" className="text-field" type="number" min="2" max="1000" step="1" required disabled={busy}
value={Number.isNaN(options.steps) ? "" : options.steps} onChange={(event) => onChange({ ...options, steps: event.target.valueAsNumber })} /></PropRow>
- <PropRow label="Seed" htmlFor="extend-seed"><input id="extend-seed" className="text-field" type="number" min="-1" max={Number.MAX_SAFE_INTEGER} step="1" required disabled={busy}
+ <PropRow label="Seed" htmlFor="extend-seed" tooltip="Use -1 for a random seed."><input id="extend-seed" className="text-field" type="number" min="-1" max={Number.MAX_SAFE_INTEGER} step="1" required disabled={busy}
value={Number.isNaN(options.seed) ? "" : options.seed} onChange={(event) => onChange({ ...options, seed: event.target.valueAsNumber })} /></PropRow>
- <p className="image-inspector__caption">Use -1 for a random seed.</p>
<div className="image-inspector__area"><span>Prompt</span><PromptTextField aria-label="Extend prompt" value={options.prompt} onChange={(prompt) => onChange({ ...options, prompt })}
references={references} missingLabel={missingLabel} disabled={busy} placeholder="Describe what should appear beyond the image…" /></div>
{validation.message && <InfoBar severity="error" title="Adjust the Extend settings" message={validation.message} />}
diff --git a/src/components/workspace/ImageEditor.tsx b/src/components/workspace/ImageEditor.tsx
index 93ea837..57e1b97 100644
--- a/src/components/workspace/ImageEditor.tsx
+++ b/src/components/workspace/ImageEditor.tsx
@@ -711,15 +711,14 @@ export function ImageEditor({ config, folderPath, onChange: changeConfig, onGene
<div className="image-inspector__fields">
{selected.kind === "root" && imageRoot && <>
{scene.sourceImage && <p className="image-inspector__caption">{scene.sourceImage.name} · {scene.sourceImage.width} × {scene.sourceImage.height}</p>}
- <p className="image-inspector__caption">Applies to the whole image before the individual edits.</p>
</>}
- <div className="image-inspector__area"><span id={rootField("prompt-label")}>{promptLabel}</span><PromptTextField key={selected.id} aria-labelledby={rootField("prompt-label")} value={selected.description} references={promptReferences} missingLabel={missingReference} onChange={(description) => patchNode({ description })} /></div>
+ <div className="image-inspector__area"><span id={rootField("prompt-label")} tabIndex={selected.kind === "root" && imageRoot ? 0 : undefined} data-tooltip={selected.kind === "root" && imageRoot ? "Applies to the whole image before the individual edits." : undefined}>{promptLabel}</span><PromptTextField key={selected.id} aria-labelledby={rootField("prompt-label")} value={selected.description} references={promptReferences} missingLabel={missingReference} onChange={(description) => patchNode({ description })} /></div>
{selected.kind === "text" && <PropRow label="Text to render" htmlFor={rootField("text")}><input id={rootField("text")} className="text-field" value={selected.text} onChange={(event) => patchNode({ text: event.target.value })} /></PropRow>}
{selected.kind === "root" && !imageRoot && <>
<div className="image-inspector__area"><span id={rootField("background-label")}>Background (environment)</span><PromptTextField aria-labelledby={rootField("background-label")} rows={3} value={scene.background} references={promptReferences} missingLabel={missingReference} onChange={(background) => commit({ ...scene, background })} /></div>
<PropSection title="Image generation" persistKey="image.generation">
<PropRow label="Steps" htmlFor={rootField("steps")}><input id={rootField("steps")} className="text-field" type="number" min="2" max="1000" value={scene.steps} onChange={(event) => { const value = Number(event.target.value); if (Number.isInteger(value) && value >= 2 && value <= 1000) commit({ ...scene, steps: value }); }} /></PropRow>
- <PropRow label="Seed" htmlFor={rootField("seed")}><input id={rootField("seed")} className="text-field" type="number" min="-1" max={Number.MAX_SAFE_INTEGER} value={scene.seed} data-tooltip="-1 picks a random seed" onChange={(event) => { const value = Number(event.target.value); if (Number.isSafeInteger(value) && value >= -1) commit({ ...scene, seed: value }); }} /></PropRow>
+ <PropRow label="Seed" htmlFor={rootField("seed")} tooltip="-1 picks a random seed"><input id={rootField("seed")} className="text-field" type="number" min="-1" max={Number.MAX_SAFE_INTEGER} value={scene.seed} onChange={(event) => { const value = Number(event.target.value); if (Number.isSafeInteger(value) && value >= -1) commit({ ...scene, seed: value }); }} /></PropRow>
{generatedImage && <UsedImageSeed id={rootField("used-seed")} seed={usedSeed} onError={setError} />}
<PropRow label="Aspect ratio" htmlFor={rootField("ratio")}><ComboBox id={rootField("ratio")} aria-label="Aspect ratio" value={settings.aspectRatio} options={["16:9", "9:16", "1:1", "4:5"].map((ratio) => ({ value: ratio, label: ratio }))} onChange={(value) => { const aspectRatio = value as ProjectConfig["settings"]["aspectRatio"]; onChange((current) => ({ ...current, imageSettings: { ...imageSettings(current), aspectRatio } })); }} /></PropRow>
<PropRow label="Resolution" htmlFor={rootField("resolution")}><ComboBox id={rootField("resolution")} aria-label="Resolution" value={settings.resolution} options={[...new Set([...PROJECT_RESOLUTIONS, settings.resolution])].map((resolution) => { const size = outputDimensions(resolution, settings.aspectRatio); return { value: resolution, label: `${size.width} × ${size.height}` }; })} onChange={(value) => { const resolution = value as ProjectConfig["settings"]["resolution"]; onChange((current) => ({ ...current, imageSettings: { ...imageSettings(current), resolution } })); }} /></PropRow>
diff --git a/src/components/workspace/ReferencesView.tsx b/src/components/workspace/ReferencesView.tsx
index a4ea369..098cf10 100644
--- a/src/components/workspace/ReferencesView.tsx
+++ b/src/components/workspace/ReferencesView.tsx
@@ -609,11 +609,10 @@ export function ReferencesView({ config, folderPath, onChange, onRegenerateIcon,
<button className="secondary-button" onClick={() => update(selected.id, { kind: "text", sourcePath: null, relativePath: null, video: undefined, images: referenceImages(selected) })}><Delete16 aria-hidden="true" /> Remove video</button>
</section>
</PropSection>}
- {selected.kind === "audio" && <PropSection title="Sound clip" persistKey="references.audio">
+ {selected.kind === "audio" && <PropSection title="Sound clip" persistKey="references.audio" tooltip="Needs a Ref2VA generator and an image or video reference in the same scene. Cite it in a shot to place it.">
<section className="reference-video" aria-label="Sound reference">
<ReferenceAudio key={`${selected.id}:${selected.sourcePath ?? selected.relativePath}`} folderPath={folderPath} reference={selected}
onChange={(audio) => update(selected.id, { audio })} />
- <p>Needs a Ref2VA generator and an image or video reference in the same scene. Cite it in a shot to place it.</p>
<button className="secondary-button" onClick={() => update(selected.id, { kind: "text", sourcePath: null, relativePath: null, audio: undefined })}><Delete16 aria-hidden="true" /> Remove sound</button>
</section>
</PropSection>}
@@ -661,35 +660,34 @@ export function ReferencesView({ config, folderPath, onChange, onRegenerateIcon,
<button type="button" className="icon-button" aria-label="Next reference image" data-tooltip="Next image" disabled={currentImagePage === selectedImages.length - 1} onClick={() => setImagePage(currentImagePage + 1)}><ChevronRight16 aria-hidden="true" /></button>
</div>}
</PropSection>}
- <PropSection title="Prompt" persistKey="references.prompt" summary={hasRefmods ? "Locked by refmods" : isReferenceDescribed(selected) ? undefined : "Not described"}>
+ <PropSection title="Prompt" persistKey="references.prompt" summary={hasRefmods ? "Locked by refmods" : isReferenceDescribed(selected) ? undefined : "Not described"}
+ tooltip={hasRefmods ? "Remove the refmods to edit the prompt or add files."
+ : isVideoReference(selected) ? "The clip is sent as a reference. Add a prompt to describe what to keep."
+ : selected.kind === "audio" ? "The sound is sent as a reference. Describe its role, such as the voice timbre for a character."
+ : !isReferenceDescribed(selected) ? selectedImages.length > 0
+ ? "Not described yet — the picture is sent, but nothing tells the engine what to keep."
+ : "Not described yet — it won’t be used until you add a definition."
+ : "Describe what should stay consistent — the traits, materials, colours, or wardrobe Slopus should preserve across shots."}>
<div className="reference-fields">
{/* The section header names the field on screen. */}
<label><span className="sr-only">Prompt</span><textarea className="text-field" disabled={hasRefmods} value={selected.description} placeholder="Describe what should stay consistent — the traits, materials, colours, or wardrobe Slopus should preserve across shots." onChange={(event) => update(selected.id, { description: event.target.value, content: event.target.value || null, subcategory: selectedSubcategory })} /></label>
- {hasRefmods ? <p>Remove the refmods to edit the prompt or add files.</p>
- : !isReferenceDescribed(selected) && <p>{isVideoReference(selected)
- ? "The clip is sent as a reference. Add a prompt to describe what to keep."
- : selected.kind === "audio"
- ? "The sound is sent as a reference. Describe its role, such as the voice timbre for a character."
- : selectedImages.length > 0
- ? "Not described yet — the picture is sent, but nothing tells the engine what to keep."
- : "Not described yet — it won’t be used until you add a definition."}</p>}
</div>
</PropSection>
{hasRefmods && <PropSection
title="Refmods"
+ tooltip="Needs a Ref2VA generator."
persistKey="references.refmods"
summary={selected.refmods!.length}
actions={<button type="button" className="icon-button prop-row__button" aria-label="Remove refmods" data-tooltip="Remove all refmods" onClick={() => update(selected.id, { iconRelativePath: undefined, refmods: [] })}><Delete16 aria-hidden="true" /></button>}
>
<section className="reference-refmods" aria-label="Refmod attachments">
- <p>Needs a Ref2VA generator. Strength 0 turns a refmod off; more copies use more GPU memory.</p>
{selected.refmods!.map((refmod) => <div key={refmod.id}>
<b data-tooltip={refmod.name}>{refmod.name}</b>
- <PropRow label="Strength" htmlFor={`${refmod.id}-strength`}><input id={`${refmod.id}-strength`} className="text-field" aria-label={`${refmod.name} strength`} type="number" min={0} max={1} step={0.05} value={refmod.strength} onChange={(event) => {
+ <PropRow label="Strength" htmlFor={`${refmod.id}-strength`} tooltip="Strength 0 turns a refmod off."><input id={`${refmod.id}-strength`} className="text-field" aria-label={`${refmod.name} strength`} type="number" min={0} max={1} step={0.05} value={refmod.strength} onChange={(event) => {
const strength = Number(event.target.value);
if (event.target.value && Number.isFinite(strength) && strength >= 0 && strength <= 1) update(selected.id, { iconRelativePath: undefined, refmods: selected.refmods!.map((entry) => entry.id === refmod.id ? { ...entry, strength } : entry) });
}} /></PropRow>
- <PropRow label="Copies" htmlFor={`${refmod.id}-copies`}><input id={`${refmod.id}-copies`} className="text-field" aria-label={`${refmod.name} copies`} type="number" min={1} max={10} step={1} value={refmod.copies} onChange={(event) => {
+ <PropRow label="Copies" htmlFor={`${refmod.id}-copies`} tooltip="More copies use more GPU memory."><input id={`${refmod.id}-copies`} className="text-field" aria-label={`${refmod.name} copies`} type="number" min={1} max={10} step={1} value={refmod.copies} onChange={(event) => {
const copies = Number(event.target.value);
if (Number.isInteger(copies) && copies >= 1 && copies <= 10) update(selected.id, { iconRelativePath: undefined, refmods: selected.refmods!.map((entry) => entry.id === refmod.id ? { ...entry, copies } : entry) });
}} /></PropRow>
diff --git a/src/components/workspace/SceneEditor.tsx b/src/components/workspace/SceneEditor.tsx
index ce68810..bbcb7a6 100644
--- a/src/components/workspace/SceneEditor.tsx
+++ b/src/components/workspace/SceneEditor.tsx
@@ -156,7 +156,7 @@ export function ShotInspector({ job, shots, shot, index, endsAt, duration, refer
return <section className={`shot-inspector${promptOnly ? " shot-inspector--flat" : ""}`} aria-label={`Shot ${shotNumber}`}>
{group("Shot", "shot", `${seconds(shot.startSeconds)} – ${seconds(endsAt)}`, <>
- {!promptOnly && <PropRow label="Starts at" htmlFor={`shot-start-${shot.id}`}>
+ {!promptOnly && <PropRow label="Starts at" htmlFor={`shot-start-${shot.id}`} tooltip={index === 0 ? "The first shot always opens the scene." : undefined}>
<input
id={`shot-start-${shot.id}`}
className="text-field"
@@ -167,7 +167,6 @@ export function ShotInspector({ job, shots, shot, index, endsAt, duration, refer
value={shot.startSeconds}
disabled={disabled || index === 0}
aria-label={`Shot ${shotNumber} starts at, in seconds`}
- data-tooltip={index === 0 ? "The first shot always opens the scene." : undefined}
onChange={(event) => onChange({ startSeconds: Math.min(duration, Math.max(0, Number(event.target.value) || 0)) })}
/>
<span className="prop-unit">to {seconds(endsAt)}</span>
@@ -243,22 +242,20 @@ function CharacterReplaceInputs({ shot, references, disabled, onChange }: {
const characters = references.filter((reference) => !isVideoReference(reference) && isVisualReference(reference)
&& isReferenceUsable(reference) && referenceImages(reference).length > 0);
return <div className="scene-settings">
- <PropRow label="Video" htmlFor={`replace-video-${shot.id}`}>
+ <PropRow label="Video" htmlFor={`replace-video-${shot.id}`} tooltip="Uses the clip range and soundtrack setting saved under References.">
<ComboBox id={`replace-video-${shot.id}`} aria-label="Video reference for this shot" value={shot.videoReferenceId ?? ""} disabled={disabled}
options={referenceOptions(videos, shot.videoReferenceId, "None", "Unavailable video reference")}
onChange={(value) => onChange({ videoReferenceId: value || null })} />
</PropRow>
- <p className="prop-caption">Uses the clip range and soundtrack setting saved under References.</p>
<PropRow label="New character" htmlFor={`replace-character-${shot.id}`}>
<ComboBox id={`replace-character-${shot.id}`} aria-label="New character reference for this shot" value={shot.characterReferenceId ?? ""} disabled={disabled}
options={referenceOptions(characters, shot.characterReferenceId, "None", "Unavailable character reference")}
onChange={(value) => onChange({ characterReferenceId: value || null })} />
</PropRow>
- <PropRow label="Replace" htmlFor={`replace-target-${shot.id}`}>
+ <PropRow label="Replace" htmlFor={`replace-target-${shot.id}`} tooltip="With several characters, name one, for example “the person in the red jacket”. Camera, background, lighting and other characters are kept.">
<input id={`replace-target-${shot.id}`} className="text-field" aria-label="Character to replace in this shot" value={shot.characterTarget ?? ""} disabled={disabled}
placeholder="The main character" onChange={(event) => onChange({ characterTarget: event.target.value || null })} />
</PropRow>
- <p className="prop-caption">With several characters, name one, for example “the person in the red jacket”. Camera, background, lighting and other characters are kept.</p>
</div>;
}
@@ -322,13 +319,13 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenes
return <section className="scene-inspector" aria-label="This scene">
<div role="region" aria-label="Scene" className="scene-settings">
<PropSection title="Scene" persistKey="generator.scene" summary={SCENE_TYPES.find((type) => type.value === sceneType)?.label}>
- <PropRow label="Scene type" htmlFor={`${id}-type`}>
+ <PropRow label="Scene type" htmlFor={`${id}-type`} tooltip={characterReplace ? "Open a shot to choose its source video and new character." : animate ? "Animate output is limited to 14.375 seconds; longer scenes are shortened to fit." : undefined}>
<ComboBox id={`${id}-type`} aria-label="Scene type" value={sceneType} disabled={disabled} options={SCENE_TYPES}
onChange={(value) => onChange({ sceneType: value as SceneType, usePreviousSceneLastFrame: undefined,
...(value === "animate" ? { endFrameReferenceId: undefined } : {}) })} />
</PropRow>
{continuing && <>
- <PropRow label="Source scene" htmlFor={`${id}-source-scene`}>
+ <PropRow label="Source scene" htmlFor={`${id}-source-scene`} tooltip="Uses the selected scene’s saved latents. Generate it first, or use Generate all.">
<ComboBox id={`${id}-source-scene`} aria-label="Source scene for continuation" disabled={disabled}
value={job.continuationSceneId ?? ""}
options={[{ value: "", label: "None" },
@@ -342,7 +339,7 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenes
value={job.continuationFrom ?? "end"} options={[{ value: "end", label: "End" }, { value: "start", label: "Start" }]}
onChange={(value) => onChange({ continuationFrom: value as "start" | "end" })} />
</PropRow>
- <PropRow label="Overlap frames" htmlFor={`${id}-overlap`}>
+ <PropRow label="Overlap frames" htmlFor={`${id}-overlap`} tooltip="Overlap uses 22, 39, 56, … frames at 24 fps.">
<ComboBox id={`${id}-overlap`} aria-label="Continuation overlap frames" disabled={disabled}
value={String(job.continuationOverlapFrames ?? DEFAULT_CONTINUATION_OVERLAP)}
options={Array.from({ length: (MAX_CONTINUATION_OVERLAP - DEFAULT_CONTINUATION_OVERLAP) / 17 + 1 }, (_, index) => {
@@ -351,41 +348,38 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenes
})}
onChange={(value) => onChange({ continuationOverlapFrames: Number(value) })} />
</PropRow>
- <PropRow label="Lock Overlap" htmlFor={`${id}-lock-overlap`}>
+ <PropRow label="Lock Overlap" htmlFor={`${id}-lock-overlap`} tooltip="Lock Overlap constrains the overlapping video and audio to the source.">
<ToggleSwitch id={`${id}-lock-overlap`} aria-label="Lock Overlap" checked={job.continuationLockOverlap ?? false} disabled={disabled}
onChange={(checked) => onChange({ continuationLockOverlap: checked })} />
</PropRow>
- <p className="prop-caption">Uses the selected scene’s saved latents. Generate it first, or use Generate all. Overlap uses 22, 39, 56, … frames at 24 fps. Lock Overlap constrains the overlapping video and audio to the source.</p>
</>}
{pose && <>
- <PropRow label="Pose video" htmlFor={`${id}-pose`}>
+ <PropRow label="Pose video" htmlFor={`${id}-pose`} tooltip="Uses the saved clip range for pose and motion. Describe the subject and setting below.">
<ComboBox id={`${id}-pose`} aria-label="Pose video reference for this scene" value={job.poseVideoReferenceId ?? ""} disabled={disabled}
options={referenceOptions(videos, job.poseVideoReferenceId, "None", "Unavailable video reference")}
onChange={(value) => onChange({ poseVideoReferenceId: value || null })} />
</PropRow>
- <p className="prop-caption">Uses the saved clip range for pose and motion. Describe the subject and setting below.</p>
{shots.map((shot, index) => <ShotInspector key={shot.id} job={job} shots={shots} shot={shot} index={index}
endsAt={shots[index + 1]?.startSeconds ?? sceneDurationSeconds(job)} duration={sceneDurationSeconds(job)}
references={references} folderPath={folderPath} disabled={disabled} promptOnly
onChange={(updates) => onShots(shots.map((item) => item.id === shot.id ? { ...item, ...updates } : item))} />)}
</>}
- {characterReplace && <p className="prop-caption">Open a shot to choose its source video and new character.</p>}
{transition && <>
- <PropRow label={sceneType === "bridge" ? "Start video" : "Video"} htmlFor={`${id}-start-video`}>
+ <PropRow label={sceneType === "bridge" ? "Start video" : "Video"} htmlFor={`${id}-start-video`}
+ tooltip={`${sceneType === "bridge" ? "Connects the end of the start video to the beginning of the end video." : "Continues from the end of the selected video."} Open a shot to describe the new action; the scene length sets only the new segment.`}>
<ComboBox id={`${id}-start-video`} aria-label="Start video reference for this scene" value={job.startVideoReferenceId ?? ""} disabled={disabled}
options={referenceOptions(videos, job.startVideoReferenceId, "None", "Unavailable video reference")}
onChange={(value) => onChange({ startVideoReferenceId: value || null })} />
</PropRow>
- {sceneType === "bridge" && <PropRow label="End video" htmlFor={`${id}-end-video`}>
+ {sceneType === "bridge" && <PropRow label="End video" htmlFor={`${id}-end-video`} tooltip="Connects the end of the start video to the beginning of the end video.">
<ComboBox id={`${id}-end-video`} aria-label="End video reference for this scene" value={job.endVideoReferenceId ?? ""} disabled={disabled}
options={referenceOptions(videos, job.endVideoReferenceId, "None", "Unavailable video reference")}
onChange={(value) => onChange({ endVideoReferenceId: value || null })} />
</PropRow>}
- <p className="prop-caption">{sceneType === "bridge" ? "Connects the end of the start video to the beginning of the end video." : "Continues from the end of the selected video."} Open a shot to describe the new action; the scene length sets only the new segment.</p>
</>}
{!characterReplace && <>
{animate && <>
- <PropRow label="Video" htmlFor={`${id}-animate-video`}>
+ <PropRow label="Video" htmlFor={`${id}-animate-video`} tooltip="One driving video and one repainted frame of its scene. Turn on the video’s soundtrack under References to keep it.">
<ComboBox id={`${id}-animate-video`} aria-label="Reference video for this scene" disabled={disabled}
value={videos.find((reference) => job.referenceIds.includes(reference.id))?.id ?? ""}
options={referenceOptions(videos, null, "None", "")}
@@ -394,7 +388,6 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenes
...(value ? [value] : []),
] })} />
</PropRow>
- <p className="prop-caption">One driving video and one repainted frame of its scene. Turn on the video’s soundtrack under References to keep it.</p>
</>}
{!animate && <PropRow label="Look" htmlFor={`${id}-look`}>
<ComboBox
@@ -415,7 +408,7 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenes
</PropRow>}
{!animate && !chosen && defaultLook && <p className="prop-caption">Using project Look: {look.options.find((option) => option.id === defaultLook)?.label ?? defaultLook}.</p>}
{!transition && !pose && !continuing && <>
- <PropRow label={animate ? "Repainted frame" : "Start frame"} htmlFor={`${id}-start`}>
+ <PropRow label={animate ? "Repainted frame" : "Start frame"} htmlFor={`${id}-start`} tooltip={animate ? "A frame of the driving video with the character repainted. Keep its pose, framing, background and lighting." : undefined}>
<ReferenceSelector
id={`${id}-start`}
references={references} accept={["image"]} folderPath={folderPath}
@@ -435,7 +428,6 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenes
/>
{addImageButton(animate ? "Add repainted frame" : "Add start frame", onAddStartFrame)}
</PropRow>
- {animate && <p className="prop-caption">A frame of the driving video with the character repainted. Keep its pose, framing, background and lighting.</p>}
</>}
{!animate && !transition && !pose && !continuing && <PropRow label="Last frame" htmlFor={`${id}-end`}>
<ReferenceSelector id={`${id}-end`} value={job.endFrameReferenceId ?? ""} disabled={disabled} aria-label="Last frame for this scene"
@@ -473,7 +465,6 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenes
</div>
<div role="region" aria-label="Generation" className="scene-settings">
<PropSection title="Generation" persistKey="generator.generation" summary={`${sceneGenerationSteps(job, defaultSteps)} steps`}>
- {animate && <p className="prop-caption">Animate output is limited to 14.375 seconds; longer scenes are shortened to fit.</p>}
<PropRow label="Steps" htmlFor={`${id}-steps`}>
<CommittedNumberInput
id={`${id}-steps`}
@@ -488,15 +479,15 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenes
onCommit={(value) => onChange({ steps: value })}
/>
</PropRow>
- <PropRow label="Separate audio steps" htmlFor={`${id}-separate-audio-steps`}>
+ <PropRow label="Separate audio steps" htmlFor={`${id}-separate-audio-steps`} tooltip="Audio uses the video generation step count unless separate audio steps are enabled.">
<ToggleSwitch id={`${id}-separate-audio-steps`} aria-label="Separate audio steps" checked={job.audioSteps != null} disabled={disabled}
onChange={(checked) => onChange({ audioSteps: checked ? Math.min(sceneGenerationSteps(job, defaultSteps), MAX_AUDIO_GENERATION_STEPS) : undefined })} />
</PropRow>
- {job.audioSteps != null ? <PropRow label="Audio steps" htmlFor={`${id}-audio-steps`}>
+ {job.audioSteps != null && <PropRow label="Audio steps" htmlFor={`${id}-audio-steps`}>
<CommittedNumberInput id={`${id}-audio-steps`} className="text-field" minimum={2} maximum={MAX_AUDIO_GENERATION_STEPS} step={1}
value={job.audioSteps} integer disabled={disabled} aria-label="Audio step count" onCommit={(value) => onChange({ audioSteps: value })} />
- </PropRow> : <p className="prop-caption">Audio uses the video generation step count.</p>}
- <PropRow label="Seed" htmlFor={`${id}-seed`}>
+ </PropRow>}
+ <PropRow label="Seed" htmlFor={`${id}-seed`} tooltip="-1 picks a random seed">
<CommittedNumberInput
id={`${id}-seed`}
className="text-field"
@@ -507,15 +498,13 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenes
integer
disabled={disabled}
aria-label="Generation seed"
- data-tooltip="-1 picks a random seed"
onCommit={(value) => onChange({ seed: value })}
/>
</PropRow>
- <PropRow label="Latent upscale" htmlFor={`${id}-latent-upscale`}>
+ <PropRow label="Latent upscale" htmlFor={`${id}-latent-upscale`} tooltip="Generate at half resolution, then upscale to the selected resolution. Requires Latent upscale weights in Settings → Generator → Other weights.">
<ToggleSwitch id={`${id}-latent-upscale`} aria-label="Latent upscale" checked={job.latentUpscale ?? false} disabled={disabled}
onChange={(checked) => onChange({ latentUpscale: checked })} />
</PropRow>
- <p className="prop-caption">Generate at half resolution, then upscale to the selected resolution. Requires Latent upscale weights in Settings → Generator → Other weights.</p>
</PropSection>
</div>
</section>;
@@ -545,7 +534,7 @@ function ShotSettings({ settings, disabled, shotNumber, onChange }: {
<ul className="shot-settings__chips">
{chosen.map(({ group: owner, option }) => <li key={`${owner.id}-${option.id}`}>
<span className="setting-tag" data-tooltip={`Adds “${option.term}” to the prompt`}>
- <em>{owner.label}</em>
+ <em data-tooltip={owner.help} tabIndex={0}>{owner.label}</em>
<b>{option.label}</b>
<button
type="button"
@@ -562,6 +551,7 @@ function ShotSettings({ settings, disabled, shotNumber, onChange }: {
value={pending}
disabled={disabled}
placeholder="Add a setting…"
+ data-tooltip={group?.help}
aria-label={`Add a setting to shot ${shotNumber}`}
options={groups.map((option) => {
// Speed and amplitude qualify a movement. With none chosen the
@@ -584,7 +574,6 @@ function ShotSettings({ settings, disabled, shotNumber, onChange }: {
setPending(null);
}}
/>}
- {group && <span className="shot-settings__help">{group.help}</span>}
</div>
</div>;
}
diff --git a/src/styles/generator.css b/src/styles/generator.css
index 2d76fd7..349e76f 100644
--- a/src/styles/generator.css
+++ b/src/styles/generator.css
@@ -865,12 +865,6 @@
gap: var(--space-2);
}
-.shot-settings__help {
- color: var(--text-muted);
- font-size: var(--text-xs);
- line-height: var(--leading-snug);
-}
-
/* --- The compiled prompt (Debug prompt dialog) ----------------------------- */
.debug-prompt {