summaryrefslogtreecommitdiff
path: root/fpdfsdk/include/fpdf_transformpage.h
blob: 32b0ea008c7510bd2272a75f75d187ba67ebb297 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
// Copyright 2014 PDFium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
 
// Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com

#ifndef _TRANSFORMPAGE_H_
#define _TRANSFORMPAGE_H_

#ifndef _FPDFVIEW_H_
#include "fpdfview.h"
#endif

typedef void* FPDF_PAGEARCSAVER;
typedef void* FPDF_PAGEARCLOADER;
/**
*  Set "MediaBox" entry to the page dictionary.						   
* @param[in] page	- Handle to a page.
* @param[in] left	- The left of the rectangle.
* @param[in] bottom	- The bottom of the rectangle.
* @param[in] right	- The right of the rectangle.
* @param[in] top	- The top of the rectangle.
* @retval None.
* @note The method can not support to set this feature for the document which consists of dynamic XFA fields.
*/
DLLEXPORT void STDCALL FPDFPage_SetMediaBox(FPDF_PAGE page, float left, float bottom, float right, float top);

/**
*  Set "CropBox" entry to the page dictionary.						   
* @param[in] page	- Handle to a page.
* @param[in] left	- The left of the rectangle.
* @param[in] bottom	- The bottom of the rectangle.
* @param[in] right	- The right of the rectangle.
* @param[in] top	- The top of the rectangle.
* @retval None.
* @note The method can not support to set this feature for the document which consists of dynamic XFA fields.
*/
DLLEXPORT void STDCALL FPDFPage_SetCropBox(FPDF_PAGE page, float left, float bottom, float right, float top);


/**  Get "MediaBox" entry from the page dictionary.						   
* @param[in] page	- Handle to a page.
* @param[in] left	- Pointer to a double value receiving the left of the rectangle.
* @param[in] bottom	- Pointer to a double value receiving the bottom of the rectangle.
* @param[in] right	- Pointer to a double value receiving the right of the rectangle.
* @param[in] top	- Pointer to a double value receiving the top of the rectangle.
* @retval True if success,else fail.
* @note The method can not support to get this feature for the document which consists of dynamic XFA fields.
*/
DLLEXPORT FPDF_BOOL STDCALL FPDFPage_GetMediaBox(FPDF_PAGE page, float* left, float* bottom, float* right, float* top);

/**  Get "CropBox" entry from the page dictionary.						   
* @param[in] page	- Handle to a page.
* @param[in] left	- Pointer to a double value receiving the left of the rectangle.
* @param[in] bottom	- Pointer to a double value receiving the bottom of the rectangle.
* @param[in] right	- Pointer to a double value receiving the right of the rectangle.
* @param[in] top	- Pointer to a double value receiving the top of the rectangle.
* @retval True if success,else fail.
* @note The method can not support to get this feature for the document which consists of dynamic XFA fields.
*/
DLLEXPORT FPDF_BOOL STDCALL FPDFPage_GetCropBox(FPDF_PAGE page, float* left, float* bottom, float* right, float* top);

/**
* Transform the whole page with a specified matrix, then clip the page content region.
*
* @param[in] page		 - A page handle.
* @param[in] matrix		 - The transform matrix.
* @param[in] clipRect	 - A rectangle page area to be clipped.
* @Note. This function will transform the whole page, and would take effect to all the objects in the page.
*		 The method can not support to get this feature for the document which consists of dynamic XFA fields.
*/
DLLEXPORT FPDF_BOOL STDCALL FPDFPage_TransFormWithClip(FPDF_PAGE page, FS_MATRIX* matrix, FS_RECTF* clipRect);

/**
* Transform (scale, rotate, shear, move) the clip path of page object.
* @param[in] page_object - Handle to a page object. Returned by FPDFPageObj_NewImageObj.
* @param[in] a	- The coefficient "a" of the matrix.
* @param[in] b	- The coefficient "b" of the matrix.
* @param[in] c	- The coefficient "c" of the matrix.
* @param[in] d	- The coefficient "d" of the matrix.
* @param[in] e	- The coefficient "e" of the matrix.
* @param[in] f	- The coefficient "f" of the matrix.
* @retval None.
*/
DLLEXPORT void STDCALL FPDFPageObj_TransformClipPath(FPDF_PAGEOBJECT page_object,double a, double b, double c, double d, double e, double f);

/**
* Create a new clip path, with a rectangle inserted.
* 
* @param[in] left	- The left of the clip box.
* @param[in] bottom - The bottom of the clip box.
* @param[in] right	- The right of the clip box.
* @param[in] top	- The top of the clip box.
* @retval a handle to the clip path.
*/
DLLEXPORT FPDF_CLIPPATH STDCALL FPDF_CreateClipPath(float left, float bottom, float right, float top);

/**
* Destroy the clip path.
*
* @param[in] clipPath - A handle to the clip path.
* Destroy the clip path.
* @retval None.
*/
DLLEXPORT void STDCALL FPDF_DestroyClipPath(FPDF_CLIPPATH clipPath);

/**
* Clip the page content, the page content that outside the clipping region become invisible.
*
* @param[in] page		 - A page handle.
* @param[in] clipPath	 - A handle to the clip path.
* @Note. A clip path will be inserted before the page content stream or content array. In this way, the page content will be clipped
* by this clip path. The method can not support this feature for the document consists of dynamic XFA fields.
*/
DLLEXPORT void STDCALL FPDFPage_InsertClipPath(FPDF_PAGE page,FPDF_CLIPPATH clipPath);

#endif