6.2 KiB
title, description
| title | description |
|---|---|
| Film 与渲染 | 装配并列的画面与声音贡献,再渲染所选节目区间。 |
Film 是普通作者组件。它把显式选择的 VisualTrack、AudioTrack 与一个 Canvas、一个 Timeline 组合成 Composition。渲染器再把 Composition 变成视频。
<import as="space" from="@hypit/spatial@1"/>
<import as="film" from="@hypit/film@1"/>
<import as="html" from="@hypit/html-video@1"/>
装配 Film
<space:Canvas id="vertical" width="1080" height="1920"/>
<film:Film id="main" canvas={vertical.canvas} timeline={speech.timeline}
appearance={recipes.film.vertical}>
<film:Track id="picture" source={picture.visual}/>
<film:Track source={mix.audio}/>
<film:Track id="cards" source={cards.visual}/>
<film:Track id="captions" source={captions.visual}/>
<film:Track id="meaning" source={meaning.visual}/>
</film:Film>
| 属性 | 必填 | 含义 |
|---|---|---|
id |
是 | 公开 Composition 身份 |
canvas |
是 | 画面坐标系 |
timeline |
是 | 有限的绝对节目范围 |
appearance |
是 | Film Recipe,包括清屏颜色 |
每个 <film:Track> 接受一个 VisualTrack 或 AudioTrack。Film 不会发现某个输出的“兄弟端口”。
如果同一份准备媒体要同时贡献画面和声音,就分别从它声明一个 Visual Clip 和一个
Audio Clip,并在这里显式选择两边产出的 Track。
常见输出包括:
| 来源 | 类型 | 角色 |
|---|---|---|
{picture.visual} |
VisualTrack | Visual Track 放置的画面出现关系 |
{mix.audio} |
AudioTrack | Audio Track 中的语音、音乐与效果 |
{cards.visual} |
VisualTrack | 独立图片或视频 Clip |
{captions.visual} |
VisualTrack | Caption 家族 |
{scene.visual} |
VisualTrack | 项目组件 |
公开输出是 {main.composition}。
画面顺序属于父 Scope
Film 子项负责选择并放置贡献。每个视觉 <film:Track> 与 <film:Stack> 都携带由直属父
VisualScope 拥有的 id;同级成员按声明顺序从后向前绘制。组件只发布可复用的 Track 局部 programme,
不携带它在未知未来 Film 中的位置。Stack 封闭子 VisualScope,并在自身声明的位置作为一张画面进入父
Scope。id 只负责寻址,不会暗中参与绘制顺序。同一个 VisualTrack 可以通过不同成员 id 重复放置。
film.vertical { background: #09090B; }
media.speaker { fit: cover; }
media.card { fit: contain; }
caption.base { }
item 保持在所属 Track 的放置关系内。若多张画面、图形与文字因为共享布局或运动而需要局部交错顺序, 应由一个组件拥有该 programme 及其内部元素树或浏览器程序;仍可独立使用的贡献保持为并列 Track。
闭合局部视觉栈
若一组画面需要先合成为一张 Picture,并让一个 Adjustment 只作用于该组,使用 Film Stack:
<import as="adjust" from="@hypit/visual-adjustment@1"/>
<import as="treatment" from="@hypit/visual-treatment@1"/>
<treatment:Color id="cinematic" contrast="1.08" saturation="0.9" hue="-2"/>
<adjust:Track id="look" timeline={speech.timeline}>
<adjust:Adjustment id="grade" during={speech.window}
effect={cinematic}/>
</adjust:Track>
<film:Film id="main" canvas={vertical.canvas} timeline={speech.timeline}
appearance={recipes.film.vertical}>
<film:Track id="background" source={background.visual}/>
<film:Stack id="treated-subject">
<film:Track id="subject" source={subject.visual}/>
<film:Track id="look" source={look.visual}/>
</film:Stack>
<film:Track id="captions" source={captions.visual}/>
<film:Track source={dialogue.audio}/>
</film:Film>
Stack 从透明画面开始,在父 Scope 中按自身声明位置作为一张画面进入。Adjustment 只变换该 Stack 内已经累积的 画面。AudioTrack 保持在 Film 根上,不会继承视觉 Stack 的归属。
渲染完整视频
<html:Video id="final"
composition={main.composition}/>
渲染器编译视觉贡献、捕获所需帧、渲染 AudioTrack,并复用封装为交付文件。
{final.video} 是普通 Resource-backed Blob,通常也是 Invocation Target。
<?svml using="@hypit/markup/invocation@1"?>
<svrun version="1">
<author source="./main.svml"/>
<target output="final.video"/>
</svrun>
渲染帧区间
<html:Video id="detail" composition={main.composition}
start-frame="240" end-frame-exclusive="360"/>
边界使用原 Timeline 的半开区间。30 fps 时,这个例子渲染第 8–12 秒。即使输出片段从零 开始,动画和媒体采样仍保留原节目位置。区间渲染只限制最终捕获与编码;构建仍会执行目标所需的 上游工作,因此已接受的媒体与对齐证据应在 Author Source 中显式选择。
完全由组件绘制的影片
Timeline 不要求语音或媒体:
<import as="time" from="@hypit/timeline-author@1"/>
<time:Clock id="animation-clock" frame-rate="30"/>
<time:Timeline id="animation" clock={animation-clock} end="8s">
<time:Instant id="question" at="0.5s"/>
<time:Instant id="answer" at="2s"/>
</time:Timeline>
<chat:Scene id="conversation" timeline={animation.timeline} within={canvas.bounds}
during={animation.window}>
<chat:Message id="question" at={animation.question} sender="Maya" text="Ready?"/>
<chat:Message id="answer" at={animation.answer} sender="Leo" text="Let's go."/>
</chat:Scene>
<film:Film id="main" canvas={canvas.canvas} timeline={animation.timeline}
appearance={recipes.film.main}>
<film:Track id="conversation" source={conversation.visual}/>
</film:Film>
<html:Video id="final" composition={main.composition}/>
组件用普通绝对时间拥有自己的阅读节奏。没有选择 AudioTrack 时,结果是静音的。在语音作品 中,Narrative Projection 可以把 Moment 或 Selection 显影成同样的绝对 Instant 与 Window 输入。
执行前检查
hypit check main.svml
hypit plan build.svrun
check 在不调用外部服务的情况下验证导入、类型和引用。plan 显示所选 Target 与外部工作。付费执行前应检查该计划。
时间与装配解释媒体准备、Timeline 构造、媒体放置与语义投影; Tracks解释 Visual 和 Audio 的作者形式。