خلاصه (Summary)

کامپوننت Animation یک کامپوننت ویژه برای ساخت کانال‌های انیمیشن کی‌فریم (Keyframe Animation Channels) است.
این کامپوننت شامل یک شبکه از پیش‌تعریف‌شده است که از Keyframe CHOP و چندین Table DAT برای تعریف کانال‌های انیمیشن‌شده استفاده می‌کند.

رابط کاربری برای ساخت و ویرایش انیمیشن این کامپوننت، Animation Editor نام دارد.

این کامپوننت هم ورودی CHOP دارد و هم خروجی CHOP.

ورودی‌های Animation Component

• اگر ورودی متصل نباشد، ایندکس کامپوننت بر اساس محدوده زمانی کانال‌ها به صورت حلقه‌ای اجرا می‌شود.

• اگر یک ورودی CHOP متصل شود، می‌تواند ایندکس انیمیشن را به صورت دستی کنترل کند.

  • مثلاً اگر کانال‌ها از فریم ۱ تا ۶۰۰ کی‌فریم داشته باشند، می‌توان ورودی‌ای متصل کرد که عددی بین ۱ تا ۶۰۰ به آن بدهد تا خروجی انیمیشن کنترل شود (اعداد بیرون از این محدوده بر اساس Extend Conditions کانال‌ها عمل می‌کنند).

• با استفاده از منوی Index Units در Keyframe CHOP می‌توان انیمیشن را با واحدهای ثانیه، نمونه (Samples) یا کسر (Fraction) کنترل کرد (که ۰ شروع و ۱ پایان است).

خروجی‌های Animation Component

• خروجی CHOP مقدار فعلی کانال انیمیشن را می‌دهد.

• می‌توان آن را مستقیم به CHOPهای دیگر وصل کرد یا یک Null CHOP برای خروجی گرفتن به پارامترها افزود.

• مقادیر کانال‌های فعلی را می‌توان با فعال کردن Node Viewer در خود Animation COMP مشاهده کرد.

استفاده از Animation Component

هر زمان در TouchDesigner بخواهید پارامتری را کی‌فریم کنید، از یک Animation COMP استفاده می‌شود.

راه‌های ایجاد Animation COMP:

• از طریق OP Create Dialog

• راست‌کلیک روی هر پارامتر → Keyframe Parameter in… → New Animation

• برای باز کردن Animation Editor: راست‌کلیک روی یک Animation COMP → انتخاب Edit Animation…

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

پارامترها – صفحه Animation

• Time Reference timeref → منبع زمانی برای انیمیشن (استفاده می‌شود وقتی Type در صفحه Range روی Timeline باشد).

• Play Mode playmode → حالت پخش انیمیشن یا خروجی گرفتن از کل منحنی انیمیشن.

• Play play → در حالت Sequential، روشن بودن = پخش انیمیشن / خاموش = توقف.

• Speed speed → ضریب سرعت (مثال: ۱ = عادی، ۲ = دو برابر سریع‌تر، ۰.۵ = نصف سرعت، مقادیر منفی = پخش معکوس).

• Cue cue → پرش به نقطه Cue هنگام فعال‌سازی.

• Cue Pulse cuepulse → پرش فوری به Cue Point.

• Cue Point cuepoint → تعیین ایندکسی از انیمیشن به‌عنوان نقطه پرش.

• Cue Point Unit cuepointunit → واحد Cue Point.

• Input Index Unit inputindexunit → وقتی Play Mode روی “Use Input Index” باشد، واحد ورودی ایندکس را مشخص می‌کند:

  • Samples

  • Frames

  • Seconds

  • Fraction

  • X Units → استفاده مستقیم از داده‌های Key DAT داخلی

• Cyclic Range cyclic → رفتار حلقه‌ای یا غیرحلقه‌ای برای ایندکس‌های ورودی.

  • Auto = بررسی Extend Condition

  • Yes = حلقه‌ای

  • No = غیرحلقه‌ای

• Specify Edit Attributes specifyedit → فعال کردن تغییر ویژگی‌های ویرایش.

• Edit Origin editorigin → تغییر مبدا نمایش کانال‌ها (روی داده ذخیره‌شده اثری ندارد).

• Edit Rate editrate → تغییر نرخ نمایش کانال‌ها (روی داده اصلی اثری ندارد).

• Edit Animation… editanimation → باز کردن انیمیشن در Animation Editor.

پارامترها – صفحه Range

• Type rangetype → نوع محدوده کاری:

  • Timeline = استفاده از محدوده Timeline مرجع

  • Custom = تعیین محدوده سفارشی با Start و End

• Start / End → شروع و پایان محدوده (با واحد ثانیه، فریم یا نمونه).

• Start Unit / End Unit → انتخاب واحد Start و End.

• Trim Left tleft → رفتار کانال قبل از Start:

  • Hold = نگه‌داشتن مقدار فعلی

  • Slope = ادامه شیب

  • Cycle = تکرار حلقه‌ای

  • Mirror = تکرار آینه‌ای

  • Default = استفاده از مقدار ثابت تعریف‌شده

• Trim Right tright → رفتار کانال بعد از End (مشابه بالا).

• Trim Default tdefault → مقدار ثابت پیش‌فرض.

پارامترها – صفحه Extensions

(مانند سایر کامپوننت‌ها)

• Extension ext → اطلاعات ساخت اکستنشن

• Object ext0object → نمونه‌های کلاس متصل‌شونده

• Name ext0name → نام اختیاری

• Promote ext0promote → دسترسی مستقیم یا از طریق .ext

• Re-Init Extensions reinitextensions → بازکامپایل کردن همه اکستنشن‌ها

پارامترها – صفحه Common

• Parent Shortcut parentshortcut → مسیر والد برای دسترسی درون کامپوننت

• Global OP Shortcut opshortcut → مسیر جهانی برای دسترسی به کامپوننت

• Internal OP iop → اپراتورهای داخلی

• Node View / Operator Viewer → نمایشگر نود انتخابی

• Enable Cloning / Clone Master → کلون‌کردن از یک مرجع

• Load on Demand → بارگذاری تنها در صورت نیاز

• Enable External .tox / Path → بارگذاری از فایل tox خارجی

• Reload Custom/Built-In Parameters → ریلود پارامترها هنگام بارگذاری tox

• Save Backup of External → ذخیره نسخه پشتیبان tox در فایل toe

• Sub-Component to Load → بارگذاری یک زیرکامپوننت خاص از tox

• Relative File Path Behavior relpath → مسیرها نسبی به toe، tox یا والد

ورودی‌های اپراتور (Operator Inputs)

• Input 0 → برای کنترل ایندکس انیمیشن (اختیاری).

Info CHOP Channels

Common COMP Info Channels

• num_children → تعداد فرزندهای کامپوننت

Common Operator Info Channels

• total_cooks → تعداد دفعات cook از شروع

• cook_time → مدت زمان cook آخر (ms)

• cook_frame → شماره فریم آخرین cook (نسبت به timeline)

• cook_abs_frame → شماره فریم آخرین cook (نسبت به زمان مطلق)

• cook_start_time / cook_end_time → زمان شروع و پایان cook در فریم

• cooked_this_frame → اگر در این فریم cook شده باشد = ۱

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

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