EST - EVENT GRAPHIC SHIFT

v1.0 2015.10.29 Initial Release
v1.1 2015.10.30 improved regexp so we can also use , to separate the x and y
fix bug when erasing event.
v1.2 2015.11.01 - fix crash when no event page met condition... v1.3 2015.11.12 - add z to the graphic shift. so you can make event that on top of other event.
fix regexp so it recognize <graphic_shift: 1,2,3> (coma without spaces)
v1.4 2015.11.23 - ability to flip / rotate the graphic. using comment tag:
<graphic_flip_h> => flip graphic horizontally
<graphic_flip_v> => flip graphic vertically
<graphic_rotation: x> => rotate graphic by x degree
ability to flip / rotate the graphic using script call / plugin call:
script call:
this.thisEventChangeFlipH(true); //=> will flip graphic horizontally
this.thisEventChangeFlipH(false); //=> will cancel flip graphic horizontally
this.thisEventChangeFlipV(true); //=> will flip graphic vertically
this.thisEventChangeFlipV(false); //=> will cancel flip graphic vertically
this.thisEventChangeRotation(x); //=> will rotate graphic by x degree
plugin call:
this_event_change_fliph true //=> will flip graphic horizontally
this_event_change_fliph false //=> will cancel flip graphic horizontally
this_event_change_flipv true //=> will flip graphic vertically
this_event_change_flipv false //=> will cancel flip graphic vertically
this_event_change_rotation x //=> will rotate graphic by x degree
v1.5 2015.11.23 - ability to change graphic offset x and y using scriptcall / plugin call:
script call:
this.thisEventChangeOffsetX(value); //=> will set offset x to value
this.thisEventChangeOffsetY(value); //=> will set offset y to value
plugin call:
this_event_change_offsetx value; //=> will set offset x to value
this_event_change_offsety value; //=> will set offset y to value

v1.6 2015.12.01 - > ability to change graphic offset z using scriptcall / plugin call:
> Notetags/Commenttags to change event zoom (default zoom too), scale x, scale y
> ability to change event zoom / scale x / scale y using scriptcall / plugin call:
> ability to change event opacity
Below CAN be turned OFF if you don't use it...
> ability to change blend color(warning: chrome not supported)
> ability to change tone color (warning: chrome not supported)

add Comment at the event page you want the graphic to shift
<graphic_shift: offsetx offsety offset z>
example:
<graphic_shift: 32 -32, 2>
<graphic_shift: 32, -32> (from v1.1 this work too)
<graphic_shift: 32 , -32> (from v1.1 this work too)
<graphic_shift: 32 ,-32> (from v1.1 this work too)

will shift the graphic x by +32 pixel (go to right 32 pixel)
will shift the graphic y by -32 pixel (go to down 32 pixel)
will shift the graphic z by adding 2 z level so it will be on top of event with lower z value

tips by default event z = event priority type * 2 + 1
> below character = 0 => 0*2+1 = 3
> same as character = 1 => 1*2+1 = 3
> above character = 2 => 2*2+1 = 5
> [Tile] Event (ignore above 3 setting) = 0 => 0*2+1 = 1
so if you add 2... the final z level will be added by value from default event z
if you want to reduce z level. use negative value.

some z level references:
shadow = 6
balloon = 7
animation = 8
mouse destination sprite = 9
source : rpg_sprites.js

if you only want to shift x value you could do fine with not entering the offsety value
or offset z.
example:
<graphic_shift: 32>
> new comment tag for flipping / rotating event graphic
give comment tag:
<graphic_flip_h> => flip graphic horizontally
<graphic_flip_v> => flip graphic vertically
<graphic_rotation: x> => rotate graphic by x degree

> ability to flip / rotate the graphic using script call / plugin call:
script call:
this.thisEventChangeFlipH(true); //=> will flip graphic horizontally
this.thisEventChangeFlipH(false); //=> will cancel flip graphic horizontally
this.thisEventChangeFlipV(true); //=> will flip graphic vertically
this.thisEventChangeFlipV(false); //=> will cancel flip graphic vertically
this.thisEventChangeRotation(x); //=> will rotate graphic by x degree
plugin call:
this_event_change_fliph true //=> will flip graphic horizontally
this_event_change_fliph false //=> will cancel flip graphic horizontally
this_event_change_flipv true //=> will flip graphic vertically
this_event_change_flipv false //=> will cancel flip graphic vertically
this_event_change_rotation x //=> will rotate graphic by x degree

