Reference:Text - Revision history

Jholsenback: clarification

2012-12-29T16:15:48Z

clarification

Jholsenback: 1 revision: updates related to change #5720

2012-10-10T12:58:35Z

1 revision: updates related to change #5720

Jholsenback: updated for RC7

2012-10-09T03:44:35Z

updated for RC7

Jholsenback: 1 revision: underscore link repair

2012-07-17T18:09:18Z

1 revision: underscore link repair

Jholsenback: still testing that theory

2012-07-16T12:14:05Z

still testing that theory

Jholsenback: 1 revision: Reference Migration Initial Load

2012-03-15T19:08:58Z

1 revision: Reference Migration Initial Load

Jholsenback: 1 revision: Initial Load (TF)

2012-03-11T22:27:03Z

1 revision: Initial Load (TF)

New page

[[Category:Objects]]
[[Category:Finite Solid Primitives]]
{{#indexentry:text, keyword}}
{{#indexentry:keyword, text}}
{{#indexentry:ttf, text}}
{{#indexentry:keyword, ttf}}
{{#indexentry:ttf}}
A <code>text</code> object creates 3-D text as an extruded block letter.
Currently only TrueType fonts (ttf) and TrueType Collections (ttc) are supported
but the syntax allows for other font types to be added in the future. If TrueType Collections
are used, the first font found in the collection will be used. The syntax is:
<pre>
TEXT_OBECT:
text {
ttf "fontname.ttf/ttc" "String_of_Text"
Thickness, <Offset>
[OBJECT_MODIFIERS...]
}
</pre>

Where <code>fontname.ttf</code> or <code>fontname.ttc</code> is the name of the TrueType font file. It
is a quoted string literal or string expression. The string expression which
follows is the actual text of the string object. It too may be a quoted
string literal or string expression. See section [[Reference:Strings|Strings]] for more
on string expressions.

The text will start with the origin at the lower left, front of the first
character and will extend in the +x-direction. The baseline of the text
follows the x-axis and descender drop into the -y-direction. The front of the
character sits in the x-y-plane and the text is extruded in the +z-direction.
The front-to-back thickness is specified by the required value <code>
Thickness</code>.

Characters are generally sized so that 1 unit of vertical spacing is
correct. The characters are about 0.5 to 0.75 units tall.

The horizontal spacing is handled by POV-Ray internally including any kerning
information stored in the font. The required vector <code>
<Offset></code> defines any extra translation between each
character. Normally you should specify a zero for this value. Specifying
<code>0.1*x</code> would put additional 0.1 units of space between each
character. Here is an example:
<pre>
text {
ttf "timrom.ttf" "POV-Ray" 1, 0
pigment { Red }
}
</pre>

Only printable characters are allowed in text objects. Characters such as
return, line feed, tabs, backspace etc. are not supported.

For easy access to your fonts, set the [[Reference:Scene_Parsing_Options#Library_Paths|:Library_Path|Library_Path]]
to the directory that contains your font collection.

@@ Line 18: / Line 18: @@
 <p>Where <code>fontname.ttf</code> or <code>fontname.ttc</code> is the name of the TrueType font file. It is a quoted string literal or string expression. The string expression which follows is the actual text of the string object. It too may be a quoted string literal or string expression. See section <!--<linkto "Strings">Strings</linkto>--->[[Reference:Strings|Strings]] for more on string expressions.</p>
-<p>In version 3.7 several fonts were <em>built-in</em>, consequently, the following <em>alternate</em> syntax is available:</p>
+<p>In version 3.7 several fonts are now <em>built-in</em>. It should be noted that this is only a preliminary solution so the benchmark program will run without installing POV-Ray. Future versions may lack this mechanism, so in scene files (other than the built-in benchmark) you should continue to reference the external font files as before. Consequently, the following <em>alternate</em> syntax is available:</p>
 <pre>
 TEXT_OBECT:

@@ Line 6: / Line 6: @@
 {{#indexentry:keyword, ttf}}
 {{#indexentry:ttf}}
-<p>A <code>text</code> object creates 3-D text as an extruded block letter.
+<p>A <code>text</code> object creates 3-D text as an extruded block letter. Currently only TrueType fonts (ttf) and TrueType Collections (ttc) are supported but the syntax allows for other font types to be added in the future. If TrueType Collections are used, the first font found in the collection will be used. The syntax is:</p>
 <pre>
 TEXT_OBECT:
@@ Line 19: / Line 16: @@
 </pre>
-<p>Where <code>fontname.ttf</code> or <code>fontname.ttc</code> is the name of the TrueType font file. It
+<p>Where <code>fontname.ttf</code> or <code>fontname.ttc</code> is the name of the TrueType font file. It is a quoted string literal or string expression. The string expression which follows is the actual text of the string object. It too may be a quoted string literal or string expression. See section <!--<linkto "Strings">Strings</linkto>--->[[Reference:Strings|Strings]] for more on string expressions.</p>
 is a quoted string literal or string expression. The string expression which
-follows is the actual text of the string object. It too may be a quoted
+<p>In version 3.7 several fonts were <em>built-in</em>, consequently, the following <em>alternate</em> syntax is available:</p>
-string literal or string expression. See section <!--<linkto "Strings">Strings</linkto>--->[[Reference:Strings|Strings]] for more
+<pre>
-on string expressions.</p>
+TEXT_OBECT:
-<p>
+  text {
-The text will start with the origin at the lower left, front of the first
+    internal Font_Number &quot;String_of_Text&quot;
-character and will extend in the +x-direction. The baseline of the text
+    Thickness, &lt;Offset&gt;
-follows the x-axis and descender drop into the -y-direction. The front of the
+    [OBJECT_MODIFIERS] }
 character sits in the x-y-plane and the text is extruded in the +z-direction.
-The front-to-back thickness is specified by the required value <em><code>
+</pre>
 Thickness</code></em>.</p>
 <p>
-Characters are generally sized so that 1 unit of vertical spacing is
+<p>Characters are generally sized so that 1 unit of vertical spacing is correct. The characters are about 0.5 to 0.75 units tall.</p>
 correct. The characters are about 0.5 to 0.75 units tall.</p>
-<p>
+<p>The horizontal spacing is handled by POV-Ray internally including any kerning information stored in the font. The required vector <em><code>&lt;Offset&gt;</code></em> defines any extra translation between each character. Normally you should specify a zero for this value. Specifying <code>0.1*x</code> would put additional 0.1 units of space between each character. Here is an example:</p>
 <pre>
 text {
@@ Line 48: / Line 51: @@
 </pre>
-<p>Only printable characters are allowed in text objects. Characters such as
+<p>Only printable characters are allowed in text objects. Characters such as return, line feed, tabs, backspace etc. are not supported.</p>
-<p>For easy access to your fonts, set the [[Reference:Scene Parsing Options#Library Paths|:Library_Path|Library_Path]]
+<p>For easy access to your fonts, set the [[Reference:Scene Parsing Options#Library Paths|:Library_Path|Library_Path]] to the directory that contains your font collection.</p>

@@ Line 51: / Line 51: @@
 return, line feed, tabs, backspace etc. are not supported.</p>
-<p>For easy access to your fonts, set the [[Reference:Scene_Parsing_Options#Library_Paths|:Library_Path|Library_Path]]
+<p>For easy access to your fonts, set the [[Reference:Scene Parsing Options#Library Paths|:Library_Path|Library_Path]]
 to the directory that contains your font collection.</p>

← Older revision	Revision as of 12:58, 10 October 2012
(No difference)

← Older revision	Revision as of 18:09, 17 July 2012
(No difference)

← Older revision	Revision as of 19:08, 15 March 2012
(No difference)