Filter SDK/avs2yuv - Revision history

Admin at 20:38, 6 October 2014

2014-10-06T20:38:48Z

Admin: typo

2014-01-30T21:51:07Z

typo

← Older revision		Revision as of 23:51, 30 January 2014
Line 359:		Line 359:
	return 0;		return 0;

	The application executed succesfully, so we return ~~are~~ zero.		The application executed succesfully, so we return zero.

Admin at 22:54, 22 January 2014

2014-01-22T22:54:48Z

← Older revision		Revision as of 00:54, 23 January 2014
Line 361:		Line 361:
	The application executed succesfully, so we return are zero.		The application executed succesfully, so we return are zero.

	~~todo - how to return an error if old avisynth version is loaded?~~

	todo - static and dynamic linking (see above) - http://msdn.microsoft.com/en-us/library/windows/desktop/ms685090%28v=vs.85%29.aspx		todo - static and dynamic linking (see above) - http://msdn.microsoft.com/en-us/library/windows/desktop/ms685090%28v=vs.85%29.aspx

Admin at 22:54, 22 January 2014

2014-01-22T22:54:06Z

← Older revision		Revision as of 00:54, 23 January 2014
Line 342:		Line 342:

	FreeLibrary(avsdll);		FreeLibrary(avsdll);

			Frees the library (avisynth.dll) from memory.

			AVS_linkage = 0;

	} catch(AvisynthError err) {		} catch(AvisynthError err) {
Line 349:		Line 353:
	If a runtime error occurs, the [[Control_structures\|try-catch statement]] catches the error, and it is written to the console.		If a runtime error occurs, the [[Control_structures\|try-catch statement]] catches the error, and it is written to the console.

	~~AVS_linkage = 0;~~
	fclose(out_fh);		fclose(out_fh);

Admin at 22:52, 22 January 2014

2014-01-22T22:52:50Z

← Older revision		Revision as of 00:52, 23 January 2014
Line 269:		Line 269:
	}		}

	If the loaded avisynth.dll has an api version earlier than 5 an error is thrown. This is needed if you used functionality which doesn't exist in older versions. Like using DeleteScriptEnvironment down the road ~~the~~ delete the script environment (yes it is easy to make it compatible with older api versions, but this is just an illustration). So it can be used to force a specific version.		If the loaded avisynth.dll has an api version earlier than 5 an error is thrown. This is needed if you used functionality which doesn't exist in older versions. Like using DeleteScriptEnvironment down the road to delete the script environment (yes it is easy to make it compatible with older api versions, but this is just for illustration). So it can be used to force a specific version.

	VideoInfo vi = clip->GetVideoInfo();		VideoInfo vi = clip->GetVideoInfo();

Admin at 22:50, 22 January 2014

2014-01-22T22:50:41Z

← Older revision		Revision as of 00:50, 23 January 2014
Line 63:		Line 63:

	VideoInfo vi = clip->GetVideoInfo();		VideoInfo vi = clip->GetVideoInfo();

			if (!vi.HasVideo()) {
			fprintf(stderr, "Error: '%s' audio only clip.\n", infile);
			FreeLibrary(avsdll);
			return 1;
			}

	fprintf(stderr, " %s:\n", infile);		fprintf(stderr, " %s:\n", infile);
	fprintf(stderr, " %dx%d,\n", vi.width, vi.height);		fprintf(stderr, " %dx%d,\n", vi.width, vi.height);
