NAME

image_parent - Return a reference to the parent object.

SYNOPSIS

nil
image_parent( vid:src )
image_parent( vid:src, vid:reference )

DESCRIPTION

This function is used to figure out if vid is linked to another object from a previous call to link_image and which primary attachement the image has. This is normally WORLDID , but can be another vid through any of the define_rendertarget class of functions. If the reference argument is provided, the function will only return if src is a decendent of reference . and the parentvid will match reference .

EXAMPLE

function image_parent0()


      a = fill_surface(32, 32, 255, 0, 0);


      b = fill_surface(32, 32, 255, 0, 0);


      c = fill_surface(32, 32, 255, 0, 0);


      link_image(c, a);


      image_tracetag(a, "(a)");


      print(image_tracetag(image_parent(b)));


      print(image_tracetag(image_parent(c)));


      print(image_tracetag(image_parent(a)));
end

EXAMPLE

function image_parent1()


      a = fill_surface(32, 32, 255, 0, 0)


      b = fill_surface(32, 32, 255, 0, 0)


      c = fill_surface(32, 32, 255, 0, 0)


      d = fill_surface(32, 32, 255, 0, 0)


      link_image(a, b)


      link_image(b, c)


      print(image_parent(a, b))


      print(image_parent(a, c))


      print(image_parent(a, d)) -- not a parent
end

MISUSE

function image_parent0()


      print(image_parent(BADID));
end

MISUSE

function image_parent1()


      print(image_parent(WORLDID));
end