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には4つのフィールドが含まれており、独立して変更できます。

前に挿入される引数-i source ：

custom.before_i

後に挿入される引数-i source ：

custom.after_i
custom.video
custom.audio

Zscale vsスケール

ffmpegには、色とフレームサイズの変換用の2つのビデオフィルターがあります。

scale （libswscale）はより汎用性があります
zscale （Zimg）は、より予測可能な品質を提供します

デフォルトでは、 vtcff zscaleを使用します。「カラースペース間のパスなし」エラーにつながる場合があります。他の方法が役に立たない場合は、 zscale scaleに置き換えるだけです。

cmd.use_zscale == True zscaleが使用されることを意味します
cmd.use_zscale == False平均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にピクセル形式を変換する必要があります。 ffmpegは、 use_zscaleプロパティに関係なく、 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'

ターゲット形式

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に設定されています。結果のサイズは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ビデオファイルに変換します。

 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 ))