Method function IGDIPlus.IGPMetafile.SetDownLevelRasterizationLimit(Cardinal) : TGPMetafile

From Mitov Wiki Doc
Revision as of 17:19, 18 October 2012 by David Alm (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This is a Beta Read Only version of this page. Please review and send recommendations to mitov@mitov.com. We will enable the editing as soon as we are happy with the overall Wiki site.

Class: IGPMetafile

Contents

Syntax

Delphi:

function SetDownLevelRasterizationLimit( metafileRasterizationLimitDpi : Cardinal ) : TGPMetafile;

C++ Builder:

TGPMetafile __fastcall SetDownLevelRasterizationLimit( unsigned int metafileRasterizationLimitDpi );

Visual C++ (MFC):

SetDownLevelRasterizationLimit(  metafileRasterizationLimitDpi );

Summary

Sets the resolution for certain brush bitmaps that are stored in this metafile.

Description

Call this method to set the resolution for certain brush bitmaps that are stored in this metafile. Remarks The purpose of this method is to prevent metafiles from becoming too large as a result of texture and gradient brushes being stored at high resolution. Suppose you construct a Metafile object (for recording an EmfTypeEmfOnly metafile) based on the device context of a printer that has a resolution of 600 dpi. Also suppose you create a path gradient brush or a texture brush based on a Bitmap object that has a resolution of 96 dpi. If the bitmap that represents that brush is stored in the metafile with a resolution of 96 dpi, it will require much less space than if it is stored with a resolution of 600 dpi.


The default rasterization limit for metafiles is 96 dpi. So if you do not call this method at all, path gradient brush and texture brush bitmaps are stored with a resolution of 96 dpi.


The rasterization limit has an effect on metafiles of type EmfTypeEmfOnly and EmfTypeEmfPlusDual, but it has no effect on metafiles of type EmfTypeEmfPlusOnly.

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox