Destroy

Destroying uiZ objects

Destroying a uiZ object may not be done using GameMaker's instance_destroy() function. To correctly remove a uiZ object, you need to call uiz_destroyObject(instanceid).

To destroy your object using an animation, see animations.

Here is a list of usable functions:

• uiz_destroyObject(instanceid): Destroys a uiZ object and all of it's children and grandchildren.

  • instanceid: The instance of the uiZ object to destroy.

• uiz_destroyObject_notself(instanceid): Destroys all of an object's children and grandchildren. However, the object itself is not destroyed.

  • instanceid: The instance of the parent who's children are to be destroyed.

• uiz_destroyObject_animation_default(instanceid): Safely destroys an uiZ object, but does it with style. The animation is set by uiz_destroyObject_setDestroyAnimation. This function also destroys all children of the instanceid after the animation is complete.

  • instanceid: The instance id of any uiZ object.

• uiz_destroyObject_animation(instanceid, xFunction, yFunction, alphaFunction, time): Destroys an object using a specific animation. This function also destroys all children of the instanceid after the animation is complete.

  • instanceid: The instance id of any uiZ object.
  • xFunction[uiz_straight]: The function to apply to the width of the object.
  • yFunction[uiz_straight]: The function to apply to the height of the object.
  • alphaFunction[uiz_straight]: The function to apply to the alpha (head_alpha specifically) of the object.
  • speed[0.5]: The time in seconds the animation should last for.

• uiz_destroyObject_setDestroyAnimation(instanceid, xFunction, yFunction, alphaFunction, time): Changes how an object is destroyed when uiz_destroyObject_animation_default is called.

  • instanceid: The instance id of any uiZ object.
  • xFunction[uiz_straight]: The function to apply to the width of the object.
  • yFunction[uiz_straight]: The function to apply to the height of the object.
  • alphaFunction[uiz_straight]: The function to apply to the alpha (head_alpha specifically) of the object.
  • speed[0.5]: The time in seconds the animation should last for.