add_channelsAddChannelsAddChannelsadd_channelsadd_channels
Short description
add_channelsAddChannelsAddChannelsadd_channelsadd_channels — Add gray values to regions.
Signature
add_channels( region Regions, image Image, out image GrayRegions )void AddChannels( const HObject& Regions, const HObject& Image, HObject* GrayRegions )static void HOperatorSet.AddChannels( HObject regions, HObject image, out HObject grayRegions )def add_channels( regions: HObject, image: HObject ) -> HObject
Herror add_channels( const Hobject Regions, const Hobject Image, Hobject* GrayRegions )
Herror T_add_channels( const Hobject Regions, const Hobject Image, Hobject* GrayRegions )
HImage HRegion::AddChannels( const HImage& Image ) const
HImage HRegion.AddChannels( HImage image )
Description
The operator add_channelsAddChannels creates an array of images
GrayRegionsgrayRegionsgray_regions with an element for every input region in
Regionsregionsregions. These images correspond to the input image Imageimageimage
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
Imageimageimage 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).
Parameters
Regionsregionsregions (input_object) region(-array) → objectHObjectHRegionHObjectHobject
Input regions (without pixel values).
Imageimageimage (input_object) (multichannel-)image → 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 with pixel values for regions.
GrayRegionsgrayRegionsgray_regions (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)
Output image(s) with regions and pixel values
(one image per input region).
Number of elements: Regions == GrayRegions
Combinations with other operators
Combinations
Possible predecessors
thresholdThreshold, regiongrowingRegiongrowing, gen_circleGenCircle, draw_regionDrawRegion
Possible successors
thresholdThreshold, regiongrowingRegiongrowing, get_domainGetDomain
Alternatives
change_domainChangeDomain, reduce_domainReduceDomain
See also
full_domainFullDomain, get_domainGetDomain, intersectionIntersection
Module
Foundation