Löve Frames - The Image Object
Return to Index
Information
The image object is basically just an image with customizable color.
Example Use
local frame = loveframes.Create("frame")
frame:SetName("Image")
frame:SetSize(138, 315)
frame:CenterWithinArea(unpack(demo.centerarea))
local image = loveframes.Create("image", frame)
image:SetImage("resources/images/carlsagan.png")
image:SetPos(5, 30)
local panel = loveframes.Create("panel", frame)
panel:SetPos(5, 160)
panel:SetSize(128, 150)
local text1 = loveframes.Create("text", panel)
text1:SetPos(5, 5)
text1:SetText("Orientation: ")
local slider1 = loveframes.Create("slider", panel)
slider1:SetPos(5, 20)
slider1:SetWidth(118)
slider1:SetMinMax(0, 360)
slider1:SetDecimals(0)
slider1.OnValueChanged = function(object)
image:SetOrientation(object:GetValue())
end
text1.Update = function(object, dt)
object:SetText("Orientation: " ..slider1:GetValue())
end
local text2 = loveframes.Create("text", panel)
text2:SetPos(5, 40)
text2:SetText("Scale")
local slider2 = loveframes.Create("slider", panel)
slider2:SetPos(5, 55)
slider2:SetWidth(118)
slider2:SetMinMax(1, 2)
slider2:SetDecimals(5)
slider2.OnValueChanged = function(object)
image:SetScale(object:GetValue(), object:GetValue())
end
text2.Update = function(object, dt)
object:SetText("Scale: " ..slider2:GetValue())
end
local text3 = loveframes.Create("text", panel)
text3:SetPos(5, 75)
text3:SetText("Offset")
local slider3 = loveframes.Create("slider", panel)
slider3:SetPos(5, 90)
slider3:SetWidth(118)
slider3:SetMinMax(1, 50)
slider3:SetDecimals(5)
slider3.OnValueChanged = function(object)
image:SetOffset(object:GetValue(), object:GetValue())
end
text3.Update = function(object, dt)
object:SetText("Offset: " ..slider3:GetValue())
end
local text4 = loveframes.Create("text", panel)
text4:SetPos(5, 110)
text4:SetText("Shear")
local slider4 = loveframes.Create("slider", panel)
slider4:SetPos(5, 125)
slider4:SetWidth(118)
slider4:SetMinMax(0, 10)
slider4:SetDecimals(5)
slider4.OnValueChanged = function(object)
image:SetShear(object:GetValue(), object:GetValue())
end
text4.Update = function(object, dt)
object:SetText("Shear: " ..slider4:GetValue())
end
Event Callbacks
The image object has no unique event callbacks.
Methods
SetImage - Sets the object's image
- Note: The argument in this function can be a path to an image or an image already created with love.graphics.newImage.
- Returns 1 value: image [image]
- Returns 4 values: r [number], g [number], b [number], a [number]
- Returns 1 value: orientation [number]
- Returns 1 value: scalex [number]
- Returns 1 value: scaley [number]
- Returns 2 values: scalex [number], scaley [number]
- Returns 1 value: offsetx [number]
- Returns 1 value: offsety [number]
- Returns 2 value: offsetx [number], offsety [number]
- Returns 1 value: shearx [number]
- Returns 1 value: sheary [number]
- Returns 2 values: shearx [number], sheary [number]
- Returns 2 values: imagewidth [number], imageheight [number]
- Returns 1 value: imagewidth [number]
- Returns 1 value: imageheight [number]
- Note: The argument in this function can be a path to an image or an image already created with love.graphics.newImage.
object:SetImage(image[string or image])GetImage - Gets the object's image
- Returns 1 value: image [image]
local image = object:GetImage()SetColor - Sets the objects color
object:SetColor(r[number], g[number], b[number], a[number])GetColor - Gets the objects color
- Returns 4 values: r [number], g [number], b [number], a [number]
local r, g, b, a = object:GetColor()SetOrientation - Sets the objects orientation
object:SetOrientation(orientation[number])GetOrientation - Gets the objects orientation
- Returns 1 value: orientation [number]
local orientation = object:GetOrientation()SetScaleX - Sets the object's x scale
object:SetScaleX(scalex[number])GetScaleX - Gets the object's x scale
- Returns 1 value: scalex [number]
local scalex = object:GetScaleX()SetScaleY - Sets the object's y scale
object:SetScaleY(scaley[number])GetScaleY - Gets the object's y scale
- Returns 1 value: scaley [number]
local scaley = object:GetScaleY()SetScale - Sets the object's x and y scale
object:SetScale(scalex[number], scaley[number])GetScale - Gets the object's x and y scale
- Returns 2 values: scalex [number], scaley [number]
local scalex, scaley = object:GetScale()SetOffsetX - Sets the object's x offset
object:SetOffsetX(offsetx[number])GetOffsetX - Gets the object's x offset
- Returns 1 value: offsetx [number]
local offsetx = object:GetOffsetX()SetOffsetY - Sets the object's y offset
object:SetOffsetY(offsety[number])GetOffsetY - Gets the object's y offset
- Returns 1 value: offsety [number]
local offsety = object:GetOffsetY()SetOffset - Sets the object's x and y offsets
object:SetOffset(offsetx[number], offsety[number])GetOffset - Gets the object's x and y offsets
- Returns 2 value: offsetx [number], offsety [number]
local offsetx, offsety = object:GetOffset()SetShearX - Sets the object's x shear
object:SetShearX(shearx[number])GetShearX - Gets the object's x shear
- Returns 1 value: shearx [number]
local shearx = object:GetShearX()SetShearY - Sets the object's y shear
object:SetShearY(sheary[number])GetShearY - Gets the object's y shear
- Returns 1 value: sheary [number]
local sheary = object:GetShearY()SetShear - Sets the object's x and y shear
object:SetShear(shearx[number], sheary[number])GetShear - Gets the object's x and y shear
- Returns 2 values: shearx [number], sheary [number]
local shearx, sheary = object:GetShear()GetImageSize - Gets the object's image size
- Returns 2 values: imagewidth [number], imageheight [number]
local imagewidth, imageheight = object:GetImageSize()GetImageWidth - Gets the object's image width
- Returns 1 value: imagewidth [number]
local imagewidth = object:GetImageWidth()GetImageHeight - Gets the object's image height
- Returns 1 value: imageheight [number]
local imageheight = object:GetImageHeight()