PowerPoint 是用 96 DPI (Pixel Per Inch) 來定義尺寸寬度。 PowerPoint uses 96 DPI (Pixels Per Inch) to define dimensions.
當我們的顯示器為 10.1” 1280x800 Pixel 時，對應的設定如下： For a 10.1" 1280x800 Pixel display, the settings are:
👉 設計版面設定： 寬度 33.86 公分，高度 21.16 公分。
Slide Size Setting: Width 33.86 cm, Height 21.16 cm.
使用 PowerPoint 中的動作設定來進行頁面切換： Use PowerPoint's Action settings for page transitions:
選擇物件 ➔ 插入 ➔ 動作 ➔ 選擇「跳到投影片xxx」。 Select Object ➔ Insert ➔ Action ➔ Hyperlink to Slide...
利用 PowerPoint 內建的切換功能製作動態轉場： Use PowerPoint's built-in transitions:
選擇上方選單 「切換」 ➔ 選擇 「推入」 或 「擦去」 ➔ 設定「效果選項」(上下左右) ➔ 設定「期間」/ 過場時間單位(秒/10)。 Go to Transitions ➔ Select Push or Wipe ➔ Set Effect Options (Direction) ➔ Set Duration.
👉 請點擊上方導覽列，查詢並複製各項 UI 元件的 Alt Text 設計語法！ Click the navigation bar above to view and copy the Alt Text syntax for each UI component!
請將全域的系統參數寫在 PowerPoint 第一頁投影片的「備忘錄」(Notes) 區域中。 Please write the global system parameters in the "Notes" pane of the FIRST slide in PowerPoint.
固定寫法：[CAN_BPS=數值]。
若未填寫或填寫無效數值，系統預設為 500000。系統支援以下傳輸速率：
Format: [CAN_BPS=value].
If omitted or invalid, the default is 500000. Supported baud rates:
固定寫法：[DEFAULT_BRIGHTNESS=數值]。
用戶可設定範圍為 5 (最暗) 到 100 (最亮)。
Format: [DEFAULT_BRIGHTNESS=value].
User can set range from 5 (darkest) to 100 (brightest).
[CAN_BPS=500000] [DEFAULT_BRIGHTNESS=100]
▲ 將參數設定寫在第一張投影片下方的備忘錄中 ▲ Write settings in the Notes pane under Slide 1
| Parameter | 說明Description | Example |
|---|---|---|
| Mul / Add |
(Option) Math : Display = (Raw x Mul) + Add。 如果是用 DBC 通常不用寫。如需調整換算用此方式換算。 (Option) Math: Display = (Raw x Mul) + Add. Usually not needed with DBC. Use for custom calculations. |
Mul=0.5, Add=16 |
| Suffix |
(Option) Unit : 顯示在數值後的文字。 如果 DBC 單位不是你要的 (例如 degC)，可用此覆寫。 (Option) Unit: Text appended after the value. Overrides DBC unit if needed (e.g., degC to ℃). |
Suffix=℃ |
@Text, Tag=DBC_Group_Pressure, Mul=0.1, Suffix=bar| Parameter | 說明Description | Example |
|---|---|---|
| Rules |
{ Range : Text : Color | ... } 以 | 分隔。Color 可用 HEX (#0b03fc) 或 RGB (11, 3, 252)
{ Range : Text : Color | ... } separated by |. Color accepts HEX or RGB.
|
0-0: OFF : #0b03fc |
@Text, Tag=DBC_Machine_State,
Rules={
0-0: OFF : #0b03fc |
1-1: Heating : #fc4903 |
2-2: Ready : #03fc77 |
3-3: Brewing : #942c03 |
4-4: Steam_Mode : #f0f3f7
}| Parameter | 說明Description | Example |
|---|---|---|
| ColorRules |
{ Range:Color | ... } 以 | 分隔。Color 支援 HEX 或 RGB
{ Range:Color | ... } separated by |. Supports HEX or RGB.
|
0-50:0,255,0 |
@Text, Tag=DBC_FreshWater, Mul=1.0, Add=0, Suffix= % ,ColorRules={0-50:0,255,0 | 51-80:255,255,0 | 81-100:255,0,0}| Parameter | 說明Description | Example |
|---|---|---|
| Max | 最大值。一般由 DBC 取得。若沒寫預設為 100。Maximum value. Usually from DBC. Defaults to 100. | Max=200 |
| Min | 最小值。一般由 DBC 取得。若沒寫預設為 0。Minimum value. Usually from DBC. Defaults to 0. | Min=0 |
@ProgressBar, Tag=DBC_Group_Pressure, Min=0, Max=200, Factor=1| Parameter | 說明Description | Example |
|---|---|---|
| Max | 最大值。Maximum value. | Max=1050 |
| Min | 最小值。Minimum value. | Min=800 |
@TrackBar, Tag=DBCTX_Target_Temp, Min=800, Max=1050, Factor=1| Parameter | 說明Description | Example |
|---|---|---|
| Def |
0: Toggle OFF 或 1: Toggle ON。沒有寫預設是 0 (OFF)。 0: Toggle OFF or 1: Toggle ON.Defaults to 0 (OFF). |
Def=0 |
@Toggle, Tag=DBC_Brew_Switch, GenTx=1, Min=0, Max=2, Factor=1, Def=0| Parameter | 說明Description | Example |
|---|---|---|
| Def | 指針初始位置。沒寫預設為 0。Initial position. Defaults to 0. | Def=0 |
| Max | 指針的最大值。一般由 DBC 取得。Maximum value. Usually from DBC. | Max=1300 |
| Min | 指針的最小值。一般由 DBC 取得。Minimum value. Usually from DBC. | Min=0 |
| StartAngle | UI Meter 底圖指針 起始角度。Starting angle. | StartAngle=-135 |
| EndAngle | UI Meter 底圖指針 終點角度。Ending angle. | EndAngle=135 |
@Meter, Tag=DBC_Boiler_Act_Temp, Factor=1, Min=0, Max=1300, StartAngle=-135, EndAngle=135, Def=0| Parameter | 說明Description | Example |
|---|---|---|
| RotateAngle |
指定 0% 開始的角度 (預設為 0度)。 例如 -90 表示從 12 點鐘方向開始。 Sets the angle for 0% (Default is 0°). e.g., -90 means starting from 12 o'clock. |
RotateAngle=-90 |
@CircleMask, Tag=DBC_Group_Pressure, Min=0, Max=200, Factor=1, RotateAngle=-90| Parameter | 說明Description | Example |
|---|---|---|
| TagDef | 預設初始值。若沒寫預設為0。Default initial value. Defaults to 0. | TagDef=100 |
| Inc | 按下時變大特效。30表示變大30%。Enlarge effect when pressed. 30 means 30% larger. | Inc=30 |
| Frame | 動畫影格數 (60Hz下 30 Frame = 0.5秒)。Animation frames (30 frames = 0.5s at 60Hz). | Frame=30 |
| TagInc | 每次按下去的變化量 (例如 +5 或 -5)。Increment step (e.g., +5 or -5). | TagInc=-5 |
@PopupBtn, Tag=BTN_Pre_Infusion_Time_Minus, Target=DBCTX_Pre_Infusion_Time, TagInc=-5, TagDef=100, Inc=30, Frame=30@PopupBtn, Tag=BTN_Pre_Infusion_Time_Plus, Target=DBCTX_Pre_Infusion_Time, TagInc=5, TagDef=100, Inc=30, Frame=30
在 PPT 上用文字寫上 YYYY-MM-DD 或 HH:mm:ss，然後加入 Alt Text：
Type YYYY-MM-DD or HH:mm:ss in a PPT text box, then apply Alt Text:
@DigitalClock, Format=Date
@DigitalClock, Format=Time, Def=24H
VAR_Edit_Year) 是系統內建特殊變數，絕對不能拼錯！
The Tags below (e.g., VAR_Edit_Year) are built-in variables. Do NOT misspell them!
| 功能Function | 文字顯示 (Text)Text Display | 增加按鈕 (+) PopupBtnPlus Button (+) | 減少按鈕 (-) PopupBtnMinus Button (-) |
|---|---|---|---|
| 年 (YYYY)Year (YYYY) | @Text, Tag=VAR_Edit_Year, Def=2026 |
@PopupBtn, Tag=VAR_Edit_Year_Plus, Target=VAR_Edit_Year, TagDef=2026, TagMax=2300, TagMin=1990, TagInc=1, Inc=30, Frame=5 |
@PopupBtn, Tag=VAR_Edit_Year_Minus, Target=VAR_Edit_Year, TagDef=2026, TagMax=2300, TagMin=1990, TagInc=-1, Inc=30, Frame=5 |
| 月 (MM)Month (MM) | @Text, Tag=VAR_Edit_Month, Def=6 |
@PopupBtn, Tag=VAR_Edit_Month_Plus, Target=VAR_Edit_Month, TagDef=6, TagMax=12, TagMin=1, TagInc=1, Inc=30, Frame=5 |
@PopupBtn, Tag=VAR_Edit_Month_Minus, Target=VAR_Edit_Month, TagDef=6, TagMax=12, TagMin=1, TagInc=-1, Inc=30, Frame=5 |
| 日 (DD)Day (DD) | @Text, Tag=VAR_Edit_Day, Def=15 |
@PopupBtn, Tag=VAR_Edit_Day_Plus, Target=VAR_Edit_Day, TagDef=15, TagMax=31, TagMin=1, TagInc=1, Inc=30, Frame=5 |
@PopupBtn, Tag=VAR_Edit_Day_Minus, Target=VAR_Edit_Day, TagDef=15, TagMax=31, TagMin=1, TagInc=-1, Inc=30, Frame=5 |
| 時 (HH)Hour (HH) | @Text, Tag=VAR_Edit_Hour, Def=12 |
@PopupBtn, Tag=VAR_Edit_Hour_Plus, Target=VAR_Edit_Hour, TagDef=12, TagMax=23, TagMin=0, TagInc=1, Frame=24, Inc=30, Frame=5 |
@PopupBtn, Tag=VAR_Edit_Hour_Minus, Target=VAR_Edit_Hour, TagDef=12, TagMax=23, TagMin=0, TagInc=-1, Frame=24, Inc=30, Frame=5 |
| 分 (mm)Minute (mm) | @Text, Tag=VAR_Edit_Min, Def=30 |
@PopupBtn, Tag=VAR_Edit_Min_Plus, Target=VAR_Edit_Min, TagDef=30, TagMax=59, TagMin=0, TagInc=1, Inc=30, Frame=5 |
@PopupBtn, Tag=VAR_Edit_Min_Minus, Target=VAR_Edit_Min, TagDef=30, TagMax=59, TagMin=0, TagInc=-1, Inc=30, Frame=5 |
當系統中有一個設定總時間的變數（例如：Tag=DBCTX_Set_Duration 為總分鐘數），如果要將其拆分成「小時」與「分鐘」兩個獨立的文字方塊來顯示時，就需要使用 Algo 參數進行數學換算。
When the system has a total time variable (e.g., total minutes), and you need to split it into "Hours" and "Minutes" in separate text boxes, use the Algo parameter.
| Parameter | 說明Description | Example |
|---|---|---|
| Algo=Div | 取商數 (Division)。用來計算小時 (除以60)。 Division quotient. Used for calculating hours (divided by 60). | Algo=Div, Param=60 |
| Algo=Mod | 取餘數 (Modulo)。用來計算分鐘 (除以60的餘數)。 Modulo remainder. Used for calculating minutes (remainder of 60). | Algo=Mod, Param=60 |
@Text, Tag=DBCTX_Set_Duration, Algo=Div, Param=60, Min=00, Max=24, Def=00@Text, Tag=DBCTX_Set_Duration, Algo=Mod, Param=60, Min=00, Max=59, Def=00@Text, Tag=VAR_CAN_LOG_TX
@Text, Tag=VAR_CAN_LOG_RX
VAR_Backlight。
Use a TrackBar to control screen brightness, bound to the internal system variable VAR_Backlight.
@TrackBar, Tag=VAR_Backlight, Min=5, Max=100, Def=100
Src: 影片檔案路徑 (必填，後續固定使用 D:/，例如 D:/video.mp4)。Src: Video file path (Required, fix to D:/, e.g., D:/video.mp4).Visible: 0 為隱藏，1 為顯示。Visible: 0 for hidden, 1 for visible.Playing: 1 表示載入後自動播放。Playing: 1 means auto-play on load.repeat: 1 表示無限循環重複播放。repeat: 1 means infinite loop playback.@Video, Tag=Video_Play_SW, Src=D:/AMPIRE_V3.mp4, Visible=0
@Video, Tag=Video_Play_SW, Src=D:/AMPIRE_V3.mp4, Visible=1, Playing=1, repeat=1
067 而顯示 67，請加入第 11 張「相同大小的空白透明圖」。Hide Leading Zero (Optional): To hide leading zeros, add an 11th "blank transparent image".@SpriteSource, Name=DigiFont_RedGroup and place off-slide, set Alt Text:@SpriteSource, Name=DigiFont_Red30000.002 (已達 8 位有效數字)，在二進位中無法精確表示，會變成最接近的近似值 30000.001953125...。不同設備底層運算差異必然會導致最後一位小數浮動，請理解此技術限制。
⚠️ Float Precision Limits:30000.002 cannot be exactly represented in binary and becomes approximately 30000.001953125.... Slight variations between different devices' processing architectures are entirely normal.
| Parameter | 說明Description | Example |
|---|---|---|
| algo | 指定為 digital (整數提取)。Set to digital (integer extraction). |
algo=digital |
| param |
位數：10000(萬), 1000(千), 100(百), 10(十), 1(個)
Digit place: 10000(10Ks), 1000(Ks), 100(Hundreds), 10(Tens), 1(Ones)
|
param=10000 |
萬位數 (param=10000)：Ten-Thousands Place (param=10000):
@Sprite, Tag=MB_Net_Weight, Min=-9999, Max=99999, Factor=1, Source=DigiFont_Red, algo=digital, Param=10000
千位數 (param=1000)：Thousands Place (param=1000):
@Sprite, Tag=MB_Net_Weight, Min=-9999, Max=99999, Factor=1, Source=DigiFont_Red, algo=digital, Param=1000
百位數 (param=100)：Hundreds Place (param=100):
@Sprite, Tag=MB_Net_Weight, Min=-9999, Max=99999, Factor=1, Source=DigiFont_Red, algo=digital, Param=100
十位數 (param=10)：Tens Place (param=10):
@Sprite, Tag=MB_Net_Weight, Min=-9999, Max=99999, Factor=1, Source=DigiFont_Red, algo=digital, Param=10
個位數 (param=1)：Ones Place (param=1):
@Sprite, Tag=MB_Net_Weight, Min=-9999, Max=99999, Factor=1, Source=DigiFont_Red, algo=digital, Param=1
| Parameter | 說明Description | Example |
|---|---|---|
| algo | 指定為 digital_float (浮點數提取，需 12 張圖)。Set to digital_float (requires 12 images). |
algo=digital_float |
| param |
小數點後為 0.1(小數後1位), 0.01(小數後2位), 0.001(小數後3位)
Float multiplier:0.1 (1st dec), 0.01 (2nd dec), 0.001 (3rd dec)
|
param=0.1 |
小數後 1 位 (param=0.1)：1st Decimal Place (param=0.1):
@Sprite, Tag=MB_Net_Weight, Min=-9999, Max=99999, Factor=1, Source=DigiFont_Red, algo=digital_float, Param=0.1
小數後 2 位 (param=0.01)：2nd Decimal Place (param=0.01):
@Sprite, Tag=MB_Net_Weight, Min=-9999, Max=99999, Factor=1, Source=DigiFont_Red, algo=digital_float, Param=0.01
小數後 3 位 (param=0.001)：3rd Decimal Place (param=0.001):
@Sprite, Tag=MB_Net_Weight, Min=-9999, Max=99999, Factor=1, Source=DigiFont_Red, algo=digital_float, Param=0.001
由多張獨立圖片 (含空白與負號) 拼成的浮點數值 Float value composed of separate images (including minus sign)
應用場景：多個開關但只有單選 (如：空調風量 High / Med / Low)。 Use Case: Multiple switches but single selection (e.g., Fan Speed High/Med/Low).
Group 讓系統知道它們是同一組互斥按鈕。
Manually set the Group parameter to group mutually exclusive buttons.
| Parameter | 說明Description | Example |
|---|---|---|
| Group | 群組名稱，同名稱的 Radio 會互斥 (單選)。 Group name. Radio buttons sharing this name are mutually exclusive. | Group=Fan_Speed_Level |
| Value | 此按鈕代表的數值。 The value this button represents. | Value=3 |
| Inc | 點擊時的放大特效 (-20 表示變小20%)。 Zoom effect on click (-20 means shrink 20%). | Inc=-20 |
| Frame | 特效動畫長度。 Animation duration in frames. | Frame=15 |
選項 High (Value=3)：Option High (Value=3):
@PopupRadio, Group=Fan_Speed_Level, Tag=DBCTX_Fan_Speed_Level, Value=3, Inc=-20, Frame=15
選項 Med (Value=2)：Option Med (Value=2):
@PopupRadio, Group=Fan_Speed_Level, Tag=DBCTX_Fan_Speed_Level, Value=2, Inc=-20, Frame=15
選項 Low (Value=1)：Option Low (Value=1):
@PopupRadio, Group=Fan_Speed_Level, Tag=DBCTX_Fan_Speed_Level, Value=1, Inc=-20, Frame=15
TimerMode=Bounce : 呼吸燈模式 (最小遞增到最大，再遞減到最小)。TimerMode=Bounce : Breathing light mode (increments to max, then decrements to min).TimerMode=Loop : 循環模式 (最小遞增到最大，然後重置)。TimerMode=Loop : Loop mode (increments to max, then resets to min).| Parameter | 說明Description |
|---|---|
| TimerInterval | 單位毫秒 (ms)。Unit in milliseconds (ms). |
| TimerStep | 每次變化的增量。Increment step value. |
| TimerMin | 起始最小值。Starting minimum value. |
| TimerMax | 起始最大值。Starting maximum value. |
| TimerPriority | 優先等級。當有多個按鈕改變相同變數時會有優先等級的問題。數值越高，優先等級越高。Priority level. Used when multiple buttons alter the same variable. Higher value = higher priority. |
| TimerControl_Tag | 此 Timer 在系統中的變數名稱 (用來控制開/關)。The variable name controlling this Timer (used to toggle ON/OFF). |
| TimerOutput_Tag | 要改變的目標系統變數名稱。The target system variable name to be modified by the Timer. |
@Toggle, Tag=VAR_BL_Timer, Def=0
@PopupRadio, Group=Light_Scene, Tag=VAR_Movie_SW, Value=1, Inc=-20, Frame=15, Def=0, TimerInterval=100, TimerMode=Bounce, TimerStep=1, TimerMin=30, TimerMax=30, TimerPriority=110, TimerControl_Tag=VAR_BL_Timer, TimerOutput_Tag=VAR_Backlight
@PopupRadio, Group=Light_Scene, Tag=VAR_READ_SW, Value=3, Inc=-20, Frame=15, Def=0, TimerInterval=100, TimerMode=Bounce, TimerStep=1, TimerMin=90, TimerMax=90, TimerPriority=120, TimerControl_Tag=VAR_BL_Timer, TimerOutput_Tag=VAR_Backlight
@PopupRadio, Group=Light_Scene, Tag=VAR_Party_SW, Value=2, Inc=-20, Frame=15, Def=0, TimerInterval=50, TimerMode=Bounce, TimerStep=1, TimerMin=5, TimerMax=100, TimerPriority=100, TimerControl_Tag=VAR_BL_Timer, TimerOutput_Tag=VAR_Backlight
Tab Container 是一個核心架構功能，能讓 UI 設計師在單一螢幕的固定視窗範圍內，實現複雜的多頁面導航。透過設定 @CONTAINER_PLACEHOLDER 與 @CONTAINER_PAGE，系統可以自動替換內容並加上專業的動態過場特效——完全不需寫任何程式碼。
The Tab Container is a core architectural feature that enables complex multi-page navigation within a fixed viewport on a single screen. By utilizing the @CONTAINER_PLACEHOLDER and @CONTAINER_PAGE tags, the system dynamically swaps content slides with professional transition effects—all without writing embedded code.
定義視窗範圍： 在主頁面 (Page 1) 建立一個矩形作為切換區的「舞台」。
準備子頁面內容： 準備其他要切換進來的內容頁 (Page 2, 3...)。提示：請直接複製主頁面，以確保內容所在的 X/Y 座標完全一致對齊！
Define Viewport: Create a primary slide and use a Rectangle to define the switching area (the "Stage").
Prepare Content: Prepare subsequent slides. Pro Tip: Copy Page 1 to ensure the content containers are in the exact same X/Y position.
選取主頁面的邊界矩形，使用 PPT Add-in 點擊 "Set Placeholder (Main Page)"。系統會賦予一個唯一的 ID。 Select the boundary rectangle on Page 1. Click "Set Placeholder (Main Page)" in the Add-in. It receives a unique ID.
@CONTAINER_PLACEHOLDER, ID=MainContentArea
在子頁面選取剛剛定義好範圍的物件，點擊 "Set Tab Page (Sub-page)"。在此您可以設定一個目標名稱 (TargetID) 以及進場/退場的特效。 On sub-slides, select the boundary object and click "Set Tab Page (Sub-page)". Here you define a TargetID and select transition effects.
@CONTAINER_PAGE, TargetID=Tab1_Layer, ShowEffect=ScrollRight, HidingEffect=ScrollRight
最後，選取主頁面上的選單按鈕，利用 Add-in 的 "Bind to Selected Tab" 工具，將按鈕與剛才設定好的子頁面 (TargetContainer) 連接起來。 Finally, select a menu button on Page 1. Use the "Bind to Selected Tab" tool to link the button to the TargetID you defined.
@PopupRadio, Group=TabMenu, Value=1, TargetContainer=Tab1_Layer
| 分類Category | 關鍵字參數 (Keywords)Keywords | 說明Description |
|---|---|---|
| Basic | None, Fade, Scale |
無、淡入淡出、縮放Standard visibility and scaling transitions. |
| Scrolling | ScrollLeft, ScrollUp, ScrollRight, ScrollDown |
內容從指定方向滑入/滑出Content slides in/out from specified direction. |
| Wiping | WipeLeft, WipeUp, WipeRight, WipeDown |
內容漸進式擦除顯示Progressive unveiling of the content. |
| Hybrid | ScrollRightWithFade, ScaleWithFade |
結合位移與不透明度的混合變化Combines movement with opacity changes. |
這是一個進階的輪播容器元件。讓多個子元件 (按鈕、圖片) 以水平或垂直方式並排顯示，支援手勢滑動 (Swipe) 切換。系統會自動計算中心放大與兩側縮小的數學特效與 Z-Order，無需撰寫程式碼。 An advanced container widget featuring premium dynamic transition effects. Displays multiple child components side-by-side with swipe gesture support. Automatically handles math calculations for center magnification and side scaling.
在投影片的非顯示區域 (外側灰色工作區)，準備好所有要輪播的子元件 (例如 7 個咖啡種類按鈕)。
提示：為了確保最佳的視覺縮放，請確定所有子元件的長寬比例完全一致。
Prepare all child components to be animated in the non-display area (gray workspace).
Pro Tip: Ensure all child components have perfectly identical dimensions/aspect ratios.
選取灰色工作區中的「其中一個」子元件，開啟 Add-in 面板，點擊 SCF_H (水平輪播) 或 SCF_V (垂直輪播)。
系統會在畫面上自動生成一個 紅色虛線框 (顯示範圍) 與一個 綠色虛線框 (來源框)。
Select exactly "one" child component, open Add-in, click SCF_H (Horizontal) or SCF_V (Vertical).
The system generates a Red Frame (Viewport) and a Green Frame (Source).
紅框限制：將紅框移至 UI 正確顯示位置。若為水平輪播 (SCF_H)，請勿調整紅框高度 (將對齊上邊緣)。若為垂直 (SCF_V)，請勿調整紅框寬度 (將對齊左邊緣)。 Red Frame Constraints: Move to desired layout position. For SCF_H, do NOT adjust height. For SCF_V, do NOT adjust width.
您可以在紅框的 Alt Text 中手動加入以下參數來微調物理特效： Manually append these parameters to the Red Frame's Alt Text to fine-tune physics:
| Parameter | 說明Description | Example |
|---|---|---|
| Factor | (預設:50) 控制兩側物件縮小的比例與拖曳阻力。(Default:50) Controls spatial scaling ratio and movement dampening. | Factor=65 |
| TotalFrame | (預設:10) 滑動轉場的動畫影格數。數值越大越流暢，越小越即時。(Default:10) Animation frames for transition. Higher = smoother, Lower = snappier. | TotalFrame=12 |
@ScaleCoverFlow, ID=CF_MAIN, ShowBackground=False, Factor=65, TotalFrame=12提供自動計算位移、物理內插的動畫容器。設計師只需定義「起點」與「終點」的狀態與位置，系統就會自動運算平滑的線性平移 (Translation) 轉場效果（注意：實際效果為水平/垂直平移，並不會發生旋轉或滾動）。 A container handling complex math/physics for UI transitions. Define "Start" and "End" positions/states, and the system automatically calculates smooth linear translation displacement (Note: it translates linearly without any rolling or rotation).
在 PPT 中準備兩組物件集合 (可包含多個 Widget)：左邊為起始狀態，右邊為複製過去並修改外觀的終點狀態。 Prepare two object collections: Left is the Starting State, Right is the duplicated and modified Destination State.
右鍵點擊起始狀態群組，在 Add-in 面板點擊 "ANIM"，設定以下參數： Right-click the starting collection, click "ANIM" in Add-in, and configure:
| Parameter | 說明Description |
|---|---|
| TotalFrame | 動畫總影格數 (預設:30)。決定動畫長短與平滑度。Total frames (Default: 30). Determines duration/smoothness. |
| MoveType | 移動物理特性 (Linear / EaseIn / EaseOut)。Movement physics (Linear / EaseIn / EaseOut). |
| Playing | (True / False) 是否在載入時自動播放。Auto-play on load (True / False). |
| Repeat / Cycling | 是否重複播放 / 循環播放。Repeat playback / Continuous looping. |
@AnimSourceStart@AnimSourceEnd@AnimPosStart@AnimPosEnd