Shared Mem In TOP

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

خلاصه (Summary)

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

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

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


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

  1. Summary

  2. Parameters – SharedMemIn Page

  3. Parameters – Common Page

  4. Info CHOP Channels
     4.1 Common TOP Info Channels
     4.2 Common Operator Info Channels


Parameters – SharedMemIn Page

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

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


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 را به تعداد مشخص‌شده تکرار می‌کند.
در هر پاس بعد از اول، نتیجه‌ی پاس قبلی گرفته شده و به‌عنوان ورودی اول نود جایگزین می‌شود.
تنها استثنا GLSL TOP در حالت استفاده از Compute Shader است که در آن، ورودی همچنان تصویر TOP متصل باقی می‌ماند.

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

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


Info CHOP Channels

اطلاعات تکمیلی مربوط به Shared Mem In 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 – تعداد خطاهای این اپراتور (در صورت وجود)