# ذخیره تصویر (پیشرفته)

گره **Save Image (Advanced)** تصاویر ورودی را در پوشه خروجی ComfyUI شما ذخیره می‌کند و کنترل پیشرفته‌ای روی قالب فایل، عمق بیت و فضای رنگ فراهم می‌کند. از ذخیره به‌صورت فایل‌های PNG، EXR یا AVIF (شامل AVIF متحرک) پشتیبانی می‌کند و می‌تواند فراداده گردش‌کار را در فایل‌های ذخیره‌شده جاسازی کند.

## ورودی‌ها

### ورودی‌های مشترک

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
| --- | --- | --- | --- | --- |
| `تصاویر` | تصاویری که باید ذخیره شوند. | IMAGE | بله | - |
| `پیشوند نام فایل` | پیشوند فایل برای ذخیره. ممکن است شامل نشانه‌های قالب‌بندی مانند `%date:yyyy-MM-dd%` یا `%Empty Latent Image.width%` باشد. (پیش‌فرض: "ComfyUI") | STRING | بله | - |
| `فرمت` | قالب فایلی که تصویر در آن ذخیره می‌شود. انتخاب یک قالب، گزینه‌های اضافی آن قالب را نمایش می‌دهد. | DYNAMIC_COMBO | بله | `"png"`<br>`"exr"`<br>`"avif"` |

### ورودی‌های PNG

این گزینه‌ها زمانی ظاهر می‌شوند که `format` روی `"png"` تنظیم شده باشد.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
| --- | --- | --- | --- | --- |
| `bit_depth` | عمق بیت برای فایل PNG ذخیره‌شده. (پیش‌فرض: "8-bit") | COMBO | بله (شرطی) | `"8-bit"`<br>`"16-bit"` |
| `input_color_space` | فضای رنگ تنسور ورودی. برای قالب PNG فقط sRGB در دسترس است. (پیش‌فرض: "sRGB") | COMBO | بله (شرطی) | `"sRGB"` |

### ورودی‌های EXR

این گزینه‌ها زمانی ظاهر می‌شوند که `format` روی `"exr"` تنظیم شده باشد.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
| --- | --- | --- | --- | --- |
| `bit_depth` | عمق بیت برای فایل EXR ذخیره‌شده. (پیش‌فرض: "16-bit float") | COMBO | بله (شرطی) | `"16-bit float"`<br>`"32-bit float"` |
| `input_color_space` | فضای رنگ تنسور ورودی. EXR همیشه به‌صورت خطی صحنه در گاموت منطبق نوشته می‌شود.<br>`"sRGB"` — ورودی، Rec.709 کدگذاری‌شده با sRGB است؛ EOTF معکوس sRGB اعمال می‌شود.<br>`"HDR"` — ورودی، Rec.2020 (BT.2100) کدگذاری‌شده با HLG است؛ OETF معکوس HLG برای به‌دست‌آوردن نور خطی صحنه اعمال می‌شود.<br>`"linear"` — ورودی از قبل خطی صحنه است (پرایمری‌های Rec.709)؛ بدون تغییر نوشته می‌شود. از این گزینه برای خروجی رندرر/کامپوزیتور استفاده کنید.<br>`"linear ACEScg"` — ورودی از قبل ACEScg صحنه‌خطی (AP1 / D60) است؛ با مختصات رنگی ACEScg بدون تغییر نوشته می‌شود. (پیش‌فرض: "sRGB") | COMBO | بله (شرطی) | `"sRGB"`<br>`"HDR"`<br>`"linear"`<br>`"linear ACEScg"` |

### ورودی‌های AVIF

