vtcff_py скачать - vtcff_py исходный код скачать

VTCFF

Этот проект является черновиком и не предназначен для использования кем -либо.

vtcff - это библиотека для транскодирования между форматами видео с акцентом на поддержание качества и глубины цвета в видеопроизводственных трубопроводах. В студийных задачах видео секунд занимают гигабайты, а качественные компромиссы наименее желательны.

vtcff имеет тенденцию максимизировать качество, жертвуя скоростью и дисковым пространством.

vtcff на самом деле является оберткой для ffmpeg - наименее интуитивно понятный видео инструмент.

Установить

$ pip3 install vtcff

Эта команда установит пакет, но не сама FFMPEG.

Другие варианты

Установите предварительный выпуск от GitHub:

$ pip3 install git+https://github.com/rtmigo/vtcff_py@staging#egg=vtcff

Основной пример

 import subprocess
from vtcff import FfmpegCommand , Scale , Transpose , Hevc

cmd = FfmpegCommand ()

cmd . src_file = '/path/to/source.mov'
cmd . dst_file = '/path/to/target.mov'

# set set some filters
cmd . scale = Scale ( 1920 , 1080 )
cmd . transpose = Transpose . CLOCKWISE

# set compression format
cmd . dst_codec_video = Hevc ( mbps = 100 )

# run command
subprocess . check_call ( list ( cmd ))

Получение сгенерированных аргументов

 import subprocess , os
from vtcff import FfmpegCommand , Prores

cmd = FfmpegCommand ()
cmd . src_file = 'source.mov'
cmd . dst_file = 'target.mov'
cmd . dst_codec_video = Prores ()

print ( str ( cmd ))
# ffmpeg -i source.mov -codec:v prores_ks target.mov

print ( list ( cmd ))
# ['ffmpeg', '-i', 'source.mov', '-codec:v', 'prores_ks', 'target.mov']

# running in different ways:
os . system ( str ( cmd ))
subprocess . run ( list ( cmd ))

Пользовательские аргументы

Объект позволяет вам вручную указать аргументы FFMPEG. Аргументы, приведенные таким образом, имеют приоритет над аргументами, сгенерированными объектом.

 from vtcff import FfmpegCommand

cmd = FfmpegCommand ()

# set arguments as string
cmd . custom . video . string = "-codec:v libx265"
cmd . custom . video . string += "-x265-params lossless=1"

# or as list
cmd . custom . video . list = [ "-codec:v" , "libx265" ]
cmd . custom . video . list . extend ([ "-x265-params" , "lossless=1" ])

cmd.custom содержит четыре поля, которые могут быть изменены независимо.

Аргументы, которые должны быть вставлены до -i source :

custom.before_i

Аргументы, которые должны быть вставлены после -i source :

custom.after_i
custom.video
custom.audio

Zscale против шкалы

ffmpeg имеет два видео фильтра для преобразования цвета и размер кадра:

scale (libssscale) более универсален
zscale (Zimg) дает более предсказуемое качество

По умолчанию vtcff использует zscale . Иногда это может привести к ошибке «нет пути между цветами». Если другие методы не помогают, вы можете просто заменить zscale на scale .

cmd.use_zscale == True edence zscale используется
cmd.use_zscale == False Mine scale используется

 from vtcff import FfmpegCommand , Scale

cmd = FfmpegCommand ()

assert cmd . use_zscale == True  # by default, it's 'zscale' (zimg) 
cmd . use_zscale = False  # switching to 'scale' (libswscale)

# properties affected:
cmd . scale = Scale ( 1920 , 1080 )
cmd . src_color_space = 'bt709'
cmd . dst_color_space = 'bt2020ncl'
cmd . src_range_full = True
cmd . dst_range_full = False

use_zscale=True , означает, что Zimg будет использоваться для конверсий, явно установленных свойствами объекта. Это хорошо, потому что эти преобразования будут высокого качества.

Однако неявные преобразования также могут потребоваться. Например, перед обработкой 16-битной PNG с zscale нам необходимо преобразовать формат пикселя из rgba64be в gbrap16le . FFMPEG будет делать это автоматически с libswscale независимо от свойства use_zscale .

