MFEKstroke

NAME
DESCRIPTION
USAGE
OPTIONS
SUBCOMMANDS

NAME

MFEKstroke − manual page for MFEKstroke git-rev-3a65ce1

DESCRIPTION

MFEKstroke

Matthew Blanchard <matthewrblanchard@gmail.com>; Fredrick R. Brennan <copypaste???kittens???ph>; MFEK Authors

A utility for applying stroking techniques to contours (in UFO .glif format).

USAGE

MFEKstroke <SUBCOMMAND>

OPTIONS

−h, −−help

Print help information

SUBCOMMANDS

CWS

Takes a .glif file and strokes it at a constant width.

DASH

Applies a dash to a glyph.

NIB

Takes a nib and a path, both in .glif format, and emulates a pen, with the chosen nib, stroking the path.

Important note: FontForge is used for this, so it may be more unstable than other modes as FontForge is implemented in C and not memory safe. To prevent bugs, we turn off simplification and overlap removal. Use MFEK for that.

PAP

Maps a pattern glyph along a path glyph.

VWS

Takes a .glif file and strokes it with variable width.

MFEKstroke-CWS
MFEKstroke−CWS 0.1

Fredrick R. Brennan <copypaste???kittens???ph>; Matthew Blanchard <matthewrblanchard@gmail.com>

Takes a .glif file and strokes it at a constant width.

USAGE

MFEKstroke CWS [OPTIONS] −−input <input> −−output <output>

OPTIONS
−s
, −−startcap <startcap>

Either the constant strings "circle", "round" or "square", or a .glif file. [default: circle]

−e, −−endcap <endcap>

Either the constant strings "circle", "round" or "square", or a .glif file. [default: circle]

−i, −−input <input>

The path to the input file.

−j, −−jointype <jointype>

How to join discontinuous splines [default: round] [possible values: round, circle, miter, bevel]

−o, −−output <output>

The path where the output will be saved.

−w, −−width <width>

<f64> Constant stroke width.

−l, −−left <left>

<f64> Constant stroke width (left).

−r, −−right <right>

<f64> Constant stroke width (right).

−I, −−remove−internal

Remove internal contour

−E, −−remove−external

Remove external contour

−S, −−segmentwise

Join all segments with caps (stroke all B??zier segments one by one)

−h, −−help

Print help information

MFEKstroke-DASH
MFEKstroke−DASH 0.1.0

Fredrick R. Brennan <copypaste???kittens.ph>; MFEK Authors; Skia/kurbo.rs authors

Applies a dash to a glyph.

USAGE

MFEKstroke DASH [OPTIONS] −−input <input> −−output <output>

OPTIONS
−i
, −−input <input>

The path to the input glif file.

−o, −−output <output>

The path to the output glif file.

−d, −−dash−description <dash>...

Dash description [default: 30 30]

−c, −−cull

Attempt to cull earlier dashes when later dashes cover them

−w, −−width <width>

Stroke width (to leave an open contour, use 0) [default: 30]

−W, −−cull−width <cull−width>

Cull width [default: 40]

−a, −−min−area <area>

Paths with either a height or width below this number are culled. Do not set if unsure.

−l, −−write−last

Write last path

−j, −−join <join−type>

How to join discontinuous splines [default: round] [possible values: round, miter, bevel]

−J, −−cap <cap−type>

How to cap splines [default: round] [possible values: round, butt, square]

−h, −−help

Print help information

MFEKstroke-NIB
MFEKstroke−NIB 0.1.0

Fredrick R. Brennan <copypaste???kittens???ph>; Skef Iterum (FontForge)

Takes a nib and a path, both in .glif format, and emulates a pen, with the chosen nib, stroking the path.

Important note: FontForge is used for this, so it may be more unstable than other modes as FontForge is implemented in C and not memory safe. To prevent bugs, we turn off simplification and overlap removal. Use MFEK for that.

USAGE

MFEKstroke NIB [OPTIONS] −−nib <nib> −−input <input> −−output <output>

OPTIONS
−n
, −−nib <nib>

The path to the nib file. FontForge is quite strict about these. The .glif must contain a single closed spline, running clockwise, which represents a convex shape.

−i, −−input <input>

The path to the input path file.

−o, −−output <output>

The path where the output .glif will be saved.

−a, −−accuracy <accuracy>

<f64> Accuracy target [default: 0.25]

−h, −−help

Print help information

MFEKstroke-PAP
MFEKstroke−PAP 0.2.1

Matthew Blanchard <matthewrblanchard@gmail.com>; Fredrick R. Brennan <copypaste???kittens.ph>; MFEK Authors

Maps a pattern glyph along a path glyph.

USAGE

MFEKstroke PAP [OPTIONS] −−path <path>

OPTIONS
−p
, −−pattern <pattern>

The path to the input pattern file. You may also provide either −−dot−pattern or −−dash−pattern to use built−in patterns.

−=, −−dash−pattern

Use a simple dash pattern

−., −−dot−pattern

Use a simple dot pattern

−P, −−path <path>

The path to the input path file.

−o, −−output <output>

The path where the output will be saved. If omitted, or ‘−‘, stdout.

−c, −−contour <contour>

<isize> if this is a positive number we stroke only that specific contour in the outline by index. [default: -1]

−m, −−mode <mode>

Repeat mode. [default: single] [possible values: single, repeated]

−s, −−subdivide <subdivide>

<usize> how many times to subdivide the patterns at their midpoint. [default: 0]

−X, −−sx <sx>

<f64> how much we scale our input pattern on the x−axis. [default: 1]

−Y, −−sy <sy>

<f64> how much we scale our input pattern on the y−axis. [default: 1]

−n, −−noffset <normal−offset>

<f64> how much to offset the pattern along the normal of the path. [default: 0]

−t, −−toffset <tangent−offset>

<f64> how much to offset the pattern along the tangent of the path. [default: 0]

−W, −−spacing <spacing>

<f64> how much padding to trail each copy with. [default: 0]

−!, −−stretch <stretch>

<stretch> false if not given, true if given, spacing mode if value of spacing given [possible values: spacing]

−S, −−simplify

<boolean> if we should run the result through Skia’s (buggy) simplify routine.

−O, −−overdraw <overdraw>

<f64> pattern copies overlapping more than arg% are removed. [default: 100%]

−Q, −−one−pass

<boolean> whether we should not reflow the path after culling during overdraw (faster but worse).

−C, −−no−center−pattern

<boolean> supply if you wish to center the pattern

−r, −−reverse

<boolean> true will reverse the path.

−R, −−reverse−culling

<boolean> true will reverse the order we check for overlaps during overlap culling.

−h, −−help

Print help information

MFEKstroke-VWS
MFEKstroke−VWS 0.1

Matthew Blanchard <matthewrblanchard@gmail.com>

Takes a .glif file and strokes it with variable width.

USAGE

MFEKstroke VWS −i <input> −o <output>

OPTIONS
−h
, −−help

Print help information

−i <input>

The path to the input file.

−o <output>

The path where the output will be saved.

−V, −−version