Web Render TOP

خلاصه

Web Render TOP یک URL یا DAT را دریافت کرده و با استفاده از فرآیندهای جداگانه مرورگر که از Chromium Embedded Frameworks (CEF) استفاده می‌کنند، یک وب‌سایت را رندر می‌کند و نتیجه را از طریق حافظه مشترک به TouchDesigner بازمی‌گرداند.

نام فرآیندها با TouchDesigner Web Render شروع می‌شود و ممکن است برای هر Web Render TOP چندین فرآیند ایجاد شود. این TOP صفحات غیر فلش مانند HTML، HTML5، PDF، SVG و غیره را رندر می‌کند. صفحات می‌توانند در اینترنت باشند، در فایل‌های محلی با syntax file:// باشند یا از یک DAT خوانده شوند.

برای دریافت وضعیت صفحه و تعداد دفعات رندر شدن، می‌توانید یک Info CHOP متصل کنید.

برای دریافت handle حافظه مشترک، وضعیت فرآیند مرورگر، process_id، نسخه‌های CEF و Chromium، URL نمایش داده شده، عنوان صفحه و وضعیت خطای فرآیند، می‌توانید یک Info DAT متصل کنید.

همچنین به منابع زیر مراجعه کنید: Palette:webBrowser، Audio Web Render CHOP، Palette:SVG

