From bd337bc8951494772d8a24c83f851a2968c75456 Mon Sep 17 00:00:00 2001 From: ComfyUI Wiki Date: Thu, 21 May 2026 09:57:43 +0800 Subject: [PATCH 1/2] Restore 3D node docs with images and correct parameter tables. Revert Load3D, Load3DAnimation, Preview3D, and Preview3DAnimation documentation to the v0.4.4 content across all languages, recovering screenshots, canvas guides, and output descriptions corrupted by later AI rewrites and i18n alignment. --- comfyui_embedded_docs/docs/Load3D/ar.md | 110 ++++++----- comfyui_embedded_docs/docs/Load3D/en.md | 2 +- comfyui_embedded_docs/docs/Load3D/es.md | 150 +++++++-------- comfyui_embedded_docs/docs/Load3D/fa.md | 10 +- comfyui_embedded_docs/docs/Load3D/fr.md | 134 +++++++------ comfyui_embedded_docs/docs/Load3D/ja.md | 151 ++++++++------- comfyui_embedded_docs/docs/Load3D/ko.md | 148 +++++++------- comfyui_embedded_docs/docs/Load3D/pt-BR.md | 92 ++++----- comfyui_embedded_docs/docs/Load3D/ru.md | 140 +++++++------- comfyui_embedded_docs/docs/Load3D/tr.md | 86 ++++----- comfyui_embedded_docs/docs/Load3D/zh-TW.md | 96 +++++---- comfyui_embedded_docs/docs/Load3D/zh.md | 151 +++++++-------- .../docs/Load3DAnimation/ar.md | 122 ++++++------ .../docs/Load3DAnimation/en.md | 14 +- .../docs/Load3DAnimation/es.md | 182 ++++++++---------- .../docs/Load3DAnimation/fa.md | 14 +- .../docs/Load3DAnimation/fr.md | 146 +++++++------- .../docs/Load3DAnimation/ja.md | 157 ++++++++------- .../docs/Load3DAnimation/ko.md | 152 +++++++-------- .../docs/Load3DAnimation/pt-BR.md | 98 +++++----- .../docs/Load3DAnimation/ru.md | 142 +++++++------- .../docs/Load3DAnimation/tr.md | 110 ++++++----- .../docs/Load3DAnimation/zh-TW.md | 106 +++++----- .../docs/Load3DAnimation/zh.md | 159 ++++++++------- comfyui_embedded_docs/docs/Preview3D/ar.md | 94 ++++----- comfyui_embedded_docs/docs/Preview3D/en.md | 14 +- comfyui_embedded_docs/docs/Preview3D/es.md | 106 +++++----- comfyui_embedded_docs/docs/Preview3D/fa.md | 14 +- comfyui_embedded_docs/docs/Preview3D/fr.md | 104 +++++----- comfyui_embedded_docs/docs/Preview3D/ja.md | 114 ++++++----- comfyui_embedded_docs/docs/Preview3D/ko.md | 143 ++++++++------ comfyui_embedded_docs/docs/Preview3D/pt-BR.md | 72 +++---- comfyui_embedded_docs/docs/Preview3D/ru.md | 104 +++++----- comfyui_embedded_docs/docs/Preview3D/tr.md | 80 ++++---- comfyui_embedded_docs/docs/Preview3D/zh-TW.md | 86 +++++---- comfyui_embedded_docs/docs/Preview3D/zh.md | 114 ++++++----- .../docs/Preview3DAnimation/ar.md | 96 ++++----- .../docs/Preview3DAnimation/en.md | 14 +- .../docs/Preview3DAnimation/es.md | 104 +++++----- .../docs/Preview3DAnimation/fa.md | 14 +- .../docs/Preview3DAnimation/fr.md | 104 +++++----- .../docs/Preview3DAnimation/ja.md | 110 +++++------ .../docs/Preview3DAnimation/ko.md | 143 ++++++++------ .../docs/Preview3DAnimation/pt-BR.md | 70 +++---- .../docs/Preview3DAnimation/ru.md | 106 +++++----- .../docs/Preview3DAnimation/tr.md | 92 ++++----- .../docs/Preview3DAnimation/zh-TW.md | 82 ++++---- .../docs/Preview3DAnimation/zh.md | 114 ++++++----- 48 files changed, 2353 insertions(+), 2413 deletions(-) diff --git a/comfyui_embedded_docs/docs/Load3D/ar.md b/comfyui_embedded_docs/docs/Load3D/ar.md index ca3e9de5c..02cec68bf 100644 --- a/comfyui_embedded_docs/docs/Load3D/ar.md +++ b/comfyui_embedded_docs/docs/Load3D/ar.md @@ -1,85 +1,83 @@ -> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3D/ar.md) +> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3D/ar.md) -بالتأكيد، إليك الترجمة العربية للوثيقة التقنية الخاصة بعقدة ComfyUI، مع الالتزام التام بقواعد الترجمة المحددة: - -عقدة تحميل النماذج ثلاثية الأبعاد (Load3D) هي عقدة أساسية لتحميل ومعالجة ملفات النماذج ثلاثية الأبعاد. عند تحميل العقدة، تقوم تلقائياً بجلب الموارد ثلاثية الأبعاد المتاحة من المسار `ComfyUI/input/3d/`. يمكنك أيضاً رفع ملفات ثلاثية الأبعاد مدعومة للمعاينة باستخدام وظيفة الرفع. +عُقدة Load3D هي عُقدة أساسية لتحميل ومعالجة ملفات النماذج ثلاثية الأبعاد. عند تحميل العُقدة، تسترجع تلقائيًا موارد ثلاثية الأبعاد متاحة من `ComfyUI/input/3d/`. يمكنك أيضًا رفع ملفات ثلاثية الأبعاد مدعومة للمعاينة باستخدام وظيفة الرفع. **الصيغ المدعومة** -حالياً، تدعم هذه العقدة صيغ ملفات ثلاثية الأبعاد متعددة، بما في ذلك `.gltf` و `.glb` و `.obj` و `.fbx` و `.stl`. +تدعم هذه العُقدة حاليًا صيغ ملفات ثلاثية الأبعاد متعددة، بما في ذلك `.gltf`، و`.glb`، و`.obj`، و`.fbx`، و`.stl`. -**تفضيلات العقد ثلاثية الأبعاد** -يمكن تكوين بعض التفضيلات ذات الصلة بالعقد ثلاثية الأبعاد في قائمة إعدادات ComfyUI. يرجى الرجوع إلى الوثائق التالية للإعدادات المقابلة: +**تفضيلات العُقد ثلاثية الأبعاد** +يمكن تكوين بعض التفضيلات المتعلقة بالعُقد ثلاثية الأبعاد في قائمة إعدادات ComfyUI. يرجى الرجوع إلى الوثائق التالية للإعدادات المقابلة: [قائمة الإعدادات](https://docs.comfy.org/interface/settings/3d) -بالإضافة إلى مخرجات العقدة المعتادة، تحتوي عقدة تحميل النماذج ثلاثية الأبعاد (Load3D) على العديد من الإعدادات المتعلقة بعرض المنظور ثلاثي الأبعاد في قائمة اللوحة. +إلى جانب مخرجات العُقد العادية، تمتلك Load3D العديد من الإعدادات المتعلقة بعرض المشاهد ثلاثية الأبعاد في قائمة لوحة الرسم. ## المدخلات -| اسم المعامل | النوع | الوصف | القيمة الافتراضية | النطاق | -|---------------|----------|---------------------------------|---------|--------------| -| model_file | اختيار ملف | مسار ملف النموذج ثلاثي الأبعاد، يدعم الرفع، ويقرأ افتراضياً ملفات النموذج من `ComfyUI/input/3d/` | - | الصيغ المدعومة | -| width | INT | عرض عرض اللوحة | 1024 | 1-4096 | -| height | INT | ارتفاع عرض اللوحة | 1024 | 1-4096 | +| اسم المعامل | النوع | الوصف | الافتراضي | النطاق | +|------------------|--------------|-----------------------------------------------------------|-----------|---------------| +| model_file | File Selection | مسار ملف النموذج ثلاثي الأبعاد، يدعم الرفع، ويقرأ افتراضيًا ملفات النماذج من `ComfyUI/input/3d/` | - | الصيغ المدعومة | +| width | INT | عرض عرض لوحة الرسم | 1024 | 1-4096 | +| height | INT | ارتفاع عرض لوحة الرسم | 1024 | 1-4096 | ## المخرجات -| اسم المعامل | نوع البيانات | الوصف | -|-----------------|----------------|------------------------------------| -| image | IMAGE | الصورة المقدمة من اللوحة | -| mask | MASK | قناع يحتوي على موضع النموذج الحالي | -| mesh_path | STRING | مسار ملف النموذج | -| normal | IMAGE | خريطة الاتجاهات الطبيعية | -| lineart | IMAGE | مخرجات صورة الرسم الخطي، يمكن ضبط `edge_threshold` المقابل في قائمة نموذج اللوحة | -| camera_info | LOAD3D_CAMERA | معلومات الكاميرا | -| recording_video | VIDEO | الفيديو المسجل (فقط عند وجود تسجيل) | +| اسم المعامل | نوع البيانات | الوصف | +|------------------|--------------|------------------------------------------------------------| +| image | IMAGE | صورة عرض لوحة الرسم | +| mask | MASK | قناع يحتوي على موضع النموذج الحالي | +| mesh_path | STRING | مسار ملف النموذج | +| normal | IMAGE | خريطة الأسطح الطبيعية (Normal Map) | +| lineart | IMAGE | إخراج صورة الرسم الخطي، يمكن ضبط `edge_threshold` المقابل في قائمة النموذج بلوحة الرسم | +| camera_info | LOAD3D_CAMERA | معلومات الكاميرا | +| recording_video | VIDEO | الفيديو المسجل (فقط عند وجود تسجيل) | -معاينة جميع المخرجات: -![عرض توضيحي للعملية](./asset/load3d_outputs.webp) +معاينة لجميع المخرجات: +![عرض تجريبي للعمليات](./asset/load3d_outputs.webp) -## وصف منطقة اللوحة +## وصف منطقة لوحة الرسم -تحتوي منطقة اللوحة الخاصة بعقدة تحميل النماذج ثلاثية الأبعاد (Load3D) على العديد من عمليات العرض، بما في ذلك: +تحتوي منطقة لوحة الرسم في عُقدة Load3D على العديد من عمليات العرض، بما في ذلك: - إعدادات عرض المعاينة (الشبكة، لون الخلفية، عرض المعاينة) -- التحكم في الكاميرا: التحكم في مجال الرؤية (FOV)، نوع الكاميرا -- شدة الإضاءة العامة: ضبط شدة الإضاءة +- تحكم الكاميرا: التحكم في مجال الرؤية (FOV)، نوع الكاميرا +- شدة الإضاءة العالمية: ضبط شدة الإضاءة - تسجيل الفيديو: تسجيل وتصدير مقاطع الفيديو -- تصدير النموذج: يدعم صيغ `GLB` و `OBJ` و `STL` +- تصدير النموذج: يدعم صيغ `GLB`، و`OBJ`، و`STL` - والمزيد -![واجهة مستخدم عقدة تحميل النماذج ثلاثية الأبعاد](./asset/load3d_ui.jpg) +![واجهة مستخدم عُقدة Load 3D](./asset/load3d_ui.jpg) -1. يحتوي على قوائم متعددة وقوائم مخفية لعقدة تحميل النماذج ثلاثية الأبعاد (Load 3D) -2. قائمة `تغيير حجم نافذة المعاينة` و `تسجيل فيديو اللوحة` -3. محور تشغيل العرض ثلاثي الأبعاد +1. يحتوي على قوائم متعددة وقوائم مخفية لعُقدة Load 3D +2. قائمة `تغيير حجم نافذة المعاينة` و`تسجيل فيديو لوحة الرسم` +3. محور عمليات العرض ثلاثي الأبعاد 4. صورة مصغرة للمعاينة -5. إعدادات حجم المعاينة، قياس عرض المعاينة عن طريق ضبط الأبعاد ثم تغيير حجم النافذة +5. إعدادات حجم المعاينة، قم بتغيير مقياس عرض المعاينة عن طريق تعيين الأبعاد ثم تغيير حجم النافذة ### 1. عمليات العرض عمليات التحكم في العرض: -- النقر بزر الفأرة الأيسر + السحب: تدوير العرض -- النقر بزر الفأرة الأيمن + السحب: تحريك العرض -- تمرير العجلة الوسطى أو النقر بزر الفأرة الأوسط + السحب: تكبير/تصغير -- محور الإحداثيات: تبديل طرق العرض +- النقر الأيسر + السحب: تدوير العرض +- النقر الأيمن + السحب: نقل العرض +- تمرير عجلة鼠标 الوسط أو النقر الأوسط + السحب: التكبير/التصغير +- محور الإحداثيات: تبديل العروض ### 2. وظائف القائمة اليسرى ![القائمة](./asset/menu.webp) -في اللوحة، بعض الإعدادات مخفية في القائمة. انقر على زر القائمة لتوسيع قوائم مختلفة +في لوحة الرسم، تكون بعض الإعدادات مخفية في القائمة. انقر على زر القائمة لتوسيع القوائم المختلفة - 1. المشهد: يحتوي على شبكة نافذة المعاينة، لون الخلفية، إعدادات المعاينة -- 2. النموذج: وضع عرض النموذج، مواد النسيج، إعدادات الاتجاه العلوي -- 3. الكاميرا: التبديل بين العرض المتعامد والمنظوري، وضبط حجم زاوية المنظور -- 4. الإضاءة: شدة الإضاءة العامة للمشهد +- 2. النموذج: وضع عرض النموذج، مواد الأسطح، إعدادات اتجاه الأعلى +- 3. الكاميرا: التبديل بين وضعي العرض المتوازي والمنظوري، وتعيين حجم زاوية المنظور +- 4. الضوء: شدة الإضاءة العالمية للمشهد - 5. التصدير: تصدير النموذج إلى صيغ أخرى (GLB, OBJ, STL) #### المشهد @@ -99,38 +97,38 @@ توفر قائمة النموذج بعض الوظائف المتعلقة بالنموذج -1. **الاتجاه العلوي**: تحديد المحور الذي يمثل الاتجاه العلوي للنموذج -2. **وضع المواد**: تبديل أوضاع عرض النموذج - أصلي، عادي، إطار سلكي، رسم خطي +1. **اتجاه الأعلى**: تحديد أي محور هو اتجاه الأعلى للنموذج +2. **وضع المادة**: تبديل أوضاع عرض النموذج - الأصلي، الطبيعي، الهيكل السلكي، الرسم الخطي #### الكاميرا ![قائمة الكاميرا](./asset/menu_camera.webp) -توفر هذه القائمة التبديل بين العرض المتعامد والمنظوري، وإعدادات حجم زاوية المنظور +توفر هذه القائمة التبديل بين وضعي العرض المتوازي والمنظوري، وإعدادات حجم زاوية المنظور -1. **الكاميرا**: التبديل السريع بين العرض المتعامد والعرض المتعامد +1. **الكاميرا**: التبديل السريع بين وضعي العرض المتوازي والمنظوري 2. **مجال الرؤية (FOV)**: ضبط زاوية مجال الرؤية -#### الإضاءة +#### الضوء -![قائمة الإضاءة](./asset/menu_light.webp) +![قائمة الضوء](./asset/menu_light.webp) -من خلال هذه القائمة، يمكنك ضبط شدة الإضاءة العامة للمشهد بسرعة +من خلال هذه القائمة، يمكنك ضبط شدة الإضاءة العالمية للمشهد بسرعة #### التصدير ![قائمة التصدير](./asset/menu_export.webp) -توفر هذه القائمة إمكانية تحويل وتصدير صيغ النموذج بسرعة +توفر هذه القائمة القدرة على تحويل وتصدير صيغ النماذج بسرعة ### 3. وظائف القائمة اليمنى -للقائمة اليمنى وظيفتان رئيسيتان: +تحتوي القائمة اليمنى على وظيفتين رئيسيتين: -1. **إعادة تعيين نسبة العرض**: بعد النقر على الزر، ستقوم نافذة العرض بضبط نسبة منطقة عرض اللوحة وفقاً للعرض والارتفاع المحددين -2. **تسجيل الفيديو**: يتيح لك تسجيل عمليات العرض ثلاثي الأبعاد الحالية كفيديو، ويسمح بالاستيراد، ويمكن إخراجه كـ `recording_video` إلى العقد اللاحقة \ No newline at end of file +1. **إعادة تعيين نسبة العرض**: بعد النقر على الزر، سيقوم العرض بضبط نسبة منطقة عرض لوحة الرسم وفقًا للعرض والارتفاع المحددين +2. **تسجيل الفيديو**: يسمح لك بتسجيل عمليات العرض ثلاثي الأبعاد الحالية كفيديو، يسمح بالاستيراد، ويمكن إخراجه كـ `recording_video` إلى العُقد اللاحقة diff --git a/comfyui_embedded_docs/docs/Load3D/en.md b/comfyui_embedded_docs/docs/Load3D/en.md index 7787d6821..157b71370 100644 --- a/comfyui_embedded_docs/docs/Load3D/en.md +++ b/comfyui_embedded_docs/docs/Load3D/en.md @@ -122,7 +122,7 @@ This menu provides the ability to quickly convert and export model formats ### 3. Right Menu Functions diff --git a/comfyui_embedded_docs/docs/Load3D/es.md b/comfyui_embedded_docs/docs/Load3D/es.md index 34b0e0f19..6d5ae17d4 100644 --- a/comfyui_embedded_docs/docs/Load3D/es.md +++ b/comfyui_embedded_docs/docs/Load3D/es.md @@ -1,62 +1,58 @@ -> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Load3D/es.md) +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. -Aquí tienes la traducción al español de la documentación del nodo Load3D, siguiendo todas las reglas establecidas: +**Formatos soportados** +Actualmente, este nodo soporta varios formatos de archivos 3D, incluyendo `.gltf`, `.glb`, `.obj`, `.fbx` y `.stl`. -El nodo Load3D es un nodo principal para cargar y procesar archivos de modelos 3D. Al cargar el nodo, este recupera automáticamente los recursos 3D disponibles de `ComfyUI/input/3d/`. También puedes subir archivos 3D compatibles para previsualizarlos usando la función de carga. +**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: -**Formatos compatibles** -Actualmente, este nodo admite múltiples formatos de archivo 3D, incluyendo `.gltf`, `.glb`, `.obj`, `.fbx` y `.stl`. +[Menú de configuración](https://docs.comfy.org/interface/settings/3d) -**Preferencias de nodos 3D** -Algunas preferencias relacionadas con los nodos 3D se pueden configurar en el menú de ajustes de ComfyUI. Consulta la siguiente documentación para las configuraciones correspondientes: - -[Menú de Ajustes](https://docs.comfy.org/interface/settings/3d) - -Además de las salidas regulares del nodo, Load3D tiene muchas configuraciones relacionadas con la vista 3D en el menú del lienzo. +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 | Por Defecto | Rango | -|---------------|----------|---------------------------------|---------|--------------| -| model_file | Selección de Archivo | Ruta del archivo de modelo 3D, admite carga, por defecto lee archivos de modelo de `ComfyUI/input/3d/` | - | Formatos compatibles | -| width | INT | Ancho de renderizado del lienzo | 1024 | 1-4096 | -| height | INT | Alto de renderizado del lienzo | 1024 | 1-4096 | +| 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 del Parámetro | Tipo de Dato | Descripción | -|-----------------|----------------|------------------------------------| -| image | IMAGE | Imagen renderizada del lienzo | -| mask | MASK | Máscara que contiene la posición actual del modelo | -| mesh_path | STRING | Ruta del archivo del modelo | -| normal | IMAGE | Mapa de normales | -| lineart | IMAGE | Salida de imagen de arte lineal, el `edge_threshold` correspondiente se puede ajustar en el menú del modelo del lienzo | -| camera_info | LOAD3D_CAMERA | Información de la cámara | -| recording_video | VIDEO | Video grabado (solo cuando existe una grabación) | +| 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 operación de vista](./asset/load3d_outputs.webp) +![Demostración de operaciones de vista](./asset/load3d_outputs.webp) -## Descripción del Área del Lienzo +## Descripción del área de lienzo (Canvas) -El área del Lienzo del nodo Load3D contiene numerosas operaciones de vista, incluyendo: +El área Canvas del nodo Load3D contiene numerosas operaciones de vista, incluyendo: -- Configuraciones 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: Compatible con formatos `GLB`, `OBJ`, `STL` -- Y más +- 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. -![Interfaz de usuario del nodo Load 3D](./asset/load3d_ui.jpg) +![UI del nodo Load 3D](./asset/load3d_ui.jpg) -1. Contiene múltiples menús y menús ocultos del nodo Load 3D -2. Menú para `redimensionar la ventana de vista previa` y `grabación de video del lienzo` -3. Eje de operación de la vista 3D -4. Miniatura de vista previa -5. Configuraciones de tamaño de vista previa, escala la visualización de la vista previa estableciendo dimensiones y luego redimensionando la ventana +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 +### 1. Operaciones de vista