libpng.txt - A description on how to use and modify libpng
libpng version 1.2.5 - October 3, 2002
Updated and distributed by Glenn Randers-Pehrson
<randeg@alum.rpi.edu>
Copyright (c) 1998-2002 Glenn Randers-Pehrson
For conditions of distribution and use, see copyright
notice in png.h.
based on:
libpng 1.0 beta 6 version 0.96 May 28, 1997
Updated and distributed by Andreas Dilger
Copyright (c) 1996, 1997 Andreas Dilger
libpng 1.0 beta 2 - version 0.88 January 26, 1996
For conditions of distribution and use, see copyright
notice in png.h. Copyright (c) 1995, 1996 Guy Eric
Schalnat, Group 42, Inc.
Updated/rewritten per request in the libpng FAQ
Copyright (c) 1995, 1996 Frank J. T. Wojcik
December 18, 1995 & January 20, 1996
I. Introduction
This file describes how to use and modify the PNG reference library
(known as libpng) for your own use. There are five sections to this
file: introduction, structures, reading, writing, and modification and
configuration notes for various special platforms. In addition to this
file, example.c is a good starting point for using the library, as
it is heavily commented and should include everything most people
will need. We assume that libpng is already installed; see the
INSTALL file for instructions on how to install libpng.
Libpng was written as a companion to the PNG specification, as a way
of reducing the amount of time and effort it takes to support the PNG
file format in application programs.
The PNG-1.2 specification is available at <http://www.libpng.org/pub/png>
and at <ftp://ftp.uu.net/graphics/png/documents/>.
The PNG-1.0 specification is available
as RFC 2083 <ftp://ftp.uu.net/graphics/png/documents/> and as a
W3C Recommendation <http://www.w3.org/TR/REC.png.html>. Some
additional chunks are described in the special-purpose public chunks
documents at <ftp://ftp.uu.net/graphics/png/documents/>.
Other information
about PNG, and the latest version of libpng, can be found at the PNG home
page, <http://www.libpng.org/pub/png/>
and at <ftp://ftp.uu.net/graphics/png/>.
Most users will not have to modify the library significantly; advanced
users may want to modify it more. All attempts were made to make it as
complete as possible, while keeping the code easy to understand.
Currently, this library only supports C. Support for other languages
is being considered.
Libpng has been designed to handle multiple sessions at one time,
to be easily modifiable, to be portable to the vast majority of
machines (ANSI, K&R, 16-, 32-, and 64-bit) available, and to be easy
to use. The ultimate goal of libpng is to promote the acceptance of
the PNG file format in whatever way possible. While there is still
work to be done (see the TODO file), libpng should cover the
majority of the needs of its users.
Libpng uses zlib for its compression and decompression of PNG files.
Further information about zlib, and the latest version of zlib, can
be found at the zlib home page, <http://www.info-zip.org/pub/infozip/zlib/>.
The zlib compression utility is a general purpose utility that is
useful for more than PNG files, and can be used without libpng.
See the documentation delivered with zlib for more details.
You can usually find the source files for the zlib utility wherever you
find the libpng source files.
Libpng is thread safe, provided the threads are using different
instances of the structures. Each thread should have its own
png_struct and png_info instances, and thus its own image.
Libpng does not protect itself against two threads using the
same instance of a structure. Note: thread safety may be defeated
by use of some of the MMX assembler code in pnggccrd.c, which is only
compiled when the user defines PNG_THREAD_UNSAFE_OK.
II. Structures
There are two main structures that are important to libpng, png_struct
and png_info. The first, png_struct, is an internal structure that
will not, for the most part, be used by a user except as the first
variable passed to every libpng function call.
The png_info structure is designed to provide information about the
PNG file. At one time, the fields of png_info were intended to be
directly accessible to the user. However, this tended to cause problems
with applications using dynamically loaded libraries, and as a result
a set of interface functions for png_info (the png_get_*() and png_set_*()
functions) was developed. The fields of png_info are still available for
older applications, but it is suggested that applications use the new
interfaces if at all possible.
Applications that do make direct access to the members of png_struct (except
for png_ptr->jmpbuf) must be recompiled whenever the library is updated,
and applications that make direct access to the members of png_info must
be recompiled if they were compiled or loaded with libpng version 1.0.6,
in which the members were in a different order. In version 1.0.7, the
members of the png_info structure reverted to the old order, as they were
in versions 0.97c through 1.0.5. Starting with version 2.0.0, both
structures are going to be hidden, and the contents of the structures will
only be accessible through the png_get/png_set functions.
The png.h header file is an invaluable reference for programming with libpng.
And while I'm on the topic, make sure you include the libpng header file:
#include <png.h>
III. Reading
We'll now walk you through the possible functions to call when reading
in a PNG file sequentially, briefly explaining the syntax and purpose
of each one. See example.c and png.h for more detail. While
progressive reading is covered in the next section, you will still
need some of the functions discussed in this section to read a PNG
file.
Setup
You will want to do the I/O initialization(*) before you get into libpng,
so if it doesn't work, you don't have much to undo. Of course, you
will also want to insure that you are, in fact, dealing with a PNG
file. Libpng provides a simple check to see if a file is a PNG file.
To use it, pass in the first 1 to 8 bytes of the file to the function
png_sig_cmp(), and it will return 0 if the bytes match the corresponding
bytes of the PNG signature, or nonzero otherwise. Of course, the more bytes
you pass in, the greater the accuracy of the prediction.
If you are intending to keep the file pointer open for use in libpng,
you must ensure you don't read more than 8 bytes from the beginning
of the file, and you also have to make a call to png_set_sig_bytes_read()
with the number of bytes you read from the beginning. Libpng will
then only check the bytes (if any) that your program didn't read.
(*): If you are not using the standard I/O functions, you will need
to replace them with custom functions. See the discussion under
Customizing libpng.
FILE *fp = fopen(file_name, "rb");
if (!fp)
{
return (ERROR);
}
fread(header, 1, number, fp);
is_png = !png_sig_cmp(header, 0, number);
if (!is_png)
{
return (NOT_PNG);
}
Next, png_struct and png_info need to be allocated and initialized. In
order to ensure that the size of these structures is correct even with a
dynamically linked libpng, there are functions to initialize and
allocate the structures. We also pass the library version, optional
pointers to error handling functions, and a pointer to a data struct for
use by the error functions, if necessary (the pointer and functions can
be NULL if the default error handlers are to be used). See the section
on Changes to Libpng below regarding the old initialization functions.
The structure allocation functions quietly return NULL if they fail to
create the structure, so your application should check for that.
png_structp png_ptr = png_create_read_struct
(PNG_LIBPNG_VER_STRING, (png_voidp)user_error_ptr,
没有合适的资源?快使用搜索试试~ 我知道了~
pov-ray渲染器源码文件
共1339个文件
h:247个
c:233个
cpp:183个
3星 · 超过75%的资源 需积分: 10 26 下载量 86 浏览量
2011-02-21
19:04:24
上传
评论 2
收藏 4.78MB ZIP 举报
温馨提示
POV-Ray是一个开源的免费软件,您可以自由的使用及传播它。它有15年的历史,自从DKBTrace2.12版开源以后(1989年),POV-Ray的研发工作开始。 POV-Ray应当属于功能强大的程序建模渲染器,它自身提供了场景描述语言。和Ruby一样,可以用任意的文本编辑器编辑。编辑以后在软件中进行渲染。
资源推荐
资源详情
资源评论
收起资源包目录
pov-ray渲染器源码文件 (1339个子文件)
cjpeg.1 10KB
tiffcp.1 8KB
jpegtran.1 8KB
djpeg.1 7KB
fax2tiff.1 7KB
tiff2pdf.1 7KB
tiff2ps.1 7KB
tiffgt.1 7KB
raw2tiff.1 5KB
fax2ps.1 5KB
tiffsv.1 4KB
tiffdither.1 4KB
tiff2rgba.1 3KB
tiffmedian.1 3KB
pal2rgb.1 3KB
rgb2ycbcr.1 3KB
ras2tiff.1 3KB
ppm2tiff.1 3KB
thumbnail.1 3KB
sgi2tiff.1 3KB
tiffcmp.1 3KB
tiff2bw.1 3KB
tiffinfo.1 3KB
tiffdump.1 3KB
wrjpgcom.1 3KB
gif2tiff.1 3KB
tiffsplit.1 2KB
rdjpgcom.1 2KB
ansi2knr.1 2KB
libpng.3 161KB
libpngpf.3 17KB
zlib.3 5KB
makefile.32sunu 7KB
libtiff.3t 19KB
TIFFOpen.3t 9KB
TIFFRGBAImage.3t 9KB
TIFFcolor.3t 8KB
TIFFSetField.3t 7KB
TIFFGetField.3t 7KB
TIFFReadRGBAImage.3t 7KB
TIFFReadDirectory.3t 6KB
TIFFReadRGBATile.3t 6KB
TIFFReadRGBAStrip.3t 6KB
TIFFWriteScanline.3t 6KB
TIFFWriteDirectory.3t 5KB
TIFFquery.3t 4KB
TIFFtile.3t 4KB
TIFFReadScanline.3t 4KB
TIFFWriteEncodedStrip.3t 4KB
TIFFstrip.3t 4KB
TIFFWriteEncodedTile.3t 3KB
TIFFbuffer.3t 3KB
TIFFWriteRawStrip.3t 3KB
TIFFReadTile.3t 3KB
TIFFcodec.3t 3KB
TIFFReadEncodedTile.3t 3KB
TIFFWriteRawTile.3t 3KB
TIFFReadEncodedStrip.3t 3KB
TIFFSetDirectory.3t 3KB
TIFFmemory.3t 3KB
TIFFWriteTile.3t 3KB
TIFFswab.3t 3KB
TIFFWarning.3t 3KB
TIFFPrintDirectory.3t 3KB
TIFFError.3t 3KB
TIFFReadRawTile.3t 3KB
TIFFFlush.3t 2KB
TIFFReadRawStrip.3t 2KB
TIFFsize.3t 2KB
TIFFDataWidth.3t 2KB
TIFFClose.3t 2KB
png.5 2KB
README.586 2KB
makefile.64sunu 7KB
README.686 1KB
makefile.acorn 2KB
zlib.adb 20KB
test.adb 13KB
zlib-streams.adb 6KB
mtest.adb 4KB
zlib-thin.adb 4KB
read.adb 4KB
zlib-thin.ads 17KB
zlib.ads 13KB
zlib-streams.ads 4KB
makefile.aix 3KB
makefile.amiga 1KB
ANNOUNCE 1KB
makefile.ansi 12KB
gvmat32.asm 22KB
inffas32.asm 14KB
LZTIMER.ASM 12KB
match.asm 11KB
jmemdosa.asm 8KB
makefile.atari 2KB
makefile.b32 13KB
codemax.bas 24KB
png2pnm.bat 2KB
pnm2png.bat 2KB
conf.bat 351B
共 1339 条
- 1
- 2
- 3
- 4
- 5
- 6
- 14
资源评论
- 代码小卒2013-09-10这个在官网就能下载到的,并且它的这个还不是最新版的!
- robert02112013-03-08东西不错还是可以用的,只是软件的实用性不太大,只能建立基本的模型。不过还是 谢谢了
- lxl198802062014-06-19用还是能用的,不是最新版
hello_cust
- 粉丝: 1
- 资源: 1
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
最新资源
- Python爬取淘宝热卖商品并可视化分析
- 5152单片机proteus仿真和源码将按键次数写入AT24C02再读出并用1602LCD显示
- SE-SSD复现过程(Det3D的安装教程)
- 基于Python的在线学习与推荐系统设计与实现(论文+源码)-kaic
- 串口通过 YMODEM 协议进行文件传输
- 蓝桥杯2024年第十五届省赛真题-前缀总分
- com.qihoo.appstore_300101305-1.apk
- tensorflow-gpu-2.7.1-cp37-cp37m-manylinux2010-x86-64.whl
- tensorflow-2.7.2-cp37-cp37m-manylinux2010-x86-64.whl
- tensorflow-2.7.1-cp39-cp39-manylinux2010-x86-64.whl
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功