OAK Select TOP

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

خلاصه (Summary)

OAK Select می‌تواند تصاویر را در قالب‌های مختلف از دوربین OAK دریافت کند. این قالب‌ها شامل موارد زیر هستند:

  • تصویر RGB

  • تصویر تک‌رنگ (Monochrome)

  • تصاویر عمق (Depth)

  • ابرنقاط XYZ (Point Cloud)

همچنین ببینید:
OAK-D، OAK Device CHOP، OAK Select CHOP

فهرست مطالب

  1. Summary

  2. Parameters – OAK Page

  3. Parameters – Common Page

  4. Info CHOP Channels

    • 4.1 Specific oakselect TOP Info Channels

    • 4.2 Common TOP Info Channels

    • 4.3 Common Operator Info Channels

Parameters – OAK Page

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

Active (active) –
فعال یا غیرفعال‌سازی این TOP.

OAK Device CHOP (chop) –
ارجاع به OAK Device CHOP که ارتباط با دوربین OAK را مدیریت می‌کند.

Stream (stream) –
نام استریم (جریان داده) که از دوربین OAK دریافت می‌شود.

Cache Size (cachesize)
پارامتر Cache Size مشابه پارامتر Queue Size در OAK Select CHOP عمل می‌کند.
انتخاب مقدار 2 یک مقدار پیش‌فرض مناسب است، زیرا به TouchDesigner اجازه می‌دهد هم‌زمان با نوشتن غیرهمزمان داده‌های جدید در بافر باقی‌مانده، یک تصویر را به کاربر نمایش دهد.

Output Index (outputindex)
این پارامتر مشابه پارامتر Output Index در Cache TOP است.
در پایپ‌لاین‌های پیچیده‌تر depthAI (مانند مثال ردیابی دست)، داده‌های ردیابی دست با تأخیر بیشتری نسبت به تصاویر RGB به TouchDesigner می‌رسند.
با استفاده از مقدار منفی برای Output Index، می‌توان تصاویر را کمی به تأخیر انداخت تا هم‌زمانی بهتری با داده‌های ردیابی ایجاد شود.

Output Index Unit (outputindexunit) ⊞ –
واحد زمانی مورد استفاده برای Output Index (مثلاً فریم یا ثانیه).

Limit Max (limitmax)
زمانی که استریم یک تصویر عمق باشد (و نام استریم شامل کلمه‌ی depth باشد)، محدود کردن بیشینه‌ی عمق z-depth تصویر می‌تواند مفید باشد.
این مقدار بر حسب متر اندازه‌گیری می‌شود.

Output Format (outputformat) ⊞
TouchDesigner می‌تواند برخی پردازش‌های پایه‌ی تصویری را انجام دهد که depthAI هنوز آن‌ها را پیاده‌سازی نکرده است.
برای مثال، اگر Output Format روی Point Cloud تنظیم شود، استریم از نوع depth باشد و نام استریم شامل “depth” باشد، خروجی OAK Select یک ابرنقاط XYZ با دقت 32 بیت خواهد بود که از تصویر عمق و ماتریس درونی (intrinsic matrix) دوربین استخراج شده است.

Parameters – Common Page

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

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

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

Resolution Menu (resmenu)
منوی کشویی شامل چند رزولوشن متداول.

Use Global Res Multiplier (resmult)
از ضریب رزولوشن سراسری موجود در
Edit → Preferences → TOPs
استفاده می‌کند. این ضریب روی رزولوشن تمام TOPها اعمال می‌شود و برای سیستم‌هایی با توان سخت‌افزاری متفاوت بسیار کاربردی است.

Output Aspect (outputaspect) ⊞
تنظیم نسبت تصویر خروجی و اجازه‌ی نمایش تکسچرها در هر اندازه‌ای.
در ترکیب TOPهایی با نسبت تصویر متفاوت، ممکن است نتایج غیرمنتظره ایجاد شود.
(می‌توان تصاویر با پیکسل‌های غیرمربعی تعریف کرد.)

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

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

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

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

نکته:
برای درک بهتر نحوه‌ی عملکرد TOPها با تصاویر، هنگام شروع کار بهتر است Fill Viewer روی Native Resolution تنظیم شود تا تغییر اندازه‌ی خودکار Viewer اعمال نشود.

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

Passes (npasses)
عملیات TOP را به تعداد مشخص‌شده تکرار می‌کند.
در هر پاس بعد از اول، خروجی پاس قبلی جایگزین ورودی اول نود می‌شود.
تنها استثنا GLSL TOP در حالت Compute Shader است که ورودی آن همچنان تصویر TOP متصل باقی می‌ماند.

Channel Mask (chanmask)
انتخاب کانال‌هایی که TOP روی آن‌ها عمل می‌کند (R، G، B، A).
به‌صورت پیش‌فرض همه‌ی کانال‌ها فعال هستند.

Pixel Format (format) ⊞
فرمت ذخیره‌سازی داده برای هر کانال تصویر (R، G، B، A).
برای اطلاعات بیشتر به Pixel Formats مراجعه کنید.

Info CHOP Channels

کانال‌های اطلاعاتی CHOP

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

کانال‌های اختصاصی oakselect TOP

  • sequence_num – مطابق مقدار sequenceNum در مستندات depthAI.

  • messages_received – تعداد کل پیام‌هایی که با نام استریم تنظیم‌شده در OAK Select TOP دریافت شده‌اند.

  • fps – نرخ فریم مؤثر این استریم؛ یعنی سرعتی که TouchDesigner داده‌ها را دریافت می‌کند (این مقدار با FPS هدف استریم تفاوت دارد).

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

  • resx – رزولوشن افقی TOP بر حسب پیکسل.

  • resy – رزولوشن عمودی TOP بر حسب پیکسل.

  • aspectx – نسبت افقی تصویر.

  • aspecty – نسبت عمودی تصویر.

  • depth – عمق آرایه‌ی دوبعدی یا سه‌بعدی، در صورتی که TOP شامل تکسچر آرایه‌ای باشد.

  • gpu_memory_used – میزان کل حافظه‌ی گرافیکی مصرف‌شده توسط این 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 – تعداد خطاها (در صورت وجود).