Skip to content

Image : VisualElement

This is the Image element class which can be used to display bimg formatted images. Bimg is a universal ComputerCraft image format. See: https://github.com/SkyTheCodeMaster/bimg

Properties

PropertyTypeDefaultDescription
bimgtable{}The bimg image data
currentFramenumber1Current animation frame
autoResizebooleanfalseWhether to automatically resize the image when content exceeds bounds
offsetXnumber0Horizontal offset for viewing larger images
offsetYnumber0Vertical offset for viewing larger images

Combined Properties

NamePropertiesDescription
offsetoffsetX offsetYCombined property for offsetX and offsetY

Functions

MethodReturnsDescription
Image:addFrameImageAdds a new frame to the image
Image:getBgstringGets the background color at the specified position
Image:getFgstringGets the foreground color at the specified position
Image:getFrametableGets the specified frame
Image:getImageSizenumberGets the size of the image
Image:getMetadatatableGets the metadata of the image
Image:getPixelDatanumber?Gets pixel information at position
Image:getTextstringGets the text at the specified position
Image:nextFrameImageAdvances to the next frame in the animation
Image:resizeImageImageResizes the image to the specified width and height
Image:setBgImageSets the background color at the specified position
Image:setFgImageSets the foreground color at the specified position
Image:setMetadataImageSets the metadata of the image
Image:setPixelImageSets the pixel at the specified position
Image:setTextImageSets the text at the specified position
Image:updateFrameImageUpdates the specified frame with the provided data

Protected Functions

MethodReturnsDescription
Image:initImageInitializes the Image instance
Image:render-Renders the Image

Image:addFrame()

Adds a new frame to the image

Returns

  • Image self The Image instance

Image:getBg(x, y, length)

Gets the background color at the specified position

Parameters

  • x number The x position
  • y number The y position
  • length number The length of the background color pattern to get

Returns

  • string bg The background color pattern

Image:getFg(x, y, length)

Gets the foreground color at the specified position

Parameters

  • x number The x position
  • y number The y position
  • length number The length of the foreground color pattern to get

Returns

  • string fg The foreground color pattern

Image:getFrame(frameIndex)

Gets the specified frame

Parameters

  • frameIndex number The index of the frame to get

Returns

  • table frame The frame data

Image:getImageSize()

Gets the size of the image

Returns

  • number width The width of the image
  • number height The height of the image

Image:getMetadata()

Gets the metadata of the image

Returns

  • table metadata The metadata of the image

Image:getPixelData(x, y)

Gets pixel information at position

Parameters

  • x number X position
  • y number Y position

Returns

  • number? fg Foreground color
  • number? bg Background color
  • string? char Character at position

Image:getText(x, y, length)

Gets the text at the specified position

Parameters

  • x number The x position
  • y number The y position
  • length number The length of the text to get

Returns

  • string text The text at the specified position

Image:nextFrame()

Advances to the next frame in the animation

Returns

  • Image self The Image instance

Image:resizeImage(width, height)

Resizes the image to the specified width and height

Parameters

  • width number The new width of the image
  • height number The new height of the image

Returns

  • Image self The Image instance

Image:setBg(x, y, pattern)

Sets the background color at the specified position

Parameters

  • x number The x position
  • y number The y position
  • pattern string The background color pattern

Returns

  • Image self The Image instance

Image:setFg(x, y, pattern)

Sets the foreground color at the specified position

Parameters

  • x number The x position
  • y number The y position
  • pattern string The foreground color pattern

Returns

  • Image self The Image instance

Image:setMetadata(key, value)

Sets the metadata of the image

Parameters

  • key string The key of the metadata to set
  • value string The value of the metadata to set

Returns

  • Image self The Image instance

Image:setPixel(x, y, char, fg, bg)

Sets the pixel at the specified position

Parameters

  • x number The x position
  • y number The y position
  • char string The character to set
  • fg string The foreground color pattern
  • bg string The background color pattern

Returns

  • Image self The Image instance

Image:setText(x, y, text)

Sets the text at the specified position

Parameters

  • x number The x position
  • y number The y position
  • text string The text to set

Returns

  • Image self The Image instance

Image:updateFrame(frameIndex, frame)

Updates the specified frame with the provided data

Parameters

  • frameIndex number The index of the frame to update
  • frame table The new frame data

Returns

  • Image self The Image instance

Released under the MIT License.