overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionoverpaint_region (Operator)

Name

overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionoverpaint_region — Zeichnet Regionen in ein Bild ein.

Signatur

Beschreibung

overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegionoverpaint_region zeichnet die Regionen aus RegionRegionRegionRegionregionregion in das Bild ImageImageImageImageimageimage mit den vorgegebenen Grauwerten GrayvalGrayvalGrayvalGrayvalgrayvalgrayval ein. Die Grauwerte können entweder einmal für jeden Bildkanal, geltend für alle Regionen, definiert werden, oder für jede Region und jeden Bildkanal einzeln. Um Letzteres zu definieren, werden die Kanal-Grauwerte g zu jeder Region gruppiert und zu einem Tupel entsprechend der Reihenfolge der Regionen verknüpft, z.B. für ein dreikanaliges Bild: [g(channel1,region1), g(channel2,region1), g(channel3,region1), g(channel1,region2), ... ]. Ist das Bild vom Typ direction, werden Grauwerte, die nicht innerhalb des für direction-Bilder erlaubten Wertebereichs liegen, auf den Wert 255 gesetzt, um sie als ungültig zu kennzeichnen. Der Parameter TypeTypeTypeTypetypetype gibt an, ob die Regionen ausgefüllt ('fill'"fill""fill""fill""fill""fill") oder nur der Rand ('margin'"margin""margin""margin""margin""margin") eingetragen werden soll.

Als Alternative zu overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegionoverpaint_region zeichnet der Operator paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region die Regionen nicht direkt in ImageImageImageImageimageimage ein, sondern gibt das Ergebnis in einem neu erzeugten Bild zurück.

Achtung

overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegionoverpaint_region verändert den Inhalt eines bereits bestehenden Bildes (ImageImageImageImageimageimage). Zudem können aber auch andere Bildobjekte betroffen sein: Wenn man z.B. ImageImageImageImageimageimage mit Hilfe von copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj aus einem anderen Bildobjekt erzeugt hat (oder umgekehrt), wird auch dessen Bildmatrix überschrieben. Deshalb sollte overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegionoverpaint_region nur zum Einzeichnen in neu erzeugte Bildobjekte verwendet werden. Typische Operatoren hierfür sind z.B. gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const (erzeugt ein neues Bild mit angegebener Größe), gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto (erzeugt ein Bild mit der Größe eines angegebenen Prototyp-Bildes) oder copy_imagecopy_imageCopyImageCopyImageCopyImagecopy_image (erzeugt ein Bild als Kopie eines angegebenen Bildes).

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

• ImageImageImageImageimageimage

Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.

Parameter

* Paint a rectangle into a new image (New1)

gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* generate a black image
gen_image_const(New1,'byte', 768, 576)
* paint a white rectangle
overpaint_region(New1,Rectangle,255.0,'fill')

/* Paint a rectangle into a new image (New1) */

gen_rectangle1(&Rectangle,100.0,100.0,300.0,300.0);
/* generate a black image */
gen_image_const(&New1,"byte", 768, 576)
/* paint a white rectangle */
overpaint_region(New1,Rectangle,255.0,"fill");

* Paint a rectangle into a new image (New1)

gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* generate a black image
gen_image_const(New1,'byte', 768, 576)
* paint a white rectangle
overpaint_region(New1,Rectangle,255.0,'fill')

* Paint a rectangle into a new image (New1)

gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* generate a black image
gen_image_const(New1,'byte', 768, 576)
* paint a white rectangle
overpaint_region(New1,Rectangle,255.0,'fill')

* Paint a rectangle into a new image (New1)

gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* generate a black image
gen_image_const(New1,'byte', 768, 576)
* paint a white rectangle
overpaint_region(New1,Rectangle,255.0,'fill')

Ergebnis

Sind die Parameterwerte korrekt, dann liefert overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegionoverpaint_region den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingaberegionen vorhanden) lässt sich mittels set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_imageread_imageReadImageReadImageReadImageread_image, gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const, gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain

Alternativen

set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval, paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region, paint_xldpaint_xldPaintXldPaintXldPaintXldpaint_xld

Siehe auch

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, set_drawset_drawSetDrawSetDrawSetDrawset_draw, paint_graypaint_grayPaintGrayPaintGrayPaintGraypaint_gray, overpaint_grayoverpaint_grayOverpaintGrayOverpaintGrayOverpaintGrayoverpaint_gray, gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const

Modul

Foundation