fugWrapperGL documentation

What it does

This FFGL plugin is a wrapper for FF10 plugins, allowing you to use them in FFGL only applications

Notice

This is beta software and has not been tested thoroughly. We make no warrenty as to stability or safety of using this software.

Installation

Copy the following libraries to your WINDOWS\System32 directory:

• avutil-50.dll - utility library from FFMPEG, used by swscale-0.dll
• swscale-0.dll - fast image scaling library from FFMPEG

IMPORTANT: Copy the following files to your FFGL application directory NOT YOUR PLUGIN DIRECTORY

• fugWrapperGL.dll - the FFGL wrapper plugin
• WrapPlug.bat - a batch file for automated wrapping
• ff10 - the directory where you need to put your FF10 plugins

Copy a few of your FF10 plugins into the ff10 directory

I'm assuming your directory layout is something like this:

• FreeFrameApp (dir)
  • ff10 (dir)
  • plugins (dir)
  • FreeFrameApp.exe (or Avenue.exe or whatever your FreeFrame app is called)
  • fugWrapperGL.dll
  • WrapPlug.bat

Where the plugins directory contains your FFGL plugins for use by FreeFrameApp.exe. If it's called something else, you'll need to open up WrapPlug.bat and edit the settings.

Editing WrapPlug.bat

The default WrapPlug.bat contains this:

Which looks for *.dll files in the ff10 directory and copies fugWrapperGL.dll to the plugins directory under the same name.

So, for example, if you have AlphaTrail.dll under your ff10 directory, you'll end up with a AlphaTrail.dll under your plugins directory too, after running WrapPlug.bat (but it's actually just a copy of fugWrapperGL.dll)

If you want a different destination directory just change the .\plugins\ path at the end

• Resolume Avenue: change .\plugins\ to .\plugins\vfx\

Wrapping Your Plugins

If you've followed the instructions above, you can now double click on WrapPlug.bat and it should wrap all your FF10 plugins. You can now load your FFGL application.

If, more likely when, I release an updated version of this plugin, copy it to your FreeFrameApp dir and just run WrapPlug.bat again to update all your plugins.

Using fugWrapperGL

You should now be able to see and use all your FF10 plugins in your FFGL application

Please let me know if you have any problems especially if you have plugins that don't seem to work correctly.

History

• 1.0.4 - #18 - 20th March 2010
  • Found what was crashing Avenue on various plugins - all working now
  • Fixed up a few plugins that say they do alpha (but don't)
  • Now supports FF_SOURCE plugins
  • Added padding to all buffers as some plugins write beyond their bounds
• 1.0.3 - #16 - 18th March 2010
  • Fixed crashing when plugin couldn't be loaded (subsequent call to FF_GETINFO would return invalid pointer)
  • Added logging of plugins that can't be loaded - written to fugWrapperGL.log in applications directory
• 1.0.2 - #14 - 17th March 2010
  • Fixes FF_PROCESSFRAMECOPY in fugWrapperGL
• 1.0.1 - #10 - 16th March 2010
  • Fixed a real stupid show-stopper that probably caused several plugins to crash!
  • Now checks for invalid values of MinFrames, MaxFrames, Parameter Types, etc
  • Added a (partial) list of plugins that say they process 32bit but don't add alpha information (forces them to operate in 24bit mode)
• 1.0.0 - #2 - 11th March 2010
  • Initial release

Copyright and contact details

©2010 Alex May - www.bigfug.com - bigfug@gmail.com

This software uses code of FFmpeg licensed under the LGPLv2.1