C API: Add SK_API, also documentation of an example.

src/c/sk_surface.cpp

 /*
  * Copyright 2014 Google Inc.
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
-#include "sk_canvas.h"
-#include "sk_data.h"
-#include "sk_image.h"
-#include "sk_paint.h"
-#include "sk_path.h"
-#include "sk_surface.h"
-#include "sk_types_priv.h"
-
 #include "SkCanvas.h"
 #include "SkData.h"
 #include "SkImage.h"
 #include "SkMaskFilter.h"
 #include "SkMatrix.h"
 #include "SkPaint.h"
 #include "SkPath.h"
 #include "SkPictureRecorder.h"
 #include "SkSurface.h"
 
+#include "sk_canvas.h"
+#include "sk_data.h"
+#include "sk_image.h"
+#include "sk_paint.h"
+#include "sk_path.h"
+#include "sk_surface.h"
+#include "sk_types_priv.h"
+
 const struct {
     sk_colortype_t  fC;
     SkColorType     fSK;
 } gColorTypeMap[] = {
     { UNKNOWN_SK_COLORTYPE,     kUnknown_SkColorType    },
     { RGBA_8888_SK_COLORTYPE,   kRGBA_8888_SkColorType  },
     { BGRA_8888_SK_COLORTYPE,   kBGRA_8888_SkColorType  },
     { ALPHA_8_SK_COLORTYPE,     kAlpha_8_SkColorType    },
 };
 
@@ skipping 663 matching lines @@
 
 size_t sk_data_get_size(const sk_data_t* cdata) {
     return AsData(cdata)->size();
 }
 
 const void* sk_data_get_data(const sk_data_t* cdata) {
     return AsData(cdata)->data();
 }
 
 ///////////////////////////////////////////////////////////////////////////////////////////