/usr/share/doc/therion-doc/samples.doc/25.html is in therion-doc 5.4.1ds1-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 | <html>
<head>
<title>Extended elevation control</title><link href="index.css" rel="styleSheet" type="text/css">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<center>
<table width="640" border="0" cellspacing="0" cellpadding="0">
<tr>
<td>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="33%" align="left">
<a href="10.html"><font class="nav">|Previous|</font></a>
</td>
<td width="34%" align="center"><a href="index.html"><font class="nav">|Contents|</font></a></td>
<td width="33%" align="right">
<a href="30.html"><font class="nav">|Next|</font></a>
</td>
</tr>
</table>
<hr noshade color="#000" size="1" width="100%"/>
<h1>Extended elevation control</h1>
<p>
Assume following situation (in plan view),
when there is a loop in centerline between stations 1 and 4,
small chimney near station 5
and entrance to the cave is at station 6.
</p>
<p>
<a href="000017-map1p.pdf"><img border="1" src="000017.png"/></a>
</p>
<p>
By default, centerline extended elevation of this situation looks like this:
</p>
<p>
<a href="000018-map1x.pdf"><img border="1" src="000018.png"/></a>
</p>
<p>
This is obviously not what we would like to get.
</p>
<p>
To control process of extended elevation, there is a special
<code>extend</code> option in centerline command.
</p>
<p>
First of all, we would like to start our extended elevation
at station 6 (where the entrance is). This can be done by specifying
</p>
<pre class="code">
extend start 6
</pre>
<p>
in the centerline. Now it looks better,
</p>
<p>
<a href="000019-map2.pdf"><img border="1" src="000019.png"/></a>
</p>
<p>
but there is still a problem with a branch containing station 5.
</p>
<p>
If we would like to start this branch from station 4, we need
to forbid therion to extend station 5 from 1. This can be done
by specifying
</p>
<pre class="code">
extend ignore 1 5
</pre>
<p>
This means, that shot from 1 to 5 will be ignored, when extended
elevation is generated.
</p>
<p>
If we would like to extend branch starting
with station 5 to the left, we need to specify also
</p>
<pre class="code">
extend left 5
</pre>
<p>
This will extend all stations from station 5 to the left.
</p>
<p>
<a href="000020-map3.pdf"><img border="1" src="000020.png"/></a>
</p>
<p>
As we have mentioned before, there is a small chimney above station 5.
In this case, it is much more natural to draw this shot as vertical
(because it is a chimney). To specify this, use
</p>
<pre class="code">
extend vertical 5 5'
</pre>
<p>
<a href="000021-map6.pdf"><img border="1" src="000021.png"/></a>
</p>
<p>
Or you can completely hide this leg from extended centerline using:
</p>
<pre class="code">
extend hide 5 5'
</pre>
<p>
<a href="000022-map7.pdf"><img border="1" src="000022.png"/></a>
</p>
<a name="0"></a><h2>Stations in extended elevation scraps</h2>
<p>
Even if the station 1 is present more then one time in the map,
therion automatically
detects correct position of this station in each scrap and they are
usually drawn correctly.
</p>
<p>
<a href="000023-map4.pdf"><img border="1" src="000023.png"/></a>
</p>
<p>
The only thing that is missing is connection line between stations 1
in these two branches.
Therion does not automatically generate these lines because their
shape usually depends on particilar map.
</p>
<p>
To draw such a line all you need to do is to create a simple scrap
with this line. Here is an example:
</p>
<pre class="code">
scrap sc -proj extended
point 0 0 station -name 1 -from 5 -visibility off
point 100 0 station -name 1 -from 2 -visibility off
line map-connection
0 5
0 15
100 15
100 5
endline
endscrap
</pre>
<p>
As you can see, even there are two stations with same name, they
are distinguished by <code>-from</code> option, which specifies
previous station in extended elevation. Using this scrap you receive the
final map:
</p>
<p>
<a href="000024-map5.pdf"><img border="1" src="000024.png"/></a>
</p>
<p></p>
<hr noshade color="#000" size="1" width="100%"/>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="33%" align="left">
<a href="10.html"><font class="nav">|Previous|</font></a>
</td>
<td width="34%" align="center"><a href="index.html"><font class="nav">|Contents|</font></a></td>
<td width="33%" align="right">
<a href="30.html"><font class="nav">|Next|</font></a>
</td>
</tr>
</table>
</td>
</tr>
</table>
</center>
</body></html>
|