TEXT¶
Renders a text.
Properties¶
align¶
angle¶
-
angle
¶ -
- Type
- degree
- Default
- 0
- Range
- -90 to 90
The rotation degree of the text.
Note
The angle is not available, if spacing / wordSpacing is set.
antiAlias¶
-
anti
¶Alias -
- Type
- boolean
- Default
- 1 (true)
breakSpace¶
-
break
¶Space -
- Type
- float
- Default
- 1.0
Defines a value that is multiplied by the line height of the current element.
breakWidth¶
doNotStripHTML¶
emboss¶
fontColor¶
-
font
¶Color -
- Type
- GraphicColor / stdWrap
- Default
- black
The font color.
fontFile¶
fontSize¶
hide¶
iterations¶
maxWidth¶
-
max
¶Width -
- Type
- positive integer / stdWrap
Sets the maximum width in pixels, the text must be. Reduces the fontSize, if the text does not fit within this width.
Does not support setting alternative font sizes in splitRendering options.
niceText¶
-
nice
¶Text -
- Type
- boolean / stdWrap
This is a very popular feature that helps to render small letters much nicer than the FreeType library can normally do. But it also loads the system very much!
The principle of this function is to create a black/white image file in twice or more times the size of the actual image file and then print the text onto this in a scaled dimension. Afterwards GraphicsMagick/ImageMagick scales down the mask and masks the fontColor down on the original image file through the temporary mask.
The fact that the font is actually rendered in the double size and scaled down adds a more homogeneous shape to the letters. Some fonts are more critical than others though. If you do not need the quality, then do not use the function.
after¶
-
nice
¶Text. after -
GraphicsMagick/ImageMagick parameters after scale.
before¶
-
nice
¶Text. before -
GraphicsMagick/ImageMagick parameters before scale.
scaleFactor¶
-
nice
¶Text. scale Factor -
- Type
- integer (2-5)
The scaling factor.
sharpen¶
-
nice
¶Text. sharpen -
- Type
- integer (0-99)
The sharpen value for the mask (after scaling). This enables you to make the text crisper, if it is too blurred!
offset¶
outline¶
shadow¶
spacing¶
splitRendering¶
-
split
¶Rendering -
- Type
- integer / (array of keys)
Split the rendering of a string into separate processes with individual configurations. By this method a certain range of characters can be rendered with another font face or size. This is very useful if you want to use separate fonts for strings where you have latin characters combined with, for example, Japanese and there is a separate font file for each.
You can also render keywords in another font / size / color.
[array]¶
-
split
¶Rendering. [array] -
- Type
- integer
With keyword being [charRange, highlightWord].
- splitRendering.[array] = keyword with keyword being [charRange, highlightWord]
-
splitRendering.[array] {
- fontFile: Alternative font file for this rendering.
- fontSize: Alternative font size for this rendering.
- color: Alternative color for this rendering, works only without niceText.
- xSpaceBefore: x space before this part.
- xSpaceAfter: x space after this part.
- ySpaceBefore: y space before this part.
- ySpaceAfter: y space after this part.
}
Keyword: charRange
split
= Comma-separated list of character ranges (for example,Rendering. [array]. value 100-
) given as Unicode character numbers. The list accepts optional starting and ending points, for example,200 - 200
or200 -
and single values, for example,65, 66, 67
.Keyword: highlightWord
split
= Word to highlight, makes a case sensitive search for this.Rendering. [array]. value Limitations:
- The pixel compensation values are not corrected for scale factor used
with niceText. Basically this means
that when
nice
is used, these values will have only the half effect.Text - When word spacing is used the
highlight
mode does not work.Word - The color override works only without
nice
.Text
Example:
10.splitRendering.compX = 2 10.splitRendering.compY = -2 10.splitRendering.10 = charRange 10.splitRendering.10 { value = 200-380 , 65, 66 fontSize = 50 fontFile = EXT:core/Resources/Private/Font/nimbus.ttf xSpaceBefore = 30 } 10.splitRendering.20 = highlightWord 10.splitRendering.20 { value = TheWord color = red }
Copied!
compX¶
-
split
¶Rendering. comp X -
- Type
- integer
Additional pixel space between parts, x direction.
compY¶
-
split
¶Rendering. comp Y -
- Type
- integer
Additional pixel space between parts, y direction.