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 for-
       mat ]  [	--format format	]  ]  [	--version ]  [ --help ]

	[ pattern  [ element...	]   ]

DESCRIPTION
       fc-match	 matches  pattern  (empty pattern by default) using the	normal
       fontconfig 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 op-
       tions starting with two dashes (`-'). A summary of options is  included
       below.

       -a     Displays	sorted	list of	best matching fonts, but do not	do any
	      pruning 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, in HTML format: /usr/share/doc/fontcon-
       fig/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+Ports+14.3.quarterly>

home | help