Select DAT

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

خلاصه (Summary)

Select DAT به شما امکان می‌دهد یک DAT را از هر مکان دیگری در پروژه انتخاب کنید و اگر این DAT یک جدول باشد، هر زیرمجموعه‌ای از ردیف‌ها و ستون‌ها را انتخاب کنید.

محتوا (Contents)

  1. Summary

  2. Parameters – Select Page

  3. Parameters – Common Page

  4. Operator Inputs

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

پارامترها – Select Page

  • DAT (dat)
    مسیر DAT که قرار است انتخاب شود.

  • Include First Row (firstrow)
    اجباری ردیف اول را انتخاب می‌کند، حتی اگر توسط تنظیمات Select Rows مشخص نشده باشد.

  • Include First Col (firstcol)
    اجباری ستون اول را انتخاب می‌کند، حتی اگر توسط تنظیمات Select Cols مشخص نشده باشد.

  • Select Rows (extractrows) ⊞
    این پارامتر روش‌های مختلفی برای مشخص کردن ردیف‌های انتخاب شده ارائه می‌دهد.

  • Start Row Name (rownamestart)
    نام ردیف شروع محدوده انتخاب را مشخص می‌کند.

  • Start Row Index (rowindexstart)
    شماره شاخص ردیف شروع محدوده انتخاب را مشخص می‌کند.

  • End Row Name (rownameend)
    نام ردیف پایان محدوده انتخاب را مشخص می‌کند.

  • End Row Index (rowindexend)
    شماره شاخص ردیف پایان محدوده انتخاب را مشخص می‌کند.

  • Row Select Values (rownames)
    نام‌های واقعی ردیف‌هایی که می‌خواهید انتخاب شوند را مشخص می‌کند.
    می‌توانید از الگوی تطبیق (pattern matching) TouchDesigner استفاده کنید، مثلاً:
    row[1-4] تمام ردیف‌های row1 تا row4 را انتخاب می‌کند.
    برخی کاراکترها مانند ' نیاز به پیشوند \ دارند.

  • Row Select Condition (rowexpr)
    یک عبارت (expression) مشخص کنید که ارزیابی شود. اگر مقدار آن True شود، ردیف انتخاب می‌شود.
    با باز کردن پارامتر، حالت expression قابل مشاهده است.

مثال پیش‌فرض:

re.match('.*', me.inputCell.val) != None

.* به معنی تطبیق هر کاراکتر چندین بار است، بنابراین این عبارت تمام مقادیر را انتخاب می‌کند.

اگر بخواهید نام اپراتور والد به دنبال هر عددی را انتخاب کنید، می‌توانید از:

parent().name+'[0-9]*'

استفاده کنید، جایی که [0-9]* هر رشته عددی را تطبیق می‌دهد.

عبارت:

'.*'+parent().name+'.*'

هر سلولی که شامل نام والد اپراتور باشد را تطبیق می‌دهد.
برای اطلاعات بیشتر می‌توانید Regular Expression Operations را بررسی کنید.

  • From Column (fromcol)
    هنگام انتخاب ردیف‌ها بر اساس مقادیر، این پارامتر تعیین می‌کند که کدام ستون برای تطبیق مقادیر سلول با Selected Row Values استفاده شود.

  • Select Cols (extractcols) ⊞
    این پارامتر روش‌های مختلفی برای مشخص کردن ستون‌های انتخاب شده ارائه می‌دهد.

  • Start Col Name (colnamestart)
    نام ستون شروع محدوده انتخاب را مشخص می‌کند.

  • Start Col Index (colindexstart)
    شاخص ستون شروع محدوده انتخاب را مشخص می‌کند.

  • End Col Name (colnameend)
    نام ستون پایان محدوده انتخاب را مشخص می‌کند.

  • End Col Index (colindexend)
    شاخص ستون پایان محدوده انتخاب را مشخص می‌کند.

  • Col Select Values (colnames)
    نام واقعی ستون‌هایی که می‌خواهید انتخاب شوند را مشخص می‌کند.
    می‌توانید از pattern matching استفاده کنید، مثلاً:
    colvalue[1-4] تمام ستون‌های colvalue1 تا colvalue4 را انتخاب می‌کند.
    تطبیق برخی کاراکترها مانند ' نیاز به پیشوند \ دارد.

  • Col Select Condition (colexpr)
    یک عبارت (expression) مشخص کنید که ارزیابی شود. اگر مقدار آن True شود، ستون انتخاب می‌شود.
    برای جزئیات بیشتر، به Row Select Condition نگاه کنید.

  • From Row (fromrow)
    هنگام انتخاب ستون‌ها بر اساس Specified Names، این پارامتر مشخص می‌کند که کدام ردیف برای تطبیق مقادیر سلول با Selected Col Values استفاده شود.

  • Output (output) ⊞
    تعیین می‌کند که چه فرمت خروجی برای DAT استفاده شود.

پارامترها – Common Page

  • Language (language) ⊞
    انتخاب زبان اسکریپت برای DAT.

  • Edit/View Extension (extension) ⊞
    انتخاب پسوند فایل برای ویرایشگرهای خارجی.

  • Custom Extension (customext)
    مشخص کردن پسوند سفارشی.

  • Word Wrap (wordwrap) ⊞
    فعال کردن شکستن خطوط برای نمایش نود.

ورودی‌های Operator

  • Input 0: –

کانال‌های Info CHOP

اطلاعات اضافی Select DAT از طریق Info CHOP قابل دسترسی است.

کانال‌های عمومی DAT

  • num_rows – تعداد ردیف‌ها

  • num_cols – تعداد ستون‌ها

کانال‌های عمومی Operator

  • total_cooks – تعداد دفعات Cook اپراتور از زمان شروع

  • cook_time – مدت زمان آخرین Cook (میلی‌ثانیه)

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

  • cook_abs_frame – شماره فریم نسبت به زمان مطلق

  • cook_start_time – زمان شروع Cook در آن فریم (میلی‌ثانیه)

  • cook_end_time – زمان پایان Cook در آن فریم (میلی‌ثانیه)

  • cooked_this_frame – اگر اپراتور در این فریم Cook شده باشد مقدار ۱ دارد

  • warnings – تعداد هشدارها

  • errors – تعداد خطاها