خلاصه (Summary)

Keyframe CHOP از داده‌های کانال و کلیدها (keys) در یک Animation COMP استفاده می‌کند و کانال‌هایی از نمونه‌ها را با نرخ نمونه‌برداری قابل انتخاب (فریم بر ثانیه) تولید می‌کند.

🔗 همچنین ببینید: Animation COMP و Animation Editor

این CHOP به شما امکان دسترسی به داده‌های کی‌فریم‌شده درون یک کامپوننت Animation را می‌دهد.
Animation CHOP اجازه می‌دهد کانال‌ها با فریم سراسری (Global Frame) یا ایندکس زمانی (ثانیه‌ها) پخش شوند. همچنین می‌تواند به ساعت ضرب داخلی (Global Beat Clock)، یک ایندکس مشخص یا یک کانال زمانی/lookup متصل به ورودی همگام شود.

خروجی این CHOP می‌تواند شامل همه کانال‌ها باشد – چه به‌صورت یک نمونه‌ی منفرد یا یک بازه کامل از ابتدا تا انتها.

برای ایجاد/ویرایش/حذف کانال‌های کی‌فریم:

• یک Animation COMP بسازید.

• سپس با راست‌کلیک روی آن و انتخاب Edit Keyframes…، ویرایشگر کی‌فریم را باز کنید.

• درون این کامپوننت، یک Keyframe CHOP کانال‌های ایجادشده در ویرایشگر را خروجی خواهد داد.

اگر یک ورودی به Keyframe CHOP متصل کنید، به عنوان یک lookup index عمل می‌کند.
همچنین اگر ورودی یک Time Slice باشد، خروجی هم به‌صورت Time Slice تولید می‌شود.

📌 نکته: این lookup می‌تواند از تمام کانال‌های ورودی عبور کند، هرچند تنها یکی کافی است.

پارامترها (Parameters)

🔑 صفحه Keyframe

• Animation Component (کامپوننت انیمیشن):
  مسیر Animation COMP که داده‌های کانال و کی‌فریم را نگه می‌دارد.

• Sample Rate (نرخ نمونه‌برداری):
  نرخ نمونه‌برداری کانال‌ها بر حسب نمونه در ثانیه.

• Extend Left (گسترش به چپ – قبل از بازه):

  • Hold – نگه داشتن آخرین مقدار.

  • Slope – ادامه دادن شیب داده‌ها.

  • Cycle – تکرار چرخه‌ای.

  • Mirror – تکرار چرخه‌ای با آینه‌سازی.

  • Default Value – استفاده از مقدار پیش‌فرض.

• Extend Right (گسترش به راست – بعد از بازه):
  مشابه گزینه‌های بالا.

• Default Value (مقدار پیش‌فرض):
  مقدار پیش‌فرض برای شرایط Extend.

⚙️ صفحه Common

• Time Slice – فعال‌سازی خروجی Time Sliced.

• Scope – تعیین کانال‌هایی که تحت تأثیر قرار می‌گیرند.

• Sample Rate Match – مدیریت اختلاف نرخ نمونه‌برداری بین ورودی‌ها (First, Max, Min, Error).

• Export Method – روش اتصال کانال CHOP به پارامترها:

  • DAT Table by Index

  • DAT Table by Name

  • Channel Name is Path:Parameter

• Export Root – مسیر ریشه برای اکسپورت کانال‌ها.

• Export Table – جدولی از نوع DAT برای نگهداری اطلاعات اکسپورت.

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

• Input 0: ایندکس lookup یا کانال تایمینگ.

کانال‌های Info (اطلاعات)

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

🔹 Specific Keyframe CHOP Info Channels

• start_index

• start_frame

• start_second

• start_fraction

• end_index

• end_frame

• end_second

• end_fraction

🔹 Common CHOP Info Channels

• start – شروع بازه CHOP بر حسب نمونه.

• length – تعداد نمونه‌ها.

• sample_rate – نرخ نمونه‌برداری (فریم بر ثانیه).

• num_channels – تعداد کانال‌ها.

• time_slice – فعال بودن Time Slice (۱ یا ۰).

• export_sernum – شمار دفعات به‌روزرسانی اکسپورت.

🔹 Common Operator Info Channels

• total_cooks – تعداد دفعات cook شدن از زمان شروع.

• cook_time – زمان آخرین cook (ms).

• cook_frame – شماره فریم در تایم‌لاین هنگام cook.

• cook_abs_frame – شماره فریم مطلق هنگام cook.

• cook_start_time – زمان شروع cook (ms).

• cook_end_time – زمان پایان cook (ms).

• cooked_this_frame – آیا در این فریم cook شده است یا نه.

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

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