Initial commit

Author: adamjs

README.md

@@ -1,4 +1,14 @@
 tutorial-framework
 ==================
 
-Framework to serve as a starting point for tutorials
+Framework to serve as a starting point for Awesomium tutorials.
+
+Please see: http://wiki.awesomium.com/tutorials
+
+## Setting Up on Windows
+
+You should create a new Visual Studio project with the files located in the "src" directory. Only filenames ending in "_win" or those that do not specify a platform should be added to your project.
+
+## Setting Up on Mac OSX
+
+You should create a new XCode Cocoa project with the files located in the "src" directory. Only filenames ending in "_mac" or those that do not specify a platform should be added to your project.

src/application.h

@@ -0,0 +1,67 @@
+#ifndef TUTORIAL_APPLICATION_H_
+#define TUTORIAL_APPLICATION_H_
+
+class View;
+
+namespace Awesomium {
+class WebCore;
+}
+
+// Common class that sets up an application, creates the WebCore, handles
+// the Run loop, and abstracts platform-specific details.
+class Application {
+ public:
+  // Listener interface to be used to handle various application events.
+  class Listener {
+   public:
+    virtual ~Listener() {}
+
+    // Event is fired when app (and WebCore) have been loaded.
+    virtual void OnLoaded() = 0;
+
+    // Event is fired for each iteration of the Run loop.
+    virtual void OnUpdate() = 0;
+
+    // Event is fired when the app is shutting down.
+    virtual void OnShutdown() = 0;
+  };
+
+  virtual ~Application() {}
+
+  // Platform-specific factory constructor
+  static Application* Create();
+
+  // Begin the Run loop.
+  virtual void Run() = 0;
+
+  // Ends the Run loop.
+  virtual void Quit() = 0;
+
+  // Create a platform-specific, windowed View
+  virtual View* CreateView(int width, int height) = 0;
+
+  // Destroy a View
+  virtual void DestroyView(View* view) = 0;
+
+  // Show a modal message box
+  virtual void ShowMessage(const char* message) = 0;
+  
+  // Get the WebCore
+  virtual Awesomium::WebCore* web_core() { return web_core_; }
+
+  // Get the Listener.
+  Listener* listener() { return listener_; }
+
+  // Set the Listener for various app events.
+  void set_listener(Listener* listener) { listener_ = listener; }
+
+ protected:
+  Application() { }
+
+  virtual void Load() = 0;
+  
+  Listener* listener_;
+  Awesomium::WebCore* web_core_;
+};
+
+#endif  // TUTORIAL_APPLICATION_H_

src/application_mac.mm

