Update README
This commit is contained in:
parent
80083d4f92
commit
74e10057f0
54
README.adoc
54
README.adoc
|
@ -5,8 +5,17 @@ autistdraw
|
||||||
|
|
||||||
image::http://www.image-share.com/upload/2848/201.png[screenshot]
|
image::http://www.image-share.com/upload/2848/201.png[screenshot]
|
||||||
|
|
||||||
Building and Running
|
Packages
|
||||||
--------------------
|
--------
|
||||||
|
Regular releases are sporadic. git master should be stable enough. You can get
|
||||||
|
a package with the latest development version from Archlinux's AUR, or from
|
||||||
|
openSUSE Build Service for the rest of mainstream distributions. Consult the
|
||||||
|
list of repositories and their respective links at:
|
||||||
|
|
||||||
|
https://build.opensuse.org/project/repositories/home:pjanouch:git
|
||||||
|
|
||||||
|
Building
|
||||||
|
--------
|
||||||
Build dependencies: CMake, pkg-config, liberty (included), termo (included) +
|
Build dependencies: CMake, pkg-config, liberty (included), termo (included) +
|
||||||
Runtime dependencies: ncursesw, libev
|
Runtime dependencies: ncursesw, libev
|
||||||
|
|
||||||
|
@ -16,22 +25,39 @@ Runtime dependencies: ncursesw, libev
|
||||||
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
|
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
|
||||||
$ make
|
$ make
|
||||||
|
|
||||||
Now, for standalone mode you can run:
|
To install the application, you can do either the usual:
|
||||||
|
|
||||||
$ ./autistdraw
|
# make install
|
||||||
|
|
||||||
To run as a server for other clients to connect to and draw simultaneously:
|
Or you can try telling CMake to make a package for you. For Debian it is:
|
||||||
|
|
||||||
$ ./autistdraw -s :1234
|
$ cpack -G DEB
|
||||||
|
# dpkg -i autistdraw-*.deb
|
||||||
|
|
||||||
Finally, to connect to a running server, run:
|
Note that for versions of CMake before 2.8.9, you need to prefix `cpack` with
|
||||||
|
`fakeroot` or file ownership will end up wrong.
|
||||||
$ ./autistdraw -c localhost:1234
|
|
||||||
|
|
||||||
Usage
|
Usage
|
||||||
-----
|
-----
|
||||||
Simply select a colour you like from the palette and draw by clicking and
|
For standalone mode you can run the program without arguments:
|
||||||
dragging the mouse. Use the middle mouse button to move the canvas.
|
|
||||||
|
$ autistdraw
|
||||||
|
|
||||||
|
To run as a server for other clients to connect to and draw simultaneously:
|
||||||
|
|
||||||
|
$ autistdraw -s :1234
|
||||||
|
|
||||||
|
To connect to a running server, run:
|
||||||
|
|
||||||
|
$ autistdraw -c localhost:1234
|
||||||
|
|
||||||
|
Once you have the program running, simply select a colour you like from the
|
||||||
|
palette and draw by pressing and dragging the mouse. Use the middle mouse
|
||||||
|
button to move the canvas.
|
||||||
|
|
||||||
|
You can store the current image to `drawing.bin` and load it back using the
|
||||||
|
's' and 'l' keys respectively. To just export the current picture for printing
|
||||||
|
it on a terminal, press 'e'. To export for IRC, press 'E'.
|
||||||
|
|
||||||
Known Issues
|
Known Issues
|
||||||
------------
|
------------
|
||||||
|
@ -45,6 +71,12 @@ or xterm. These two are feature-full and *fast*. st also works great.
|
||||||
Even so, try not to strain the application too much. It can and will break if
|
Even so, try not to strain the application too much. It can and will break if
|
||||||
you flood the communication channel with the terminal.
|
you flood the communication channel with the terminal.
|
||||||
|
|
||||||
|
Contributing and Support
|
||||||
|
------------------------
|
||||||
|
Use this project's GitHub to report any bugs, request features, or submit pull
|
||||||
|
requests. If you want to discuss this project, or maybe just hang out with
|
||||||
|
the developer, feel free to join me at irc://irc.janouch.name, channel #dev.
|
||||||
|
|
||||||
License
|
License
|
||||||
-------
|
-------
|
||||||
'autistdraw' is written by Přemysl Janouch <p.janouch@gmail.com>.
|
'autistdraw' is written by Přemysl Janouch <p.janouch@gmail.com>.
|
||||||
|
|
Loading…
Reference in New Issue