select_obj ( Objects : ObjectSelected : Index : )

Select an object from an object tuple.

select_obj copies the iconic object with index Index (starting with 1) from the iconic input object tuple Objects to the output object ObjectSelected. No new storage is allocated for the regions and images. Instead, new objects containing references to the existing objects are created. The number of objects in an object tuple can be queried with the operator count_obj.


Parameters

Objects (input_object)
object(-array) -> object
Objects, of which one is to be selected.

ObjectSelected (output_object)
object -> object
Selected object.

Index (input_control)
integer -> integer
Index of the object to be selected.
Default value: 1
Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 50, 100, 200, 500, 1000, 2000, 5000
Range of values: 1 <= Index


Example
/* Access to all Regions */

count_obj(Regions,&Num);
for (i=1; i<=Num; i++)
{
  select_obj(Regions,&Single,i);
  T_fetch_polygon(Single,5.0,&Row,&Column);
  T_disp_polygon(Row,Column);
  destroy_tuple(Row);
  destroy_tuple(Column);
  clear(Single);
}

Complexity

Runtime complexity: O(|Objects|


Result

select_obj returns TRUE if all objects are contained in the HORUS database and all parameters are correct. If the input is empty the behaviour can be set via set_system(::'no_object_result',<Result>:). If necessary, an exception is raised.


Possible Predecessors

count_obj


Alternatives

copy_obj


See also

count_obj, concat_obj, obj_to_integer



Copyright © 1996-1997 MVTec Software GmbH