A_TransferPointer

(development version r3167+ only)
A_TransferPointer (pointer source, pointer recipient, pointer sourcefield, pointer recipientfield[, int flags])

The calling actor performs a transfer of pointer between itself and another actor.

• source corresponds to the actor to use as a model
• recipient corresponds to the actor that will change its pointer
• sourcefield corresponds to the pointer to transfer from the source (cannot be DEFAULT or NULL)
• recipientfield corresponds to which pointer of the recipient will host the transferred value (cannot be DEFAULT or NULL)

The pointers can be any of the following:

• AAPTR_DEFAULT: The calling actor itself
• AAPTR_NULL: No actor at all (does nothing)
• AAPTR_TARGET: The calling actor's target, if any
• AAPTR_MASTER: The calling actor's master, if any
• AAPTR_TRACER: The calling actor's tracer, if any

Remember that the nature of these pointers depend on the actor type and is not always intuitive.

For more information on pointers, visit the actor pointers page.

Examples

Note: This article lists no examples. If you make use of this feature in your own project(s) or know of any basic examples that could be shared, please add them. This will make it easier to understand for future authors seeking assistance. Your contibutions are greatly appreciated.