vtcff_py
1.0.0
該項目是草稿，不打算任何人使用。
vtcff是一個庫，用於在視頻格式之間轉碼，重點是保持視頻生產管道中的質量和色彩深度。在錄音室任務中，視頻秒佔據了千兆字節，而質量妥協是最不可取的。
vtcff傾向於最大化質量，犧牲速度和磁盤空間。
vtcff實際上是ffmpeg的包裝器，這是有史以來最不直觀的視頻工具。
$ pip3 install vtcff此命令將安裝軟件包，但不能安裝FFMPEG本身。
$ 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_icustom.videocustom.audioffmpeg有兩個用於顏色和框架尺寸轉換的視頻過濾器：
scale （libswscale）更通用zscale （Zimg）提供了更可預測的質量默認情況下， vtcff使用zscale 。有時可能會導致錯誤“色彩空間之間沒有路徑”。如果其他方法無濟於事，則可以簡單地用scale替換zscale 。
cmd.use_zscale == True表示使用zscalecmd.use_zscale == False Means使用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將用於由對象屬性明確設置的轉換。這很好，因為這些轉換將是高質量的。
但是，也可能需要隱式轉換。例如，在使用zscale處理16位PNG之前，我們需要將像素格式從rgba64be轉換為gbrap16le 。無論使用use_zscale屬性如何，FFMPEG都將使用libswscale自動進行。
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' 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 ) 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 ，因為我們在這裡不會失去任何質量。所得的大小將與PRORES HQ/XQ大致相當，並且編碼時間合理。
可以在不重新編碼的情況下複製媒體流，而不會造成質量損失。
但是，可能會損失元數據 - 例如，有關顏色範圍和顏色空間的信息。
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 ()將時間表或CGI框架序列轉換為PRORES VIDEO文件。
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 ))
