diff --git a/.cursorrules b/.cursorrules new file mode 100644 index 0000000..fa2ea00 --- /dev/null +++ b/.cursorrules @@ -0,0 +1,144 @@ +# ComfyUI Node Documentation Multi-language Localization Project Rules + +## Project Overview +You are assisting in a project dedicated to creating multi-language documentation for ComfyUI nodes. +While maintaining professional explanations, metaphorical explanations are also needed to transform complex technical concepts into everyday life scenarios, ensuring non-technical users can easily understand node functionality. + +## Core Principles + +### User-Oriented +- Assume readers are completely non-technical users +- Use easy-to-understand everyday vocabulary, avoid technical terms +- Transform abstract concepts into concrete daily operations +- Explain functionality through "what it does" rather than "how it does it" + +### Metaphorical Explanation Strategy +- Choose everyday life scenarios or craft processes similar to node functionality, preferably related to painting +- Metaphors must accurately reflect the node's core functionality, avoid misleading analogies +- Choose everyday scenarios familiar to ordinary people +- Match metaphor complexity with node functionality +- Avoid metaphors that might cause cultural misunderstandings + +## Documentation Structure Requirements + +When creating or editing ComfyUI node documentation, strictly follow this structure: + +### Required Sections +1. **Function Description** - Explain the node's core purpose in 1-2 easy-to-understand sentences +2. **Working Principle** - Explain the node's working method using everyday life metaphors +3. **Input Parameter Description** - Detailed explanation of all input parameters +4. **Output Result Description** - Explain the node's output content and format +5. **Usage Suggestions** - Practical application scenarios and operation tips with metaphors +6. **Do not use level-one headings** + +### Parameter Table Format +For input parameters, please refer to the following format, though it's not mandatory if a table is already provided: +```markdown +| Parameter Name | Data Type | Input Method | Default | Range | Description | +|----------|----------|----------|---------|----------|----------| +``` + +For output results, please refer to the following format, though it's not mandatory if a table is already provided: +```markdown +| Output Name | Data Type | Description | +|----------|----------|------| +``` + +Parameter names should be represented using backticks (`) to ensure they are displayed as styled text, not plain text. +Data types should be represented using plain text, not styled text. + +## Data Type Processing Rules + +### Important: Do not translate data types +- Keep all data types in English: IMAGE, FLOAT, INT, STRING, MODEL, CONDITIONING, LATENT, MASK, etc. +- Do not translate data types into any localized versions +- Only translate parameter names + +## Multilingual Localization Rules + +### Supported Languages +- Chinese (zh) +- English (en) +- Spanish (es) +- French (fr) +- Japanese (ja) +- Korean (ko) +- Russian (ru) + +### Translation Principles +- Only translate when explicitly requested by the user +- Only translate parameter names and descriptions +- Keep data types in English +- Maintain document structure consistency +- Ensure metaphors are appropriate for the target language + +## Workflow (Only when I provide you with source code) + +### Node Analysis Phase +1. Get the node source code to determine the node's classification and functionality +2. Analyze INPUT_TYPES to identify all input parameters and their data types +3. Analyze RETURN_TYPES to determine the output content and data types +4. Understand the node's core working mechanism and application scenarios + +### Metaphor Design Phase +1. Select an appropriate everyday life metaphor based on the node's functionality +2. Ensure the metaphor accurately conveys the node's function +3. Consider the applicability of the metaphor in different cultural backgrounds +4. Design a detailed expansion of the metaphor + +### Documentation Creation Phase +1. Write a concise function description (1-2 sentences) +2. Use the selected metaphor to explain the working principle +3. Create a complete input parameter table +4. Create an output result table +5. Write practical usage suggestions and application scenarios + +## Quality Standards + +### Content Requirements +- ✅ Use everyday life metaphors to ensure non-technical users can understand +- ✅ Provide complete input and output parameter descriptions +- ✅ Include practical application scenarios and operation suggestions +- ✅ Use simple language to describe technical concepts +- ❌ Avoid using emojis +- ❌ Do not include source code snippets +- ❌ Avoid overly technical terminology explanations + +### Language Style Requirements +- **Simple and easy to understand**: Assume the reader is a completely non-technical user +- **Clear and concise**: Avoid long and complex sentences +- **Accurate and consistent**: Term +- **Clear Structure**: Clear logical hierarchy, easy to reference + +## Special Notes + +### User Collaboration Mode +- Do not actively perform multilingual translation unless explicitly requested by the user. Additionally, if the user incorrectly requests translation during file provision (e.g., providing en.md but requesting French translation), do not translate but promptly notify the user +- Terminology verification depends on user-provided interface information +- Use user-updated versions for translation and updates +- Remember to add any image content if added by the user + +### Prohibited Actions +- Do not automatically start translation work for other language files unless actively requested by the user +- Do not translate data type names +- Do not modify original documentation or create specific node example information during translation unless requested by the user + +## Translation Tasks + +When users provide language files and request translation to corresponding languages, please follow these rules: +- Usually, corresponding language screenshots of node information will be provided; ensure parameter names and descriptions match the screenshots +- If no corresponding screenshots are provided, maintain the English version of parameter names + +## Standardized Terms for Input/Output Section Titles in Different Languages + +- Note: These terms only apply to the headings of parameter description sections + +| Language File | Input Title | Output Title | +|----------|----------|----------| +| en.md | Inputs | Outputs | +| es.md | Entradas | Salidas | +| fr.md | Entrées | Sorties | +| ja.md | 入力 | 出力 | +| ko.md | 입력 | 출력 | +| zh.md | 输入 | 输出 | +| ru.md | Входы | Выходы | \ No newline at end of file diff --git a/comfyui_embedded_docs/docs/Load3d/asset/load3d_outputs.webp b/comfyui_embedded_docs/docs/Load3d/asset/load3d_outputs.webp new file mode 100644 index 0000000..f37d206 Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/load3d_outputs.webp differ diff --git a/comfyui_embedded_docs/docs/Load3d/asset/load3d_ui.jpg b/comfyui_embedded_docs/docs/Load3d/asset/load3d_ui.jpg new file mode 100644 index 0000000..46c22cd Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/load3d_ui.jpg differ diff --git a/comfyui_embedded_docs/docs/Load3d/asset/menu.webp b/comfyui_embedded_docs/docs/Load3d/asset/menu.webp new file mode 100644 index 0000000..4cbbb4b Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/menu.webp differ diff --git a/comfyui_embedded_docs/docs/Load3d/asset/menu_camera.webp b/comfyui_embedded_docs/docs/Load3d/asset/menu_camera.webp new file mode 100644 index 0000000..20b2f7b Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/menu_camera.webp differ diff --git a/comfyui_embedded_docs/docs/Load3d/asset/menu_export.webp b/comfyui_embedded_docs/docs/Load3d/asset/menu_export.webp new file mode 100644 index 0000000..51cc9fa Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/menu_export.webp differ diff --git a/comfyui_embedded_docs/docs/Load3d/asset/menu_light.webp b/comfyui_embedded_docs/docs/Load3d/asset/menu_light.webp new file mode 100644 index 0000000..9d39adf Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/menu_light.webp differ diff --git a/comfyui_embedded_docs/docs/Load3d/asset/menu_model.webp b/comfyui_embedded_docs/docs/Load3d/asset/menu_model.webp new file mode 100644 index 0000000..263e282 Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/menu_model.webp differ diff --git a/comfyui_embedded_docs/docs/Load3d/asset/menu_scene.webp b/comfyui_embedded_docs/docs/Load3d/asset/menu_scene.webp new file mode 100644 index 0000000..070a024 Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/menu_scene.webp differ diff --git a/comfyui_embedded_docs/docs/Load3d/asset/recording.mp4 b/comfyui_embedded_docs/docs/Load3d/asset/recording.mp4 new file mode 100644 index 0000000..5f077f4 Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/recording.mp4 differ diff --git a/comfyui_embedded_docs/docs/Load3d/asset/render_mode.webp b/comfyui_embedded_docs/docs/Load3d/asset/render_mode.webp new file mode 100644 index 0000000..10afd4d Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/render_mode.webp differ diff --git a/comfyui_embedded_docs/docs/Load3d/asset/view_operations.mp4 b/comfyui_embedded_docs/docs/Load3d/asset/view_operations.mp4 new file mode 100644 index 0000000..77af5b9 Binary files /dev/null and b/comfyui_embedded_docs/docs/Load3d/asset/view_operations.mp4 differ diff --git a/comfyui_embedded_docs/docs/Load3d/en.md b/comfyui_embedded_docs/docs/Load3d/en.md new file mode 100644 index 0000000..3f1a6b2 --- /dev/null +++ b/comfyui_embedded_docs/docs/Load3d/en.md @@ -0,0 +1,132 @@ +The Load3D node is a core node for loading and processing 3D model files. When loading the node, it automatically retrieves available 3D resources from `ComfyUI/input/3d/`. You can also upload supported 3D files for preview using the upload function. + +**Supported Formats** +Currently, this node supports multiple 3D file formats, including `.gltf`, `.glb`, `.obj`, `.fbx`, and `.stl`. + +**3D Node Preferences** +Some related preferences for 3D nodes can be configured in ComfyUI's settings menu. Please refer to the following documentation for corresponding settings: + +[Settings Menu](https://docs.comfy.org/interface/settings/3d) + +Besides regular node outputs, Load3D has lots of 3D view-related settings in the canvas menu. + +## Inputs + +| Parameter Name | Type | Description | Default | Range | +|---------------|----------|---------------------------------|---------|--------------| +| model_file | File Selection | 3D model file path, supports upload, defaults to reading model files from `ComfyUI/input/3d/` | - | Supported formats | +| width | INT | Canvas rendering width | 1024 | 1-4096 | +| height | INT | Canvas rendering height | 1024 | 1-4096 | + +## Outputs + +| Parameter Name | Data Type | Description | +|-----------------|----------------|------------------------------------| +| image | IMAGE | Canvas rendered image | +| mask | MASK | Mask containing current model position | +| mesh_path | STRING | Model file path | +| normal | IMAGE | Normal map | +| lineart | IMAGE | Line art image output, corresponding `edge_threshold` can be adjusted in the canvas model menu | +| camera_info | LOAD3D_CAMERA | Camera information | +| recording_video | VIDEO | Recorded video (only when recording exists) | + +All the outputs preview: +![View Operation Demo](./asset/load3d_outputs.webp) + +## Canvas Area Description + +The Load3D node's Canvas area contains numerous view operations, including: + +- Preview view settings (grid, background color, preview view) +- Camera control: Control FOV, camera type +- Global illumination intensity: Adjust lighting intensity +- Video recording: Record and export videos +- Model export: Supports `GLB`, `OBJ`, `STL` formats +- And more + +![Load 3D Node UI](./asset/load3d_ui.jpg) + +1. Contains multiple menus and hidden menus of the Load 3D node +2. Menu for `resizing preview window` and `canvas video recording` +3. 3D view operation axis +4. Preview thumbnail +5. Preview size settings, scale preview view display by setting dimensions and then resizing window + +### 1. View Operations + + + +View control operations: + +- Left-click + drag: Rotate the view +- Right-click + drag: Pan the view +- Middle wheel scroll or middle-click + drag: Zoom in/out +- Coordinate axis: Switch views + +### 2. Left Menu Functions + +![Menu](./asset/menu.webp) + +In the canvas, some settings are hidden in the menu. Click the menu button to expand different menus + +- 1. Scene: Contains preview window grid, background color, preview settings +- 2. Model: Model rendering mode, texture materials, up direction settings +- 3. Camera: Switch between orthographic and perspective views, and set the perspective angle size +- 4. Light: Scene global illumination intensity +- 5. Export: Export model to other formats (GLB, OBJ, STL) + +#### Scene + +![scene menu](./asset/menu_scene.webp) + +The Scene menu provides some basic scene setting functions + +1. Show/Hide grid +2. Set background color +3. Click to upload a background image +4. Hide the preview + +#### Model + +![Menu_Scene](./asset/menu_model.webp) + +The Model menu provides some model-related functions + +1. **Up direction**: Determine which axis is the up direction for the model +2. **Material mode**: Switch model rendering modes - Original, Normal, Wireframe, Lineart + +#### Camera + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +This menu provides switching between orthographic and perspective views, and perspective angle size settings + +1. **Camera**: Quickly switch between orthographic and orthographic views +2. **FOV**: Adjust FOV angle + +#### Light + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +Through this menu, you can quickly adjust the scene's global illumination intensity + +#### Export + +![menu_export](./asset/menu_export.webp) + +This menu provides the ability to quickly convert and export model formats + +### 3. Right Menu Functions + + + +The right menu has two main functions: + +1. **Reset view ratio**: After clicking the button, the view will adjust the canvas rendering area ratio according to the set width and height +2. **Video recording**: Allows you to record current 3D view operations as video, allows import, and can be output as `recording_video` to subsequent nodes diff --git a/comfyui_embedded_docs/docs/Load3d/es.md b/comfyui_embedded_docs/docs/Load3d/es.md new file mode 100644 index 0000000..4809e29 --- /dev/null +++ b/comfyui_embedded_docs/docs/Load3d/es.md @@ -0,0 +1,132 @@ +El nodo Load3D es un nodo principal para cargar y procesar archivos de modelos 3D. Al cargar el nodo, obtiene automáticamente los recursos 3D disponibles en `ComfyUI/input/3d/`. También puedes subir archivos 3D compatibles para previsualizarlos usando la función de carga. + +**Formatos soportados** +Actualmente, este nodo soporta varios formatos de archivos 3D, incluyendo `.gltf`, `.glb`, `.obj`, `.fbx` y `.stl`. + +**Preferencias del nodo 3D** +Algunas preferencias relacionadas con los nodos 3D se pueden configurar en el menú de configuración de ComfyUI. Consulta el siguiente documento para ver los ajustes correspondientes: + +[Menú de configuración](https://docs.comfy.org/interface/settings/3d) + +Además de las salidas habituales del nodo, Load3D tiene muchas opciones relacionadas con la vista 3D en el menú del área de previsualización. + +## Entradas + +| Nombre del parámetro | Tipo | Descripción | Predeterminado | Rango | +|---------------------|----------------|--------------------------------------------------------------------|----------------|---------------| +| model_file | File Selection | Ruta del archivo del modelo 3D, soporta carga, por defecto lee archivos de `ComfyUI/input/3d/` | - | Formatos soportados | +| width | INT | Ancho de renderizado del lienzo | 1024 | 1-4096 | +| height | INT | Alto de renderizado del lienzo | 1024 | 1-4096 | + +## Salidas + +| Nombre de salida | Tipo de dato | Descripción | +|--------------------|----------------|--------------------------------------------------------------------| +| image | IMAGE | Imagen renderizada en el lienzo | +| mask | MASK | Máscara que contiene la posición actual del modelo | +| mesh_path | STRING | Ruta del archivo del modelo (dentro de la carpeta `ComfyUI/input`) | +| normal | IMAGE | Mapa de normales | +| lineart | IMAGE | Salida de imagen de dibujo lineal, el `edge_threshold` se puede ajustar en el menú de modelo del lienzo | +| camera_info | LOAD3D_CAMERA | Información de la cámara | +| recording_video | VIDEO | Video grabado (solo si existe grabación) | + +Vista previa de todas las salidas: +![Demostración de operaciones de vista](./asset/load3d_outputs.webp) + +## Descripción del área de lienzo (Canvas) + +El área Canvas del nodo Load3D contiene numerosas operaciones de vista, incluyendo: + +- Configuración de vista previa (cuadrícula, color de fondo, vista previa) +- Control de cámara: controlar FOV, tipo de cámara +- Intensidad de iluminación global: ajustar la intensidad de la luz +- Grabación de video: grabar y exportar videos +- Exportación de modelo: soporta formatos `GLB`, `OBJ`, `STL` +- Etc. + +![UI del nodo Load 3D](./asset/load3d_ui.jpg) + +1. Incluye varios menús y menús ocultos del nodo Load 3D +2. Menú para redimensionar la ventana de previsualización y grabar video del lienzo +3. Eje de operaciones de vista 3D +4. Miniatura de previsualización +5. Configuración del tamaño de la previsualización, ajusta la visualización de la vista previa configurando dimensiones y luego redimensionando la ventana + +### 1. Operaciones de vista + + + +Operaciones de control de vista: + +- Clic izquierdo + arrastrar: rotar la vista +- Clic derecho + arrastrar: mover la vista +- Rueda del ratón o clic central: acercar/alejar +- Eje de coordenadas: cambiar de vista + +### 2. Funciones del menú izquierdo + +![Menu](./asset/menu.webp) + +En el área de previsualización, algunos menús relacionados con operaciones de vista están ocultos en el menú. Haz clic en el botón de menú para expandir los diferentes menús + +- 1. Escena (Scene): incluye cuadrícula de la ventana de previsualización, color de fondo, configuración de miniatura +- 2. Modelo (Model): modo de renderizado del modelo, materiales de textura, configuración de dirección superior +- 3. Cámara (Camera): cambiar entre vista ortográfica y perspectiva, y ajustar el ángulo de perspectiva +- 4. Luz (Light): intensidad de iluminación global de la escena +- 5. Exportar (Export): exportar el modelo a otros formatos (GLB, OBJ, STL) + +#### Escena (Scene) + +![scene menu](./asset/menu_scene.webp) + +El menú Escena proporciona algunas funciones básicas de configuración de la escena + +1. Mostrar/ocultar cuadrícula +2. Establecer color de fondo +3. Subir imagen de fondo +4. Ocultar miniatura de previsualización + +#### Modelo (Model) + +![Menu_Scene](./asset/menu_model.webp) + +El menú Modelo proporciona algunas funciones relacionadas con el modelo + +1. **Dirección superior (Up direction)**: determina qué eje es la dirección superior del modelo +2. **Modo de material (Material mode)**: cambiar modos de renderizado del modelo - Original, Normal, Malla, Dibujo lineal + +#### Cámara (Camera) + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +Este menú permite cambiar entre vistas ortográfica y perspectiva, y ajustar el ángulo de perspectiva + +1. **Cámara (Camera)**: cambiar rápidamente entre vistas ortográfica y perspectiva +2. **FOV**: ajustar el ángulo FOV + +#### Luz (Light) + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +A través de este menú puedes ajustar rápidamente la intensidad de la iluminación global de la escena + +#### Exportar (Export) + +![menu_export](./asset/menu_export.webp) + +Este menú permite convertir y exportar rápidamente formatos de modelo + +### 3. Funciones del menú derecho + + + +El menú derecho tiene dos funciones principales: + +1. **Restablecer proporción de vista**: al hacer clic en el botón, la vista ajustará la proporción del área de renderizado del lienzo según el ancho y alto establecidos +2. **Grabación de video**: permite grabar las operaciones actuales de vista 3D como video, permite importar y puede ser salida como `recording_video` a nodos posteriores diff --git a/comfyui_embedded_docs/docs/Load3d/fr.md b/comfyui_embedded_docs/docs/Load3d/fr.md new file mode 100644 index 0000000..7afc0ce --- /dev/null +++ b/comfyui_embedded_docs/docs/Load3d/fr.md @@ -0,0 +1,132 @@ +Le nœud Load3D est un nœud principal pour charger et traiter des fichiers de modèles 3D. Lors du chargement du nœud, il récupère automatiquement les ressources 3D disponibles dans `ComfyUI/input/3d/`. Vous pouvez également téléverser des fichiers 3D pris en charge pour les prévisualiser à l'aide de la fonction de téléversement. + +**Formats pris en charge** +Actuellement, ce nœud prend en charge plusieurs formats de fichiers 3D, y compris `.gltf`, `.glb`, `.obj`, `.fbx` et `.stl`. + +**Préférences du nœud 3D** +Certaines préférences liées aux nœuds 3D peuvent être configurées dans le menu des paramètres de ComfyUI. Veuillez consulter la documentation suivante pour les réglages correspondants : + +[Menu des paramètres](https://docs.comfy.org/interface/settings/3d) + +En plus des sorties habituelles du nœud, Load3D propose de nombreuses options liées à la vue 3D dans le menu de la zone d’aperçu. + +## Entrées + +| Nom du paramètre | Type | Description | Par défaut | Plage | +|------------------|----------------|--------------------------------------------------------------------|------------|---------------| +| model_file | File Selection | Chemin du fichier du modèle 3D, prise en charge du téléversement, lit par défaut les fichiers dans `ComfyUI/input/3d/` | - | Formats pris en charge | +| width | INT | Largeur de rendu du canevas | 1024 | 1-4096 | +| height | INT | Hauteur de rendu du canevas | 1024 | 1-4096 | + +## Sorties + +| Nom de sortie | Type de donnée | Description | +|------------------|----------------|--------------------------------------------------------------------| +| image | IMAGE | Image rendue sur le canevas | +| mask | MASK | Masque contenant la position actuelle du modèle | +| mesh_path | STRING | Chemin du fichier du modèle (dans le dossier `ComfyUI/input`) | +| normal | IMAGE | Carte des normales | +| lineart | IMAGE | Sortie d’image de dessin au trait, le `edge_threshold` peut être ajusté dans le menu du modèle du canevas | +| camera_info | LOAD3D_CAMERA | Informations de la caméra | +| recording_video | VIDEO | Vidéo enregistrée (uniquement si une vidéo existe) | + +Aperçu de toutes les sorties : +![Démonstration des opérations de vue](./asset/load3d_outputs.webp) + +## Description de la zone Canevas (Canvas) + +La zone Canvas du nœud Load3D contient de nombreuses opérations de vue, notamment : + +- Paramètres d’aperçu (grille, couleur de fond, aperçu) +- Contrôle de la caméra : contrôle du FOV, type de caméra +- Intensité de l’éclairage global : ajuster l’intensité de la lumière +- Enregistrement vidéo : enregistrer et exporter des vidéos +- Exportation de modèle : prend en charge les formats `GLB`, `OBJ`, `STL` +- Etc. + +![UI du nœud Load 3D](./asset/load3d_ui.jpg) + +1. Contient plusieurs menus et menus cachés du nœud Load 3D +2. Menu pour redimensionner la fenêtre d’aperçu et enregistrer la vidéo du canevas +3. Axe d’opération de vue 3D +4. Miniature d’aperçu +5. Réglage de la taille de l’aperçu, ajustez l’affichage de l’aperçu en définissant les dimensions puis en redimensionnant la fenêtre + +### 1. Opérations de vue + + + +Opérations de contrôle de la vue : + +- Clic gauche + glisser : faire pivoter la vue +- Clic droit + glisser : déplacer la vue +- Molette de la souris ou clic central : zoom avant/arrière +- Axe de coordonnées : changer de vue + +### 2. Fonctions du menu de gauche + +![Menu](./asset/menu.webp) + +Dans la zone d’aperçu, certains menus liés aux opérations de vue sont cachés dans le menu. Cliquez sur le bouton de menu pour développer les différents menus + +- 1. Scène (Scene) : comprend la grille de la fenêtre d’aperçu, la couleur de fond, les paramètres de la miniature +- 2. Modèle (Model) : mode de rendu du modèle, matériaux de texture, réglage de la direction haut +- 3. Caméra (Camera) : basculer entre la vue orthographique et la vue en perspective, et régler l’angle de perspective +- 4. Lumière (Light) : intensité de l’éclairage global de la scène +- 5. Exportation (Export) : exporter le modèle vers d’autres formats (GLB, OBJ, STL) + +#### Scène (Scene) + +![scene menu](./asset/menu_scene.webp) + +Le menu Scène propose quelques fonctions de configuration de base de la scène + +1. Afficher/Masquer la grille +2. Définir la couleur de fond +3. Télécharger une image de fond +4. Masquer la miniature d’aperçu + +#### Modèle (Model) + +![Menu_Scene](./asset/menu_model.webp) + +Le menu Modèle propose quelques fonctions liées au modèle + +1. **Direction haut (Up direction)** : détermine quel axe est la direction haut du modèle +2. **Mode matériel (Material mode)** : basculer entre les modes de rendu du modèle - Original, Normal, Fil de fer, Dessin au trait + +#### Caméra (Camera) + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +Ce menu permet de basculer entre la vue orthographique et la vue en perspective, et de régler l’angle de perspective + +1. **Caméra (Camera)** : basculer rapidement entre la vue orthographique et la vue en perspective +2. **FOV** : ajuster l’angle FOV + +#### Lumière (Light) + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +Ce menu permet d’ajuster rapidement l’intensité de l’éclairage global de la scène + +#### Exportation (Export) + +![menu_export](./asset/menu_export.webp) + +Ce menu permet de convertir et d’exporter rapidement les formats de modèle + +### 3. Fonctions du menu de droite + + + +Le menu de droite a deux fonctions principales : + +1. **Réinitialiser le ratio de vue** : après avoir cliqué sur le bouton, la vue ajustera le ratio de la zone de rendu du canevas selon la largeur et la hauteur définies +2. **Enregistrement vidéo** : permet d’enregistrer les opérations de vue 3D actuelles en vidéo, permet l’importation et peut être exporté comme `recording_video` vers les nœuds suivants diff --git a/comfyui_embedded_docs/docs/Load3d/ja.md b/comfyui_embedded_docs/docs/Load3d/ja.md new file mode 100644 index 0000000..afd65c8 --- /dev/null +++ b/comfyui_embedded_docs/docs/Load3d/ja.md @@ -0,0 +1,133 @@ +3Dを読み込むノードは、3Dモデルファイルを読み込み・処理するためのコアノードです。ノードを読み込むと、自動的に`ComfyUI/input/3d/`から利用可能な3Dリソースを取得します。また、「upload 3d model」機能を使って、対応する3Dファイルをアップロードし、プレビューすることもできます。 + +**対応フォーマット** +現在、このノードは複数の3Dファイル形式（.gltf、.glb、.obj、.fbx、.stl）に対応しています。 + +**3Dノードの設定** +3Dノードに関するいくつかの設定は、ComfyUIの設定メニューで調整できます。詳細は以下のドキュメントをご参照ください： + +[設定メニュー](https://docs.comfy.org/interface/settings/3d) + +通常のノード出力に加え、Load3Dノードはキャンバスメニュー内に多くの3Dビュー関連設定があります。 + +## 入力 + +| パラメータ名 | データ型 | 説明 | デフォルト | 範囲 | +|--------------|------------|--------------------------|--------|--------------| +| モデルファイル | File Selection | 3Dモデルファイルのパス、アップロード対応、デフォルトは`ComfyUI/input/3d/`から読み込み | - | 対応フォーマット | +| 幅 | INT | キャンバスのレンダリング幅 | 1024 | 1-4096 | +| 高さ | INT | キャンバスのレンダリング高さ | 1024 | 1-4096 | + +## 出力 + +| 出力名 | データ型 | 説明 | +| --------------- | ------------- | -------------------------------- | +| image | IMAGE | キャンバスでレンダリングされた画像 | +| mask | MASK | 現在のモデル位置を含むマスク | +| mesh_path | STRING | モデルファイルのパス（`ComfyUI/input` フォルダ内のパス） | +| normal | IMAGE | ノーマルマップ | +| lineart | IMAGE | 線画画像出力、対応する `edge_threshold` はキャンバスのモデルメニューで調整可能 | +| camera_info | LOAD3D_CAMERA | カメラ情報 | +| recording_video | VIDEO | 録画ビデオ（録画が存在する場合のみ） | + +すべての出力のプレビュー： + +![ビュー操作デモ](./asset/load3d_outputs.webp) + +## モデルキャンバス(Canvas)エリアの説明 + +Load3DノードのCanvasエリアには、多くのビュー操作が含まれています： + +- プレビュー表示設定（グリッド、背景色、プレビュー表示） +- カメラコントロール：FOV、カメラタイプの制御 +- グローバル照明強度：ライトの強さ調整 +- ビデオ録画：操作を録画・エクスポート +- モデルエクスポート：GLB、OBJ、STL形式に対応 +- など + +![Load 3D Node UI](./asset/load3d_ui.jpg) + +1. Load3Dノードの複数のメニューおよび隠しメニュー +2. プレビューウィンドウのリサイズやキャンバスビデオ録画のメニュー +3. 3Dビュー操作軸 +4. プレビューサムネイル +5. プレビューサイズ設定、寸法を設定しウィンドウサイズを変更してプレビュー表示を調整 + +### 1. ビュー操作 + + + +ビューコントロール操作： + +- 左クリック＋ドラッグ：ビューを回転 +- 右クリック＋ドラッグ：ビューを平行移動 +- 中クリック：ズームイン／アウト +- 座標軸：ビューの切り替え + +### 2. 左側メニュー機能 + +![Menu](./asset/menu.webp) + +プレビューエリアでは、一部のビュー操作関連メニューがメニュー内に隠れています。メニューボタンをクリックすると各種メニューが展開されます。 + +- 1. シーン（Scene）：プレビューウィンドウのグリッド、背景色、サムネイル設定 +- 2. モデル（Model）：モデルレンダリングモード、テクスチャ、上方向設定 +- 3. カメラ（Camera）：オーソグラフィックビューとパースビューの切り替え、視野角設定 +- 4. ライト（Light）：シーングローバル照明強度 +- 5. エクスポート（Export）：GLB、OBJ、STL形式へのエクスポート + +#### シーン（Scene） + +![scene menu](./asset/menu_scene.webp) + +シーンメニューは、シーンの基本設定機能を提供します + +1. グリッドの表示／非表示 +2. 背景色の設定 +3. 背景画像のアップロード +4. サムネイルの非表示 + +#### モデル（Model） + +![Menu_Scene](./asset/menu_model.webp) + +モデルメニューは、モデル関連の機能を提供します + +1. **上方向（Up direction）**：モデルのどの軸が上方向かを指定 +2. **レンダリングモード（Material mode）**：オリジナル、ノーマル、ワイヤーフレーム、線画の切り替え + +#### カメラ（Camera） + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +このメニューは、オーソグラフィックビューとパースビューの切り替え、視野角設定を提供します + +1. **カメラ（Camera）**：オーソグラフィックビューとパースビューの切り替え +2. **FOV**：視野角の調整 + +#### ライト（Light） + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +このメニューでシーン全体のグローバル照明強度を調整できます + +#### エクスポート（Export） + +![menu_export](./asset/menu_export.webp) + +このメニューは、モデルを他の形式（GLB、OBJ、STL）に変換・エクスポートできます + +### 3. 右側メニュー機能 + + + +右側メニューの主な2つの機能： + +1. **表示比率のリセット**：ボタンをクリックすると、設定した幅と高さに合わせてキャンバスの表示比率が調整されます +2. **ビデオ録画**：現在の3Dビュー操作をビデオとして録画し、インポートや後続ノードへの`recording_video`出力が可能です diff --git a/comfyui_embedded_docs/docs/Load3d/ko.md b/comfyui_embedded_docs/docs/Load3d/ko.md new file mode 100644 index 0000000..1fda86a --- /dev/null +++ b/comfyui_embedded_docs/docs/Load3d/ko.md @@ -0,0 +1,132 @@ +Load3D 노드는 3D 모델 파일을 불러오고 처리하는 핵심 노드입니다. 노드를 불러올 때 `ComfyUI/input/3d/` 폴더에서 사용 가능한 3D 리소스를 자동으로 가져오며, 업로드 기능을 통해 지원되는 3D 파일을 업로드하여 미리보기할 수도 있습니다. + +**지원 포맷** +현재 이 노드는 `.gltf`, `.glb`, `.obj`, `.fbx`, `.stl` 등 다양한 3D 파일 포맷을 지원합니다. + +**3D 노드 설정** +3D 노드와 관련된 일부 설정은 ComfyUI의 설정 메뉴에서 조정할 수 있습니다. 자세한 내용은 아래 문서를 참고하세요: + +[설정 메뉴](https://docs.comfy.org/interface/settings/3d) + +일반적인 노드 출력 외에도 Load3D에는 미리보기 영역 메뉴에 다양한 3D 뷰 관련 기능이 있습니다. + +## 입력 + +| 파라미터명 | 타입 | 설명 | 기본값 | 범위 | +|---------------|---------------|-------------------------------------------------------------|--------|--------------| +| model_file | File Selection | 3D 모델 파일 경로, 업로드 지원, 기본적으로 `ComfyUI/input/3d/`에서 파일을 읽음 | - | 지원 포맷 | +| width | INT | 캔버스 렌더링 너비 | 1024 | 1-4096 | +| height | INT | 캔버스 렌더링 높이 | 1024 | 1-4096 | + +## 출력 + +| 출력명 | 데이터 타입 | 설명 | +|-----------------|----------------|-------------------------------------------------------------| +| image | IMAGE | 캔버스에 렌더링된 이미지 | +| mask | MASK | 현재 모델 위치가 포함된 마스크 | +| mesh_path | STRING | 모델 파일 경로(`ComfyUI/input` 폴더 내 경로) | +| normal | IMAGE | 노멀 맵 | +| lineart | IMAGE | 라인아트 이미지 출력, `edge_threshold`는 캔버스의 모델 메뉴에서 조정 가능 | +| camera_info | LOAD3D_CAMERA | 카메라 정보 | +| recording_video | VIDEO | 녹화 영상(녹화가 있을 때만) | + +모든 출력 미리보기: +![뷰 조작 데모](./asset/load3d_outputs.webp) + +## 모델 캔버스(Canvas) 영역 설명 + +Load3D 노드의 Canvas 영역에는 다양한 뷰 조작 기능이 포함되어 있습니다: + +- 미리보기 뷰 설정(그리드, 배경색, 미리보기) +- 카메라 제어: FOV, 카메라 타입 조정 +- 전체 조명 강도: 조명 강도 조절 +- 비디오 녹화: 영상 녹화 및 내보내기 +- 모델 내보내기: `GLB`, `OBJ`, `STL` 포맷 지원 +- 기타 + +![Load 3D 노드 UI](./asset/load3d_ui.jpg) + +1. Load3D 노드의 여러 메뉴 및 숨겨진 메뉴 +2. 미리보기 창 크기 조정 및 캔버스 비디오 녹화 메뉴 +3. 3D 뷰 조작 축 +4. 미리보기 썸네일 +5. 미리보기 크기 설정, 크기를 설정한 후 창 크기를 조절해 미리보기 표시를 조정 + +### 1. 뷰 조작 + + + +뷰 조작 방법: + +- 마우스 왼쪽 클릭 + 드래그: 뷰 회전 +- 마우스 오른쪽 클릭 + 드래그: 뷰 이동 +- 마우스 휠 또는 가운데 클릭: 확대/축소 +- 좌표축: 뷰 전환 + +### 2. 왼쪽 메뉴 기능 + +![Menu](./asset/menu.webp) + +미리보기 영역에서는 일부 뷰 조작 관련 메뉴가 메뉴 버튼에 숨겨져 있습니다. 메뉴 버튼을 클릭하면 다양한 메뉴가 펼쳐집니다. + +- 1. 장면(Scene): 미리보기 창 그리드, 배경색, 썸네일 설정 +- 2. 모델(Model): 모델 렌더링 모드, 텍스처, 위 방향 설정 +- 3. 카메라(Camera): 직교 뷰와 원근 뷰 전환, 시야각(FOV) 설정 +- 4. 빛(Light): 전체 조명 강도 +- 5. 내보내기(Export): GLB, OBJ, STL 포맷으로 내보내기 + +#### 장면(Scene) + +![scene menu](./asset/menu_scene.webp) + +장면 메뉴는 장면의 기본 설정 기능을 제공합니다 + +1. 그리드 표시/숨기기 +2. 배경색 설정 +3. 배경 이미지 업로드 +4. 썸네일 숨기기 + +#### 모델(Model) + +![Menu_Scene](./asset/menu_model.webp) + +모델 메뉴는 모델 관련 기능을 제공합니다 + +1. **위 방향(Up direction)**: 모델의 어느 축이 위 방향인지 지정 +2. **렌더링 모드(Material mode)**: 원본, 노멀, 와이어프레임, 라인아트 전환 + +#### 카메라(Camera) + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +이 메뉴는 직교 뷰와 원근 뷰 전환, 시야각(FOV) 설정을 제공합니다 + +1. **카메라(Camera)**: 직교 뷰와 원근 뷰 전환 +2. **FOV**: 시야각 조절 + +#### 빛(Light) + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +이 메뉴에서 전체 조명 강도를 빠르게 조절할 수 있습니다 + +#### 내보내기(Export) + +![menu_export](./asset/menu_export.webp) + +이 메뉴는 모델을 다른 포맷(GLB, OBJ, STL)으로 변환 및 내보내기 기능을 제공합니다 + +### 3. 오른쪽 메뉴 기능 + + + +오른쪽 메뉴의 주요 기능 두 가지: + +1. **뷰 비율 재설정**: 버튼을 클릭하면 설정한 너비와 높이에 맞춰 캔버스 비율이 조정됩니다 +2. **비디오 녹화**: 현재 3D 뷰 조작을 비디오로 녹화하고, 불러오기 및 후속 노드에 `recording_video`로 출력할 수 있습니다 diff --git a/comfyui_embedded_docs/docs/Load3d/ru.md b/comfyui_embedded_docs/docs/Load3d/ru.md new file mode 100644 index 0000000..b64d23e --- /dev/null +++ b/comfyui_embedded_docs/docs/Load3d/ru.md @@ -0,0 +1,132 @@ +Узел Load3D — это основной узел для загрузки и обработки 3D-модельных файлов. При загрузке узла автоматически получаются доступные 3D-ресурсы из папки `ComfyUI/input/3d/`. Также вы можете загрузить поддерживаемые 3D-файлы для предварительного просмотра с помощью функции загрузки. + +**Поддерживаемые форматы** +В настоящее время этот узел поддерживает несколько форматов 3D-файлов, включая `.gltf`, `.glb`, `.obj`, `.fbx` и `.stl`. + +**Настройки 3D-узла** +Некоторые параметры, связанные с 3D-узлами, можно настроить в меню настроек ComfyUI. Подробнее смотрите в следующей документации: + +[Меню настроек](https://docs.comfy.org/interface/settings/3d) + +Помимо обычных выходных данных, Load3D имеет множество настроек, связанных с 3D-просмотром, в меню области предпросмотра. + +## Входы + +| Имя параметра | Тип | Описание | По умолчанию | Диапазон | +|--------------|--------------|------------------------------------------------------------------|--------------|-----------------| +| model_file | File Selection | Путь к файлу 3D-модели, поддерживает загрузку, по умолчанию читает из `ComfyUI/input/3d/` | - | Поддерживаемые форматы | +| width | INT | Ширина рендеринга холста | 1024 | 1-4096 | +| height | INT | Высота рендеринга холста | 1024 | 1-4096 | + +## Выходы + +| Имя выхода | Тип данных | Описание | +|------------------|----------------|-----------------------------------------------------------------| +| image | IMAGE | Изображение, отрендеренное на холсте | +| mask | MASK | Маска, содержащая текущую позицию модели | +| mesh_path | STRING | Путь к файлу модели (в папке `ComfyUI/input`) | +| normal | IMAGE | Карта нормалей | +| lineart | IMAGE | Выход изображения лайнарт, `edge_threshold` регулируется в меню модели на холсте | +| camera_info | LOAD3D_CAMERA | Информация о камере | +| recording_video | VIDEO | Записанное видео (только если запись существует) | + +Предварительный просмотр всех выходов: +![Демонстрация управления видом](./asset/load3d_outputs.webp) + +## Описание области Canvas + +Область Canvas узла Load3D содержит множество операций с видом, включая: + +- Настройки предпросмотра (сетка, цвет фона, предпросмотр) +- Управление камерой: FOV, тип камеры +- Интенсивность глобального освещения: регулировка яркости +- Запись видео: запись и экспорт видео +- Экспорт модели: поддержка форматов `GLB`, `OBJ`, `STL` +- и др. + +![Интерфейс узла Load 3D](./asset/load3d_ui.jpg) + +1. Содержит несколько меню и скрытых меню узла Load 3D +2. Меню для изменения размера окна предпросмотра и записи видео Canvas +3. Ось управления 3D-вида +4. Миниатюра предпросмотра +5. Настройка размера предпросмотра, масштабирование предпросмотра путем установки размеров и изменения размера окна + +### 1. Операции с видом + + + +Операции управления видом: + +- ЛКМ + перетаскивание: вращение вида +- ПКМ + перетаскивание: перемещение вида +- Колесо мыши или средняя кнопка: масштабирование +- Ось координат: переключение видов + +### 2. Функции левого меню + +![Menu](./asset/menu.webp) + +В области предпросмотра некоторые меню, связанные с управлением видом, скрыты в меню. Нажмите кнопку меню, чтобы развернуть различные меню + +- 1. Сцена (Scene): сетка окна предпросмотра, цвет фона, настройки миниатюры +- 2. Модель (Model): режим рендеринга модели, текстуры, настройка направления вверх +- 3. Камера (Camera): переключение между ортографическим и перспективным видом, настройка угла обзора +- 4. Свет (Light): интенсивность глобального освещения сцены +- 5. Экспорт (Export): экспорт модели в другие форматы (GLB, OBJ, STL) + +#### Сцена (Scene) + +![scene menu](./asset/menu_scene.webp) + +Меню Сцена предоставляет базовые функции настройки сцены + +1. Показать/скрыть сетку +2. Установить цвет фона +3. Загрузить фоновое изображение +4. Скрыть миниатюру предпросмотра + +#### Модель (Model) + +![Menu_Scene](./asset/menu_model.webp) + +Меню Модель предоставляет функции, связанные с моделью + +1. **Направление вверх (Up direction)**: определяет, какая ось является верхней для модели +2. **Режим материала (Material mode)**: переключение режимов рендеринга — Оригинал, Нормальный, Каркас, Лайнарт + +#### Камера (Camera) + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +Это меню позволяет переключаться между ортографическим и перспективным видом, а также настраивать угол обзора + +1. **Камера (Camera)**: быстрое переключение между ортографическим и перспективным видом +2. **FOV**: настройка угла обзора + +#### Свет (Light) + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +Через это меню можно быстро отрегулировать интенсивность глобального освещения сцены + +#### Экспорт (Export) + +![menu_export](./asset/menu_export.webp) + +Это меню позволяет быстро конвертировать и экспортировать форматы моделей + +### 3. Функции правого меню + + + +Правое меню имеет две основные функции: + +1. **Сбросить соотношение вида**: после нажатия кнопки вид будет подстроен под заданные ширину и высоту +2. **Запись видео**: позволяет записывать текущие операции с 3D-видами в видео, поддерживает импорт и может быть выведено как `recording_video` для последующих узлов diff --git a/comfyui_embedded_docs/docs/Load3d/zh.md b/comfyui_embedded_docs/docs/Load3d/zh.md new file mode 100644 index 0000000..306b6d2 --- /dev/null +++ b/comfyui_embedded_docs/docs/Load3d/zh.md @@ -0,0 +1,131 @@ +Load3D 节点用于加载和处理 3D 模型文件的核心节点，在加载节点时会自动获取 `ComfyUI/input/3d/` 可用的 3D 资源，你也可以通过上传功能将受支持的 3D 文件上传然后进行预览。 + +**支持格式** +目前该节点支持多种 3D 文件格式，包括 `.gltf`、`.glb`、`.obj`、`.fbx` 和 `.stl`。 + +**3D 节点预设** +3D 节点的一些相关偏好设置可以在 ComfyUI 的设置菜单中进行设置，请参考下面的文档了解对应的设置 +[设置菜单](https://docs.comfy.org/zh-CN/interface/settings/3d) + +除了常规的节点输出之外， Load3D 有许多相关的 3D 视图相关操作是位于预览区域菜单, 3D 节点 + +## 输入 + +| 参数名 | 类型 | 描述 | 默认值 | 范围 | +|--------------|------------|--------------------------|--------|--------------| +| 模型文件 | 文件选择 | 3D 模型文件路径，支持上传，默认读取 `ComfyUI/input/3d/` 下的模型文件 | - | 受支持格式文件 | +| 宽度 | INT | 画布渲染宽度 | 1024 | 1-4096 | +| 高度 | INT | 画布渲染高度 | 1024 | 1-4096 | + +## 输出 + +| 参数名称 | 数据类型 | 说明 | +| --------------- | ------------- | -------------------------------- | +| image | IMAGE | 画布渲染渲染图像 | +| mask | MASK | 包含当前模型位置的遮罩 | +| mesh_path | STRING | 模型文件路径在`ComfyUI/input` 文件夹下的路径 | +| normal | IMAGE | 法线贴图 | +| lineart | IMAGE | 线稿图像输出，对应的 `edge_threshold` 可在画布的模型菜单中进行调节 | +| camera_info | LOAD3D_CAMERA | 相机信息 | +| recording_video | VIDEO | 录制视频（仅当有录制视频存在时） | + +对应所有的输出预览如下： +![视图操作演示](./asset/load3d_outputs.webp) + +## 模型画布(Canvas)区说明 + +Load 3D 节点的 Canvas 区域包含了诸多的视图操作，包括： + +- 预览视图设置（网格、背景色、预览视图） +- 相机控制: 控制FOV、相机类型 +- 全局光照强度: 调节光照强度 +- 视频录制: 录制视频并导出视频 +- 模型导出: 支持`GLB`、`OBJ`、`STL` 格式 +- 等 + +![Load 3D 节点UI](./asset/load3d_ui.jpg) + +1. 包含了 Load 3D 节点的多个菜单以及隐藏菜单 +2. 重新`缩放预览窗口大小`以及进行`画布视频录制`菜单 +3. 3D 视图操作轴 +4. 预览缩略图 +5. 预览尺寸设置，通过设置尺寸然后再缩放窗口大小来缩放预览视图显示 + +### 1. 视图操作 + + + +视图控制操作： + +- 鼠标左键点击 + 拖拽： 视图旋转控制 +- 鼠标右键 + 拖拽： 平移视图 +- 鼠标中键： 缩放控制 +- 坐标轴： 切换视图 + +### 2. 左侧菜单功能 + +![Menu](./asset/menu.webp) + +在预览区域，有些视图操作相关的菜单被隐藏在了菜单里，点击菜单按钮可以展开对应不同的菜单 + +- 1. 场景（Scene）: 包含预览窗口网格、背景色、缩略图设置 +- 2. 模型（Model）: 模型渲染模式、纹理材质、上方向设置 +- 3. 摄像机（Camera）: 轴测视图和透视视图切换、透视视角大小设置 +- 4. 灯光（Light）: 场景全局光照强度 +- 5. 导出（Export）: 导出模型为其它格式（GLB、OBJ、STL） + +#### 场景（Scene） + +![scene menu](./asset/menu_scene.webp) + +场景菜单提供了对场景的一些基础设置功能 + +1. 显示 / 隐藏网格 +2. 设置背景色 +3. 点击上传设置背景图片 +4. 隐藏缩略预览图 + +#### 模型(Model) + +![Menu_Scene](./asset/menu_model.webp) + +模型菜单提供了一些模型的相关功能 + +1. **上方向(Up direction)**: 确定模型的哪个轴为上方向 +2. **渲染模式（Material mode）**: 模型渲染模式切换 原始（Original）、法线(Normal)、线框(Wireframe)、线稿(Lineart) + +#### 摄像机（Camera） + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +该菜单提供了轴测视图和透视视图切换、透视视角大小设置 + +1. **相机（Camera）**: 在轴测视图和正交视图之间快速切换 +2. **视场角(FOV)**: 调整 FOV 视角角度 + +#### 灯光（Light） + +![menu_modelmenu_camera](./asset/menu_modelmenu_camera.webp) + +通过该菜单可以快速调节模型场景的全局光照强度 + +#### 导出（Export） + +![menu_export](./asset/menu_export.webp) + +该菜单提供了一个快速转换模型格式并导出的能力 + +### 3. 右侧菜单功能 + + + +右侧菜单的两个主要功能为： + +1. **重设视图比例**： 点击按钮后视图将根据设定好的宽高按比例调整画布渲染区域比例 +2. **视频录制**： 允许你将当前的 3D 视图操作录制为视频，允许导入，并可以作为 `recording_video` 输出给后续节点