PeachDrawing.PDF Namespace

Classes  
ColorOptions Print color-management options, set via ColorOptions.
PdfAnnotationAppearance Draws the appearance of the standard annotations - icons, text markup, outlined shapes, free text and stamps - so a caller needs no drawing code of its own, and so the annotation carries the appearance stream a PDF/A document requires of every annotation. Each method returns a callback to give as PaintAppearance; the callback draws in points, from the top-left corner of the annotation’s ContentSize, so leave PixelsPerPoint at 1.
PdfAnnotationBuilder Adds annotations that are not links or form fields (highlights, notes, stamps, drawings) to the pages of a document, each with the appearance it is given, so a reader shows it as drawn.
PdfAnnotationDefinition An annotation to put on a page that is neither a link nor a form field: a highlight, a note, a stamp, a drawing. It says what kind of annotation it is, where it sits, what it holds, and how it looks.
PdfBookmark One entry of a document outline (the bookmarks sidebar of a reader), added with AddBookmarks(IEnumerable<PdfBookmark>).
PdfCanvas A Canvas that draws onto a PDF page. Get one from PdfComposerPage, or - for measuring text and layout without drawing anything - from CreateMeasuring(PdfRenderContext, double, double).
PdfComposer Writes a PDF file: add pages, draw on each one through a PdfCanvas, then Save(Stream).
PdfComposerOptions What a PdfComposer writes into the file besides the pages: the document information, the PDF version and conformance level, color management, encryption, embedded files and how streams and images are compressed.
PdfComposerPage One page of a PdfComposer: the canvas to draw it with, and the links that make parts of it clickable.
PdfDisclosureDefinition A region of a page that a reader can open and close: while closed the page shows only what was drawn on the page itself (a heading the reader clicks), and once opened a drawn rectangle covers that heading and what lies beneath it. Nothing reflows: the opened content is laid over the page.
PdfEmbeddedFile A file to embed in the PDF, added through EmbeddedFiles. The file shows up in a viewer’s attachments panel and is indexed in the document catalog’s /AF (Associated Files) array and /Names /EmbeddedFiles name tree.
PdfEncryptionOptions Password protection and permissions for a generated PDF, written with the PDF standard security handler using AES-256 (revision 6 of ISO 32000-2). Older handlers (RC4, AES-128) depend on deprecated algorithms and are not offered.
PdfFacturXInfo Marks the document as a Factur-X / ZUGFeRD e-invoice in its XMP metadata: which of the embedded files is the invoice XML, and the conformance level of the profile it follows. Set through FacturX.
PdfFileAttachment A file to attach to a PDF with AddAttachment(PdfFileAttachment).
PdfFormBuilder Adds interactive form fields (AcroForm text fields, check boxes, radio buttons and drop-downs) to the pages of a document.
PdfFormFieldDefinition An interactive form field to put on a page: what it is, where it is, and how it looks.
PdfLayerConfiguration Which pages of one PDF are drawn over (or under) which pages of another, for OverlayFile(PdfLayerConfiguration) and UnderlayFile(PdfLayerConfiguration).
PdfLink A link on a page, returned when it is added so it can be tied to the structure element of the content it covers.
PdfOperation Works on PDF files that already exist: take some of their pages, merge several into one, lay one over another, attach files, extend the metadata and protect or unprotect the result. Steps are chained and nothing is written until Save(string).
PdfPageSelector Reads the text a caller uses to pick pages of a document: "1,3,5-10", "r3-r1" (the last three), "z-1" (all, reversed), "1-20:even", "1-10,x3-4" (all but 3 and 4).
PdfPageSource An existing PDF opened so its pages can be painted onto any Canvas: a PdfCanvas to stamp a page of it over or under a document being written, a raster canvas to render it.
PdfPasswordException A PDF could not be opened because it needs a password that was not given, or the one given does not open it.
PdfRenderContext The RenderContext a PdfCanvas draws with: the fonts (installed ones, plus every font added), images decoded for embedding, and the scale between layout units and PDF points. A host adds what is specific to it - HTML and CSS font-family aliases, font-variation-settings parsing, resource loading - by deriving from it.
PdfSourceConformance The PDF/A and PDF/X levels an opened PDF claims for itself; None for one it does not.
PdfSourceDestination A place in an opened PDF that a link or an outline entry leads to.
PdfSourceLink A link on a page of an opened PDF: a rectangle that opens a web address or leads to another place in the file.
PdfSourceMetadata The document information of an opened PDF; a field the file does not give is null.
PdfSourceOutputIntent The output intent of an opened PDF: the print or display condition its colors are meant for, with the ICC profile that describes it.
PdfStructureAttributes A set of attributes of one owner (Table, List, Layout...) on a structure element.
PdfStructureAttributeValue One value of a structure attribute (ISO 32000-1 14.8.5): a name, text, a number, a flag, or a list of those.
PdfStructureDetails What a structure element can carry besides its type and content: its language, its actual text, a title and attributes.
PdfTagRecorder Records the logical structure of a document - headings, paragraphs, lists, figures, links - while its pages are drawn, so the file is a tagged PDF: a reader can navigate it by structure, and assistive technology can read it in order.
PdfTagSession The tagging of one drawing of a page of an opened PDF onto a document being tagged: it ties the structure elements recorded for that drawing together, so the page’s links can be tied to them afterwards. Made by CreateTagSession(PdfTagRecorder).
Structs  
PdfFormOption One choice of a Select field.
Interfaces  
IPdfFormAppearance How a form field looks, drawn by whoever knows what it should look like: the writer asks for each state it needs once, and draws it into an appearance stream of its own at PixelsPerPoint.
Enums  
ColorBlackGeneration How to represent an achromatic (gray/black) RGB-authored color as CMYK - see BlackGeneration.
ColorConversionMode How document colors should be converted for output - see ConversionMode. Every non-PreserveAsAuthored mode requires the relevant destination ICC profile property to be set (and parseable) - the composer validates this when the options are applied rather than discovering it deep in painting.
ColorRenderingIntent An ICC rendering intent (ICC.1:2010 §7.2.15) - see RenderingIntent.
ImageCompression How an opaque, lossless raster source is embedded, set via ImageCompression. PNG, BMP, and GIF always qualify (none of the three has a lossy encoding mode at all). WebP, AVIF, and TIFF each support both a lossy and a lossless encoding mode, so a source in one of those formats only qualifies when it was actually encoded losslessly - a lossy-encoded WebP/AVIF/TIFF is unaffected by this setting in every mode and stays on the same JPEG-re-encode path it always used.
PdfAConformance The PDF/A (ISO 19005) conformance level to target, set via Conformance. Defaults to None - no PDF/A -specific work is done: no /OutputIntents, no forced XMP metadata, no PDF-version bump, no PDF/A-1 transparency rejection, and no accessible-level language/alt-text requirements.
PdfAnnotationIcon A standard icon of a note or attached-file annotation. Each member names one of the icons a PDF reader knows by name and is what Icon(PdfAnnotationIcon, Size, Nullable<PaintColor>) draws, so the annotation looks the same whichever reader opens it.
PdfAnnotationPaint Which of a page’s annotations Paint(int, Canvas, PdfAnnotationPaint, PdfTagSession) draws, over its content.
PdfCopyMode How a PdfOperation carries the pages of existing files into the output.
PdfEmbeddedFileRelationship How an embedded file (PdfEmbeddedFile) relates to the PDF document it is embedded in - the PDF /AFRelationship entry (ISO 19005-3, ISO 32000-2 §14.13).
PdfFormFieldKind The kinds of interactive form field a PdfFormBuilder makes.
PdfPermissions The operations a PDF reader may allow a person who opened an encrypted document with its <em>user</em> password. A person who opens it with the <em>owner</em> password is never restricted. A reader enforces these voluntarily: they are a request made of well-behaved software, not a cryptographic barrier, because anyone who can open the document can read its content.
PdfUAConformance The PDF/UA (ISO 14289, “universal accessibility”) conformance level to target, set via UAConformance. Defaults to None: no PDF/UA claim is made.
PdfVersion The PDF version to target for the generated document’s file header (the “%PDF-x.y” marker) and any version-gated features written into it.
PdfXConformance The PDF/X (ISO 15930) conformance level to target, set via XConformance. Defaults to None - no PDF/X-specific work is done. PDF/X is a print-production conformance family (distinct from - and mutually exclusive with - PdfAConformance’s archival family): every non-None level requires an /OutputIntents ICC profile (OutputIntentProfile on ColorOptions - unlike PDF/A, the writer bundles no default profile for this, since there is no single correct press profile to assume).