vixl44's Introduction

vixl44

Create pixel art inside your terminal using vim movements

Installation

go get github.com/sebashwa/vixl44

Usage

~/go/bin/vixl44 [OPTIONS] [FILENAME]

FILENAME

    the name of your file

OPTIONS

-c, --cols
    number of columns, default is 20, 0 means full width, ignored if name of existing file given
-r, --rows
    number of rows, default is 20, 0 means full height, ignored if name of existing file given

Keybindings

Movement

Keys	Action
`h`,`j`,`k`,`l`	Move cursor left, down, up, right
`w`	Move cursor 5 columns right
`b`	Move cursor 5 columns left
`Ctrl-d`	Move cursor 5 rows down
`Ctrl-u`	Move cursor 5 rows up

Normal Mode

Keys	Action
`Space`, `Return`	Paint color
`s`	Select color under the cursor
`f`	Replace color in area (Flood fill)
`u`	Undo change
`Ctrl-r`	Redo change
`p`	Paste from buffer
`c`	Switch to palette mode
`Ctrl-v`	Switch to visual block mode

Visual Block Mode

Keys	Action
`Space`, `Return`	Paint color
`x`, `d`	Cut area
`y`	Copy area
`Esc`	Switch to normal mode
`c`	Switch to palette mode

Palette Mode

Keys	Action
`Space`, `Return`	Select color
`Esc`	Switch to normal mode
`Ctrl-v`	Switch to visual block mode

Commands

:w FILENAME<CR>         - Write to FILENAME
:wq FILENAME<CR>        - Write to FILENAME and quit
:exp FILENAME.svg<CR>   - Export to FILENAME in svg format
:exp FILENAMExN.png<CR> - Export to FILENAME in png format with an optional scale factor N
:exp FILENAME.ansi<CR>  - Export ANSI escape sequences to FILENAME (use i.e. cat FILENAME to view it)
:q<CR>                  - Quit

License

This project is free software: You can redistribute it and/or modify it under the terms of the GNU General Public License, either version 3 of the License, or (at your option) any later version.

vixl44's People