Port the Life example to Pepper 2.

examples/graphics/life/life.h

+// Copyright 2011 The Native Client Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can
+// be found in the LICENSE file.
+
+#ifndef EXAMPLES_GRAPHICS_LIFE_LIFE_H_
+#define EXAMPLES_GRAPHICS_LIFE_LIFE_H_
+
+#include <ppapi/cpp/dev/scriptable_object_deprecated.h>
+#include <ppapi/cpp/graphics_2d.h>
+#include <ppapi/cpp/image_data.h>
+#include <ppapi/cpp/instance.h>
+#include <ppapi/cpp/rect.h>
+#include <ppapi/cpp/size.h>
+#include <pthread.h>
+
+#include <cstdlib>
+#include <map>
+#include <vector>
+
+namespace life {
+// The main object that runs Conway's Life simulation (for details, see:
+// http://en.wikipedia.org/wiki/Conway's_Game_of_Life).  The Update() method
+// is called by the browser to do a single tick of the simulation.
+class Life : public pp::Instance {
+ public:
+  explicit Life(PP_Instance instance);
+  virtual ~Life();
+
+  virtual bool Init(uint32_t argc, const char* argn[], const char* argv[]);
+
+  // Update the graphics context to the new size, and reallocate all new
+  // buffers to the new size.
+  virtual void DidChangeView(const pp::Rect& position, const pp::Rect& clip);
+
+  // Return a pp::Var that represents the interface exposed to the browser.
+  // The pp::Var takes over ownership of the returned script object.
+  virtual pp::Var GetInstanceObject();
+
+  // Runs a tick of the simulations, updating all buffers.  Flushes the
+  // contents of |pixel_buffer_| to the 2D graphics context.  This method is
+  // exposed to the browser as "update()".
+  void Update();
+
+  // Plot a new blob of life centered around (|var_x|, |var_y|).  This method
+  // is exposed to the browser as "addCellAtPoint()".
+  void AddCellAtPoint(const pp::Var& var_x, const pp::Var& var_y);
+
+  int width() const {
+    return pixel_buffer_ ? pixel_buffer_->size().width() : 0;
+  }
+  int height() const {
+    return pixel_buffer_ ? pixel_buffer_->size().height() : 0;
+  }
+
+  uint32_t* pixels() const {
+    if (pixel_buffer_ != NULL && !pixel_buffer_->is_null()) {
+      return reinterpret_cast<uint32_t*>(pixel_buffer_->data());
+    }
+    return NULL;
+  }
+
+  // Indicate whether a flush is pending.  This can only be called from the
+  // main thread; it is not thread safe.
+  bool flush_pending() const {
+    return flush_pending_;
+  }
+  void set_flush_pending(bool flag) {
+    flush_pending_ = flag;
+  }
+
+ private:
+  // This class exposes the scripting interface for this NaCl module.  The
+  // HasMethod method is called by the browser when executing a method call on
+  // the |life| object (see, e.g. the update() function in
+  // life.html).  The name of the JavaScript function (e.g. "paint") is
+  // passed in the |method| parameter as a string pp::Var.  If HasMethod()
+  // returns |true|, then the browser will call the Call() method to actually
+  // invoke the method.
+  class LifeScriptObject : public pp::deprecated::ScriptableObject {
+   public:
+    explicit LifeScriptObject(Life* app_instance)
+        : pp::deprecated::ScriptableObject(),
+          app_instance_(app_instance) {}
+    virtual ~LifeScriptObject() {}
+    // Return |true| if |method| is one of the exposed method names.
+    virtual bool HasMethod(const pp::Var& method, pp::Var* exception);
+
+    // Invoke the function associated with |method|.  The argument list passed
+    // in via JavaScript is marshaled into a vector of pp::Vars.
+    virtual pp::Var Call(const pp::Var& method,
+                         const std::vector<pp::Var>& args,
+                         pp::Var* exception);
+   private:
+    Life* app_instance_;  // weak reference.
+  };
+
+  // Produce single bit random values.  Successive calls to value() should
+  // return 0 or 1 with a random distribution.
+  class RandomBitGenerator {
+   public:
+    RandomBitGenerator() : random_bit_seed_(kInitialRandSeed) {}
+    // Return the next random bit value.  Note that value() can't be a const
+    // function because it changes the internal state machine as part of its
+    // mechanism.
+    uint8_t value();
+
+   private:
+    static const uint32_t kInitialRandSeed;

[dmichael(do not use this one), 2011/02/03 20:08:44]

I'd rather remove the static and make random_bit_seed_ get initialized in the
constructor.  You can use a constant for the initial seed and have Life's
constructor initialize it using that constant.

[David Springer, 2011/02/03 21:09:47]

Done.

+    unsigned int random_bit_seed_;
+  };
+
+  // Plot a new seed cell in the simulation.  If |x| or |y| fall outside of the
+  // size of the 2D context, then do nothing.
+  void Plot(int x, int y);
+
+  // Add in some random noise to the borders of the simulation, which is used
+  // to determine the life of adjacent cells.  This is part of a simulation
+  // tick.
+  void Stir();
+
+  // Draw the current state of the simulation into the pixel buffer.
+  void UpdateCells();
+
+  // Swap the input and output cell arrays.
+  void Swap();
+
+  // Create and initialize the 2D context used for drawing.
+  void CreateContext(const pp::Size& size);
+  // Destroy the 2D drawing context.
+  void DestroyContext();
+  // Push the pixels to the browser, then attempt to flush the 2D context.  If
+  // there is a pending flush on the 2D context, then update the pixels only
+  // and do not flush.
+  void FlushPixelBuffer();
+
+  bool IsContextValid() const {
+    return graphics_2d_context_ != NULL;
+  }
+
+  pp::Graphics2D* graphics_2d_context_;
+  pp::ImageData* pixel_buffer_;
+  RandomBitGenerator random_bits_;
+  bool flush_pending_;
+  uint8_t* cell_in_;
+  uint8_t* cell_out_;
+};
+
+}  // namespace life
+
+#endif  // EXAMPLES_GRAPHICS_LIFE_LIFE_H_
+