Skip to content

generate a signed distance field from an image

License

Notifications You must be signed in to change notification settings

ElonGame/image-sdf

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

image-sdf

stable

Command-line tool which takes a 4-channel RGBA image and generates a signed distance field. The bitmask is determined by pixels with alpha over 128 and any RGB channel over 128.

img1

# install the tool
npm install image-sdf -g

# apply the effect on an image
# and pipe it to a new file
image-sdf atlas.png --spread 32 --downscale 2 > atlas-sdf.png

The code has been adpated from libgdx.

PRs welcome. This could be split into more modules (generating a bit mask, computing SDF, better image support, etc).

Usage

NPM

image-sdf input.png [opt]

Options:
  -o, --output     output file                                    
  -s, --spread     distance spread amount, default 1              
  -d, --downscale  amount to downscale the output, default 1      
  -c, --color      output color, accepts css strings, default #fff
  -h               Show help                                      

Examples:

image-sdf input.png -c "rgb(128,255,20)" -s 10 -o output.png
image-sdf input.png --spread 2 --downscale 2 > output.png
image-sdf input.png --color black -o build/output.png

The programmatic API may evolve into their own modules, i.e. for custom bitmasks.

License

MIT, see LICENSE.md for details.

About

generate a signed distance field from an image

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%