خلاصه (Summary)
Movie File Out TOP جریان یک TOP را در قالب یک فایل ویدئویی (.mov / .mp4) ذخیره می‌کند و از انواع مختلف کدک‌ها پشتیبانی می‌کند؛ از جمله: H.264 / H.265، Hap Q، NotchLC، Apple ProRes و Animation. همچنین می‌تواند تصاویر تک‌فریم، دنباله‌ای از تصاویر، یا ویدیوهای استاپ‌فریم را ذخیره کند.
برای کدک‌هایی که از آلفا پشتیبانی می‌کنند، باید از پارامتر Movie Pixel Format برای انتخاب فرمتی که شامل آلفا است استفاده شود.
رابط کاربری Export Movie Dialog حول Movie File Out TOP ساخته شده است.
برای ضبط ویدیو همراه با صدا با استفاده از Movie File Out TOP، نیاز به یک Time Sliced CHOP با کانال‌های صوتی مونو یا استریو است. اگر TouchDesigner با نرخ فریم پایین‌تری نسبت به نرخ فریم هدف اجرا شود و یک CHOP برای صدا مشخص شده باشد، این نود به‌طور خودکار فریم‌های ویدیو را تکرار می‌کند تا هماهنگی بین تصویر و صدا حفظ شود.
برای جلوگیری از افت فریم در ضبط، می‌توان ضبط را در حالت غیر هم‌زمان (non-realtime) انجام داد؛ یعنی با خاموش کردن گزینه Realtime در بالای رابط کاربری. طول ویدیو از پیش تعیین نشده و بستگی به مدت زمانی دارد که پارامتر Record فعال باشد.
همچنین می‌توان دنباله‌ای از فایل‌های .tif یا .exr را ذخیره کرد. در حالت OpenEXR می‌توان کانال‌های رنگی مختلف از چند TOP را در یک فایل EXR ذخیره کرد و همراه با متادیتا ایجاد نمود؛ این متادیتا توسط Point File In TOP قابل خواندن است.
⚠️ توجه: کدگذاری H.264/H.265 فقط در لایسنس‌های Commercial یا Pro در دسترس است و نیاز به کارت گرافیک Nvidia دارد.
⚠️ هشدار – Timeout درایور GPU: در رزولوشن بالا، بعضی فرمت‌ها ممکن است فشار سنگینی روی GPU وارد کنند (به‌ویژه در حالت RGBA BC7 برای Hap Q). ویندوز به‌طور پیش‌فرض فقط ۲ ثانیه به GPU زمان می‌دهد تا هر فریم را پردازش کند؛ اگر طولانی‌تر شود، ویندوز GPU را ریستارت می‌کند.
برای رفع مشکل، باید در رجیستری ویندوز مقدار زیر را تنظیم کنید:
نوع مقدار باید REG_DWORD باشد و مقدار آن تعداد ثانیه‌ای است که اجازه می‌دهید GPU قبل از ریستارت شدن پردازش کند (مثلاً 20–40 ثانیه). بعد از تغییر، سیستم باید ریستارت شود.
برای ذخیره تصاویر ثابت یا انیمیشن استاپ‌فریم، می‌توان پارامتر Type را تغییر داد و از دکمه Add Frame به‌صورت دستی یا با اسکریپت استفاده کرد.
🔗 همچنین ببینید: Movie File In TOP و Recording Movies with Audio
پارامترها (Parameters)
Movie Out Page
Type → انتخاب خروجی (ویدیو، تصویر، دنباله تصاویر، یا استاپ‌فریم).
Video Codec → انتخاب کدک ویدیو (Animation, JPEG, MPEG4, H264/H265, Hap, HapQ, NotchLC, ProRes, GIF, VP8, VP9 و …).
Video Codec Type → انواع مختلف یک کدک (مثل ProRes 422 HQ یا ProRes 4444 HQ).
Image File Type → فرمت تصویر (TIFF, JPEG, BMP, OpenEXR, PNG, DDS).
Unique Suffix → افزودن پسوند منحصر به‌فرد به نام فایل.
File → مسیر و نام فایل خروجی (باید پسوند .mov یا .mp4 داشته باشد).
Movie Pixel Format → انتخاب کیفیت رنگ و پشتیبانی از آلفا (RGB، RGBA، YUV 4:2:0 و …).
Audio CHOP → اتصال صدای خروجی (CHOP زمان‌بندی شده).
Audio Codec → انتخاب کدک صدا (ALAC، MP3، PCM، Vorbis).
Audio Bit Rate → انتخاب بیت‌ریت صدا (96، 128، 192، 256، 320 kbps).
Quality → کیفیت فشرده‌سازی ویدیو.
Movie FPS → نرخ فریم خروجی.
Limit Length → تعیین حداکثر طول ضبط.
Record → شروع ضبط.
Pause → توقف موقت ضبط.
Add Frame → افزودن یک فریم تکی (برای حالت استاپ‌فریم).
Max Threads → تعداد تردها برای نوشتن تصاویر.
Header Source DAT → اضافه کردن متادیتا به خروجی (فقط در EXR).
EXR Page
افزودن کانال‌های اضافی از TOPهای دیگر به فایل خروجی.
امکان ذخیره به عنوان Point Cloud برای بارگذاری مستقیم در Point File In TOP.
تعریف نام برای کانال‌های RGBA هر ورودی.
Settings Page
Stall for File Open → توقف برای باز شدن فایل قبل از ضبط.
Profile / Preset → انتخاب پروفایل H264 (Baseline, Main, High).
Bit Rate Mode → حالت ثابت یا متغیر (CBR/VBR).
Average / Peak Bitrate → تعیین بیت‌ریت هدف و حداکثر.
Keyframe Interval → فاصله بین کی‌فریم‌ها.
Max B-Frames → تعداد فریم‌های B مجاز.
Motion Prediction → کیفیت پیش‌بینی حرکت (Full, Half, Quarter).
Frame Slicing → تقسیم فریم‌ها به بخش‌های کوچک‌تر برای چند CPU.
Secondary Compression → فشرده‌سازی دوم در Hap.
Encode Test Mode → فقط تست انکود بدون ذخیره روی دیسک.
Include Mip Maps → ذخیره مپ‌ها هنگام خروجی DDS.
Common Page
Output Resolution → تنظیم رزولوشن خروجی (نسبت به ورودی یا سفارشی).
Output Aspect → نسبت تصویر (ورودی، سفارشی، یا پیش‌فرض).
Input Smoothness / Viewer Smoothness → نوع فیلتر پیکسل (Nearest, Linear, Mipmap).
Fill Viewer → حالت نمایش تصویر (Fit, Fill, Native Resolution).
Passes → تعداد دفعات پردازش TOP.
Channel Mask → انتخاب کانال‌های فعال (RGBA).
Pixel Format → فرمت ذخیره‌سازی داده پیکسل‌ها (8bit, 16bit, 32bit, RGB, RGBA, Mono, Alpha).
Operator Inputs
Input 0 → ورودی اصلی تصویر.
Info CHOP Channels
اطلاعات اضافی Movie File Out TOP که از طریق Info CHOP قابل دسترس است:
last_frames_written → تعداد فریم‌های نوشته‌شده در آخرین پردازش.
total_frames_written → کل فریم‌های نوشته‌شده.
last_audio_samples_written → تعداد نمونه‌های صوتی در آخرین پردازش.
total_audio_samples_written → کل نمونه‌های صوتی نوشته‌شده.
total_frames_dropped → تعداد فریم‌های ازدست‌رفته.
active_records → تعداد فایل‌های تصویری که هم‌زمان ذخیره می‌شوند.
cur_seq_index → اندیس فعلی در دنباله تصاویر.
و همچنین کانال‌های عمومی: resx, resy, aspectx, aspecty, gpu_memory_used, cook_time, errors, warnings و …