Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
FC-MATCH(1)							     FC-MATCH(1)

NAME
     fc-match - match available fonts

SYNOPSIS
     fc-match [ -asvVh ]  [ --all ]  [ --sort ]  [ --verbose ]	[  [ -f format ]
     [ --format format ]  ]  [ --version ]  [ --help ]

      [ pattern  [ element... ]   ]

DESCRIPTION
     fc-match  matches pattern (empty pattern by default) using the normal font-
     config matching rules to find the best font available. If --sort is  given,
     the  sorted  list	of  best  matching fonts is displayed.	The --all option
     works like --sort except that no pruning is done on the list of fonts.

     If any elements are specified, only those	are  printed.	Otherwise  short
     file  name,  family,  and	style  are printed, unless verbose output is re-
     quested.

OPTIONS
     This program follows the usual GNU command line syntax, with  long  options
     starting with two dashes (`-'). A summary of options is included below.

     -a     Displays sorted list of best matching fonts, but do not do any prun-
	    ing on the list.

     -s     Displays sorted list of best matching fonts.

     -v     Print  verbose  output  of the whole font pattern for each match, or
	    elements if any is provided.

     -f     Format output according to the format specifier format.

     -V     Show version of the program and exit.

     -h     Show summary of options.

     pattern
	    Displays fonts matching pattern (uses empty pattern by default).

     element
	    If set, the element property is displayed for matching fonts.

EXAMPLES
     fc-match sans
	    Display the best matching font categorized into  sans-serif  generic
	    family, filtered by current locale

     fc-match sans:lang=en
	    Display  the  best matching font categorized into sans-serif generic
	    family, filtered by English language

     fc-match sans:lang=en:weight=bold
	    Display the best matching font categorized into  sans-serif  generic
	    family, filtered by English language and weight is bold.

SEE ALSO
     fc-list(1)  FcFontMatch(3)  FcFontSort(3)	FcPatternFormat(3) fc-cat(1) fc-
     cache(1) fc-pattern(1) fc-query(1) fc-scan(1)

     The   fontconfig	user's	 guide	 <URL:https://fontconfig.pages.freedesk-
     top.org/fontconfig/fontconfig-user.html>

AUTHOR
     This manual page was updated by Patrick Lam <plam@csail.mit.edu>.

				  Aug 13, 2008			     FC-MATCH(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fc-match&sektion=1&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help