LumiBot：Перевод с русской вики (задача №978, LS Dev Hub)

2026-09-02T19:19:20Z

Перевод с русской вики (задача №978, LS Dev Hub)

新页面

[[ru:Настройки GIF превью]] [[en:GIF Preview Settings]] [[zh:GIF预览设置]]
每个导出的cue文件都会连同灯具数据一起保存一段简短的GIF动画——合成(Composition)的预览图。这正是'''Light Stream Player'''在动画列表中显示的内容,因此操作员无需运行合成即可通过预览找到需要的合成。无需单独制作和上传图片:预览会在导出过程中自动生成。

预览可以设置三项内容:从哪个视角拍摄、持续多长时间,以及画面精细到什么程度。

== 设置位置 ==

GIF预览的参数是软件级(而非项目级)的:它们保存在本机上,并同时应用于所有项目和所有合成。

可以通过两种方式打开这些设置:

* 菜单'''设置(Settings)''' → '''属性(Properties)'''(''Ctrl+P''),'''导出(Export)'''选项卡,'''GIF设置(GIF Settings)'''组;
* 在'''导出(Export)'''窗口中——点击'''导出模式(Export Mode)'''列表右侧的齿轮按钮:它会直接打开所需的选项卡。

更改会立即生效,并应用于下一次导出。已经导出的cue文件不会改变:要更新其中的预览图,需要重新导出该合成。

== 参数 ==

{| class="wikitable"
! 参数 !! 作用 !! 取值
|-
| '''颜色(Colors)''' || 生成动画的调色板大小。颜色越多,平滑过渡和渐变看起来越干净,但文件也越大 || 32、64、128、256。默认值为128
|-
| '''质量(Quality)''' || 动画的流畅度——即帧的采集频率(见下表) || 从'''最高(Maximum)'''到'''最低(Minimum)'''。默认值为'''中等(Medium)'''
|-
| '''时长,秒(Duration, sec)''' || 合成中有多少秒会进入预览 || 从1到100。默认值为15
|}

质量决定动画帧之间的时间间隔:

{| class="wikitable"
! 质量 !! 帧间隔 !! 每秒帧数
|-
| '''最高(Maximum)''' || 0.03秒 || 约33
|-
| '''非常高(Very High)''' || 0.06秒 || 约17
|-
| '''高(High)''' || 0.09秒 || 约11
|-
| '''中等(Medium)''' || 0.12秒 || 约8
|-
| '''低(Low)''' || 0.15秒 || 约7
|-
| '''非常低(Very Low)''' || 0.20秒 || 5
|-
| '''最低(Minimum)''' || 0.30秒 || 约3
|}

动画本身的播放速度与质量无关:预览始终以实时速度播放,和合成一样,并且是循环播放的——在'''Player'''中它会循环播放。质量只影响流畅度和帧数,从而影响文件大小。

== 预览中包含的内容 ==

'''拍摄视角'''不是在设置中选择,而是直接在'''导出(Export)'''窗口的'''选择视图(Select View)'''列表中选择:

* '''映射预览(Mapping Preview)'''——拍摄'''映射(Mapping)'''字段的平面图像:效果呈现为它们在映射上的样子,不包含三维场景。这是通用选项,在没有搭建3D场景的项目中也能使用。
* 列表中的其他任何选项——来自'''3D视图(3D View)'''窗口中某个摄像机的视角,包括项目中添加的摄像机。这样预览呈现的对象效果就如同观众所看到的一样。

'''画面始终为正方形''',尺寸为256×256像素。'''3D视图'''窗口通常比这更宽,因此进入预览的并非屏幕上显示的全部内容,而只是中央的正方形区域。要提前查看该区域的边界,请启用'''查看(View)''' → '''3D视图(3D View)''' → '''显示3D GIF边界(Show 3D GIF Bounds)'''(''F5''键):窗口边缘会变暗,中央未变暗的正方形就是未来预览画面的范围。通过移动摄像机或改变其视野角度,可以方便地把对象调整到这个正方形内。

'''片段取自合成的中间部分。'''例如,时长设为15秒时,一个两分钟的合成将截取其中间约15秒的内容进入预览:前后各七秒半。如果合成的时长短于设定的时长,则整个合成都会进入预览。

'''辅助性3D对象不会出现在预览中'''——摄像机图标、投影图标以及其他辅助标记在渲染期间都会被隐藏,即使它们在'''3D视图'''窗口中处于显示状态。而其余的一切都会按原样拍摄:模型、场景背景、灯具的光效。

== 如何选择设置 ==

默认值(128色、'''中等'''、15秒)适用于大多数项目——可以不做改动。有两种情况值得调整。

'''文件过大,上传到Player耗时较长。'''预览图保存在cue文件内部,因此它总会增加文件的大小。请按以下顺序依次调低:先调'''时长''',通常5–10秒足以辨认动画,然后调'''质量''',最后调'''颜色'''。当项目中有几十个合成时,这一点尤其明显。

'''预览效果比动画本身差。'''如果合成中有平滑的色彩渐变,把'''颜色'''调高到256——过渡处的色阶和斑块就会消失。如果动画很快、预览显得“卡顿”,把'''质量'''调高到'''高'''或'''非常高'''。

通常的操作流程如下:

# 在'''导出'''窗口中选择一个能让对象一眼就能被认出的视图。
# 如果是从3D摄像机拍摄,启用''F5''并检查对象是否位于正方形范围内。
# 在程序设置的'''导出'''选项卡中设置参数。
# 导出一个合成并查看结果——导出过程中,结果会在'''导出'''窗口左侧的图像中播放。
# 如果满意,再导出其余的合成。

== 如果预览效果不理想 ==

* '''黑色方块而不是动画'''——预览是从一个没有对准对象的3D摄像机拍摄的,或者场景中没有可显示的内容。请选择其他摄像机或'''映射预览'''。
* '''对象太小或被裁切'''——启用'''显示3D GIF边界'''(''F5''),并调整摄像机,使对象填满中央正方形区域。
* '''预览中出现摄像机图标或其他标记'''——正常情况下不应出现这种情况,辅助对象不会进入画面。如果预览中还有其他干扰内容,请检查场景中是否启用了多余的对象或背景图片。
* '''预览中的动画不流畅'''——调高'''质量'''。
* '''渐变处出现条纹和斑块'''——把'''颜色'''调高到256。
* '''Player中显示的是旧预览'''——文件没有被覆盖:请重新导出合成,并将cue文件重新上传到播放器。

== 参见 ==

* [[Экспорт композиций]]
* [[Импорт cue в Player]]
* [[切换视图和摄像机]]
* [[合成设置]]
* [[Терминология]]

GIF预览设置 - 版本历史

LumiBot：​Перевод с русской вики (задача №978, LS Dev Hub)

LumiBot：Перевод с русской вики (задача №978, LS Dev Hub)