Notch TOP

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

خلاصه (Summary)

توجه (NOTE)
لایسنس: این اپراتور فقط در نسخه‌های TouchDesigner Educational، TouchDesigner Commercial و TouchDesigner Pro در دسترس است.
سیستم‌عامل: این اپراتور فقط روی Microsoft Windows پشتیبانی می‌شود.

Notch TOP یک Notch Block (با پسوند ‎.dfxdll) که توسط Notch Builder کامپایل شده را بارگذاری می‌کند.
در لایسنس‌های Commercial و Educational محدودیت استفاده از ۲ بلاک فعال با رزولوشن 1920×1080 وجود دارد.

نکته: برای بارگذاری Notch Blockها، اکنون به CodeMeter Runtime نسخهٔ 7.60 یا بالاتر نیاز است.

با بارگذاری Notch Block در Notch TOP، برای تمام ویژگی‌های Exposed داخل بلاک، پارامترهای سفارشی ایجاد می‌شود.
این پارامترها بر اساس Page دسته‌بندی می‌شوند و هر Page نمایندهٔ یک Layer از بلاک است.
لایهٔ خروجی از طریق پارامتر Layer انتخاب می‌شود.

برچسب پارامترهای سفارشی از Exposed Name ویژگی‌ها ساخته می‌شود؛ به‌طوری که کاراکترهای خاص و فاصله‌ها حذف می‌شوند.
اگر Unique Identifier به‌صورت دستی (و نه مقدار پیش‌فرض خودکار) تنظیم شده باشد، همان مقدار به‌عنوان نام پارامتر استفاده می‌شود.
برای استفاده در TouchDesigner، توصیه می‌شود برای تمام ویژگی‌های Exposed یک Unique Identifier سفارشی تعریف شود.

فعال‌سازی Debug Logging

برای عیب‌یابی مشکلات Notch Blockها می‌توانید لاگ‌گیری را با تنظیم متغیر محیطی ویندوز زیر فعال کنید:

TOUCH_NOTCH_LOGGING=1

خطای بارگذاری بلاک

اگر بلاک لود نشود و Notch TOP خطای زیر را نمایش دهد:
“Failed to load the Notch Block”
احتمالاً یکی از دلایل زیر وجود دارد:

  1. نسخهٔ CodeMeter Runtime قدیمی است
    حداقل نسخهٔ موردنیاز 7.60 است.
    برای بررسی نسخه:
    CodeMeter Control Center > Help > About

  2. فایل‌های WupiEngine32.dll و WupiEngine64.dll وجود ندارند
    این حالت ممکن است زمانی رخ دهد که Notch Builder نصب نباشد یا فقط از لایسنس Playback استفاده شده باشد.
    برای رفع مشکل:

    • Notch را نصب کنید

    • فایل‌های DLL را در مسیر نصب Notch پیدا کنید (به‌صورت پیش‌فرض:
      C:\Program Files\Notch)

    • آن‌ها را به پوشهٔ /bin در مسیر نصب TouchDesigner کپی کنید
      (مثال:
      C:\Program Files\Derivative\TouchDesigner.2023.12120\bin)

    • در صورت باز بودن TouchDesigner، آن را ری‌استارت کنید

Exposed Block Properties

ویژگی‌های Exposed بلاک به‌صورت پارامتر روی Notch TOP اضافه می‌شوند.
هر پارامتر در Pageای قرار می‌گیرد که نام آن با Layer متناظر در Notch Block یکسان است.

بیشتر پارامترها به‌صورت مستقیم به ساختار پارامترهای TouchDesigner ترجمه می‌شوند، اما برخی نیاز به توضیح اضافه دارند که داخل پرانتز به برچسب پارامتر افزوده می‌شود:

  • TOP:
    ارجاع به یک TOP. فرمت پیکسلی باید 8-bit Fixed (RGBA) یا 16-bit Float (RGBA) باشد.

  • Xform:
    یک 3D Object COMP شامل داده‌های ترنسفورم (مثلاً Geometry COMP یا Null COMP).
    مقادیر جابجایی (Translation) و چرخش (Quaternion) در فضای جهانی به Notch Block ارسال می‌شوند.

  • Cam:
    یک Camera COMP یا هر آبجکتی با ماتریس پروجکشن (مثل Light COMP).
    علاوه بر ترنسفورم جهانی، مقادیر پروجکشن (scale/offset و near/far) نیز ارسال می‌شوند.

  • CHOP:
    ارجاع به یک CHOP که اندازه‌اش با آرایهٔ Exposed در Notch Block برابر باشد.
    اگر اندازهٔ CHOP نادرست باشد، Notch TOP هشدار می‌دهد.
    تعداد Sampleها باید با تعداد Instanceهای آرایه‌ای که بلاک انتظار دارد مطابقت داشته باشد (وابسته به پروژه).
    تعداد Channelها به نوع Property بستگی دارد و بر اساس ترتیب Channel (نه نام آن‌ها) تفسیر می‌شود؛ هرچند برای شفافیت نام‌ها در ادامه ذکر شده‌اند:

    • Euler (۹ کانال):
      t[xyz] r[xyz] s[xyz]

    • Quaternion (۱۰ کانال):
      t[xyz] q[xyzw] s[xyz]

    • Matrix 4×4 (۱۶ کانال):
      m00 m10 m20 ... m33

    • Generic (۱ کانال)

