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
|
<html>
<head>
<title>EAGLE Help: TEXT</title>
</head>
<body bgcolor=white>
<font face=Helvetica,Arial>
<hr>
<i>EAGLE Help</i>
<h1><center>TEXT</center></h1>
<hr>
<dl>
<dt>
<b>Function</b>
<dd>
Adds text to a drawing.
<p>
<dt>
<b>Syntax</b>
<dd>
<tt>TEXT any_text orientation *..</tt><br>
<tt>TEXT 'any_text' orientation *..</tt>
<p>
<dt>
<b>Mouse</b>
<dd>
Center button changes the layer.<br>
Right button rotates the text.
<p>
</dl>
<b>See also</b> <a href=32.htm>CHANGE</a>,
<a href=61.htm>MOVE</a>,
<a href=59.htm>MIRROR</a>,
<a href=69.htm>PIN</a>,
<a href=82.htm>ROTATE</a>
<p>
The TEXT command is used to add text to a library element or drawing.
When entering several texts it is not necessary to invoke the
command each time, as the text command remains active after placing
text with the mouse.
<p>
<b>Orientation</b>
<p>
The orientation of the text may be defined by the TEXT command (orientation)
using the usual definitions as listed in the <a href=26.htm>ADD</a> command (R0, R90
etc.). The right mouse button will change the rotation of the text
and the center mouse button will change the current layer.
<p>
Text is always displayed so that it can be read from in front or from
the right - even if rotated. Therefore after every two rotations it
appears the same way, but the origin has moved from the lower left
to the upper right corner. Remember this if a text appears to be unselectable.
<p>
If you want to have text that is printed "upside down", you can set the "Spin"
flag for that text.
<p>
<b>Special Characters</b>
<p>
If the text contains several succeeding blanks or a semicolon, the
whole string has to be enclosed in single quotes. If the text contains
single quotes then each one itself has to be enclosed in single quotes.
If apostrophes are required in the text, each must be enclosed
in single quotes.
<p>
<b>Key Words</b>
<p>
If the TEXT command is active and you want to type in a text that
contains a string that can be mistaken for a command (e.g. "red"
for "REDO") then this string has to be enclosed in single
quotes.
<p>
<b>Text Height</b>
<p>
The height of characters and the line width can be changed with the
CHANGE commands:
<pre>
CHANGE SIZE text_size *..
CHANGE RATIO ratio *..
</pre>
Maximum text height: 2 inches<br>
Maximum line width: 0.51602 inch (13.1 mm)<br>
Ratio: 0...31 (% of text height).
<p>
<b>Text Font</b>
<p>
Texts can have three different fonts:
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>Vector</tt></font></td> <td valign=top><font face=Helvetica,Arial>the program's internal vector font</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>Proportional</tt></font></td> <td valign=top><font face=Helvetica,Arial>a proportional pixel font (usually 'Helvetica')</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>Fixed</tt></font></td> <td valign=top><font face=Helvetica,Arial>a monospaced pixel font (usually 'Courier')</font></td></tr>
</table>
<p>
The text font can be changed with the CHANGE command:
<pre>
CHANGE FONT VECTOR|PROPORTIONAL|FIXED *..
</pre>
The program makes great efforts to output texts with fonts other than
<tt>Vector</tt> as good as possible. However, since the actual font is drawn
by the system's graphics interface, <tt>Proportional</tt> and <tt>Fixed</tt> fonts
may be output with different sizes and/or lengths.
<p>
If you set the option "Always vector font" in the <a href=15.htm>user interface dialog</a>,
all texts will always be displayed and printed using the builtin vector font.
This option is useful if the system doesn't display the other fonts correctly.<br>
When creating a new board or schematic, the current setting of this option is stored in the
drawing file. This makes sure that the drawing will be printed with the correct
setting if it is transferred to somebody else who has a different setting of
this option.<br>
You can use the <tt><a href=86.htm>SET</a> VECTOR_FONT ON|OFF</tt> command
to change the setting in an existing board or schematic drawing.
<p>
When creating output files with the CAM Processor, texts will always be drawn with
<tt>Vector</tt> font. Other fonts are not supported.
<p>
If a text with a font other than <tt>Vector</tt> is subtracted from a signal
polygon, only the surrounding rectangle is subtracted. Due to the
above mentioned possible size/length problems, the actually printed
font may exceed that rectangle. Therefore, if you need to subtract
a text from a signal polygon it is recommended that you use the <tt>Vector</tt>
font.
<p>
The <i>Ratio</i> parameter has no meaning for texts with fonts other than <tt>Vector</tt>.
<p>
<b>Character Sets</b>
<p>
Only the characters with ASCII codes below 128 are guaranteed to be printed correctly.
Any characters above this may be system dependent and may yield different results
with the various fonts.
<p>
<b>Text Variables</b>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>>NAME</tt> </font></td><td valign=top><font face=Helvetica,Arial>Component name (ev.+gate name) 1)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>>VALUE</tt> </font></td><td valign=top><font face=Helvetica,Arial>Comp. value/type 1)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>>PART</tt> </font></td><td valign=top><font face=Helvetica,Arial>Component name 2)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>>GATE</tt> </font></td><td valign=top><font face=Helvetica,Arial>Gate name 2)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>>DRAWING_NAME</tt> </font></td><td valign=top><font face=Helvetica,Arial>Drawing name</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>>LAST_DATE_TIME</tt> </font></td><td valign=top><font face=Helvetica,Arial>Time of the last modification</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>>PLOT_DATE_TIME</tt> </font></td><td valign=top><font face=Helvetica,Arial>Time of the plot creation</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>>SHEET</tt> </font></td><td valign=top><font face=Helvetica,Arial>Sheet number of schematic 3)</font></td></tr>
</table>
<p>
1) Only for package or symbol<br>
2) Only for symbol<br>
3) Only for symbol or schematic
<hr>
<table width=100% cellspacing=0 border=0><tr><td align=left><font face=Helvetica,Arial>
<a href=index.htm>Index</a>
</font></td><td align=right><font face=Helvetica,Arial size=-1>
<i>Copyright © 2005 CadSoft Computer GmbH</i>
</font></td></tr></table>
<hr>
</font>
</body>
</html>
|