zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizezoom_image_size (Operator)

Name

zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizezoom_image_size — Skalieren von Bildern auf eine vorgegebene Größe.

Signatur

zoom_image_size(Image : ImageZoom : Width, Height, Interpolation : )

Beschreibung

zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizezoom_image_size vergrößert das Bild ImageImageImageimageimage auf die durch WidthWidthWidthwidthwidth und HeightHeightHeightheightheight vorgegebene Größe. Der Parameter InterpolationInterpolationInterpolationinterpolationinterpolation gibt dabei die Art der verwendeten Interpolationsmethode an (siehe affine_trans_imageaffine_trans_imageAffineTransImageAffineTransImageaffine_trans_image). Die Domäne des Eingabebildes wird ignoriert, d.h. es wird die volle Domäne des Bildrechtecks angenommen.

Achtung

Falls der Systemparameter 'int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming" auf 'true'"true""true""true""true" gesetzt ist, kann die intern verwendete Integer-Arithmetik in den folgenden drei Fällen zu Fehlern führen: Zum einen kann das Ergebnisbild leicht fehlerhafte Grauwerte enthalten, wenn zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizezoom_image_size auf ein uint2 oder int2 Bild mit hohem Dynamikbereich (das heißt, Bilder mit Werten nahe an den Grenzen der entsprechenden Typen) angewendet wird und gleichzeitig Skalierungsfaktoren (Verhältnis von Ausgabe- zu Eingabebildgröße) kleiner als 0.5 verwendet werden. Zum zweiten können undefinierte Grauwerte am unteren und am rechten Bildrand entstehen, wenn für InterpolationInterpolationInterpolationinterpolationinterpolation ein anderer Wert als 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor" gewählt wird, ein großer Skalierungsfaktor angewendet wird und außerdem ein großes Ergebnisbild entsteht. Die maximale Breite dieses Randes mit undefinierten Grauwerten kann mit der Formel abgeschätzt werden, wobei S den Skalierungsfaktor in einer Dimension und I die Größe des Ausgabebildes in der entsprechenden Dimension darstellt. Zum dritten können undefinierte Grauwerte an allen Bildrändern entstehen, wenn für InterpolationInterpolationInterpolationinterpolationinterpolation 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor" gewählt wird, es sich um ein Real-Bild handelt, und wenn sowohl Eingabe- als auch Ergebnisbild groß sind. In allen Fällen wird empfohlen, den Systemparameter 'int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming" mittels set_systemset_systemSetSystemSetSystemset_system auf 'false'"false""false""false""false" zu setzen.

Wird 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor" als Interpolationsmethode gesetzt, können die Ergebnisse für verschiedene Bildtypen leicht voneinander abweichen. Grund dafür sind Bildtyp-spezifische Optimierungen des Interpolationsverfahrens.

zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizezoom_image_size wird nicht intern parallelisiert, wenn WidthWidthWidthwidthwidth und HeightHeightHeightheightheight den halben Dimensionen von ImageImageImageimageimage entsprechen. Außerdem erfolgt keine interne Parallelisierung für InterpolationInterpolationInterpolationinterpolationinterpolation='nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor".

zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizezoom_image_size kann auf OpenCL-Geräten ausgeführt werden, wenn das Eingangsbild die maximale Größe für Bildobjekte des ausgewählten Gerätes nicht überschreitet. Aus numerischen Gründen kann es dabei zu geringfügigen Abweichungen des Ergebnisses gegenüber der Ausführung auf der CPU kommen.

Ausführungsinformationen

Unterstützt OpenCL Compute Devices.
Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf Tupelebene.
Automatisch parallelisiert auf Kanalebene.
Automatisch parallelisiert auf interner Datenebene.

Parameter

ImageImageImageimageimage (input_object) (multichannel-)image(-array) → object (byte* / int2* / uint2* / real*) *erlaubt für Compute Devices

Eingabebild

ImageZoomImageZoomImageZoomimageZoomimage_zoom (output_object) (multichannel-)image(-array) → object (byte / int2 / uint2 / real)

Skaliertes Ausgabebild.

WidthWidthWidthwidthwidth (input_control) extent.x → (integer)

Breite des Zielbildes.

Default: 512

Wertevorschläge: 128, 256, 512

Wertebereich: 2 ≤ Width Width Width width width ≤ 512

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

HeightHeightHeightheightheight (input_control) extent.y → (integer)

Höhe des Zielbildes.

Default: 512

Wertevorschläge: 128, 256, 512

Wertebereich: 2 ≤ Height Height Height height height ≤ 512

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

InterpolationInterpolationInterpolationinterpolationinterpolation (input_control) string → (string)

Art der Interpolation.

Default: 'constant' "constant" "constant" "constant" "constant"

Werteliste: 'bicubic'"bicubic""bicubic""bicubic""bicubic", 'bilinear'"bilinear""bilinear""bilinear""bilinear", 'constant'"constant""constant""constant""constant", 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor", 'weighted'"weighted""weighted""weighted""weighted"

Beispiel (HDevelop)

read_image(Image,'monkey')
dev_display (Image)
zoom_image_size(Image,ZoomImage,200,200,'constant')
dev_display (ZoomImage)

Beispiel (C)

read_image(&Image,"monkey");
disp_image(Image,WindowHandle);
zoom_image_size(Image,&ZoomImage,200,200,"constant");
disp_image(ZoomImage,WindowHandle);

Beispiel (HDevelop)

read_image(Image,'monkey')
dev_display (Image)
zoom_image_size(Image,ZoomImage,200,200,'constant')
dev_display (ZoomImage)

Beispiel (HDevelop)

read_image(Image,'monkey')
dev_display (Image)
zoom_image_size(Image,ZoomImage,200,200,'constant')
dev_display (ZoomImage)

Alternativen

zoom_image_factorzoom_image_factorZoomImageFactorZoomImageFactorzoom_image_factor, affine_trans_imageaffine_trans_imageAffineTransImageAffineTransImageaffine_trans_image, hom_mat2d_scalehom_mat2d_scaleHomMat2dScaleHomMat2dScalehom_mat2d_scale

Siehe auch

hom_mat2d_scalehom_mat2d_scaleHomMat2dScaleHomMat2dScalehom_mat2d_scale, affine_trans_imageaffine_trans_imageAffineTransImageAffineTransImageaffine_trans_image

Modul

Foundation

Operatoren