f1935fbc06
新增摄像机控制功能，允许用户为画布节点配置相机、镜头、焦距和光圈参数，生成时自动追加对应的摄影提示词到生成prompt中： 1. 新增相机参数类型定义与画布元数据存储支持 2. 实现相机/镜头参数库与提示词构建逻辑 3. 添加可视化配置弹窗与面板组件 4. 集成到图像生成流程中自动拼接摄影提示词
311 lines
16 KiB
TypeScript
311 lines
16 KiB
TypeScript
/**
|
||
* Professional cinematography prompt library for the Camera Control panel.
|
||
*
|
||
* Ported from open-storyboard-canvas, simplified for the web project.
|
||
* The output prompt is a comma-joinable fragment appended to the user's
|
||
* generation prompt so the image model treats it as camera direction.
|
||
*/
|
||
|
||
export interface CameraProfile {
|
||
id: string;
|
||
label: string;
|
||
zhName: string;
|
||
shortTag: string;
|
||
profilePrompt: string;
|
||
bodyColor: string;
|
||
accentColor: string;
|
||
useCase: string;
|
||
description: string;
|
||
}
|
||
|
||
export interface LensProfile {
|
||
id: string;
|
||
label: string;
|
||
zhName: string;
|
||
shortTag: string;
|
||
profilePrompt: string;
|
||
lensColor: string;
|
||
ringColor: string;
|
||
useCase: string;
|
||
description: string;
|
||
}
|
||
|
||
export interface CameraControlOptions {
|
||
enabled: boolean;
|
||
camera: string;
|
||
lens: string;
|
||
focalLength: number;
|
||
aperture: number;
|
||
}
|
||
|
||
export const CAMERA_PROFILES: CameraProfile[] = [
|
||
{
|
||
id: "panavision_dxl2",
|
||
label: "Panavision DXL2",
|
||
zhName: "潘那维申 DXL2",
|
||
shortTag: "Panavision DXL2",
|
||
profilePrompt: "shot on Panavision DXL2 with Panavision DXL color science, large-format Monstro 8K VV sensor, signature organic highlight rolloff, rich filmic texture, premium modern cinema look",
|
||
bodyColor: "#2a2a2a",
|
||
accentColor: "#e2a84f",
|
||
description: "好莱坞顶级院线电影机，8K 大画幅传感器，质感油润。",
|
||
useCase: "剧情长片、奢华广告、顶级商业片",
|
||
},
|
||
{
|
||
id: "arri_alexa_mini_lf",
|
||
label: "ARRI Alexa Mini LF",
|
||
zhName: "阿莱 Mini LF",
|
||
shortTag: "ARRI Alexa Mini LF",
|
||
profilePrompt: "shot on ARRI Alexa Mini LF with ARRI Wide Gamut color science, ALEV III large-format sensor, gorgeous skin-tone rendering, buttery highlight rolloff, industry-standard feature-film look",
|
||
bodyColor: "#3a3a3a",
|
||
accentColor: "#d4d4d4",
|
||
description: "行业基准院线电影机，肤色渲染公认最佳。",
|
||
useCase: "剧情片、人像叙事、品牌广告",
|
||
},
|
||
{
|
||
id: "red_komodo_6k",
|
||
label: "RED Komodo 6K",
|
||
zhName: "RED 科莫多 6K",
|
||
shortTag: "RED Komodo 6K",
|
||
profilePrompt: "shot on RED Komodo 6K with RED IPP2 color pipeline, Super35 global-shutter sensor, crisp modern digital detail, clean shadows, crisp action-movie look",
|
||
bodyColor: "#8b2b2b",
|
||
accentColor: "#ff3b3b",
|
||
description: "紧凑全局快门 6K，无果冻效应，动作片首选。",
|
||
useCase: "动作片、FPV、穿越机、无人机",
|
||
},
|
||
{
|
||
id: "red_v_raptor_8k",
|
||
label: "RED V-Raptor 8K",
|
||
zhName: "RED V-Raptor 8K",
|
||
shortTag: "RED V-Raptor 8K",
|
||
profilePrompt: "shot on RED V-Raptor 8K VV, RED IPP2 color pipeline, 8K Vista Vision sensor, razor-sharp resolution, vivid yet natural color",
|
||
bodyColor: "#701f1f",
|
||
accentColor: "#ff5555",
|
||
description: "RED 旗舰 8K Vista Vision，极致清晰度。",
|
||
useCase: "科幻大片、高分辨率 VFX 场景",
|
||
},
|
||
{
|
||
id: "sony_venice_2",
|
||
label: "Sony Venice 2",
|
||
zhName: "索尼 Venice 2",
|
||
shortTag: "Sony Venice 2",
|
||
profilePrompt: "shot on Sony Venice 2 with Sony S-Gamut3.Cine / S-Log3, dual native ISO full-frame cinema sensor, clean shadows, highly refined modern color science",
|
||
bodyColor: "#2d3a4d",
|
||
accentColor: "#4d90d0",
|
||
description: "全画幅双原生 ISO，弱光表现极佳。",
|
||
useCase: "高端广告、纪录片、夜景戏剧",
|
||
},
|
||
{
|
||
id: "sony_fx6",
|
||
label: "Sony FX6",
|
||
zhName: "索尼 FX6",
|
||
shortTag: "Sony FX6",
|
||
profilePrompt: "shot on Sony FX6, Sony Venice-derived color science, full-frame cinema sensor, clean low-light performance, documentary-friendly modern look",
|
||
bodyColor: "#2d2d36",
|
||
accentColor: "#ff9000",
|
||
description: "轻量全画幅 Cinema Line，手持纪录片常用。",
|
||
useCase: "纪录片、单兵采访、轻量剧情",
|
||
},
|
||
{
|
||
id: "blackmagic_ursa_12k",
|
||
label: "Blackmagic URSA 12K",
|
||
zhName: "黑魔法 URSA 12K",
|
||
shortTag: "Blackmagic URSA 12K",
|
||
profilePrompt: "shot on Blackmagic URSA Cine 12K with Blackmagic Generation 5 color science, Super35 12K sensor, rich filmic tones, indie-cinema aesthetic",
|
||
bodyColor: "#2e2e2e",
|
||
accentColor: "#ffb820",
|
||
description: "独立电影人宠儿，12K 高分辨率性价比机。",
|
||
useCase: "独立电影、音乐短片、实验影像",
|
||
},
|
||
{
|
||
id: "canon_c500_mk2",
|
||
label: "Canon C500 Mk II",
|
||
zhName: "佳能 C500 Mk II",
|
||
shortTag: "Canon C500 Mk II",
|
||
profilePrompt: "shot on Canon C500 Mark II with Canon Cinema Gamut, full-frame cinema sensor, warm natural skin tones, premium broadcast and feature-film character",
|
||
bodyColor: "#332a22",
|
||
accentColor: "#e8c070",
|
||
description: "佳能色彩科学，暖调肤色，广播级电影机。",
|
||
useCase: "广告、电视剧、婚礼电影",
|
||
},
|
||
];
|
||
|
||
export const LENS_PROFILES: LensProfile[] = [
|
||
{
|
||
id: "arri_signature_prime",
|
||
label: "ARRI Signature Prime",
|
||
zhName: "阿莱大师定焦",
|
||
shortTag: "ARRI Signature Prime",
|
||
profilePrompt: "ARRI Signature Prime lens, large-format coverage, creamy organic bokeh, gentle contrast, smooth highlight rolloff, soft flattering flares",
|
||
lensColor: "#2a2a2a",
|
||
ringColor: "#c4a060",
|
||
description: "顶级大画幅定焦头，奶油虚化，温润对比。",
|
||
useCase: "人物叙事、顶级商业片",
|
||
},
|
||
{
|
||
id: "cooke_s7i",
|
||
label: "Cooke S7/i",
|
||
zhName: "库克 S7/i",
|
||
shortTag: "Cooke S7/i",
|
||
profilePrompt: "Cooke S7/i lens, legendary \"Cooke Look\", warm color bias, gentle contrast, soft rounded bokeh, classic flattering skin rendering",
|
||
lensColor: "#26231d",
|
||
ringColor: "#d0a060",
|
||
description: "传奇「Cooke Look」，暖调偏红，讨喜肤色。",
|
||
useCase: "古典人像、时代感叙事",
|
||
},
|
||
{
|
||
id: "zeiss_supreme_prime",
|
||
label: "Zeiss Supreme Prime",
|
||
zhName: "蔡司至尊定焦",
|
||
shortTag: "Zeiss Supreme Prime",
|
||
profilePrompt: "Zeiss Supreme Prime lens, neutral modern color, high micro-contrast, sharp yet refined detail, clean bokeh with subtle cat-eye near edges",
|
||
lensColor: "#1e1e22",
|
||
ringColor: "#4d90d0",
|
||
description: "中性现代色彩，微反差锐利而不硬。",
|
||
useCase: "科技感广告、现代剧情",
|
||
},
|
||
{
|
||
id: "canon_sumire_prime",
|
||
label: "Canon Sumire Prime",
|
||
zhName: "佳能 Sumire 定焦",
|
||
shortTag: "Canon Sumire Prime",
|
||
profilePrompt: "Canon Sumire Prime lens, soft organic character, warm gentle color rendering, dreamy rounded bokeh, cinematic softness for portraits",
|
||
lensColor: "#2c241c",
|
||
ringColor: "#e0b070",
|
||
description: "柔和梦幻肤色镜，暖调柔焦。",
|
||
useCase: "爱情片、梦境、人物特写",
|
||
},
|
||
{
|
||
id: "anamorphic_cooke",
|
||
label: "Anamorphic (Cooke)",
|
||
zhName: "Cooke 变形宽银幕",
|
||
shortTag: "Cooke Anamorphic",
|
||
profilePrompt: "Cooke anamorphic lens, oval bokeh, horizontal blue streaks for flares, wide cinematic framing, subtle focus roll-off, 2.39:1 anamorphic cinematic feel",
|
||
lensColor: "#1a1a24",
|
||
ringColor: "#6a9ed6",
|
||
description: "宽银幕变形镜，椭圆虚化 + 水平蓝色光晕。",
|
||
useCase: "科幻大片、太空戏、夜戏",
|
||
},
|
||
{
|
||
id: "anamorphic_atlas",
|
||
label: "Anamorphic (Atlas)",
|
||
zhName: "Atlas Orion 变形",
|
||
shortTag: "Atlas Orion Anamorphic",
|
||
profilePrompt: "Atlas Orion anamorphic lens, oval bokeh, cyan horizontal flares, modern anamorphic look with clean center and subtle edge blur",
|
||
lensColor: "#1b2228",
|
||
ringColor: "#40c0e0",
|
||
description: "现代变形镜，青色光晕，中心清晰边缘柔。",
|
||
useCase: "音乐 MV、风格化广告",
|
||
},
|
||
{
|
||
id: "vintage_leica_r",
|
||
label: "Vintage Leica R",
|
||
zhName: "徕卡 R 老镜",
|
||
shortTag: "Vintage Leica R",
|
||
profilePrompt: "vintage Leica R prime lens, rich color saturation, slight glow on highlights, slightly soft edges, nostalgic 1970s-80s cinema character",
|
||
lensColor: "#3a2f1f",
|
||
ringColor: "#d04040",
|
||
description: "上世纪老镜，高光微透溢，复古怀旧味。",
|
||
useCase: "年代戏、怀旧 MV、文艺片",
|
||
},
|
||
{
|
||
id: "macro_100mm",
|
||
label: "Macro 100mm",
|
||
zhName: "100mm 微距",
|
||
shortTag: "Macro 100mm",
|
||
profilePrompt: "macro 100mm prime lens, extremely shallow depth of field, razor-thin focus plane, smooth creamy bokeh, detail-rich close-up rendering",
|
||
lensColor: "#1f1f1f",
|
||
ringColor: "#60d090",
|
||
description: "微距特写专用，细节惊人，景深极浅。",
|
||
useCase: "美食广告、珠宝、昆虫、细节",
|
||
},
|
||
];
|
||
|
||
export const FOCAL_LENGTHS = [14, 18, 24, 35, 40, 50, 65, 85, 100, 135, 200] as const;
|
||
export const APERTURES = [1.2, 1.4, 1.8, 2, 2.8, 4, 5.6, 8, 11, 16] as const;
|
||
|
||
export const FOCAL_LENGTH_META: Record<number, { zhName: string; description: string; useCase: string }> = {
|
||
14: { zhName: "超广角", description: "14mm 极致广角，空间被极度拉伸", useCase: "建筑内景、风景全景、沉浸视角" },
|
||
18: { zhName: "超广角", description: "18mm 超广角，强烈空间纵深", useCase: "街头摄影、室内、建筑" },
|
||
24: { zhName: "广角", description: "24mm 广角，环境感强烈", useCase: "风光、大场面、新闻纪实" },
|
||
35: { zhName: "小广角", description: "35mm 经典叙事焦段，接近人眼", useCase: "纪实、人物环境叙事" },
|
||
40: { zhName: "准标准", description: "40mm 准标准，构图平衡", useCase: "人像叙事、文艺片" },
|
||
50: { zhName: "标准", description: "50mm 标准，空间感自然", useCase: "人像、日常、街拍" },
|
||
65: { zhName: "中焦", description: "65mm 中焦，轻微压缩，讨喜肤色", useCase: "半身人像、对话戏" },
|
||
85: { zhName: "中长焦", description: "85mm 经典人像焦段", useCase: "特写人像、婚礼" },
|
||
100: { zhName: "长焦", description: "100mm 长焦，背景压缩明显", useCase: "特写、微距、体育" },
|
||
135: { zhName: "长焦", description: "135mm 电影专用长焦", useCase: "剧情特写、舞台" },
|
||
200: { zhName: "超长焦", description: "200mm 超长焦，极致背景压缩", useCase: "体育、野生动物、戏剧感特写" },
|
||
};
|
||
|
||
export const APERTURE_META: Record<number, { zhName: string; description: string; useCase: string }> = {
|
||
1.2: { zhName: "极大光圈", description: "f/1.2 虚化极致，景深刀削般薄", useCase: "梦幻人像、高光溢出效果" },
|
||
1.4: { zhName: "大光圈", description: "f/1.4 强烈虚化，电影感十足", useCase: "夜景人像、暗光" },
|
||
1.8: { zhName: "大光圈", description: "f/1.8 明显背景虚化", useCase: "半身人像、街头弱光" },
|
||
2: { zhName: "大光圈", description: "f/2 柔和虚化与充足锐度", useCase: "人像、文艺日常" },
|
||
2.8: { zhName: "标准大光圈", description: "f/2.8 景深适中、虚化柔和", useCase: "群像、叙事" },
|
||
4: { zhName: "中光圈", description: "f/4 主体清晰，背景有轻微虚化", useCase: "群像、婚礼、电视剧" },
|
||
5.6: { zhName: "中光圈", description: "f/5.6 背景可辨，环境感强", useCase: "纪实、日常、小品" },
|
||
8: { zhName: "小光圈", description: "f/8 画质最佳区，前后皆清晰", useCase: "风光、建筑、全景" },
|
||
11: { zhName: "小光圈", description: "f/11 超大景深，几乎全清晰", useCase: "大场景、产品摆拍" },
|
||
16: { zhName: "极小光圈", description: "f/16 星芒出现，需高光源", useCase: "日光风光、星芒特效" },
|
||
};
|
||
|
||
const CAMERA_PROMPT_TEMPLATE = [
|
||
"the following parameters describe the virtual camera, lens, and exposure used to render this image",
|
||
"they are camera direction, NOT objects to add inside the frame",
|
||
"do not add any physical camera, lens, tripod, viewfinder, or photography equipment into the image",
|
||
"{{cameraProfilePrompt}}, {{lensProfilePrompt}}, {{focalLengthPrompt}}, {{aperturePrompt}}",
|
||
"keep the subjects, scene, and action unchanged — apply these as optical and sensor characteristics only",
|
||
"[camera body: {{cameraBody}} · lens: {{lens}} · focal: {{focalLengthMm}}mm · aperture: f/{{apertureF}}]",
|
||
].join(", ");
|
||
|
||
export function describeFocalLength(mm: number): string {
|
||
if (mm <= 16) return `${mm}mm ultra-wide-angle perspective, strong spatial depth, pronounced edge distortion, immersive wide coverage`;
|
||
if (mm <= 24) return `${mm}mm wide-angle perspective, exaggerated depth, strong foreground/background separation, environment-forward framing`;
|
||
if (mm <= 35) return `${mm}mm slight-wide cinematic perspective, natural environmental context, balanced depth, classic story-telling framing`;
|
||
if (mm <= 50) return `${mm}mm standard/normal perspective, close to natural human eye perspective, neutral spatial compression, flattering portrait framing`;
|
||
if (mm <= 85) return `${mm}mm short-telephoto portrait perspective, mild background compression, flattering facial rendering, subject isolation`;
|
||
if (mm <= 135) return `${mm}mm telephoto perspective, moderate compression, strong subject isolation from background, cinematic close-up`;
|
||
return `${mm}mm long-telephoto perspective, strong background compression, highly isolated subject on compressed flat background, powerful dramatic framing`;
|
||
}
|
||
|
||
export function describeAperture(f: number): string {
|
||
if (f <= 1.4) return `shot wide open at f/${f}, extremely shallow depth of field, strong creamy bokeh, razor-thin focus plane, dreamy background separation`;
|
||
if (f <= 2) return `shot at f/${f}, very shallow depth of field, smooth cinematic bokeh, clear subject-from-background separation`;
|
||
if (f <= 2.8) return `shot at f/${f}, shallow depth of field, soft bokeh, natural subject isolation`;
|
||
if (f <= 4) return `shot at f/${f}, moderate depth of field, gentle falloff, clean background blur without over-smoothing`;
|
||
if (f <= 5.6) return `shot at f/${f}, balanced depth of field, background retains context while subject remains clearly in focus`;
|
||
if (f <= 8) return `shot at f/${f}, wide depth of field, environment and subject both sharp, documentary / landscape style`;
|
||
return `shot at f/${f}, very wide depth of field, extensive sharpness from foreground to background, wide-open environmental feel`;
|
||
}
|
||
|
||
function applyTemplate(template: string, values: Record<string, string>): string {
|
||
return template.replace(/\{\{(\w+)\}\}/g, (_, key: string) => values[key] ?? "")
|
||
.split(",")
|
||
.map((s) => s.trim())
|
||
.filter(Boolean)
|
||
.join(", ");
|
||
}
|
||
|
||
export interface CameraPromptInput {
|
||
cameraId: string;
|
||
lensId: string;
|
||
focalLengthMm: number;
|
||
apertureF: number;
|
||
}
|
||
|
||
export function buildCameraPrompt(input: CameraPromptInput): string {
|
||
const cam = CAMERA_PROFILES.find((c) => c.id === input.cameraId) ?? CAMERA_PROFILES[0];
|
||
const lens = LENS_PROFILES.find((l) => l.id === input.lensId) ?? LENS_PROFILES[0];
|
||
return applyTemplate(CAMERA_PROMPT_TEMPLATE, {
|
||
cameraProfilePrompt: cam.profilePrompt,
|
||
lensProfilePrompt: lens.profilePrompt,
|
||
focalLengthPrompt: describeFocalLength(input.focalLengthMm),
|
||
aperturePrompt: describeAperture(input.apertureF),
|
||
cameraBody: cam.shortTag,
|
||
lens: lens.shortTag,
|
||
focalLengthMm: String(input.focalLengthMm),
|
||
apertureF: String(input.apertureF),
|
||
});
|
||
}
|