interjacentinterjacentInterjacentInterjacentinterjacent (Operator)

Name

interjacentinterjacentInterjacentInterjacentinterjacent — Partition the image plane using given regions.

Warning

interjacentinterjacentInterjacentInterjacentInterjacentinterjacent is obsolete and is only provided for reasons of backward compatibility.

Signature

interjacent(Region : RegionInterjacent : Mode : )

Herror interjacent(const Hobject Region, Hobject* RegionInterjacent, const char* Mode)

Herror T_interjacent(const Hobject Region, Hobject* RegionInterjacent, const Htuple Mode)

void Interjacent(const HObject& Region, HObject* RegionInterjacent, const HTuple& Mode)

HRegion HRegion::Interjacent(const HString& Mode) const

HRegion HRegion::Interjacent(const char* Mode) const

HRegion HRegion::Interjacent(const wchar_t* Mode) const   (Windows only)

static void HOperatorSet.Interjacent(HObject region, out HObject regionInterjacent, HTuple mode)

HRegion HRegion.Interjacent(string mode)

def interjacent(region: HObject, mode: str) -> HObject

Description

interjacentinterjacentInterjacentInterjacentInterjacentinterjacent partitions the image plane using the regions given in RegionRegionRegionRegionregionregion. The result is a region containing the extracted separating lines. The following modes of operation can be used:

'medial_axis'

This mode is used for regions that do not touch or overlap. The operator will find separating lines between the regions which partition the background evenly between the input regions. This corresponds to the following calls:

Example:

complement('full',Region,Tmp)complement("full",Region,Tmp)Complement("full",Region,Tmp)Complement("full",Region,Tmp)Complement("full",Region,Tmp)complement("full",Region,Tmp)

skeleton(Tmp,Result)skeleton(Tmp,Result)Skeleton(Tmp,Result)Skeleton(Tmp,Result)Skeleton(Tmp,Result)skeleton(Tmp,Result)

'border'

If the input regions do not touch or overlap this mode is equivalent to boundary(Region,Result)boundary(Region,Result)Boundary(Region,Result)Boundary(Region,Result)Boundary(Region,Result)boundary(Region,Result), i.e., it replaces each region by its boundary. If regions are touching they are aggregated into one region. The corresponding output region then contains the boundary of the aggregated region, as well as the one pixel wide separating line between the original regions. This corresponds to the following calls:

Example:

boundary(Region,Tmp1,'inner')boundary(Region,Tmp1,"inner")Boundary(Region,Tmp1,"inner")Boundary(Region,Tmp1,"inner")Boundary(Region,Tmp1,"inner")boundary(Region,Tmp1,"inner")

union1(Tmp1,Tmp2)union1(Tmp1,Tmp2)Union1(Tmp1,Tmp2)Union1(Tmp1,Tmp2)Union1(Tmp1,Tmp2)union1(Tmp1,Tmp2)

skeleton(Tmp2,Result)skeleton(Tmp2,Result)Skeleton(Tmp2,Result)Skeleton(Tmp2,Result)Skeleton(Tmp2,Result)skeleton(Tmp2,Result)

'mixed'

In this mode the operator behaves like the mode 'medial_axis'"medial_axis""medial_axis""medial_axis""medial_axis""medial_axis" for non-overlapping regions. If regions touch or overlap, again separating lines between the input regions are generated on output, but this time including the “touching line” between regions, i.e., touching regions are separated by a line in the output region. This corresponds to the following calls:

Example:

erosion1(Region,Mask,Tmp1,1)erosion1(Region,Mask,Tmp1,1)Erosion1(Region,Mask,Tmp1,1)Erosion1(Region,Mask,Tmp1,1)Erosion1(Region,Mask,Tmp1,1)erosion1(Region,Mask,Tmp1,1)

union1(Tmp1,Tmp2)union1(Tmp1,Tmp2)Union1(Tmp1,Tmp2)Union1(Tmp1,Tmp2)Union1(Tmp1,Tmp2)union1(Tmp1,Tmp2)

complement(full,Tmp2,Tmp3)complement(full,Tmp2,Tmp3)Complement(full,Tmp2,Tmp3)Complement(full,Tmp2,Tmp3)Complement(full,Tmp2,Tmp3)complement(full,Tmp2,Tmp3)

skeleton(Tmp3,Result)skeleton(Tmp3,Result)Skeleton(Tmp3,Result)Skeleton(Tmp3,Result)Skeleton(Tmp3,Result)skeleton(Tmp3,Result)

where Mask denotes the following “cross mask”:

Execution Information

Parameters

RegionRegionRegionRegionregionregion (input_object)  region(-array) objectHRegionHObjectHRegionHobject

Regions for which the separating lines are to be determined.

RegionInterjacentRegionInterjacentRegionInterjacentRegionInterjacentregionInterjacentregion_interjacent (output_object)  region objectHRegionHObjectHRegionHobject *

Output region containing the separating lines.

ModeModeModeModemodemode (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Mode of operation.

Default value: 'mixed' "mixed" "mixed" "mixed" "mixed" "mixed"

List of values: 'border'"border""border""border""border""border", 'medial_axis'"medial_axis""medial_axis""medial_axis""medial_axis""medial_axis", 'mixed'"mixed""mixed""mixed""mixed""mixed"

Example (HDevelop)

read_image(Image,'forest_air1')
mean_image(Image,Mean,31,31)
dyn_threshold(Image,Mean,Seg,20,'light')
interjacent(Seg,Graph,'medial_axis')
dev_display(Graph)

Example (C)

read_image(&Image,"forest_air1");
mean_imae(Image,&Mean,31,31);
dyn_threshold(Image,Mean,&Seg,20,"light");
interjacent(Seg,&Graph,"medial_axis");
disp_region(Graph,WindowHandle);

Example (HDevelop)

read_image(Image,'forest_air1')
mean_image(Image,Mean,31,31)
dyn_threshold(Image,Mean,Seg,20,'light')
interjacent(Seg,Graph,'medial_axis')
dev_display(Graph)

Example (HDevelop)

read_image(Image,'forest_air1')
mean_image(Image,Mean,31,31)
dyn_threshold(Image,Mean,Seg,20,'light')
interjacent(Seg,Graph,'medial_axis')
dev_display(Graph)

Example (HDevelop)

read_image(Image,'forest_air1')
mean_image(Image,Mean,31,31)
dyn_threshold(Image,Mean,Seg,20,'light')
interjacent(Seg,Graph,'medial_axis')
dev_display(Graph)

Result

interjacentinterjacentInterjacentInterjacentInterjacentinterjacent always returns the value TRUE. The behavior in case of empty input (no regions given) can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>), the behavior in case of an empty input region via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>), and the behavior in case of an empty result region via set_system('store_empty_region',<'2 (H_MSG_TRUE)'/'3 (H_MSG_FALSE)'>)set_system("store_empty_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)SetSystem("store_empty_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)SetSystem("store_empty_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)SetSystem("store_empty_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)set_system("store_empty_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">). If necessary, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringPouringpouring

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

See also

expand_regionexpand_regionExpandRegionExpandRegionExpandRegionexpand_region, junctions_skeletonjunctions_skeletonJunctionsSkeletonJunctionsSkeletonJunctionsSkeletonjunctions_skeleton, boundaryboundaryBoundaryBoundaryBoundaryboundary

Module

Foundation