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

خلاصه (Summary)

اپراتور Photoshop In TOP می‌تواند خروجی تصویر از نرم‌افزار Photoshop را به‌صورت استریم (زنده) وارد TouchDesigner کند.
Photoshop می‌تواند روی همان کامپیوتری که TouchDesigner اجرا می‌شود یا روی هر کامپیوتر دیگری در شبکه در حال اجرا باشد. همچنین Photoshop می‌تواند روی سیستم‌عامل ویندوز یا مک اجرا شود.

اگر پارامتر Lock Document Name خالی گذاشته شود، این TOP هر سندی را که در حال حاضر در Photoshop فعال است دریافت می‌کند.


راه‌اندازی Photoshop (Photoshop Setup)

برای اتصال به Photoshop In TOP، باید یک اتصال ریموت (Remote Connection) در Photoshop تنظیم شود.

  1. یک فایل را در Photoshop باز کنید.

  2. از منوی Edit گزینه Remote Connections… را انتخاب کنید.

  3. در پنجره‌ای که باز می‌شود، یک Service Name و Password وارد کنید. سپس گزینه Enable Remote Connections را فعال کنید.

اکنون Photoshop آماده اتصال به TouchDesigner است. تصویر زیر، پنجره Remote Connections در Photoshop را نشان می‌دهد.

RemoteConnections.png


PythonIcon.pngphotoshopinTOP_Class


فهرست مطالب (Contents)

  1. Summary
     1.1 Photoshop Setup

  2. Parameters – Photoshop In Page

  3. Parameters – Common Page

  4. Operator Inputs

  5. Info CHOP Channels
     5.1 Specific Photoshop In TOP Info Channels
     5.2 Common TOP Info Channels
     5.3 Common Operator Info Channels


Parameters – Photoshop In Page

Active (active)
در صورت فعال بودن، TOP داده‌ها را از Photoshop دریافت می‌کند.

Address (address)
آدرس IP کامپیوتری که Photoshop روی آن اجرا می‌شود. اگر Photoshop و TouchDesigner روی یک سیستم هستند، می‌توان از localhost استفاده کرد. در غیر این صورت، آدرس IP موردنیاز در پنجره Remote Connection در Photoshop نمایش داده می‌شود.

Password (password)
رمز عبوری که در پنجره Remote Connection در Photoshop تعیین شده است را وارد کنید.

Image Format (imageformat) – ⊞
تعیین می‌کند استریم تصویر Photoshop با چه فرمتی منتقل شود.

Locked Document Name (lockeddocument)
برای قفل‌کردن ورودی Photoshop In TOP روی یک فایل مشخص که در Photoshop باز است استفاده می‌شود.

Lock to Current Document (locktocurrent)
با کلیک روی این دکمه، ورودی Photoshop In TOP روی سندی که هم‌اکنون در Photoshop فعال است قفل می‌شود. این دکمه مقدار پارامتر Locked Document Name را به‌صورت خودکار پر می‌کند.

Unlock (unlock)
پارامتر Locked Document Name را پاک می‌کند. در حالت آزاد (Unlocked)، Photoshop In TOP هر سندی را که در حال حاضر در Photoshop فعال است دریافت می‌کند.

Update Mode (updatemode) – ⊞
مشخص می‌کند تصویر به چه شکلی به‌روزرسانی شود.

Max Update Rate (maxupdaterate)
حداکثر نرخ به‌روزرسانی تصویر، زمانی که Update Mode روی حالت خودکار (Automatic) تنظیم شده باشد.

Update (update)
برای به‌روزرسانی دستی تصویر کلیک کنید.


Parameters – Common Page

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

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

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

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

این قابلیت زمانی مفید است که پروژه روی سیستم‌هایی با سخت‌افزار متفاوت اجرا شود. برای مثال اگر پروژه روی یک ورک‌استیشن قوی با حافظه گرافیکی بالا طراحی شده باشد، کاربری با لپ‌تاپی دارای تنها 64MB VRAM می‌تواند Global Resolution Multiplier را روی نصف یا یک‌چهارم قرار دهد تا پروژه با سرعت قابل قبول اجرا شود. با فعال بودن این گزینه، این TOP تحت تأثیر ضریب جهانی قرار می‌گیرد.

Output Aspect (outputaspect) – ⊞
نسبت تصویر خروجی را تنظیم می‌کند و اجازه می‌دهد تکسچرها در هر اندازه‌ای نمایش داده شوند.
هنگام کامپوزیت TOPهایی با نسبت تصویر متفاوت، مراقب نتایج غیرمنتظره باشید.
(می‌توان تصاویر با پیکسل‌های غیرمربعی تعریف کرد؛ جایی که xres/yres با aspectx/aspecty برابر نباشد.)

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

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

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

Fill Viewer (fillmode) – ⊞
تعیین می‌کند تصویر TOP چگونه در Viewer نمایش داده شود.

نکته: برای درک بهتر نحوه کار TOPها با تصاویر، در ابتدای کار بهتر است این گزینه را روی 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 مراجعه کنید.


Operator Inputs

Input 0:


Info CHOP Channels

اطلاعات تکمیلی مربوط به Photoshop In TOP از طریق یک Info CHOP قابل دسترسی است.

Specific Photoshop In TOP Info Channels

  • connected – وضعیت اتصال

  • receiving_updates – وضعیت دریافت به‌روزرسانی‌ها

Common TOP Info Channels

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

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

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

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

  • depth – عمق آرایه ۲بعدی یا ۳بعدی (در صورت وجود Texture Array)

  • gpu_memory_used – مقدار کل حافظه تکسچر مصرف‌شده توسط این TOP

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 شده باشد مقدار ۱

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

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