tile_channelstile_channelsTileChannelstile_channelsTileChannelsTileChannels (Operator)

Name

tile_channelstile_channelsTileChannelstile_channelsTileChannelsTileChannels — Zusammenfügen von mehreren Bildern zu einem großen Bild.

Signatur

tile_channels(Image : TiledImage : NumColumns, TileOrder : )

tile_channelstile_channelsTileChannelstile_channelsTileChannelsTileChannels fügt ein aus mehreren Kanälen bestehendes Bild durch Kachelung zu einem großen einkanaligen Bild zusammen. Das Eingabebild ImageImageImageImageImageimage besteht aus Num Bildern gleicher Größe, die in den einzelnen Kanälen gespeichert werden. Das Ausgabebild TiledImageTiledImageTiledImageTiledImageTiledImagetiledImage besteht aus einem einzigen Kanal, in dem die Num Eingabekanäle in NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns Spalten gekachelt worden sind. Insbesondere kann tile_channelstile_channelsTileChannelstile_channelsTileChannelsTileChannels also keine Farbbilder zusammenfügen. Hierzu kann tile_imagestile_imagesTileImagestile_imagesTileImagesTileImages verwendet werden. Der Parameter TileOrderTileOrderTileOrderTileOrderTileOrdertileOrder legt die Richtung fest, in der die Eingabekanäle in die Ausgabe kopiert werden, falls dies nicht schon durch NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns festgelegt wird (d.h., falls NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns != 1 und NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns != Num). Falls TileOrderTileOrderTileOrderTileOrderTileOrdertileOrder = 'horizontal'"horizontal""horizontal""horizontal""horizontal""horizontal", werden die Bilder in horizontaler Richtung kopiert, d.h. der zweite Kanal des Eingabebildes liegt rechts neben dem ersten Kanal. Falls TileOrderTileOrderTileOrderTileOrderTileOrdertileOrder = 'vertical'"vertical""vertical""vertical""vertical""vertical", werden die Bilder in vertikaler Richtung kopiert, d.h. der zweite Kanal des Eingabebildes liegt unter dem ersten Kanal. Der Definitionsbereich (die Region) des Ausgabebildes TiledImageTiledImageTiledImageTiledImageTiledImagetiledImage wird berechnet, indem die Region des Eingabebildes ImageImageImageImageImageimage an die entsprechenden Stellen im Ausgabebild kopiert wird. Falls Num kein Vielfaches von NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns ist, hat das Ausgabebild undefinierte Grauwerte in der unteren linken Ecke des Bildes. Die Ausgaberegion ist entsprechend gesetzt.

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf Tupelebene.

Parameter

ImageImageImageImageImageimage (input_object) (multichannel-)image(-array) → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real)

Eingabebild.

TiledImageTiledImageTiledImageTiledImageTiledImagetiledImage (output_object) singlechannelimage(-array) → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real)

Gekacheltes Ausgabegild.

NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns (input_control) integer → (integer)

Anzahl der Spalten, die für das Ausgabebild verwendet werden

Defaultwert: 1

Wertevorschläge: 1, 2, 3, 4, 5, 6, 7

Restriktion: NumColumns >= 1

TileOrderTileOrderTileOrderTileOrderTileOrdertileOrder (input_control) string → (string)

Reihenfolge der Eingabebilder im Ausgabebild.

Defaultwert: 'vertical' "vertical" "vertical" "vertical" "vertical" "vertical"

Werteliste: 'horizontal'"horizontal""horizontal""horizontal""horizontal""horizontal", 'vertical'"vertical""vertical""vertical""vertical""vertical"

Beispiel (HDevelop)

* Grab 5 single-channel images and stack them vertically.
gen_rectangle1 (Image, 0, 0, Height-1, Width-1)
for I := 1 to 5 by 1
    grab_image_async (ImageGrabbed, AcqHandle, -1)
    append_channel (Image, ImageGrabbed, Image)
endfor
tile_channels (Image, TiledImage, 1, 'vertical')

Ergebnis

Sind die Parameterwerte korrekt und tritt kein Fehler während der Berechnung auf, liefert tile_channelstile_channelsTileChannelstile_channelsTileChannelsTileChannels den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

append_channelappend_channelAppendChannelappend_channelAppendChannelAppendChannel

Alternativen

tile_imagestile_imagesTileImagestile_imagesTileImagesTileImages, tile_images_offsettile_images_offsetTileImagesOffsettile_images_offsetTileImagesOffsetTileImagesOffset

Siehe auch

change_formatchange_formatChangeFormatchange_formatChangeFormatChangeFormat, crop_partcrop_partCropPartcrop_partCropPartCropPart, crop_rectangle1crop_rectangle1CropRectangle1crop_rectangle1CropRectangle1CropRectangle1

Modul

Foundation

Operatoren