imggen

A shell script to create simple placeholder images, like you might use for textures.

Setup

Requires ImageMagick, which you can get via your system package manager.

macOS

On macOS you can get ImageMagick via brew:

brew install imagemagick

Linux

On Linux you can use apt-get or the relevant package manager for your distribution:

sudo apt-get install imagemagick

Linking

After installing, I'd recommend symlinking this to /usr/local/bin:

ln -s /path/to/original/imggen /usr/local/bin/imggen

Usage

Create an image with 1024x512 resolution and save it as some_image.png.

imggen -s 1024x512 -o some_image

Shorthand to create a square image and save it as out.png.

imggen 256

Additional settings:

Usage: imggen [-s 256x512] [-o 10] [-p 16] [-sw 4] [-fs 24]
              [-fg white] [-bg orange] [-f Arial] [-t Placeholder]
              [-out out]
       imggen 256

Options:
  -h   --help          Print this help info and exit
  -s   --size          Set to width x height of desired output
  -o   --offset        Distance from inner box to edge of image
  -p   --plus          Width and height of center indicator
  -sw  --stroke-width  Width of stroke of all lines
  -fs  --font-size     Size of font
  -fg  --foreground    Color of text, square, center indicator
  -bg  --background    Color of background
  -f   --font          Name of font to use for text
  -t   --text          String to display over size information
  -out --out-file      Name of output file (no extension)
  -ds  --dim-suffix    Whether or not to add dimension suffix to filename

Output

Todo

• Make this available via Homebrew with dependencies
• Better font size handling
• More unit tests
• Optional grid patterns

License

© 2017 Steve Richey. Shared under an MIT license. See license.md for details.