ClassesClassesClassesClasses | | | | Operators

hamming_change_regionhamming_change_regionHammingChangeRegionhamming_change_regionHammingChangeRegionHammingChangeRegion (Operator)

Name

hamming_change_regionhamming_change_regionHammingChangeRegionhamming_change_regionHammingChangeRegionHammingChangeRegion — Generate a region having a given Hamming distance.

Warning

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

Signature

hamming_change_region(InputRegion : OutputRegion : Width, Height, Distance : )

Herror hamming_change_region(const Hobject InputRegion, Hobject* OutputRegion, const Hlong Width, const Hlong Height, const Hlong Distance)

Herror T_hamming_change_region(const Hobject InputRegion, Hobject* OutputRegion, const Htuple Width, const Htuple Height, const Htuple Distance)

Herror hamming_change_region(Hobject InputRegion, Hobject* OutputRegion, const HTuple& Width, const HTuple& Height, const HTuple& Distance)

HRegion HRegion::HammingChangeRegion(const HTuple& Width, const HTuple& Height, const HTuple& Distance) const

HRegionArray HRegionArray::HammingChangeRegion(const HTuple& Width, const HTuple& Height, const HTuple& Distance) const

void HammingChangeRegion(const HObject& InputRegion, HObject* OutputRegion, const HTuple& Width, const HTuple& Height, const HTuple& Distance)

HRegion HRegion::HammingChangeRegion(Hlong Width, Hlong Height, Hlong Distance) const

void HOperatorSetX.HammingChangeRegion(
[in] IHUntypedObjectX* InputRegion, [out] IHUntypedObjectX*OutputRegion, [in] VARIANT Width, [in] VARIANT Height, [in] VARIANT Distance)

IHRegionX* HRegionX.HammingChangeRegion(
[in] Hlong Width, [in] Hlong Height, [in] Hlong Distance)

static void HOperatorSet.HammingChangeRegion(HObject inputRegion, out HObject outputRegion, HTuple width, HTuple height, HTuple distance)

HRegion HRegion.HammingChangeRegion(int width, int height, int distance)

Description

hamming_change_regionhamming_change_regionHammingChangeRegionhamming_change_regionHammingChangeRegionHammingChangeRegion changes the region in the left upper part of the image given by WidthWidthWidthWidthWidthwidth and HeightHeightHeightHeightHeightheight such that the resulting regions have a Hamming distance of DistanceDistanceDistanceDistanceDistancedistance to the input regions. This is done by adding or removing DistanceDistanceDistanceDistanceDistancedistance points from the input region.

Attention

If WidthWidthWidthWidthWidthwidth and HeightHeightHeightHeightHeightheight are chosen too large the resulting region requires a lot of memory.

Parallelization

Parameters

InputRegionInputRegionInputRegionInputRegionInputRegioninputRegion (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Region to be modified.

OutputRegionOutputRegionOutputRegionOutputRegionOutputRegionoutputRegion (output_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject *

Regions having the required Hamming distance.

WidthWidthWidthWidthWidthwidth (input_control)  extent.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Width of the region to be changed.

Default value: 100

Suggested values: 64, 128, 256, 512

Typical range of values: 1 ≤ Width Width Width Width Width width ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Width > 0

HeightHeightHeightHeightHeightheight (input_control)  extent.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Height of the region to be changed.

Default value: 100

Suggested values: 64, 128, 256, 512

Typical range of values: 1 ≤ Height Height Height Height Height height ≤ 512 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Height > 0

DistanceDistanceDistanceDistanceDistancedistance (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Hamming distance between the old and new regions.

Default value: 1000

Suggested values: 100, 500, 1000, 5000, 10000

Typical range of values: 0 ≤ Distance Distance Distance Distance Distance distance ≤ 10000 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Distance >= 0 && Distance < Width * Height

Complexity

Memory requirement of the generated region (worst case): O(2 * WidthWidthWidthWidthWidthwidth * HeightHeightHeightHeightHeightheight).

Result

hamming_change_regionhamming_change_regionHammingChangeRegionhamming_change_regionHammingChangeRegionHammingChangeRegion returns 2 (H_MSG_TRUE) if all parameters are correct. 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

connectionconnectionConnectionconnectionConnectionConnection, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, pouringpouringPouringpouringPouringPouring, class_ndim_normclass_ndim_normClassNdimNormclass_ndim_normClassNdimNormClassNdimNorm

Possible Successors

select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape

See also

hamming_distancehamming_distanceHammingDistancehamming_distanceHammingDistanceHammingDistance

Module

Foundation


ClassesClassesClassesClasses | | | | Operators