KlassenKlassenKlassenKlassen | | | | Operatoren

overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray (Operator)

Name

overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray — Überschreibt die Grauwerte eines Bildes.

Signatur

overpaint_gray(ImageDestination, ImageSource : : : )

Herror overpaint_gray(const Hobject ImageDestination, const Hobject ImageSource)

Herror T_overpaint_gray(const Hobject ImageDestination, const Hobject ImageSource)

Herror overpaint_gray(Hobject ImageDestination, Hobject ImageSource)

void HImage::OverpaintGray(const HImage& ImageSource) const

void OverpaintGray(const HObject& ImageDestination, const HObject& ImageSource)

void HImage::OverpaintGray(const HImage& ImageSource) const

void HOperatorSetX.OverpaintGray(
[in] IHUntypedObjectX* ImageDestination, [in] IHUntypedObjectX* ImageSource)

void HImageX.OverpaintGray([in] IHImageX* ImageSource)

static void HOperatorSet.OverpaintGray(HObject imageDestination, HObject imageSource)

void HImage.OverpaintGray(HImage imageSource)

Beschreibung

overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray zeichnet die Grauwerte des Bildes aus ImageSourceImageSourceImageSourceImageSourceImageSourceimageSource in das Bild in ImageDestinationImageDestinationImageDestinationImageDestinationImageDestinationimageDestination ein. Kopiert werden nur die Grauwerte aus dem Definitionsbereich von ImageSourceImageSourceImageSourceImageSourceImageSourceimageSource (siehe reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain).

Als Alternative zu overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray zeichnet der Operator paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray die Grauwerte nicht direkt in ImageDestinationImageDestinationImageDestinationImageDestinationImageDestinationimageDestination ein, sondern gibt das Ergebnis in einem neu erzeugten Bild zurück.

Achtung

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

Parallelisierung

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

Der Wert dieses Parameters darf nicht über mehrere Threads verwendet werden.

Parameter

ImageDestinationImageDestinationImageDestinationImageDestinationImageDestinationimageDestination (input_object, Zustand wird modifiziert)  (multichannel-)image objectHImageHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / vector_field)

Eingabebild, in das eingezeichnet werden soll.

ImageSourceImageSourceImageSourceImageSourceImageSourceimageSource (input_object)  (multichannel-)image objectHImageHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / vector_field)

Eingabebild, das die zusätzlichen Grauwerte liefert.

Beispiel (HDevelop)

* Copy a circular part of the image 'monkey' into a new image (New1):

read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
* New image with black (0) background
gen_image_proto(Image,New1,0.0)
* Copy a part of the image 'monkey' into New1
overpaint_gray(New1,Mask)

Beispiel (C)

/* Copy a circular part of the image 'monkey' into a new image (New1): */

read_image(&Image,"monkey");
gen_circle(&Circle,200.0,200.0,150.0);
reduce_domain(Image,Circle,&Mask);
/* New image with black (0) background */
gen_image_proto(Image,&New1,0.0);
/* Copy a part of the image 'monkey' into New1 */
overpaint_gray(New1,Mask);

Beispiel (HDevelop)

* Copy a circular part of the image 'monkey' into a new image (New1):

read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
* New image with black (0) background
gen_image_proto(Image,New1,0.0)
* Copy a part of the image 'monkey' into New1
overpaint_gray(New1,Mask)

Beispiel (HDevelop)

* Copy a circular part of the image 'monkey' into a new image (New1):

read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
* New image with black (0) background
gen_image_proto(Image,New1,0.0)
* Copy a part of the image 'monkey' into New1
overpaint_gray(New1,Mask)

Beispiel (HDevelop)

* Copy a circular part of the image 'monkey' into a new image (New1):

read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
* New image with black (0) background
gen_image_proto(Image,New1,0.0)
* Copy a part of the image 'monkey' into New1
overpaint_gray(New1,Mask)

Beispiel (HDevelop)

* Copy a circular part of the image 'monkey' into a new image (New1):

read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
* New image with black (0) background
gen_image_proto(Image,New1,0.0)
* Copy a part of the image 'monkey' into New1
overpaint_gray(New1,Mask)

Ergebnis

Sind die Parameterwerte korrekt, liefert overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_imageread_imageReadImageread_imageReadImageReadImage, gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst, gen_image_protogen_image_protoGenImageProtogen_image_protoGenImageProtoGenImageProto

Alternativen

get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1, paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray, set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval, copy_imagecopy_imageCopyImagecopy_imageCopyImageCopyImage

Siehe auch

paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion, overpaint_regionoverpaint_regionOverpaintRegionoverpaint_regionOverpaintRegionOverpaintRegion

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren