A_CallSpecial

A_CallSpecial (int special, [int arg1, [int arg2, [int arg3, [int arg4, [int arg5]]]]])

Warning: This function should never be used directly. This article is for the purposes of complete documentation only.

This is used internally to convert an action special call in DECORATE into an action function the parser can recognize. It should not be used directly.

Examples

Take this sample DECORATE code:

Death:
  BOSS I 8
  BOSS J 8 A_Scream
  BOSS K 8
  BOSS L 8 A_NoBlocking
  BOSS M 0 Floor_LowerToLowest (17, 64)
  BOSS MN 8
  BOSS O -1
  stop

Internally, the Floor_LowerToLowest line is converted to this:

  BOSS M 0 A_CallSpecial (21, 17, 64)

Since 21 is the ID of the Floor_LowerToLowest special, this results in the special being called when this frame is processed at run-time. This conversion is done automatically by ZDoom, so you don't need to worry about specifying this yourself.

This function may seem limited at face-value, but it can be used for a number of useful effects. If you have an actor that can be "used" and want it to clear it's special after being destroyed, calling Thing_SetSpecial and clearing it's arguments will work. Furthermore, DECORATE can be infinitely expanded by calling ACS_Execute and related script functions in your DECORATE code.