blob: 253f6686d79d6ab08a2f93d45d40c4a9598852e2 [file] [log] [blame]
// 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 PUBLIC_FPDF_EDIT_H_
#define PUBLIC_FPDF_EDIT_H_
#include <stdint.h>
#include "fpdfview.h"
// Define all types used in the SDK. Note they can be simply regarded as opaque
// pointers
// or long integer numbers.
#define FPDF_ARGB(a, r, g, b) \
((((uint32_t)(((uint8_t)(b) | ((FX_WORD)((uint8_t)(g)) << 8)) | \
(((FX_DWORD)(uint8_t)(r)) << 16)))) | \
(((FX_DWORD)(uint8_t)(a)) << 24))
#define FPDF_GetBValue(argb) ((uint8_t)(argb))
#define FPDF_GetGValue(argb) ((uint8_t)(((uint16_t)(argb)) >> 8))
#define FPDF_GetRValue(argb) ((uint8_t)((argb) >> 16))
#define FPDF_GetAValue(argb) ((uint8_t)((argb) >> 24))
#ifdef __cplusplus
extern "C" {
#endif
//////////////////////////////////////////////////////////////////////
//
// Document functions
//
//////////////////////////////////////////////////////////////////////
// Function: FPDF_CreateNewDocument
// Create a new PDF document.
// Parameters:
// None.
// Return value:
// A handle to a document. If failed, NULL is returned.
//
DLLEXPORT FPDF_DOCUMENT STDCALL FPDF_CreateNewDocument();
//////////////////////////////////////////////////////////////////////
//
// Page functions
//
//////////////////////////////////////////////////////////////////////
// Function: FPDFPage_New
// Construct an empty page.
// Parameters:
// document - Handle to document. Returned by FPDF_LoadDocument
// and FPDF_CreateNewDocument.
// page_index - The index of a page.
// width - The page width.
// height - The page height.
// Return value:
// The handle to the page.
// Comments:
// Loaded page can be deleted by FPDFPage_Delete.
// Notes:
// The method can not support to create a new page for the document
// consists of dynamic XFA fields.
//
DLLEXPORT FPDF_PAGE STDCALL FPDFPage_New(FPDF_DOCUMENT document,
int page_index,
double width,
double height);
// Function: FPDFPage_Delete
// Delete a PDF page.
// Parameters:
// document - Handle to document. Returned by FPDF_LoadDocument
// and FPDF_CreateNewDocument.
// page_index - The index of a page.
// Return value:
// None.
// Notes:
// The method can not support to delete page for the document consists
// of dynamic XFA fields.
//
DLLEXPORT void STDCALL FPDFPage_Delete(FPDF_DOCUMENT document, int page_index);
// Function: FPDFPage_GetRotation
// Get the page rotation. One of following values will be returned:
// 0(0), 1(90), 2(180), 3(270).
// Parameters:
// page - Handle to a page. Returned by FPDFPage_New or
// FPDF_LoadPage.
// Return value:
// The PDF page rotation.
// Comment:
// The PDF page rotation is rotated clockwise.
// Notes:
// The method can not support to get the page rotate for the document
// consists of dynamic XFA fields.
//
DLLEXPORT int STDCALL FPDFPage_GetRotation(FPDF_PAGE page);
// Function: FPDFPage_SetRotation
// Set page rotation. One of following values will be set: 0(0), 1(90),
// 2(180), 3(270).
// Parameters:
// page - Handle to a page. Returned by FPDFPage_New or
// FPDF_LoadPage.
// rotate - The value of the PDF page rotation.
// Return value:
// None.
// Comment:
// The PDF page rotation is rotated clockwise.
// Notes:
// The method can not support to set this feature for the document
// consists of dynamic XFA fields.
//
DLLEXPORT void STDCALL FPDFPage_SetRotation(FPDF_PAGE page, int rotate);
// Function: FPDFPage_InsertObject
// Insert an object to the page. The page object is automatically
// freed.
// Parameters:
// page - Handle to a page. Returned by FPDFPage_New or
// FPDF_LoadPage.
// page_obj - Handle to a page object. Returned by
// FPDFPageObj_NewTextObj,FPDFPageObj_NewTextObjEx and
// FPDFPageObj_NewPathObj.
// Return value:
// None.
// Notes:
// The method can not support this feature for the document consists of
// dynamic XFA fields.
//
DLLEXPORT void STDCALL FPDFPage_InsertObject(FPDF_PAGE page,
FPDF_PAGEOBJECT page_obj);
// Function: FPDFPage_CountObject
// Get number of page objects inside the page.
// Parameters:
// page - Handle to a page. Returned by FPDFPage_New or
// FPDF_LoadPage.
// Return value:
// The number of the page object.
// Notes:
// The method can not support this feature for the document consists of
// dynamic XFA fields.
//
DLLEXPORT int STDCALL FPDFPage_CountObject(FPDF_PAGE page);
// Function: FPDFPage_GetObject
// Get page object by index.
// Parameters:
// page - Handle to a page. Returned by FPDFPage_New or
// FPDF_LoadPage.
// index - The index of a page object.
// Return value:
// The handle of the page object. Null for failed.
// Notes:
// The method can not support this feature for the document consists of
// dynamic XFA fields.
//
DLLEXPORT FPDF_PAGEOBJECT STDCALL FPDFPage_GetObject(FPDF_PAGE page, int index);
// Function: FPDFPage_HasTransparency
// Check that whether the content of specified PDF page contains
// transparency.
// Parameters:
// page - Handle to a page. Returned by FPDFPage_New or
// FPDF_LoadPage.
// Return value:
// TRUE means that the PDF page does contains transparency.
// Otherwise, returns FALSE.
// Notes:
// The method can not support this feature for the document consists of
// dynamic XFA fields.
//
DLLEXPORT FPDF_BOOL STDCALL FPDFPage_HasTransparency(FPDF_PAGE page);
// Function: FPDFPage_GenerateContent
// Generate PDF Page content.
// Parameters:
// page - Handle to a page. Returned by FPDFPage_New or
// FPDF_LoadPage.
// Return value:
// True if successful, false otherwise.
// Comment:
// Before you save the page to a file, or reload the page, you must
// call the FPDFPage_GenerateContent function.
// Or the changed information will be lost.
// Notes:
// The method can not support this feature for the document consists of
// dynamic XFA fields.
//
DLLEXPORT FPDF_BOOL STDCALL FPDFPage_GenerateContent(FPDF_PAGE page);
//////////////////////////////////////////////////////////////////////
//
// Page Object functions
//
//////////////////////////////////////////////////////////////////////
// Function: FPDFPageObj_HasTransparency
// Check that whether the specified PDF page object contains
// transparency.
// Parameters:
// pageObject - Handle to a page object.
// Return value:
// TRUE means that the PDF page object does contains transparency.
// Otherwise, returns FALSE.
DLLEXPORT FPDF_BOOL STDCALL
FPDFPageObj_HasTransparency(FPDF_PAGEOBJECT pageObject);
// Function: FPDFPageObj_Transform
// Transform (scale, rotate, shear, move) page object.
// Parameters:
// page_object - Handle to a page object. Returned by
// FPDFPageObj_NewImageObj.
// a - The coefficient "a" of the matrix.
// b - The coefficient "b" of the matrix.
// c - The coefficient "c" of the matrix.
// d - The coefficient "d" of the matrix.
// e - The coefficient "e" of the matrix.
// f - The coefficient "f" of the matrix.
// Return value:
// None.
DLLEXPORT void STDCALL FPDFPageObj_Transform(FPDF_PAGEOBJECT page_object,
double a,
double b,
double c,
double d,
double e,
double f);
// Function: FPDFPage_TransformAnnots
// Transform (scale, rotate, shear, move) all annots in a page.
// Parameters:
// page - Handle to a page.
// a - The coefficient "a" of the matrix.
// b - The coefficient "b" of the matrix.
// c - The coefficient "c" of the matrix.
// d - The coefficient "d" of the matrix.
// e - The coefficient "e" of the matrix.
// f - The coefficient "f" of the matrix.
// Return value:
// None.
// Notes:
// The method can not support this feature for the document consists of
// dynamic XFA fields.
DLLEXPORT void STDCALL FPDFPage_TransformAnnots(FPDF_PAGE page,
double a,
double b,
double c,
double d,
double e,
double f);
// The page object constants.
#define FPDF_PAGEOBJ_TEXT 1
#define FPDF_PAGEOBJ_PATH 2
#define FPDF_PAGEOBJ_IMAGE 3
#define FPDF_PAGEOBJ_SHADING 4
#define FPDF_PAGEOBJ_FORM 5
//////////////////////////////////////////////////////////////////////
//
// Image functions
//
//////////////////////////////////////////////////////////////////////
// Function: FPDFPageObj_NewImgeObj
// Create a new Image Object.
// Parameters:
// document - Handle to document. Returned by
// FPDF_LoadDocument or FPDF_CreateNewDocument function.
// Return Value:
// Handle of image object.
DLLEXPORT FPDF_PAGEOBJECT STDCALL
FPDFPageObj_NewImgeObj(FPDF_DOCUMENT document);
// Function: FPDFImageObj_LoadJpegFile
// Load Image from a JPEG image file and then set it to an image
// object.
// Parameters:
// pages - Pointers to the start of all loaded pages, could
// be NULL.
// nCount - Number of pages, could be 0.
// image_object - Handle of image object returned by
// FPDFPageObj_NewImgeObj.
// fileAccess - The custom file access handler, which specifies
// the JPEG image file.
// Return Value:
// TRUE if successful, FALSE otherwise.
// Note:
// The image object might already has an associated image, which is
// shared and cached by the loaded pages, In this case, we need to
// clear the cache of image for all the loaded pages.
// Pass pages and count to this API to clear the image cache.
// The method can not support this feature for the document consists of
// dynamic XFA fields.
//
DLLEXPORT FPDF_BOOL STDCALL
FPDFImageObj_LoadJpegFile(FPDF_PAGE* pages,
int nCount,
FPDF_PAGEOBJECT image_object,
FPDF_FILEACCESS* fileAccess);
// Function: FPDFImageObj_SetMatrix
// Set the matrix of an image object.
// Parameters:
// image_object - Handle of image object returned by
// FPDFPageObj_NewImgeObj.
// a - The coefficient "a" of the matrix.
// b - The coefficient "b" of the matrix.
// c - The coefficient "c" of the matrix.
// d - The coefficient "d" of the matrix.
// e - The coefficient "e" of the matrix.
// f - The coefficient "f" of the matrix.
// Return value:
// TRUE if successful, FALSE otherwise.
DLLEXPORT FPDF_BOOL STDCALL FPDFImageObj_SetMatrix(FPDF_PAGEOBJECT image_object,
double a,
double b,
double c,
double d,
double e,
double f);
// Function: FPDFImageObj_SetBitmap
// Set the bitmap to an image object.
// Parameters:
// pages - Pointer's to the start of all loaded pages.
// nCount - Number of pages.
// image_object - Handle of image object returned by
// FPDFPageObj_NewImgeObj.
// bitmap - The handle of the bitmap which you want to set
// it to the image object.
// Return value:
// TRUE if successful, FALSE otherwise.
// Notes;
// The method can not support this feature for the document consists of
// dynamic XFA fields.
//
DLLEXPORT FPDF_BOOL STDCALL FPDFImageObj_SetBitmap(FPDF_PAGE* pages,
int nCount,
FPDF_PAGEOBJECT image_object,
FPDF_BITMAP bitmap);
#ifdef __cplusplus
}
#endif
#endif // PUBLIC_FPDF_EDIT_H_