خلاصه
CHOP Execute DAT اسکریپت خودش را زمانی اجرا میکند که مقدار کانالهای یک CHOP مشخص تغییر کند.
میتوانی مشخص کنی کدام کانالها بررسی شوند و بر اساس نوع تغییر آنها، اجرای اسکریپت را فعال کنی.
اسکریپت برای هر نمونه (sample) که تغییر کند، فراخوانی میشود. بنابراین هنگام رندر یک فریم، ممکن است ۲ بار یا بیشتر برای هر کانال صدا زده شود، بسته به اینکه TouchDesigner چند فریم به جلو رفته است (ببین Time Slicing).
CHOP Execute DATها با متدهای پیشفرض پایتون ساخته میشوند. برای هر شرطی که در پارامترها فعال شده باشد، یک متد متناظر در DAT وجود دارد. هر وقت آن شرط برقرار شود، متد مربوطهی پایتون اجرا خواهد شد.
همچنین ببین: chopexecuteDAT_Class
محتوای سند
خلاصه
پارامترها – صفحه CHOP Execute
پارامترها – صفحه File
پارامترها – صفحه Common
ورودیهای اپراتور
کانالهای Info CHOP
6.1. کانالهای اطلاعات عمومی DAT
6.2. کانالهای اطلاعات عمومی اپراتور
پارامترها – صفحه CHOP Execute
Active (فعال) – وقتی روشن باشد، DAT به CHOP مرجع پاسخ میدهد.
Execute From (اجرای از) executeloc ⊞ – (فقط Tscript) تعیین میکند اسکریپت از چه موقعیتی اجرا شود.
Current Node (گره فعلی) current – اسکریپت از محل گره فعلی اجرا میشود.
This Node (این گره) here – اسکریپت از والد DAT اجرا میشود. این کار دسترسی به نودهای همسطح DAT را ساده میکند.
Specified Operator (اپراتور مشخصشده) op – اسکریپت از مؤلفهای که در پارامتر Component مشخص شده اجرا میشود.
From Operator (از اپراتور) fromop – مسیری که اسکریپت از آن اجرا میشود اگر گزینه Execute From روی Specified Operator تنظیم شده باشد.
CHOP chop – CHOPی که تغییر کانالش اجرای اسکریپت DAT را فعال میکند.
Channel (کانال) channel – کانالی که تغییرش باعث اجرای DAT میشود.
Off to On offtoon – متد
onOffToOn()زمانی اجرا میشود که کانال از حالت خاموش به روشن تغییر کند (در اولین فریم “on”).While On whileon – متد
whileOn()زمانی اجرا میشود که کانال روشن باشد. در هر فریم یکبار فراخوانی میشود.On to Off ontooff – متد
onOnToOff()زمانی اجرا میشود که کانال از روشن به خاموش تغییر کند (در اولین فریم “off”).While Off whileoff – متد
whileOff()زمانی اجرا میشود که کانال خاموش باشد. در هر فریم یکبار فراخوانی میشود.Value Change (تغییر مقدار) valuechange – متد
onValueChange()زمانی اجرا میشود که مقدار کانال به هر طریقی تغییر کند. در هر فریم یکبار فراخوانی میشود.While Off/On Frequency (فرکانس در حالت روشن/خاموش) freq ⊞ – فقط زمانی فعال است که از گزینههای While On یا While Off استفاده شود. تعیین میکند DAT برای هر نمونه یا فقط یکبار در هر فریم اجرا شود.
Execute For Every Sample (اجرای برای هر نمونه) everysample
Execute Once Per Frame (اجرای یکبار در هر فریم) onceperframe
Edit.. (ویرایش) edit – با کلیک روی این گزینه، ویرایشگر متن باز میشود تا متن DAT را ویرایش کنی.
پارامترها – صفحه File
File (فایل) file – مسیر و نام فایل در سیستم فایل برای بارگذاری. فایلهای .txt و .dat را میپذیرد.
Sync to File (همگامسازی با فایل) syncfile – وقتی روشن باشد، فایل هنگام شروع پروژه از دیسک بارگذاری میشود.
اگر نام فایل مشخص شده باشد، روشن کردن این گزینه فایل را بلافاصله بارگذاری میکند.
اگر فایل وجود نداشته باشد، اولین بار که DAT بهروزرسانی شود ساخته خواهد شد.
تغییرات فایل بهصورت زنده به DAT منتقل میشود و برعکس، تغییرات DAT نیز روی فایل نوشته میشود.
اگر فایل حذف شود، DAT محتوای فعلی خودش را نگه میدارد.
Load on Start (بارگذاری در شروع) loadonstart – اگر روشن باشد، فایل هنگام شروع پروژه دوباره بارگذاری میشود.
Load File (بارگذاری فایل) loadonstartpulse – فایل را بلافاصله بارگذاری میکند.
Write on Toe Save (نوشتن هنگام ذخیره پروژه) write – اگر روشن باشد، هنگام ذخیره پروژه محتوای DAT روی دیسک نوشته میشود.
Write File (نوشتن فایل) writepulse – فایل را فوراً روی دیسک مینویسد.
پارامترها – صفحه Common
Language (زبان) ⊞ – انتخاب زبان اسکریپت برای اجرای DAT.
Input – از زبان اسکریپت ورودی استفاده میکند.
Node – از زبان اسکریپت خود DAT استفاده میکند.
Edit/View Extension (پسوند ویرایش/مشاهده) ⊞ – انتخاب پسوند فایلی که این DAT برای ویرایشگرهای خارجی نمایش دهد.
dat – پسوندهای رایج فایل.
From Language – پسوند را بر اساس زبان اسکریپت DAT انتخاب میکند.
Custom Extension – تعریف یک پسوند سفارشی.
Custom Extension (customext) – تعیین پسوند سفارشی.
Word Wrap (شکستن خطوط) ⊞ – فعال یا غیرفعال کردن شکستن خطوط برای نمایش نود.
Input – از تنظیمات ورودی استفاده میکند.
On – شکستن خطوط فعال.
Off – شکستن خطوط غیرفعال.
ورودیهای اپراتور
Input 0 –
کانالهای Info CHOP
اطلاعات اضافی برای CHOP Execute DAT از طریق یک Info CHOP در دسترس است.
کانالهای اطلاعات عمومی DAT
num_rows – تعداد ردیفها در این DAT.
num_cols – تعداد ستونها در این DAT.
کانالهای اطلاعات عمومی اپراتور
total_cooks – تعداد دفعاتی که اپراتور از زمان شروع فرآیند اجرا شده است.
cook_time – مدت زمان آخرین اجرا (cook) بر حسب میلیثانیه.
cook_frame – شماره فریمی که آخرین بار اپراتور نسبت به تایملاین مؤلفه اجرا شده است.
cook_abs_frame – شماره فریمی که آخرین بار اپراتور نسبت به زمان مطلق اجرا شده است.
cook_start_time – زمان (میلیثانیه) شروع پردازش اپراتور در فریم اجرا.
cook_end_time – زمان (میلیثانیه) پایان پردازش اپراتور در فریم اجرا.
cooked_this_frame – اگر اپراتور در این فریم اجرا شده باشد، مقدار 1 خواهد داشت.
warnings – تعداد هشدارهای این اپراتور (در صورت وجود).
errors – تعداد خطاهای این اپراتور (در صورت وجود).