120 lines
2.0 KiB
TypeScript
120 lines
2.0 KiB
TypeScript
|
/**
|
|||
|
|
* 鏡頭語言系統類型定義
|
|||
|
|
*
|
|||
|
|
* 此結構為 AI 知識層，前端不硬編、不限制
|
|||
|
|
* 僅結構化呈現 AI 的選擇結果
|
|||
|
|
*
|
|||
|
|
* 設計為可擴充：透過 Record<string, unknown> 允許動態欄位
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 基礎鏡頭語言結構
|
|||
|
|
* 包含核心欄位與可擴充的額外欄位
|
|||
|
|
*/
|
|||
|
|
export interface CameraLanguage {
|
|||
|
|
/**
|
|||
|
|
* 鏡頭與景別（Shot Size & Lens）
|
|||
|
|
* 例如：Extreme Long Shot (XLS), Long Shot (LS), Medium Shot (MS),
|
|||
|
|
* Close-Up (CU), Extreme Close-Up (ECU), Over-the-Shoulder (OTS), POV
|
|||
|
|
*/
|
|||
|
|
shot: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 運鏡（Camera Movement）
|
|||
|
|
* 例如：Pan, Tilt, Dolly In/Out, Truck, Crane, Handheld, Dolly Zoom
|
|||
|
|
*/
|
|||
|
|
movement: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 構圖（Composition）
|
|||
|
|
* 例如：Rule of Thirds, Leading Lines, Depth of Field, Dutch Angle,
|
|||
|
|
* Headroom, 180-degree Rule
|
|||
|
|
*/
|
|||
|
|
composition: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 光線（Lighting）
|
|||
|
|
* 例如：Three-Point Lighting, High Key, Low Key, Hard Light, Soft Light
|
|||
|
|
*/
|
|||
|
|
lighting: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 描述（Description）
|
|||
|
|
* 鏡頭的詳細描述或說明
|
|||
|
|
*/
|
|||
|
|
description: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 可擴充欄位
|
|||
|
|
* 允許 AI 或使用者動態添加額外的鏡頭語言資訊
|
|||
|
|
* 例如：lens, focalLength, aperture, iso, colorGrading 等
|
|||
|
|
*/
|
|||
|
|
[key: string]: unknown
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 分鏡表單一鏡頭結構
|
|||
|
|
*/
|
|||
|
|
export interface StoryboardShot {
|
|||
|
|
/**
|
|||
|
|
* 鏡頭編號
|
|||
|
|
*/
|
|||
|
|
shotNumber: number
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 鏡頭語言
|
|||
|
|
*/
|
|||
|
|
camera: CameraLanguage
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 場景描述
|
|||
|
|
*/
|
|||
|
|
scene: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 對話或旁白
|
|||
|
|
*/
|
|||
|
|
dialogue?: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 時長（秒）
|
|||
|
|
*/
|
|||
|
|
duration?: number
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 可擴充欄位
|
|||
|
|
*/
|
|||
|
|
[key: string]: unknown
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 完整分鏡表結構
|
|||
|
|
*/
|
|||
|
|
export interface Storyboard {
|
|||
|
|
/**
|
|||
|
|
* 標題
|
|||
|
|
*/
|
|||
|
|
title: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 風格描述
|
|||
|
|
*/
|
|||
|
|
style?: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 節奏描述
|
|||
|
|
*/
|
|||
|
|
pace?: string
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 鏡頭列表
|
|||
|
|
*/
|
|||
|
|
shots: StoryboardShot[]
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 可擴充欄位
|
|||
|
|
*/
|
|||
|
|
[key: string]: unknown
|
|||
|
|
}
|
|||
|
|
|