Pixel

From GiderosMobile
Revision as of 14:30, 13 July 2023 by Hgy29 (talk | contribs) (Text replacement - "<source" to "<syntaxhighlight")

Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2016.06
Inherits from: Sprite

Description

A rectangular Sprite which can be filled with solid colors, gradients or textures. Pixel aims at being a simpler and faster alternative to Shape when needing to display a coloured box or box with a gradient. It is also useful as Bitmap replacement since every texture will be fitted into Pixel dimensions automatically.

Examples

<syntaxhighlight lang="lua"> local mypixel = Pixel.new(0x0000FF, 0.75, 128, 128) mypixel:setAnchorPoint(0.5, 0.5) mypixel:setPosition(application:getContentWidth() / 2, 64)

stage:addChild(mypixel) </source>

<syntaxhighlight lang="lua"> application:setBackgroundColor(0x323232) local p = Pixel.new(0xffffff, 1, 32, 32)

p:set("redMultiplier", 1) -- OK p:set("greenMultiplier", 0) -- OK p:set("blueMultiplier", 0) -- OK p:set("alphaMultiplier", 1) -- OK --p:set("anchorX", .5) -- NOT OK --p:set("anchorY", .5) -- NOT OK p:set("anchorX", 16) -- OK p:set("anchorY", 16) -- OK p:set("alpha", .5) -- OK p:set("scaleX", 1.5) -- OK p:set("rotation", 10) -- OK p:set("x", 32) -- OK p:set("y", 32) -- OK

stage:addChild(p) </source>

Methods

Pixel.new creates a new Pixel
Pixel.new constructor to create a Pixel with texture in letterbox mode
Pixel:getColor returns the color(s) of the Pixel
Pixel:getDimensions returns the current size of the Pixel
Pixel:getTexturePosition returns the texture position
Pixel:getTextureScale returns the texture scale
Pixel:setColor sets the color of the Pixel
Pixel:setColor sets a gradient
Pixel:setColor sets a 4-colour gradient
Pixel:setDimensions sets both width and height of the Pixel
Pixel:setHeight sets the height of the Pixel sprite
Pixel:setNinePatch sets a 9-patch style texture rendering
Pixel:setTexture attaches a texture to the Pixel
Pixel:setTextureMatrix specifies a transform matrix for the texture
Pixel:setTexturePosition sets a texture position
Pixel:setTextureScale sets a texture scale
Pixel:setWidth sets the width of the Pixel sprite

Events

Constants