Defines the target DotsPerInch in the horizontal direction. Used within FixedFonts font sizing logic and image export logic. Needed in some instances to achieve consistent or alternative font sizes between multiple printed or exported images. DpiX and DpiY is applied in the following instances when FixedFonts = True:
1) When exporting a metafile (sized in 1/100th millimeters or 1/2540 inches), and ExportImageDpi=0 (denoting no embedded DPI information), DpiX and DpiY will control the resolution (width and height in pixels) of the metafile created along with controlling font sizing logic. If ExportImageDpi=0 and DpiX=0 and DpiY=0, ProEssentials defaults to 1000 DPI and temporarily sets FixedFonts = False while performing export.
2) When exporting a PNG/JPG, and ExportImageDpi=0 (denoting no embedded DPI/size information), DpiX and DpiY will control font sizing logic.
3) When using built-in print dialog or functions PEprintgraph/PEprintgraphEX, and PrintDpi=0, setting DpiX and DpiY forces the use of an alternate DPI versus the actual printer's DPI values.
4) Low-level printing a chart by preparing a metafile to be played to a printer DC. In this case, set DpiX and DpiY to the printer's DpiX and DpiY values prior to calling PEresetimageEx.
Note, when FixedFonts = True, and using built-in print dialog or PEprintgraph/PEprintgraphEx function, ProEssentials will automatically set internal DpiX and DpiY variables to the target printer's DPI settings when PrintDpi=0.
PeFunction.Image.DpiX members of Pego.PeFunction.Image, Pesgo.PeFunction.Image, Pe3do.PeFunction.Image, Pepso.PeFunction.Image, Pepco.PeFunction.Image
See Also: DpiY, PrintDpi, ExportImageDpi, HidePrintDpi, HideExportImageDpi
©2022 Gigasoft, Inc. | All rights reserved.
Gigasoft is a registered trademark, and ProEssentials a trademark of Gigasoft, Inc.