]>
Commit | Line | Data |
---|---|---|
0272a10d VZ |
1 | |
2 | /* pngrio.c - functions for data input | |
3 | * | |
fff5f7d5 VZ |
4 | * Last changed in libpng 1.6.0 [February 14, 2013] |
5 | * Copyright (c) 1998-2013 Glenn Randers-Pehrson | |
0272a10d VZ |
6 | * (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger) |
7 | * (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.) | |
8 | * | |
b61cc19c PC |
9 | * This code is released under the libpng license. |
10 | * For conditions of distribution and use, see the disclaimer | |
11 | * and license in png.h | |
12 | * | |
0272a10d VZ |
13 | * This file provides a location for all input. Users who need |
14 | * special handling are expected to write a function that has the same | |
15 | * arguments as this and performs a similar function, but that possibly | |
16 | * has a different input method. Note that you shouldn't change this | |
17 | * function, but rather write a replacement function and then make | |
18 | * libpng use it at run time with png_set_read_fn(...). | |
19 | */ | |
20 | ||
b61cc19c | 21 | #include "pngpriv.h" |
0272a10d | 22 | |
9c0d9ce3 DS |
23 | #ifdef PNG_READ_SUPPORTED |
24 | ||
0272a10d | 25 | /* Read the data from whatever input you are using. The default routine |
b61cc19c PC |
26 | * reads from a file pointer. Note that this routine sometimes gets called |
27 | * with very small lengths, so you should implement some kind of simple | |
28 | * buffering if you are using unbuffered reads. This should never be asked | |
29 | * to read more then 64K on a 16 bit machine. | |
30 | */ | |
0272a10d | 31 | void /* PRIVATE */ |
fff5f7d5 | 32 | png_read_data(png_structrp png_ptr, png_bytep data, png_size_t length) |
0272a10d | 33 | { |
970f6abe | 34 | png_debug1(4, "reading %d bytes", (int)length); |
9c0d9ce3 | 35 | |
0272a10d VZ |
36 | if (png_ptr->read_data_fn != NULL) |
37 | (*(png_ptr->read_data_fn))(png_ptr, data, length); | |
9c0d9ce3 | 38 | |
0272a10d VZ |
39 | else |
40 | png_error(png_ptr, "Call to NULL read function"); | |
41 | } | |
42 | ||
b61cc19c | 43 | #ifdef PNG_STDIO_SUPPORTED |
0272a10d | 44 | /* This is the function that does the actual reading of data. If you are |
b61cc19c PC |
45 | * not reading from a standard C stream, you should create a replacement |
46 | * read_data function and use it at run time with png_set_read_fn(), rather | |
47 | * than changing the library. | |
48 | */ | |
9c0d9ce3 | 49 | void PNGCBAPI |
0272a10d VZ |
50 | png_default_read_data(png_structp png_ptr, png_bytep data, png_size_t length) |
51 | { | |
52 | png_size_t check; | |
53 | ||
b61cc19c PC |
54 | if (png_ptr == NULL) |
55 | return; | |
9c0d9ce3 | 56 | |
0272a10d VZ |
57 | /* fread() returns 0 on error, so it is OK to store this in a png_size_t |
58 | * instead of an int, which is what fread() actually returns. | |
59 | */ | |
fff5f7d5 | 60 | check = fread(data, 1, length, png_voidcast(png_FILE_p, png_ptr->io_ptr)); |
0272a10d VZ |
61 | |
62 | if (check != length) | |
63 | png_error(png_ptr, "Read Error"); | |
64 | } | |
0272a10d VZ |
65 | #endif |
66 | ||
67 | /* This function allows the application to supply a new input function | |
b61cc19c PC |
68 | * for libpng if standard C streams aren't being used. |
69 | * | |
70 | * This function takes as its arguments: | |
9c0d9ce3 | 71 | * |
b61cc19c | 72 | * png_ptr - pointer to a png input data structure |
9c0d9ce3 | 73 | * |
b61cc19c PC |
74 | * io_ptr - pointer to user supplied structure containing info about |
75 | * the input functions. May be NULL. | |
9c0d9ce3 | 76 | * |
b61cc19c PC |
77 | * read_data_fn - pointer to a new input function that takes as its |
78 | * arguments a pointer to a png_struct, a pointer to | |
79 | * a location where input data can be stored, and a 32-bit | |
80 | * unsigned int that is the number of bytes to be read. | |
81 | * To exit and output any fatal error messages the new write | |
82 | * function should call png_error(png_ptr, "Error msg"). | |
83 | * May be NULL, in which case libpng's default function will | |
84 | * be used. | |
85 | */ | |
0272a10d | 86 | void PNGAPI |
fff5f7d5 | 87 | png_set_read_fn(png_structrp png_ptr, png_voidp io_ptr, |
0272a10d VZ |
88 | png_rw_ptr read_data_fn) |
89 | { | |
b61cc19c PC |
90 | if (png_ptr == NULL) |
91 | return; | |
9c0d9ce3 | 92 | |
0272a10d VZ |
93 | png_ptr->io_ptr = io_ptr; |
94 | ||
b61cc19c | 95 | #ifdef PNG_STDIO_SUPPORTED |
0272a10d VZ |
96 | if (read_data_fn != NULL) |
97 | png_ptr->read_data_fn = read_data_fn; | |
9c0d9ce3 | 98 | |
0272a10d VZ |
99 | else |
100 | png_ptr->read_data_fn = png_default_read_data; | |
101 | #else | |
102 | png_ptr->read_data_fn = read_data_fn; | |
103 | #endif | |
104 | ||
105 | /* It is an error to write to a read device */ | |
106 | if (png_ptr->write_data_fn != NULL) | |
107 | { | |
108 | png_ptr->write_data_fn = NULL; | |
109 | png_warning(png_ptr, | |
9c0d9ce3 DS |
110 | "Can't set both read_data_fn and write_data_fn in the" |
111 | " same structure"); | |
0272a10d VZ |
112 | } |
113 | ||
b61cc19c | 114 | #ifdef PNG_WRITE_FLUSH_SUPPORTED |
0272a10d VZ |
115 | png_ptr->output_flush_fn = NULL; |
116 | #endif | |
117 | } | |
118 | #endif /* PNG_READ_SUPPORTED */ |