summary refs log tree commit diff
path: root/bin/man3/png.3
blob: accffbd725a568859b641f86980becf0595769eb (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
.Dd July 25, 2019
.Dt PNG 3
.Os
.
.Sh NAME
.Nm png
.Nd basic PNG output
.
.Sh SYNOPSIS
.In png.h
.
.Ft void
.Fo pngHead
.Fa "FILE *file"
.Fa "uint32_t width"
.Fa "uint32_t height"
.Fa "uint8_t depth"
.Fa "uint8_t color"
.Fc
.
.Ft void
.Fn pngPalette "FILE *file" "const uint8_t *pal" "uint32_t len"
.
.Ft void
.Fn pngData "FILE *file" "const uint8_t *data" "uint32_t len"
.
.Ft void
.Fn pngTail "FILE *file"
.
.Sh DESCRIPTION
The
.Fn pngHead
function
writes the
.Sy IHDR
chunk to
.Fa file .
The
.Fa color
parameter can be one of
.Dv PNGGrayscale ,
.Dv PNGTruecolor
optionally
.Em or Ns 'ed
with
.Dv PNGAlpha ,
or
.Dv PNGIndexed .
.
.Pp
The
.Fn pngPalette
function
writes the
.Sy PLTE
chunk to
.Fa file .
.
.Pp
The
.Fn pngData
function
writes the
.Sy IDAT
chunk to
.Fa file
without compression.
The constants
.Dv PNGNone ,
.Dv PNGSub ,
.Dv PNGUp ,
.Dv PNGAverage ,
.Dv PNGPaeth
are defined
for use in PNG data.
.
.Pp
The
.Fn pngTail
function
writes the
.Sy IEND
chunk to
.Fa file .
.
.Sh ERRORS
Any errors from writing to
.Fa file
are handled by calling
.Xr err 3 .
?id=901e37ead8bdd1b8bde9a61e2d6217a48fd49192&follow=1'>Match sh functions as TagJune McEnroe 2019-02-18Match Sh and Ss as Tag in mdocJune McEnroe 2019-02-18Match statics and typedefs as TagJune McEnroe 2019-02-18Clean up htmlHeaderJune McEnroe 2019-02-18Remove hi line numberingJune McEnroe Tags are much better for referring to specific parts of a file and line numbering is better done by a post-processing tool such as cat -n or producing a two-column HTML <table>. 2019-02-18Add Tag class to hiJune McEnroe 2019-02-17Generate HTML with hi -n -f html -o anchorJune McEnroe Running hi twice to insert stuff between the head and the content is a bit of a hack but oh well. 2019-02-17Add hi -f html -o anchor for line number linksJune McEnroe 2019-02-17Simplify temp trap in upJune McEnroe 2019-02-17Add line numbers to hiJune McEnroe Renames previous -n option to -m to stay consistent with cat -n. Prefixing lines with line numbers affects where the first tab indent ends up relative to the text above it. Not sure if it's worth fixing somehow. 2019-02-17Always split spans after newlinesJune McEnroe Simplifies ANSI and IRC output code, and prepares for line numbered output. 2019-02-15Color format specifiers light cyan in vimJune McEnroe 2019-02-15Highlight Interp as yellowJune McEnroe 2019-02-15Highlight strings in sh command substitutionsJune McEnroe 2019-02-15Add nmap gpJune McEnroe 2019-02-14Avoid newline when copying URL to pasteboardJune McEnroe 2019-02-13Add forgotten "sixth" book of H2G2June McEnroe