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

Admin at 22:54, 22 January 2014

2014-01-22T22:54:48Z

Admin at 22:54, 22 January 2014

2014-01-22T22:54:06Z

Admin at 22:52, 22 January 2014

2014-01-22T22:52:50Z

Admin at 22:50, 22 January 2014

2014-01-22T22:50:41Z

Admin at 22:45, 22 January 2014

2014-01-22T22:45:28Z

Admin at 16:34, 5 January 2014

2014-01-05T16:34:35Z

Admin at 16:30, 5 January 2014

2014-01-05T16:30:38Z

Unreal666: Added 'FilterSDK' Category

2014-01-05T08:47:59Z

Added 'FilterSDK' Category

@@ Line 195: / Line 195: @@
      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");
@@ Line 211: / Line 211: @@
      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);
@@ Line 242: / Line 242: @@
      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();
@@ Line 273: / Line 273: @@
      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()) {

← Older revision		Revision as of 21: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.

← Older revision		Revision as of 22:54, 22 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

@@ Line 342: / Line 342: @@
      FreeLibrary(avsdll);
   } 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.
   fclose(out_fh);

@@ 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();

@@ Line 63: / Line 63: @@
      VideoInfo vi = clip->GetVideoInfo();
-−
      fprintf(stderr, " %s:\n", infile);
      fprintf(stderr, " %dx%d,\n", vi.width, vi.height);
@@ Line 256: / Line 262: @@
      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) {
         fprintf(stderr, "Error: too old version ('%d') of avisynth.dll loaded.\nplease install v2.60 or later.\n",
@@ Line 264: / Line 268: @@
         return 1;
+     }
      VideoInfo vi = clip->GetVideoInfo();
-−
 [[Cplusplus_API#GetVideoInfo|GetVideoInfo]] returns a [[Cplusplus_API/VideoInfo|VideoInfo]] structure of the clip.
      fprintf(stderr, " %s:\n", infile);

@@ Line 271: / Line 271: @@
      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) {
@@ Line 330: / Line 330: @@
 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

@@ Line 42: / Line 42: @@
         return 1;
+     }
-−
      env = CreateEnv(AVISYNTH_INTERFACE_VERSION);
-    env->CheckVersion(5); // todo - only useful for plugins - find another way to check AviSynth version
      AVS_linkage = env->GetAVSLinkage();
      AVSValue arg(infile);
@@ Line 79: / Line 79: @@
      for (int frm = 0; frm < vi.num_frames; ++frm) {
         PVideoFrame f = clip->GetFrame(frm, env);
         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]);
            for (int y=0; y<height; y++) {
-              wrote += fwrite(data, 1, rowsize, out_fh);
+              fwrite(data, 1, rowsize, out_fh);
               data += pitch;
+           }
@@ Line 126: / Line 124: @@
   #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).
@@ 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.
   #include <Windows.h>
@@ Line 230: / Line 230: @@
 This creates the script environment. Its members can be accessed by [[Cplusplus_API#IScriptEnvironment|env->...]].
      AVS_linkage = env->GetAVSLinkage();
@@ Line 275: / Line 271: @@
      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) {
@@ Line 287: / Line 283: @@
      static const int planes[] = {PLANAR_Y, PLANAR_U, PLANAR_V};
+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) {
-Start with frame zero (and run through all of them).
+Run to all frames in the input file.
         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 rowsize = f->GetRowSize(planes[p]);
            int pitch = f->GetPitch(planes[p]);
            const BYTE* data = f->GetReadPtr(planes[p]);
            for (int y=0; y<height; y++) {
-              wrote += fwrite(data, 1, rowsize, out_fh);
+              fwrite(data, 1, rowsize, out_fh);
               data += pitch;
-−
+Move the read pointer to the next line.
-−
-−
      env->DeleteScriptEnvironment();
      FreeLibrary(avsdll);
-−
   } catch(AvisynthError err) {
      fprintf(stderr, "\nAvisynth error:\n%s\n", err.msg);
      return 1;
-−
   AVS_linkage = 0;
   fclose(out_fh);
   return 0;
 todo - static and dynamic linking (see above) - http://msdn.microsoft.com/en-us/library/windows/desktop/ms685090%28v=vs.85%29.aspx

← Older revision		Revision as of 08: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]]