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

خلاصه (Summary)

اپراتور Point File In TOP داده‌های پوینت سه‌بعدی (3D Point Data) را از یک فایل تکی یا از یک دنباله فایل (Sequence) بارگذاری کرده و آن‌ها را وارد TOPها می‌کند.
هر پوینت از یک یا چند مقدار ممیز شناور تشکیل شده است؛ مانند موقعیت XYZ، مقادیر رنگ RGB، نرمال‌های سه‌بعدی، شدت اسکنر و غیره.

Point File In TOP تمام داده‌های پوینت موجود را بارگذاری می‌کند، اما فقط چهار کانال می‌توانند در تصویر خروجی قرار بگیرند. به‌صورت پیش‌فرض، چهار کانال اول داده‌های پوینت به‌ترتیب در کانال‌های Red، Green، Blue و Alpha قرار می‌گیرند. با این حال، می‌توانید با استفاده از پارامترهای صفحه Point Data، هر کانال داده پوینت را به هر کانال رنگی اختصاص دهید.
برای ایجاد تصاویر خروجی اضافی از همان فایل منبع، می‌توانید یک Point File Select TOP متصل کنید.

Point File In TOP قادر به خواندن داده‌های پوینت از فرمت‌های مختلف مش و داده‌های ممیز شناور است، از جمله:
.obj، .ply، .fits (فرمت نجومی) و .exr

همچنین می‌تواند فایل‌های ASCII پوینت (مانند .xyz، .pts، .csv، .txt و غیره) را بارگذاری کند که در آن‌ها هر خط شامل یک پوینت بوده و فیلدها با کاما یا فاصله از هم جدا شده‌اند. خط اول در فایل‌های ASCII می‌تواند یکی از موارد زیر باشد:

  • تعداد پوینت‌ها

  • نام فیلدهای پوینت

  • اولین پوینت فایل

برای مشاهده فهرست کامل، به File Types مراجعه کنید.
فرمت OpenEXR معمولاً بهترین انتخاب است، زیرا باینری است، می‌تواند به‌صورت دنباله چندفریمی با استفاده از سیستم پیش‌خوانی و بافرینگ Movie File در TouchDesigner خوانده شود، و می‌توان آن را با Movie File Out TOP و با تعداد نامحدود کانال نوشت.

برای بررسی وضعیت یک Point File In TOP می‌توانید یک Info CHOP به آن متصل کنید. این کار اطلاعاتی مانند تعداد پوینت‌ها، تعداد فیلدها در هر پوینت و تعداد فریم‌ها را نمایش می‌دهد. همچنین اطلاعات دینامیکی مانند وضعیت باز بودن فایل، فریم جاری، فریم‌های پیش‌خوانی‌شده، اندازه صف، تعداد فریم‌های از دست‌رفته، زمان دیکود CPU و زمان آپلود به GPU را نشان می‌دهد.

Headerها:
اگر فایل شامل داده‌های هدر اضافی باشد، می‌توان آن‌ها را با اتصال یک Info DAT مشاهده کرد. داده‌های هدر به‌صورت جفت‌های کلید–مقدار ذخیره می‌شوند؛ کلیدها در ستون اول و داده متناظر در ستون دوم قرار دارند که به‌راحتی با پایتون قابل تفسیر هستند.

تمام فرمت‌های لیست پوینت ASCII صرف‌نظر از پسوندشان (txt، csv، xyz و غیره) به یک شکل بارگذاری می‌شوند. پارسر ابتدا اولین کاراکتر جداکننده (کاما، فاصله یا تب) را پیدا کرده و از آن برای جدا کردن بقیه فایل استفاده می‌کند. جداکننده‌هایی که داخل کوتیشن تکی یا دوتایی باشند نادیده گرفته می‌شوند.
چند قانون خاص نیز وجود دارد؛ مثلاً چند فاصله پشت‌سرهم یکی در نظر گرفته می‌شوند، اما وجود کاما در انتهای یک خط نشان‌دهنده یک فیلد خالی بعد از آن است.

پس از مشخص شدن جداکننده:

  • خط اول می‌تواند تعداد پوینت‌ها باشد (که نادیده گرفته می‌شود).

  • اگر خط بعدی شامل رشته‌ها باشد، به‌عنوان ردیف هدر (نام کانال‌ها) در نظر گرفته می‌شود.

  • هر خط بعد از آن یک پوینت محسوب می‌شود.

همچنین ببینید: OpenEXR

PythonIcon.pngpointfileinTOP_Class

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

  1. Summary

  2. Parameters – Point Data Page

  3. Parameters – Play Page

  4. Parameters – Trim Page

  5. Parameters – Tune Page

  6. Parameters – Common Page

  7. Info CHOP Channels
     7.1 Specific Point File In TOP Info Channels
     7.2 Common TOP Info Channels
     7.3 Common Operator Info Channels

