Script TOP
پرش به ناوبری | پرش به جستجو

خلاصه

اپراتور Script TOP برای تولید یک تصویر TOP با استفاده از یک اسکریپت پایتون به‌کار می‌رود. قابلیت اصلی‌ای که در اختیار می‌گذارد copyNumpyArray است؛ این تابع یک آرایه NumPy را به‌عنوان ورودی می‌گیرد و تصویر TOP را با داده‌های همان تصویر پر می‌کند. اینکه آرایه NumPy چگونه تولید شود کاملاً به نویسنده اسکریپت بستگی دارد؛ می‌تواند کد سفارشی، OpenCV یا هر روش دیگری باشد.

منبع ورودی برای تابع copyNumpyArray() می‌تواند شامل ۳ یا ۴ کانال باشد.

Script CHOP این امکان را می‌دهد که آرایه‌های NumPy به کانال‌های CHOP تبدیل شوند. همچنین هر CHOP می‌تواند کانال‌های خود را به آرایه‌های NumPy تبدیل کند. (می ۲۰۲۱)

نگاه کنید به:
numPyArray() در TOP Class، Script DAT

همچنین ببینید:
Script CHOP، Script SOP

نکته:
این TOP از تکسچرهای سه‌بعدی (3D Textures) و آرایه‌های تکسچر دوبعدی (2D Texture Arrays) پشتیبانی می‌کند.

PythonIcon.png
scriptTOP_Class

فهرست مطالب

  1. Summary

  2. Parameters – Setup Page

  3. Parameters – Common Page

  4. Operator Inputs

  5. Info CHOP Channels
      5.1 Common TOP Info Channels
      5.2 Common Operator Info Channels

Parameters – Setup Page

Callbacks DAT (callbacks)
DATای را مشخص می‌کند که Callbackها در آن قرار دارند.

Setup Parameters (setuppars)
با کلیک روی این دکمه، تابع Callback به نام setupParameters() اجرا می‌شود.

Modify Outside of Cook (modoutsidecook)
اجازه می‌دهد TOP توسط یک اسکریپت خارجی و بدون نیاز به Lock کردن TOP به‌روزرسانی شود.

Parameters – Common Page

Output Resolution (outputresolution) ⊞
تغییر سریع رزولوشن داده‌های TOP.

Resolution (resolution) ⊞
فقط زمانی فعال است که پارامتر Resolution روی Custom Resolution تنظیم شده باشد.
برخی Generatorها مانند Constant و Ramp ورودی ندارند و فقط از این فیلد برای تعیین اندازه استفاده می‌کنند.
منوی کشویی سمت راست شامل چند رزولوشن پرکاربرد است.

Resolution Menu (resmenu)
منوی کشویی با چند رزولوشن رایج.

Use Global Res Multiplier (resmult)
از Global Resolution Multiplier موجود در مسیر
Edit > Preferences > TOPs استفاده می‌کند.
این مقدار، رزولوشن تمام TOPها را در ضریب مشخص‌شده ضرب می‌کند. این ویژگی هنگام کار روی سیستم‌هایی با مشخصات سخت‌افزاری متفاوت بسیار کاربردی است.
برای مثال، اگر پروژه روی یک ورک‌استیشن قدرتمند با حافظه گرافیکی زیاد طراحی شده باشد، کاربری با لپ‌تاپ ضعیف‌تر (مثلاً با 64MB VRAM) می‌تواند این ضریب را روی نصف یا یک‌چهارم قرار دهد تا پروژه با سرعت قابل قبول اجرا شود.
با فعال بودن این گزینه، این TOP تحت تأثیر ضریب سراسری قرار می‌گیرد.

Output Aspect (outputaspect) ⊞
نسبت تصویر خروجی را تنظیم می‌کند و اجازه می‌دهد تکسچرها در هر اندازه‌ای نمایش داده شوند.
هنگام کامپوزیت کردن TOPهایی با نسبت تصویر متفاوت، مراقب نتایج غیرمنتظره باشید.
(می‌توانید تصاویر با پیکسل‌های غیرمربعی تعریف کنید با استفاده از xres، yres، aspectx، aspecty در حالتی که xres/yres ≠ aspectx/aspecty باشد.)

Aspect (aspect) ⊞
زمانی استفاده می‌شود که Output Aspect روی Custom Aspect تنظیم شده باشد.

Aspect Menu (armenu)
منوی کشویی شامل چند نسبت تصویر رایج.

Input Smoothness (inputfiltertype) ⊞
کنترل فیلتر شدن پیکسل‌ها روی تصویر ورودی TOP.

Fill Viewer (fillmode) ⊞
نحوه نمایش تصویر TOP در Viewer را تعیین می‌کند.

نکته:
برای درک بهتر نحوه کار TOPها با تصاویر، هنگام شروع کار بهتر است این گزینه روی Native Resolution تنظیم شود. این کار باعث می‌شود بدون تغییر اندازه خودکار Viewer، دقیقاً ببینید چه اتفاقی در حال رخ دادن است.

Viewer Smoothness (filtertype) ⊞
کنترل فیلتر شدن پیکسل‌ها در Viewerها.

Passes (npasses)
عملیات TOP را به تعداد مشخص‌شده تکرار می‌کند.
در هر پاس بعد از پاس اول، خروجی پاس قبلی گرفته شده و به‌جای ورودی اول نود قرار می‌گیرد.
یک استثنا GLSL TOP هنگام استفاده از Compute Shader است؛ در این حالت ورودی همچنان تصویر TOP متصل‌شده باقی می‌ماند.

Channel Mask (chanmask)
امکان انتخاب اینکه TOP روی کدام کانال‌ها (R، G، B یا A) عمل کند. به‌صورت پیش‌فرض همه کانال‌ها انتخاب شده‌اند.

Pixel Format (format) ⊞
فرمت ذخیره‌سازی داده برای هر کانال تصویر (مانند R، G، B و A).
برای اطلاعات بیشتر به Pixel Formats مراجعه کنید.

Operator Inputs

Input 0: —

Info CHOP Channels

اطلاعات اضافی مربوط به Script TOP از طریق یک Info CHOP قابل دسترسی است.

Common TOP Info Channels

  • resx — رزولوشن افقی TOP بر حسب پیکسل

  • resy — رزولوشن عمودی TOP بر حسب پیکسل

  • aspectx — نسبت افقی TOP

  • aspecty — نسبت عمودی TOP

  • depth — عمق آرایه 2D یا 3D، در صورتی که این TOP شامل آرایه تکسچر 2D یا 3D باشد

  • gpu_memory_used — مقدار کل حافظه تکسچر GPU استفاده‌شده توسط این TOP

Common Operator Info Channels

  • total_cooks — تعداد دفعاتی که اپراتور از زمان شروع پردازش Cook شده است

  • cook_time — مدت زمان آخرین Cook بر حسب میلی‌ثانیه

  • cook_frame — شماره فریمی که اپراتور آخرین بار نسبت به تایم‌لاین کامپوننت Cook شده است

  • cook_abs_frame — شماره فریمی که اپراتور آخرین بار نسبت به زمان مطلق Cook شده است

  • cook_start_time — زمان شروع Cook اپراتور (میلی‌ثانیه) در فریمی که Cook شده

  • cook_end_time — زمان پایان Cook اپراتور (میلی‌ثانیه) در همان فریم

  • cooked_this_frame — اگر اپراتور در این فریم Cook شده باشد مقدار 1 است

  • warnings — تعداد هشدارهای این اپراتور (در صورت وجود)

  • errors — تعداد خطاهای این اپراتور (در صورت وجود)