پارامترها – صفحه Web Render

  • Active (فعال): فعال یا غیرفعال کردن Web Render TOP.

  • Source (منبع): منبع وب‌سایت، که می‌تواند یک URL، فایل یا داده از یک DAT باشد.

  • URL or File (آدرس URL یا فایل): آدرس یکنواخت منبع یا وب‌سایت.

  • DAT: متن برای بارگذاری در صفحه وب.

  • Reload Source (بارگذاری مجدد منبع): بارگذاری مجدد DAT، URL یا فایل.

  • Reload Current Page (بارگذاری مجدد صفحه فعلی): همانند refresh مرورگر وب.

  • Reset Update Count (بازنشانی شمارنده به‌روزرسانی): شمارنده تعداد به‌روزرسانی‌های صفحه وب را بازنشانی می‌کند (از طریق Info CHOP قابل دسترسی است).

  • Only Update when Loaded (به‌روزرسانی فقط پس از بارگذاری کامل): صفحه وب تنها وقتی نمایش داده می‌شود که کامل بارگذاری شده باشد.

  • Cook Always (همیشه Cook شود): اگر فعال باشد، هر فریم Cook می‌شود. اگر خاموش باشد، TOP پس از آخرین به‌روزرسانی، ۱۰ فریم اضافی Cook می‌شود تا تداوم حفظ شود.

  • Transparent Background (پس‌زمینه شفاف): صفحه وب با پس‌زمینه شفاف بارگذاری می‌شود. این گزینه باعث راه‌اندازی مجدد فرآیند مرورگر می‌شود.

  • Audio Options (تنظیمات صوتی): اجازه می‌دهد مرورگر صدا را پخش کند اگر صفحه حاوی صوت باشد. راه‌اندازی مجدد فرآیند مرورگر انجام می‌شود.

  • Enable Media Stream (فعال‌سازی Media Stream): اجازه می‌دهد Web Render از میکروفون و دوربین استفاده کند.

  • Redirect Popups (هدایت Popups): به جای نادیده گرفتن popups، TOP به URL pop-up هدایت می‌شود.

  • Maximum Render Frame Rate (حداکثر نرخ فریم رندر): حداکثر نرخ فریم رندر صفحه را تنظیم می‌کند. می‌تواند بالاتر از ۶۰ باشد ولی تضمینی برای نرخ ثابت وجود ندارد.

  • Number of Frame Buffers (تعداد بافر فریم‌ها): حداکثر تعداد تصاویر کش شده را مشخص می‌کند.

  • DPI Scaling Factor (ضریب مقیاس DPI): ضریب DPI صفحه وب رندر شده را تنظیم می‌کند. مقدار پیش‌فرض با DPI Scale مانیتور ۰ TouchDesigner مطابقت دارد.

  • Use Shared Texture (استفاده از بافت مشترک): یک بافت Direct3D 11 بین TouchDesigner و فرآیند Web Render به جای حافظه مشترک به اشتراک گذاشته می‌شود (تنها در ویندوز).

  • User Cache Directory (دایرکتوری کش کاربر): دایرکتوری پایدار برای ذخیره داده‌های کاربر توسط CEF. این دایرکتوری باید برای هر Web Render TOP یکتا باشد، در غیر این صورت خطا می‌دهد. به طور پیش‌فرض، یک دایرکتوری موقت برای هر TOP ایجاد می‌شود.

  • Modify Header DAT (تغییر هدر DAT): تغییر هدر درخواست برای یک URL مشخص. یک جدول با ستون‌های Name, Value و URL مشخص کنید. اگر URL مطابقت داشت، Name و Value جایگزین هدر موجود می‌شوند.

  • Options (گزینه‌ها): گزینه‌های اضافی که به فرآیند مرورگر ارسال می‌شوند. باعث راه‌اندازی مجدد مرورگر می‌شود.

  • Restart if Process Died (راه‌اندازی مجدد در صورت قطع فرآیند): در صورت قطع فرآیند، مرورگر را به‌طور خودکار راه‌اندازی می‌کند.

  • Restart (راه‌اندازی مجدد دستی): با دکمه، فرآیند را بلافاصله راه‌اندازی مجدد می‌کند (دسترسی در Python با pulse() امکان‌پذیر است).

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

  • Output Resolution / Resolution / Resolution Menu (رزولوشن خروجی / رزولوشن / منوی رزولوشن): تغییر سریع رزولوشن TOP و استفاده از رزولوشن‌های سفارشی یا استاندارد.

  • Use Global Res Multiplier: استفاده از ضریب رزولوشن جهانی (مفید برای سیستم‌های با سخت‌افزار متفاوت).

  • Output Aspect / Aspect / Aspect Menu: تنظیم نسبت تصویر خروجی.

  • Input Smoothness: کنترل فیلتر پیکسل روی تصویر ورودی TOP.

  • Fill Viewer: نحوه نمایش تصویر در viewer (برای درک بهتر، Native Resolution توصیه می‌شود).

  • Viewer Smoothness: کنترل فیلتر پیکسل در viewer.

  • Passes: تکرار عملیات TOP برای چند پاس.

  • Channel Mask: انتخاب کانال‌های R، G، B، A.

  • Pixel Format: فرمت ذخیره‌سازی داده‌ها برای هر کانال.

کانال‌های Info CHOP

کانال‌های اختصاصی Web Render TOP

  • num_handle_updates: تعداد به‌روزرسانی‌های دریافت شده از CEF

  • loaded: وضعیت بارگذاری صفحه

  • update_frame: آخرین فریم به‌روزرسانی

  • update_abs_frame: آخرین به‌روزرسانی در فریم‌های مطلق

  • updates_per_second: نرخ فریم تصاویر دریافتی

  • num_skipped_updates: تعداد به‌روزرسانی‌های دریافت شده که رندر نشده‌اند

  • error_code: کد خطای صفحه وب

  • audio: وضعیت صوتی، ۱ اگر صدا در Web Render شروع شده باشد

کانال‌های عمومی TOP

  • resx / resy: رزولوشن افقی و عمودی

  • aspectx / aspecty: نسبت ابعاد

  • depth: عمق آرایه 2D یا 3D

  • gpu_memory_used: حافظه GPU مصرف شده

کانال‌های عمومی Operator

  • total_cooks / cook_time / cook_frame / cook_abs_frame / cook_start_time / cook_end_time / cooked_this_frame / warnings / errors مشابه سایر TOPها