Images
wraith.images loads pictures and draws them in your windows. Wraith holds them on the GPU for you, in the overlay and anywhere else they get drawn.
Load one
Section titled “Load one”images.load takes a path in your plugin’s folder. It reads and decodes the file on a worker, so the game doesn’t stall, and gives you a promise to await in a task.
local wraith = require("wraith")local frame, images, ui = wraith.frame, wraith.images, wraith.ui
local logo = images.load("logo.png"):await()
frame.onFrame(function() ui.window("Logo", function() logo:draw() -- its own size logo:draw({ fit = "width" }) -- as wide as the window, same shape logo:draw({ width = 64, height = 64, fit = "contain" }) -- inside 64 by 64 ui.image(logo, { tint = { 1, 0.5, 0.5, 1 } }) -- same thing, tinted end)end)It reads PNG, JPEG, BMP, TGA and the first frame of a GIF. Sides over 16384 pixels get refused. A file that’s missing or isn’t an image rejects with a message saying so.
Already have the bytes? images.decode(bytes) takes them as a string and works the same way. Raw RGBA pixels go to images.create(width, height, rgba), which gives you the image right away.
logo.width and logo.height are its size in pixels.
Draw it
Section titled “Draw it”draw only works inside a UI callback, like other ui calls. Without width or height it’s its own size. With one of them it keeps its shape. fit = "contain" fits it inside both, and fit = "width" fills the window across. tint multiplies its colors.
Let it go
Section titled “Let it go”logo:destroy() frees it now. Calling it twice is fine, but drawing it after throws. Whatever you don’t destroy goes when your plugin stops. In a tweak, images go when the tweak turns off.
Made with ♥ by Asgard