@@ -0,0 +1,110 @@
+#include "application.h"
+#include "view.h"
+#import <Cocoa/Cocoa.h>
+#include <Awesomium/WebCore.h>
+#include <string>
+
+@interface AppDelegate : NSObject<NSApplicationDelegate> {
+  NSTimer *timer;
+}
+- (void)startUpdateTimer;
+- (void)applicationWillTerminate:(NSNotification *)aNotification;
+- (BOOL)applicationShouldTerminateAfterLastWindowClosed:(NSApplication *)theApplication;
+- (void)updateTimer:(NSTimer *)timer;
+@end
+
+using namespace Awesomium;
+
+class ApplicationMac : public Application {
+  NSAutoreleasePool* pool;
+  NSApplication* app;
+  AppDelegate* appDelegate;
+public:
+  ApplicationMac() {
+    listener_ = NULL;
+    web_core_ = NULL;
+  }
+  
+  virtual ~ApplicationMac() {
+    [NSApp setDelegate:nil];
+    [appDelegate release];
+    [pool release];
+    
+    if (listener())
+      listener()->OnShutdown();
+    
+    if (web_core_)
+      web_core_->Shutdown();
+  }
+  
+  virtual void Run() {
+    Load();
+    
+    [NSApp activateIgnoringOtherApps:YES];
+    [appDelegate startUpdateTimer];
+    [NSApp run];
+  }
+  
+  virtual void Quit() {
+    [app terminate:app];
+  }
+  
+  virtual void Load() {
+    pool = [[NSAutoreleasePool alloc] init];
+    app = [NSApplication sharedApplication];
+    [NSApp setActivationPolicy:NSApplicationActivationPolicyRegular];
+    appDelegate = [[AppDelegate alloc] init];
+    [NSApp setDelegate:appDelegate];
+    
+    web_core_ = WebCore::Initialize(WebConfig());
+    
+    if (listener())
+      listener()->OnLoaded();
+  }
+  
+  virtual View* CreateView(int width, int height) {
+    return View::Create(width, height);
+  }
+  
+  virtual void DestroyView(View* view) {
+    delete view;
+  }
+  
+  virtual void ShowMessage(const char* message) {
+    NSAlert *alert = [[[NSAlert alloc] init] autorelease];
+    [alert setMessageText:[[NSString alloc] initWithUTF8String:message]];
+    [alert runModal];
+  }
+};
+
+Application* Application::Create() {
+  return new ApplicationMac();
+}
+
+@implementation AppDelegate
+
+- (void)startUpdateTimer {
+	timer = [NSTimer timerWithTimeInterval:(1.0f/60.0f)
+                                  target:self
+                                selector:@selector(updateTimer:)
+                                userInfo:nil
+                                 repeats:YES];
+	[[NSRunLoop currentRunLoop] addTimer:timer forMode:NSDefaultRunLoopMode];
+	[[NSRunLoop currentRunLoop] addTimer:timer forMode:NSEventTrackingRunLoopMode];
+}
+
+- (void)applicationWillTerminate:(NSNotification *)aNotification {
+  if (Awesomium::WebCore::instance())
+    Awesomium::WebCore::instance()->Shutdown();
+}
+
+- (BOOL)applicationShouldTerminateAfterLastWindowClosed:(NSApplication *)theApplication {
+  return YES;
+}
+
+- (void)updateTimer:(NSTimer *)timer {
+	if (Awesomium::WebCore::instance())
+    Awesomium::WebCore::instance()->Update();
+}
+
+@end

src/application_win.cc

@@ -0,0 +1,66 @@
+#include "application.h"
+#include "view.h"
+#include <Awesomium/WebCore.h>
+#include <string>
+
+using namespace Awesomium;
+
+class ApplicationWin : public Application {
+  bool is_running_;
+ public:
+  ApplicationWin() {
+    is_running_ = true;
+    listener_ = NULL;
+    web_core_ = NULL;
+  }
+
+  virtual ~ApplicationWin() {
+    if (listener())
+      listener()->OnShutdown();
+
+    if (web_core_)
+      web_core_->Shutdown();
+  }
+
+  virtual void Run() {
+    Load();
+
+    // Main message loop:
+    MSG msg;
+    while (GetMessage(&msg, NULL, 0, 0) && is_running_) {
+      web_core_->Update();
+      TranslateMessage(&msg);
+      DispatchMessage(&msg);
+      if (listener())
+        listener()->OnUpdate();
+    }
+  }
+  
+  virtual void Quit() {
+    is_running_ = false;
+  }
+
+  virtual void Load() {
+     web_core_ = WebCore::Initialize(WebConfig());
+
+    if (listener())
+      listener()->OnLoaded();
+  }
+
+  virtual View* CreateView(int width, int height) {
+    return View::Create(width, height);
+  }
+
+  virtual void DestroyView(View* view) {
+    delete view;
+  }
+
+  virtual void ShowMessage(const char* message) {
+    std::wstring message_str(message, message + strlen(message));
+    MessageBox(0, message_str.c_str(), message_str.c_str(), NULL);
+  }
+};
+
+Application* Application::Create() {
+  return new ApplicationWin();
+}