Урожай и масштаб

 from vtcff import FfmpegCommand , Scale , Crop

# crop 10 pixels, then scale
a = FfmpegCommand ()
a . crop = Crop ( left = 10 )
a . scale = Scale ( 1920 , 1080 )

# scale, then crop 10 pixels
b = FfmpegCommand ()
b . scale = Scale ( 1920 , 1080 )
b . crop = Crop ( left = 10 )

Масштаб пропорционально

 from vtcff import FfmpegCommand , Scale

cmd = FfmpegCommand ()

# set height to 1080, automatically compute width 
cmd . scale = Scale ( - 1 , 1080 )

# set height to 1080, select the width as the closest factor 
# of two to the proportional size 
cmd . scale = Scale ( - 2 , 1080 )

Изменить цветовой диапазон

 from vtcff import FfmpegCommand

cmd = FfmpegCommand ()

# Full/Data/PC range to Limited/Video/TV
cmd . src_range_full = True
cmd . dst_range_full = False

# rec.709 to rec.2020 
cmd . src_color_space = 'bt709'
cmd . dst_color_space = 'bt2020ncl'

Целевые форматы

Кодирование Apple Prores

 from vtcff import FfmpegCommand , Prores , ProresProfile

cmd = FfmpegCommand ()

# by default it will encode to ProRes 4:2:2
cmd . dst_codec_video = Prores ()

# encode to ProRes 4:2:2 HQ instead 
cmd . dst_codec_video = Prores ( profile = ProresProfile . HQ )

Кодирование HEVC (H.265)

 from vtcff import FfmpegCommand , Hevc , VcPreset

cmd = FfmpegCommand ()

# ideal quality
cmd . dst_codec_video = Hevc ( lossless = True )

# best for bitrate quality
cmd . dst_codec_video = Hevc ( near_lossless = True , mbps = 100 )

# default quality
cmd . dst_codec_video = Hevc ( mbps = 100 )

# all modes can be tweaked with optional speed presets:
cmd . dst_codec_video = Hevc ( mbps = 100 ,
                           preset = VcPreset . N7_SLOW )

По умолчанию, near_lossless установлен на максимально медленную VcPreset.N10_PLACEBO , потому что мы пытаемся максимизировать качество. Вы можете выбрать более быструю предустановку, чтобы результат появился в течение всей жизни.

По умолчанию, lossless установлена на максимально быстрое возможное VcPreset.N1_ULTRAFAST , потому что мы не теряем качества здесь. Полученный размер будет примерно сопоставим с HQ/XQ PRORES, а время кодирования является разумным.

Копирование потоков

Медиа-потоки можно скопировать без повторного кодирования и без потери качества.

Тем не менее, может быть некоторая потеря метаданных - например, информация о цветовых диапазонах и цветовых пространствах.

 from vtcff import FfmpegCommand , VideoCopy , NoAudio

cmd = FfmpegCommand ()

# changing container from mp4 to mov
cmd . src_file = "source.mp4"
cmd . dst_file = "source.mov"

# keeping video, removing audio
cmd . dst_codec_video = VideoCopy ()
cmd . dst_codec_audio = NoAudio ()

Изображения в видео

Преобразование TimelApses или последовательностей кадров CGI в видеофайл PRORES.

 import subprocess
from vtcff import FfmpegCommand , Prores , ProresProfile

cmd = FfmpegCommand ()

# input directory will be automatically transformed 
# to a pattern like '/my/dir_with_frames/img_%04.png'   
cmd . src_file = '/my/dir_with_frames'
cmd . src_fps = 29.97

cmd . dst_file = '/videos/timelapse.mov'
cmd . dst_codec_video = Prores ( profile = ProresProfile . HQ )

# images usually have Full/Data/PC color range,
# but most NLEs assume that videos have Limited/Video/TV range
cmd . src_range_full = True
cmd . dst_range_full = False

# we will treat sRGB like Rec.709, 
# although it's a little sad
cmd . src_color_space = 'bt709'
cmd . dst_color_space = 'bt709'

# run command
subprocess . check_call ( list ( cmd ))