> ability to change graphic offset x and y using scriptcall / plugin call:
script call:
this.thisEventChangeOffsetX(value); //=> will set offset x to value
this.thisEventChangeOffsetY(value); //=> will set offset y to value
plugin call:
this_event_change_offsetx value; //=> will set offset x to value
this_event_change_offsety value; //=> will set offset y to value

> ability to change graphic offset z using scriptcall / plugin call:
script call:
this.thisEventChangeOffsetZ(value); //=> will set offset z to value
plugin call:
this_event_change_offsetz value; //=> will set offset z to value

> Notetags/Commenttags to change event zoom (default zoom too), scale x, scale y
to make all event in a map to have specific default zoom level...
give notetags to MAP NOTE:
<event_zoom: value>
will zoom all map event [value] times from normal (can be changed individually
by comment tag / script call / plugin call)

to change specific event page zoom level give comment tag:
<graphic_zoom: value> -> will zoom event by [value] times (both x and y affected)
<graphic_scalex: value> -> will only affect x zoom (become fat/thin :D )
<graphic_scaley: value> -> will only affect y zoom (become short/tall :D )

> ability to change event zoom /scale x / scale y using scriptcall / plugin call:
script call:
this.thisEventChangeScaleX(value);
this.thisEventChangeScaleY(value);
this.thisEventChangeZoom(value);
change value to any number. if you want to use decimal. use
1.5 instead of 1,5

plugin call:
this_event_change_scalex value
this_event_change_scaley value
this_event_change_zoom value
change value to any number. if you want to use decimal. use
1.5 instead of 1,5

> comment tag to set event page opacity
<graphic_opacity: value>
change value to number between 0-255 (255 is solid, 0 is transparent)

> ability to change event opacity using script call / plugin call:
script call:
this.thisEventChangeOpacity(value);
plugin call:
this_event_change_opacity value

will set event opacity to value

WARNING !!! BELOW IS NOT SUPPORTED IN CHROME... it will show black image instead.
THIS FEATURE CAN ALSO BE TURNED OFF IF YOU DON'T WANT TO USE IT... CHANGE IN PLUGIN PARAMETER
IF YOU TURN IT OFF THAT MEAN LESS CHECK AND FASTER SPEED.

> comment tag to set event page blend color (warning: chrome not supported)
<graphic_blend: red, green, blue, alpha>
red => 0-255 (need alpha to show effect)
green => 0-255 (need alpha to show effect)
blue => 0-255 (need alpha to show effect)
alpha => 0-255 (strength of the blend... lower value will make it not seen)

> ability to change blend color by script call / plugin call(warning: chrome not supported)
script call:
this.thisEventChangeBlend(red,green,blue,alpha)
plugin call:
this_event_change_blend red green blue alpha

red => 0-255 (need alpha to show effect)
green => 0-255 (need alpha to show effect)
blue => 0-255 (need alpha to show effect)
alpha => 0-255 (strength of the blend... lower value will make it not seen)

> comment tag to set event page tone color (warning: chrome not supported)
<graphic_tone: red, green, blue, alpha>
red => 0-255 (need alpha to show effect)
green => 0-255 (need alpha to show effect)
blue => 0-255 (need alpha to show effect)
alpha => 0-255 (strength of the blend... lower value will make it not seen)

> ability to change tone color via script call / plugin call (warning: chrome not supported)
script call:
this.thisEventChangeTone(red,green,blue,alpha)
plugin call:
this_event_change_tone red green blue alpha
red => 0-255 (need alpha to show effect)
green => 0-255 (need alpha to show effect)
blue => 0-255 (need alpha to show effect)
alpha => 0-255 (strength of the blend... lower value will make it not seen)