From 11c5ab28040c31e22a39e882a3e0da2128c81c4b Mon Sep 17 00:00:00 2001
From: Tj Holowaychuk <tj@vision-media.ca>
Date: Tue, 5 Oct 2010 16:22:58 -0700
Subject: [PATCH 1/2] Added clip()

---
 src/context2d.cc | 18 ++++++++++++++++--
 src/context2d.h  |  1 +
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/src/context2d.cc b/src/context2d.cc
index 9bafb90..db53ccf 100644
--- a/src/context2d.cc
+++ b/src/context2d.cc
@@ -80,6 +80,7 @@ Context2d::Initialize(Handle<Object> target) {
   NODE_SET_PROTOTYPE_METHOD(t, "transform", Transform);
   NODE_SET_PROTOTYPE_METHOD(t, "resetTransform", ResetTransform);
   NODE_SET_PROTOTYPE_METHOD(t, "scale", Scale);
+  NODE_SET_PROTOTYPE_METHOD(t, "clip", Clip);
   NODE_SET_PROTOTYPE_METHOD(t, "fill", Fill);
   NODE_SET_PROTOTYPE_METHOD(t, "stroke", Stroke);
   NODE_SET_PROTOTYPE_METHOD(t, "fillRect", FillRect);
@@ -549,7 +550,20 @@ Context2d::Scale(const Arguments &args) {
 }
 
 /*
- * Fill the shape.
+ * Use path as clipping region.
+ */
+
+Handle<Value>
+Context2d::Clip(const Arguments &args) {
+  HandleScope scope;
+  Context2d *context = ObjectWrap::Unwrap<Context2d>(args.This());
+  cairo_t *ctx = context->getContext();
+  cairo_clip_preserve(ctx);
+  return Undefined();
+}
+
+/*
+ * Fill the path.
  */
 
 Handle<Value>
@@ -563,7 +577,7 @@ Context2d::Fill(const Arguments &args) {
 }
 
 /*
- * Stroke the shape.
+ * Stroke the path.
  */
 
 Handle<Value>
diff --git a/src/context2d.h b/src/context2d.h
index a242152..a61f452 100644
--- a/src/context2d.h
+++ b/src/context2d.h
@@ -33,6 +33,7 @@ class Context2d: public node::ObjectWrap {
     static Handle<Value> ResetTransform(const Arguments &args);
     static Handle<Value> BeginPath(const Arguments &args);
     static Handle<Value> ClosePath(const Arguments &args);
+    static Handle<Value> Clip(const Arguments &args);
     static Handle<Value> Fill(const Arguments &args);
     static Handle<Value> Stroke(const Arguments &args);
     static Handle<Value> SetSource(const Arguments &args);

From b813b887e06820625edfd7bdbd73e53854c0c5ca Mon Sep 17 00:00:00 2001
From: Tj Holowaychuk <tj@vision-media.ca>
Date: Tue, 5 Oct 2010 16:25:16 -0700
Subject: [PATCH 2/2] Added clip() test

---
 test/canvas.test.js | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/test/canvas.test.js b/test/canvas.test.js
index 0804507..d234030 100644
--- a/test/canvas.test.js
+++ b/test/canvas.test.js
@@ -462,5 +462,23 @@ module.exports = {
       , '2ba95ccadd5c38949a5ea493dbc78e08'
       , 'Context2d invalid fillStyle did not retain previous value');
     
+  },
+  
+  'test Context2d#clip()': function(assert){
+    var canvas = new Canvas(200, 200)
+      , ctx = canvas.getContext('2d')
+      , path = __dirname + '/images/clip.png';
+    
+    ctx.arc(50,50,50,0,Math.PI * 2);
+    ctx.stroke();
+    ctx.clip();
+    ctx.fillStyle = 'rgba(0,0,0,.5)';
+    ctx.fillRect(0,0,100,100);
+    
+    assertChecksum(
+        canvas
+      , path
+      , '6199442d05718481ac5ccd034239f6f1'
+      , 'Context2d#clip() failed');
   }
 }
\ No newline at end of file