/ofxAwesomium

openFrameworks wrapper around the offscreen html renderer, Awesomium

Primary LanguageC++GNU General Public License v3.0GPL-3.0

#ofxAwesomium

Awesomium is an off-screen bHTML renderer. This basically means that you can give it a URL and it will give you an ofTexture of the webpage. You can also "inject" mouse and keyboard events, making it an interactive browser renderer. Also supports Flash!

Installation

  1. Download Awesomium Currently using v1.7.3
  2. Install Awesomium
  3. Try out the examples to make sure it works!

Using the Project Generator on OSX

It kind of sucks that there are so many steps required to add Awesomium to oF, but that's just the way it is right now. Essentially all you are doing is linking against the Awesomium framework and adding it to the application bundle under Executables. It's the same process covered in Setting Up on Mac OSX. If you don't know what that means, just follow the steps below.

  1. Generate a project using the Project generator. Make sure to check off ofxAwesomium in the addons list
  2. In the Finder, navigate to /Library/Frameworks (this is where the Awesomium installer put some stuff)
  3. Locate Awesomium.framework in /Library/Frameworks Locate Framework
  4. Drag the entire Awesomium.framework into XCode and drop it into the Project Navigator Drag and drop
  5. In the dialog that appears, click "Finish" Finish
  6. In the Project Navigator, click on the blue icon at the top. Then click on "Build Phases" Build Phases
  7. Drag "Awesomium.framework" from the Project Navigator and drop it on the section called "Link Binary With Libraries"
  8. In the Menu bar, go to Editor > Add Build Phase > Add Copy Files Build Phase
  9. In the resulting "Copy Files" build phase, change "Destination" to "Executables", and drag Awesomium.framework (again) from the Project Navigator to where it says "Add Files Here"

Using ProjectGenerator on Windows

The instructions for Windows are quite involved as well. Begin by opening the Windows installation instructions. You'll need them for several steps.

  1. Generate a project using the Project generator. Make sure to check off ofxAwesomium in the addons list
  2. Add your code or copy the example code into your project
  3. In the Set up your project section of the Windows installation instructions, follow steps 3-6 to add the necessary paths to your Visual Studios solution
  4. Follow the instructions in the Copy files to your build distribution section and copy the files into the project's bin folder
  5. Proceed to build your project