{
    "content": [
        {
            "type": "text",
            "text": "# ps2pk (man)\n\n## NAME\n\nps2pk - creates a TeX pkfont from a type1 PostScript font\n\n## SYNOPSIS\n\nps2pk  [ -v ] [ -eenc ] [ -Xxres ] [ -Eexpansion ] [ -Sslant  ] [ -Ppointsize ] [ -Rbaseres ]\n[ -raspectratio  ] [ -Yyres ] [ -aAFMfile ] [ -mmodename ] type1 [pkfont]\n\n## DESCRIPTION\n\nThis program renders a given type1 PostScript font at a given pointsize (default 10.0 points)\nand resolution (default 300dpi) into a TeX pkfont.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION** (1 subsections)\n- **ACKNOWLEDGEMENT**\n- **SEE ALSO**\n- **VERSION**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "ps2pk",
        "section": "",
        "mode": "man",
        "summary": "ps2pk - creates a TeX pkfont from a type1 PostScript font",
        "synopsis": "ps2pk  [ -v ] [ -eenc ] [ -Xxres ] [ -Eexpansion ] [ -Sslant  ] [ -Ppointsize ] [ -Rbaseres ]\n[ -raspectratio  ] [ -Yyres ] [ -aAFMfile ] [ -mmodename ] type1 [pkfont]",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [
            {
                "flag": "",
                "long": null,
                "arg": null,
                "description": "The desired aspect ratio (expression, integerY/integerX, default 300/300). This will be shown in the \"specials\" at the end of the pkfont. Setting the aspect ra‐ tio creates a value for yres but an explicit yres value will take precedence. Argument must be in \"\" if spaces are left around `/'. -Sslant The slant (real value, default 0.0). -Xxres The resolution in the X direction (integer value, default 300 dpi). -Yyres The resolution in the Y direction (integer value, default the value of xres). If yres differs from xres, a \"special\" text giving the aspect ratio will be written at the end of the pkfont. -v Verbose flag. (Tells what the program is doing.) type1 The name of the PostScript type1 font. The name of the AFM-file will be con‐ structed from this name by removing the extension (if suplied) and adding \".afm\". The PostScript \"FontName\" is extracted from the AFM-file and written into a \"spe‐ cial\" at the end of the pkfont. [pkfont] The name of the resulting pkfont can be overruled with this name. The default name of pkfont is derived from the basename of the type1 font, the pointsize and xres. For example `ps2pk -P17.28 Utopia-Regular' will result in `Utopia-Regu‐ lar17.300pk'. An explicit value for the name of the pkfont is necessary when the type1 font name already shows the point size, otherwise the pointsize value is catenated on to the pkfont basename which is usually not what is wanted. The following PK \"specials\" provide an internal check on the characteristics of the pkfont, in accordance with the recommendations of the TeX Working Group on the TeX Directory Standard (TWG-TDS): \"fontid=FontName\", \"codingscheme=Encoding\", \"fontfacebyte\", \"mag\", \"mode=(ps2pk)modename\", \"pixels-per-inch\", and \"aspect-ratio\" if it is other than unity."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "afm2tfm",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/afm2tfm/1/json"
            },
            {
                "name": "pk2bm",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/pk2bm/1/json"
            },
            {
                "name": "kpsewhich",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/kpsewhich/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 59,
                "subsections": [
                    {
                        "name": "-r_aspectratio_",
                        "lines": 41
                    }
                ]
            },
            {
                "name": "ACKNOWLEDGEMENT",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 10,
                "subsections": []
            },
            {
                "name": "VERSION",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 9,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "ps2pk - creates a TeX pkfont from a type1 PostScript font\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "ps2pk  [ -v ] [ -eenc ] [ -Xxres ] [ -Eexpansion ] [ -Sslant  ] [ -Ppointsize ] [ -Rbaseres ]\n[ -raspectratio  ] [ -Yyres ] [ -aAFMfile ] [ -mmodename ] type1 [pkfont]\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "This program renders a given type1 PostScript font at a given pointsize (default 10.0 points)\nand resolution (default 300dpi) into a TeX pkfont.\n\nTo  generate  the  pkfont  ps2pk  needs  a valid type1 font file (for example Utopia-Regular,\nUtopia-Regula.pfb or Utopia-Regula.pfa) and its corresponding  AFM-file  (Utopia-Regular.afm)\nwith  the font metrics.  The program accepts both the binary type1 format (Utopia-Regula.pfb)\nand its ASCII equivalent (Utopia-Regular or Utopia-Regula.pfa).  To locate the  files,  ps2pk\nuses  the  kpathsea  library (see the info page on kpathsea). Additionally, pfb and pfa files\nare searched for in the directory specified in the environment  variable  T1INPUTS,  and  afm\nfiles  are searched in AFMFONTS, if they are set (the -v flag will report which filenames are\nlooked for).\n\nThe program will make a pkfont in which the character codes are derived from their AFM (Adobe\nFont  Metrics) defined values.  This can be overruled by specifying an explicit encoding file\nvia the -e option.  The encoding file enc should contain a valid PostScript encoding contain‐\ning  PostScript  names like /hyphen.  Here is an incomplete example (see afm2tfm for complete\nsyntax):\n\n% This is the EC encoding.\n/ECEncoding [          % now 256 chars follow\n% 0x00\n/grave /acute /circumflex /tilde /dieresis /hungarumlaut\n/ring /caron /breve /macron /dotaccent /cedilla\n/ogonek /quotesinglbase /guilsinglleft /guilsinglright\n\n(Rest of lines omitted.)\n\n% 0xF0\n/eth /ntilde /ograve /oacute /ocircumflex /otilde\n/odieresis /oe /oslash /ugrave /uacute /ucircumflex\n/udieresis /yacute /thorn /germandbls ] def\n\nOptions and arguments:\n\n-aAFMfile   Overrules the name that is used to locate the AFM file.\n\n\n-eenc       Name of a file containing an encoding scheme (default - the encoding named in the\nAFM-file  is used).  The actual PostScript name of the encoding scheme is written\nas a \"special\" at the end of the pkfont.\n\n\n-Eextension The extension factor (real value, default 1.0).\n\n\n-mmodename  A modename such as would be used by METAFONT (default \"Unknown mode\").\n\n\n-Ppointsize The desired pointsize (real value, default 10.0 points).\n\n\n-Rbaseres   The desired base resolution (integer value, default 300 dpi).   If  this  differs\nfrom  the value of xres, the appropriate magnification will be shown in the \"spe‐\ncials\" at the end of the pkfont. If possible, this will be expressed  as  a  mag‐\nstep,  otherwise as a real number. For example, a pkfont with an xres of 329, us‐\ning the default base resolution of 300, will include the \"special\" text \"mag=mag‐\nstep(0.5)\" at the end of the font.\n\n",
                "subsections": [
                    {
                        "name": "-r_aspectratio_",
                        "content": "The  desired aspect ratio (expression, integerY/integerX, default 300/300).  This\nwill be shown in the \"specials\" at the end of the pkfont.  Setting the aspect ra‐\ntio  creates  a  value  for yres but an explicit yres value will take precedence.\nArgument must be in \"\" if spaces are left around `/'.\n\n\n-Sslant     The slant (real value, default 0.0).\n\n\n-Xxres      The resolution in the X direction (integer value, default 300 dpi).\n\n\n-Yyres      The resolution in the Y direction (integer value, default the value of xres).  If\nyres  differs from xres, a \"special\" text giving the aspect ratio will be written\nat the end of the pkfont.\n\n\n-v          Verbose flag. (Tells what the program is doing.)\n\n\ntype1       The name of the PostScript type1 font.  The name of the  AFM-file  will  be  con‐\nstructed from this name by removing the extension (if suplied) and adding \".afm\".\nThe PostScript \"FontName\" is extracted from the AFM-file and written into a \"spe‐\ncial\" at the end of the pkfont.\n\n\n[pkfont]    The  name  of  the resulting pkfont can be overruled with this name.  The default\nname of pkfont is derived from the basename of the type1 font, the pointsize  and\nxres.   For  example  `ps2pk -P17.28 Utopia-Regular' will result in `Utopia-Regu‐\nlar17.300pk'.  An explicit value for the name of the pkfont is necessary when the\ntype1  font  name  already shows the point size, otherwise the pointsize value is\ncatenated on to the pkfont basename which is usually not what is wanted.\n\n\nThe following PK \"specials\" provide an internal check on the characteristics of  the  pkfont,\nin accordance with the recommendations of the TeX Working Group on the TeX Directory Standard\n(TWG-TDS):\n\"fontid=FontName\", \"codingscheme=Encoding\",  \"fontfacebyte\",  \"mag\",  \"mode=(ps2pk)modename\",\n\"pixels-per-inch\", and \"aspect-ratio\" if it is other than unity.\n\n"
                    }
                ]
            },
            "ACKNOWLEDGEMENT": {
                "content": "This  program  uses the Type1 hinting and rendering software IBM has donated to the X Consor‐\ntium.\n\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "`METAFONT: The Program', Donald Knuth.\n`The GFtoPK processor', belonging to the METAFONTware.\n`Adobe Font Metric Files', Version 3.0, PostScript Developer\nSupport Group.\nafm2tfm(1)\npk2bm(1)\nkpsewhich(1)\ninfo kpathsea\n\n",
                "subsections": []
            },
            "VERSION": {
                "content": "1.4 (January 1994)\n\n",
                "subsections": []
            },
            "AUTHOR": {
                "content": "Piet Tutelaers, modified for ps2pkm by Pierre A. Mackay.  This manpage was adapted  to  teTeX\nby Frank Kuester.\n\nMaintained  in  TeX  Live;  please  send bug reports or other correspondence to tex-k@tug.org\n(http://lists.tug.org/tex-k).\n\n\n\n1 Feb 2016                                     PS2PK(1)",
                "subsections": []
            }
        }
    }
}