视频贴图

概述

视频贴图可以进行解码，并回放贴图的视频文件。该文档会描述将一个视频文件导入为一个新的视频贴图资源的过程，以及如何在关卡中使用它。

导入新视频文件

视频贴图导入方法与导入一个常规的 2d 贴图资源一样。 在 Generic Browser（通用浏览器）的文件菜单中，选择导入选项。 目前，唯一受支持的视频文件格式是 Bink (*.bik)。 只要选择了文件，就会显示导入对话框，可以指定要创建的对象及其包的名称。

如果视频文件导入正确，那么您应该会看到一个新的视频贴图缩略图图标，并附带有关视频回放持续时间和帧频率的详细信息。 请注意要创建的视频贴图与解码的视频帧宽度和高度将会相同。

现在，可以将视频贴图作为样本，就像常规的 2d 贴图资源一样可以在材质中使用。 然后，可以将材质应用于关卡中的表面。

视频贴图属性

为如何动态载入视频进行回放提供了两个选项：

MovieStream_Memory - 该选项会在回放开始前将视频文件的整个内容加载到内存中。然后，解码器会直接在该内存中解码该视频流。

MovieStream_File - （未实现）

为控制资源的初始视频回放状态提供了以下选项：

Looping - 如果已启用该选项，那么视频会从视频的开头开始，只要视频播放到结束位置就会来回循环并重新开始回放。

AutoPlay - 如果已启用该选项，那么回放会在视频导入完成后立即开始。 否则，只是解码视频的单个帧，然后回放暂停。

脚本功能

以下是一些可以通过从脚本中引用 TextureMovie（贴图视频）资源控制的回放功能：

Play() - 开始进行视频的解码和回放。此外，调用该函数不会暂停之前暂停的视频，或在已经停止的视频上重新开始回放。

Pause() - 暂时停止视频的解码和回放。调用 Play() 将会重新开始回放。

Stop() - 与 Pause() 相同，只是会将视频流也重置为第一帧。 调用 Play() 将会重新开始回放。

请注意从视频流媒体进行解码将会耗尽相当多的 CPU 时间，在渲染线程上进行解码的情况除外。