影片
“Video（影片）”是能夠以AVI格式播放JPEG影片的小工具。
在模擬器中運行的“Video（影片）”
Note
不支援音訊，
小工具組
影片位於TouchGFX Designer中的Miscellaneous小工具組中。
TouchGFX Designer中的“Video（影片）”
Tip
使用TouchGFX Generator以影片解碼功能設定HAL，以便在目標播放影片。
屬性
TouchGFX Designer中影片的屬性。
| 屬性組 | 属性说明 |
|---|---|
| 名稱 | 小工具的名稱。 Name是TouchGFX Designer和程式碼中使用的唯一識別碼。 |
| 位置 | X 和Y 指定小工具左上角相對于其父的位置。 W 和 H 指定小工具的寬度和高度。 鎖定指定小工具是否應鎖定為其當前的X、Y、W和H。 如果鎖定小工具，還會禁止通過螢幕與小工具進行交互。 可見 指定小工具的可見性。 使小工具不可見還將禁用與小工具之間通過螢幕進行的交互。 |
| 範例 | Sample指定小工具的範例影片。 這些範例免費使用。 |
| 影片 | Video指定小工具應該使用的影片。 Auto Play指定進入螢幕時是否自動播放影片。 Loop指定影片是否應該重複撥放。 |
| Mixin | 可拖動 指定在運行時小工具是否可拖動。 ClickListener 指定小工具被點擊時是否會呼叫callback函數。 MoveAnimator 指定小工具是否可繪製 X 和 Y 值變化的動畫。 |
交互
TouchGFX Designer中的影片支援的操作和觸發條件。
操作
| 小工具特有的操作 | 說明 |
|---|---|
| Play | 播放影片 |
| Pause | 暫停影片播放 |
| Stop | 停止影片播放 |
| 標準小工具操作 | 說明 |
|---|---|
| 移動小工具 | 隨時間的推移將小工具移動到新位置。 |
| 隱藏小工具 | 隱藏小工具（將可見性設置為false）。 |
| 顯示小工具 | 使隱藏的小工具可見（將可見性設置為true）。 |
觸發條件
| 觸發條件 | 說明 |
|---|---|
| 影片已結束 | 影片小工具結束了影片播放。 |
性能
影片小工具是一種密集型元件。 因此，在大部分平臺上，會將影片視為要求高的小工具。
關於繪製性能的更多細節，請閱讀‘通用UI元件性能’章節或‘MJPEG影片’文章。
範例
生成程式碼
在生成的視圖基類的程式碼中，可以查看Designer是如何創建影片的。
Screen1ViewBase.cpp
#include <gui_generated/main_screen/mainViewBase.hpp>
#include <videos/VideoDatabase.hpp>
mainViewBase::mainViewBase()
{
video.setPosition(0, 0, 480, 272);
video.setRepeat(true);
video.setVideoData(video_SampleVideo1_480x272_bin_start, video_SampleVideo1_480x272_bin_length);
video.play();
add(video);
}
TouchGFX Designer範例
如需進一步瞭解影片，請嘗試在TouchGFX Designer中使用下列UI範本之一創建新應用：
TouchGFX Designer中的影片範例UI範本