Orbbec TOP

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

خلاصه (Summary)

Orbbec TOP می‌تواند برای دریافت جریان‌های ویدئویی و داده‌های IMU از یک دوربین Orbbec استفاده شود.

  • جریان‌های ویدئویی موجود بستگی به دوربین متصل دارد، اما معمولاً شامل رنگ (Color)، عمق (Depth)، IR و داده ابر نقطه‌ای (Point Cloud) هستند.

  • این نود از Orbbec SDK استفاده می‌کند و فهرست مدل‌های دوربین سازگار در صفحه GitHub پروژه موجود است.

دوربین می‌تواند از طریق USB یا Ethernet متصل شود، بسته به مدل.

توجه: دریافت تصاویر رنگی ویدئو از طریق Ethernet ممکن است برای فریم‌ویرهای قدیمی پشتیبانی نشود. توصیه می‌شود فریم‌ویر دوربین خود را به آخرین نسخه‌ای که با Orbbec SDK سازگار است به‌روزرسانی کنید.

MacOS: اتصال به دوربین‌های Orbbec روی سیستم‌های MacOS نیازمند دسترسی root است.

  • می‌توانید TouchDesigner را با دسترسی root اجرا کنید: با باز کردن Terminal و استفاده از دستور:

sudo "/Applications/TouchDesigner.app/contents/MacOS/TouchDesigner"

برای دریافت بیش از یک جریان ویدئویی از یک دوربین، می‌توانید از یک یا چند Orbbec Select TOP که به Orbbec TOP اصلی لینک شده‌اند، استفاده کنید.

  • همه رزولوشن‌ها و پیکربندی توسط Orbbec TOP اصلی کنترل می‌شوند.

داده‌های ردیابی اسکلت (Skeleton Tracking) نیز می‌توانند از دوربین‌های Kinect Orbbec سازگار (Femto Mega، Femto Bolt و غیره) با استفاده از Kinect Azure TOP و Kinect Azure CHOP به دست آیند.
توجه: اگر از نودهای Kinect Azure با سخت‌افزار Orbbec استفاده می‌کنید، نباید Orbbec TOP را در همان پروژه استفاده کنید، زیرا ممکن است باعث ناپایداری شود.

می‌توان از Info CHOP برای مشاهده مقدار فعلی هر ویژگی دوربین پشتیبانی شده و از Info DAT برای دیدن مقادیر حداقل، حداکثر و پیش‌فرض هر ویژگی استفاده کرد.

PythonIcon.pngorbbecTOP_Class

فهرست مطالب

  1. Summary

  2. Parameters – Orbbec Page

  3. Parameters – Common Page

  4. Info CHOP Channels

    • 4.1 Common TOP Info Channels

    • 4.2 Common Operator Info Channels

Parameters – Orbbec Page

پارامترهای صفحه Orbbec

Active (active)
خاموش کردن این پارامتر ارتباط با دوربین را غیرفعال می‌کند.

  • این کار همچنین تمام Orbbec Select TOPهایی که به این TOP متکی هستند را متوقف می‌کند.

Device Source (devicesource) ⊞
مشخص می‌کند که از کدام حالت برای اتصال به دوربین استفاده شود.
توجه: معمولاً توصیه می‌شود از پارامتر Device منو برای اتصال استفاده کنید، نه وارد کردن مستقیم IP.

Device (device)
انتخاب شماره سریال دوربینی که می‌خواهید به آن متصل شوید.

  • فقط یک Orbbec TOP می‌تواند همزمان به یک دوربین متصل شود.

  • برای دریافت جریان‌های ویدئویی اضافی از همان دوربین از Orbbec Select TOP استفاده کنید.

  • دوربین‌های متصل از طریق USB و Ethernet توسط این منو قابل شناسایی هستند.

  • دوربین‌های متصل از طریق این منو می‌توانند پس از جدا و دوباره وصل شدن به صورت خودکار reconnect شوند.
    توجه: ممکن است تا ۳۰ ثانیه طول بکشد تا دوربین پس از اتصال ظاهر شود.

IP (ip)
آدرس IP دوربینی که می‌خواهید به آن متصل شوید.

Color Resolution (colorres) ⊞
انتخاب رزولوشن دوربین رنگی سنسور.

  • هر دوربین یک رزولوشن پیش‌فرض دارد که به طور خودکار استفاده می‌شود.

  • گزینه‌های اضافی بسته به مدل دوربین در منو ظاهر می‌شوند.

  • همه فریم‌ریت‌ها (FPS) برای همه رزولوشن‌ها در دسترس نیستند.

