BlankClip
Raffriff42 (Talk | contribs) m (one more touch-up) |
Raffriff42 (Talk | contribs) (note AVS+ differences) |
||
Line 34: | Line 34: | ||
:{{Par2|pixel_type|string|"RGB32"}} | :{{Par2|pixel_type|string|"RGB32"}} | ||
− | ::Pixel type of the resulting clip; | + | ::Pixel type of the resulting clip; can be any of the following: |
:::{|class="wikitable" | :::{|class="wikitable" | ||
|style="width:5em; text-align:center;"|[[RGB24]] | |style="width:5em; text-align:center;"|[[RGB24]] | ||
Line 45: | Line 45: | ||
|style="width:5em; text-align:center;"|[[Y8]] '''*''' | |style="width:5em; text-align:center;"|[[Y8]] '''*''' | ||
|- | |- | ||
− | |align="left" colspan="9" | * ''AviSynth v2.60'' | + | |align="left" colspan="9" | '''*''' AviSynth v2.60 |
+ | |} | ||
+ | ::{{AvsPluscon}} these [[Avisynthplus_color_formats|additional color formats]] are allowed: | ||
+ | :::{|class="wikitable" | ||
+ | |style="width:5em; text-align:center;"|RGB48 | ||
+ | |style="width:5em; text-align:center;"|RGB64 | ||
+ | |style="width:5em; text-align:center;"|RGB(A)PS | ||
+ | |style="width:5em; text-align:center;"|RGB(A)P''xx'' | ||
+ | |style="width:5em; text-align:center;"|YUV(A)422P''xx'' | ||
+ | |style="width:5em; text-align:center;"|YUV(A)420P''xx'' | ||
+ | |style="width:5em; text-align:center;"|YUV(A)444P''xx'' | ||
+ | |style="width:5em; text-align:center;"|Y''xx'' | ||
+ | |- | ||
+ | |align="left" colspan="9" | | ||
+ | ''where''<br> | ||
+ | ''S'' = 32-bit float (RGB only)<br> | ||
+ | ''xx'' = integer bit depth: 8, 10, 12, 14, or 16<br> | ||
+ | (A) = optional alpha channel; for example ''RGB{{BoldColor|blue|100|A}}P16'' or ''YUV{{BoldColor|blue|100|A}}420P10'' | ||
|} | |} | ||
Line 66: | Line 83: | ||
:{{Par2|sample_type|string|"16bit"}} | :{{Par2|sample_type|string|"16bit"}} | ||
− | ::Specifies the audio sample type. It can be | + | ::Specifies the audio sample type. It can be ''8bit'', ''16bit'', ''24bit'', ''32bit'' or ''float''. |
:{{Par2|sixteen_bit|bool|true}} | :{{Par2|sixteen_bit|bool|true}} |
Revision as of 07:11, 24 May 2017
BlankClip produces a solid color video clip with silent audio. The clip passed as an argument is used as a template - for frame rate, image size, and so on, but the template is optional. You can specify as many clip properties explicitly as you wish. By default, BlankClip will produce a pitch-black 10 second clip; 24 fps, 640x480, RGB32, with 16 bit, 44100 Hz, mono, silent audio.
When supplying a template, BlankClip returns a clip with properties copied from that template. If the template is audio-only, you get a blank audio-only clip, and if it's video-only you get a blank video-only clip. If you start to add parameters that force a video track (i.e. width, height or pixel_type) or audio track (i.e. audio_rate, channels or sample_type), the remaining parameters for that track will be the defaults. (AviSynth v2.60)
Blackness is an alias for BlankClip. The parameters are the same.
Syntax and Parameters
BlankClip( [clip clip, int length, int width, int height, string pixel_type,
float fps, int fps_denominator, int audio_rate, bool stereo, bool sixteen_bit,
int color, int color_yuv] ) (deprecated)
BlankClip( [clip clip, int length, int width, int height, string pixel_type,
float fps, int fps_denominator, int audio_rate, int channels, string sample_type,
int color, int color_yuv] )
Blackness( ...same parameters as BlankClip )
- clip clip =
- if supplied, the resulting clip will have the clip properties of the template, except for the properties you define explicitly.
- int length = 240
- Length of the resulting clip, in frames.
- int width = 640
- int height = 480
- Width and height of the resulting clip.
- string pixel_type = "RGB32"
- Pixel type of the resulting clip; can be any of the following:
- AVS+ these additional color formats are allowed:
RGB48 RGB64 RGB(A)PS RGB(A)Pxx YUV(A)422Pxx YUV(A)420Pxx YUV(A)444Pxx Yxx where
S = 32-bit float (RGB only)
xx = integer bit depth: 8, 10, 12, 14, or 16
(A) = optional alpha channel; for example RGBAP16 or YUVA420P10
- float fps = 24
- Frame rate of the resulting clip.
- int fps_denominator = 1
- Specify frame rate in rational form (numerator/denominator). For example, fps=30000,fps_denominator=1001 (approximately 29.97 fps) or fps=24000,fps_denominator=1001 (approximately 23.976 fps).
- Note: if fps_denominator is given (even if it is "1"), fps is rounded to the nearest integer.
- int audio_rate = 44100
- Sample rate of the (silent) audio.
- int channels = 1
- Specifies the number of channels of (silent) audio.
- bool stereo = false
- Deprecated: use channels instead.
- If true, the (silent) audio is in stereo: channels=2.
- string sample_type = "16bit"
- Specifies the audio sample type. It can be 8bit, 16bit, 24bit, 32bit or float.
- bool sixteen_bit = true
- Deprecated: use sample_type instead.
- true and false give both 16 bit, except when a template is used where a different bit is set.
- int color = $000000
- Specifies the color of the clip, black (= $000000) by default. See color presets for preset color. See Colors for more information on specifying colors.
- int color_yuv =
- Specifies the color of the clip using YUV values. It requires setting pixel_type to one of the YUV formats; otherwise it doesn't do anything.
Examples
# produces a black clip (3000 frames, width 720, height 576, framerate 25), # with a silent audio track (16 bit 44.1 kHz stereo): BlankClip(length=3000, width=720, height=576, fps=25, color=$000000)
# produces a black clip (3000 frames) with the remaining clip properties of the AVI: video = AviSource("E:\pdwork\DO-Heaven.AVI") BlankClip(video, length=3000, color=$000000)
# produces a black clip (3000 frames) with the remaining clip properties of the AVI: # produces a black clip (3000 frames) with the remaining clip properties of the AVI: video = AviSource("E:\pdwork\DO-Heaven.AVI") audio = BlankClip(video, audio_rate=48000) AudioDub(video, audio)
Changes
v2.55 | Added color_yuv. |
v2.58 | Added channels and sample_type. |
v2.60 | Added pixel_type="YV24"/"YV16"/"YV411"/"Y8". |
Supply useful defaults for new Audio/Video when using a Video/Audio only template clip. |