blob: 62cc23e38582d70fc24991b159427c27f965191a [file] [log] [blame]
/* 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.
*/
/**
* Implementation of the Printing interface.
*/
label Chrome {
M14 = 0.5
};
[assert_size(4)]
enum PP_PrintOrientation_Dev {
PP_PRINTORIENTATION_NORMAL = 0,
PP_PRINTORIENTATION_ROTATED_90_CW = 1,
PP_PRINTORIENTATION_ROTATED_180 = 2,
PP_PRINTORIENTATION_ROTATED_90_CCW = 3
};
[assert_size(4)]
enum PP_PrintOutputFormat_Dev {
PP_PRINTOUTPUTFORMAT_RASTER = 1u << 0,
PP_PRINTOUTPUTFORMAT_PDF = 1u << 1,
PP_PRINTOUTPUTFORMAT_POSTSCRIPT = 1u << 2,
PP_PRINTOUTPUTFORMAT_EMF = 1u << 3
};
[assert_size(32)]
struct PP_PrintSettings_Dev {
/** This is the size of the printable area in points (1/72 of an inch) */
PP_Rect printable_area;
int32_t dpi;
PP_PrintOrientation_Dev orientation;
PP_Bool grayscale;
PP_PrintOutputFormat_Dev format;
};
/**
* Specifies a contiguous range of page numbers to be printed.
* The page numbers use a zero-based index.
*/
[assert_size(8)]
struct PP_PrintPageNumberRange_Dev {
uint32_t first_page_number;
uint32_t last_page_number;
};
interface 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([in] PP_Instance instance);
/**
* 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([in] PP_Instance instance,
[in] 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_Buffer otherwise. Returns 0 on
* failure.
*/
PP_Resource PrintPages([in] PP_Instance instance,
[in] PP_PrintPageNumberRange_Dev page_ranges,
[in] uint32_t page_range_count);
/** Ends the print session. Further calls to PrintPage will fail. */
void End([in] 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.
*/
PP_Bool IsScalingDisabled([in] PP_Instance instance);
};