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

ppapi/api/ppb_var.idl

 /* Copyright (c) 2012 The Chromium Authors. All rights reserved.
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 /**
  * This file defines the <code>PPB_Var</code> struct.
  */
 
 label Chrome {
   M14 = 1.0,
-  M18 = 1.1
+  M18 = 1.1,
+  M34 = 1.2
 };
 
 /**
  * PPB_Var API
  */
 interface PPB_Var {
   /**
    * AddRef() adds a reference to the given var. If this is not a refcounted
    * object, this function will do nothing so you can always call it no matter
    * what the type.
@@ skipping 82 matching lines @@
    * If the instance frees its reference, the string will be freed and the
    * pointer will be to arbitrary memory.
    *
    * @param[in] var A PP_Var struct containing a string-type var.
    * @param[in,out] len A pointer to the length of the string-type var.
    *
    * @return A char* encoded in UTF-8.
    */
   [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.

 };