Number: 1482
Title: fontname documentation
Submitter: Stephen North
Date: Wed Oct 15 14:42:08 2008
Subsys: Dot
Version: 2.21.0
System: *-*-
Severity: minor
Problem:
Documentation needs to explain when a Pango font specification is allowed, and when a fontconfig specification is allowed.
Comments:
For extra credit, convert one into the other :-)

[ellson] Assuming you have graphviz built with pangocairo, the syntax for dot's fontname attribute is pango's:


   "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]"
ref:

   http://library.gnome.org/devel/pango/unstable/pango-Fonts.html#pango-font-description-from-string
so:

    fontname="Calibri Bold"
should give you what you want.

The current version of dot ignores any [SIZE] value and uses its own default, or the value given by "fontsize=..." instead. We will investigate to see if we can at least accept pango's [SIZE] to override dot's default.

If you don't have pangocairo installed, then fontname is interpreted by the gd library and fontconfig, which unfortunately uses a different syntax:


   fontname="Calibri:style=Bold"
should work. My personal feeling is, don't use graphviz without pangocairo, but perhaps we can do something to make the syntax for uniform in this scenario.

If neither pangocairo nor fontconfig are available, then we fallback to some internal bitmap fonts. In this scenario its probably best to just stick with the default font.
Owner: *
Status: *