https://github.com/transitive-bullshit/primitive-cli

CLI to reproduce images from geometric primitives.
https://github.com/transitive-bullshit/primitive-cli

art generative-art graphics primitive primitives

Last synced: about 1 month ago
JSON representation

CLI to reproduce images from geometric primitives.

• Host: GitHub
• URL: https://github.com/transitive-bullshit/primitive-cli
• Owner: transitive-bullshit
• Created: 2018-05-31T19:12:33.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2022-12-09T13:25:41.000Z (over 2 years ago)
• Last Synced: 2025-05-07T17:13:11.122Z (about 1 month ago)
• Topics: art, generative-art, graphics, primitive, primitives
• Language: JavaScript
• Size: 594 KB
• Stars: 9
• Watchers: 2
• Forks: 0
• Open Issues: 11
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# primitive-cli

> CLI to reproduce images from geometric primitives (Node.js + browser port of [primitive](https://github.com/fogleman/primitive)).

[![NPM](https://img.shields.io/npm/v/primitive-cli.svg)](https://www.npmjs.com/package/primitive-cli) [![Build Status](https://travis-ci.com/transitive-bullshit/primitive-cli.svg?branch=master)](https://travis-ci.com/transitive-bullshit/primitive-cli) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)

This CLI is also available as a [library](https://github.com/transitive-bullshit/primitive).

[![Demo](https://storage.googleapis.com/transitive-bullshit-primitive/artem-bali-578205-unsplash-triangle-500.png)](https://transitive-bullshit.github.io/primitive-web/)

## Install

```bash

npm install -g primitive-cli

```

## Usage

```bash

  Usage: primitive [options]

  Options:

    -V, --version                           output the version number

    -i, --input                   Path of input image to process

    -o, --output                  Path to generate output image (default: out.png)

    -s, --num-steps                 Number of steps to process [1, 1000] (default: 200)

    -e, --min-energy                Minimum energy to stop processing early [0, 1]

    -a, --shape-alpha               Alpha opacity of shapes [0, 255] (default: 128)

    -t, --shape-type                Type of shapes to use (rotated-ellipse, rectangle, random, etc) (default: triangle)

    -c, --num-candidates            Number of top-level candidates per step [1, 32] (default: 1)

    -r, --num-candidate-shapes      Number of random candidates shapes per step [10, 1000] (default: 50)

    -m, --num-candidate-mutations   Number of candidate mutations per step [10, 500] (default: 100)

    -E, --num-candidate-extras      Number of extra candidate shapes per step [0, 16] (default: 0)

    -n, --nth-frame                 Record every nth frame (for gifs) [1, 32] (default: 1)

    -h, --help                              output usage information

```

## Related

-   [primitive (js)](https://github.com/transitive-bullshit/primitive) - JS library for this CLI.

-   [primitive (go)](https://github.com/fogleman/primitive) - Original Go version by [Michael Fogleman](https://www.michaelfogleman.com/)

## License

MIT © [Travis Fischer](https://github.com/transitive-bullshit)

Support my OSS work by following me on twitter