Foxit PDF SDK
|
Public Member Functions | |
def | Renderer (bitmap, is_rgb_order) |
Constructor, with bitmap. More... | |
def | Renderer (other) |
Constructor, with another renderer object. More... | |
def | EnableForPrint (is_render_for_print) |
Set the flag to decide whether to do rendering in print mode. More... | |
def | IsEmpty () |
Check whether current object is empty or not. More... | |
def | RenderAnnot (annot, matrix) |
Render a specified annotation. More... | |
def | RenderFormControls (page, matrix) |
Render form controls. More... | |
def | RenderGraphicsObject (graphics_object, page, matrix) |
Render a graphics object. More... | |
def | SetClearType (is_clear_type) |
Set the flag to decide whether to use ClearType-like anti-aliasing to render text objects. More... | |
def | SetClipPathFill (clip_path, matrix, fill_mode) |
Set clipping path using filled region. More... | |
def | SetClipPathStroke (clip_path, matrix, graph_state) |
Set clipping path using stroked region. More... | |
def | SetClipRect (clip_rect) |
Set the clipping rectangle which will be used in following rendering progress. More... | |
def | SetColorMode (color_mode) |
Set color mode. More... | |
def | SetForceDownSample (is_to_force_down_sample) |
Set the flag to decide whether to use down-sampling for image stretching. More... | |
def | SetForceHalftone (is_to_force_halftone) |
Set the flag to decide whether to use halftone for image stretching. More... | |
def | SetJPEGDownSample (is_jepg_down_sample) |
Set the flag to decide whether to use down-sampling for jpeg image. More... | |
def | SetJPXDownSample (is_jpx_down_sample) |
Set the flag to decide whether to use down-sampling for jpx image. More... | |
def | SetLayerContext (layer_context) |
Set layer context to render context handle. More... | |
def | SetMappingModeColors (background_color, foreground_color) |
Set background color and foreground color when color mode is FoxitPDFSDKPython2.Renderer.e_ColorModeMappingGray or FoxitPDFSDKPython2.Renderer.e_ColorModeMapping . More... | |
def | SetPrintTextAsGraphic (is_to_print_text_graphic) |
Set the flag to decide whether to print text as path or bitmap. More... | |
def | SetPrintTextAsImage (is_to_print_text_image) |
Set the flag to decide whether to print text as image. More... | |
def | SetRenderAnnotAppearanceType (ap_type) |
Set the annotation's appearance type for rendering. More... | |
def | SetRenderAnnotsForThumbnail (is_render_annots_for_thumbnail) |
Set rendering flag to decide whether to render annotations in thumbnail mode or not. More... | |
def | SetRenderContentFlags (render_content_flags) |
Set rendering flag to decide what content will be rendered. More... | |
def | SetRenderEnhanceThinLines (is_render_enhance_thin_lines) |
Set the flag to decide whether to enhance thin lines. More... | |
def | SetRenderFormField (is_render_formfield) |
Set the flag to decide whether to render form fields (except signature fields). More... | |
def | SetRenderImageAntiAliasing (is_render_image_antialiasing) |
Set the flag to decide whether to draw image anti-aliasing. More... | |
def | SetRenderPathAntiAliasing (is_render_path_antialiasing) |
Set the flag to decide whether to draw path anti-aliasing. More... | |
def | SetRenderPathFullCovered (is_render_path_full_covered) |
A special flag that can be applied to fill mode. More... | |
def | SetRenderPathThinLine (is_render_path_thin_line) |
Set the flag to decide whether to draw path as thin line. More... | |
def | SetRenderSignature (is_render_signature) |
Set the flag to decide whether to render signatures or not. More... | |
def | SetRenderSignatureState (is_render_signature_state) |
Set the flag to decide whether to draw the signature state on the signature. More... | |
def | SetRenderTextAntiAliasing (is_render_text_antialiasing) |
Set the flag to decide whether to draw text anti-aliasing. More... | |
def | StartQuickRender (page, matrix, pause) |
Start to quickly render a PDF page, mainly for thumbnail purpose. More... | |
def | StartRender (page, matrix, pause) |
Start to render a PDF page. More... | |
def | StartRenderBitmap (bitmap, matrix, clip_rect, interpolation, pause) |
Start to render a bitmap. More... | |
def | StartRenderReflowPage (reflow_page, matrix, pause) |
Start to render a reflow page. More... | |
def | StartRenderXFAPage (xfa_page_view, matrix, is_highlight, pause) |
Start to render an XFA page. More... | |
Static Public Attributes | |
e_ColorModeMapping = _fsdk.Renderer_e_ColorModeMapping | |
Map a color value to the color range defined by a background color and a foreground color. | |
e_ColorModeMappingGray = _fsdk.Renderer_e_ColorModeMappingGray | |
Map gray/white/black color value to background/foreground; for other colors, no change. | |
e_RenderAnnot = _fsdk.Renderer_e_RenderAnnot | |
If set, annotations will be rendered. | |
PDF renderer is a graphics engine and is used to render page to a bitmap or a platform device context. This class can be constructed with a bitmap, or a device object. It offers functions to set rendering options/flags, and do rendering. In this class, there are several ways to do rendering:
Widget annotation is always associated with form field and form control in Foxit PDF SDK. For how to render widget annotations, here is a recommended flow:
def FoxitPDFSDKPython2.Renderer.Renderer | ( | bitmap, | |
is_rgb_order | |||
) |
Constructor, with bitmap.
The input bitmap is treated as an independent device and all the content rendered by the renderer would appear in the bitmap.
[in] | bitmap | A bitmap used for rendering. User should ensure the bitmap to keep valid until the end of life cycle of current renderer object. The format of bitmap should not be FoxitPDFSDKPython2.Bitmap.e_DIB1bpp . |
[in] | is_rgb_order | true means Foxit PDF SDK needs to use RGB byte-order (Red is in the lowest order) when rendering. false means Foxit PDF SDK needs to use BGR byte-order (Blue is in the lowest order) when rendering. |
def FoxitPDFSDKPython2.Renderer.Renderer | ( | other | ) |
Constructor, with another renderer object.
[in] | other | Another renderer object. |
def FoxitPDFSDKPython2.Renderer.EnableForPrint | ( | is_render_for_print | ) |
Set the flag to decide whether to do rendering in print mode.
Please ensure this rendering flag is set as expected when current renderer is to used for printing. For rendering annotations, if this flag is set to be true, Foxit PDF SDK will only render annotations which have annotation flag FoxitPDFSDKPython2.Annot.e_FlagPrint .
If this function is not called for current renderer object yet, default value false will be used.
[in] | is_render_for_print | true means to render in print mode, while false means to render not in print mode. |
def FoxitPDFSDKPython2.Renderer.IsEmpty | ( | ) |
Check whether current object is empty or not.
When the current object is empty, that means current object is useless.
def FoxitPDFSDKPython2.Renderer.RenderAnnot | ( | annot, | |
matrix | |||
) |
Render a specified annotation.
When this function is called, rendering flag (set by function FoxitPDFSDKPython2.Renderer.SetRenderContentFlags or by default) will be ignored.
[in] | annot | An annotation object to be rendered. If input annot is a pop-up annotation, this function will not render it and will return false. |
[in] | matrix | The transformation matrix used for rendering, which is usually returned by function FoxitPDFSDKPython2.PDFPage.GetDisplayMatrix . |
def FoxitPDFSDKPython2.Renderer.RenderFormControls | ( | page, | |
matrix | |||
) |
Render form controls.
When this function is called, rendering flag (set by function FoxitPDFSDKPython2.Renderer.SetRenderContentFlags or by default) will be ignored.
[in] | page | A valid PDF page. If input page is invalid, this function do nothing and return false directly. |
[in] | matrix | The transformation matrix used for rendering, which is usually returned by function FoxitPDFSDKPython2.PDFPage.GetDisplayMatrix . |
def FoxitPDFSDKPython2.Renderer.RenderGraphicsObject | ( | graphics_object, | |
page, | |||
matrix | |||
) |
Render a graphics object.
When this function is called, rendering flag (set by function FoxitPDFSDKPython2.Renderer.SetRenderContentFlags or by default) will be ignored.
[in] | graphics_object | A valid PDF graphics object to be rendered. |
[in] | page | A valid PDF page. Parameter graphics_object belongs to this PDF page. |
[in] | matrix | The transformation matrix used for rendering, which is usually returned by function FoxitPDFSDKPython2.PDFPage.GetDisplayMatrix . |
def FoxitPDFSDKPython2.Renderer.SetClearType | ( | is_clear_type | ) |
Set the flag to decide whether to use ClearType-like anti-aliasing to render text objects.
If this function is not called, default value true will be used.
[in] | is_clear_type | true means to use ClearType-like anti-aliasing to render text objects. false means not to use ClearType-like anti-aliasing to render text objects. |
def FoxitPDFSDKPython2.Renderer.SetClipPathFill | ( | clip_path, | |
matrix, | |||
fill_mode | |||
) |
Set clipping path using filled region.
[in] | clip_path | A clipping path. |
[in] | matrix | The transformation matrix used for clipping. |
[in] | fill_mode | Fill mode. It should be value or . |
def FoxitPDFSDKPython2.Renderer.SetClipPathStroke | ( | clip_path, | |
matrix, | |||
graph_state | |||
) |
Set clipping path using stroked region.
[in] | clip_path | A clipping path. |
[in] | matrix | The transformation matrix used for clipping. |
[in] | graph_state | A valid graph state, for pen attributes. If this is null, Foxit PDF SDK will use a graph state object with default constructor. |
def FoxitPDFSDKPython2.Renderer.SetClipRect | ( | clip_rect | ) |
Set the clipping rectangle which will be used in following rendering progress.
[in] | clip_rect | A clipping rectangle. If it is null, that means not to use clipping rectangle in following rendering progress. |
def FoxitPDFSDKPython2.Renderer.SetColorMode | ( | color_mode | ) |
Set color mode.
If this function is not called, default value FoxitPDFSDKPython2.Renderer.e_ColorModeNormal will be used.
[in] | color_mode | Color mode value. It should be one of following values:
|
def FoxitPDFSDKPython2.Renderer.SetForceDownSample | ( | is_to_force_down_sample | ) |
Set the flag to decide whether to use down-sampling for image stretching.
If this function is not called, default value false will be used.
[in] | is_to_force_down_sample | true means to use down-sampling for image stretching. false means not to use down-sampling for image stretching. |
def FoxitPDFSDKPython2.Renderer.SetForceHalftone | ( | is_to_force_halftone | ) |
Set the flag to decide whether to use halftone for image stretching.
If this function is not called, default value false will be used.
[in] | is_to_force_halftone | true means to use halftone for image stretching. false means not to use halftone for image stretching. |
def FoxitPDFSDKPython2.Renderer.SetJPEGDownSample | ( | is_jepg_down_sample | ) |
Set the flag to decide whether to use down-sampling for jpeg image.
Whether to use down-sampling for jpeg image or not will affect rendering result for a PDF page. When current function is called successfully, user should called function FoxitPDFSDKPython2.PDFPage.ClearRenderCache for a PDF page (which has been rendered at least once) before rendering the PDF page again.
If this function is not called, default value true will be used.
[in] | is_jepg_down_sample | true means to use down-sampling for jpeg image. false means not to use down-sampling for jpeg image. |
def FoxitPDFSDKPython2.Renderer.SetJPXDownSample | ( | is_jpx_down_sample | ) |
Set the flag to decide whether to use down-sampling for jpx image.
Whether to use down-sampling for jpx image or not will affect rendering result for a PDF page. When current function is called successfully, user should called function FoxitPDFSDKPython2.PDFPage.ClearRenderCache for a PDF page (which has been rendered at least once) before rendering the PDF page again.
If this function is not called, default value true will be used.
[in] | is_jpx_down_sample | true means to use down-sampling for jpx image. false means not to use down-sampling for jpx image. |
def FoxitPDFSDKPython2.Renderer.SetLayerContext | ( | layer_context | ) |
Set layer context to render context handle.
In order to render one layer when PDF page's contents is rendered on a rendering context, user should call this function to set the layer context to render context.
[in] | layer_context | A layer context object. |
def FoxitPDFSDKPython2.Renderer.SetMappingModeColors | ( | background_color, | |
foreground_color | |||
) |
Set background color and foreground color when color mode is FoxitPDFSDKPython2.Renderer.e_ColorModeMappingGray or FoxitPDFSDKPython2.Renderer.e_ColorModeMapping .
[in] | background_color | The background color. Format: 0xAARRGGBB. |
[in] | foreground_color | The foreground color. Format: 0xAARRGGBB. |
def FoxitPDFSDKPython2.Renderer.SetPrintTextAsGraphic | ( | is_to_print_text_graphic | ) |
Set the flag to decide whether to print text as path or bitmap.
When this flag is true, Foxit PDF SDK will render text in different way: if font size is greater than 50, print text as path; otherwise, print text as bitmap.
If this function is not called, default value false will be used.
[in] | is_to_print_text_graphic | true means to print text as path or bitmap. false means not to print text as path or bitmap. |
def FoxitPDFSDKPython2.Renderer.SetPrintTextAsImage | ( | is_to_print_text_image | ) |
Set the flag to decide whether to print text as image.
If this function is not called, default value false will be used.
[in] | is_to_print_text_image | true means to print text as image. false means not to print text as image. |
def FoxitPDFSDKPython2.Renderer.SetRenderAnnotAppearanceType | ( | ap_type | ) |
Set the annotation's appearance type for rendering.
[in] | ap_type | Type of annotation's appearance. Please refer to values starting from FoxitPDFSDKPython2.Annot.e_AppearanceTypeNormal and this should be one of these values. |
def FoxitPDFSDKPython2.Renderer.SetRenderAnnotsForThumbnail | ( | is_render_annots_for_thumbnail | ) |
Set rendering flag to decide whether to render annotations in thumbnail mode or not.
In thumbnail mode, the flags of annotations, "NoZoom" and "NoRotate", will be ignored. This rendering flag is available only when flag FoxitPDFSDKPython2.Renderer.e_RenderAnnot is used for rendering or function FoxitPDFSDKPython2.Renderer.RenderAnnot is called. Please refer to function FoxitPDFSDKPython2.Renderer.SetRenderContentFlags about setting flag FoxitPDFSDKPython2.Renderer.e_RenderAnnot .
If this function is not called, default value false will be used when this rendering flag is available.
[in] | is_render_annots_for_thumbnail | true means to render annotations in thumbnail mode. false means not to render annotations in thumbnail mode. |
def FoxitPDFSDKPython2.Renderer.SetRenderContentFlags | ( | render_content_flags | ) |
Set rendering flag to decide what content will be rendered.
If this function is not called, default value (FoxitPDFSDKPython2.Renderer.e_RenderPage | FoxitPDFSDKPython2.Renderer.e_RenderAnnot ) will be used.
[in] | render_content_flags | Rendering content flags. Please refer to values starting from FoxitPDFSDKPython2.Renderer.e_RenderPage and this should be one or a combination of these values. |
def FoxitPDFSDKPython2.Renderer.SetRenderEnhanceThinLines | ( | is_render_enhance_thin_lines | ) |
Set the flag to decide whether to enhance thin lines.
If this function is not called, default value false will be used.
[in] | is_render_enhance_thin_lines | true means to draw zero width lines with a thicker path so they are more visible than the default single pixel. false means to draw zero width lines with a single pixel width. |
def FoxitPDFSDKPython2.Renderer.SetRenderFormField | ( | is_render_formfield | ) |
Set the flag to decide whether to render form fields (except signature fields).
If this function is not called, default value true will be used when this flag is available.
[in] | is_render_formfield | true means to render form fields (except signature fields). false means not to render form fields (except signature fields). |
def FoxitPDFSDKPython2.Renderer.SetRenderImageAntiAliasing | ( | is_render_image_antialiasing | ) |
Set the flag to decide whether to draw image anti-aliasing.
If this function is not called, default value true will be used.
[in] | is_render_image_antialiasing | true means to draw image anti-aliasing, and the effect would be similar to values defined in enum class InterpolationFlag. false means to draw image aliasing. |
def FoxitPDFSDKPython2.Renderer.SetRenderPathAntiAliasing | ( | is_render_path_antialiasing | ) |
Set the flag to decide whether to draw path anti-aliasing.
If this function is not called, default value true will be used.
[in] | is_render_path_antialiasing | true means to draw path anti-aliasing. false means to draw path aliasing. |
def FoxitPDFSDKPython2.Renderer.SetRenderPathFullCovered | ( | is_render_path_full_covered | ) |
A special flag that can be applied to fill mode.
If this function is not called, default value false will be used.
[in] | is_render_path_full_covered | true means that all pixels partially covered by the path will be fully painted, while false means not. |
def FoxitPDFSDKPython2.Renderer.SetRenderPathThinLine | ( | is_render_path_thin_line | ) |
Set the flag to decide whether to draw path as thin line.
If this function is not called, default value false will be used.
[in] | is_render_path_thin_line | true means to draw path as thin line. false means not to draw path as thin line. |
def FoxitPDFSDKPython2.Renderer.SetRenderSignature | ( | is_render_signature | ) |
Set the flag to decide whether to render signatures or not.
If this function is not called, default value true will be used when this flag is available.
[in] | is_render_signature | true means to render signatures. false means not to render signatures. |
def FoxitPDFSDKPython2.Renderer.SetRenderSignatureState | ( | is_render_signature_state | ) |
Set the flag to decide whether to draw the signature state on the signature.
If this function is not called, default value true will be used.
[in] | is_render_signature_state | true means to draw the signature state on the signature, while false means not. |
def FoxitPDFSDKPython2.Renderer.SetRenderTextAntiAliasing | ( | is_render_text_antialiasing | ) |
Set the flag to decide whether to draw text anti-aliasing.
If this function is not called, default value true will be used.
[in] | is_render_text_antialiasing | true means to draw text anti-aliasing. false means to draw text aliasing. |
def FoxitPDFSDKPython2.Renderer.StartQuickRender | ( | page, | |
matrix, | |||
pause | |||
) |
Start to quickly render a PDF page, mainly for thumbnail purpose.
This function is mainly used for render a page for thumbnail purpose. The rendered content will not be completed: all the annotations will be ignored, event if flag FoxitPDFSDKPython2.Renderer.e_RenderAnnot is set by function FoxitPDFSDKPython2.Renderer.SetRenderContentFlags ; text content will become blurred and will be replace by pixel point.
It may still take a long time to do this quick rendering when page has complex or large contents, so Foxit PDF SDK uses a progressive process to do this.
[in] | page | A valid PDF page. It should have been parsed. |
[in] | matrix | The transformation matrix used for rendering, which is usually returned by function FoxitPDFSDKPython2.PDFPage.GetDisplayMatrix . |
[in] | pause | Pause callback object which decides if the rendering process needs to be paused. This can be null which means not to pause during the rendering process. If this is not null, it should be a valid pause object implemented by user. |
def FoxitPDFSDKPython2.Renderer.StartRender | ( | page, | |
matrix, | |||
pause | |||
) |
Start to render a PDF page.
It may take a long time to render a PDF page with complex or large contents, so Foxit PDF SDK uses a progressive process to do this.
Widget annotation is always associated with form field and form control in Foxit PDF SDK. For how to render widget annotations, here is a recommended flow:
[in] | page | A valid PDF page. If only to render annotations (that means only FoxitPDFSDKPython2.Renderer.e_RenderAnnot is set by function FoxitPDFSDKPython2.Renderer.SetRenderContentFlags ), there is no need to parse the input page; otherwise the input page should have been parsed. |
[in] | matrix | The transformation matrix used for rendering, which is usually returned by function FoxitPDFSDKPython2.PDFPage.GetDisplayMatrix . |
[in] | pause | Pause callback object which decides if the rendering process needs to be paused. This can be null which means not to pause during the rendering process. If this is not null, it should be a valid pause object implemented by user. |
def FoxitPDFSDKPython2.Renderer.StartRenderBitmap | ( | bitmap, | |
matrix, | |||
clip_rect, | |||
interpolation, | |||
pause | |||
) |
Start to render a bitmap.
It may take a long time to render a bitmap with complex or large contents, so Foxit PDF SDK uses a progressive process to do this.
[in] | bitmap | A valid bitmap. User should ensure the bitmap to keep valid until current rendering process is finished. |
[in] | matrix | The transformation matrix used for rendering. This matrix is used as image matrix: assume that h is image height, w is image width, and then matrix [w 0 0 h 0 0] will produce an identical image. |
[in] | clip_rect | Clip rectangle for the rendering device. This can be null. |
[in] | interpolation | Bitmap interpolation flags. Please refer to values starting from FoxitPDFSDKPython2.Bitmap.e_Downsample and this can be one or a combination of these values. If not specify any flag, please use 0. |
[in] | pause | Pause callback object which decides if the rendering process needs to be paused. This can be null which means not to pause during the rendering process. If this is not null, it should be a valid pause object implemented by user. |
def FoxitPDFSDKPython2.Renderer.StartRenderReflowPage | ( | reflow_page, | |
matrix, | |||
pause | |||
) |
Start to render a reflow page.
It may take a long time to render a reflow page with complex or large contents, so Foxit PDF SDK uses a progressive process to do this.
[in] | reflow_page | A valid reflow page. It should have been parsed. |
[in] | matrix | The transformation matrix used for rendering, which is usually returned by function FoxitPDFSDKPython2.ReflowPage.GetDisplayMatrix . |
[in] | pause | Pause callback object which decides if the rendering process needs to be paused. This can be null which means not to pause during the rendering process. If this is not null, it should be a valid pause object implemented by user. |
def FoxitPDFSDKPython2.Renderer.StartRenderXFAPage | ( | xfa_page_view, | |
matrix, | |||
is_highlight, | |||
pause | |||
) |
Start to render an XFA page.
It will take a long time to render an XFA page with complex or large contents, so Foxit PDF SDK uses a progressive process to do this.
[in] | xfa_page_view | A valid XFA page. |
[in] | matrix | The transformation matrix used for rendering, which is usually returned by function FoxitPDFSDKPython2.XFAPage.GetDisplayMatrix . |
[in] | is_highlight | true means to highlight XFA widgets, and false means not to highlight XFA widgets. |
[in] | pause | Pause callback object which decides if the rendering process needs to be paused. This can be null which means not to pause during the rendering process. If this is not null, it should be a valid pause object implemented by user. |