define_region

Defines either a rectangular region or a rectilinear region.

define_region [-name region_name] -type region_type [x1 y1 x2 y2]+ [-color value]

Arguments

-name region_name

Specifies the region name. The name must be unique. Do not use reserved names such as “bank0” and “bank<N>” for region names. If the region cannot be created, the name is empty. A default name is generated if a name is not specified in this argument.

-type region_type

Specifies the region type. The default is inclusive. The following table shows the acceptable values for this argument:

Region Constraint	Conditions
Empty	No macros can be assigned to an empty region
Exclusive	Only contains macros assigned to the region
Inclusive	Can contain macros both assigned and unassigned to the region

x1 y1 x2 y2

Specifies the series of coordinate pairs that constitute the region. These rectangles may or may not overlap. They are given as x1 y1 x2 y2 (where x1, y1 is the lower left and x2 y2 is the upper right corner in row/column coordinates). You must specify at least one set of coordinates.

-color value

Specifies the color of the region. The following table shows the acceptable values for this argument:

Color	Decimal value	Description
	16776960	Aqua
	65280	Bright green
	16711680	Blue
	16760960	RGB(128,192,255)
	255	Red
	16711935	Fuchsia
	65535	Yellow
	33023	Orange
	8421631	Coral
	9568200	Sea foam
	8323199	Violet
	12632256	Gray - 25%

Supported Families

Fusion, ProASIC3/E and Axcelerator

Description

Unlocked macros in empty or exclusive regions are unassigned from that region. You cannot create empty or exclusive regions in areas that contain locked macros.

You can define a rectilinear region only in a PDC file; you cannot define a rectilinear region using the MultiView Navigator tool.

Use inclusive or exclusive region constraints if you intend to assign logic to a region. An inclusive region constraint with no macros assigned to it has no effect. An exclusive region constraint with no macros assigned to it is equivalent to an empty region.

Exceptions

If macros assigned to a region exceed the area's capacity, an error message appears in the Log window.

Examples

The following example defines an empty rectangular region.

define_region -name cluster_region1 -type empty 100 46 102 46

The following example defines a rectilinear region with the name RecRegion. This region contains two rectangular areas.

define_region -name RecRegion -type Exclusive 0 40 3 42 0 77 7 79

The following examples define three regions with three different colors:

define_region -name UserRegion0 -color 128 50 19 60 25

define_region -name UserRegion1 -color 16711935 11 2 55 29