quantize-luau

A fully typed Luau module for MMCQ color quantization. With added support for Color3s to be used instead of RGB arrays. Based on quantize.js and Leptonica.

Quick Overview

Usage

local Quantize = require(Path.To.Quantize)

local ArrayOfPixels = {{190,197,190}, {202,204,200}, {207,214,210}, {211,214,211}, {205,207,207}}
local MaxColors = 4

local ColorMap = Quantize(ArrayOfPixels, MaxColors)

• Pixels - An array of pixels (represented as {R,G,B arrays}) or Color3s to quantize
• MaxColors - The maximum number of colors allowed in the reduced palette, must be within 2 to 256

Reduced Palette

The :Palette() method returns an array that contains the reduced color palette.

-- Returns the reduced palette
ColorMap:Palette()
-- {{204, 204, 204}, {208,212,212}, {188,196,188}, {212,204,196}}

Reduced pixel

The :Map(Pixel) method maps an individual pixel or Color3 to the reduced color palette.

-- Returns the reduced pixel
ColorMap:Map(ArrayOfPixels[1])
-- {188,196,188}