IWICBitmap::SetResolution-Methode (wincodec.h)

  • Artikel

Ändert die physische Auflösung des Bilds.

Syntax

HRESULT SetResolution(
  [in] double dpiX,
  [in] double dpiY
);

Parameter

[in] dpiX

Typ: double

Die horizontale Auflösung.

[in] dpiY

Typ: double

Die vertikale Auflösung.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode hat keine Auswirkungen auf die tatsächlichen Pixel oder Beispiele, die in der Bitmap gespeichert sind. Stattdessen wird die Interpretation der Samplingrate geändert. Dies bedeutet, dass ein 96-DPI-Bild, das 96 Pixel breit ist, einen Zoll beträgt. Wenn die physische Auflösung auf 48 DPI geändert wird, wird die Bitmap als 2 Zoll breit angesehen, hat aber die gleiche Anzahl von Pixeln.
Wenn die Auflösung kleiner als REAL_EPSILON (1.192092896e-07F) ist, wird der Fehlercode WINCODEC_ERR_INVALIDPARAMETER zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP2, Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincodec.h
Bibliothek Windowscodecs.lib
DLL Windowscodecs.dll