OpenColorIO TOP

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

خلاصه (Summary)

OpenColorIO TOP از کتابخانه OpenColorIO (http://opencolorio.org/) استفاده می‌کند تا تبدیل‌ها و جدول‌های جستجو (LUTs) مختلف را روی تکسچرها و تصاویر شما اعمال کند.
ترتیب پیش‌فرض اعمال تبدیل‌ها به این شکل است:

Color Space → File → CDL → Output (Display)

این ترتیب می‌تواند با استفاده از چند OpenColorIO TOP به صورت زنجیره‌ای تغییر کند، با این امکان که تبدیل‌های غیرضروری خاموش شوند.

فضای رنگی TOPهای TouchDesigner خطی (Linear) است، بنابراین معمولاً تصاویر وارد شده به TouchDesigner باید به خطی تبدیل شوند، اگر به صورت غیرخطی رمزگذاری شده باشند.

PythonIcon.pngopencolorioTOP_Class

فهرست مطالب

  1. Summary

  2. Parameters – Setup Page

  3. Parameters – Color Space Transform Page

  4. Parameters – File Transform Page

  5. Parameters – CDL Transform Page

  6. Parameters – Output Page

  7. Parameters – Common Page

  8. Operator Inputs

  9. Info CHOP Channels

    • 9.1 Common TOP Info Channels

    • 9.2 Common Operator Info Channels

Parameters – Setup Page

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

Configuration File (config) –
فایلی که شامل تمام اطلاعات مربوطه مانند LUTها، تبدیل‌ها، فضاهای رنگی، ویوها و نمایشگرها است.
چند نمونه کانفیگ در مسیر نصب برنامه: /Samples/OpenColorIO موجود است.

Reload Config (reloadconfig) –
بازخوانی دستی فایل کانفیگ.

Parameters – Color Space Transform Page

پارامترهای صفحه Color Space Transform

Use Transform (usecolorspacetransform) –
فعال یا غیرفعال کردن اثر این تبدیل.
تبدیل فضای رنگ، تصویر را از یک فضای رنگی به فضای رنگی دیگر منتقل می‌کند.

Input (incolorspace) –
تعیین فضای رنگ ورودی، یعنی فضای رنگ تصویر وارد شده.

Output (outcolorspace) –
تعیین فضای رنگ خروجی. تصویر از فضای رنگ ورودی به این فضای رنگ تبدیل می‌شود.

Parameters – File Transform Page

پارامترهای صفحه File Transform

Use Transform (usefiletransform) –
فعال یا غیرفعال کردن اثر این تبدیل.
تبدیل فایل، فایل‌های تبدیل فضای رنگ را اعمال می‌کند.
چندین فرمت فایل پشتیبانی می‌شود، مانند spi1d و spi3d.

File Source (filesource) –
فایلی که باید بارگذاری شود.
توجه: فایل انتظار دارد تصویر در فضای رنگی خاصی باشد و تبدیل فایل این موضوع را داخلی مدیریت نمی‌کند. پس مطمئن شوید تصویر قبل از اعمال تبدیل در فضای رنگی صحیح است، در غیر این صورت نتایج نادرست خواهد بود.

Interpolation (interpolation) ⊞
روش درونیابی فایل.

Direction (filedirection) ⊞
جهت تبدیل. برای معکوس کردن تبدیل، Inverse را انتخاب کنید.

Parameters – CDL Transform Page

پارامترهای صفحه CDL Transform

CDL Mode (cdlmode) ⊞
Color Decision List – تعیین اثر این تبدیل روی تصویر، یا با مقادیر دستی پارامترها یا با فایل اصلاح رنگ .cc.
ASC CDL

Slope (slope) ⊞
تنظیم گین (Gain).

Offset (offset) ⊞
تنظیم آفست (Offset).

Power (power) ⊞
تنظیم گاما (Gamma).

Saturation (saturation)
تنظیم اشباع رنگ.

Direction (cdldirection) ⊞
جهت تبدیل. برای معکوس کردن تبدیل، Inverse را انتخاب کنید.

Color Correction File (ccfile)
به جای مقادیر دستی، می‌توان اطلاعات Slope، Offset، Power و Saturation را از فایل اصلاح رنگ .cc بارگذاری کرد.

Parameters – Output Page

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

Use Output (useoutput) –
فعال یا غیرفعال کردن تبدیل نمایش.
تبدیل نمایش امکان تبدیل فضای رنگ برای دستگاه‌های نمایش خاص را می‌دهد.

Gain (gain)
تنظیم نوردهی قبل از تبدیل نمایش.

Display (display)
فضای رنگ دستگاهی که تصویر روی آن نمایش داده می‌شود.

View (view)
تعیین تبدیل فضای رنگی که روی تصویر اعمال می‌شود.

Input Color Space (colorspace)
تعیین فضای رنگ ورودی.

Gamma (gamma)
تنظیم میزان اصلاح گاما بعد از تبدیل نمایش.

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) ⊞
تنظیم نسبت تصویر خروجی و امکان نمایش تکسچرها در هر اندازه.

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 به تعداد مشخص شده.

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

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

Operator Inputs

  • Input 0: –

Info CHOP Channels

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

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

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

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

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

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

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

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

  • 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 – تعداد خطاها (در صورت وجود).