Color FPS (colorfps) ⊞
تنظیم نرخ فریم (FPS) برای دوربین رنگی.

  • دوربین به طور خودکار یک نرخ فریم پیش‌فرض فرض می‌کند.

Depth Resolution (depthres) ⊞
انتخاب رزولوشن دوربین عمق سنسور.

  • مشابه دوربین رنگی، رزولوشن پیش‌فرض خودکار دارد و گزینه‌های اضافی بسته به مدل ظاهر می‌شوند.

Depth FPS (depthfps) ⊞
تنظیم نرخ فریم دوربین عمق.

Depth Align Mode (depthalignmode) ⊞
این پارامتر برای تطبیق تصویر عمق با رزولوشن دوربین رنگی استفاده می‌شود.

  • ممکن است این کار در سخت‌افزار یا نرم‌افزار انجام شود بسته به مدل دوربین.

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

Image (image) ⊞
انتخاب کدام جریان ویدئویی دوربین در خروجی نود نمایش داده شود.

  • جریان‌های اضافی از همان دوربین را می‌توان با Orbbec Select TOP دریافت کرد.

Enable Gyro Sensor (gyro)
فعال کردن داده‌های IMU چرخشی از سنسور ژیروسکوپ در صورت وجود.

  • داده‌ها بر حسب درجه/ثانیه هستند و با وصل کردن Info CHOP به عنوان کانال CHOP قابل دسترسی‌اند.

Enable Accel Sensor (accel)
فعال کردن داده‌های شتاب خطی IMU از سنسور شتاب‌سنج در صورت وجود.

  • داده‌ها بر حسب m/s² هستند و با وصل کردن Info CHOP قابل دسترسی‌اند.

Properties CHOP (propschop)
مسیر CHOP ویژگی‌ها که مرجع گرفته می‌شود.

  • هر کانال CHOP نماینده یک OBPropertyID است که برای کنترل تنظیمات دوربین استفاده می‌شود.

  • نام کانال باید تمام حروف کوچک باشد و پیش‌وند OB_PROP_ را نداشته باشد.

  • برای مثال، نام کانال معتبر برای OB_PROP_COLOR_MIRROR_BOOL، color_mirror_bool است.

  • ویژگی‌های پشتیبانی شده بین مدل‌های مختلف دوربین متفاوت است.

  • مقدار فعلی هر ویژگی پشتیبانی شده در Info CHOP قابل مشاهده است.

  • مقادیر حداقل، حداکثر و پیش‌فرض هر ویژگی در Info DAT قابل مشاهده است.

Parameters – Common Page

پارامترهای عمومی

Output Resolution (outputresolution) ⊞
تغییر سریع رزولوشن داده‌های خروجی TOP.

Resolution (resolution) ⊞
فقط زمانی فعال است که Resolution روی Custom Resolution تنظیم شده باشد.

Resolution Menu (resmenu)
منوی کشویی با رزولوشن‌های رایج.

Use Global Res Multiplier (resmult)
استفاده از ضریب رزولوشن سراسری.

Output Aspect (outputaspect) ⊞
تنظیم نسبت تصویر خروجی.

Aspect (aspect) ⊞
زمانی استفاده می‌شود که Output Aspect روی Custom Aspect باشد.

Aspect Menu (armenu)
منوی کشویی نسبت‌های تصویر رایج.

Input Smoothness (inputfiltertype) ⊞
کنترل فیلتر پیکسلی روی تصویر ورودی TOP.

Fill Viewer (fillmode) ⊞
نحوه نمایش تصویر TOP در Viewer.

Viewer Smoothness (filtertype) ⊞
کنترل فیلتر پیکسلی در Viewerها.

Passes (npasses)
تکرار عملیات TOP به تعداد مشخص شده.

  • مشابه توضیحات Orbbec Select TOP

Channel Mask (chanmask)
انتخاب کانال‌های فعال (R، G، B، A).

Pixel Format (format) ⊞
فرمت ذخیره‌سازی داده هر کانال (R، G، B، A).

Info CHOP Channels

اطلاعات تکمیلی Orbbec TOP از طریق Info CHOP قابل دسترسی است.

کانال‌های اطلاعات مشترک TOP

  • resx – رزولوشن افقی TOP (پیکسل)

  • resy – رزولوشن عمودی TOP (پیکسل)

  • aspectx – نسبت افقی TOP

  • aspecty – نسبت عمودی TOP

  • depth – عمق آرایه 2D یا 3D اگر TOP حاوی بافت 2D یا 3D باشد

  • gpu_memory_used – میزان کل حافظه GPU مصرفی توسط TOP

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

  • 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 – تعداد خطاها