特定の写真がいくつかのスプライトと衝突したときに2種類のイベントを実行できるプラグイン – RS_PictureTool.js

=============================================================================
Introduction
=============================================================================
This plugin allows you to create interactive pictures that can detect
collisions with characters (events or player) and trigger specific actions
when collisions occur.

This is useful for creating interactive UI elements, clickable objects in the
game world, or creating trigger areas without needing to place visible events.

=============================================================================
Script Calls
=============================================================================

1) Run a specific event when a picture collides with an event:

RS.PictureTool.runEventCollideWithPicture(picId, eventId);

Parameters:
- picId: The ID of the picture (starts from 1)
- eventId: The ID of the event to check collision with and to run

2) Run a common event when a picture collides with an event:

RS.PictureTool.runCommonEventCollideWithPicture(picId, eventId, commonEventId);

Parameters:
- picId: The ID of the picture (starts from 1)
- eventId: The ID of the event to check collision with
- commonEventId: The ID of the common event to run

3) Run an event when a picture collides with the player:

RS.PictureTool.runEventCollideWithPlayer(picId, eventId);

Parameters:
- picId: The ID of the picture (starts from 1)
- eventId: The ID of the event to run when collision occurs

4) Run a common event when a picture collides with the player:

RS.PictureTool.runCommonEventCollideWithPlayer(picId, eventId, commonEventId);

Parameters:
- picId: The ID of the picture (starts from 1)
- eventId: The ID of the event to check (usually for tracking purposes)
- commonEventId: The ID of the common event to run

=============================================================================
Usage Examples
=============================================================================

Example 1: Create clickable button
1. Show a picture with ID 1 (button image)
2. Create an event with ID 5 that contains the button functionality
3. In a parallel process event, call:
RS.PictureTool.runEventCollideWithPlayer(1, 5);

Example 2: Create an invisible trigger area
1. Show a transparent picture with ID 2 at desired location
2. Create a common event with ID 10 for the trigger action
3. In a parallel process event, call:
RS.PictureTool.runCommonEventCollideWithPlayer(2, 1, 10);

=============================================================================
Notes
=============================================================================
- Collision detection uses rectangular hitboxes
- The Delay parameter prevents excessive triggering and input blocking
- Pictures must be visible (though can be transparent) for collision to work
- Events can be triggered repeatedly if the collision persists

=============================================================================
Version Log
=============================================================================
2018.04.13 (v1.0.0) - First Release.
2018.04.16 (v1.0.1) - Fixed a hanging bug.
2018.04.16 (v1.0.2) - Fixed the issue that the save is not working.
2018.04.16 (v1.0.3) - Fixed the issue when the picture is deleted
2024.06.23 (v1.1.0):
- Fixed the issue of no response when a picture collides with a specific character sprite
- Improved collision detection accuracy
- Optimized performance for multiple collision checks
- Added better error handling for missing pictures or events