Skip to content

Repository files navigation

!! Deprecated in favor of ViewportCanvas due to hitting Roblox UIGradient cap. If you are doing animations, however, it is still recommended to use GradientCanvas since Roblox takes too long to render ViewportCanvas and can't do animated images.

GradientCanvas

A canvas renderer using greedy gradients to draw efficiently in Roblox

image

image

API

GradientCanvas.new(ResolutionX: number, ResolutionY: number)

returns a new canvas of the specified resolution

GradientCanvas:SetParent(Parent: Instance)

parents the canvas GUI to the passed Instance

GradientCanvas:SetPixel(X: number, Y: number, Color: Color3)

Sets the color of the canvas specified pixel

GradientCanvas:Render()

renders the canvas based on the set pixels

(It will not automatically render, you must call this method when you've completed your pixel updates)

GradientCanvas:Clear()

clears the canvas render

GradientCanvas:Destroy()

cleans up the canvas and its GUIs


Demonstration

-- FrameslocalDemo=script.Parent.DemolocalRef=script.Parent.Ref-- ResolutionlocalResX, ResY=16*6, 9*6-- Create CanvaslocalCanvas=require(script.GradientCanvas).new(ResX, ResY)
Canvas:SetParent(Demo)
-- Draw pixelsforx=1, ResXdofory=1, ResYdo-- Define colorlocalv=math.sin(x/ResX) *math.cos(y/ResY)
localc=Color3.fromHSV(v, 0.9, 0.9)
-- Set in canvasCanvas:SetPixel(x, y, c)
-- Draw naively for referencelocalpixel=Instance.new("Frame")
pixel.BorderSizePixel=0pixel.BackgroundColor3=cpixel.Size=UDim2.fromScale(1/ResX, 1/ResY)
pixel.Position=UDim2.fromScale((1/ResX)*(x-1), (1/ResY)*(y-1))
pixel.Parent=Ref.Canvasendend-- Render canvasCanvas:Render()
-- Expose countsDemo.TextLabel.Text=string.format("Frames Instances: %d", Canvas._ActiveFrames)
Ref.TextLabel.Text=string.format("Frames Instances: %d", ResX*ResY)

About

A canvas renderer using greedy gradients to draw efficiently in Roblox

Resources

Stars

57 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages