[PK8]

New Character Properties with Calls

LINKS BROKEN

Introduction
This script adds additional properties from the Sprite class to Game_Character such as angle, color, mirror, tone, zoom_x, and zoom_y. For this version, I also combined my Event Angle/Color/Mirror/Tone/Zoom add-ons and my script calls with this script.

Features

• This gives Character sprites additional properties from the Sprite class such as Angle, Color, Mirror, Tone, Zoom, Wave Amp, Wave Length, and Wave Speed
  
• Change the angle, color, mirror, tone, zoom, wave amp, wave length, and wave speed of a character sprite using script calls.
  
• Set Angle, Color, Mirror, Tone, Zoom, Wave Amplitude, Wave Length, and Wave Speed of Events using special comments.
  
• Change certain properties of a character sprite to a desired value in a certain number of frames with a script call.
  

What's New?
For v2, I merged two add-ons I made for the original (Change Character Sprite Angle/Color/Size/Tone in frames and Event Angle/Color/Size/Tone) into one package and threw in several new script calls which should be useful (e.g.: zoom_change, color_*_change, tone_*_change).

Media
Images

Note the treasure chests, statues, and the flying imp hovering over Ralph.

Script
New Character Properties with Calls 2.2 (RMVXA)
New Character Properties with Calls 2.2 (RMVX)
New Character Properties with Calls 2.2 (RMXP)

Author's Notes
I wanted to work on letting game creators animate character sprites a little more through script calls. I noticed certain properties such as angle, color, mirror, tone, and angle were missing so I wanted to add them in.

Thanks
Charlie Fleed for showing me how to script special comments a few years ago.
Prof. Meow Meow making fantastic use of it in a demo he showed me a few years ago.

License / Terms
Free for non-commercial and commercial purposes. Just credit me.

[PK8]

Indeed. :D

Also, yo! This script's been updated to version 1.2 as of today! This update particularly caters towards those who didn't like how the sprite's zoom level value 1.0 signifies actual pixel size. So I decided to do something about it and made 100.0 signify actual pixel size. I've also added a customization option for anyone who does not like the change.

[PK8]

Event Tone, Color, Size, Angle and Mirror

Introduction
The following five scripts I'm submitting allows the user to alter an event sprite's size, angle, tone, color and have it flip horizontally. These scripts will require the Character Sprite Add-ons script in order for them to work.

Features

• Change tone of event sprite. (Event Tone)
  
• Give it a color. (Event Color)
  
• Change the size of the event sprite. (Event Size)
  
• Change the angle of the event's sprite. (Event Angle)
  
• Flip event sprite horizontally. (Event Mirror)
  

Screenshots

Script
Event Angle
Event Color
Event Mirror
Event Size
Event Tone

Instructions
These scripts require the Character Sprite Add-ons script in order for them to work.

FAQ

How to change the angle of an event sprite

Go to a map event, select the Comment event command and type this:
$angle value

How to set the color of an event sprite

Go to a map event, select the Comment event command and type this:
$color red(0 - 255) green(0 - 255) blue(0 - 255) alpha(0 - 255)(optional)(default: 255)

How to flip the event sprite horizontally.

Go to a map event, select the Comment event command and type this:
$mirror

How to change the size of an event sprite.

Go to a map event, select the Comment event command and type this:
$size x-scale y-scale

Note that 1.0 denotes actual size of the sprite.
Example: $size 0.5 0.5 - Half the size of the normal sprite.

How to set the tone of an event sprite.

Go to a map event, select the Comment event command and type this:
$color red(-255 - 255) green(-255 - 255) blue(-255 - 255) saturation(0 - 255)(optional)(default: 0)

Compatibility
Methods aliased:

• Game_Event < Game_Character
  • refresh
    

Credits and Thanks
Charlie Lee: For teaching me how.
MGCaladtogel: I did a bit of code ripping from his NeoMode7 script.

Author's Notes
Boredom makes me do this.

Terms and Conditions
Credit me, I s'pose. :P

[This was a post of a script that used to be an add-on.]

[PK8]

