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-Fileobjc_draw()
Object Library
objc_change()                                                           AES

Syntax


WORD objc_change( tree, obj, rsvd, ox, oy, ow, oh, newstate, drawflag )
OBJECT *tree;
WORD obj, rsvd, ox, oy, ow, oh, newstate, drawflag;

Function       objc_change() changes the display state of an object.

Opcode         47 (0x2F)

Availability   All AES versions.

Parameters     tree specifies the object tree of the object to modify. obj
               specifies the object to modify.
               rsvd is reserved and should be 0.
               ox, oy, ow, and oh specify the clipping rectangle if the
               object is to be redrawn.
               newstate specifies the new state of the object (same as
               ob_state).
               If drawflag is NO_DRAW (0) the object is not redrawn
               whereas if drawflag is REDRAW (1) the object is redrawn.

Binding        intin[0] = obj;
               intin[1] = rsvd;
               intin[2] = ox;
               intin[3] = oy;
               intin[4] = ow;
               intin[5] = oh;
               intin[6] = newstate;
               intin[7] = drawflag;

               addrin[0] = tree;

               return crys_if(0x2F);

Return Value   objc_change() returns 0 if an error occurred and non-zero
               otherwise.

Comments       In general, if not redrawing the object, it is usually
               quicker to manipulate the object tree directly.

See Also       objc_draw()


Group          Object Library