aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 4163f1143a0651270b6c7999768a5550aba6dcc9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# Connect the dots

This repository houses some "connect the dots" pictures with Christian themes.

## Downloading

If you try to download the SVG files using a web browser, they can break due to
the way browser handles them.  In this case, you should instead download the ZIP
archive with all the files in it or use a command line tool, e.g.

```shell-script
    wget 'https://git.koszko.org/connect-the-dots/plain/cup-of-passion.svg' \
        -O ./cup-of-passion.svg
```

## Drawing workflow

Pictures here are initially sketched with pencil and paper.  They are then
scanned and opened with [Inkscape](https://inkscape.org/).  The actual vector
image gets drawn over the initial sketch (in a separate Inkscape layer).

Every drawing includes a line (an open sequence of connected segments, without
curves) named (inside Inkscape) as "connect-the-dots".  This repository contains
a [GNU Guile](https://www.gnu.org/software/guile/) script `make-points.scm`
which is then used to add dots with labels on the corners of the line.  Sample
invokation of the script (under a UNIX-like system with Guile installed) looks
like this:

```shell-script
    ./make-points.scm                    \
        --input=cup-of-passion.svg       \
        --output=cup-of-passion-work.svg \
        --font-size=12.5
```

The modified image is then opened in Inkscape again and the labels are manually
rearranged to collide with each other and with other picture elements as little
as possible.  It is still possible to remove a corner and its label at this
point.  Subsequent invokation of `make-points.scm` on the modified picture
replaces the dots with new ones and renumbers those labels that have not been
removed.  The labels remain in the positions they were moved to by the designer.

The final picture can be exported (e.g. to a PDF) after setting sketch and line
layers to invisible in Inkscape.

## Copying

🅮 All rights reversed

The contents of this repository are available under the [Creative Commos Zero
v1.0](https://creativecommons.org/publicdomain/zero/1.0/legalcode.pl) license.
The repository follows the [REUSE](https://reuse.software/) v3.0 specification.