HALCON Reference Manual 10.0.2
Table of Contents / Image / Domain ClassesClassesClasses | | | Operators

change_domainchange_domainchange_domainChangeDomainChangeDomain (Operator)

Name

change_domainchange_domainchange_domainChangeDomainChangeDomain — Change definition domain of an image.

Signature

change_domain(Image, NewDomain : ImageNew : : )

Herror change_domain(const Hobject Image, const Hobject NewDomain, Hobject* ImageNew)

Herror T_change_domain(const Hobject Image, const Hobject NewDomain, Hobject* ImageNew)

Herror change_domain(Hobject Image, Hobject NewDomain, Hobject* ImageNew)

HImage HImage::ChangeDomain(const HRegion& NewDomain) const

HImageArray HImageArray::ChangeDomain(const HRegion& NewDomain) const

void HOperatorSetX.ChangeDomain(
[in] IHUntypedObjectX* Image, [in] IHUntypedObjectX* NewDomain, [out] IHUntypedObjectX*ImageNew)

IHImageX* HImageX.ChangeDomain([in] IHRegionX* NewDomain)

static void HOperatorSet.ChangeDomain(HObject image, HObject newDomain, out HObject imageNew)

HImage HImage.ChangeDomain(HRegion newDomain)

Description

The operator change_domainchange_domainchange_domainChangeDomainChangeDomain uses the indicated region as the new definition domain. Unlike the operator reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain it does not form the intersection of the previous definition domain, i.e., the size of the matrix is not changed. This implies in particular, that the region must not exceed the image matrix, otherwise using such inconsistent iconic objects during subsequent operations will likely lead to errors or system crashes.

Attention

Due to running time the transferred region is not checked for consistency (i.e., whether it fits with the image matrix). Incorrect regions lead to system hang-ups during subsequent operations.

Parallelization

Parameters

ImageImageImageImageimage (input_object)  image(-array) objectHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Input image.

NewDomainNewDomainNewDomainNewDomainnewDomain (input_object)  region objectHRegionHRegionHRegionXHobject

New definition domain.

ImageNewImageNewImageNewImageNewimageNew (output_object)  image(-array) objectHImageHImageHImageXHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Image with new definition domain.

Possible Predecessors

get_domainget_domainget_domainGetDomainGetDomain

Alternatives

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain

See also

full_domainfull_domainfull_domainFullDomainFullDomain, get_domainget_domainget_domainGetDomainGetDomain, intersectionintersectionintersectionIntersectionIntersection

Module

Foundation


Table of Contents / Image / Domain ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH