EnhancedQT External

Installation

Development: Revolution 2.7 and later

Place the EnhancedQT.dll/.bundle in the Revolution customization folder: Documents/My Revolution [edition]/Externals.

The external will load the next time you launch Revolution.

Development: Revolution 2.6

To make the EnhancedQT external available in the development environment you can do the following:

  1. Place the EnhancedQT.bundle or EnhancedQT.dll file in the same directory as the Revolution executable.
  2. Create a new stack. Name it "EnhancedQT" and save it as EnhancedQT.rev in the [Revolution Folder]/plugins/ folder.
  3. Set the externals property of the stack to "EnhancedQT.bundle" (OS X) or "EnhancedQT.dll" (Win).
  4. Put the following in the stack script:
    on preOpenStack
      start using stack (short name of me)
    	
      pass preOpenStack
    end preOpenStack
  5. Select "Plugin Settings" from the Development->Plugins menu in Revolution.
  6. Select EnhancedQT.rev from the Plugin drop-down menu.
  7. Configure the plugin to resemble the screen shot below.
  8. Restart Revolution and type eqtVersion() in the message box. You should see the version number of the external displayed.

Standalones

You can place the external wherever you would like relative to the standalone application and then set the externals property of your program stack.

Things To Be Aware Of

Initialization

Before making any calls to the EnhancedQT external on Windows you should call qtInitialize. Before shutting down your application you should call qtTerminate. It does no harm to call these handlers on OS X.

QuickTime Version

Each handler in the external has a "QT Version" number in the documentation. This is the version of QuickTime that the handler should work with. I have not tested all of the handlers against the specified version of QuickTime but the information is taken from the QuickTime API documentation. You can use qtVersion() to ensure that the computer your program is running on has a compatible version of QuickTime installed.