ImageSource - Revision history

Raffriff42: DevIL pixel formats

2018-03-03T17:50:19Z

DevIL pixel formats

← Older revision		Revision as of 19:50, 3 March 2018
Line 30:		Line 30:

	:{{Par2\|pixel_type\|string\|"RGB24"}}		:{{Par2\|pixel_type\|string\|"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.		::Specifies the output pixel format:
	::{{~~AvsPluscon~~}} ~~also supports [[Avisynthplus_color_formats~~\|~~Y16]],~~ [[~~Avisynthplus_color_formats\|RGB48~~]] ~~and~~ [[~~Avisynthplus_color_formats\|RGB64~~]].		::*If {{FuncArg\|use_DevIL}}=true, [[Y8]] (8-bit greyscale), [[RGB24]] and [[RGB32]] are supported.
			:::{{AvsPluscon}} also supports their 16-bit counterparts: [[Avisynthplus_color_formats\|Y16]], [[Avisynthplus_color_formats\|RGB48]] and [[Avisynthplus_color_formats\|RGB64]].
			:::The alpha channel is loaded only for RGB32/64 and only if DevIL supports it for the loaded image format.
			::*If {{FuncArg\|use_DevIL}}=false, must be empty ''except'' when decoding a 12 bit, 3 plane EBMP;
			:::in that case, {{FuncArg\|pixel_type}} must be either [[YV12]] (the default) or [[YV411]].


Line 39:		Line 43:

	===== ''Output Formats'' =====		===== ''Output Formats'' =====
	:For BMP or EBMP images opened with the internal parser, the video output is set when the sequence was created (see [[ImageWriter#The_EBMP_Format\|ImageWriter: The EBMP Format]]); for images opened with the [http://openil.sourceforge.net/ DevIL] library, the video output is ~~RGB24, RGB32 or Y8~~.		:For BMP or EBMP images opened with the internal parser, the video output is set when the sequence was created (see [[ImageWriter#The_EBMP_Format\|ImageWriter: The EBMP Format]]); for images opened with the [http://openil.sourceforge.net/ DevIL] library, the video output is as decribed under {{FuncArg\|pixel_type}} above.

	===== ''Input Formats'' =====		===== ''Input Formats'' =====
Line 67:		Line 71:

	:{{Par2\|pixel_type\|string\|"RGB32"}}		:{{Par2\|pixel_type\|string\|"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.		::Specifies the output pixel format: [[Y8]] (8-bit greyscale), [[RGB24]] and [[RGB32]] are supported.
			:::{{AvsPluscon}} also supports their 16-bit counterparts: [[Avisynthplus_color_formats\|Y16]], [[Avisynthplus_color_formats\|RGB48]] and [[Avisynthplus_color_formats\|RGB64]].
			:::The alpha channel is loaded only for RGB32/64 and only if DevIL supports it for the loaded image format.

Raffriff42: AVS+ pixel formats

2018-03-03T17:18:07Z

AVS+ pixel formats

← Older revision		Revision as of 19:18, 3 March 2018
Line 31:		Line 31:
	:{{Par2\|pixel_type\|string\|"RGB24"}}		:{{Par2\|pixel_type\|string\|"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.		::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.
			::{{AvsPluscon}} also supports [[Avisynthplus_color_formats\|Y16]], [[Avisynthplus_color_formats\|RGB48]] and [[Avisynthplus_color_formats\|RGB64]].

Raffriff42: note on "file not found" error message

2017-07-28T12:12:54Z

note on "file not found" error message

← Older revision		Revision as of 14:12, 28 July 2017
Line 10:		Line 10:
	:{{Par2\|file\|string\|"c:\%06d.ebmp"}}		:{{Par2\|file\|string\|"c:\%06d.ebmp"}}
	::Template for the image file(s), where frame number substitution can be specified using [http://www.cplusplus.com/reference/clibrary/cstdio/sprintf/ sprintf syntax]. For example, the files written by [[ImageWriter\|ImageWriter's]] default parameters can be referenced with "c:\%06d.ebmp". If {{FuncArg\|file}} points to a single file (no sprintf pattern), then that file is read once and the image subsequently returned for all requested frames.		::Template for the image file(s), where frame number substitution can be specified using [http://www.cplusplus.com/reference/clibrary/cstdio/sprintf/ sprintf syntax]. For example, the files written by [[ImageWriter\|ImageWriter's]] default parameters can be referenced with "c:\%06d.ebmp". If {{FuncArg\|file}} points to a single file (no sprintf pattern), then that file is read once and the image subsequently returned for all requested frames.

			::If you see the error message '''''ImageReader: error 'could not open file' in DevIL library''''' it may mean that a {{FuncArg\|file}} was not found or does not exist; see [[#Notes\|Notes]] below.

	:{{Par2\|start\|int\|0}}		:{{Par2\|start\|int\|0}}
Line 54:		Line 56:
	:{{Par2\|file\|string\|}}		:{{Par2\|file\|string\|}}
	::animation file to be loaded.		::animation file to be loaded.

			::If you see the error message '''''ImageSourceAnim: error 'could not open file' in DevIL library''''' it may mean that the {{FuncArg\|file}} was not found or does not exist; see [[#Notes\|Notes]] below.

	:{{Par2\|fps\|float\|24.0}}		:{{Par2\|fps\|float\|24.0}}
Line 131:		Line 135:
	*DevIL.dll 1.7.8 requires the 2005 VC [https://support.microsoft.com/en-us/kb/2977003 runtime libraries] to be correctly installed: [http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en Visual C++ 2005 SP1 Redistributable Package (x86)].		*DevIL.dll 1.7.8 requires the 2005 VC [https://support.microsoft.com/en-us/kb/2977003 runtime libraries] to be correctly installed: [http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en 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.)		* 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.)
			* Error message for "file not found" condition discussed [https://forum.doom9.org/showthread.php?t=174769 here]
	</div>		</div>

Raffriff42: use_DevIL: rephrase

2017-07-28T11:42:29Z

use_DevIL: rephrase

← Older revision		Revision as of 13:42, 28 July 2017
Line 19:		Line 19:

	:{{Par2\|use_DevIL\|bool\|false}}		:{{Par2\|use_DevIL\|bool\|false}}
	::When false, an attempt is made to parse ~~(E)BMP~~ files with the internal parser, upon failure (~~prior to v2.56~~) [http://openil.sourceforge.net/ DevIL] ~~(Developer's Image Library)~~ is ~~invoked (see [[#Notes\|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.		::When false (the default), give the ''Developer's Image Library'' ([http://openil.sourceforge.net/ DevIL]) lower priority, using the internal BMP/[[ImageWriter#The_EBMP_Format\|EBMP]] parser whenever possible; when true, always use DevIL, bypassing the internal parser.
			<div {{NotaBeneWidthIndent\|58\|4}} >
			When {{FuncArg\|use_DevIL}}=false, an attempt is made to parse files with the internal BMP/EBMP parser; upon failure – that is, for all image files which are not (E)BMP – [http://openil.sourceforge.net/ DevIL] is utilized. When {{FuncArg\|use_DevIL}}=true, execution skips the internal parser and goes directly to DevIL. You should only need to use {{FuncArg\|use_DevIL}}=true if you have (E)BMP files you don't want read by '''ImageReader''''s internal parser. See [[#Notes\|Notes]] below for DevIL library details.
			</div>

	:{{Par2\|info\|bool\|false}}		:{{Par2\|info\|bool\|false}}
Line 33:		Line 36:

	===== ''Output Formats'' =====		===== ''Output Formats'' =====
	:If [http://openil.sourceforge.net/ DevIL] ~~is used~~, the video output is RGB24, RGB32 or Y8~~; otherwise it is whatever format the EBMP ([[ImageWriter]] file format) sequence has~~.		:For BMP or EBMP images opened with the internal parser, the video output is set when the sequence was created (see [[ImageWriter#The_EBMP_Format\|ImageWriter: The EBMP Format]]); for images opened with the [http://openil.sourceforge.net/ DevIL] library, the video output is RGB24, RGB32 or Y8.

	===== ''Input Formats'' =====		===== ''Input Formats'' =====

Admin: /* Notes */

2016-06-23T16:13:32Z

Notes

← Older revision		Revision as of 18:13, 23 June 2016
Line 123:		Line 123:
	<div style="max-width:62em" >		<div style="max-width:62em" >
	* "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#The_EBMP_Format\|ImageWriter]] for more details.		* "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#The_EBMP_Format\|ImageWriter]] for more details.
	* Since v2.61 ~~ebmp image formats can be read and written when the~~ DevIL ~~library~~ is ~~not~~ loaded.		* Since v2.61 DevIL.dll is delay loaded, so Avisynth.dll can be used without it, in which case ImageReader/Writer would support only ebmp mode.
	* Greyscale BMPs are not read and written correctly by DevIL. They should be opened using '''use_DevIL=false'''.		* Greyscale BMPs are not read and written correctly by DevIL. They should be opened using '''use_DevIL=false'''.
	* [http://openil.sourceforge.net/ DevIL] 1.7.8 is included in the Avisynth installation since v2.61. If you need to download it, it is available [https://sourceforge.net/projects/openil/files/DevIL%20Win32/1.7.8/DevIL-EndUser-x86-1.7.8.zip 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.		* [http://openil.sourceforge.net/ DevIL] 1.7.8 is included in the Avisynth installation since v2.61. If you need to download it, it is available [https://sourceforge.net/projects/openil/files/DevIL%20Win32/1.7.8/DevIL-EndUser-x86-1.7.8.zip 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.

Admin: /* Notes */

2016-06-23T16:13:04Z

Notes

← Older revision		Revision as of 18:13, 23 June 2016
Line 123:		Line 123:
	<div style="max-width:62em" >		<div style="max-width:62em" >
	* "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#The_EBMP_Format\|ImageWriter]] for more details.		* "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#The_EBMP_Format\|ImageWriter]] for more details.
	* Since v2.61 ebmp image formats can be read and written ~~even if~~ the DevIL library is not loaded.		* Since v2.61 ebmp image formats can be read and written when the DevIL library is not loaded.
	* Greyscale BMPs are not read and written correctly by DevIL. They should be opened using '''use_DevIL=false'''.		* Greyscale BMPs are not read and written correctly by DevIL. They should be opened using '''use_DevIL=false'''.
	* [http://openil.sourceforge.net/ DevIL] 1.7.8 is included in the Avisynth installation since v2.61. If you need to download it, it is available [https://sourceforge.net/projects/openil/files/DevIL%20Win32/1.7.8/DevIL-EndUser-x86-1.7.8.zip 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.		* [http://openil.sourceforge.net/ DevIL] 1.7.8 is included in the Avisynth installation since v2.61. If you need to download it, it is available [https://sourceforge.net/projects/openil/files/DevIL%20Win32/1.7.8/DevIL-EndUser-x86-1.7.8.zip 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.

Admin: /* Notes */

2016-06-23T16:11:59Z

Notes

← Older revision		Revision as of 18:11, 23 June 2016
Line 123:		Line 123:
	<div style="max-width:62em" >		<div style="max-width:62em" >
	* "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#The_EBMP_Format\|ImageWriter]] for more details.		* "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#The_EBMP_Format\|ImageWriter]] for more details.
	* Since v2.61 ebmp image formats ~~will~~ be read and written even if the DevIL library is not loaded.		* Since v2.61 ebmp image formats can be read and written even if the DevIL library is not loaded.
	* Greyscale BMPs are not read and written correctly by DevIL. They should be opened using '''use_DevIL=false'''.		* Greyscale BMPs are not read and written correctly by DevIL. They should be opened using '''use_DevIL=false'''.
	* [http://openil.sourceforge.net/ DevIL] 1.7.8 is included in the Avisynth installation since v2.61. If you need to download it, it is available [https://sourceforge.net/projects/openil/files/DevIL%20Win32/1.7.8/DevIL-EndUser-x86-1.7.8.zip 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.		* [http://openil.sourceforge.net/ DevIL] 1.7.8 is included in the Avisynth installation since v2.61. If you need to download it, it is available [https://sourceforge.net/projects/openil/files/DevIL%20Win32/1.7.8/DevIL-EndUser-x86-1.7.8.zip 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.

Admin: /* Changes */

2016-06-23T16:11:43Z

Changes

← Older revision		Revision as of 18:11, 23 June 2016
Line 149:		Line 149:
	\| Updated DevIL library to v1.7.8.		\| Updated DevIL library to v1.7.8.
	\|-		\|-
	\|		\| v2.61
	\| DevIL.dll is now delay loaded, so Avisynth.dll can be used without it, in which case ImageReader/Writer would support only ebmp mode.		\| DevIL.dll is now delay loaded, so Avisynth.dll can be used without it, in which case ImageReader/Writer would support only ebmp mode.
	\|}		\|}

Admin: /* Changes */

2016-06-23T16:11:22Z

Changes

← Older revision		Revision as of 18:11, 23 June 2016
Line 148:		Line 148:
	\| v2.61		\| v2.61
	\| Updated DevIL library to v1.7.8.		\| Updated DevIL library to v1.7.8.
			\|-
			\|
			\| DevIL.dll is now delay loaded, so Avisynth.dll can be used without it, in which case ImageReader/Writer would support only ebmp mode.
	\|}		\|}
	</div>		</div>

	{{FilterCat\|Internal filters\|Media file filters\|Source_filters}}		{{FilterCat\|Internal filters\|Media file filters\|Source_filters}}

Admin: /* Notes */

2016-06-23T16:06:20Z

Notes

← Older revision		Revision as of 18:06, 23 June 2016
Line 123:		Line 123:
	<div style="max-width:62em" >		<div style="max-width:62em" >
	* "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#The_EBMP_Format\|ImageWriter]] for more details.		* "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#The_EBMP_Format\|ImageWriter]] for more details.
			* Since v2.61 ebmp image formats will be read and written even if the DevIL library is not loaded.
	* Greyscale BMPs are not read and written correctly by DevIL. They should be opened using '''use_DevIL=false'''.		* Greyscale BMPs are not read and written correctly by DevIL. They should be opened using '''use_DevIL=false'''.
	* [http://openil.sourceforge.net/ DevIL] 1.7.8 is included in the Avisynth installation since v2.61. If you need to download it, it is available [https://sourceforge.net/projects/openil/files/DevIL%20Win32/1.7.8/DevIL-EndUser-x86-1.7.8.zip 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.		* [http://openil.sourceforge.net/ DevIL] 1.7.8 is included in the Avisynth installation since v2.61. If you need to download it, it is available [https://sourceforge.net/projects/openil/files/DevIL%20Win32/1.7.8/DevIL-EndUser-x86-1.7.8.zip 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.
Line 128:		Line 129:
	* 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.)		* 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.)
	</div>		</div>


	== Changes ==		== Changes ==