Operator Reference

HALCON Operator Reference / Image / Domain
ClassesClasses | | Operators

add_channelsadd_channelsAddChannelsAddChannelsadd_channels (Operator)

add_channelsadd_channelsAddChannelsAddChannelsadd_channels — Add gray values to regions.

Signature

add_channels(Regions, Image : GrayRegions : : )

Herror add_channels(const Hobject Regions, const Hobject Image, Hobject* GrayRegions)

Herror T_add_channels(const Hobject Regions, const Hobject Image, Hobject* GrayRegions)

void AddChannels(const HObject& Regions, const HObject& Image, HObject* GrayRegions)

HImage HRegion::AddChannels(const HImage& Image) const

static void HOperatorSet.AddChannels(HObject regions, HObject image, out HObject grayRegions)

HImage HRegion.AddChannels(HImage image)

def add_channels(regions: HObject, image: HObject) -> HObject

Description

The operator add_channelsadd_channelsAddChannelsAddChannelsadd_channels creates an array of images GrayRegionsGrayRegionsGrayRegionsgrayRegionsgray_regions with an element for every input region in RegionsRegionsRegionsregionsregions. These images correspond to the input image ImageImageImageimageimage with a reduced domain, namely the intersection of the definition domain of the input image with the region. Thus, the new definition domain can be a subset of the region. Thereby the size of the image matrix is not changed and all channels of ImageImageImageimageimage are adopted.

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

RegionsRegionsRegionsregionsregions (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Input regions (without pixel values).

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

Input image with pixel values for regions.

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

Output image(s) with regions and pixel values (one image per input region).

Number of elements: Regions == GrayRegions

Possible Predecessors

thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, gen_circlegen_circleGenCircleGenCirclegen_circle, draw_regiondraw_regionDrawRegionDrawRegiondraw_region

Possible Successors

thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, get_domainget_domainGetDomainGetDomainget_domain

Alternatives

change_domainchange_domainChangeDomainChangeDomainchange_domain, reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain

See also

full_domainfull_domainFullDomainFullDomainfull_domain, get_domainget_domainGetDomainGetDomainget_domain, intersectionintersectionIntersectionIntersectionintersection

Module

Foundation

ClassesClasses | | Operators