README.md
1
2
3[Milton](https://github.com/serge-rgb/milton) is an open source application that lets you Just Paint.
4
5There are no pixels, you can paint with (almost) infinite detail. It feels raster-based but it works with vectors.
6It is not an image editor. It is not a vector graphics editor. It is a program that lets you draw, sketch and paint.
7There is no save button, your work is persistent with unlimited undo.
8
9### [Latest release](https://github.com/serge-rgb/milton/releases/)
10
11[](https://waffle.io/serge-rgb/milton)
12[](https://gitter.im/serge-rgb/milton?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
13
14
15
16
17
18
19What Milton is not:
20-------------------
21
22Milton is not an image editor or a vector graphics editor. It's a program that
23lets you draw, sketch and paint.
24
25User Manual
26===========
27
28If the GUI makes something not-obvious, please create a github issue!
29
30It's very helpful to drag the mouse (or pen) while pressing `space` to pan the
31canvas. Also, switching between the brush and the eraser with `b` and `e`.
32You can change the brush size with `[` and `]` and control the transparency
33with the number keys.
34
35Here is the [latest video tutorial](https://www.youtube.com/watch?v=g27gHio2Ohk)
36
37Check out the [patreon page](https://www.patreon.com/serge_rgb?ty=h) if you would like to help out. :)
38
39While on Windows there are binaries available, for Milton on Linux or OSX you will have to compile from source. There are some basic build instructions below. They will probably build, but please be prepared to do a bit of debugging on your end if you run into trouble, since these are not the primary development platforms.
40
41How to Compile
42==============
43
44Windows
45-------
46
47Milton currently supports Visual Studio 2019.
48
49Other versions of Visual Studio might not work.
50
51To build:
52
53Run a x64 developer command prompt (for VS 2019 this corresponds to the "x64 Native Tools Command Prompt") and type the following:
54
55```
56build.bat
57```
58
59Milton will be compiled to `build\Milton.exe`
60
61
62This repo provides a binary SDL.lib that was compiled by running
63`build_deps.bat` in the `third_party` directory.
64
65
66Linux and macOS
67---------------
68
69As of 2018-10-24, linux and mac are not officially supported. I (Sergio) would like to support them again but my efforts are currently going into producing a new release for Windows. You can try and compile with the included scripts, but things will likely not work!
70
71
72Versioning scheme
73=================
74
75Milton uses a MAJOR.MINOR.PATCH versioning scheme, where MAJOR keeps track of very significant changes, such as a UI overhaul. MINOR keeps track of binary file format compatibility. PATCH is incremented for new releases that do not break file format compatibility. PATCH version gets reset to 0 when the MINOR version increases.
76
77For example, Milton version 1.3.1 can read mlt files produced any previous version, but it can't read files produced by 1.4.0
78
79
80License
81=======
82
83 Milton
84
85 Copyright (C) 2015 - 2018 Sergio Gonzalez
86
87 This program is free software: you can redistribute it and/or modify
88 it under the terms of the GNU General Public License as published by
89 the Free Software Foundation, either version 3 of the License, or
90 (at your option) any later version.
91
92 This program is distributed in the hope that it will be useful,
93 but WITHOUT ANY WARRANTY; without even the implied warranty of
94 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
95 GNU General Public License for more details.
96
97 You should have received a copy of the GNU General Public License
98 along with this program. If not, see <http://www.gnu.org/licenses/>.
99
100Thanks
101======
102
103Milton is made with love by Sergio Gonzalez with the help of [awesome
104people](https://github.com/serge-rgb/milton/blob/master/CREDITS.md).
105
106
107
){kind=link}
){kind=link}
){kind=link}
){kind=link}
){kind=link}