aboutsummaryrefslogtreecommitdiffstats
path: root/doc/user/bgr_colo
diff options
context:
space:
mode:
authorJeffrey H. Kingston <jeff@it.usyd.edu.au>2010-09-14 19:21:41 +0000
committerJeffrey H. Kingston <jeff@it.usyd.edu.au>2010-09-14 19:21:41 +0000
commit71bdb35d52747e6d7d9f55df4524d57c2966be94 (patch)
tree480ee5eefccc40d5f3331cc52d66f722fd19bfb9 /doc/user/bgr_colo
parentb41263ea7578fa9742486135c762803b52794105 (diff)
downloadlout-71bdb35d52747e6d7d9f55df4524d57c2966be94.tar.gz
Lout 3.17.
git-svn-id: http://svn.savannah.nongnu.org/svn/lout/trunk@2 9365b830-b601-4143-9ba8-b4a8e2c3339c
Diffstat (limited to 'doc/user/bgr_colo')
-rw-r--r--doc/user/bgr_colo48
1 files changed, 48 insertions, 0 deletions
diff --git a/doc/user/bgr_colo b/doc/user/bgr_colo
new file mode 100644
index 0000000..4a48fb9
--- /dev/null
+++ b/doc/user/bgr_colo
@@ -0,0 +1,48 @@
+@Section
+ @Title { Colour }
+ @Tag { colour }
+@Begin
+@PP
+Colour is obtained in much the same way that fonts and language changes
+colour. @Index @Code "@Colour"
+color. @Index @Code "@Color"
+are, using the @Code "@Colour" (or equivalently {@Code "@Color"}) symbol:
+@ID @Code "grey @Colour { Hello, world }"
+produces
+@ID grey @Colour { Hello, world }
+The @Code "@Colour" symbol will accept any of the following colours:
+@QD @HAdjust @Tab
+ vmargin { 0.7vx }
+ hmargin { 0.2c }
+ @Fmta { @Col A @Colour @FilledBox ! @Col @Code A ! @Col !
+ @Col B @Colour @FilledBox ! @Col @Code B ! @Col !
+ @Col C @Colour @FilledBox ! @Col @Code C }
+ @Fmtb { @Col A @Colour @FilledBox ! @Col @Code A ! @Col !
+ @Col B @Colour @FilledBox ! @Col @Code B ! @Col !
+ @Col ! @Col }
+{
+@Rowa A { darkred } B { red } C { lightred }
+@Rowa A { darkgreen } B { green } C { lightgreen }
+@Rowa A { darkblue } B { blue } C { lightblue }
+@Rowa A { darkcyan } B { cyan } C { lightcyan }
+@Rowa A { darkmagenta } B { magenta } C { lightmagenta }
+@Rowa A { darkyellow } B { yellow } C { lightyellow }
+@Rowa A { darkgrey } B { grey } C { lightgrey }
+@Rowa A { darkgray } B { gray } C { lightgray }
+@Rowb A { black } B { white }
+}
+Monochrome output devices will render them as shades of grey. Colouring
+something @Code white makes it invisible, which is sometimes useful.
+@PP
+In addition to the list of colours given above, there is a special
+colour called {@Code nochange} which produces the colour you already
+happen to be using.
+@PP
+Whether or not the colours produced by @Code "@Colour" actually
+correspond with the names depends on the output device; the same
+nominal colour can look quite different on screen and on paper. The
+standard Lout @Code "@SetColour" symbol can provide many more colours
+setcolour. @Index @Code "@SetColour"
+@Cite { $kingston1995lout.expert}, although they must be specified
+using numbers rather than names.
+@End @Section