# VaeDecodeTextureTrellis

این گره یک لاتنت بافت Trellis2 را با استفاده از یک VAE به رنگ‌های وکسل رمزگشایی می‌کند. لاتنت ورودی شامل نمونه‌های ویژگی پراکنده به همراه مختصات است؛ گره رنگ هر وکسل را بازسازی می‌کند و نتیجه را به‌صورت یک شبکه وکسل برمی‌گرداند تا گره‌های پایین‌دستی، مانند PaintMesh، بتوانند از آن برای رنگ‌آمیزی یک مش سه‌بعدی استفاده کنند.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `نمونه‌ها` | لاتنت بافت برای رمزگشایی. شامل ویژگی‌های نمونه و مختصات پراکنده است و ممکن است فراداده اختیاری مانند شمارش‌های مختصات (`coord_counts`)، چارچوب مدل (`model_frame`، پیش‌فرض: "y_up") و وضوح مختصات (`coord_resolution`) را در خود داشته باشد. | LATENT | بله | — |
| `vae` | VAE مدل Trellis2 که برای رمزگشایی لاتنت بافت به رنگ‌های وکسل استفاده می‌شود. | VAE | بله | — |
| `تقسیم‌بندی‌های شکل` | اطلاعات شکل که برای هدایت بازسازی با جزئیات بالاتر در هنگام رمزگشایی استفاده می‌شود. به حفظ سازگاری ساختار در وضوح‌های بالاتر کمک می‌کند. | SHAPE_SUBDIVIDES | بله | — |

توجه: وقتی لاتنت `samples` شامل `coord_counts` باشد، شمارش‌ها باید نامنفی باشند، مجموعشان باید با تعداد سطرهای مختصات مطابقت داشته باشد، و هر دسته (batch) باید دقیقاً شامل تعداد سطرهای مورد انتظار باشد؛ در غیر این صورت گره خطا می‌دهد. اگر `model_frame` لاتنت "z_up" باشد، مختصات وکسل رمزگشایی‌شده به Y-up بازنگاشت می‌شوند تا با رأس‌های مش هم‌تراز شوند. وقتی `coord_resolution` ارائه شود، وضوح بافت خروجی برابر آن مقدار ضربدر 16 است. در غیر این صورت از بزرگ‌ترین مختصات وکسل به‌علاوه یک استنتاج می‌شود و به سمت بالا به یکی از 256، 512، 1024، 1536 یا 2048 گرد می‌شود؛ اگر مقدار موردنیاز از 2048 فراتر رود، همان مقدار بزرگ‌تر استفاده می‌شود. اگر هیچ مختصاتی در دسترس نباشد، وضوح به‌طور پیش‌فرض 1024 است.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `voxel_colors` | داده وکسل رمزگشایی‌شده شامل مختصات، ویژگی‌های رنگ و وضوح بافت. هر وکسل 6 کانال رنگ دارد: رنگ پایه (RGB)، متالیک، زبری و آلفا، همگی در بازه [0, 1]. مصرف‌کنندگان رنگ رأس مانند PaintMesh از 3 کانال اول استفاده می‌کنند. | VOXEL |

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

---
**Source fingerprint (SHA-256):** `952ea7d7a0147519392bebe352a0da731462db278c8640fa527aa5b6f64e4aa7`
