[libpng16] Added instructions for disabling hardware optimizations in INSTALL.

This commit is contained in:
Glenn Randers-Pehrson 2017-07-05 19:20:57 -05:00
parent 23b51990e3
commit f380ae5243
3 changed files with 28 additions and 11 deletions

View File

@ -1,4 +1,4 @@
Libpng 1.6.31beta02 - July 5, 2017 Libpng 1.6.31beta02 - July 6, 2017
This is not intended to be a public release. It will be replaced This is not intended to be a public release. It will be replaced
within a few weeks by a public version or by another test version. within a few weeks by a public version or by another test version.
@ -69,7 +69,8 @@ Version 1.6.31beta01 [July 5, 2017]
Added "Requires: zlib" to libpng.pc.in (Pieter Neerincx). Added "Requires: zlib" to libpng.pc.in (Pieter Neerincx).
Added special case for FreeBSD in arm/filter_neon.S (Maya Rashish). Added special case for FreeBSD in arm/filter_neon.S (Maya Rashish).
Version 1.6.31beta02 [July 5, 2017] Version 1.6.31beta02 [July 6, 2017]
Added instructions for disabling hardware optimizations in INSTALL.
Send comments/corrections/commendations to png-mng-implement at lists.sf.net Send comments/corrections/commendations to png-mng-implement at lists.sf.net
(subscription required; visit (subscription required; visit

View File

@ -5864,7 +5864,8 @@ Version 1.6.31beta01 [July 5, 2017]
Added "Requires: zlib" to libpng.pc.in (Pieter Neerincx). Added "Requires: zlib" to libpng.pc.in (Pieter Neerincx).
Added special case for FreeBSD in arm/filter_neon.S (Maya Rashish). Added special case for FreeBSD in arm/filter_neon.S (Maya Rashish).
Version 1.6.31beta02 [July 5, 2017] Version 1.6.31beta02 [July 6, 2017]
Added instructions for disabling hardware optimizations in INSTALL.
Send comments/corrections/commendations to png-mng-implement at lists.sf.net Send comments/corrections/commendations to png-mng-implement at lists.sf.net
(subscription required; visit (subscription required; visit

31
INSTALL
View File

@ -16,10 +16,11 @@ Contents
XI. Prepending a prefix to exported symbols XI. Prepending a prefix to exported symbols
XII. Configuring for compiler xxx: XII. Configuring for compiler xxx:
XIII. Removing unwanted object code XIII. Removing unwanted object code
XIV. Changes to the build and configuration of libpng in libpng-1.5.x XIV. Enabling or disabling hardware optimizations
XV. Setjmp/longjmp issues XV. Changes to the build and configuration of libpng in libpng-1.5.x
XVI. Common linking failures XVI. Setjmp/longjmp issues
XVII. Other sources of information about libpng XVII. Common linking failures
XVIII. Other sources of information about libpng
I. Simple installation I. Simple installation
@ -281,7 +282,21 @@ library to fail if they call functions not available in your library.
The size of the library itself should not be an issue, because only The size of the library itself should not be an issue, because only
those sections that are actually used will be loaded into memory. those sections that are actually used will be loaded into memory.
XIV. Changes to the build and configuration of libpng in libpng-1.5.x XIV. Enabling or disabling hardware optimizations
Certain hardware capabilites, such as the Intel SSE instructions,
are normally detected at run time. If you wish to avoid using them,
you can disable them via configure options such as
--enable-arm-neon=no, --enable-mips-msa=no, --enable-intel-sse=no,
--enable-powerpc-vsx=no
or via compiler-command options such as
CPPFLAGS += "-DPNG_ARM_NEON_OPT=0, -DPNG_MIPS_MSA_OPT=0,
-DPNG_INTEL_SSE_OPT=0, -DPNG_POWERPC_VSX_OPT=0"
XV. Changes to the build and configuration of libpng in libpng-1.5.x
Details of internal changes to the library code can be found in the CHANGES Details of internal changes to the library code can be found in the CHANGES
file and in the GIT repository logs. These will be of no concern to the vast file and in the GIT repository logs. These will be of no concern to the vast
@ -372,7 +387,7 @@ $PREFIX/include directory). Do not edit pnglibconf.h after you have built
libpng, because than the settings would not accurately reflect the settings libpng, because than the settings would not accurately reflect the settings
that were used to build libpng. that were used to build libpng.
XV. Setjmp/longjmp issues XVI. Setjmp/longjmp issues
Libpng uses setjmp()/longjmp() for error handling. Unfortunately setjmp() Libpng uses setjmp()/longjmp() for error handling. Unfortunately setjmp()
is known to be not thread-safe on some platforms and we don't know of is known to be not thread-safe on some platforms and we don't know of
@ -390,7 +405,7 @@ This requires setjmp/longjmp, so you must either build the library
with PNG_SETJMP_SUPPORTED defined, or with PNG_SIMPLIFIED_READ_SUPPORTED with PNG_SETJMP_SUPPORTED defined, or with PNG_SIMPLIFIED_READ_SUPPORTED
and PNG_SIMPLIFIED_WRITE_SUPPORTED undefined. and PNG_SIMPLIFIED_WRITE_SUPPORTED undefined.
XVI. Common linking failures XVII. Common linking failures
If your application fails to find libpng or zlib entries while linking: If your application fails to find libpng or zlib entries while linking:
@ -402,7 +417,7 @@ If your application fails to find libpng or zlib entries while linking:
If you are using the vstudio project, observe the WARNING in If you are using the vstudio project, observe the WARNING in
project/vstudio/README.txt. project/vstudio/README.txt.
XVII. Other sources of information about libpng: XVIII. Other sources of information about libpng:
Further information can be found in the README and libpng-manual.txt Further information can be found in the README and libpng-manual.txt
files, in the individual makefiles, in png.h, and the manual pages files, in the individual makefiles, in png.h, and the manual pages