Heya, sorry for the bump but since this topic is already over 600 views and counting, I'm assuming somebody must have installed this by now.

It's been given the upgrade to 1.1 and now the developer can change the tone, angle, color and size of a character's (player or event) sprite with script calls.

[DerVVulfman]

Waitaminute. :mellow:

The whole actual 'WORKING' code of this script is 30 lines? That's it? :o

BTW: Nice to see that more people like us are adding all those detailed instructions into the scripts. B)

[PK8]

Character Sprite Addons VX
Version: 1.2

Introduction
Adds on additional properties from the Sprite class to character sprites which weren't included before such as Angle, Tone, Color, Mirror, Zoom_X and Zoom_Y. As of version 1.1, it also allows devs to change certain properties of character sprites.

Features

• Gives character sprites additional properties from the Sprite class such as angle, tone, color, mirror, zoom_x and zoom_y.
  
• Change the color, tone, angle and size of character sprites with script calls.
  
• 1 customization option. (See Customization section in text file.)
  

Script

Character Sprite Add-ons VX

Code:

=begin
????????????????????????????????????????????????????????????????????????????????
? Character Sprite Addons                                                      ?
? Version 1.2 by PK8                                                           ?
????????????????????????????????????????????????????????????????????????????????
????????????????????????????????????????????????????????????????????????????????
? ? Description:                                                               ?
? ?? Adds on additional properties to character sprites which weren't included ?
?    before such as Angle, Tone, Color, Mirror, Zoom_X and Zoom_Y.             ?
????????????????????????????????????????????????????????????????????????????????
? ? Features:                                                                  ?
? ?? Gives character sprites additional properties from the Sprite class such  ?
? ?  as angle, tone, color, mirror, zoom_x and zoom_y.                         ?
? ?? Change the angle, size, color, tone of a character sprite as well as      ?
?    flipping it horizontally with script calls. (New to Version 1.1)          ?
????????????????????????????????????????????????????????????????????????????????
? ? Customization                                                              ?
? ?? For those who don't like how in the zoom functions, the value 1.0         ?
?    signifies "actual pixel size", I've changed it a bit to make the value    ?
?    100.0 signify actual pixel size. For those who may not like the update,   ?
?    you can disable this by jumping to the third line after this long box     ?
?    and set CharacterSpriteZoom100 to false.                                  ?
????????????????????????????????????????????????????????????????????????????????
? ? Usage:                                                                     ?
? ? ? Tones.                                                                   ?
? ?? How do I change the tone of the player's sprite?                          ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace red green blue saturation with values):          ?
? ?        $game_player.tone = Tone.new(red, green, blue(, sat))                  ?
? ?        return true                                                         ?
? ?? How do I change the tone of an event's sprite?                            ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace id with an event id):                            ?
? ?        $game_map.events[id].tone = Tone.new(red, green, blue(, sat))       ?
? ?        return true                                                         ?
? ?? Example usage? I may still be confused.                                   ?
? ?     $game_player.tone = Tone.new(100, 100, 100, 255);return true           ?
? ?     $game_player.tone = Tone.new(-64, 0, -64, 0);return true               ?
? ?     $game_player.tone = Tone.new(-64, 0, -64);return true                  ?
? ?                                                                            ?
? ? ? Angles.                                                                  ?
? ?? How do I change the angle of the player's sprite?                         ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace angle with a value):                             ?
? ?        $game_player.angle = value                                          ?
? ?? How do I change the angle of an event's sprite?                           ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace angle with a value, id with an event id):        ?
? ?        $game_map.events[id].angle = value                                  ?
? ?                                                                            ?
? ? ? Colors.                                                                  ?
? ?? How do I change the color of the player's sprite?                         ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace red green blue alpha with values):               ?
? ?        $game_player.color = Color.new(red, green, blue(, alpha))           ?
? ?        return true                                                         ?
? ?? How do I change the angle of an event's sprite?                           ?
? ?     1. Use Call script event command.                                      ?
? ?     2. Type this (replace id with an event id):                            ?
? ?        $game_map.events[id].color = Color.new(red, green, blue(, alpha))   ?
? ?        return true                                                         ?
? ?? Example usage? I may still be confused.                                   ?
? ?     $game_player.color = Color.new(100, 100, 100, 100);return true         ?
? ?     $game_player.color = Color.new(200, 0, 200, 255);return true           ?
? ?     $game_player.color = Color.new(200, 0, 200);return true                ?
? ?                                                                            ?
? ? ? zoom_x and zoom_y.                                                       ?
? ?? How do I change the sprite's x-axis zoom level?                           ?
? ?     For players: $game_player.zoom_x = value                               ?
? ?     For events: $game_map.events[id].zoom_x = value                        ?
? ?? How do I change the sprite's y-axis zoom level?                           ?
? ?     For players: $game_player.zoom_y = value                               ?
? ?     For events: $game_map.events[id].zoom_y = value                        ?
? ?                                                                            ?
? ? ? Mirror.                                                                  ?
? ?? How do I flip character sprites horizontally?                             ?
? ?     For players: $game_player.mirror = true                                ?
? ?     For events: $game_map.events[id].mirror = true                         ?
? ?? Okay, how do I unflip them?                                               ?
?       For players: $game_player.mirror = false                               ?
?       For events: $game_map.events[id].mirror = false                        ?
????????????????????????????????????????????????????????????????????????????????
? ? Methods Aliased:                                                           ?
? ?? update - Sprite_Character < Sprite_Base                                   ?
? ?? initialize - Game_Character                                               ?
????????????????????????????????????????????????????????????????????????????????
? ? Changelog:                                                                 ?
? ?? Version 1.1 (5/10/09) - Replaced attr_reader with attr_accessor.          ?
? ?? Version 1.2 (5/12/09) - Updated the zoom stuff. (More info below)         ?
????????????????????????????????????????????????????????????????????????????????
? ? About Version 1.2 change:                                                  ?
?   Originally, the value '1.0' for properties zoom_x and zoom_y stood for     ?
?   the character sprite's actual size. I felt like trying to explain that in  ?
?   the instructions of this script and add-ons made to it would just confuse  ?
?   some people. So I wanted to make the value 100.0 denote the actual pixel   ?
?   size of the sprite.                                                        ?
????????????????????????????????????????????????????????????????????????????????
=end

