object.fill

Overview

For object fills, Corona uses the concept of paint. The fill of a shape refers to the interior area of the shape. When you assign a paint to a fill, you control how the interior area of the shape is rendered.

Paint Types

• Paint — solid color fills/strokes.
• BitmapPaint — used to fill/stroke an object with an image.
• CompositePaint — used for multi-texture fills/strokes.
• GradientPaint — used for linear gradient fills/strokes.
• ImageSheetPaint — used to fill/stroke an object with an image sheet frame.
• Camera Source — used to fill an object with the device camera source (iOS-only).

Examples

local paint = { 1, 0, 0.5 }
local rect = display.newRect( 200, 300, 300, 300 )
rect.fill = paint

local paint = {
    type = "image",
    filename = "texture1.png"
}

local rect = display.newRect( 200, 200, 300, 300 )
rect.fill = paint

local paint = {
    type = "composite",
    paint1 = { type="image", filename="wood.png" },
    paint2 = { type="image", filename="dust.png" }
}

local rect = display.newRect( 200, 200, 300, 300 )
rect.fill = paint
rect.fill.effect = "composite.average"

local paint = {
    type = "gradient",
    color1 = { 1, 0, 0.4 },
    color2 = { 1, 0, 0, 0.2 },
    direction = "down"
}

local rect = display.newRect( 200, 200, 300, 300 )
rect.fill = paint

local options =
{
    width = 40,
    height = 100,
    numFrames = 8,
    sheetContentWidth = 160,  -- width of original 1x size of entire sheet
    sheetContentHeight = 200  -- height of original 1x size of entire sheet
}
local imageSheet = graphics.newImageSheet( "textures.png", options )

local paint = {
    type = "image",
    sheet = imageSheet,
    frame = 2
}

local rect = display.newRect( 200, 200, 300, 300 )
rect.fill = paint

if ( system.getInfo("environment") ~= "simulator" ) then
    display.setDefault( "cameraSource", "front" )   --front-facing camera
    --display.setDefault( "cameraSource", "back" )  --back-facing camera
end

local rect = display.newRect( 200, 200, 300, 300 )
rect.fill = { type = "camera" }