Operator Reference

HALCON Operator Reference / Image / Domain
ClassesClasses | | Operators

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain (Operator)

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain — Reduce the domain of an image.

Signature

reduce_domain(Image, Region : ImageReduced : : )

Herror reduce_domain(const Hobject Image, const Hobject Region, Hobject* ImageReduced)

Herror T_reduce_domain(const Hobject Image, const Hobject Region, Hobject* ImageReduced)

void ReduceDomain(const HObject& Image, const HObject& Region, HObject* ImageReduced)

HImage HImage::ReduceDomain(const HRegion& Region) const

static void HOperatorSet.ReduceDomain(HObject image, HObject region, out HObject imageReduced)

HImage HImage.ReduceDomain(HRegion region)

def reduce_domain(image: HObject, region: HObject) -> HObject

Description

The operator reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain reduces the definition domain of the given image to the indicated region. The new definition domain is calculated as the intersection of the old definition domain with the region. Thus, the new definition domain can be a subset of the region. The size of the matrix is not changed.

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).
  • Automatically parallelized on tuple level.

Parameters

ImageImageImageimageimage (input_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Input image.

RegionRegionRegionregionregion (input_object)  region → objectHRegionHObjectHObjectHobject

New definition domain.

ImageReducedImageReducedImageReducedimageReducedimage_reduced (output_object)  image(-array) → objectHImageHObjectHObjectHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Image with reduced definition domain.

Possible Predecessors

get_domainget_domainGetDomainGetDomainget_domain

Alternatives

change_domainchange_domainChangeDomainChangeDomainchange_domain, rectangle1_domainrectangle1_domainRectangle1DomainRectangle1Domainrectangle1_domain, add_channelsadd_channelsAddChannelsAddChannelsadd_channels

See also

full_domainfull_domainFullDomainFullDomainfull_domain, get_domainget_domainGetDomainGetDomainget_domain, intersectionintersectionIntersectionIntersectionintersection

Module

Foundation

ClassesClasses | | Operators