IWICBitmap::SetResolution-Methode (wincodec.h)

Artikel
03/03/2024

Ä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

Freigeben über