Shared Mem Out TOP

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

خلاصه (Summary)

نکته (NOTE)
لایسنس: این اپراتور فقط در نسخه‌های TouchDesigner Educational، TouchDesigner Commercial و TouchDesigner Pro در دسترس است.

اپراتور Shared Mem Out TOP داده‌های تصویری را در یک بلاک حافظه‌ی اشتراکی (Shared Memory) می‌نویسد تا توسط سایر پروسه‌های TouchDesigner یا نرم‌افزارهای شخص ثالث مورد استفاده قرار گیرد.

همچنین ببینید: Using Shared Memory in TouchDesigner و Shared Mem In TOP.

فهرست مطالب (Contents)

  1. Summary

  2. Parameters – SharedMemOut 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 – SharedMemOut Page

Active (active)
وقتی فعال باشد، TOP ورودی‌های خود را Cook کرده و داده‌ها را در بلاک حافظه می‌نویسد.

Shared Mem Name (name)
نام بلاک حافظه‌ای که داده‌ها در آن نوشته می‌شوند.

Shared Mem Type (memtype) ⊞
مشخص می‌کند نوشتن داده‌ها در حافظه‌ی Local (محلی) انجام شود یا Global (سراسری).

Download Type (downloadtype) ⊞
انتخاب بین دو حالت Immediate (Slow) و Next Frame (Fast) برای عملکرد بهتر.

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 دارد می‌تواند Global Resolution Multiplier را روی نصف یا یک‌چهارم تنظیم کند تا پروژه با سرعت قابل قبول اجرا شود.
با فعال‌بودن این گزینه، این 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 را به تعداد مشخص‌شده تکرار می‌کند.
قرار دادن این مقدار روی عددی بزرگ‌تر از ۱، عملاً مشابه این است که خروجی هر پاس گرفته شده و دوباره به ورودی اول نود داده شود و این فرآیند تکرار گردد.
در هر پاس، سایر ورودی‌ها و پارامترها بدون تغییر باقی می‌مانند.

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

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

Operator Inputs

Input 0: –

Info CHOP Channels

اطلاعات تکمیلی مربوط به Shared Mem Out TOP از طریق یک Info CHOP قابل دسترسی است.

Common TOP Info Channels

resx – رزولوشن افقی TOP بر حسب پیکسل
resy – رزولوشن عمودی TOP بر حسب پیکسل
aspectx – نسبت تصویر افقی TOP
aspecty – نسبت تصویر عمودی TOP
depth – عمق آرایه‌ی دوبعدی یا سه‌بعدی، اگر این TOP شامل Texture Array دوبعدی یا سه‌بعدی باشد
gpu_memory_used – مقدار کل حافظه‌ی تکسچر استفاده‌شده توسط این 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 – تعداد خطاهای این اپراتور (در صورت وجود)