blenderskool / pigmnts Goto Github PK

View Code? Open in Web Editor NEW

66.0 3.0 3.0 336 KB

🎨 Color palette generator from an image using WebAssesmbly and Rust

Home Page: https://pigmnts.web.app

License: MIT License

Rust 100.00%

color-palette pigments rust kmeans web-assembly wasm color-quantization

pigmnts's Introduction

Hey there 👋
I'm

About 🌏

I build innovative and useful products on the web with great user experience.
I'm curious about how things work and often try to learn by breaking them apart.

Work 🔭

Software development engineer at Razorpay (Present).
Software development engineering intern at Razorpay in spring 2022.
Software engineering intern at Akamai Technologies in summer 2021.
Frontend engineering intern at smallcase in summer 2020.
Building Slant it and Blaze in my free time.

Current Interests 🌱

React
Typescript
Tailwind CSS
Graph Theory
Compiler Design
Generic Programming

Ask me about 💬

Frontend development
UI design
Open source

Get in touch 📫

Mail: [email protected]
Personal site: akashhamirwasia.com

Fun facts ⚡

I occasionally work on 3D graphics with Blender
I enjoy playing Tennis 🎾

Amazing folks who sponsor my work 💚

_{Shivay Lamba}

_{Aniruddha Mysore}

pigmnts's People

Contributors

Stargazers

Watchers

Forkers

khairulaffandy srujandeshpande vemilyus

pigmnts's Issues

Segmentation Fault

Hey!

I'm getting a segmentation fault on a M1 Macbook Pro running Sonoma 14.0.

pigmnts test.png -xrd
Creating a palette of 5 colors from test.png
⠸
[1]    16785 segmentation fault  pigmnts test.png -xrd

Any logs I can check to see how to fix this?

Handle errors when unsupported file is chosen

Appropriate error handling when a file with an unsupported file format is encountered. This is mainly due to the limitations in the file formats supported by image-rs

Add flags for other color formats

The color palette in other color formats (currently RGB, HSL, L*AB) can be displayed on-demand by enabling appropriate flags.

Try L*ab color space

L*ab color space resembles humans' perception of colors. It may give better results compared to RGBA.

Publish pigmnts-cli on crates.io

Currently only the lib crate is available on crates.io can you please publish the cli to ?

Use conditional compilation

Conditional compilation using cfg can be used to separate the code specifically written for WebAssembly.

Update README

Update the README with the updated return of pigments_pixels function

Improve README for contributors

README does not have info on how to go about contributing and setting up this project locally.

Add color names

Colors in the palette could provide the nearest name from a color dictionary. https://github.com/meodai/color-names seems like a great starting point

Median cut algorithm

Experiment with the Median cut algorithm to extract the color palette.

Reference: https://spin.atomicobject.com/2016/12/07/pixels-and-palettes-extracting-color-palettes-from-images/

Structure output as a table

The output can be shown as a table that can display information in a more structured way.
This library looks promising https://github.com/phsym/prettytable-rs

Add examples in README

Examples on how to use the package in WASM can be added to the README

Pigmnts causes problems with Glowforge

When running the Pigmnts add-on, interactions on app.glowforge.com are negatively affected. Mouseover events on certain interface elements (such as the zoom in/out buttons) cause the entire screen to go white.

This may be a highly-specific problem, but it could also be an indication that the Pigmnts add-on causes issues on other sites.

Some of the errors from the console:

Saga Stack: undefined fs.js:3:18231

Add validation so that only allow images

Currently one can upload any file type, I think it should be restricted to only images
If I upload a pdf (any other type) the loader didn't stop.

I would like to fix this.

Add support for HTTP image URLs

CLI could allow usage of HTTP and HTTPS image URLs where the image is fetched in the memory and then the palette is created from it

Isomorphic npm package

The library published on npm works only on the client-side. Support for the pigmnts library on server-side using Node.js can be implemented considering following points:

pigments_node() function can be implemented that is compatible with Node.js and does not depend on Browser APIs like canvas.
The existing pigments() function may depend on pigmnts_node() function making it easier to interact with the library on the client-side by abstracting canvas APIs.
Appropriate build system to create a single isomorphic package. wasm-pack supports multiple outputs targets, but combining them under a single package is a little messy. Hoping for this to be merged rustwasm/wasm-pack#705

Implement a CLI

pigmnts library can be used to build a CLI tool that can extract a color palette from an image.

Add support for other color formats

The results of the palette generated is in RGBA format (hex color in WASM).
Support for more color formats like HSL, L*ab, CMYK would be useful

CLI on Windows

CLI does not work on Windows since termion doesn't support Windows.

Add multiple files support in CLI

CLI should support multiple files in a single command.

Update README to include CLI

README should include information related to the CLI

Add Ubuntu 16.04 environment to CI

Pigmnts CLI is currently compiled for Ubuntu 18.04. Ubuntu 16.04 can also be added in the outputs

Add functionality for weighted means

Allow option to introduce weights during the calculation of new mean color during kmeans++

Sort based on dominance

The generated colors could be sorted based on its dominance in the image. Or even better, return the colors along with their dominance as a percentage.

Use threads for data parallelism

K-means (and K-means++) involve a lot of synchronous tasks which makes it difficult to achieve task parallelism. However, data parallelism may be achieved to improve the performance of certain areas in the process. MapReduce technique can be applied as a starting point in the Assignment step of the algorithm.

For the time being, this could be implemented using native std::thread and WebAssembly support can be thought of a little later once any improvements using threads are observed.

Output as HTML

CLI could output the palette as a HTML file. This would make it easy to preview the colors in the palette on terminals that don't support true colors.

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.