diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/fontspec/fontspec-doc-xetex.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/fontspec/fontspec-doc-xetex.tex | 68 |
1 files changed, 55 insertions, 13 deletions
diff --git a/Master/texmf-dist/source/latex/fontspec/fontspec-doc-xetex.tex b/Master/texmf-dist/source/latex/fontspec/fontspec-doc-xetex.tex index 62bae7e44d1..e0ae035e4e0 100644 --- a/Master/texmf-dist/source/latex/fontspec/fontspec-doc-xetex.tex +++ b/Master/texmf-dist/source/latex/fontspec/fontspec-doc-xetex.tex @@ -1,4 +1,9 @@ +%%^^A%% fontspec-doc-xetex.tex -- part of FONTSPEC <wspr.io/fontspec> +\documentclass[a4paper]{l3doc} +\usepackage{fontspec-doc-style} +\showexamplesfalse +\begin{document} \part{Fonts and features with \XeTeX} \label{sec:xetex-features} @@ -11,7 +16,7 @@ selected by \pkg{fontspec}. \subsection{Mapping} \label{sec:mapping} -\feat{Mapping} enables a \XeTeX\ text-mapping scheme, shown in \exref{mapping}. +The \feat{Mapping} feature enables a \XeTeX\ text-mapping scheme, with an example shown in \exref{mapping}. \begin{Xexample}{mapping}{\XeTeX's \feat{Mapping} feature.} \fontspec{Cochin}[Mapping=tex-text] @@ -25,22 +30,22 @@ The use of the latter syntax is recommended for better compatibility with \LuaTeX\ documents. -\subsection{Different font technologies: \AAT\ and OpenType}\label{sec:renderer} +\subsection{Different font technologies: \AAT, OpenType, and Graphite}\label{sec:renderer} -\XeTeX\ supports two rendering technologies for typesetting, selected with +\XeTeX\ supports three rendering technologies for typesetting, selected with the \feat{Renderer} font feature. The first, \opt{AAT}, is -that provided (only) by \MacOSX\ itself. The second, \opt{OpenType}, -is an open source OpenType interpreter. -\note{v2.4: This was called `\texttt{ICU}' in previous versions of \XeTeX\ and \pkg{fontspec}. -Backwards compatibility is preserved.} -It provides greater support for -OpenType features, notably contextual arrangement, over \opt{AAT}. - -In general, this feature will not need to be explicitly called: for OpenType +that provided only by \MacOSX. +The second, \opt{OpenType}, is an open source OpenType interpreter. +It provides greater support for OpenType features, notably contextual arrangement, over \opt{AAT}. +The third is \opt{Graphite}, which is an alternative to OpenType with particular features for less-common languages and the capability for more powerful font options. +Features for \opt{OpenType} have already been discussed in \vref{sec:opentype-features}; +\opt{Graphite} and \opt{AAT} features are discussed later in \vref{sec:graphite-features} and \vref{sec:aat-features}. + +Unless you have a particular need, the \feat{Renderer} feature is rarely explicitly required: for OpenType fonts, the \opt{OpenType} renderer is used automatically, and for \AAT\ fonts, \opt{AAT} is chosen by default. Some fonts, however, will contain font tables -for \emph{both} rendering technologies, such as the Hiragino Japanese fonts -distributed with \MacOSX, and in these cases the choice may be required. +for multiple rendering technologies, such as the Hiragino Japanese fonts +distributed with \MacOSX, and in these cases one over the other may be preferred. Among some other font features only available through a specific renderer, \opt{OpenType} provides for the \feat{Script} and \feat{Language} features, which allow @@ -72,6 +77,29 @@ explicitly. \end{Verbatim} +\section{The Graphite renderer} +\label{sec:graphite-features} + +Since the Graphite renderer is designed for less common scripts and languages, usually with +specific or unique requirements, Graphite features are not standard across fonts. + +Currently \pkg{fontspec} does not support a convenient interface to select Graphite font +features and all selection must be done via `raw' font feature selection. + +Here's an example: +\begin{Verbatim} + \fontspec{Charis SIL}[ + Renderer=Graphite, + RawFeature={Uppercase Eng alternates=Large eng on baseline}] + Ŋ +\end{Verbatim} + +Here's another: +\begin{Verbatim} +\fontspec{AwamiNastaliq-Regular.ttf}[Renderer=Graphite] ^^^^06b5 +\addfontfeature{RawFeature={Lam with V=V over bowl}} ^^^^06b5 +\end{Verbatim} + \section{\MacOSX's \AAT\ fonts} @@ -334,3 +362,17 @@ options: \opt{Off}, \opt{Parenthesis}, \opt{Period}, \opt{RomanNumerals}, \opt{Diamond}, \opt{BlackSquare}, \opt{BlackRoundSquare}, and \opt{DoubleCircle}. +\end{document} + +% /© +% ------------------------------------------------ +% The FONTSPEC package <wspr.io/fontspec> +% ------------------------------------------------ +% Copyright 2004-2017 Will Robertson, LPPL "maintainer" +% Copyright 2009-2013 Khaled Hosny +% ------------------------------------------------ +% This package is free software and may be redistributed and/or modified under +% the conditions of the LaTeX Project Public License, version 1.3c or higher +% (your choice): <http://www.latex-project.org/lppl/>. +% ------------------------------------------------ +% ©/ |