summaryrefslogtreecommitdiff
path: root/graphics/pgf/contrib/pgf-cmykshadings/README.md
blob: ecb448ff59ad55f61f354c73d74ee82a471f745b (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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
# pgf-cmykshadings — Support for CMYK and grayscale shadings in PGF/TikZ

The `pgf-cmykshadings` package provides support for CMYK and grayscale shadings
for the `pgf` package. By default `pgf` only supports RGB shadings.
`pgf-cmykshadings` attempts to produce shadings consistent with the currently
selected `xcolor` colour model. The `rgb`, `cmyk`, and `gray` colour models
from the `xcolor` package are supported.

## Installation from TeXLive or MiKTeX

`pgf-cmykshadings` is in TeXLive and MiKTeX and can be installed in the usual
way through your distribution. e.g., in TeXLive by running:

```
tlmgr install pgf-cmykshadings
```

## Installation from CTAN

Download and unpack `pgf-cmykshadings.zip` from CTAN at
https://ctan.org/pkg/pgf-cmykshadings

Change to the `pgf-cmykshadings` directory, then run:

```
tex pgf-cmykshadings.ins
```

to generate the style file (`pgf-cmykshadigns.sty`) and driver files
(`pgfsys-cmykshadings-*.def`).

Copy these generated files to `$TEXMFHOME/tex/latex/pgf-cmykshadings/` and
`pgf-cmykshadings.pdf` to `$TEXMFHOME/doc/latex/pgf-cmykshadings/`.

You can find `$TEXMFHOME` by running:

```
kpsewhich -var-value=TEXMFHOME
```

## Installation from Git Source

`pgf-cmykshadings` uses the `l3build` system.

Clone the git repository using:

```
git clone https://github.com/dcpurton/pgf-cmykshadings.git
```

Change to the `pgf-cmykshadings` directory, and then the package and
documentation can be installed by running:

```
l3build install --full
```

## Licence

```
Copyright (c) 2018 David Purton <dcpurton@marshwiggle.net>

This work may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.3c of this license
or (at your option) any later version. The latest version of this
license is in
   http://www.latex-project.org/lppl.txt
and version 1.3c or later is part of all distributions of LaTeX
version 2005/12/01 or later.

This work is "maintained" (as per the LPPL maintenance status)
by David Purton.

This work consists of the files pgf-cmykshadings.ins,
pgf-cmykshadings.dtx, README.md, and the derived files
  - pgf-cmykshadings.sty
  - pgfsys-cmykshadings-pdftex.def
  - pgfsys-cmykshadings-xetex.def
  - pgfsys-cmykshadings-luatex.def
  - pgfsys-cmykshadings-dvipdfmx.def
  - pgfsys-cmykshadings-dvipdfm.def
  - pgfsys-cmykshadings-dvips.def
  - pgfsys-cmykshadings-textures.def
  - pgfsys-cmykshadings-vtex.def
  - pgfsys-cmykshadings-common-postscript.def
  - pgf-cmykshadings.pdf


Substantial parts of the code for this package are taken from the pgf package
file pgfcoreshade.code.tex, along with the driver files pgfsys-*.def, copyright
(c) 2006 Till Tantau and then slightly modified to support CMYK and grayscale
shadings.
```