zoom_image_factorzoom_image_factorZoomImageFactorZoomImageFactorzoom_image_factor (Operator)

Name

zoom_image_factorzoom_image_factorZoomImageFactorZoomImageFactorzoom_image_factor — Skalieren von Bildern um einen Vergrößerungsfaktor.

Signatur

zoom_image_factor(Image : ImageZoomed : ScaleWidth, ScaleHeight, Interpolation : )

Beschreibung

zoom_image_factorzoom_image_factorZoomImageFactorZoomImageFactorzoom_image_factor vergrößert das Bild ImageImageImageimageimage um einen Faktor ScaleWidthScaleWidthScaleWidthscaleWidthscale_width in der Breite und einen Faktor ScaleHeightScaleHeightScaleHeightscaleHeightscale_height in der Höhe. 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_factorzoom_image_factorZoomImageFactorZoomImageFactorzoom_image_factor 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 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_factorzoom_image_factorZoomImageFactorZoomImageFactorzoom_image_factor wird für ScaleWidthScaleWidthScaleWidthscaleWidthscale_width = 0.5 und ScaleHeightScaleHeightScaleHeightscaleHeightscale_height = 0.5 nicht intern parallelisiert. Außerdem erfolgt keine interne Parallelisierung für InterpolationInterpolationInterpolationinterpolationinterpolation='nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor".

zoom_image_factorzoom_image_factorZoomImageFactorZoomImageFactorzoom_image_factor 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.

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

Skaliertes Ausgabebild.

ScaleWidthScaleWidthScaleWidthscaleWidthscale_width (input_control) extent.x → (real)

Faktor für Breite des Zielbildes.

Default: 0.5

Wertevorschläge: 0.25, 0.5, 1.5, 2.0

Wertebereich: 0.001 ≤ ScaleWidth ScaleWidth ScaleWidth scaleWidth scale_width ≤ 10.0

Minimale Schrittweite: 0.001

Empfohlene Schrittweite: 0.1

ScaleHeightScaleHeightScaleHeightscaleHeightscale_height (input_control) extent.y → (real)

Faktor für Höhe des Zielbildes.

Default: 0.5

Wertevorschläge: 0.25, 0.5, 1.5, 2.0

Wertebereich: 0.001 ≤ ScaleHeight ScaleHeight ScaleHeight scaleHeight scale_height ≤ 10.0

Minimale Schrittweite: 0.001

Empfohlene Schrittweite: 0.1

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_factor (Image, ZoomImage, 0.25, 0.25, 'constant')
dev_display (ZoomImage)

Beispiel (C)

read_image(&Image,"monkey");
disp_image(Image,WindowHandle);
zoom_image_factor(Image,&ZooImage,0.25,0.25,"constant");
disp_image(ZooImage,WindowHandle);

Beispiel (HDevelop)

read_image(Image,'monkey')
dev_display (Image)
zoom_image_factor (Image, ZoomImage, 0.25, 0.25, 'constant')
dev_display (ZoomImage)

Beispiel (HDevelop)

read_image(Image,'monkey')
dev_display (Image)
zoom_image_factor (Image, ZoomImage, 0.25, 0.25, 'constant')
dev_display (ZoomImage)

Alternativen

zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizezoom_image_size, 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