dwww Home | Manual pages | Find package

g.mkfontcap(1grass)         GRASS GIS User's Manual        g.mkfontcap(1grass)

NAME
       g.mkfontcap   - Generates the font configuration file by scanning vari-
       ous directories for fonts.

KEYWORDS
       general

SYNOPSIS
       g.mkfontcap
       g.mkfontcap --help
       g.mkfontcap   [-os]    [extradirs=string]      [--help]     [--verbose]
       [--quiet]  [--ui]

   Flags:
       -o
           Overwrite font configuration file if already existing

       -s
           Write  font  configuration file to standard output instead of $GIS-
           BASE/etc

       --help
           Print usage summary

       --verbose
           Verbose module output

       --quiet
           Quiet module output

       --ui
           Force launching GUI dialog

   Parameters:
       extradirs=string
           List of extra directories to scan
           Comma-separated list of extra directories to scan for Freetype-com-
           patible fonts as well as the defaults (see documentation)

DESCRIPTION
       g.mkfontcap  is  a  utilty  to generate a GRASS font configuration file
       ("fontcap") containing details of the fonts available  on  the  current
       system.  If Freetype is not installed, the font list will be limited to
       the set of Hershey stroke fonts supplied with GRASS. With Freetype  en-
       abled however, the module will recursively scan all files within a pre-
       defined hierarchy to find Freetype-compatible scalable fonts. The  list
       of directories scanned is currently:
           /usr/lib/X11/fonts
           /usr/share/X11/fonts
           /usr/share/fonts
           /usr/local/share/fonts
           ${HOME}/Library/Fonts
           /Library/Fonts
           /System/Library/Fonts
           ${WINDIR}/Fonts

       These correspond to directories where fonts can be found on some common
       operating systems. Extra directories to search can easily by added  us-
       ing  the  extradirs parameter, which accepts a comma-separated list. An
       extra directory may optionally contain an environment variable  at  the
       start of the string, if enclosed in ${xxx} syntax (see examples above).

       The  module  will normally write to the standard fontcap file location,
       $GISBASE/etc/fontcap. If the  environment  variable  GRASS_FONT_CAP  is
       set,  the  output will instead be written to the file specified by that
       variable. This is useful if you don’t have permission to  modify  $GIS-
       BASE/etc/fontcap: in this case you can use e.g.
       # use local file version instead of system copy
       GRASS_FONT_CAP=$HOME/.gfontcap
       export GRASS_FONT_CAP
       g.mkfontcap

       to  create a personal copy and then to make GRASS use that file instead
       of the system copy.

       The output list of fonts is sorted first by type (Stroke  fonts  first,
       followed  by  Freetype)  and  within each type by the short name of the
       font.

SEE ALSO
        d.font

AUTHOR
       Paul Kelly

SOURCE CODE
       Available at: g.mkfontcap source code (history)

       Accessed: unknown

       Main index | General index | Topics index | Keywords index |  Graphical
       index | Full index

       © 2003-2022 GRASS Development Team, GRASS GIS 7.8.7 Reference Manual

GRASS 7.8.7                                                g.mkfontcap(1grass)

Generated by dwww version 1.14 on Sun Dec 29 18:21:47 CET 2024.