3waybutton

obj_uiZ_3waybutton

Button made with slightly better scaling in mind.
Has the ability of putting a sprite's images together to infinitely stretch the sprite in the horizontal direction, without it getting blurry.
Can have text on it which is only contained within the width of the button, not it's height.
The sprites can still be stretched in height, which can give a poor result.
This button looks the best if the buttons width is bigger than the buttons height.
Square sprites with a even number for the width/height work the best.

Property variables

• color[c_white]: the blend of color the button should have. (see uiz_3waybutton_setcolor function)
• alpha[1]: alpha the button should have. (function available on any uiZ object)
• text[""]: the text to draw inside the button. (see uiz_3waybutton_settext function)
• textcolor[c_black]: the color of the text to draw, if any.
• font[-1]: the font to use, a value of -1 means font will be ignored (any random font will be used).
• sprite[spr_uiZ_3partbutton]: which sprite to use to draw the button. (see uiz_3waybutton_setsprite function)
• spraddto[0]: If a sprite contains multiple buttons, this can be used to select the image index at which your button should draw. spraddto+3 (up to +5) then contains the mouse over button sprites, while spraddto+6 (up to +8) contains the mouse click button sprits. (See uiz_3waybutton_setsprite function)
• texturemode[uiz_texturemode_fill]: what texturemode the middle part of the sprite should have.

Functions

• uiz_3waybutton_setcolor(id, color): Sets the color parameter of the button.
  • id: the instance id of the instance you want to modify
  • color: see color property variable
• uiz_3waybutton_settext(id, text, textcolor, font): Sets the text of the instance.
  • id: the instance id of the instance you want to modify
  • text, textcolor, font: see property variables
• uiz_3waybutton_setsprite(id, sprite, spraddto): Sets the sprite and spraddto used of the button.
  • id: the instance id of the instance you want to modify
  • sprite, spraddto see property variables

Readable variables

• kmouseover: a value holding information about the mouse (variable available on any uiZ object)
• update: this is 1 when the mouse presses the button, else it is 0.
• updated: this is 1 when the mouse releases the button, else it is 0.

Visuals

note: For the visuals, a red button and sprite have been used, as it is easier to see.