همچنین ببینید: Notch

notchTOP_Class

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

  1. Summary
      1.1 Exposed Block Properties

  2. Parameters – Notch Page

  3. Parameters – Common Page

  4. Info CHOP Channels
      4.1 Specific Notch TOP Info Channels
      4.2 Common TOP Info Channels
      4.3 Common Operator Info Channels

Parameters – Notch Page

Active (active)

وضعیت فعال بودن نود/بلاک.
وقتی فعال باشد، نود بلاک را رندر می‌کند.
اگر غیرفعال شود، نمونهٔ بلاک آزاد می‌شود و اگر نمونهٔ دیگری وجود نداشته باشد (یعنی Notch TOP دیگری از همان بلاک استفاده نکند)، بلاک Unload می‌شود.
در این حالت فایل ‎.dfxdll دوباره قابل ویرایش خواهد بود.
با فعال‌سازی مجدد، بلاک همراه با تغییرات دوباره بارگذاری می‌شود.

Clear Parameter Values on File Change (clearparams)

اگر فعال باشد، با تغییر فایل بلاک تمام پارامترها پاک می‌شوند.
اگر غیرفعال باشد، مقادیر پارامترهای Exposed با نام یکسان حفظ می‌شوند.

Block (block)

مشخص‌کردن فایل ‎.dfxdll (Notch Block).

Layer (layer)

لایه‌ای که به‌عنوان خروجی Notch TOP استفاده می‌شود.

Play Mode (playmode) ⊞

انتخاب روش پخش بلاک.

Initialize (init)

پخش بلاک را مقداردهی اولیه می‌کند؛ به ابتدای تایم‌لاین می‌رود اما پخش را جلو نمی‌برد.

Start (start)

پخش بلاک را از ابتدا ریست کرده و شروع به پخش می‌کند.

Play (play)

فعال‌سازی پخش بلاک.
در حالت Sequential، اگر غیرفعال شود پخش متوقف می‌شود.

Speed (speed)

سرعت پخش.

Index (index)

ایندکس پخش زمانی که Index Mode انتخاب شده باشد.

Index Unit (indexunit) ⊞

واحد مورد استفاده برای پارامتر Index.

Purge GPU Mem (purge)

پاک‌سازی حافظهٔ GPU (Video RAM) مصرف‌شده توسط بلاک.

Parameters – Common Page

(این بخش مشابه سایر TOPهاست و بدون تغییر مفهومی ترجمه شده است)

Output Resolution (outputresolution) ⊞

تغییر سریع رزولوشن خروجی TOP.

Resolution (resolution) ⊞

فقط وقتی فعال است که Output Resolution روی Custom Resolution باشد.

Resolution Menu (resmenu)

رزولوشن‌های پرکاربرد.

Use Global Res Multiplier (resmult)

استفاده از ضریب رزولوشن سراسری TouchDesigner
(Edit > Preferences > TOPs).

Output Aspect (outputaspect) ⊞

تنظیم نسبت تصویر خروجی.

Aspect (aspect) ⊞

برای حالت Custom Aspect.

Aspect Menu (armenu)

نسبت‌های تصویر رایج.

Input Smoothness (inputfiltertype) ⊞

فیلتر پیکسلی ورودی.

Fill Viewer (fillmode) ⊞

نحوهٔ نمایش تصویر در Viewer.
نکته: برای فهم بهتر رفتار TOPها، ابتدا روی Native Resolution تنظیم شود.

Viewer Smoothness (filtertype) ⊞

فیلتر پیکسلی Viewer.

Passes (npasses)

تکرار عملیات TOP به تعداد مشخص.
(به‌جز GLSL TOP در حالت Compute Shader)

Channel Mask (chanmask)

انتخاب کانال‌های R، G، B و A.

Pixel Format (format) ⊞

فرمت ذخیره‌سازی دادهٔ پیکسلی.

Info CHOP Channels

اطلاعات تکمیلی Notch TOP از طریق Info CHOP در دسترس است.

Specific Notch TOP Info Channels

  • initializing

  • ready

  • running

  • done

  • timer_fraction

  • timer_seconds

  • timer_index

  • playing_seconds

  • running_seconds

  • length_seconds

  • sample_rate

  • index

  • block_gpu_memory_used

  • block_render_time

Common TOP Info Channels

  • resx: رزولوشن افقی

  • resy: رزولوشن عمودی

  • aspectx: نسبت افقی

  • aspecty: نسبت عمودی

  • depth: عمق آرایهٔ 2D یا 3D

  • gpu_memory_used: حافظهٔ GPU مصرف‌شده

Common Operator Info Channels

  • total_cooks

  • cook_time

  • cook_frame

  • cook_abs_frame

  • cook_start_time

  • cook_end_time

  • cooked_this_frame

  • warnings

  • errors