region_get(STRING* name, num,VECTOR* vMin, VECTOR* vMax)
Returns the size of a certain region.
Parameters:
name - region name, STRING* or char*, or NULL for finding regions regardless of their name.
num - number of the region (1 = first region) if there are several regions with the same name, or if NULL was given for the name.
vMin - set to bounding box minimum coordinate.
vMin - set to bounding box maximum coordinate.
Returns:
0 - region not found
1 - region found
Speed:
Medium.
Remarks:
- Different regions can have the same name. In that case, use num to select between the same-named regions.
- For merely testing if a region with given name exists, NULL can be given for vMin and vMax.
- Regions can be placed in WED by clicking Add Region, or created with region_create.
Edition:
A8.12
Example:
VECTOR vMin,vMax;
if(region_get("trigger_01",1,vMin,vMax))
printf("Region found!");
See also:
view_check, region_set, region_find, region_create,
region_check
► latest version online