NAME

image_children - List the objects in a context that has the specified object as a direct parent

SYNOPSIS

vidtbl or bool
image_children( vid, searchvid )

DESCRIPTION

This function provides either a list of immediate descendants (images linked TO vid) or recursively scans and tests if vid is related to searchvid (when provided).

EXAMPLE

function image_children0()


      a = null_surface(1, 1);


      b = null_surface(1, 1);


      c = null_surface(1, 1);


      link_image(b, a);


      link_image(c, b);


      tbl = image_children(a);


      for i,v in ipairs(tbl) do


            print(v);


      end
end

EXAMPLE

function image_children1()


      a = null_surface(1, 1);


      b = null_surface(1, 1);


      c = null_surface(1, 1);


      d = null_surface(1, 1);


      link_image(c, b);


      link_image(b, a);


      local positive = image_children(c, a);


      local negative = image_children(d, a);


      print(positive, negative);
end

MISUSE

function image_children0()


      image_childen(BADID);
end

SEE ALSO:

image_parent(3)