Definitions / Jargon

First, a couple "definitions" that specifically apply to how we use certain terms in this article - this is NOT an exhaustive dictionary.

Image

as used in this article, we mean an AtalaIamge object or more broadly a "RASTER" image which means an image object that is based on a "grid of pixels" as opposed to specific image formats (tiff, jpeg, etc)

PDF

as used in this article we're referring to a pdf but NOT as an image extracted or rasterized from a PDF

ImageSpace / Image Space / Image Coordinates

ImageSpace and these other terms will refer to how one navigates coordinates when working with an Image object

PdfSpace / PDF Space / PDF Coordinates

PdfSpace will refer to how one navigates coordinates when working with a PDF in one of our classes such as PdfDocument, PdfGeneratedDocument, PdfTextDocument, etc

Point

A system.Drawing.Point object which is expressing an X, Y coordinate in ImageSpace

In Image space, a Point is integer value as a single point identifies a single pixel there is no such thing as a partial pixel in ImageSpace

PdfPoint

A System.Drawing.PointF object which is expressing an X, Y coordinate in PdfSpace

Critically, a PdfPoint is 1/72 of an inch AND the PdfSpace coordinates are measured 0,0 is bottom left and as X increases you move right (same as ImageSpace) but eacn uniit is a 1/72 inch step, but as Y increases you go UP toward the TOP of the page (also segmented into 1/72 of an inch)

Concepts

Images from PdfDecoder

When you use our PdfDecoder to make an AtalaImage ... the PdfDecoder RASTERIZES the image .. converting whatever the 100% VIEW of a specific page is into a grid of pixels with the PdfDecoder.Resolution (default is 96 which is quite low) is set to. Once you have an AtalaImage, the fact that it came from PDF doesn't matter.. it's now an Image and is living in "ImageSpace"