[PPAPI] Moving pp::VarResource_Dev API into pp::Var (now stable).

ppapi/api/ppb_var.idl

Index: ppapi/api/ppb_var.idl
diff --git a/ppapi/api/ppb_var.idl b/ppapi/api/ppb_var.idl
index 5bc613102acef32b1c6886ab36c99d0612068d20..ecb3707bcfea56b80e442f3f9be692d9af11c9c7 100644
--- a/ppapi/api/ppb_var.idl
+++ b/ppapi/api/ppb_var.idl
@@ -9,7 +9,8 @@
 
 label Chrome {
   M14 = 1.0,
-  M18 = 1.1
+  M18 = 1.1,
+  M34 = 1.2
 };
 
 /**
@@ -112,5 +113,29 @@ interface PPB_Var {
    */
   [version=1.0]
   str_t VarToUtf8([in] PP_Var var, [out] uint32_t len);
+
+  /**
+   * Converts a resource-type var to a <code>PP_Resource</code>.
+   *
+   * @param[in] var A <code>PP_Var</code> struct containing a resource-type var.
+   *
+   * @return A <code>PP_Resource</code> retrieved from the var, or 0 if the var
+   * is not a resource. The reference count of the resource is incremented on
+   * behalf of the caller.
+   */
+  [version=1.2]
+  PP_Resource VarToResource([in] PP_Var var);
+
+  /**
+   * Creates a new <code>PP_Var</code> from a given resource.
+   *
+   * @param[in] resource A <code>PP_Resource</code> to be wrapped in a var.
+   *
+   * @return A <code>PP_Var</code> created for this resource, with type
+   * <code>PP_VARTYPE_RESOURCE</code>. The reference count of the var is set to
+   * 1 on behalf of the caller.
+   */
+  [version=1.2]
+  PP_Var VarFromResource([in] PP_Resource resource);

[dmichael (off chromium), 2014/02/06 17:25:01]

I can't remember, can this hold any PP_Resource, or only ones we support passing
over Messaging? I think it can hold any, in which case the comment is good.

If it can only hold *some*, that should be noted in the comment.

[Matt Giuca, 2014/02/07 03:11:22]

Yes, it can hold any PP_Resource. It will only check if it's convertible when
you try to pass it.

 };