Reject the registration: Directly

ASTER::ACTION::MotionControl::Reject from controller, the registered specific instance; LPRO Directly

Unregister an instance by specifying the instance registered in the motion controller.

• Timer processing can be set by specifying frame time.

• There are two main methods for unregistering instances and motion groups registered with the motion controller.

Use "By Name" to unregister by motion group and "LPRO Directly" to unregister only matched instances.

"LPRO Directly"; Send the "fixed value" of instances that match specific conditions, such as object instances that match condition checks for variable values or object instances clicked by the mouse, to ASTER.

Parameter.1

Specification of the motion group name.

Select the object instance. Only the "Active (sprite) Object" Type can select.

If "The Active Object" is not specified, an error will be displayed when executing the action from the event, and the process will be aborted.

Parameter.2

Frame-based timer function.

You can set a timer to unregister at a specified time. The time unit is in application frames.

If the application is running at 60 FPS, inputting 60 as the parameter will unregister approximately one second later.

To unregister immediately, input 0.

Notes.1

Execution priority.

Reject is the highest level command in the motion controller. It is not affected by lower-level commands.

Once a Reject command is issued, it cannot be overridden, stopped, or canceled. If a command of the same type as Reject has already been issued to the target motion group, any subsequently issued Reject commands will be invalidated.

Notes.2

“By Name” and “LPRO Directly”

The Reject command has two types: "By Name," which attempts to unregister by specifying the group name, and "Direct," which attempts to unregister by searching for the memory address of the object instance.

When commands with Destroy functionality are added to these two types, there are a total of four types of Reject commands. Furthermore, if the delay execution value is 0 and all registered instances are targeted by the "By Name" command, it branches into the "Complete Unregister (完全解除)" and "Complete Erase (完全消去)" commands, making a total of six types.

All six types are equivalent in authority, with the command issued first having priority.

---
title: Reject Functions
---
flowchart LR
  A@{shape: dbl-circ, label: "Reject"}
  A --> B@{ shape: delay, label: "Reject: Directly" }
  A --> C@{ shape: delay, label: "Reject: By Name" }
  C --> D[Reject: All]
  C --> E[Timer]
  C --> F[Timer + Destroy]
  B --> G[Timer]
  B --> H[Timer + Destroy]
  D --> I[Timer]
  D --> J[Timer + Destroy]
  I -.-|Named| K@{shape: dbl-circ, label: "完全解除"}
  J -.-|Named| L@{shape: dbl-circ, label: "完全消去"}

The "By Name" type of the Reject command can capture the exact timing of unregistration by Event Detect (immediate execution condition) when the registration is canceled on a motion group basis.

However, if the group is deleted using the "Complete Unregister (完全解除)" or "Complete Erase (完全消去)" of Reject, Event Detect cannot be used.