PNMTextMaker

class PNMTextMaker

Bases: FreetypeFont

This object uses the Freetype library to generate text directly into an image. It is different from the TextNode/DynamicTextFont interface, which use the Freetype library to generate text in the scene graph, to be rendered onscreen via the Panda render traversal.

Inheritance diagram

enum Alignment

enumerator A_left = 0

enumerator A_right = 1

enumerator A_center = 2

explicit PNMTextMaker(Filename const &font_filename, int face_index)

explicit PNMTextMaker(char const *font_data, int data_length, int face_index)

explicit PNMTextMaker(FreetypeFont const &copy)

PNMTextMaker(PNMTextMaker const &copy)

The constructor expects the name of some font file that FreeType can read, along with face_index, indicating which font within the file to load (usually 0).

This constructor works as above, but it takes the font data from an in- memory buffer instead of from a named file.

int calc_width(std::string const &text)

int calc_width(std::wstring const &text): Returns the width in pixels of the indicated line of text.

int generate_into(std::string const &text, PNMImage &dest_image, int x, int y)

int generate_into(std::wstring const &text, PNMImage &dest_image, int x, int y): Generates a single line of text into the indicated image at the indicated position; the return value is the total width in pixels.

Alignment get_align(void) const

int get_distance_field_radius(void) const: Returns the radius previously set with set_distance_field_radius, or 0 otherwise.

LColor const &get_fg(void) const: Returns the foreground color of text that will be generated by future calls to generate_into().

PNMTextGlyph *get_glyph(int character): Returns the glyph for the indicated index, or NULL if it is not defined in the font.

LColor const &get_interior(void) const: Returns the color that will be used to render the interior portions of hollow fonts.

bool get_interior_flag(void) const

bool is_valid(void) const: Returns true if the PNMTextMaker is valid and ready to generate text, false otherwise.

void set_align(PNMTextMaker::Alignment align_type)

void set_distance_field_radius(int radius): If this is set to something other than 0, Panda will generate a signed distance field with the given radius.

void set_fg(LColor const &fg): Sets the foreground color of text that will be generated by future calls to generate_into(). This is the color that all of the “on” pixels in the font will show as.

void set_interior(LColor const &interior): Sets the color that will be used to render the interior portions of hollow fonts in future calls to generate_into(). This is respected only if interior_flag is true.

void set_interior_flag(bool interior_flag)

Sets the flag that indicates whether the interior of hollow fonts is identified as a preprocess as each glyph is loaded. If this flag is true, you may specify an interior color along with a fg and bg color when you place text; if the flag is false, the interior color is ignored.

It is generally best to set_native_antialias(0) when using this feature. Also, this works best when the pixel size is not very small.