#???????????????????????????????????????????????????????????????????????????????
#? ? Customize                                                                 ?
#???????????????????????????????????????????????????????????????????????????????
class PK8
  CharacterSpriteZoom100 = true
  # If false, sprite's zoom level value 1.0 would denote actual pixel size.
  # If true, sprite's zoom level value 100.0 would denote actual pixel size.
end

#==============================================================================
# ** Sprite_Character
#------------------------------------------------------------------------------
#  This sprite is used to display characters. It observes a instance of the
# Game_Character class and automatically changes sprite conditions.
#==============================================================================
class Sprite_Character < Sprite_Base
  alias pk8_character_sprite_addons_update :update

  #--------------------------------------------------------------------------
  # * Frame Update
  #--------------------------------------------------------------------------
  def update
    pk8_character_sprite_addons_update
    self.tone = @character.tone
    self.angle = @character.angle
    if PK8::CharacterSpriteZoom100 == true
      self.zoom_x = @character.zoom_x / 100.0
      self.zoom_y = @character.zoom_y / 100.0
    elsif PK8::CharacterSpriteZoom100 == false
      self.zoom_x = @character.zoom_x
      self.zoom_y = @character.zoom_y
    end
    self.mirror = @character.mirror
    self.color = @character.color
  end
end

#==============================================================================
# ** Game_Character
#------------------------------------------------------------------------------
#  This class deals with characters. It's used as a superclass of the
# Game_Player and Game_Event classes.
#==============================================================================
class Game_Character
  #--------------------------------------------------------------------------
  # * Public Instance Variables
  #--------------------------------------------------------------------------
  attr_accessor :tone
  attr_accessor :angle
  attr_accessor :zoom_x
  attr_accessor :zoom_y
  attr_accessor :mirror
  attr_accessor :color
  
  alias pk8_character_sprite_addons_initialize :initialize
  #--------------------------------------------------------------------------
  # * Frame Update
  #--------------------------------------------------------------------------
  def initialize
    pk8_character_sprite_addons_initialize
    @tone = Tone.new(0, 0, 0, 0)
    @angle = 0
    if PK8::CharacterSpriteZoom100 == true
      @zoom_x = 100.0
      @zoom_y = 100.0
    elsif PK8::CharacterSpriteZoom100 == false
      @zoom_x = 1.0
      @zoom_y = 1.0
    end
    @mirror = false
    @color = Color.new(0, 0, 0, 0)
  end
