Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileObject Library
objc_find()                                                             AES

Syntax

WORD objc_find( tree, obj, depth, ox, oy )
OBJECT *tree;
WORD obj, depth, ox, oy;

Function       objc_find() determines which object is found at a given
               coordinate.

Opcode         43 (0x2B)

Availability   All AES versions.

Parameters     tree specifies the object tree containing the objects to
               search. The search starts from object index obj forward in
               the object tree.
               depth specifies the depth in the tree to search (a value
               of 1 searches only first generation objects, a value of 2
               searches up to second generation objects, up to a maximum
               of 7 to search all objects).
               ox and oy specify the coordinate to search at.

Binding        intin[0] = obj;
               intin[1] = depth;
               intin[2] = ox;
               intin[3] = oy;

               addrin[0] = tree;

               return crys_if(0x2B);

Return Value   objc_find() returns the object index of the object found at
               coordinates ( ox, oy ) or -1 if no object is found.

Group          Object Library