Movie File In TOP

Movie File In TOP

خلاصه (Summary)

Movie File In TOP فایل‌های ویدئویی، تصاویر ثابت یا توالی‌ای از تصاویر ثابت را وارد شبکه‌ی TOP می‌کند.
این نود می‌تواند تصاویر با فرمت‌های زیر را بخواند: .jpg، .gif، .tif، .bmp.
همچنین می‌تواند ویدئوها را در فرمت‌های زیر بخواند:
.mov (QuickTime)، .mp4، .mpg، .mpeg، .avi، .wmv، .dpx، Cineform، Hap Q (همراه با پشتیبانی از Alpha).

علاوه بر این، از کُدک NotchLC، فایل‌های EXR (.exr)، برخی فایل‌های Flash (.swf و .flv) و همچنین فایل‌های فشرده‌ی .dds (DXT1/3/5 و RG) نیز پشتیبانی می‌کند.
تصاویر و ویدئوها همچنین می‌توانند از طریق وب با استفاده از http:// برای مشخص کردن URL فراخوانی شوند.

با استفاده از پارامتر Hardware Decode در صفحه‌ی Tune می‌توان از دیکودر سخت‌افزاری کارت‌های گرافیک Nvidia بهره گرفت. این قابلیت از فایل‌های H264/H265 با عمق ۱۰ و ۱۲ بیت و فایل‌های YUV 444 روی سخت‌افزارهای پشتیبانی‌کننده پشتیبانی می‌کند و آن‌ها را به کانال‌های پیکسلی ۱۶ بیتی تبدیل می‌نماید. کُدک‌های دیگری که توسط این سخت‌افزار دیکود می‌شوند شامل VP8، VP9، JPEG، AV1، VC1 هستند.

هنگام خواندن فرمت‌هایی که از عمق رنگی بالاتر پشتیبانی می‌کنند (۱۰/۱۶/۳۲ بیت)، به‌طور خودکار یک فرمت پیکسلی مناسب انتخاب می‌شود، به شرطی که منوی Pixel Format در صفحه‌ی Common روی حالت “Use Input” باقی مانده باشد. برای مثال اگر فایل ۱۶ بیتی باشد، هر کانال رنگ به صورت ۱۶ بیتی بارگذاری می‌شود.

برای لیست کامل فرمت‌ها، به بخش File Types مراجعه کنید.

برای بررسی وضعیت Movie File In TOP می‌توانید یک Info CHOP به آن متصل کنید. این CHOP اطلاعاتی مانند طول فیلم، رزولوشن، تعداد تصاویر در ثانیه (کانال sample_rate) و وجود یا عدم وجود صدا در فایل را نشان می‌دهد. همچنین داده‌های پویا مثل وضعیت باز شدن فایل، فریم فعلی، تعداد فریم‌های بافر شده (readahead)، اندازه‌ی صف، تعداد فریم‌های افتاده، زمان دیکود CPU و زمان بارگذاری GPU را نمایش می‌دهد.

⚠️ توجه: نرخ “تصاویر در ثانیه” (sample_rate) یک ویدئو ممکن است با نرخ فریم تایم‌لاین پروژه متفاوت باشد. وقتی به “index” در فیلم اشاره می‌شود، منظور ترتیب تصاویر در فایل فیلم است و ربطی به نرخ فریم کلی پروژه ندارد.

