OSC Out DAT

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

خلاصه (Summary)

OSC Out DAT برای ارسال اطلاعات از طریق اتصال OSC بین کامپیوترهایی که در مکان‌های مختلف قرار دارند استفاده می‌شود.
برای ارسال پیام‌های OSC از متد پایتونی .sendOSC() استفاده می‌شود.

OSC Bundle‌ها این امکان را می‌دهند که به‌جای ارسال چند پیام جداگانه، یک گروه از پیام‌ها را با یک دستور واحد ارسال کنید.
تابع sendOSC() در OSC Out DAT می‌تواند یک لیست از پیام‌ها را دریافت کرده و در صورتی که پارامتر asBundle=True تنظیم شود، آن‌ها را به‌صورت یک Bundle ارسال کند.

Bundleها در اصل به‌عنوان یک بهینه‌سازی عملکرد برای کنترل بلادرنگ (Real-time) سینتی‌سایزرها با تعداد زیادی پارامتر ایجاد شده‌اند.
(با تشکر از Jesse Gilbert)

همچنین ببینید:
OSC، OSC In DAT، OSC In CHOP، OSC Out CHOP، iOS و OSC، Network Protocols، Sync

نکته مخصوص ویندوز:
اگر با مشکل اتصال مواجه شدید، مطمئن شوید که Windows Firewall غیرفعال باشد.

محتویات (Contents)

  1. Summary

  2. Parameters – Connect Page

  3. Parameters – Received Messages Page

  4. Parameters – Common Page

  5. Operator Inputs

  6. Info CHOP Channels
     6.1 Specific OSC Out DAT Info Channels
     6.2 Common DAT Info Channels
     6.3 Common Operator Info Channels

Parameters – Connect Page

Active (active)
وقتی روشن باشد، DAT اطلاعات را از/به پورت شبکه دریافت و ارسال می‌کند.
وقتی خاموش باشد، هیچ به‌روزرسانی‌ای انجام نمی‌شود و داده‌های ارسالی به پورت از بین می‌روند.

Protocol (protocol) ⊞
انتخاب پروتکل شبکه مورد استفاده.
برای اطلاعات بیشتر به مقاله Network Protocols مراجعه کنید.

Network Address (address)
آدرس شبکه‌ی کامپیوتر مقصد هنگام استفاده از UDP.
در حالت Multi-cast، این آدرس، آدرس مولتی‌کست مقصد است.
این آدرس می‌تواند یک آدرس استاندارد وب باشد (مانند foo یا foo.bar.com) یا یک IP (مثلاً 100.123.45.78).
اگر مقدار “localhost” وارد شود، یعنی مقصد روی همان کامپیوتر قرار دارد.

Port (port)
پورتی که داده‌ها به آن ارسال می‌شوند.

Local Address (localaddress)
تعیین آدرس IP محلی برای ارسال داده‌ها؛
مفید در سیستم‌هایی که چند کارت شبکه (NIC) دارند و می‌خواهید مشخص کنید ارسال از کدام انجام شود.

Shared Connection (shared)
استفاده از همان اتصال شبکه‌ای که سایر DATهای شبکه با همان پروتکل استفاده می‌کنند.

OSC Address Scope (addscope)
برای محدودکردن کانال‌هایی که تولید می‌شوند می‌توان از الگوهای نام کانال برای شامل یا حذف‌کردن کانال‌ها استفاده کرد.
مثال:

^*accel*

کانال‌های شتاب‌سنج را که از اپ‌های iOS یا iPhone مانند mrmr می‌آیند حذف می‌کند.
برای سینتکس الگوها به بخش Pattern Matching مراجعه کنید.

Include Type Tag (typetag)
تگ نوع آرگومان‌ها را در هر پیام قرار می‌دهد تا در صورت نیاز، نرم‌افزار گیرنده بتواند نوع پارامترها را تشخیص دهد.

Split Bundle into Messages (splitbundle)
در صورت فعال‌بودن، هر پیام داخل یک Bundle در یک ردیف جداگانه قرار می‌گیرد.

Split Message into Columns (splitmessage)
در صورت فعال‌بودن، آدرس OSC و آرگومان‌ها در ستون‌های جداگانه قرار می‌گیرند؛
در غیر این صورت همگی در ستون message نمایش داده می‌شوند.

Bundle Timestamp Column (bundletimestamp)
در صورت فعال‌بودن، مقدار تایم‌استمپ هر Bundle در یک ستون جداگانه اضافه می‌شود.

Parameters – Received Messages Page

Callbacks DAT (callbacks)
DAT حاوی Callbackهایی که برای هر پیام دریافتی اجرا می‌شوند.

Execute from (executeloc) ⊞
مشخص می‌کند اسکریپت از کدام مکان اجرا شود.

From Operator (fromop)
اپراتوری که تغییر وضعیت آن باعث اجرای اسکریپت می‌شود (در حالت Specified Operator).
همچنین مسیر اجرای اسکریپت نیز خواهد بود.

Clamp Output (clamp)
به‌صورت پیش‌فرض خروجی به ۱۰۰ پیام محدود است؛
با فعال‌بودن Clamp Output می‌توان آن را به هر مقداری، حتی نامحدود، تغییر داد.

Maximum Lines (maxlines)
حداکثر تعداد پیام‌ها؛ پیام‌های قدیمی‌تر زودتر حذف می‌شوند.

Clear Output (clear)
تمام خطوط به‌جز هدر را حذف می‌کند.
پاک‌سازی با پایتون:

op("opname").par.clear.pulse()

Bytes Column (bytes)
بایت‌های خام پیام را در یک ستون جداگانه خروجی می‌دهد.

Parameters – Common Page

Language (language) ⊞
انتخاب زبان اسکریپت.

Edit/View Extension (extension) ⊞
پسوند فایلی که DAT برای ویرایشگرهای خارجی نمایش می‌دهد.

Custom Extension (customext)
تعریف پسوند سفارشی.

Word Wrap (wordwrap) ⊞
فعال‌سازی Word Wrap در نمایش نود.

Operator Inputs

Input 0: —

Info CHOP Channels

اطلاعات تکمیلی OSC Out DAT از طریق یک Info CHOP در دسترس است.

Specific OSC Out DAT Info Channels

messages_pending
تعداد پیام‌های در صف ارسال.

Common DAT Info Channels

  • num_rows : تعداد ردیف‌های DAT

  • num_cols : تعداد ستون‌های DAT

Common Operator Info Channels

  • total_cooks : تعداد دفعات Cook شدن اپراتور از زمان شروع

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

  • cook_frame : شماره فریم آخرین Cook نسبت به تایم‌لاین کامپوننت

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

  • cook_start_time : زمان شروع Cook (میلی‌ثانیه)

  • cook_end_time : زمان پایان Cook (میلی‌ثانیه)

  • cooked_this_frame : اگر در این فریم Cook شده باشد مقدار 1

  • warnings : تعداد هشدارها (در صورت وجود)

  • errors : تعداد خطاها (در صورت وجود)