partition_rectanglepartition_rectanglePartitionRectanglepartition_rectanglePartitionRectanglePartitionRectangle (Operator)

Name

partition_rectanglepartition_rectanglePartitionRectanglepartition_rectanglePartitionRectanglePartitionRectangle — Partition a region into rectangles of approximately equal size.

Signature

Description

partition_rectanglepartition_rectanglePartitionRectanglepartition_rectanglePartitionRectanglePartitionRectangle partitions the input region into rectangles having an extent of WidthWidthWidthWidthWidthwidth times HeightHeightHeightHeightHeightheight. The rectangles are returned in PartitionedPartitionedPartitionedPartitionedPartitionedpartitioned. The region is always split into rectangles of approximately equal size. If this is not possible with the requested rectangle size, then WidthWidthWidthWidthWidthwidth and HeightHeightHeightHeightHeightheight are adapted so that the size of the resulting rectangles is approximately equal. If the region is smaller than the given size, its output remains unchanged. A partition is only done if the size of the region is at least 1.5 times the size of the rectangle given by the parameters.

Parallelization

• 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

Result

partition_rectanglepartition_rectanglePartitionRectanglepartition_rectanglePartitionRectanglePartitionRectangle 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>), 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>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>), and the behavior in case of an empty result region via set_system('store_empty_region',<'true'/'false'>)set_system("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)set_system("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">). If necessary, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdthresholdThresholdThreshold, connectionconnectionConnectionconnectionConnectionConnection

Alternatives

partition_dynamicpartition_dynamicPartitionDynamicpartition_dynamicPartitionDynamicPartitionDynamic

See also

intersectionintersectionIntersectionintersectionIntersectionIntersection, smallest_rectangle1smallest_rectangle1SmallestRectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1, shape_transshape_transShapeTransshape_transShapeTransShapeTrans, clip_regionclip_regionClipRegionclip_regionClipRegionClipRegion

Module

Foundation