KC_MoveRouteTF - Rotate, Translate, and Scale Characters During Move Routes [MV

じ☆ve冰风

KC_MoveRouteTF 1.0.2
by Kelly Chavez​

Introduction
I felt my cutscenes were a bit bland, so I wrote a few functions to let me add a little flair to my move routes.

Features
This script is fairly minimal in terms of parameters. All they do is allow individual portions of the plugin to be disabled for compatibility. The real meat of this plugin is in the methods added to the character objects that can be easily accessed through move route commands.

Screenshots




How to Use
Using the script is as simple as adding it via the plugin manager and using the script calls in your move route commands.

Script Calls
All of these functions are accessed via the move route commands and prefixed with 'this.'. So, for example, to rotate a character 90 degrees clockwise, you would write 'this.rotate(90)' in the move route command. All arguments have default values used if they are not explicitly defined by the developer. See plugin help for more details.

• Getter Functions:
  
  
  
  • scaleX(), scaleY(), translationX(), translationY(), rotation()
    
  • Each of these functions returns the CURRENT value of their respective transformations
    
  
  
• Setter Functions:
  
  
  
  • rescaleXTo(scale, duration, wait), rescaleYTo(scale, duration, wait), rescaleTo(x, y, duration, wait), translateXTo(x, duration, wait), translateYTo(y, duration, wait), translateTo(x, y, duration, wait), rotateTo(angle, duration, wait)
    
  • rescaleX(scale, duration, wait), rescaleY(scale, duration, wait), rescale(x, y, duration, wait), translateX(x, duration, wait), translateY(y, duration, wait), translate(x, y, duration, wait), rotate(angle, duration, wait)
    
  • Each of these functions transforms the character's sprite. Functions suffixed with 'To' transform the character until they reach the value(s) passed into the function.
    
  • Functions not suffixed with 'To' offset the current transformation by that amount.
    
  • To demonstrate the difference between these functions, consider the function calls this.rescaleY(1) and this.rescaleYTo(1) on a character whose vertical scale is 1. this.rescaleY(1) would leave the character with a y scale of 2 (current scale + value = 1 + 1 = 2) whereas this.rescaleYTo(1) would leave the scale at 1.
    
  
  

Demo (MZ)
Current Version (1.0.2) - GitHub
Old Version (1.0.1) - GitHub
Old Version (1.0.0) - GitHub

Demo (MV)
Current Version (1.0.2) - Github
Old Version (1.0.1) - Github
Old Version (1.0.0) - N/A

Download
GitHub (Download 'KC_MoveRouteTF.js')

Compatibility Notes

• Plugin (MZ): VisuMZ_1_EventsMoveCore
  
  
  
  • This plugin's rotation functionality is incompatible with the "Dash tilt?" option of the listed plugin.
    
  
  

Changelog
Spoiler: Changelog

• 2024/04/09 -v1.0.2
  
  
  
  • Fix 'Play Animation' sprite incorrect positioning bug in MV
    
    
    
    • Character would be incorrectly positioned while animations played if rotations were enabled
      
    
    
  • Fix crash upon load game in certain condition
    
    
    
    • Game would crash when loading a save file that was created without this plugin present
      
    
    
  • General internal code restructure
    
  
  
• 2022/07/20 - v1.0.1
  
  
  
  • Fixed aliasing on Game_CharacterBase.prototype.update
    
  • Changed how rotations are handled internally to support MV
    
  
  
• 2022/07/19 - v1.0.0
  
  
  
  • Initial Release
    
  
  

Terms and Credits
I've released this plugin under the MIT license. So, you can include this plugin in any project as long as you include the license with your distribution. For most projects, this requirement is fulfilled as long as you keep the license text that is at the top of the plugin's js file intact.

Also, though not strictly required, I would appreciate being credited as K. Chavez or Kelly Chavez in your games' credits.


本贴来自国际rpgmaker官方论坛作者:Kelly-inactive处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/kc_moveroutetf-rotate-translate-and-scale-characters-during-move-routes-mv-mz.149633/