همچنین نگاه کنید به صفحه‌های:

  • Movie File In TOP optimizations (بهینه‌سازی پخش فیلم)

  • Hap

  • Movie File Out TOP

  • Cineform


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

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

    🔹 اگر یک پوشه از تصاویر را به‌جای یک فایل مشخص کنید، آن پوشه به عنوان یک ویدئو در نظر گرفته می‌شود. تمام تصاویر باید رزولوشن یکسان داشته باشند. ترتیب تصاویر براساس حروف و اعداد در نام آن‌ها (alphanumeric) خواهد بود. اولین تصویر شاخص (index) صفر می‌گیرد، دومین تصویر یک و … (صرف‌نظر از اسم فایل).
    با تغییر Sample Rate در صفحه Trim می‌توانید سرعت پخش توالی تصاویر را مشخص کنید.

    🔹 اگر یک فایل info.xml در همان پوشه وجود داشته باشد، می‌توانید نرخ فریم و فایل صوتی همراه توالی تصاویر را مشخص کنید. نمونه:

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

    URLها نیز می‌توانند برای دریافت تصاویر و ویدئوها استفاده شوند. فایل دانلودشده به مسیر موقت Derivative ذخیره می‌شود و سپس در Movie File In TOP بارگذاری خواهد شد.


  • Reload (reload)
    تغییر مقدار از ۰ به ۱ باعث می‌شود فایل دوباره بارگذاری شود (مناسب وقتی که فایل تغییر کرده یا ابتدا وجود نداشته است).

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


  • Play Mode (playmode)
    مشخص می‌کند فیلم چگونه پخش شود. حالت‌ها:

    1. Locked to Timeline (locked)
      فیلم به تایم‌لاین قفل می‌شود. جابجایی در تایم‌لاین، موقعیت فیلم را هم تغییر می‌دهد. در این حالت پارامترهای Play، Reset، Speed و Index غیرفعال هستند.

    2. Specify Index (specify)
      اجازه می‌دهد کاربر با استفاده از پارامتر Index موقعیت دقیق فیلم را مشخص کند. (مناسب برای دسترسی تصادفی به هر نقطه‌ی فیلم).

    3. Sequential (sequential)
      فیلم به‌طور مستقل از تایم‌لاین پروژه پخش می‌شود. پارامترهای Reset و Speed در این حالت فعال هستند.

    4. Timecode Object/CHOP/DAT (timecodeop)
      موقعیت فیلم بر اساس یک Timecode (از CHOP، DAT یا شیء Timecode Class) تعیین می‌شود.


  • Play (play)
    وقتی مقدار ۱ باشد فیلم پخش می‌شود، وقتی ۰ باشد متوقف می‌شود.

  • Speed (speed)
    ضریب سرعت پخش (فقط در حالت Sequential).

    • ۱ = سرعت عادی

    • ۲ = دو برابر سریع‌تر

    • ۰.۵ = نصف سرعت

    • مقادیر منفی = پخش معکوس


  • Cue (cue)
    وقتی مقدار ۱ شود، فیلم به نقطه Cue Point می‌پرد. (فقط در حالت Sequential).

  • Cue Pulse (cuepulse)
    بلافاصله فیلم را به نقطه Cue Point می‌برد.

  • Cue Point (cuepoint)
    هر شاخصی در فیلم را می‌توان به عنوان Cue Point تعریف کرد.

  • Cue Point Unit (cuepointunit)
    واحد اندازه‌گیری Cue Point:

    • I → شاخص (Index)

    • F → فریم‌ها (Frames)

    • S → ثانیه (Seconds)

    • % → درصد (Fraction)

  • Cue Behavior (cuebehavior)
    تعیین رفتار Cue:

    • Repeat Cued Frame → هنگام رها کردن Cue، بلافاصله فریم بعدی را پخش می‌کند.

    • Play Next Frame → هنگام رها کردن Cue، ابتدا فریم Cue شده را نمایش می‌دهد سپس ادامه می‌دهد.


  • Index (index)
    وقتی Play Mode روی Specify Index باشد، این پارامتر موقعیت فیلم را مشخص می‌کند.
    واحد Index می‌تواند: Index، Frames، Seconds یا Fraction باشد.

    🔹 مثال: اگر فیلم داخلی ۲۵fps باشد و تایم‌لاین ۶۰fps:

    • اگر Units روی Index باشد و مقدار ۲۵ انتخاب شود → تصویر مربوط به ثانیه‌ی ۱ام فیلم نمایش داده می‌شود.

    • اگر Units روی Frames باشد و مقدار ۶۰ انتخاب شود → همان تصویر (ثانیه‌ی ۱ام) نمایش داده می‌شود.


  • Loop Crossfade (loopcrossfade)
    در هنگام Loop کردن، ابتدا و انتهای فیلم را Crossfade می‌کند تا انتقال نرم ایجاد شود.

  • Loop Crossfade Unit (loopcrossfadeunit)
    واحد اندازه‌گیری برای Crossfade: Index، Frames، Seconds، Fraction.


  • Step Size (stepsize)
    مشخص می‌کند چند فریم باید جا بیفتد قبل از نمایش بعدی.
    مثلا Step Size = ۳۰ → هر ۳۰ فریم یک بار تصویر نمایش داده می‌شود.


  • Audio Loop (audioloop)
    نحوه رفتار صدا هنگام رسیدن به انتهای فیلم:

    • Silence → صدا خاموش شود.

    • Fade → صدا محو شود.

    • Match Start to End → هماهنگ با تصویر لوپ شود.


  • Image Sequence Indexing (imageindexing)
    روش شماره‌گذاری تصاویر در توالی:

    • Zero Based → از ۰ شروع شود (بعد از مرتب‌سازی alphanumeric).

    • Filename Based → از عدد موجود در انتهای نام فایل استفاده شود (مثلا flower400.tiff → اندیس ۴۰۰).

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

      • Output Resolution (outputresolution)
        وضوح (رزولوشن) خروجی تصویر را مشخص می‌کند. گزینه‌ها:

        • Use Input → وضوح همان وضوح تصویر ورودی خواهد بود.

        • Eighth → ۱/۸ اندازه‌ی ورودی.

        • Quarter → ۱/۴ اندازه‌ی ورودی.

        • Half → نصف اندازه‌ی ورودی.

        • Specify → ابعاد دقیق را خودتان تعیین می‌کنید.

      • Resolution (resolutionw, resolutionh)
        اگر Output Resolution روی Specify باشد، اینجا می‌توانید تعداد پیکسل‌های عرض (Width) و ارتفاع (Height) را مشخص کنید.

      • Resolution Menu (resolutionmenu)
        یک منوی آماده برای انتخاب ابعاد استاندارد (مثلاً 1280×720).

      • Fit Resolution (fit)
        وقتی فعال باشد، تصویر درون وضوح خروجی جا می‌گیرد (Scaling با حفظ نسبت).

      • Fill Mode (fillmode)
        روش قرار گرفتن تصویر در وضوح خروجی:

        • Fit Horizontal → عرض را پر می‌کند.

        • Fit Vertical → ارتفاع را پر می‌کند.

        • Fit Best → تصویر را به‌طور کامل جا می‌دهد (ممکن است کناره‌ها خالی بماند).

        • Stretch → تصویر را کاملاً به وضوح جدید می‌کشد.

        • Crop → تصویر را برش می‌دهد تا کامل پر شود.

      • Crop (cropl, cropr, cropt, cropb)
        حاشیه‌ی برش (Crop) را مشخص می‌کند: چپ، راست، بالا، پایین. مقادیر به پیکسل است.


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

      • Start Index (startindex)
        نقطه‌ی شروع فیلم یا توالی تصاویر (شاخص شروع).

      • End Index (endindex)
        نقطه‌ی پایان فیلم یا توالی تصاویر.

      • Trim Unit (trimunit)
        واحد اندازه‌گیری Start و End: Index، Frames، Seconds، Fraction.

      • Sample Rate (samplerate)
        نرخ فریم پخش (fps). برای توالی تصاویر مهم است.
        مثلاً اگر توالی ۱۰۰ تصویر دارید و Sample Rate = 25 باشد، طول کل ۴ ثانیه خواهد شد.

      • Extend (extend)
        وقتی تایم‌لاین از محدوده‌ی Start و End عبور کند چه اتفاقی بیفتد:

        • Hold → آخرین تصویر نگه داشته می‌شود.

        • Loop → فیلم دوباره از اول پخش می‌شود.

        • Mirror → فیلم به عقب پخش می‌شود و دوباره جلو می‌رود (رفت و برگشتی).

        • Zero → خروجی خالی (سیاه) می‌شود.


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

      • Decode Ahead (decodeahead)
        چند فریم جلوتر از فریم فعلی دیکود (Decode) شود. برای روان‌تر شدن پخش.

      • GPU Upload (gpuupload)
        چند فریم جلوتر روی GPU بارگذاری شود.

      • Pre-Read Frames (preread)
        هنگام شروع پخش، چند فریم از قبل بارگذاری شود.

      • Loop Filter Size (loopfilter)
        وقتی Loop فعال باشد، اندازه‌ی بافری که برای روانی Loop استفاده می‌شود.

      • Read Mode (readmode)
        تعیین می‌کند Movie File In چگونه داده‌ها را بخواند:

        • Sequential → خواندن پشت‌سرهم.

        • Random Access → اجازه‌ی دسترسی به هر نقطه‌ی فیلم.

      • Hardware Decode (hwdecode)
        اگر کارت گرافیک پشتیبانی کند، دیکود ویدئو توسط سخت‌افزار انجام می‌شود.

      • Reload Behavior (reloadbehavior)
        وقتی فایل دوباره بارگذاری می‌شود چه اتفاقی بیفتد.


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

      • Output Resolution (commonres)
        همانند صفحه Image، ولی در بخش عمومی (مشترک برای همه TOPها).

      • Pixel Format (pixelformat)
        فرمت پیکسلی خروجی:

        • Use Input → همان فرمت ورودی.

        • 8-bit Fixed → RGBA با ۸ بیت.

        • 16-bit Float → RGBA با ۱۶ بیت شناور.

        • 32-bit Float → RGBA با ۳۲ بیت شناور.

      • Viewer
        فعال/غیرفعال کردن نمایش خروجی در Viewer.


      Info CHOP

      وقتی یک Info CHOP را به Movie File In وصل کنید، اطلاعات زیر را دریافت می‌کنید:

      • num_images → تعداد کل تصاویر/فریم‌ها.

      • width → عرض تصویر.

      • height → ارتفاع تصویر.

      • aspect → نسبت تصویر.

      • rate → نرخ فریم فیلم (sample_rate).

      • duration → مدت زمان.

      • current_index → شاخص فریم فعلی.

      • decoded_frames → تعداد فریم‌های دیکود شده.

      • gpu_uploads → تعداد فریم‌های بارگذاری شده روی GPU.

      • cpu_time → زمان صرف‌شده برای دیکود CPU.

      • gpu_time → زمان بارگذاری GPU.

      • dropped_frames → تعداد فریم‌های از دست رفته.

      • audio_channels → تعداد کانال‌های صوتی.

      • audio_rate → نرخ نمونه‌برداری صوت.

دیدگاهتان را بنویسید