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 .