blob: dc31f6662c25a7b899f49ec72bd8565d71fe234e (
plain) (
blame)
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
|
@Section
@Title { Clipping }
@Tag { clipping }
@Begin
@PP
The @Code "@HClip" symbol clips the following object horizontally to
the available width:
@ID @Code {
"@Box 1c @Wide @HClip WARNING!"
}
produces
@ID {
@Box 1c @Wide @HClip WARNING!
}
The following object may be arbitrary as usual; for example, it
could be an illustration included using @Code "@IncludeGraphic"
(Section {@NumberOf include}).
We have used the @Code "@Wide" symbol from Section {@NumberOf precise}
to make clear what the available width is in this small example (one
centimetre), but @Code "@HClip" will work in any context; for example,
you could use it to clip a table entry, or a display.
@PP
The @Code "@HClip" symbol has a @Code "shift" option which determines
which part of the clipped object is displayed. It may take on any
value between {@Code "0.0"}, meaning to display the leftmost part
(the default value), and {@Code "1.0"}, meaning to display the rightmost
part:
@ID @Code {
"@Box 1c @Wide @HClip shift { 1.0 } WARNING!"
}
produces
@ID {
@Box 1c @Wide @HClip shift { 1.0 } WARNING!
}
To display the central part, use shift value {@Code "0.5"}. Notice that
there is no unit of measurement attached to the value of {@Code "shift"}.
@PP
There is also a @Code "@VClip" symbol which works in exactly the same
way, only vertically. The two symbols combine together naturally:
@ID @Code {
"@Box 1c @Wide 0.2c @High @HClip @VClip WARNING!"
}
produces
@ID {
@Box 1c @Wide 0.2c @High @HClip @VClip WARNING!
}
The @Code "shift" options to determine which part of the two-dimensional
area is displayed, as usual.
@End @Section
|
