Video(virtools BB模块汉语翻译及用法详解).doc

VideoDx8 Video Dependency Version 1.00 - VirtoolsCategorized in Video/Dependency DescriptionApply to a BEOBJECT.Add this BB to your composition to download the DirectX 8 Video Engine in the Virtools 3D Life Player. Technical InformationBy default, no video engine is downloaded by the Virtools Web player. Add this BB to your composition to ensurethe Dx8 Video Engine is downloadedbythe users Virtools Web Player. If DirectX 8 is installed, video playback will be available for your composition with the Dx8Video Engine.WarningThe Dx8 video engine is more compact, while video playback with a Dx9 rasterizer will be better optimised with the Dx9 Video Engine. While the Dx8 Video Dependency BB will work under a Dx9 (rasterizer). The inverse - a DX8 (rasterizer) with the Dx9 video Engine) - is incompatible, so if you use the Dx9 Video Dependency BB, you should also use the Dx8 Video Dependency. Note: You may choose only to include the Dx8 Video Dependency BB to decrease the Web Player installation time. 视频DX8 视频附属在Video/Dependency中将其分类描述适用于交互对象添加这个BB到你的项目中，就可以在Virtools 3D播放器中下载DX8视频引擎。技术信息以默认值，没有视频引擎被下载到Virtools网络播放器中。添加这个BB到你的项目中并确保DX8视频引擎在用户的Virtools网络播放器中。如果DX8被要求，视频的录制功能将使用DX8 视频引擎被用在你的项目中警告DX8视频引擎更加结实，当Dx8 Video Dependency BB在DX9下工作时，在一个DX9的光栅下录制视频时将更好的在DX9视频引擎下。所以，如果你使用Dx9 Video Dependency BB,你应该也使用DX8视频附属提示：你可以只选择包含DX8 Video Dependency BB来减小网络播放器的使用时间。Dx9 Video Dependency Version 1.00 - VirtoolsCategorized in Video/Dependency DescriptionApply to a BEOBJECT.Add this BB to your composition to download the DirectX 9Video Engine in the Virtools 3D Life Player. Technical InformationBy default, no video engine is downloaded by the Virtools Web player. Add this BB to your composition to ensurethe Dx9 Video Engine is downloadedbythe users Virtools 3D Life Player. If DirectX 9 (rasterizer) is installed, video playback will be available for your composition with the Dx9Video Engine. WarningVideo playback with a Dx9 rasterizer will be better optimised with the Dx9 Video Engine; however, the Dx8 Video Dependency BB will work under a Dx9 (rasterizer). The inverse - a DX8 (rasterizer) with the Dx9 video Engine) - is incompatible, so if you use the Dx9 Video Dependency BB, you should also use the Dx8 Video Dependency BB . Note: You may choose only to include the Dx8 Video Dependency BB to decrease the Web Player installation time. DX9 视频附属在Video/Dependency中将其分类描述适用于交互对象添加这个BB到你的项目中，就可以在Virtools 3D播放器中下载DX9视频引擎。技术信息以默认值，没有视频引擎被下载到Virtools网络播放器中。添加这个BB到你的项目中并确保DX9视频引擎在用户的Virtools网络播放器中。如果DX9被要求，视频的录制功能将使用DX9 视频引擎被用在你的项目中警告DX9视频引擎更加结实，当Dx8 Video Dependency BB在DX9下工作时，在一个DX9的光栅下录制视频时将更好的在DX9视频引擎下。所以，如果你使用Dx9 Video Dependency BB,你应该也使用DX8视频附属提示：你可以只选择包含DX8 Video Dependency BB来减小网络播放器的使用时间。Get Video Input Formats Version 1.00 - VirtoolsCategorized in Video/Basic DescriptionApply to a VIDEO.Get the available input format descriptions for the given capture ID.AllVideoBBs.cmo Technical InformationIn: triggers the process.Loop In: triggers the next step in the process loop. Out: is activated when the process is completed.Loop Out: is activated when the process need to loop. Capture ID: the BB will retrieve the available input format forthe camera with this ID.Count: total number of formats available.ID: identifierfor this format.Name: video type used by this format (RGB, YUV, FOURCC.).Size: image with and height used by this format.Frequency:minimum and maximum frequency that is advisedfor this format. RemarksOnly devices with a WDM driver(most of todays cameras provide such a driver) will return a list of available formats. For olders drivers, the BB will directly return with a format count of -1 and you wont be able to change the input format. To modify the format used by a live video, use the Video Input Control BB. 设置视频输入格式在Video/Basic中将其分类描述适用于视频获取一个可用的输入格式来描述给定的记录的IDAllVideoBBs.cmo技术信息In：触发该进程Loop In：在进程循环中触发下一步Out：当进程完成时则被激活Loop Out：当进程需要循环时则被激活Capture ID：这个BB将为这个ID的摄影机重新取回可用的输入格式Count：可用的格式的总数ID：这个格式的识别号Name：使用这个格式的视频的类型（RGB，YUV，FOURCC）Size：使用这个格式里的图片的尺寸Frequency：对这个格式建议的最小值和最大值评论只有WDM驱动的设备（在现有的摄影机里都有提供这样的一个驱动）将返回一个可用格式的清单。对于老一点的驱动，这个BB将直接返回一个格式计算为-1，并且你不能改变他的输入格式来修改这个格式使用一个活的视频，使用Video Input Control BB.Video Input Control Version 1.00 - VirtoolsCategorized in Video/Controls DescriptionApply to a VIDEO.Modify a videos input controls (runtime parameters).AllVideoBBs.cmoTechnical InformationIn: activates the process.Out: is activated if In has finished.Error: is activated if the building block encounters an error,Error pOut giving a description ofwhat went wrong.Format ID:formatidentifier to use forthe live video input (see Remarks). Set to -1 to use the default format.Frequency : frequency to use for the live video input. Set to -1 to use the default frequency. Error: Output string that describes the error. 视频输入控制在Video/Controls中将其分类描述适用于视频修改一个视频的输入控制（运行时间参数）AllVideoBBs.cmo技术信息In：激活该进程Out：如果In已经结束，则被激活Error：如果BB遇到一个错误则被激活，错误的pOut给一个对错误的描述Format ID：对使用的视频输入进行识别（看评论）。设置-1来使用默认的格式Frequency：多次使用现有的视频输入。设置-1到使用的默认附属中Error：描述错误的输出字符串Remarks Those controls only apply to a live video. To get a list of the available Format ID and Frequency, use the Get Video Input Formats BB. To change the format, there are the following restriction : o When the video is unloaded, it is always possible toset anyof the supported format. o When the video is loaded, it has to be stopped to set a new input format. And switching from one format to another is not always possible (this depends on your camera drivers). For instance, it is often impossible to switch from a RGB format to a YUV format while the video is loaded. You should therefore test the capabilities of your camera if you need to forbid those impossible format changes or first unload your video. To change the frequency, the video can be either unloaded or loaded and stopped. To know what format is currently used by your live video, you can use the GetVideoInfo VSL method on your video object.评论这些控制只适用于一个活着的视频来获取一个可用的ID格式和附属的清单，使用一个Get Video Input Formats BB.来改变这个格式，那有一个紧跟着的约束：当视频没有被载入，他总是可能被设置任何支持的格式大部分视频被载入，他被设置了一个新的输入格式后停止。并且从一个格式转换到另一个格式不总是可能的（这取决于你的摄影机的驱动）。以这个例子，当视频被载入时，他总是把一个RGB格式转化成为一个YUV格式。如果你需要禁止这些不可能的格式，你应该测试你的摄影机的能力.为了改变附属，视频能够两者都被卸下或是载入都将被停止为了知道现有的格式，你能使用GetVideoInfo VSL办法在你的视频对象上Video Basic Control Version 1.00 - VirtoolsCategorized in Video/Controls DescriptionApply to a 3DENTITY.Modify a videos global controls (runtime options).AllVideoBBs.cmoTechnical InformationIn: activates the process.Out: is activated if In has finished.Error: is activated if the building block encounters an error,Error pOut giving a description ofwhat went wrong.Loop: Should the Video loop (between the specified start time and stop time)? Start Time : The point in the video where the video should begin.Stop time : The point in the video where the video should end. Leaving it at 0mn 0s 0ms means it will play until the end.Speed: Speed of the video Playback. 1 = normal speed.Gain: The volume of the audio between 0 (no volume) and 1 (max volume).Pan: Balance between the Left (-1) and right channel (1).Error: Output string that describes the error. Controls : Each checkbox allows you to remove the corresponding pIn above. 视频基本控制在Video/Controls中将其分类描述适用于3D实体修改一个视频的全局控制（运行时间选项）AllVideoBBs.cmo技术信息In：激活该进程Out：如果In被完成则被激活Error：如果BB遭遇一个错误，错误的pOut给了错误一个描述。Loop：视频应该是否被循环（在指定的起始时间和结束时间之间）Start Time：视频开始时的时间点Stop time：视频结束时的时间点.离开时在0分0秒0毫秒意味着他将播放直至结束Speed：视频录制的速度。1=一个平常的速度Gain：在0（无声音）和1（最大声音）之间Pan：在左（-1）和右边的通道（1）之间的平衡Error：描述错误的输出字符Controls：每个单选框允许你移动与pIn符合的RemarksThese features are highly depends on the compression format of the video. More precisely: Setting the Start Time and/or the Stop Time will fail if the videodoes not have seeking capabilities. You may use the Support Seeking parameter operation while the video is loaded to get this information. In particular, it is not supported by live videos. Setting the Speed will fail if the video does not support speed change and setting a negative speed will fail if it does not support negative speed. You may use the Support Speed Change and Support Negative Speed parameter operations while the video is loaded to get those information. In particular, it is not supported by live videos. Setting the Speed may also fail for certain values as compression formats support various speed ranges. Most compression formats support a speed factor between 0 and 2 (DivX, Indeo,.); but some will support none (wmv,.) ; others support higher speed rates. If getting this information is not possible, you must test it with your video to validate your speed value. Setting the Gain and the Balance will fail if the video has no sound or if the Enable Audio properties is deactivated. You may use the Is Audio Enabled and/or Has Audio parameter operations while the video is loaded to get those information. Also note that seeking and changing the speed of a video is not always smooth. This depends on the compression algorithm and the key rate usedfor the video compression. If you need a very smooth speed changing and/or seek, you will have to compress your video with many key framestofacilitate the video decompression at any time position.评论这些特点是取决于视频的压缩格式。更多的细节：设置开始时间/或是停止时间将失败如果视频没有找到他的能力。当视频载入并获得这个信息时，你可以使用Support Seeking参数进行运算。特别是，他不支持生动的视频如果视频不支持速度的改变，并设置了一个否定的速度，设置速度会将会失败。你可以使用Support Speed Change和 Support Negative Speed参数进行运算。当视频被载入并获得这些信息时。特别的，他不支持生动的视频设置一个速度也将失败。不部分压缩的格式支持一个速度因素在0和2之间（X层，Indeo. . .）但是一些将支持（wmv. . .）；另外的支持高速率。如果获得这个信息没有可能，你必须测试他同你的视频到可用的你的速度值设置赢利和平衡将会失败，如果视频没有声音或者是如果EnAble Audio被撤消。当视频被载入并获得这些信息时，你可以使用Audio Enabled 以及或是 Has Audio参数进行运算也要注意到寻找并改变这些视频的速度不是很顺利的。这取决于压缩程度和主要的比例。如果你需要一个非常快的速度来改变寻找，你就要压缩你的视频通过一些帧使视频的减压在任何时间Video Basic Properties Version 1.00 - VirtoolsCategorized in Video/Properties DescriptionApply to a VIDEO.Modify a videos global properties (static options).AllVideoBBs.cmoTechnical InformationIn: activates the process.Out: is activated if In has finished.Error: is activated if the building block encounters an error,Error pOut giving a description ofwhat went wrong.Input Type : This defines the video input type: Read from a file, live video feed or streamed content.Output Type: This defines where to display the video: on a texture or on the screen as overlay video.Enable Audio : If checked, the audio is played for videos with soundtrack or live videos. Error: Output string that describes the error. Input Type : This removes the pIn for Input Type. Output Type : This removes the pIn for Output Type.Enable Audio : This removes the pIn for Enable Audio. RemarksProperties can not be changed while the video is loaded; otherwise, the BB wil fail. Make sure to unload your video before activating this BB.视频基本属性在Video/Properties中将其分类描述适用于视频修改一个视频的全局属性（静态选项）AllVideoBBs.cmo技术信息In：激活该进程Out：如果In完成则被激活Error：如果BB遇到一个错误，则被激活，错误的pOut给了一个对错误的描述Input Type：这个视频输入接口被下定义Type：从文件里读取，依靠于流动的内容Output Type：输出口的类型Display the video：在一个纹理或是在一个屏幕上Enable Audio：如果被钩选，音频为视频被播放Error：描述错误的输出字符串Input Type：这个移除了输入类型的pIn接口Output Type：这个移除了输出类型的pIn接口Enable Audio：这个移除了音频能力的pIn评论当视频被载入时，属性不能够被改变；另外，这个BB将失败。确保在激活这个BB之前卸下你的视频Video Capture Version 1.00 - VirtoolsCategorized in Video/Basic DescriptionApply to a VIDEO.Capture the current image of a video. AllVideoBBs.cmoTechnical InformationIn: activates the process.Out: is activated if the building block is activated.Error: is activated if the building block encounters an error,Error pOut giving a description ofwhat went wrong.Target Texture : The target texture where the video appears.Error: Output string that describes the error. 视频截取在Video/Basic中将其分类描述适用于一段视频截取视频中的现有图片AllVideoBBs.cmo技术信息In：激活该进程Out：当BB被激活时则被激活Error：如果BB发生了一个错误则被激活，错误pOut对错误进行了描述Target Texture：视频出现的目标纹理Error：描述错误的输出字符串Video Input Properties Version 1.00 - VirtoolsCategorized in Video/Properties DescriptionApply to a VIDEO.Modify a videos input properties (static options).AllVideoBBs.cmoTechnical InformationIn: activates the process.Out: is activated if In has finished.Error: is activated if the building block encounters an error,Error pOut giving a description ofwhat went wrong.IMPORTANT: pIns will be determined by the Input Type settings! Input Type: This defines the video input in the CMO: Read from a file, live video feed or streamed content. Each Type has a specific list of options to be defined. 视频输入属性在Video/Properties中将其分类描述适用于视频修改一个视频的输入属性（静态选项）AllVideoBBs.cmo技术信息In：激活该进程Out：当In被完成时则被激活Error：如果BB有一个错误，则被激活，错误pOut对错误进行了描述IMPORTANT：pIns将被输入类型设置被决定Input Type：在一个CMO文件中给视频输入接口下定义：从一个文件中读取现有的视频或是一个数据流。每种类型有一个指定的定义的选项清单 Input Type: File: The video is read from a file on the local or network hard drive. Target Video : The name of the video object. File: Path to the video file to be read. Paths can be either absolute, relativeor a filename. In this last case, the video directory must be added to the Path Manager in the Bitmap Path Category. Input Type: Live: The video is being fed by a live video source (camera, web cam, etc.) Target Video : The name of the video object.VideoID: The video source to use. The camera must be plugged in and operational. A pulldown list - listing available sources - appears when selecting the right hand button. When the composition is saved and reloaded, the camera with the same name is selected; if it is not found, the first available one is used. AudioID: The audio source to use. The microphone must be plugged in and operational. A pulldown list - listing available sources - appears when selecting the right hand button. When the composition is saved and reloaded, the microphone with the same name is selected; if it is not found, the first available one is used. 输入类型：文件：从一个文件中读取视频在本地或者一个网络驱动 Target Video：视频对象的名称 File：被读取的视频文件的路径。路径可能为绝对路径，相对路径或是一个文件名。在最后的事件中，视频指南必须被添加到路径管理器中在一个位图路径中。Input Type：Live：视频被放在一个活的视频资源中（摄影机，网络等等）Target Video：视频对象的名称VideoID：被使用的视频资源。摄影机必须被接通电源并且被运算一个下拉菜单-可用的资源列表-当选择右边手的按钮时就出现。当项目被保存后再载入时，有相同名字的摄影机被选择；如果没有被找到，第一个可用被使用AudioID：被使用的音频资源。麦克风必须插上电源并操作。一个下拉菜单-可见资源列表 当选择右边手的按钮时就出现。当项目被保存后再载入时，有相同名字的摄影机被选择；如果没有被找到，第一个可用被使用 Input Type: Stream: The video is being streamed from a URL address. Target Video : The name of the video object.Url: The absolute URL of the video that is to be streamed. Path must be formatted as Protocol:/., for instance, it can be file:/.,http:/. or mms:/. Error: Output string that describes the error. Live Properties / VideoID: This removes the pIn for VideoID. RemarksProperties can not be changed while the video is loaded. Otherwise, the BB will fail, so make sure to unload your video before activating this BB. Video and audio source lists are populated at the application start up. These sources must therefore be plugged in before the start of the application. VERY IMPORTANT: By default, no video engine is downloaded by the Virtools Web player. You must add the Dx8 Video Dependency BB (and optionally the Dx9 Video Dependency BB) to your composition to ensurethe Dx8 (or Dx9) Video Engine is downloadedbythe users Virtools 3D Life Player. If DirectX 8 or 9 is installed, video playback will be available for your composition with the Dx8 (or Dx9) Video Engine. Input Type：Stream：视频被从一个URL地址上下载Target Video：视频对象的名称 Url：被分组的视频的绝对路径。路径必须被设置为以下格式：Protocol:/., 举个例子, 他能够为： file:/.,http:/. or mms:/. Error：输出字符穿描述了一个错误Live Properties/VideoID：这个移动了VideoID的pIn评论当视频被载入时属性不能够发生变化。另外，BB会失败，请确保在激活该BB之前卸下你的视频视频和音频资源清单都在应用程序开始中。这些资源必须在应用程序开始之前被接通电源。很重要：通过默认值，没有视频引擎通过Virtools 网络播放器被下载。你必须添加一个Dx8 Video Dependency BB（或者是Dx9 Video Dependency BB)到你的项目中，确保DX8（或是DX9）视频引擎被下载通过用户的Virtools 3D播放器。如果DX8或DX9被安装，视频录制将对于你的项目是可用的Video Loader Version 1.00 - VirtoolsCategorized in Video/Basic DescriptionApply to a VIDEO.Expose Loading Control on a video.AllVideoBBs.cmoTechnical InformationLoad: activates the process.Unload: activates the process. Loaded: is activated when Load has finished.Unloaded: is activatedwhen Unload has finished.Error: is activated if the building block encounters an error,Error pOut giving a description ofwhat went wrong.State: Current video state (Loading, Playing, Paused, Stopped, Unloading, Unloaded).Error: Output string that describes the error. RemarksYou dont necesserely need to use the Video Loader BB, you may directly use the Video Player BB that handles loading and unloading of the video. But as loading a video may be long, you can use this BB to load your video in advance,avoiding a delay when playing the video, and unload it once youve finished using it. If you use the Video Loader BB for a manual control of the loading, make sure to uncheck the Manage Load / Unload setting of the Virtools Player BB you use with this video. 载入视频在Video/Basic中将其分类描述适用于视频控制一个视频的载入AllVideoBBs.cmo技术信息Load：激活该进程Unload：激活该进程Loaded：当Load完成时则被激活Unloaded：当Unload完成时则被激活Error：如果BB遇到一个错误则被激活，错误的pOut对错误做了描述State：现有的视频的状态（载入，播放，暂停，停止，没有被载入）Error：描述错误的输出字符串评论你不能成功的使用Video Loa