Panda3D

Functions | Variables
config_text.cxx File Reference

PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University. More...

`#include "config_text.h"`
`#include "staticTextFont.h"`
`#include "textFont.h"`
`#include "textGlyph.h"`
`#include "textNode.h"`
`#include "textProperties.h"`
`#include "dynamicTextFont.h"`
`#include "dynamicTextGlyph.h"`
`#include "dynamicTextPage.h"`
`#include "geomTextGlyph.h"`
`#include "unicodeLatinMap.h"`
`#include "pandaSystem.h"`
`#include "dconfig.h"`
`#include "config_express.h"`

Go to the source code of this file.

## Functions
| Configure (config_text)
| ConfigureFn (config_text)
wstring | get_text_never_break_before ()
wstring | get_text_soft_hyphen_output ()
void | init_libtext ()
| Initializes the library. More...
| NotifyCategoryDef (text, "")

## Variables
ConfigVariableInt | text_anisotropic_degree ("text-anisotropic-degree", 1, PRC_DESC("This is the default anisotropic-degree that is set on dynamic " "font textures. Setting this to a value greater than 1 can help " "smooth out the antialiasing for small letters."))
ConfigVariableFilename | text_default_font ("text-default-font", "", PRC_DESC("This names a filename that will be loaded at startup time as " "the default font for any TextNode that does not specify a font " "otherwise. The default is to use a special font that is " "compiled into Panda, if available."))
ConfigVariableDouble | text_default_underscore_height ("text-default-underscore-height", -0.2, PRC_DESC("Specifies the default height of the underscore line, relative " "to the text baseline, when underscoring is enabled."))
ConfigVariableBool | text_dynamic_merge ("text-dynamic-merge", true, PRC_DESC("Set this true to merge generated glyphs into the GeomVertexData " "as the text is assembled, or false to wait for the flatten " "operation. Usually it's a performance " "advantage to keep this true. See TextNode::set_flatten_flags()."))
ConfigVariableInt | text_embed_graphic_key ("text-embed-graphic-key", 5, PRC_DESC("This is the decimal character number that, embedded in " "a string, is used to bracket the name of a model " "added to the TextPropertiesManager object, to " "embed an arbitrary graphic image within a paragraph."))
ConfigVariableBool | text_flatten ("text-flatten", true, PRC_DESC("Set this true to flatten text when it is generated, or false to " "keep it as a deep hierarchy. Usually it's a performance " "advantage to keep this true, but this also depends on the setting " "of text-dynamic-merge. See TextNode::set_flatten_flags()."))
ConfigVariableDouble | text_hyphen_ratio ("text-hyphen-ratio", 0.7, PRC_DESC("If the rightmost whitespace character falls before this " "fraction of the line, hyphenate a word to the right of that " "if possible."))
ConfigVariableBool | text_kerning ("text-kerning", false, PRC_DESC("Set this true to enable kerning when the font provides kerning " "tables. This can result in more aesthetically pleasing spacing " "between individual glyphs. Has no effect when text-use-harfbuzz " "is true, since HarfBuzz offers superior kerning support."))
ConfigVariableEnum< SamplerState::FilterType > | text_magfilter ("text-magfilter", SamplerState::FT_linear, PRC_DESC("The default texture magfilter type for dynamic text fonts"))
ConfigVariableInt | text_max_never_break ("text-max-never-break", 3, PRC_DESC("If we have more than this number of text-never-break-before " "characters in a row, do not treat any of them as special and " "instead break the line wherever we can."))
ConfigVariableEnum< SamplerState::FilterType > | text_minfilter ("text-minfilter", SamplerState::FT_linear, PRC_DESC("The default texture minfilter type for dynamic text fonts"))
ConfigVariableInt | text_page_size ("text-page-size", "256 256", PRC_DESC("This is the default size for new textures created for dynamic " "fonts."))
ConfigVariableDouble | text_poly_margin ("text-poly-margin", 0.0f, PRC_DESC("This is the amount by which to make each glyph polygon larger " "than strictly necessary, in screen units that are added to each " "margin. Increasing this value will decrease the tendency for " "letters to get chopped off at the edges, but it will also " "increase the tendency for adjacent glyphs to bleed into each " "other (unless you also increase text-texture-margin)."))
ConfigVariableInt | text_pop_properties_key ("text-pop-properties-key", 2, PRC_DESC("This is the decimal character number that undoes the " "effect of a previous appearance of text_push_properties_key."))
ConfigVariableInt | text_push_properties_key ("text-push-properties-key", 1, PRC_DESC("This is the decimal character number that, embedded in " "a string, is used to bracket the name of a TextProperties " "structure added to the TextPropertiesManager object, to " "control the appearance of subsequent text."))
ConfigVariableEnum< Texture::QualityLevel > | text_quality_level ("text-quality-level", Texture::QL_best, PRC_DESC("The default quality level for dynamic text fonts; see Texture::set_quality_level()."))
ConfigVariableEnum< TextFont::RenderMode > | text_render_mode ("text-render-mode", TextFont::RM_texture, PRC_DESC("The default render mode for dynamic text fonts"))
ConfigVariableBool | text_small_caps ("text-small-caps", false, PRC_DESC("This controls the default setting for " "TextNode::set_small_caps()."))
ConfigVariableDouble | text_small_caps_scale ("text-small-caps-scale", 0.8f, PRC_DESC("This controls the default setting for " "TextNode::set_small_caps_scale()."))
ConfigVariableInt | text_soft_break_key ("text-soft-break-key", 4, PRC_DESC("This is similar to text-soft-hyphen-key, except that " "when it is used as a break point, no character is " "introduced in its place."))
ConfigVariableInt | text_soft_hyphen_key ("text-soft-hyphen-key", 3, PRC_DESC("This is the decimal character number that, embedded in a " "string, is identified as the soft-hyphen character."))
ConfigVariableDouble | text_tab_width ("text-tab-width", 5.0f, PRC_DESC("This controls the default setting for " "TextNode::set_tab_width()."))
ConfigVariableInt | text_texture_margin ("text-texture-margin", 2, PRC_DESC("This is the number of texels of empty space reserved around each " "glyph in the texture. Setting this value larger will decrease " "the tendency for adjacent glyphs to bleed into each other at " "small sizes, but it will increase amount of wasted texture " "memory."))
ConfigVariableBool | text_use_harfbuzz ("text-use-harfbuzz", false, PRC_DESC("Set this true to enable HarfBuzz support, which offers superior " "text shaping and better support for non-Latin text."))
ConfigVariableEnum< SamplerState::WrapMode > | text_wrap_mode ("text-wrap-mode", SamplerState::WM_border_color, PRC_DESC("The default wrap mode for dynamic text fonts"))

## Detailed Description

PANDA 3D SOFTWARE Copyright (c) Carnegie Mellon University.

All rights reserved.

All use of this software is subject to the terms of the revised BSD license. You should have received a copy of this license along with this source code in a file named "LICENSE."

Author
  drose

Date
  2000-03-02

Definition in file config_text.cxx.

## Function Documentation

## ◆ init_libtext()

void init_libtext | ( |  | ) |

Initializes the library.

This must be called at least once before any of the functions or classes in this library can be used. Normally it will be called by the static initializers and need not be called explicitly, but special cases exist.

Definition at line 227 of file config_text.cxx.

References PandaSystem::add_system(), PandaSystem::get_global_ptr(), and GeomTextGlyph::register_with_read_factory().