pammosaicknit(1)

1Pammosaicknit User Manual(0)                      Pammosaicknit User Manual(0)
2
3
4
5       Table Of Contents ⟨#contents⟩
6
7

NAME

9       pammosaicknit - validate a mosaic knitting pattern
10
11
12

SYNOPSIS

14       pammosaicknit [in_netpbmfile]
15
16

DESCRIPTION

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

ARGUMENTS

48       pammosaicknit's only argument, in_netpbmfile, is the name of  an  image
49       file  that  represents  a mosaic knitting pattern. If you don't specify
50       in_netpbmfile, the program reads the image from Standard Input.
51
52
53

NOTES

55       If the input image is not a black-and-white image,  pammosaicknit  con‐
56       verts  it  internally  to  black and white by thresholding each pixel's
57       luminosity. The output image is always a color image containing at most
58       four colors (black, white, dark red, light red).
59
60
61

HISTORY

70       pammosaicknit was new in Netpbm 10.53 (December 2010).
71
72
73

AUTHOR

75       Copyright (C) 2010 Scott Pakin, scott+pbm@pakin.org.
76
77
78

80       ·
81
82              SYNOPSIS ⟨#synopsis⟩
83
84       ·
85
86              DESCRIPTION ⟨#description⟩
87
88       ·
89
90              ARGUMENTS ⟨#arguments⟩
91
92       ·
93
94              NOTES ⟨#notes⟩
95
96       ·
97
98              SEE ALSO ⟨#see_also⟩
99
100       ·
101
102              HISTORY ⟨#history⟩
103
104       ·
105
106              AUTHOR ⟨#author⟩
107

DOCUMENT SOURCE

109       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
110       source.  The master documentation is at
111
112              http://netpbm.sourceforge.net/doc/pammosaicknit.html
113
114netpbm documentation           12 December 2010   Pammosaicknit User Manual(0)