آموزش Text TOP در نرم افزار Touchdesigner

ویدئوی آموزشی youtube

ویدئو آموزشی Aparat

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

خلاصه

Text TOP رشته‌های متنی را به‌صورت تصویر نمایش می‌دهد. این ماژول از چندین فونت، اندازه، رنگ، حاشیه، فاصله بین کاراکترها و فاصله بین خطوط پشتیبانی می‌کند. متن می‌تواند به‌صورت بیت‌مپ، خطوط آنتی‌الیاس‌شده، یا کاراکترهای چندضلعی توپر نمایش داده شود. هر فونت TrueType را می‌توان با Text TOP رندر کرد. پشتیبانی از یونیکد وجود دارد. روش جدید Scalable Display Method با استفاده از Slug Library متن مقیاس‌پذیر و مستقل از رزولوشن را با بالاترین کیفیت ممکن در Text TOP رندر می‌کند.

این ماژول می‌تواند رشته‌های متنی ساده با مقادیر عددی توکار نمایش دهد. همچنین قادر است خطوط متن و اعداد را در قالب اعشاری یا ممیز شناور قالب‌بندی کند؛ به‌طوری‌که اعداد از یک CHOP خوانده می‌شوند و از کاراکترهای قالب‌بندی ویژه استفاده می‌شود.

همچنین می‌تواند رشته‌های متنی را از یک Table DAT از طریق پارامتر Specification DAT رندر کند؛ در این حالت، سرستون‌ها نام پارامترهایی هستند که هنگام رندر هر سطر از جدول، مقداردهیِ جایگزین (override) می‌شوند.

هر فونت TrueType یا OpenType که در ویندوز بارگذاری شده باشد، توسط Text TOP قابل رندر است. برای وارد کردن فونت جدید به سیستم ویندوز، پوشه Fonts را در Control Panel باز کرده و فایل‌های فونت (.ttf/.otf) را در آن Drag & Drop کنید. همچنین می‌توان مسیر فایل‌های .ttf/.otf را مستقیماً در پارامتر Font File مشخص کرد.

برای رندر متن یونیکد، متن را به‌صورت یک رشته پایتون بخوانید. بخش Unicode را ببینید.

نکته: می‌توانید از عضو textTOP_Class.textWidth برای محاسبه عرض متن در Text TOP استفاده کنید.

همچنین ببینید: Field COMP، Text SOP، Unicode

فهرست مطالب

  1. خلاصه

  2. پارامترها – صفحه Text

  3. پارامترها – صفحه Font

  4. پارامترها – صفحه Color

  5. پارامترها – صفحه Output

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

  7. ورودی‌های اپراتور

  8. کانال‌های Info CHOP
      8.1 کانال‌های اختصاصی Info برای Text TOP
      8.2 کانال‌های Info مشترک TOP
      8.3 کانال‌های Info مشترک اپراتور

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

Field Component field
یک Field Component را به‌عنوان منبع متن مشخص می‌کند. فونت و استایل متنی که در Field Component نمایش داده می‌شود، از طریق پارامترهای Text TOP تنظیم می‌گردد.

DAT dat
یک DAT را به‌عنوان منبع متن مشخص می‌کند. یک DAT را روی این فیلد Drag & Drop کنید یا مسیر DAT را دستی وارد نمایید.

DAT Row rowindex
شماره سطر (از 0 شروع می‌شود) در صورتی که DAT یک جدول باشد.

DAT Col colindex
شماره ستون سلول، در صورتی که DAT یک جدول باشد.

Specification DAT specdat
یک Table DAT که امکان تعیین و جایگذاری متن بر اساس پیکسل را می‌دهد؛ به‌طوری‌که گوشه پایین-چپ (0,0) در نظر گرفته می‌شود. سرستون‌ها باید شامل position1 یا x، position2 یا y و text باشند. نمونه جدول:

x y text
0 0 lower left text
100 100 somewhere in the middle

Text text
یک رشته متنی. به‌صورت اختیاری می‌تواند با یک مقدار عددی و یک متن پس از آن (Post Text) همراه شود که با پارامترهای Value و Post Text تنظیم می‌شوند. اگر به خط جدید یا تب نیاز دارید، توصیه می‌شود پارامتر را به حالت Expression ببرید و یک رشته پایتون شامل \n یا \t بنویسید؛ مانند:
'First Line\nSecond Line'