end

Instructions
Copy-paste! Also, look for any add-on topics which may link to this as a requirement for use.

FAQ

Changing the tone of a character sprite

Player:

• Use Call script event command.
  
• Type this (replace red green blue saturation with values):
  $game_player.tone = Tone.new(red, green, blue(, sat))
  return true
  

Events:

• Use Call script event command.
  
• Type this (replace id with an event id):
  $game_map.events[id].tone = Tone.new(red, green, blue(, sat))
  return true
  

Example usage of changing character sprite tone?

• $game_player.tone = Tone.new(100, 100, 100, 255)
  return true
  
• $game_player.tone = Tone.new(-64, 0, 64, 0)
  return true
  
• $game_player.tone = Tone.new(-64, 0, 64)
  return true
  

Changing the color of a character sprite.

Player:

• Use Call script event command.
  
• Type this (replace red green blue alpha with values):
  $game_player.color = Color.new(red, green, blue(, alpha))
  return true
  

Events:

• Use Call script event command.
  
• Type this (replace id with an event id):
  $game_map.events[id].color = Color.new(red, green, blue(, alpha))
  return true
  

Example usage of changing character sprite color?

• $game_player.color = Color.new(100, 100, 100, 100)
  return true
  
• $game_player.color = Color.new(200, 0, 200, 255)
  return true
  
• $game_player.color = Color.new(200, 0, 200)
  return true
  

Changing the angle of a character sprite

Players:
$game_player.angle = value

Events:
$game_map.events[id].angle = value

Changing the x-axis and y-axis zoom level of a character sprite

Player:
$game_player.zoom_x = value
$game_player.zoom_y = value

Events:
$game_map.events[id].zoom_x = value
$game_map.events[id].zoom_y = value

Flipping character sprite horizontally

Players:
$game_player.mirror = boolean

Events
$game_map.events[id].mirror = boolean
* boolean meaning either true or false.

Compatibility
This aliases the following methods from the following classes.

• Sprite_Character < Sprite_Base
  • update
    
• Game_Character
  • initialize
    

Author's Notes
I want scripters to add on to it. :3

Terms and Conditions
It's not necessary to credit me for this.

------------------------------

Add-ons
Event Tone, Angle, Color, Mirror and Size comment commands.

[old vx version of the script was here]

[Alpha-Mad]

Hey hey! Not bad! I may incorporate this (at least the size and mirror ones). This would be great for monsters that grow in size before attacking and such.

[Rylius]

I like this, tho I dont have any uses for it atm. =/
Antialiasing would be f'king awesome, but as far as I know it's slow as hell in RGSS. And I dont have a clue how to do it. o.o
But who knows, maybe something for next version? ~.^

[PK8]

This script has gotten a major update!

v2: Both the Event Angle/Color/Mirror/Tone/Zoom/Wave and the Change Character Properties in frames script were combined into one script. New script calls were thrown in too.

v2.1: Added the optional truth value relative argument for all methods. Useful if you want to add ontosubtract from a character property.

[PK8]

I just updated the script to v2.1.1

This update improves the documentation, reduces the code by about a hundred lines, and provides some improvements to the documentation. If you're using the VX version, it's imperative that you update it. There was a game-breaking bug in there.

Edit: Just updated the script to v2.2
Now users can use arrays for setting tone/colors or changing them in frames.
To VX users: If you're still using v2.1, please update it.