FLV Converter SDK

FlvToVideo source_flv [options]….

source_flv is the file path of source FLV.

Possible parameters for "options":

-out output the output file path. If the output file is not set, the program won't implement the encoding.

-st start_time the time to start capturing the video; in second; decimal fraction is possible. By default, the start time is 0.

-dt duration the duration; in second; decimal fraction is possible. By default, it lasts to the end of the video.

-vf string the output file format, like avi, asf, mov, mp4, psp, 3gp and so on. By default, the format is automatically set according to the filename extension. For more information about file format, please refer to File Format List.

-size wxh the output video size; w is width, h is height; w & h should be even value. By default, the width and the height of the source file are used.

-vbr bitrate the bit rate in video compression; in kbps.

-fr frame_rate the output video frame rate; in fps; decimal fraction is possible, e.g. 29.970. By default, the frame rate of the source file is used.

-d perform deinterlacing.

-vcodec codec the video compression codec, e.g. mpeg4. For more information about the possible value, please refer to Video Codec List.

-vtag tag the FOURCC of the video, e.g. mp43. By default, the pre-set settings of the encoder are used.

-gop key_frame_interval the interval between the key frames; 0 is for intraframe. By default, the value is 12.

-aspect h/v the aspect ratio of the video, h is horizontal value and v is vertical value, e.g. 4/3

-acodec codec the audio compression codec, e.g. mp3. For more information about the possible value, please refer to Audio Codec List.

-asr sample_rate the output audio sample rate.

-ac channels the output audio channels; 1 mono, 2 stereo.

-abr bitrate the audio bit rate; in bps, e.g. 96000.

-pf format the captured image format, e.g. jpg, gif, png, bmp; jpg by default. For more information about the possible image format, please refer to Image Format List.

-ps wxhthecaptured image size, e.g. 12x90. By default, it is the output video size.

-crop l,t,r,b the pixels of each lateral to be cropped away. This combination of pixels will form a selected content, e.g. 0,20,0,20 which indicates to crop away 20 pixels from both the top and the buttom.

-gpr n file_name_tmpl to capture some number of images at random time and save the images as the name specified by file_name_tmpl.The number of the images is specified by n. There should be "?" within file_name_tmpl, and the "?" will be replaced by numbers with the generated file.

-gp t file capture the image from time t and save with the name file. This option can be repeated.

There could be prefix for t to show the comparative time point, e.g. s1.0 indicates the 1.0 second after the correspondent start time; e-1.0 indicates the 1.0 second before the end time; m2.3 indicates 2.3 seconds after the middle time of the video.

-pstretch stretch the image when the h/v rate of the captured image is different from that of the source FLV image. Otherwise, letterbox is shown to process the cropped image.

-vstretch stretch the video when the h/v rate of the output video image is different from that of the source FLV image. Otherwise, letterbox is shown to process the cropped image.

-vn no video included.

-an no audio included.

-slp t the time for sleep after encoding each frame, in milliseconds; it is used to prevent occupying too much CPU during the process of encoding. By default, the value is 0, which indicates not to sleep, so that the encoding is finished as soon as possible.

-iwm LogoFilename [(size, width, height)] [(a,origin, xOffset, yOffset)] [(t, rgba, tolerance)]] [[{(s, StartTime, DurationTime)| (m, StartTime, DurationTime)| (e,StartTime, DurationTime)}]…]]

it is to set the properties of the Logo

LogoFilename is the file name for the Logo
(size,width,height) is the size of the Logo; "width" is the width of the Logo, and "height" is the height of Logo in pixels.

(a,origin,xOffset,yOffset) is to set the alignment of the Logo; "origin" is the relative origin, possible value:

0 Top-Left
1 Top-Center
2 Top-Right
3 Center
4 Bottom-Left
5 Bottom-Center
6 Bottom-Right

"xOffset,yOffset" are the horizontal and vertical offsets; move right or down is positive value, while move left or up is negative value.

Only (a,origin) and (a,origin,xOffset,yOffset) are valid in this option.

(t, rgba,tolerance) is to set the transparent color of the Logo. "rgba" is an eight hexadecimal integer, and each component occupies two hexadecimal digits, see below:

"rgb" indicates the transparent color, "a" is the alpha/transparency of the entire Logo.

"tolerance" is the tolerance value, i.e. to set the degree of color which is similar to the transparent color to be transparent.

Only (t, rgba) and (t, rgba,tolerance) are valid in this option.

(x,StartTime,DurationTime) is to set the start time and the duration to show the Logo from position "x" in seconds.

x=s, it indicates the start of the video, and "StartTime" is positive value; e.g. (s,1.0,3.0), it indicates that the Logo will show up when the video plays to the 1st second, and last 3.0 seconds.

x=m, it indicates the middle of the video; when "StartTime" is positive value, it counts from the middle to the right; when "StartTime" is negative value, it counts from the middle to the left; e.g. (m,-1.0,2.0), it indicates that the Logo will show up when there are still 1.0 second to the middle of the video, and last 2.0 seconds.

x=e, it indicates the end of the video, and "StartTime" is negative value;
e.g. (e,-2.0,2.0), it indicates that the Logo will show up when there are still 2.0 seconds to the end of the video, and last 2.0 seconds.

-twm TextString [(a,origin, xOffset, yOffset)] [(f, font, style, size, effect, rgba)] [[{(s, StartTime, DurationTime)|(m, StartTime, DurationTime)|(e, StartTime, DurationTime)}]…]]

it is to set the properties of the Text

TextString is the text string to be shown

(a,origin,xOffset,yOffset) is to set the alignment of the Text; "origin" is the relative origin, possible value:

0 Top-Left
1 Top-Center
2 Top-Right
3 Center
4 Bottom-Left
5 Bottom-Center
6 Bottom-Right

"xOffset,yOffset" are the horizontal and vertical offsets; move right or down is positive value, while move left or up is negative value.

Only (a,origin) and (a,origin,xOffset,yOffset) are valid in this option.

(f,font,style,size,effect, rgba) is to set the character settings; "font" is the font name; e.g. "Times New Roman".

"style" is the font style, possible value:
0 Normal
1 Italic
2 Bold
3 Bold & Italic

"size" is the font size.

"effect" is the font effect, possible value:
0 None
1 Strikeout
2 Underline
3 Strikeout & Underline

"rgba" is an eight hexadecimal integer, and each component occupies two hexadecimal digits, see below:

"rgb" indicates the transparent color, "a" is the alpha/transparency of the Text.

Default is allowed in this option, but they could not be vacant at the same time; e.g. you can choose Times New Roman as the font name, and 10 as size, i.e. (f, "Times New Roman",,10), but there should not be the following option: (f,,,,)

(x,StartTime,DurationTime) is to set the start time and the duration to show the Text from position "x" in seconds.

x=s, it indicates the start of the video, and "StartTime" is positive value; e.g. (s,1.0,3.0), it indicates that the Text will show up when the video plays to the 1st second, and last 3.0 seconds.

x=m, it indicates the middle of the video; when "StartTime" is positive value, it counts from the middle to the right; when "StartTime" is negative value, it counts from the middle to the left; e.g. (m,-1.0,2.0), it indicates that the Text will show up when there are still 1.0 second to the middle of the video, and last 2.0 seconds.

x=e, it indicates the end of the video, and "StartTime" is negative value;
e.g. (e,-2.0,2.0), it indicates that the Text will show up when there are still 2.0 seconds to the end of the video, and last 2.0 seconds.

-acodec enable the change of audio codec