Skip to content

change_domainChangeDomainChangeDomainchange_domainchange_domain🔗

Short description🔗

change_domainChangeDomainChangeDomainchange_domainchange_domain — Change definition domain of an image.

Signature🔗

change_domain( image Image, region NewDomain, out image ImageNew )void ChangeDomain( const HObject& Image, const HObject& NewDomain, HObject* ImageNew )static void HOperatorSet.ChangeDomain( HObject image, HObject newDomain, out HObject imageNew )def change_domain( image: HObject, new_domain: HObject ) -> HObject

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

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

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

HImage HImage.ChangeDomain( HRegion newDomain )

Description🔗

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

Execution information

  • Supports objects on compute devices.

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

Parameters🔗

Imageimageimage (input_object) (multichannel-)image(-array) → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HObject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HImage (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HObject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)Hobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Input image.

NewDomainnewDomainnew_domain (input_object) region → objectHObjectHRegionHObjectHobject

New definition domain.

ImageNewimageNewimage_new (output_object) image(-array) → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HObject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HImage (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HObject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)Hobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Image with new definition domain.

Combinations with other operators🔗

Combinations

Possible predecessors

get_domainGetDomain

Alternatives

reduce_domainReduceDomain

See also

full_domainFullDomain, get_domainGetDomain, intersectionIntersection

Module🔗

Foundation