10.2 Invoking Limn

This section lists the options that Limn accepts in alphabetic order. The previous section described many of these options in the context of the fitting algorithm.

See section 3.3 Command-line options, for general option syntax.

The root of the main input fontname is called font-name below.

`-align-threshold real'

If either coordinate of the endpoints on a spline is closer than this, make them the same; default is .5. See section 10.1.8 Aligning endpoints.

`-corner-always-threshold angle-in-degrees'

If the angle at a pixel is less than this, it is considered a corner, even if it is within `corner-surround' pixels of another corner; default is 60. See section 10.1.2 Finding corners.

`-corner-surround unsigned'

Number of pixels on either side of a point to consider when determining if that point is a corner; default is 4. See section 10.1.2 Finding corners.

`-corner-threshold angle-in-degrees'

If a pixel, its predecessor(s), and its successor(s) meet at an angle smaller than this, it's a corner; default is 100. See section 10.1.2 Finding corners.

`-display-continue'

If you specified `-do-display', do not wait for you to hit return after displaying each character online. See section 10.1.9 Displaying fitting online.

`-display-grid-size unsigned'

Number of expanded pixels between the grid lines; default is 10. See section 10.1.9 Displaying fitting online.

`-display-pixel-size unsigned'

Length of one side of the square that each pixel expands into; default is 9. See section 10.1.9 Displaying fitting online.

`-display-rectangle-size unsigned'

Length of one side of the square drawn to represent input pixels; default is 6. Must be less than `display-pixel-size'. See section 10.1.9 Displaying fitting online.

`-do-display'

Show the results of the fitting in an X window, if the X server specified in the DISPLAY environment variable can be opened. See section 10.1.9 Displaying fitting online.

`-dpi unsigned'

The resolution, in pixels per inch. See section 3.3.2 Common options.

`-error-threshold real'

Subdivide fitted curves that are off by more pixels than this; default is 2.0. See section 10.1.5.4 Reparameterization.

`-filter-alternative-surround unsigned'

Another choice for filter-surround; default is 1. See section 10.1.4 Filtering curves.

`-filter-epsilon real'

If the angles using `filter-surround' and `filter-alternative-surround' points differ by more than this, use the latter; default is 10.0. See section 10.1.4 Filtering curves.

`-filter-iterations unsigned'

Smooth the curve this many times before fitting; default is 4. See section 10.1.4 Filtering curves.

`-filter-percent percent'

When filtering, use the old point plus distance of neighbors multiplied by this (as a percentage) to determine the new point; default is 33. See section 10.1.4 Filtering curves.

`-filter-surround unsigned'

Number of pixels on either side of a point to consider when filtering that point; default is 2. See section 10.1.4 Filtering curves.

`-help'

Print a usage message. See section 3.3.2 Common options.

`-keep-knees'

Do not remove "knees"---points on the inside of the outline that are between two others. See section 10.1.3 Removing knees.

`-line-reversion-threshold real'

If a spline is closer to a straight line than this, keep it a straight line even if it is a list with curves; default is .01 pixels. See section 10.1.7 Changing lines to splines.

`-line-threshold real'

If a spline is not more than this far away from the straight line defined by its endpoints, then output a straight line; default is 1. See section 10.1.6 Changing splines to lines.

`-log'

Write detailed progress reports to `font_name.log'.

`-output-file filename'

Write to filename if it has a suffix and to `filename.bzr' if it doesn't. Default is `font-name.bzr'.

`-range char1-char2'

Only output characters with codes between char1 and char2, inclusive. (See section 3.3.2 Common options, and 3.3.3 Specifying character codes.)

`-reparameterize-improve percent'

If reparameterization doesn't improve the fit by this much, as a percentage, then stop reparameterizing; default is 10. See section 10.1.5.4 Reparameterization.

`-reparameterize-threshold real'

If an initial fit is off by more pixels than this, don't bother to reparameterize; default is 30. See section 10.1.5.4 Reparameterization.

`-subdivide-search percent'

Percentage of the curve from the initial guess for a subdivision point to look for a better one; default is 10. See section 10.1.5.5 Subdivision.

`-subdivide-surround unsigned'

Number of points on either side of a point to consider when looking for a subdivision point; default is 4. See section 10.1.5.5 Subdivision.

`-subdivide-threshold real'

If a point is this close or closer to a straight line, subdivide there; default is .03 pixels. See section 10.1.5.5 Subdivision.

`-tangent-surround unsigned'

Number of points on either side of a point to consider when computing the tangent at that point; default is 3. See section 10.1.5.2 Finding tangents.

`-verbose'

Output progress reports.

`-version'

Print the version number.