pammosaicknit(1)

1Pammosaicknit User Manual(0)                      Pammosaicknit User Manual(0)
2
3
4
5<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
6    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
7
8
9<meta http-equiv="content-type" content="text/html; charset=us-ascii" />
10
11       Table Of Contents ⟨#contents⟩
12
13

NAME

15       pammosaicknit - validate a mosaic knitting pattern
16
17
18

SYNOPSIS

20       pammosaicknit [in_netpbmfile]
21
22

DESCRIPTION

24       This program is part of Netpbm(1).
25
26       pammosaicknit   helps   the   user   create  mosaic  knitting  patterns
27       ⟨http://en.wikipedia.org/wiki/Slip-stitch_knitting#Mosaic_knitting⟩   .
28       The  program  inputs  a  black-and-white  Netpbm image that describes a
29       mosaic knitting pattern and outputs a color Netpbm image  of  the  same
30       pattern but with invalid runs shown in red.
31
32       A  valid  knitting pattern starts with a <q>black</q> row on the bottom
33       and alternates <q>white</q> and <q>black</q> rows. A  <q>black</q>  row
34       can contain any arrangement of black pixels but no more than three con‐
35       secutive white pixels. A <q>white</q> row can contain  any  arrangement
36       of  white  pixels but no more than three consecutive black pixels. Col‐
37       umns wrap horizontally, so a <q>white</q> row that both begins and ends
38       with  two black pixels is deemed to contain four consecutive black pix‐
39       els. Because this is an invalid number for a  <q>white</q>  row,  those
40       four pixels will be recolored red in the output image.
41
42       For clarity, there are two shades of red in the output image.  Dark red
43       pixels indicate pixels that were black in the  input  image  but  which
44       must contain one or more white pixels. Light red pixels indicate pixels
45       that were white in the input image but which must contain one  or  more
46       black pixels.
47
48       If the output image contains no red pixels, then the input image repre‐
49       sents a valid mosaic knitting pattern.
50
51
52

ARGUMENTS

54       pammosaicknit's only argument, in_netpbmfile, is the name of  an  image
55       file  that  represents  a mosaic knitting pattern. If you don't specify
56       in_netpbmfile, the program reads the image from Standard Input.
57
58
59

NOTES

61       If the input image is not a black-and-white image,  pammosaicknit  con‐
62       verts  it  internally  to  black and white by thresholding each pixel's
63       luminosity. The output image is always a color image containing at most
64       four colors (black, white, dark red, light red).
65
66
67

HISTORY

76       pammosaicknit was new in Netpbm 10.53 (December 2010).
77
78
79

AUTHOR

81       Copyright (C) 2010 Scott Pakin, scott+pbm@pakin.org.
82
83
84

86       ·
87
88              SYNOPSIS ⟨#synopsis⟩
89
90       ·
91
92              DESCRIPTION ⟨#description⟩
93
94       ·
95
96              ARGUMENTS ⟨#arguments⟩
97
98       ·
99
100              NOTES ⟨#notes⟩
101
102       ·
103
104              SEE ALSO ⟨#see_also⟩
105
106       ·
107
108              HISTORY ⟨#history⟩
109
110       ·
111
112              AUTHOR ⟨#author⟩
113
114
115
116netpbm documentation           12 December 2010   Pammosaicknit User Manual(0)