Type Function Object ShapeObject Library display.* Return value none Revision Release 2023.3686 Keywords setFillVertexColor, vertex color, fill, vector See also [object:setStrokeVertexColor()][api.type.ShapeObject.setVertexStrokeColor] display.newRect() display.newRoundRect() display.newCircle() display.newText() display.newPolygon()
Sets the color of a particular fill vertex in vector and text objects. Also applies a tint to image objects.
Until a given fill vertex color has been assigned, it is interpreted as white. The color/tint of the object at each vertex is a combination of its fill color and fill vertex color: the two red values multiplied together produce the final red, and so on for the remaining channels. When the object is drawn, the resulting colors/tints are interpolated between neighboring vertices.
The first time this is called on an object, some extra memory will be allocated to it to store the colors.
object:setFillVertexColor( index, gray ) object:setFillVertexColor( index, gray, alpha ) object:setFillVertexColor( index, red, green, blue ) object:setFillVertexColor( index, red, green, blue, alpha )
Numbers Integer from 1 to object.fillVertexCount indicating which fill vertex to color.
In the case of meshes, many methods operate on vertices. In those instances and here, index refers to the same vertex. (TODO Other shapes. At this point the details are unlikely to change; none of it is written down though.)
Numbers. Numbers between 0 and 1 that represent the corresponding value for that channel. alpha represents the opacity of the fill color/tint.
If you are passing a table of color values to this function, the table must be unpacked so that the color values are dictated properly:
local myText = display.newText( "hello", 0, 0, native.systemFontBold, 12 )
local colorTable = { 1, 0, 0, 0.5 }
myText:setFillVertexColor( 2, unpack(colorTable) )
local vertices = { 0,-110, 27,-35, 105,-35, 43,16, 65,90, 0,45, -65,90, -43,15, -105,-35, -27,-35 }
local star = display.newPolygon( 300, 300, vertices )
star:setFillVertexColor( 3, 1, 0.2, 0.2 )
local myText = display.newText( "hello", 0, 0, native.systemFontBold, 12 ) myText:setFillVertexColor( 2, 1, 0.2, 0.2 )
local image = display.newImage( "image.png" ) image:setFillVertexColor( 3, 0.72, 0.9, 0.16, 0.78 ) -- Tints vertex #3 of image green