خلاصه

Annotates (یادداشت‌ها) در Network Editor به صورت مستطیل‌های رنگی نمایش داده می‌شوند که شامل متن و گرافیک نوشته‌شده توسط کاربر هستند. این ابزار بر پایه‌ی Annotate COMP ساخته شده و امکان مستندسازی شبکه‌ها را با اطلاعات مفید مثل کامنت‌ها و گروه‌بندی نودها فراهم می‌کند.

سه حالت داخلی از Annotate COMP وجود دارد که به راحتی می‌توان آن‌ها را ایجاد کرد:

  • Comments (کامنت‌ها): یادداشت‌های ساده‌ی متنی (مانند Post-it). می‌توان آن‌ها را از منوی راست‌کلیک شبکه یا با کلید میانبر Shift + C ایجاد کرد.

  • Network Boxes (جعبه‌های شبکه): گروه‌بندی نودها برای برچسب‌گذاری/جابجایی. ایجاد از منوی راست‌کلیک یا میانبر Shift + B.

  • Annotates (یادداشت‌ها – حالت پیش‌فرض): شامل همه‌ی قابلیت‌های بالا + امکان نمایش قدرتمند نودها. ایجاد از منوی راست‌کلیک، میانبر Shift + A، کشیدن با Alt + کلیک چپ یا از طریق OP Create Dialog.

تنظیمات پیش‌فرض (Default Setup)

تنظیم پیش‌فرض Annotate COMP ترکیبی از یک کامنت، جعبه شبکه و نمایشگر نود است. این ابزار یک روش قدرتمند برای سازمان‌دهی و مستندسازی شبکه‌هاست.

  • آیکون قفل در گوشه‌ی بالا سمت راست برای قفل/بازکردن ویرایش متن استفاده می‌شود.

  • در حالت قفل‌شده نمی‌توان متن را تغییر داد و کلیک روی بدنه باعث انتخاب شبکه‌ی زیرین می‌شود.

  • Annotates را می‌توان با کشیدن لبه‌ها تغییر اندازه داد یا با کشیدن نوار عنوان جابجا کرد. در حالت کامنت (بدون نوار عنوان)، جابجایی از طریق متن انجام می‌شود.

  • اگر گزینه‌ی Enclose OPs فعال باشد، هنگام جابجایی Annotate تمام نودهای درون آن هم جابجا می‌شوند. با نگه داشتن Alt می‌توان فقط خود Annotate را جابجا کرد.

ویژگی‌های کلیدی:

  • Annotates شامل نمایشگر داخلی OP هستند (قابل کنترل در صفحه‌ی OP Viewer).

  • ویژگی‌های متنی پایه در صفحه‌ی Text و ویژگی‌های پیشرفته مثل رنگ، محدودیت عرض متن و … در صفحه‌ی Settings قرار دارند.

  • Annotates به صورت لایه‌ای نمایش داده می‌شوند. کنترل بیشتر از طریق Depth Layer امکان‌پذیر است.

  • پیش‌فرض پشت شبکه (grid) قرار می‌گیرند، اما می‌توان آن‌ها را روی گرید یا حتی بالای نودها نمایش داد.

پارامترها

صفحه‌ی Text

  • Title Text: متن عنوان

  • Title Height: ارتفاع نوار عنوان

  • Title Align: چینش عنوان (چپ، وسط، راست)

  • Body Text: متن بدنه

  • Body Font Size: اندازه فونت بدنه

  • Limit Body Text Width / Max Width: محدودیت عرض متن و تنظیم شکست خط

صفحه‌ی Settings

  • Mode: تغییر بین حالت‌های Comment / Network Box / Annotate

  • Smart Quote: اصلاح خودکار گیومه، خط فاصله، …

  • Body Word Wrap: شکست متن بدنه در صورت طولانی بودن

  • Back Color / Alpha: رنگ و شفافیت پس‌زمینه

  • Opacity: شفافیت کلی Annotate

صفحه‌ی OP Viewer

کنترل نمایشگر داخلی اپراتور:

  • Viewer Display: فعال/غیرفعال کردن نمایشگر

  • OP: انتخاب اپراتور برای نمایش

  • Interactive: فعال کردن تعامل کاربر با نمایشگر

  • Size/Aspect Override & Scale: تنظیم اندازه و مقیاس نمایشگر

  • Offset & Zoom: تغییر موقعیت و زوم روی بخش خاصی از نود (مثل CHOP یا DAT)

  • Fill Alpha: شفافیت پس‌زمینه نمایشگر

صفحه‌ی About

  • Version: نسخه Annotate COMP

  • Help: لینک به صفحه راهنما

Annotate Extension

اعضا (Members):

  • BodyColor → رنگ RGBA بدنه

  • BodyFontColor → رنگ فونت متن بدنه

  • BodyText → متن بدنه

  • TitleColor → رنگ RGBA نوار عنوان

  • TitleFontColor → رنگ فونت عنوان

  • TitleText → متن عنوان

  • EncloseOPs → تعیین می‌کند که Annotate نودهای داخلش را شامل شود یا نه

متدها (Methods):

  • OnCreate(Mode) → فراخوانی هنگام ایجاد Annotate (حالت “annotate”، “comment” یا “networkbox”)

صفحه‌ی Annotate

  • Operator Viewer: اپراتوری که درون Annotate نمایش داده می‌شود

  • Enable Interaction: فعال/غیرفعال کردن تعامل

  • Enclose Operators: شامل کردن نودهای داخل محدوده Annotate

  • Utility: مشخص می‌کند Annotate یک نود کمکی (Utility) باشد یا نه

  • Layer Zone & Depth Layer: کنترل لایه‌بندی در شبکه

صفحه‌ی Extensions

تنظیمات مرتبط با اکستنشن‌های پایتون Annotate

صفحه‌ی Common

پارامترهای عمومی مثل Parent Shortcut، Clone Master، Load on Demand، External .tox و …

Info CHOP Channels

اطلاعات اضافی Annotate COMP از طریق Info CHOP قابل دسترسی است.

Common COMP Info Channels

  • num_children → تعداد نودهای داخلی

Common Operator Info Channels

  • total_cooks → تعداد دفعات cook شدن

  • cook_time → مدت cook آخر (میلی‌ثانیه)

  • cook_frame → شماره فریم cook در تایم‌لاین

  • cook_abs_frame → شماره فریم cook در زمان مطلق

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

  • cooked_this_frame → اگر در این فریم cook شده باشد مقدار 1

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

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