ImageSource

Revision as of 15:54, 7 January 2016

ImageReader and ImageSource

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)

string  file = "c:\%06d.ebmp"

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". If file points to a single file (no sprintf pattern), then that file is read once and the image subsequently returned for all requested frames.

int  start = 0

int  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.

float  fps = 24.0

Frames Per Second of returned clip.

bool  use_DevIL = false

When false, an attempt is made to parse (E)BMP files with the internal parser, upon failure (prior to v2.56) DevIL (Developer's Image Library) is invoked (see Notes below). When true, execution skips the internal parser and goes directly to DevIL. You should only need to use this if you have BMP files you don't want read by ImageReader's internal parser.

bool  info = false

When true, the source filename and DevIL version is written to each video frame.

string  pixel_type = "RGB24"

Specifies the output pixel format: Y8 (8-bit greyscale), RGB24 and RGB32 are supported. The alpha channel is loaded only for RGB32 and only if DevIL supports it for the loaded image format.

ImageReader is present from v2.52, replacing WarpEnterprises' ImageSequence plugin.

ImageSource is equivalent, with some minor functionality changes. ImageSource is faster than ImageReader when importing a single picture.

Output Formats

If DevIL is used, the video output is RGB24, RGB32 or Y8; otherwise it is whatever format the EBMP (ImageWriter file format) sequence has.

Input Formats

All AviSynth color spaces are supported.

BMP and EBMP are supported natively (see Notes below); with DevIL 1.7.8, supported image formats are:

dds,  jpg/jpe/jpeg,  pcx,  png,  pbm/pgm/ppm,  tga,  tif/tiff,

gif,  exr,  jp2,  psd,  hdr,  raw,  sgi/bw/rgb/rgba

ImageSourceAnim

ImageSourceAnim(string file, float fps, bool info, string pixel_type)

string  file =

animation file to be loaded.

float  fps = 24.0

Frames Per Second of returned clip.

bool  info = false

When true, the source filename and DevIL version is written to each video frame.

string  pixel_type = "RGB32"

Specifies the output pixel format: Y8 (8-bit greyscale), RGB24 and RGB32 are supported. The alpha channel is loaded only for RGB32 and only if DevIL supports it for the loaded image format.

ImageSourceAnim lets you import animations (gif, ppm, tif/tiff or psd). If there is a delay between the first and second image in the animation, the framerate is set accordingly. If this delay is zero, the framerate is set to 24 fps by default (and can be adjusted by setting the fps parameter). If the images in the animation have unequal dimensions, then the dimension of the first image is taken and the remaining images are padded with black pixels below and or to the right. Note that unlike ImageReader and ImageSource, pixel_type is set to RGB32 by default.

ImageSourceAnim requires DevIL 1.7.8, included in the Avisynth installation (see Notes below).

Examples

# 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.jpeg", 100, 199, 29.97)

# Read files "00.bmp" through "50.bmp" bypassing AviSynth's internal BMP reader
ImageSource("%02d.bmp", end = 50, use_DevIL = true)

# Read a single image, repeat 300 times
ImageSource("static.png", end = 300, use_DevIL=true)

# Read a greyscale (8-bit) jpg:
ImageSource("GoldPetals-8bit.jpg", use_DevIL=true)

# Read a greyscale (8-bit) BMP (using AviSynth's internal BMP reader):
ImageSource("GoldPetals-8bit.bmp")

# Read a YV24 BMP (created with ImageWriter):
ImageSource("GoldPetals-24bit.ebmp")

# Use a still-frame image with audio:
audio = DirectShowSource("Gina La Piana - Start Over.flv")
video = ImageSource("Gina La Piana.jpg", fps=25, start=1, end=ceil(25*AudioLengthF(audio)/AudioRate(audio)))
return AudioDub(video, audio)

# Read an animation:
ImageSourceAnim("F:\TestPics\8bit_animated.gif")

Notes

• "EBMP" is an AviSynth extension of the standard Microsoft RIFF image format that allows you to save raw image data (all color formats are supported). See ImageWriter for more details.
• Greyscale BMPs are not read and written correctly by DevIL. They should be opened using use_DevIL=false.
• DevIL 1.7.8 is included in the Avisynth installation. If you need to download it, it is available here. Just put the DevIL.dll in your system folder (it will overwrite any older version). Be sure to use the non-unicode version, because the other one will result in crashes when loading pictures.
• DevIL.dll 1.7.8 requires the 2005 VC phttps://support.microsoft.com/en-us/kb/2977003 runtime libraries] to be correctly installed: Visual C++ 2005 SP1 Redistributable Package (x86).
• Loading DIB/BMP type files that use a palette (such as 8 bit RGB, Monochrome, RLE8 and RLE4) requires DevIL 1.7.8. (Because the failure was usually catastrophic, internal BMP processing does not automatically fail over to DevIL processing. Forcing DevIL processing when using DevIL 1.6.6 for these file types is not recommended.)

Changes