Line 256:		Line 262:

	PClip clip = res.AsClip();		PClip clip = res.AsClip();

	If the loaded avisynth.dll has an api version earlier than 5 an error is thrown. This is needed if you used functionality which doesn't exist in older versions. Like using DeleteScriptEnvironment down the road the delete the script environment (yes it is easy to make it compatible with older api versions, but this is just an illustration). So it can be used to force a specific version.

	if (clip->GetVersion() < 5) {		if (clip->GetVersion() < 5) {
	fprintf(stderr, "Error: too old version ('%d') of avisynth.dll loaded.\nplease install v2.60 or later.\n",		fprintf(stderr, "Error: too old version ('%d') of avisynth.dll loaded.\nplease install v2.60 or later.\n",
Line 264:		Line 268:
	return 1;		return 1;
	}		}

			If the loaded avisynth.dll has an api version earlier than 5 an error is thrown. This is needed if you used functionality which doesn't exist in older versions. Like using DeleteScriptEnvironment down the road the delete the script environment (yes it is easy to make it compatible with older api versions, but this is just an illustration). So it can be used to force a specific version.

	VideoInfo vi = clip->GetVideoInfo();		VideoInfo vi = clip->GetVideoInfo();

	[[Cplusplus_API#GetVideoInfo\|GetVideoInfo]] returns a [[Cplusplus_API/VideoInfo\|VideoInfo]] structure of the clip.		[[Cplusplus_API#GetVideoInfo\|GetVideoInfo]] returns a [[Cplusplus_API/VideoInfo\|VideoInfo]] structure of the clip.

			if (!vi.HasVideo()) {
			fprintf(stderr, "Error: '%s' audio only clip.\n", infile);
			FreeLibrary(avsdll);
			return 1;
			}

			Returns an error if the clip doesn't contain video (in case it contains only audio for example).

	fprintf(stderr, " %s:\n", infile);		fprintf(stderr, " %s:\n", infile);

Admin at 22:45, 22 January 2014

2014-01-22T22:45:28Z

← Older revision		Revision as of 00:45, 23 January 2014
Line 55:		Line 55:

	PClip clip = res.AsClip();		PClip clip = res.AsClip();

			if (clip->GetVersion() < 5) {
			fprintf(stderr, "Error: too old version ('%d') of avisynth.dll loaded.\nplease install v2.60 or later.\n",
			clip->GetVersion());
			return 1;
			}

	VideoInfo vi = clip->GetVideoInfo();		VideoInfo vi = clip->GetVideoInfo();

Line 94:		Line 101:
	env->DeleteScriptEnvironment();		env->DeleteScriptEnvironment();
	FreeLibrary(avsdll);		FreeLibrary(avsdll);
			AVS_linkage = 0;

	} catch(AvisynthError err) {		} catch(AvisynthError err) {
Line 100:		Line 108:
	}		}

	~~AVS_linkage = 0;~~
	fclose(out_fh);		fclose(out_fh);
	return 0;		return 0;
Line 250:		Line 257:
	PClip clip = res.AsClip();		PClip clip = res.AsClip();

	~~todo - check whether it~~ has ~~video~~ (it can be ~~an audio only~~ clip) - ~~clip.HasVideo~~() ~~???~~		If the loaded avisynth.dll has an api version earlier than 5 an error is thrown. This is needed if you used functionality which doesn't exist in older versions. Like using DeleteScriptEnvironment down the road the delete the script environment (yes it is easy to make it compatible with older api versions, but this is just an illustration). So it can be used to force a specific version.

			if (clip->GetVersion() < 5) {
			fprintf(stderr, "Error: too old version ('%d') of avisynth.dll loaded.\nplease install v2.60 or later.\n",
			clip->GetVersion());
			return 1;
			}

	VideoInfo vi = clip->GetVideoInfo();		VideoInfo vi = clip->GetVideoInfo();

Admin at 16:34, 5 January 2014

2014-01-05T16:34:35Z

← Older revision		Revision as of 18:34, 5 January 2014
Line 271:		Line 271:
	out_fh = fopen(outfile, "wb");		out_fh = fopen(outfile, "wb");

	Creates an empty binary file and opens it for writing. It returns a file pointer called 'out_fh' here.		Creates an empty binary file and opens it for writing. It returns a file pointer called 'out_fh' here. Nb, 'wb' means write mode and binary.

	if (!out_fh) {		if (!out_fh) {
Line 330:		Line 330:

	The application executed succesfully, so we return are zero.		The application executed succesfully, so we return are zero.

			todo - how to return an error if old avisynth version is loaded?

	todo - static and dynamic linking (see above) - http://msdn.microsoft.com/en-us/library/windows/desktop/ms685090%28v=vs.85%29.aspx		todo - static and dynamic linking (see above) - http://msdn.microsoft.com/en-us/library/windows/desktop/ms685090%28v=vs.85%29.aspx

Admin at 16:30, 5 January 2014

2014-01-05T16:30:38Z

← Older revision		Revision as of 18:30, 5 January 2014
Line 42:		Line 42:
	return 1;		return 1;
	}		}

	env = CreateEnv(AVISYNTH_INTERFACE_VERSION);		env = CreateEnv(AVISYNTH_INTERFACE_VERSION);
	~~env->CheckVersion(5); // todo - only useful for plugins - find another way to check AviSynth version~~
	AVS_linkage = env->GetAVSLinkage();		AVS_linkage = env->GetAVSLinkage();
	AVSValue arg(infile);		AVSValue arg(infile);
Line 79:		Line 79:
	for (int frm = 0; frm < vi.num_frames; ++frm) {		for (int frm = 0; frm < vi.num_frames; ++frm) {
	PVideoFrame f = clip->GetFrame(frm, env);		PVideoFrame f = clip->GetFrame(frm, env);

	~~int wrote = 0;~~

	for (int p=0; p<3; p++) { // for interleaved formats only the first plane (being the whole frame) is written		for (int p=0; p<3; p++) { // for interleaved formats only the first plane (being the whole frame) is written
Line 88:		Line 86:
	const BYTE* data = f->GetReadPtr(planes[p]);		const BYTE* data = f->GetReadPtr(planes[p]);
	for (int y=0; y<height; y++) {		for (int y=0; y<height; y++) {
	~~wrote +=~~ fwrite(data, 1, rowsize, out_fh);		fwrite(data, 1, rowsize, out_fh);
	data += pitch;		data += pitch;
	}		}
Line 126:		Line 124:
	#include <stdio.h>		#include <stdio.h>

	The header stdio.h contains objects like [http://www.cplusplus.com/reference/cstdio/stderr/ stderr] (a pointer to a FILE object) and functions like [http://www.cplusplus.com/reference/cstdio/fprintf/ fprintf] ~~and~~ [http://www.cplusplus.com/reference/cstdio/fopen/ fopen]. Those will be used later on.		The header stdio.h contains objects like [http://www.cplusplus.com/reference/cstdio/stderr/ stderr] (a pointer to a FILE object) and functions like [http://www.cplusplus.com/reference/cstdio/fprintf/ fprintf], [http://www.cplusplus.com/reference/cstdio/fopen/ fopen] and [http://www.cplusplus.com/reference/cstdio/fwrite/ fwrite]. Those will be used later on.

	The standard error stream (''stderr'') is the default destination for error messages and other diagnostic warnings. Like stdout, it is usually also directed by default to the text console (generally, on the screen).		The standard error stream (''stderr'') is the default destination for error messages and other diagnostic warnings. Like stdout, it is usually also directed by default to the text console (generally, on the screen).
Line 133:		Line 131:

	''fopen'' opens the file whose name is specified in the parameter filename and associates it with a stream that can be identified in future operations by the FILE pointer returned.		''fopen'' opens the file whose name is specified in the parameter filename and associates it with a stream that can be identified in future operations by the FILE pointer returned.

			''fwrite'' writes data to a file which is opened bij ''fopen''.

	#include <Windows.h>		#include <Windows.h>
Line 230:		Line 230:

	This creates the script environment. Its members can be accessed by [[Cplusplus_API#IScriptEnvironment\|env->...]].		This creates the script environment. Its members can be accessed by [[Cplusplus_API#IScriptEnvironment\|env->...]].

	~~env->CheckVersion(5);~~

	~~// todo - only useful for plugins - find another way to check AviSynth version (it now simply quits when an old avisynth.dll is loaded)~~

	AVS_linkage = env->GetAVSLinkage();		AVS_linkage = env->GetAVSLinkage();
Line 275:		Line 271:
	out_fh = fopen(outfile, "wb");		out_fh = fopen(outfile, "wb");

	Creates an empty binary file and opens it for writing.		Creates an empty binary file and opens it for writing. It returns a file pointer called 'out_fh' here.

	if (!out_fh) {		if (!out_fh) {
Line 287:		Line 283:
	static const int planes[] = {PLANAR_Y, PLANAR_U, PLANAR_V};		static const int planes[] = {PLANAR_Y, PLANAR_U, PLANAR_V};

	x		All three planes will be processed. For interleaved formats, automatically, only the first plane (being the whole frame) will be written to the output file.

	for (int frm = 0; frm < vi.num_frames; ++frm) {		for (int frm = 0; frm < vi.num_frames; ++frm) {

	~~Start with frame zero (and run through~~ all ~~of them)~~.		Run to all frames in the input file.

	PVideoFrame f = clip->GetFrame(frm, env);		PVideoFrame f = clip->GetFrame(frm, env);

	~~int wrote = 0;~~		Gets frame 'frm'.

	for (int p=0; p<3; p++) { ~~// for interleaved formats only the first plane (being the whole frame) is written~~		for (int p=0; p<3; p++) {
	int height = f->GetHeight(planes[p]);		int height = f->GetHeight(planes[p]);
	int rowsize = f->GetRowSize(planes[p]);		int rowsize = f->GetRowSize(planes[p]);
	int pitch = f->GetPitch(planes[p]);		int pitch = f->GetPitch(planes[p]);
	const BYTE* data = f->GetReadPtr(planes[p]);		const BYTE* data = f->GetReadPtr(planes[p]);

			Gets the height, rowsize, pitch and a read pointer 'data' to the plane. See [[Filter_SDK/InvertNeg\|InvertNeg]] for more information.

	for (int y=0; y<height; y++) {		for (int y=0; y<height; y++) {
	~~wrote +=~~ fwrite(data, 1, rowsize, out_fh);		fwrite(data, 1, rowsize, out_fh);

			Writes 'rowsize' bytes from the block of memory pointed by 'data' to the current position in the file pointer 'out_fh'.

	data += pitch;		data += pitch;
	}
	}		Move the read pointer to the next line.
	}

	env->DeleteScriptEnvironment();		env->DeleteScriptEnvironment();

			When all frames are processed the script environment is deleted.

	FreeLibrary(avsdll);		FreeLibrary(avsdll);

	} catch(AvisynthError err) {		} catch(AvisynthError err) {
	fprintf(stderr, "\nAvisynth error:\n%s\n", err.msg);		fprintf(stderr, "\nAvisynth error:\n%s\n", err.msg);
	return 1;		return 1;
	}
			If a runtime error occurs, the [[Control_structures\|try-catch statement]] catches the error, and it is written to the console.

	AVS_linkage = 0;		AVS_linkage = 0;
	fclose(out_fh);		fclose(out_fh);

			Closes the file.

	return 0;		return 0;
	}

			The application executed succesfully, so we return are zero.

	todo - static and dynamic linking (see above) - http://msdn.microsoft.com/en-us/library/windows/desktop/ms685090%28v=vs.85%29.aspx		todo - static and dynamic linking (see above) - http://msdn.microsoft.com/en-us/library/windows/desktop/ms685090%28v=vs.85%29.aspx

Unreal666: Added 'FilterSDK' Category

2014-01-05T08:47:59Z

Added 'FilterSDK' Category

← Older revision		Revision as of 10:47, 5 January 2014
Line 325:		Line 325:
	todo - static and dynamic linking (see above) - http://msdn.microsoft.com/en-us/library/windows/desktop/ms685090%28v=vs.85%29.aspx		todo - static and dynamic linking (see above) - http://msdn.microsoft.com/en-us/library/windows/desktop/ms685090%28v=vs.85%29.aspx
	http://msdn.microsoft.com/en-us/library/d14wsce5.aspx		http://msdn.microsoft.com/en-us/library/d14wsce5.aspx

			[[Category:FilterSDK]]

← Older revision		Revision as of 22:38, 6 October 2014
Line 195:		Line 195:
	IScriptEnvironment* env;		IScriptEnvironment* env;

	env returns a pointer to the [[Cplusplus_API#IScriptEnvironment\|IScriptEnvironment]] interface.		env returns a pointer to the [[Filter_SDK/Cplusplus_API#IScriptEnvironment\|IScriptEnvironment]] interface.

	HMODULE avsdll = LoadLibrary("avisynth.dll");		HMODULE avsdll = LoadLibrary("avisynth.dll");
Line 211:		Line 211:
	DLLFUNC CreateEnv = (DLLFUNC)GetProcAddress(avsdll, "CreateScriptEnvironment");		DLLFUNC CreateEnv = (DLLFUNC)GetProcAddress(avsdll, "CreateScriptEnvironment");

	[[Cplusplus_API#CreateScriptEnvironment\|CreateScriptEnvironment]] is exported by avisynth.dll and it is a pointer to the [[Cplusplus_API#IScriptEnvironment\|IScriptEnvironment]] interface. [http://msdn.microsoft.com/en-us/library/windows/desktop/ms683212%28v=vs.85%29.aspx GetProcAddress] will retrieve the address of the exported function (when failing it will return NULL).		[[Filter_SDK/Cplusplus_API#CreateScriptEnvironment\|CreateScriptEnvironment]] is exported by avisynth.dll and it is a pointer to the [[Filter_SDK/Cplusplus_API#IScriptEnvironment\|IScriptEnvironment]] interface. [http://msdn.microsoft.com/en-us/library/windows/desktop/ms683212%28v=vs.85%29.aspx GetProcAddress] will retrieve the address of the exported function (when failing it will return NULL).

	In order to do so you must declare a function pointer (called 'DLLFUNC' here) with exactly the same prototype as the function it is supposed to represent. This is done in the first line (note that [[Cplusplus_API#CreateScriptEnvironment\|CreateScriptEnvironment]] has one parameter of type 'int')		In order to do so you must declare a function pointer (called 'DLLFUNC' here) with exactly the same prototype as the function it is supposed to represent. This is done in the first line (note that [[Filter_SDK/Cplusplus_API#CreateScriptEnvironment\|CreateScriptEnvironment]] has one parameter of type 'int')

	typedef IScriptEnvironment* (__stdcall *DLLFUNC)(int);		typedef IScriptEnvironment* (__stdcall *DLLFUNC)(int);
Line 242:		Line 242:
	env = CreateEnv(AVISYNTH_INTERFACE_VERSION);		env = CreateEnv(AVISYNTH_INTERFACE_VERSION);

	This creates the script environment. Its members can be accessed by [[Cplusplus_API#IScriptEnvironment\|env->...]].		This creates the script environment. Its members can be accessed by [[Filter_SDK/Cplusplus_API#IScriptEnvironment\|env->...]].

	AVS_linkage = env->GetAVSLinkage();		AVS_linkage = env->GetAVSLinkage();
Line 273:		Line 273:
	VideoInfo vi = clip->GetVideoInfo();		VideoInfo vi = clip->GetVideoInfo();

	[[Cplusplus_API#GetVideoInfo\|GetVideoInfo]] returns a [[Cplusplus_API/VideoInfo\|VideoInfo]] structure of the clip.		[[Filter_SDK/Cplusplus_API#GetVideoInfo\|GetVideoInfo]] returns a [[Filter_SDK/Cplusplus_API/VideoInfo\|VideoInfo]] structure of the clip.

	if (!vi.HasVideo()) {		if (!vi.HasVideo()) {