Parameters – Point Data Page

کنترل می‌کند داده‌های فیلد هر پوینت چگونه در تصویر خروجی قرار بگیرند.

سوییچ‌های Custom مشخص می‌کنند آیا از نام فیلد سفارشی برای انتخاب داده‌ای که در کانال رنگی متناظر قرار می‌گیرد استفاده شود یا نه.
اگر خاموش باشند، فیلدها به‌ترتیب انتخاب می‌شوند (مثلاً اولین فیلد به Red، دومی به Green و …).

در حالت Custom می‌توانید فیلد موردنظر را از منوی کشویی انتخاب کنید یا مستقیماً نام آن را وارد نمایید. اگر کانال رنگی در فرمت تصویر خروجی در دسترس نباشد (به پارامتر Pixel Format مراجعه کنید)، این پارامتر غیرفعال می‌شود.

File (file)
مسیر و نام فایل پوینت برای بارگذاری. فرمت‌های قابل پشتیبانی در بخش File Types آمده‌اند.
می‌توانید فایل‌های اینترنتی را با http:// مشخص کنید.

برای در نظر گرفتن یک پوشه به‌عنوان انیمیشن، به‌جای نام فایل، مسیر پوشه را وارد کنید. تمام فایل‌ها باید رزولوشن یکسان داشته باشند. هر فایل به‌عنوان یک فریم در انیمیشن در نظر گرفته می‌شود. ترتیب فایل‌ها الفبایی–عددی است. به‌صورت پیش‌فرض اولین فایل اندیس 0، دومی 1 و به همین ترتیب خواهد داشت. با Override کردن Sample Rate در صفحه Trim می‌توانید انیمیشن را با هر نرخ فریمی پخش کنید.

استفاده از فایل info.xml در پوشه دنباله فایل‌ها امکان تعیین FPS را فراهم می‌کند. نمونه فایل:

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes" ?>
<Settings>
<attributes fps="30.0" />
</Settings>

URLها نیز می‌توانند برای دریافت فایل استفاده شوند. فایل در پوشه temp مربوط به Derivative دانلود شده و سپس در Point File In TOP خوانده می‌شود.

Reload (reload)
با تغییر مقدار از 0 به 1، فایل مجدداً بارگذاری می‌شود. مناسب زمانی که فایل تغییر کرده یا ابتدا وجود نداشته است.

Reload Pulse (reloadpulse)
فوراً فایل داده پوینت را دوباره بارگذاری می‌کند.

Red (red) – ⊞
انتخاب یکی از کانال‌های داده پوینت برای قرارگیری در کانال قرمز تصویر خروجی. انتخاب One یا Zero مقدار ثابت را در خروجی قرار می‌دهد.

Green (green) – ⊞
انتخاب کانال داده پوینت برای کانال سبز.

Blue (blue) – ⊞
انتخاب کانال داده پوینت برای کانال آبی.

Alpha (alpha) – ⊞
انتخاب کانال داده پوینت برای کانال آلفا.

Parameters – Play Page

Play Mode (playmode) – ⊞
روش پخش انیمیشن را مشخص می‌کند (۳ حالت مختلف).

Play (play)
وقتی روی 1 باشد انیمیشن پخش می‌شود و وقتی 0 باشد متوقف می‌شود.

Speed (speed)
ضریب سرعت پخش که فقط در حالت Sequential کار می‌کند. مقدار 1 سرعت پیش‌فرض است، 2 دو برابر، 0.5 نصف سرعت. مقادیر منفی باعث پخش معکوس می‌شوند.

Cue (cue)
با قرار دادن روی 1 به نقطه Cue می‌پرد. فقط در حالت Sequential فعال است.

Cue Pulse (cuepulse)
بلافاصله به موقعیت Cue Point می‌پرد.

Cue Point (cuepoint)
هر اندیسی از انیمیشن را به‌عنوان نقطه پرش تعیین می‌کند.

Cue Point Unit (cuepointunit) – ⊞
واحد این پارامتر را از بین Index، Frames، Seconds و Fraction (درصد) انتخاب می‌کند.

Cue Behavior (cuebehavior) – ⊞
رفتار پارامتر Cue را سفارشی می‌کند.

Index (index)
وقتی Play Mode روی Specify Index باشد، موقعیت فایل را به‌طور مستقیم تعیین می‌کند. واحدها می‌توانند Index، Frames، Seconds یا Fraction باشند.

Index Unit (indexunit) – ⊞
انتخاب واحد برای پارامتر Index.

Loop Crossfade (loopcrossfade)
ابتدا و انتهای انیمیشن را برای لوپ شدن نرم، کراس‌فید می‌کند. اگر Trim فعال باشد، بین Trim Start و Trim End کراس‌فید می‌شود.

Loop Crossfade Unit (loopcrossfadeunit) – ⊞
انتخاب واحد کراس‌فید.

