ImageReader (string "file", int "start",
int "end", float "fps", bool
"use_DevIL", bool "info", string "pixel_type")
ImageSource (string "file", int "start",
int "end", float "fps", bool
"use_DevIL", bool "info", string "pixel_type")
ImageReader is present in v2.52, it replaces WarpEnterprises'
plugin, with some minor functionality changes. As of v2.55
ImageSource is equivalent, with some minor functionality changes.
ImageSource is faster than ImageReader when importing one picture.
file: template for the image file(s), where frame number
substitution can be specified using
sprintf syntax.
For example, the files written by ImageWriter's
default parameters can be referenced with "c:\%06d.ebmp". As of v2.56 if the
template points to a single file then that file is read once and subsequently
returned for all requested frames.
start = 0, end = 1000: Specifies the starting and ending
numbers used for filename generation. The file corresponding to start
is always frame 0 in the clip, the file corresponding to end is
frame (end-start). The resulting clip has (end-start+1) frames. 'end=0' does
NOT mean 'no upper bound' as with ImageWriter.
The first file in the sequence, i.e., corresponding to 'start', MUST exist in order
for clip parameters to be computed. Any missing files in the sequence are replaced
with a blank frame.
fps = 24: frames per second of returned clip. An integer value prior to v2.55.
use_DevIL = false: When false, an attempt is made to parse (E)BMP files
with the internal parser, upon failure DevIL processing is invoked. When true,
execution skips directly to DevIL processing. You should only need to use this if
you have BMP files you don't want read by ImageReader's
internal parser.
NOTE : DevIL version 1.6.6 as shipped with Avisynth does not correctly support DIB/BMP type files that use a pallette, these include 8 bit RGB, Monochrome, RLE8 and RLE4. Because the failure is usually catastrophic, from revision 2.56, internal BMP processing does not automatically fail over to DevIL processing. Forcing DevIL processing for these file types is currently not recommended.
info = false: when true, the source filename text is overlayed on each video frame (added in v2.55).
pixel_type = rgb24: Allow the output pixel format to be specified, both rgb24 and rgb32 are supported. The alpha channel is loaded only for rgb32 and only if DevIL supports it for the loaded image format. (added in v2.56).
The resulting video clip colorspace is RGB if DevIL is used, otherwise it is whatever colorspace an EBMP sequence was written from (all AviSynth formats are supported).
# Default parameters: read a 1000-frame native
# AviSynth EBMP sequence (at 24 fps)
ImageSource()
# Read files "100.jpeg" through "199.jpeg"
# into an NTSC clip.
ImageSource("D:\%d.jpeg", 100, 199, 29.97)
# Note: floating point fps is available from v2.56
# Read files "00.bmp" through "50.bmp" bypassing
# AviSynth's internal BMP reader.
ImageSource("D:\%02d.bmp", end=50, use_DevIL=true)
# Read a single image, repeat 300 times
ImageSource("D:\static.png", end=300)
# Much, much faster from v2.56
* "EBMP" is an AviSynth extension of the standard Microsoft RIFF image format that allows you to save raw YUY2 and YV12 image data. See ImageWriter for more details.
$Date: 2007/05/17 20:56:14 $