خلاصه (Summary)

Audio Play CHOP یک فایل صوتی را از طریق هر دستگاه خروجی صوتی متصل با استفاده از DirectSound پخش می‌کند. این CHOP از فرمت‌های .aif، .mp3، .mid، .wav و .m4a تا نرخ نمونه‌برداری ۴۸ کیلوهرتز پشتیبانی می‌کند و می‌تواند شامل کانال‌های مونو، استریو یا تا ۵.۱ کانال باشد. کانال‌های صوتی سپس می‌توانند به هر موقعیت اسپیکری که DirectSound استفاده می‌کند، مسیر‌دهی شوند.

توجه: نمونه‌های صوتی وارد TouchDesigner نمی‌شوند و قابل پردازش در CHOPها نیستند. Audio Play CHOP یک فرآیند خارجی راه‌اندازی می‌کند که فایل را باز کرده و مستقیم به خروجی‌های صوتی سیستم می‌فرستد. اگر بخواهید صوت را داخل TouchDesigner پردازش کنید یا در Movie File Out TOP یا Audio Device Out CHOP خروجی بگیرید، باید از Audio File In CHOP استفاده کنید.

این CHOP شامل یک کانال به نام state است که ۱ است وقتی فایلی در حال پخش باشد و ۰ در غیر این صورت.

  • ورودی اول (Input 0: Triggers) برای فعال‌سازی پخش فایل صوتی است.

  • ورودی دوم (Input 1: Volume) برای کنترل صدا استفاده می‌شود؛ اگر متصل نباشد، از پارامتر Volume استفاده می‌شود.

  • ورودی سوم (Input 2: Pan) برای پانینگ است؛ اگر متصل نباشد، مرکز فرض می‌شود.

  • در صورت استفاده از DAT List، ورودی‌ها می‌توانند شامل چند کانال باشند تا هر فایل جداگانه کنترل شود.

  • چندین Audio Play CHOP می‌توانند به‌صورت همزمان به دستگاه‌های مختلف خروجی دهند.

این CHOP می‌تواند از طریق پارامتر Trigger نیز فعال شود؛ در این حالت اگر چند فایل در DAT List مشخص شده باشند، همه فایل‌ها همزمان پخش می‌شوند.

فایل‌ها همچنین می‌توانند از طریق متد .play() در audioplayCHOP_Class فعال شوند. برخی گزینه‌های پیشرفته فقط از طریق این کلاس در دسترس هستند.

فایل‌ها می‌توانند از دیسک یا وب خوانده شوند؛ برای وب از http:// استفاده کنید.

پارامترها – صفحه “AudioPlay”

  • Device (device): منوی دستگاه‌های صوتی برای خروجی. انتخاب default دستگاه انتخاب‌شده در Windows Control Panel > Sound > Playback را استفاده می‌کند.

  • Outputs (outputs):

  • Sound File (file): فایل صوتی .aif، .mp3، .mid، .wav یا .m4a (مونو یا استریو).

  • DAT List (datlist): اتصال به یک Table DAT که به‌عنوان فهرست فایل‌ها استفاده می‌شود. در این حالت ورودی اول (Input 0) می‌تواند چند کانال داشته باشد تا فایل‌ها جداگانه فعال شوند.

  • Volume (volume): 0 بی‌صدا، 1 حداکثر صدا. استفاده از Input 1 یا متد .play(volume=val) مقدار این پارامتر را بازنویسی می‌کند.

  • Mode (mode): ⊞ تعیین نحوه فعال شدن صدا با ورودی اول.

  • Trigger (trigger): فعال کردن پخش صدا.

  • Cook Every Frame (cookalways): اجبار CHOP برای cook هر فریم.

پارامترها – صفحه “Output 1”

  • Stereo Mode (stereo): خروجی را فقط به ۲ کانال جلو چپ و جلو راست تنظیم می‌کند.

  • Outputs: این صفحه و صفحه بعدی (Output 2) برای مسیر‌دهی کانال‌های فایل به خروجی‌های مختلف اسپیکر دستگاه هستند. همه دستگاه‌ها از همه خروجی‌ها پشتیبانی نمی‌کنند.

جدول نگاشت کانال‌ها برای خروجی‌ها:

  • -1 = بدون پخش

  • 0 = کانال جلو چپ فایل

  • 1 = کانال جلو راست فایل

  • 2 = کانال عقب چپ فایل

  • 3 = کانال عقب راست فایل

  • 4 = کانال مرکز فایل

  • 5 = کانال ساب یا فرکانس پایین

خروجی‌های صفحه Output 1:

  • Front Left (frontleft)

  • Front Right (frontright)

  • Front Center (frontcenter)

  • Low Frequency (lowfrequency)

  • Back Left (backleft)

  • Back Right (backright)

  • Front Left of Center (frontleftcenter)

  • Front Right of Center (frontrightcenter)

  • Back Center (backcenter)

پارامترها – صفحه “Output 2”

خروجی‌های اضافی:

  • Side Left (sideleft)

  • Side Right (sideright)

  • Top Center (topcenter)

  • Top Front Left (topfrontleft)

  • Top Front Center (topfrontcenter)

  • Top Front Right (topfrontright)

  • Top Back Left (topbackleft)

  • Top Back Center (topbackcenter)

  • Top Back Right (topbackright)

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

  • Time Slice (timeslice): فعال کردن Time Slice.

  • Scope (scope): تعیین کانال‌های تحت تأثیر.

  • Sample Rate Match (srselect): ⊞ مدیریت اختلاف نرخ نمونه‌برداری:

    • first = استفاده از نرخ ورودی اول

    • max = بازنمونه‌برداری به بالاترین نرخ

    • min = بازنمونه‌برداری به پایین‌ترین نرخ

    • err = خطا در صورت اختلاف نرخ

  • Export Method (exportmethod): ⊞ تعیین روش اتصال کانال CHOP به پارامتر.

    • DAT Table by Index (datindex)

    • DAT Table by Name (datname)

    • Channel Name is Path:Parameter (autoname)

  • Export Root (autoexportroot): مسیر ریشه برای مسیرهای Export.

  • Export Table (exporttable): جدول DAT برای نگهداری اطلاعات Export.

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

  • Input 0: Triggers

  • Input 1: Volume

  • Input 2: Pan

کانال‌های Info CHOP

کانال‌های خاص Audio Play CHOP:

  • device_default

  • sample_state0

  • sample_time0

  • sample_length0

  • sample_channels0

  • queue_read_pos0

  • queue_write_pos0

  • queue_length0

  • sample_name0_Notify

کانال‌های عمومی CHOP:

  • start, length, sample_rate, num_channels, time_slice, export_sernum

کانال‌های عمومی اپراتور:

  • total_cooks, cook_time, cook_frame, cook_abs_frame, cook_start_time, cook_end_time, cooked_this_frame, warnings, errors