## BlankClip / Blackness

`BlankClip` (clip "template", 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")
`Blackness` ()

Il filtro `BlankClip` produce un video clip con colore unico, senza audio e della lunghezza specificata (length in frames). Il clip passato come argumento è usato come template per frame rate, dimensione dell'immagine, e altro, anche se si possono specificare tutte le proprietà del clip senza dover fornire un template. color deve essere dato come valore RGB esadecimale. Senza nessun argomento, `BlankClip` produce un clip di 10 secondi, 640x480, 24 fps, 16 bit 44100 Hz stereo.

se template è presente, il clip risultante avrà le proprietà del clip template (bug!!: eccetto il color-format), a meno delle proprietà definite esplicitamente .

length: lunghezza del clip risultante(in frames).

width, height: larghezza e altezza del clip risultante.

pixel_type: pixel type del clip risultante che può essere "RGB24", "RGB32", "YUY2" o "YV12".

fps: framerate del clip risultante.

fps_denominator: si può usare questa opzione se il valore "fps" non è sufficientemente accurato. Esempio: fps = 30000, fps_denominator = 1001 (ratio = 29.97) oppure fps = 24000, fps_denominator = 1001 (ratio = 23.976). Il valore di default è 1.

audio_rate: samplerate dell'audio (muto) del clip.

stereo: (valore booleano) se impostato a "true" l'audio è stereo, se "false" l'audio è mono.

sixteen_bit: (valore booleano) true e false producono entrambi 16 bit, eccezion fatta quando si usa un template con impostato un valore diverso.

color: specifica il colore del clip, black (= $000000) di default. Vedere ColorPresets.
color_yuv: aggiunto dalla v2.55, consente di specificare il colore del clip usando valori YUV. Necessita dell'impostazione del pixel_type a "YUY2" o "YV12", altrimenti non funziona.

`Blackness` è un alias di `BlankClip`, previsto per compatibilità con le versioni precedenti.

    # Questo produce un clip nero(3000 frames, larghezza 720, altezza 576, framerate 25), con traccia audio muta
     (16 bit 44.1 kHz stereo):
    BlankClip(length=3000, width=720, height=576, fps=25, color=$000000)

    # Questo produce un clip nero (3000 frames) mantenendo le restanti proprietà dell' avi:
    AviSource("E:\pdwork\DO-Heaven.AVI")
    BlankClip(length=3000, color=$000000)

    # Questo aggiunge un audio stream muto (con un samplerate di 48 kHz) ad un video clip:
    video = AviSource("E:\pdwork\DO-Heaven.AVI")
    audio = BlankClip(video, audio_rate=48000)
    AudioDub(video, audio)

Changes:

v2.55 | aggiunto color_yuv

`$Date: 2004/09/06 22:19:40 $`