Archive:Kdenlive/Manual/Project Menu/Render/Render Profile Parameters: Difference between revisions

From KDE UserBase Wiki
No edit summary
No edit summary
(24 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<translate>
== Render Profile Parameters == <!--T:21-->


== Render Profile Parameters - How to read them ==
===Render Profile Parameters - How to read them - ver 0.9.10 === <!--T:22-->
In version 0.9.10 the render profile parameters changed significantly. <br />


<!--T:23-->
[[File:Kdenlive Edit render profile 0.9.10.png]]
<!--T:24-->
Kdenlive now makes use of "property presets" delivered by the ''melt'' project (see [http://www.mltframework.org/bin/view/MLT/PropertyPresets melt doco]). These presets are referenced by the ''properties=<preset>'' syntax.  In the example illustrated, the render profile is referencing ''lossless/H.264''.  This refers to a property preset found in file H.264 found on the system at <tt>/usr/share/mlt/presets/consumer/avformat/lossless</tt>.
<!--T:25-->
All the ''<presets>'' referenced in the render settings in Kdenlive will be referring to presets found at <tt>/usr/share/mlt/presets/consumer/avformat/</tt> (on a default install). Note that you reference presets found in subdirectories of this folder using a <tt><dirname>/<profile></tt>  syntax as shown in the example above.
<!--T:26-->
{{Output|1=<nowiki>
properties=lossless/H.264
g=120
crf=%quality
ab=%audiobitrate+'k'
</nowiki>}}
<!--T:27-->
The preset files found at <tt>/usr/share/mlt/presets/consumer/avformat/</tt> are simple text files that contain the ''melt'' parameters that define the rendering. An example is shown below.  These are the same parameters that were used in earlier versions of Kdenlive &mdash; see next section for how to read those.
Contents of  lossless/H.264: <!--}}-->
{{Output|1=<nowiki>
f=mp4
acodec=aac
ab=384k
vcodec=libx264
intra=1
vb=0
g=0
bf=0
preset=medium
qscale=1
qp=0
coder=ac
<!--T:28-->
meta.preset.extension=mp4
meta.preset.note=Intra-frame only, lossless compressed MPEG-4 AVC with AAC audio
</nowiki>}} <!--{{-->
=== Render Profile Parameters - How to read them - earlier versions of Kdenlive === <!--T:1-->
<!--T:2-->
[[File:Custom render profiles.png|300px]]
[[File:Custom render profiles.png|300px]]


The parameters that go into a render profile derive from the ffmpeg program.
<!--T:3-->
This is a worked example to show how you can understand what these parameters mean using the ffmpeg documentation.
The parameters that go into a render profile derive from the '''ffmpeg''' program.
 
<!--T:4-->
This is a worked example to show how you can understand what these parameters mean using the '''ffmpeg''' documentation.


<!--T:5-->
In the example above the parameters are:
In the example above the parameters are:


  f=dvd  
  <!--T:6-->
vcodec=mpeg2video  
{{Output|1=<nowiki>f=dvd  
acodec=mp2   
vcodec=mpeg2video  
b=5000k  
acodec=mp2   
maxrate=8000k  
b=5000k  
minrate=0  
maxrate=8000k  
bufsize=1835008  
minrate=0  
mux_packet_s=2048  
bufsize=1835008  
mux_rate=10080000  
mux_packet_s=2048  
ab=192k  
mux_rate=10080000  
ar=48000  
ab=192k  
s=720x576  
ar=48000  
g=15  
s=720x576  
me_range=63  
g=15  
trellis=1  
me_range=63  
profile=dv_pal_wide  
trellis=1  
pass=2
profile=dv_pal_wide  
pass=2</nowiki>}}
 
<!--T:7-->
Looking up the [http://linux.die.net/man/1/ffmpeg  ffmpeg help] translates these parameters as shown below.
 
<!--T:8-->
Main option is:
 
<!--T:15-->
{{Output|1=<nowiki>-f fmt            force format</nowiki>}}


Looking up the [http://linux.die.net/man/1/ffmpeg  ffmpeg help] translates these parameters as:
<!--T:9-->
Video options are:


a main option is
<!--T:16-->
-f fmt              force format
{{Output|1=<nowiki>
-vcodec codec    force video codec ('copy' to copy stream)
-pass n          select the pass number (1 or 2)
-b bitrate        set bitrate (in bits/s)
-vb bitrate      set bitrate (in bits/s)
-s size          set frame size (WxH or abbreviation)
-me_range        <int>  E.V.. limit motion vectors range (1023 for DivX player)
-trellis          <int>  E.VA. rate-distortion optimal quantization
</nowiki>}}


video options are
<!--T:10-->
-vcodec codec    force video codec ('copy' to copy stream)
Audio options are:
-pass n                select the pass number (1 or 2)
-b bitrate            set bitrate (in bits/s)
-vb bitrate          set bitrate (in bits/s)
-s size                set frame size (WxH or abbreviation)
-me_range          <int>   E.V.. limit motion vectors range (1023 for DivX player)
-trellis                  <int>  E.VA. rate-distortion optimal quantization


audio options are
<!--T:17-->
-acodec codec     force audio codec ('copy' to copy stream)
{{Output|1=<nowiki>
-ab bitrate             set bitrate (in bits/s)
-acodec codec     force audio codec ('copy' to copy stream)
-ar rate                 set audio sampling rate (in Hz)
-ab bitrate       set bitrate (in bits/s)
-ar rate         set audio sampling rate (in Hz)
</nowiki>}}


<!--T:11-->
The AVCodecContext AVOptions include:
The AVCodecContext AVOptions include:
-b                <int>  E.V.. set bitrate (in bits/s)
-maxrate      <int>  E.V.. set max video bitrate tolerance (in bits/s)
-minrate      <int>  E.V.. set min video bitrate tolerance (in bits/s)
-g                <int>  E.V.. set the group of picture size


So all the render profile options are documented here in the ffmpeg documentation.
<!--T:19-->
{{Output|1=<nowiki>
-b                <int>  E.V.. set bitrate (in bits/s)
-maxrate          <int>  E.V.. set max video bitrate tolerance (in bits/s)
-minrate          <int>  E.V.. set min video bitrate tolerance (in bits/s)
-g                <int>  E.V.. set the group of picture size
</nowiki>}}
 
<!--T:12-->
So all the render profile options are documented here in the '''ffmpeg''' documentation.
 
<!--T:20-->
See also [http://www.mltframework.org/bin/view/MLT/ConsumerAvformat MLT doco] on ConsumerAvFormat.
 
<!--T:29-->
See also [https://forum.kde.org/viewtopic.php?f=272&t=124869#p329129 HOWTO Produce 4k and 2K videos, YouTube compatible]


<!--T:13-->
{{Prevnext2
{{Prevnext2
| prevpage=Special:MyLanguage/Kdenlive/Manual/Rendering | nextpage=Special:MyLanguage/Kdenlive/Manual/Capturing
| prevpage=Special:MyLanguage/Kdenlive/Manual/Rendering | nextpage=Special:MyLanguage/Kdenlive/Manual/Capturing
| prevtext=Rendering | nexttext=Capturing
| prevtext=Rendering Using Guides and Scripts | nexttext=Capturing Video
| index=Special:MyLanguage/Kdenlive/Manual | indextext=Back to menu
| index=Special:MyLanguage/Kdenlive/Manual | indextext=Back to menu
}}
}}
<!--T:14-->
[[Category:Kdenlive]]
[[Category:Kdenlive]]
</translate>

Revision as of 09:37, 20 July 2019

Other languages:

Render Profile Parameters

Render Profile Parameters - How to read them - ver 0.9.10

In version 0.9.10 the render profile parameters changed significantly.


Kdenlive now makes use of "property presets" delivered by the melt project (see melt doco). These presets are referenced by the properties=<preset> syntax. In the example illustrated, the render profile is referencing lossless/H.264. This refers to a property preset found in file H.264 found on the system at /usr/share/mlt/presets/consumer/avformat/lossless.

All the <presets> referenced in the render settings in Kdenlive will be referring to presets found at /usr/share/mlt/presets/consumer/avformat/ (on a default install). Note that you reference presets found in subdirectories of this folder using a <dirname>/<profile> syntax as shown in the example above.

properties=lossless/H.264 
g=120 
crf=%quality 
ab=%audiobitrate+'k'

The preset files found at /usr/share/mlt/presets/consumer/avformat/ are simple text files that contain the melt parameters that define the rendering. An example is shown below. These are the same parameters that were used in earlier versions of Kdenlive — see next section for how to read those.

Contents of lossless/H.264:

f=mp4
acodec=aac
ab=384k
vcodec=libx264
intra=1
vb=0
g=0
bf=0
preset=medium
qscale=1
qp=0
coder=ac

meta.preset.extension=mp4
meta.preset.note=Intra-frame only, lossless compressed MPEG-4 AVC with AAC audio

Render Profile Parameters - How to read them - earlier versions of Kdenlive

The parameters that go into a render profile derive from the ffmpeg program.

This is a worked example to show how you can understand what these parameters mean using the ffmpeg documentation.

In the example above the parameters are:

f=dvd 
vcodec=mpeg2video 
acodec=mp2  
b=5000k 
maxrate=8000k 
minrate=0 
bufsize=1835008 
mux_packet_s=2048 
mux_rate=10080000 
ab=192k 
ar=48000 
s=720x576 
g=15 
me_range=63 
trellis=1 
profile=dv_pal_wide 
pass=2

Looking up the ffmpeg help translates these parameters as shown below.

Main option is:

-f fmt            force format

Video options are:

-vcodec codec     force video codec ('copy' to copy stream)
-pass n           select the pass number (1 or 2)
-b bitrate        set bitrate (in bits/s)
-vb bitrate       set bitrate (in bits/s)
-s size           set frame size (WxH or abbreviation)
-me_range         <int>   E.V.. limit motion vectors range (1023 for DivX player)
-trellis          <int>   E.VA. rate-distortion optimal quantization

Audio options are:

-acodec codec     force audio codec ('copy' to copy stream)
-ab bitrate       set bitrate (in bits/s)
-ar rate          set audio sampling rate (in Hz)

The AVCodecContext AVOptions include:

-b                <int>   E.V.. set bitrate (in bits/s)
-maxrate          <int>   E.V.. set max video bitrate tolerance (in bits/s)
-minrate          <int>   E.V.. set min video bitrate tolerance (in bits/s)
-g                <int>   E.V.. set the group of picture size

So all the render profile options are documented here in the ffmpeg documentation.

See also MLT doco on ConsumerAvFormat.

See also HOWTO Produce 4k and 2K videos, YouTube compatible