ClassesClasses | | Operators

change_domainchange_domainChangeDomainChangeDomain (Operator)

Name

change_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)

void ChangeDomain(const HObject& Image, const HObject& NewDomain, HObject* ImageNew)

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

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

HImage HImage.ChangeDomain(HRegion newDomain)

Description

The operator change_domainchange_domainChangeDomainChangeDomainChangeDomain uses the indicated region as the new definition domain. Unlike the operator reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain 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.

Execution Information

Parameters

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

Input image.

NewDomainNewDomainNewDomainNewDomainnewDomain (input_object)  region objectHRegionHRegionHobject

New definition domain.

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

Image with new definition domain.

Possible Predecessors

get_domainget_domainGetDomainGetDomainGetDomain

Alternatives

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain

See also

full_domainfull_domainFullDomainFullDomainFullDomain, get_domainget_domainGetDomainGetDomainGetDomain, intersectionintersectionIntersectionIntersectionIntersection

Module

Foundation


ClassesClasses | | Operators