Legacy Parsing legacyparsing
در نسخه‌های قدیمی‌تر، نحوهایی مانند \XXX (مثلاً \200 برای کاراکتر 200)، \t، \n و همچنین [] و {} (برای موقعیت‌دهی رشته‌ها) داخل متن پردازش می‌شدند. این روش اکنون منسوخ شده است. برای کدهای کاراکتری، از نحو پایتون \t و \n استفاده کنید و برای موقعیت‌دهی از Specification DAT بهره ببرید. با فعال‌سازی این گزینه می‌توانید پردازش قدیمی را دوباره فعال کنید. اگر فعال باشد و بخواهید کاراکترهای \ [ ] { } را نمایش دهید، باید قبلشان \ بگذارید.

Append Value appendvalue
فیلد Value را فعال می‌کند. این مقدار بین Text و Post Text درج می‌شود.

Value valuetouse
مقدار عددی برای نمایش.

Total Digits totaldigits
تعداد کل ارقام نمایش‌داده‌شده.

Decimal Digits decimaldigits
تعداد ارقام بعد از ممیز.

Post Text posttext
متنی که پس از Text و Value (در صورت وجود) اضافه می‌شود.

CHOP Value %-Replace chopvaluereplace
اجازه می‌دهد بخش‌هایی از رشته‌ها با مقادیر CHOP جایگزین شوند؛ با نحوی شبیه printf/sprintf در زبان C. جزئیات نحو در پارامتر بعدی (CHOP) آمده است.

CHOP chop
CHOP شامل تمام مقادیری که باید در رشته‌های متنی درج شوند. Text TOP رشته Text را تکرار می‌کند تا تمام کانال‌های CHOP نمایش داده شوند. درج با نحوی آغازشونده با % انجام می‌شود؛ مثلاً %4d:

%[flags][width][.precision][type]

  • flags (اختیاری): گزینه‌های تراز
    - تراز چپ (پیش‌فرض تراز راست است)
    0 پر کردن سمت چپ با صفر

  • width (اختیاری): تعداد کل ارقام

  • precision (اختیاری): تعداد ارقام بعد از ممیز

  • type: قالب عدد
    d عدد صحیح
    f عدد اعشاری
    g عدد double؛ قالب نمایی فقط وقتی استفاده می‌شود که توان مقدار کمتر از ±4 باشد.

یک CHOP را Drag & Drop کنید یا مسیرش را دستی وارد نمایید.

Word Wrap wordwrap
در صورت فعال بودن، متن به‌طور خودکار سطرشکنی می‌شود تا از مرزهای TOP بیرون نزند. اگر Word Wrap و Auto-Size همزمان فعال باشند، ابتدا بر اساس اندازه فونت سطرشکنی انجام می‌شود و سپس بلوک متن حاصل Auto-Size می‌شود.

Smart Quote smartquote
نقل‌قول هوشمند را فعال می‌کند؛ یعنی به‌جای کوتیشن‌های صاف، از علامت نقل‌قول باز و بسته استفاده می‌شود.

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

Font font
انتخاب فونت از منوی کشویی. تمام فونت‌ها توسط ویندوز فراهم می‌شوند و هر فونت TrueType بارگذاری‌شده قابل استفاده است.

Font File fontfile
مشخص کردن فایل فونت TrueType (.ttf). با استفاده از فایل فونت، منوی Font غیرفعال می‌شود.

Character Set charset
انتخاب مجموعه کاراکتری.

Display Method dispmethod
روش نمایش مورد استفاده.

Anti-Alias antialias
لبه‌های متن را نرم می‌کند. در حالت Texture Display Mode در دسترس نیست.

Stroke Width strokewidth
کنترل ضخامت دورخط در حالت Stroke Display Method.

Bold bold
نمایش متن به‌صورت بولد.

Italic italic
نمایش متن به‌صورت ایتالیک.

Auto-Size Font fontautosize
کنترل خودکار اندازه فونت با یکی از سه گزینه. اگر همراه Word Wrap استفاده شود، ابتدا سطرشکنی و سپس Auto-Size انجام می‌شود.

Font Size X fontsizex
اندازه فونت در محور X (افقی). در حالت‌های Polygon و Outline، اندازه‌های اعشاری مجاز هستند.

Font Size X Unit fontsizexunit
واحد اندازه: Pixels، Fraction، Fraction Aspect یا Points (پوینت فونت). هر پوینت بر اساس استاندارد ویندوز در مقیاس 100٪ تعریف می‌شود: 96 پیکسل = 72 پوینت. مثلاً پوینت 10 برابر است با 13.333 پیکسل.

Font Size Y fontsizey
اندازه فونت در محور Y (عمودی).

Font Size Y Unit fontsizeyunit
واحد اندازه محور Y.

Keep Font Ratio keepfontratio
مقدار Y را نادیده می‌گیرد و اندازه X و Y را برابر Font Size X قرار می‌دهد.

Break Language breaklang
راهنمای نوع زبان برای قالب‌بندی صحیح گلیف‌ها.