Step Size (stepsize)
تعداد فریم‌هایی که بین نمایش هر فریم رد می‌شوند. مثلاً Step Size برابر 30 یعنی نمایش هر سی‌اُمین فریم.

Audio Loop (audioloop) – ⊞
نحوه برخورد با صدا هنگام رسیدن به انتهای انیمیشن را مشخص می‌کند.

Image Sequence Indexing (imageindexing) – ⊞
نحوه مرتب‌سازی دنباله فایل‌ها را تعیین می‌کند.

Interpolate Frames (interp)
بین فریم‌ها بر اساس زمان دقیق اینترپولیشن انجام می‌دهد.

Loading/Error Image (loadingerrorimage) – ⊞
در صورت عدم امکان بارگذاری فایل، مشخص می‌کند چه چیزی نمایش داده شود.

Parameters – Trim Page

Trim (trim)
فعال‌سازی پارامترهای برش ابتدا و انتها.

Trim Start (tstart)
نقطه شروع انیمیشن را برش می‌دهد.

Trim Start Unit (tstartunit) – ⊞
انتخاب واحد Trim Start.

Trim End (tend)
نقطه پایان انیمیشن را برش می‌دهد.

Trim End Unit (tendunit) – ⊞
انتخاب واحد Trim End.

Extend Left (textendleft) – ⊞
نحوه برخورد با موقعیت‌های قبل از Trim Start را مشخص می‌کند.

Extend Right (textendright) – ⊞
نحوه برخورد با موقعیت‌های بعد از Trim End را مشخص می‌کند.

Override Sample Rate (overridesample)
فعال‌سازی تغییر Sample Rate انیمیشن.

Sample Rate (samplerate)
تنظیم Sample Rate هنگام فعال بودن Override.

Parameters – Tune Page

Pre-Read Frames (prereadframes)
تعداد فریم‌هایی که TouchDesigner قبل از نیاز، می‌خواند و در حافظه نگه می‌دارد.

Frame Read Timeout (frametimeout)
مدت‌زمانی (میلی‌ثانیه) که سیستم برای خواندن یک فریم صبر می‌کند.

Frame Timeout Strategy (frametimeoutstrat) – ⊞
در صورت رسیدن به Timeout، از آخرین فریم موجود استفاده می‌شود.

Always Load Initial Frame (alwaysloadinitial)
برای اولین فریم، Timeout نادیده گرفته می‌شود تا همیشه تصویر معتبر لود شود.

File Open Timeout (opentimeout)
حداکثر زمان انتظار برای باز شدن فایل.

Async Upload to GPU (asyncupload)
آپلود غیرهمزمان تصاویر به GPU برای کاهش زمان Cook (با مصرف حافظه GPU بیشتر).

Update Image (updateimage)
اگر 0 باشد تصویر به‌روزرسانی نمی‌شود.

Max Decode CPUs (maxdecodecpus)
محدود کردن تعداد CPUهای مورد استفاده برای دیکود.

High Performance Read (highperfread)
برای فایل‌هایی با نیاز به سرعت بسیار بالای خواندن از SSD.

High Performance Read Factor (highperfreadfactor)
کنترل اندازه عملیات خواندن دیسک در حالت High Performance.

Hardware Decode (hwdecode)
کنترل استفاده از دیکود سخت‌افزاری Nvidia.

Parameters – Common Page

(این بخش مشابه سایر TOPهاست)

  • Output Resolution

  • Resolution

  • Resolution Menu

  • Use Global Res Multiplier

  • Output Aspect

  • Aspect

  • Aspect Menu

  • Input Smoothness

  • Fill Viewer

  • Viewer Smoothness

  • Passes

  • Channel Mask

  • Pixel Format

Info CHOP Channels

اطلاعات تکمیلی Point File In TOP از طریق Info CHOP در دسترس است.

Specific Point File In TOP Info Channels

  • num_points

  • num_loaded_points

  • num_src_points

  • num_channels

  • index

  • true_index

  • index_fraction

  • file_resx

  • file_resy

  • start

  • length

  • sample_rate

  • last_index_uploaded

  • mv_has_audio

  • preloading

  • odd_field

  • last_frame

  • loop_frame

  • pre_read_misses

  • last_pre_read_miss_wait

  • hard_drive_timeouts

  • num_pre_read_frames

  • first_index_to_read

  • last_frame_hd_read_time

  • last_frame_decode_time

  • last_gpu_upload_time

  • open

  • opening

  • open_failed

  • fully_pre_read

  • true_length

  • hardware_yuv_to_rgb

  • has_non_av_track

  • pre_read_fails

  • disk_read_mbit_rate

  • has_decode_errors

  • num_decode_chunks

  • hardware_decode

Common TOP Info Channels

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

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

  • aspectx – نسبت افقی

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

  • depth – عمق آرایه ۲D یا ۳D

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

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 – تعداد خطاها