Metodo Metafile::SetDownLevelRasterizationLimit (gdiplusheaders.h)

Articolo
08/24/2023

Imposta la risoluzione per determinate bitmap di pennello archiviate in questo metafile.

Sintassi

Status SetDownLevelRasterizationLimit(
  [in] UINT metafileRasterizationLimitDpi
);

Parametri

[in] metafileRasterizationLimitDpi

Tipo: UINT

Intero non negativo che specifica la risoluzione in dpi. Se si imposta questo parametro uguale a 0, la risoluzione è impostata sulla corrispondenza della risoluzione dell'handle di contesto del dispositivo passato al costruttore Metafile . Se si imposta questo parametro su un valore maggiore di 0 ma minore di 10, la risoluzione viene lasciata invariata.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce OK, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Lo scopo di questo metodo è impedire che i metafile diventino troppo grandi a causa di pennelli di trama e sfumatura archiviati ad alta risoluzione. Si supponga di costruire un oggetto Metafile (per registrare un metafile EmfTypeEmfOnly ) in base al contesto del dispositivo di una stampante con una risoluzione di 600 dpi. Si supponga anche di creare un pennello sfumatura di percorso o un pennello di trama basato su un oggetto Bitmap con una risoluzione di 96 dpi. Se la bitmap che rappresenta tale pennello viene archiviata nel metafile con una risoluzione di 96 dpi, richiederà molto meno spazio rispetto a se è archiviata con una risoluzione di 600 dpi.

Il limite di rasterizzazione predefinito per i metafile è 96 dpi. Quindi, se non si chiama questo metodo, le bitmap del pennello sfumatura del percorso e del pennello di trama vengono archiviate con una risoluzione di 96 dpi.

Il limite di rasterizzazione ha un effetto sui metafile di tipo EmfTypeEmfOnly e EmfTypeEmfPlusDual, ma non ha alcun effetto sui metafile di tipo EmfTypeEmfPlusOnly.

Esempio

Nell'esempio seguente viene costruito un oggetto Metafile in base al contesto del dispositivo di una stampante. Il codice crea un pennello di trama basato su un file BMP e quindi registra un'ellisse riempita con quel pennello. Si supponga che la stampante abbia una risoluzione di 600 dpi e che l'oggetto Bitmap abbia una risoluzione di 96 dpi.


// Get a device context for a printer.
HDC hdcPrint = CreateDC(NULL, TEXT("\\\\printserver\\printer1"), NULL, NULL); 

// Construct a Metafile object (for recording) based on a 600-DPI printer.
Metafile metafile(L"Metafile.emf", hdcPrint, EmfTypeEmfOnly);
{     
   // Create a texture brush based on a 96-DPI bitmap. 
   Bitmap bitmap(L"Texture.bmp");
   TextureBrush textureBrush(&bitmap);

   // Set the rasterization limit of the metafile to match the DPI of the
   // printer DC, in this case 600. When the bitmap for the texture brush
   // is stored in the metafile, the bitmap will be expanded by a factor of
   // about 6 horizontally and vertically. That will increase the size of 
   // the bitmap by a factor of about 36.
   metafile.SetDownLevelRasterizationLimit(0);

   // Record an ellipse filled with the texture brush.
   Graphics graphics(&metafile);  
   graphics.FillEllipse(&textureBrush, 10, 10, 40, 40);
}

// The preceding code, along with a particular 24 x 23 bitmap,
// produced a 114 kilobyte metafile. Passing 96, instead of 0, to the 
// SetDownLevelRasterizationLimit method produced a 3.5 kilobyte metafile.

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusheaders.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll