Add IsScalingDisabled and PP_PRINTOUTPUTFORMAT_EMF to pepper printing interface.

ppapi/c/dev/ppp_printing_dev.h

 /* Copyright (c) 2011 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.
  */
 #ifndef PPAPI_C_DEV_PPP_PRINTING_DEV_H_
 #define PPAPI_C_DEV_PPP_PRINTING_DEV_H_
 
 #include "ppapi/c/pp_bool.h"
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_macros.h"
 #include "ppapi/c/pp_rect.h"
 #include "ppapi/c/pp_resource.h"
 #include "ppapi/c/pp_stdint.h"
 
 typedef enum {
   PP_PRINTORIENTATION_NORMAL         = 0,
   PP_PRINTORIENTATION_ROTATED_90_CW  = 1,
   PP_PRINTORIENTATION_ROTATED_180    = 2,
   PP_PRINTORIENTATION_ROTATED_90_CCW = 3
 } PP_PrintOrientation_Dev;
 PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_PrintOrientation_Dev, 4);
 
 typedef enum {
   PP_PRINTOUTPUTFORMAT_RASTER     = 1u << 0,
   PP_PRINTOUTPUTFORMAT_PDF        = 1u << 1,
-  PP_PRINTOUTPUTFORMAT_POSTSCRIPT = 1u << 2
+  PP_PRINTOUTPUTFORMAT_POSTSCRIPT = 1u << 2,
+  PP_PRINTOUTPUTFORMAT_EMF        = 1u << 3
 } PP_PrintOutputFormat_Dev;
 PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_PrintOutputFormat_Dev, 4);
 
 struct PP_PrintSettings_Dev {
   /** This is the size of the printable area in points (1/72 of an inch) */
   struct PP_Rect printable_area;
   int32_t dpi;
   PP_PrintOrientation_Dev orientation;
   PP_Bool grayscale;
   PP_PrintOutputFormat_Dev format;
 };
 PP_COMPILE_ASSERT_STRUCT_SIZE_IN_BYTES(PP_PrintSettings_Dev, 32);
 
 /**
  * Specifies a contiguous range of page numbers to be printed.
  * The page numbers use a zero-based index.
  */
 struct PP_PrintPageNumberRange_Dev {
   uint32_t first_page_number;
   uint32_t last_page_number;
 };
 PP_COMPILE_ASSERT_STRUCT_SIZE_IN_BYTES(PP_PrintPageNumberRange_Dev, 8);
 
 /* Interface for the plugin to implement printing. */
-#define PPP_PRINTING_DEV_INTERFACE_0_4 "PPP_Printing(Dev);0.4"
-#define PPP_PRINTING_DEV_INTERFACE PPP_PRINTING_DEV_INTERFACE_0_4
+#define PPP_PRINTING_DEV_INTERFACE_0_5 "PPP_Printing(Dev);0.5"
+#define PPP_PRINTING_DEV_INTERFACE PPP_PRINTING_DEV_INTERFACE_0_5
 
 struct PPP_Printing_Dev {
   /**
    *  Returns a bit field representing the supported print output formats.  For
    *  example, if only Raster and PostScript are supported,
    *  QuerySupportedFormats returns a value equivalent to:
    *  (PP_PRINTOUTPUTFORMAT_RASTER | PP_PRINTOUTPUTFORMAT_POSTSCRIPT)
    */
   uint32_t (*QuerySupportedFormats)(PP_Instance instance);
 
   /**
+   *  Returns true if the current content should be printed into the full page
+   *  and not scaled down to fit within the printer's printable area.
+   */
+  bool (*IsScalingDisabled)(PP_Instance instance);

[dmichael (off chromium), 2011/09/27 15:28:38]

We avoid using bool in C for various reasons (particularly, the C definition is
not necessarily compatible with C++ bool, which can lead to problems keeping a
consistent ABI). Please use PP_Bool.

Also...  we'll generally want to add functions on to the end instead of in the
middle. It makes the backwards-compatibility slightly easier in some cases.
(E.g., a plugin that wants to support 0.5 and 0.4 could safely return a 0.5
struct for either if the new function was on the end). Since this is still a Dev
interface though, it's fine to put it here if this seems like the most logical
place for it to go long term.

[vandebo (ex-Chrome), 2011/09/27 20:02:24]

Done.
 
Because there's an End method, I think anyone changing this is going to want to
add to the middle somewhere.  I've pulled my new method to the end because I
think you requested that in a later comment.

+
+  /**
    * Begins a print session with the given print settings. Calls to PrintPage
    * can only be made after a successful call to Begin. Returns the number of
    * pages required for the print output at the given page size (0 indicates
    * a failure).
    */
   int32_t (*Begin)(PP_Instance instance,
                    const struct PP_PrintSettings_Dev* print_settings);
 
   /**
    * Prints the specified pages using the format specified in Begin.
    * Returns a resource that represents the printed output.
    * This is a PPB_ImageData resource if the output format is
    * PP_PrintOutputFormat_Raster and a PPB_Blob otherwise. Returns 0 on
    * failure.
    */
   PP_Resource (*PrintPages)(
       PP_Instance instance,
       const struct PP_PrintPageNumberRange_Dev* page_ranges,
       uint32_t page_range_count);
 
   /** Ends the print session. Further calls to PrintPage will fail. */
   void (*End)(PP_Instance instance);
 };
 
 #endif  /* PPAPI_C_DEV_PPP_PRINTING_DEV_H_ */