PDF SDK Documentation

Comprehensive Guide for Developers: Features, Integration, and API Reference

Loading...
Searching...
No Matches
stamper.h
Go to the documentation of this file.
1// Copyright (c) 2009-2026 Avanquest Software. All rights reserved.
2
3#ifndef PDFSDK_STAMPER_H_INCLUDED_
4#define PDFSDK_STAMPER_H_INCLUDED_
5
21
22#include <pdfsdk/core.h>
23#include <pdfsdk/graphics.h>
24
25#ifdef PDF_STAMPER_EXPORTS
26#define PDF_STAMPER_API PDFSDK_EXPORT_
27#else
28#define PDF_STAMPER_API PDFSDK_IMPORT_
29#endif
30
31#ifdef __cplusplus
32extern "C" {
33#endif
34
57
61typedef enum {
62 kPDFStampHAlignLeft = -1,
63 kPDFStampHAlignCenter = 0,
64 kPDFStampHAlignRight = 1
66
70typedef enum {
71 kPDFStampVAlignBottom = -1,
72 kPDFStampVAlignCenter = 0,
73 kPDFStampVAlignTop = 1
75
79typedef enum {
80 kPDFStampTextAlignLeft = -1,
81 kPDFStampTextAlignCenter = 0,
82 kPDFStampTextAlignRight = 1
84
89typedef struct PDFStamperRec_* PDFStamper;
90
99PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperCreate(PDFStampSizeMode sizeMode, float a, float b, PDFStamper* pStamper);
100
109PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetSize(PDFStamper stamper, PDFStampSizeMode sizeMode, float a, float b);
110
120PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetPosition(PDFStamper stamper, float horizontalDistance, float verticalDistance, bool usePercentage);
121
130PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetAlignment(PDFStamper stamper, PDFStampHAlign hAlign, PDFStampVAlign vAlign);
131
138PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetRotation(PDFStamper stamper, float degrees);
139
146PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetOpacity(PDFStamper stamper, float opacity);
147
156PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetAsBackground(PDFStamper stamper, bool background);
157
168PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetAsAnnotation(PDFStamper stamper, bool annotation);
169
176PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperShowsOnScreen(PDFStamper stamper, bool onScreen);
177
186PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperShowsOnPrint(PDFStamper stamper, bool onPrint);
187
197PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperShowsInLayersPanel(PDFStamper stamper, bool inLayersPanel);
198
208PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetName(PDFStamper stamper, const wchar_t* name);
209
218PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetFont(PDFStamper stamper, const PDFontInfo* fontInfo);
219
227PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetFontColor(PDFStamper stamper, PDColorValue color);
228
237PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetTextOutline(PDFStamper stamper, PDColorValue strokeColor, float strokeWidth);
238
245PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperSetTextAlignment(PDFStamper stamper, PDFStampTextAlign textAlign);
246
255PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperStampText(PDFStamper stamper, PDDoc destDoc, const wchar_t* text, const PDPageRange* destPages);
256
265PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperStampImage(PDFStamper stamper, PDDoc destDoc, GXBitmap bitmap, const PDPageRange* destPages);
266
275PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperStampImageFromFile(PDFStamper stamper, PDDoc destDoc, const wchar_t* imagePath, const PDPageRange* destPages);
276
286PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperStampPage(PDFStamper stamper, PDDoc destDoc, PDDoc srcDoc, size_t srcPageIndex, const PDPageRange* destPages);
287
296PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperHasStamps(PDDoc doc, const PDPageRange* pages, bool* pHasStamps);
297
305PDF_STAMPER_API PDErrCode PDFSDK_CALLCONV PDFStamperDeleteStamps(PDDoc doc, const PDPageRange* pages);
306
307#ifdef __cplusplus
308}
309#endif
310
311#endif // PDFSDK_STAMPER_H_INCLUDED_
int32_t PDErrCode
Definition errors.h:44
Graphics API.
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperStampImageFromFile(PDFStamper stamper, PDDoc destDoc, const wchar_t *imagePath, const PDPageRange *destPages)
Stamps a raster image loaded from a file onto the given pages.
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperHasStamps(PDDoc doc, const PDPageRange *pages, bool *pHasStamps)
Reports whether any of the given pages contains at least one stamp.
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperStampText(PDFStamper stamper, PDDoc destDoc, const wchar_t *text, const PDPageRange *destPages)
Stamps text onto the given pages using the configured font, color and text alignment.
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetOpacity(PDFStamper stamper, float opacity)
Sets the opacity of the stamp.
PDFStampVAlign
Vertical alignment of the stamp relative to the crop box.
Definition stamper.h:70
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetTextAlignment(PDFStamper stamper, PDFStampTextAlign textAlign)
Sets the alignment of multi-line text within a text stamp. Default is kPDFStampTextAlignLeft.
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperShowsOnPrint(PDFStamper stamper, bool onPrint)
Specifies whether the stamp is visible when the document is printed. Default is true.
struct PDFStamperRec_ * PDFStamper
The opaque handle to the PDFStamper object.
Definition stamper.h:89
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetAsAnnotation(PDFStamper stamper, bool annotation)
Specifies whether the stamp is added as a Stamp annotation instead of page content....
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetFont(PDFStamper stamper, const PDFontInfo *fontInfo)
Sets the font used for text stamps.
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetAlignment(PDFStamper stamper, PDFStampHAlign hAlign, PDFStampVAlign vAlign)
Sets the anchor that the position offset is measured from. Default is centered (kPDFStampHAlignCenter...
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetSize(PDFStamper stamper, PDFStampSizeMode sizeMode, float a, float b)
Sets how the stamp is sized. Overrides the value passed to PDFStamperCreate.
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetPosition(PDFStamper stamper, float horizontalDistance, float verticalDistance, bool usePercentage)
Sets the offset of the stamp from the alignment anchor. Default is no offset (0, 0).
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetTextOutline(PDFStamper stamper, PDColorValue strokeColor, float strokeWidth)
Gives text stamps an outline (stroke), in addition to or instead of the fill.
PDFStampTextAlign
Alignment of multi-line text within a text stamp.
Definition stamper.h:79
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperStampImage(PDFStamper stamper, PDDoc destDoc, GXBitmap bitmap, const PDPageRange *destPages)
Stamps a raster image from an in-memory bitmap onto the given pages.
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperShowsInLayersPanel(PDFStamper stamper, bool inLayersPanel)
Specifies whether the stamp's optional-content layer is registered in the document's layer order (/Or...
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperCreate(PDFStampSizeMode sizeMode, float a, float b, PDFStamper *pStamper)
Creates a new PDFStamper object with an initial size.
PDFStampSizeMode
Specifies how a stamp is sized.
Definition stamper.h:38
@ kPDFStampSizeRelative
Definition stamper.h:45
@ kPDFStampSizeFontSize
Definition stamper.h:55
@ kPDFStampSizeAbsolute
Definition stamper.h:51
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetName(PDFStamper stamper, const wchar_t *name)
Sets the stamp name. Default is "Stamp".
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetFontColor(PDFStamper stamper, PDColorValue color)
Sets the color used for text stamps.
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetAsBackground(PDFStamper stamper, bool background)
Specifies whether the stamp is placed behind the page content (background) or on top (foreground)....
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperSetRotation(PDFStamper stamper, float degrees)
Sets the rotation of the stamp, in degrees, counter-clockwise. Default is 0 (no rotation).
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperStampPage(PDFStamper stamper, PDDoc destDoc, PDDoc srcDoc, size_t srcPageIndex, const PDPageRange *destPages)
Stamps a single page from a source PDF document (as vector art) onto the given pages.
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperDeleteStamps(PDDoc doc, const PDPageRange *pages)
Deletes all stamps from the given pages.
PDFStampHAlign
Horizontal alignment of the stamp relative to the crop box.
Definition stamper.h:61
PDFSDK_IMPORT_ PDErrCode PDFSDK_CALLCONV PDFStamperShowsOnScreen(PDFStamper stamper, bool onScreen)
Specifies whether the stamp is visible on screen. Default is true.
Specifies the font information.
Definition fonts.h:36
Specifies a structure to define a set of pages.
Definition document.h:44