این گزینه‌ها زمانی ظاهر می‌شوند که `format` روی `"avif"` تنظیم شده باشد.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
| --- | --- | --- | --- | --- |
| `bit_depth` | عمق بیت برای فایل AVIF ذخیره‌شده. حالت خودکار برای sRGB از YUV420 8بیتی و برای HDR از YUV420 10بیتی استفاده می‌کند. (پیش‌فرض: "auto") | COMBO | بله (شرطی) | `"auto"`<br>`"8-bit YUV420"`<br>`"10-bit YUV420"` |
| `input_color_space` | فضای رنگ تصاویر ورودی. HDR گزینه BT.2020/HLG و HDR PQ گزینه BT.2020/PQ را انتخاب می‌کند. (پیش‌فرض: "sRGB") | COMBO | بله (شرطی) | `"sRGB"`<br>`"HDR"`<br>`"HDR PQ"` |
| `crf` | مقادیر پایین‌تر کیفیت بالاتر و فایل‌های بزرگ‌تر تولید می‌کنند. (پیش‌فرض: 18) | INT | بله (شرطی) | 1 تا 63 |
| `save_mode` | حالت ذخیره برای فایل AVIF. `"still images"` هر تصویر در دسته را به‌صورت یک فایل ثابت جداگانه ذخیره می‌کند؛ `"animated"` کل دسته را به‌صورت یک فایل AVIF متحرک ذخیره می‌کند و `fps` و `loop_count` را نمایان می‌کند. (پیش‌فرض: "still images") | DYNAMIC_COMBO | بله (شرطی) | `"still images"`<br>`"animated"` |

### گزینه‌های AVIF متحرک

این گزینه‌ها زمانی ظاهر می‌شوند که `save_mode` روی `"animated"` تنظیم شده باشد.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
| --- | --- | --- | --- | --- |
| `fps` | نرخ فریم انیمیشن. (پیش‌فرض: 6.0) | FLOAT | بله (شرطی) | 0.01 تا 1000.0 |
| `loop_count` | تعداد دفعات تکرار انیمیشن. مقدار 0 باعث تکرار بی‌نهایت می‌شود. (پیش‌فرض: 0) | INT | بله (شرطی) | 0 تا 1000 |

**نکات مربوط به وابستگی‌های پارامتر:**
- پارامترهای مخصوص قالب (`bit_depth`، `input_color_space` و برای AVIF همچنین `crf` و `save_mode`) فقط زمانی در دسترس هستند که یک `format` مشخص انتخاب شده باشد.
- برای قالب PNG، فقط عمق‌های بیت "8-bit" و "16-bit" و فقط فضای رنگ "sRGB" در دسترس است.
- برای قالب EXR، هر دو عمق بیت "16-bit float" و "32-bit float" در دسترس است، همراه با فضاهای رنگ "sRGB"، "HDR"، "linear" یا "linear ACEScg". مقدار "16-bit float" پیش‌فرض است و فایل‌های کوچک‌تری تولید می‌کند.
- برای قالب AVIF، `fps` و `loop_count` فقط زمانی در دسترس هستند که `save_mode` روی `"animated"` تنظیم شده باشد.
- تصاویر PNG و EXR باید 1 کانال (مقیاس خاکستری)، 3 کانال (RGB) یا 4 کانال (RGBA) داشته باشند؛ سایر تعداد کانال‌ها پشتیبانی نمی‌شوند و خطا ایجاد می‌کنند.
- AVIF فقط از تصاویر 1 کاناله مقیاس خاکستری و 3 کاناله RGB پشتیبانی می‌کند؛ تصاویر RGBA (آلفا) پشتیبانی نمی‌شوند و خطا ایجاد می‌کنند.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
| --- | --- | --- |
| `images` | تصاویر ورودی، بدون تغییر عبور داده می‌شوند. خروجی رابط کاربری گره فهرستی از نتایج تصاویر ذخیره‌شده را ارائه می‌دهد که هر یک شامل نام فایل، زیرپوشه و نوع ("output") است. برای AVIF متحرک با بیش از یک تصویر، خروجی رابط کاربری همچنین یک پرچم `animated` را شامل می‌شود. | IMAGE |

> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SaveImageAdvanced/fa.md)

---
**Source fingerprint (SHA-256):** `ebbb78aedbfeb48239d900eee2170e04899e2b5b841a720209258f68dd6241f8`
