خلاصه (Summary)

File In CHOP برای خواندن فایل‌های کانال (Channel) و صوتی (Audio) جهت استفاده در CHOPها به‌کار می‌رود.
فایل می‌تواند از دیسک محلی یا از وب خوانده شود.
برای خواندن از وب، باید از پیشوند http:// در نام فایل استفاده کنی.

فرمت‌های معتبر (Valid Formats)

برای مشاهده فهرست کامل فرمت‌های معتبر برای CHOPها، به بخش File Types مراجعه کن.
فرمت‌هایی که توسط File In CHOP پشتیبانی می‌شوند شامل موارد زیر هستند:

• .chan – فایل‌های کانال ASCII خام؛ هر ردیف نشان‌دهنده یک فریم از داده‌های عددی است. نام کانال‌ها به‌صورت خودکار تعیین می‌شوند.

• .clip و .bclip – فایل‌های بومی CHOP در TouchDesigner.

• .aiff – فایل صوتی.

• .wav – فایل صوتی.

خروجی گرفتن از فایل‌های کانال (Outputting Channel Files)

همین نوع فایل‌ها را می‌توان از طریق منوی RMB (کلیک راست روی CHOP) و انتخاب گزینه Save Data Channels ذخیره کرد.

ورودی‌های دیگر (Other Input Devices)

برای فایل‌های MIDI با پسوند .mid یا .midi، از MIDI In CHOP استفاده کن.

Python API

📘 کلاس پایتون: fileinCHOP_Class

پارامترها – صفحه File In (Parameters – File In Page)

Channel File (file)

نام فایل برای بارگذاری. اگر فایل روی وب است، از پیشوند http:// استفاده کن.

Name Options (nameoption) ⊞

این منو کنترل می‌کند نام کانال‌های بارگذاری‌شده چگونه تعیین شوند:

• Use Names In File (infile): از نام‌های ذخیره‌شده در فایل استفاده می‌کند.

• Use New Names (new): از نامی که در پارامتر Name تعیین شده استفاده می‌کند.

• Use Filename (filename): از نام فایل به‌عنوان نام کانال استفاده می‌کند.

Name (name)

نامی که برای کانال‌ها استفاده می‌شود، زمانی که گزینه Use New Names انتخاب شده باشد.

Rate Options (rateoption) ⊞

تعیین می‌کند نرخ نمونه‌برداری (Sample Rate) کانال‌های بارگذاری‌شده چگونه باشد:

• No Change (nochange): از نرخ نمونه‌برداری موجود در فایل استفاده می‌شود.

• Override (override): نرخ نمونه‌برداری بر اساس عدد پارامتر Sample Rate تنظیم می‌شود، بدون اینکه داده‌ها Resample شوند.

• Resample (resample): داده‌ها بر اساس Sample Rate مشخص‌شده دوباره نمونه‌برداری می‌شوند (Resample) تا از مصرف زیاد حافظه جلوگیری شود.

Sample Rate (rate)

تعداد نمونه‌ها در هر ثانیه، که توسط Rate Options استفاده می‌شود.

Extend Left (left) ⊞

نحوه گسترش داده‌ها در سمت چپ (قبل از شروع محدوده):

• No Change (asis): بدون تغییر

• Hold (hold): نگه داشتن مقدار فعلی

• Slope (slope): ادامه دادن شیب داده‌ها قبل از شروع

• Cycle (cycle): چرخش داده‌ها به‌صورت تکراری

• Mirror (mirror): چرخش تکراری با آینه کردن چرخه‌ها

• Default Value (default): استفاده از مقدار ثابت تعیین‌شده در پارامتر Default Value

Extend Right (right) ⊞

نحوه گسترش داده‌ها در سمت راست (پس از پایان محدوده):

• No Change (asis)

• Hold (hold)

• Slope (slope)

• Cycle (cycle)

• Mirror (mirror)

• Default Value (default)

Default Value (defval)

مقدار ثابت برای شرایطی که گزینه Default Value انتخاب شده باشد.

Rename From (renamefrom)

الگوی کانال‌هایی که باید تغییر نام دهند. از Pattern Matching پشتیبانی می‌کند.

Rename To (renameto)

الگوی جایگزین برای نام‌های جدید. به‌صورت پیش‌فرض هیچ تغییری انجام نمی‌شود.
(به Pattern Replacement مراجعه کن)

Value Override Pattern (overridepattern)

الگوی کانال‌هایی که باید مقدارشان توسط Override Value جایگزین شود.

Override Value (overridevalue)

مقدار جایگزین برای کانال‌های انتخاب‌شده توسط الگوی بالا.

Refresh (refresh)

در صورت فعال بودن، فایل مجدداً بارگذاری می‌شود.

Refresh Pulse (refreshpulse)

با زدن پالس، فایل فوراً از دیسک بارگذاری مجدد می‌شود.

پارامترها – صفحه Common (Parameters – Common Page)

Time Slice (timeslice)

در صورت فعال بودن، CHOP به‌صورت Time Sliced محاسبه می‌شود (یعنی بین آخرین cook و cook فعلی).

Scope (scope)

مشخص می‌کند کدام کانال‌ها تحت تأثیر قرار می‌گیرند.

Sample Rate Match (srselect) ⊞

نحوه هماهنگ‌سازی نرخ نمونه‌برداری ورودی‌های مختلف:

• Resample At First Input’s Rate (first): مطابق با نرخ اولین ورودی

• Resample At Maximum Rate (max): مطابق با بالاترین نرخ

• Resample At Minimum Rate (min): مطابق با پایین‌ترین نرخ

• Error If Rates Differ (err): در صورت تفاوت نرخ، خطا ایجاد می‌شود

Export Method (exportmethod) ⊞

نحوه اتصال کانال CHOP به پارامترهای دیگر را تعیین می‌کند:

• DAT Table by Index (datindex): بر اساس اندیس

• DAT Table by Name (datname): بر اساس نام

• Channel Name is Path:Parameter (autoname): نام کانال شامل مسیر کامل مقصد است (مثلاً geo1/transform1:tx)

Export Root (autoexportroot)

نود ریشه‌ای که مسیرهای نسبی Export نسبت به آن محاسبه می‌شوند.

Export Table (exporttable)

DAT مورد استفاده برای ذخیره اطلاعات Export (در حالت‌های DAT Table).

کانال‌های Info CHOP (Info CHOP Channels)

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

Common CHOP Info Channels

• start: شروع بازه CHOP (بر حسب نمونه)

• length: تعداد نمونه‌ها

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

• num_channels: تعداد کانال‌ها

• time_slice: اگر فعال باشد مقدار ۱

• export_sernum: تعداد دفعات به‌روزرسانی Export

Common Operator Info Channels

• total_cooks: تعداد دفعات اجرای cook

• cook_time: زمان آخرین cook (میلی‌ثانیه)

• cook_frame: شماره فریم آخرین cook در تایم‌لاین

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

• cook_start_time / cook_end_time: زمان شروع و پایان cook

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

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

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