Reading Direction readingdirection
تعیین جهت خواندن زبان (چپ به راست یا راست به چپ).

Tracking tracking
میزان فاصله اضافه بین حروف در X و Y. این پارامتر فاصله پیش‌فرض فونت را افزایش می‌دهد و امکان افست عمودی نیز می‌دهد.

Position position
موقعیت شروع متن در X و Y.
نکته: در فیلدهای Text و Post Text می‌توان موقعیت را با براکت‌ها override کرد:

  • [x,y] → "bleh[x,y]newtext" متن newtext را در (x,y) قرار می‌دهد.

  • {X,Y} → "bleh{(+/-)x,(+/-)y}newtext" متن جدید را نسبت به موقعیت فعلی جابه‌جا می‌کند.

  • \n → رفتن به خط بعد و ریست موقعیت (خط جدید و بازگشت سطر).

Position Unit positionunit
واحد موقعیت: Pixels، Fraction (0–1)، Fraction Aspect (0–1 با درنظرگرفتن نسبت تصویر).

Line Spacing linespacing
فاصله بین خطوط متن.

Line Spacing Unit linespacingunit
واحد فاصله خطوط.

Horizontal Align alignx
تراز افقی.

Horizontal Align Mode alignxmode
نحوه محاسبه تراز افقی.

Vertical Align aligny
تراز عمودی.

Vertical Align Mode alignymode
نحوه محاسبه تراز عمودی.

Border Space borderspace
در حالت Auto-Size Font، متن را بیشتر کوچک می‌کند تا حاشیه ایجاد شود.

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

Multiply RGB by Alpha multrgbbyalpha
کانال‌های RGB را در آلفا ضرب می‌کند.

Font Color fontcolor
مقادیر RGBA برای متن (پیش‌فرض: سفید (1,1,1,1)).

Font Alpha fontalpha
مقدار آلفای فونت.

Background Color bgcolor
مقادیر RGBA برای پس‌زمینه (پیش‌فرض: مشکی شفاف (0,0,0,0)).

Background Alpha bgalpha
مقدار آلفای پس‌زمینه.

Border A / Border B
رنگ‌ها و آلفای حاشیه‌های A و B.

Left / Right / Top / Bottom Border (+ Inside)
رنگ دو پیکسل کناری/داخلی هر سمت. گزینه‌ها: 0 (بدون تغییر)، Border A، Border B.

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

Comp Over Input compoverinput
در صورت فعال بودن، ورودی با تصویر کامپوزیت می‌شود.

Operation operand
انتخاب نوع عملیات کامپوزیت (Blend Modes).

Swap Order swaporder
جای ترتیب کامپوزیت با ورودی را عوض می‌کند.

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

Output Resolution outputresolution
تغییر سریع رزولوشن خروجی TOP.

Resolution resolution / Resolution Menu resmenu
تنظیم رزولوشن سفارشی یا انتخاب از مقادیر رایج.

Use Global Res Multiplier resmult
استفاده از ضریب سراسری رزولوشن (Edit > Preferences > TOPs).

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

Input Smoothness inputfiltertype
فیلتر پیکسلی روی ورودی.

Fill Viewer fillmode
نحوه نمایش تصویر TOP در ویوئر.
نکته: برای درک بهتر رفتار TOPها، در شروع روی Native Resolution بگذارید.

Viewer Smoothness filtertype
فیلتر پیکسلی در ویوئرها.

Passes npasses
تکرار عملیات TOP به تعداد مشخص.

Channel Mask chanmask
انتخاب کانال‌های فعال (R,G,B,A).

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

Parameter Color Space parmcolorspace
کنترل تفسیر فضای رنگی پارامترهای رنگ و تبدیل آن‌ها به Working Color Space.

Parameter Reference White parmreferencewhite
نحوه برخورد با Reference White هنگام تبدیل فضای رنگی (مثال‌های SDR/HDR مطابق متن).

ورودی‌های اپراتور

Input 0: Composite Input
کنترل عملیات کامپوزیت از طریق پارامترهای صفحه Output.

کانال‌های Info CHOP

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

  • text_width

  • text_height

  • cursor_start

  • cursor_end

  • cursor_x

  • cursor_y

  • cursor_width

  • cursor_height

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

  • resx عرض رزولوشن (پیکسل)

  • resy ارتفاع رزولوشن (پیکسل)

  • aspectx نسبت افقی

  • aspecty نسبت عمودی

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

  • gpu_memory_used میزان حافظه GPU مصرف‌شده

کانال‌های مشترک اپراتور

  • total_cooks

  • cook_time

  • cook_frame

  • cook_abs_frame

  • cook_start_time

  • cook_end_time

  • cooked_this_frame

  • warnings

  • errors