Changeset 103316 in vbox for trunk/src/libs/libpng-1.6.42/INSTALL
- Timestamp:
- Feb 12, 2024 3:57:56 PM (12 months ago)
- File:
-
- 1 edited
-
trunk/src/libs/libpng-1.6.42/INSTALL (modified) (14 diffs)
Legend:
- Unmodified
- Added
- Removed
-
trunk/src/libs/libpng-1.6.42/INSTALL
r96425 r103316 129 129 *.h, *.c => libpng source files 130 130 CMakeLists.txt => "cmake" script 131 ci 132 ci_*.sh 131 133 configuration files: 132 134 configure.ac, configure, Makefile.am, Makefile.in, 133 135 autogen.sh, config.guess, ltmain.sh, missing, libpng.pc.in, 134 136 libpng-config.in, aclocal.m4, config.h.in, config.sub, 135 depcomp, install-sh, mkinstalldirs, test-pngtest.sh 137 depcomp, install-sh, mkinstalldirs, test-pngtest.sh, etc. 136 138 contrib 137 139 arm-neon, conftest, examples, gregbook, libtests, pngminim, 138 140 pngminus, pngsuite, tools, visupng 139 141 projects 140 cbuilder5, owatcom, visualc71, vstudio, xcode142 owatcom, visualc71, vstudio 141 143 scripts 142 144 makefile.* … … 146 148 etc. 147 149 zlib 148 README, *.h, *.c contrib, etc.150 README, *.h, *.c, contrib, etc. 149 151 150 152 If the line endings in the files look funny, you may wish to get the other … … 154 156 VI. Building with project files 155 157 156 If you are building libpng with M SVC, you can enter the157 libpng projects\visualc71 or vstudio directory and follow the instructions 158 in README.txt.159 160 Otherwise enter the zlib directory and follow the instructions in zlib/README,161 then come back here and run "configure" or choose the appropriate162 makefile.sysin the scripts directory.158 If you are building libpng with Microsoft Visual Studio, you can enter 159 the directory projects\visualc71 or projects\vstudio and follow the 160 instructions in README.txt. 161 162 Otherwise, enter the zlib directory and follow the instructions in 163 zlib/README, then come back here and run "configure" or choose the 164 appropriate makefile in the scripts directory. 163 165 164 166 VII. Building with makefiles … … 167 169 scripts directory into this directory, for example 168 170 169 MSDOS example:170 171 copy scripts\makefile.msc makefile172 copy scripts\pnglibconf.h.prebuilt pnglibconf.h173 174 171 UNIX example: 175 172 176 cp scripts/makefile.std makefile 177 cp scripts/pnglibconf.h.prebuilt pnglibconf.h 173 cp scripts/makefile.std Makefile 174 make 175 176 Windows example: 177 178 nmake -f scripts\makefile.vcwin32 178 179 179 180 Read the makefile to see if you need to change any source or … … 192 193 your output with the result shown in contrib/pngsuite/README. 193 194 194 Most of the makefiles will allow you to run "make install" to 195 put the library in its final resting place (if you want to 196 do that, run "make install" in the zlib directory first if necessary). 197 Some also allow you to run "make test-installed" after you have 198 run "make install". 199 200 VIII. Configuring libpng for 16-bit platforms 201 202 You will want to look into zconf.h to tell zlib (and thus libpng) that 203 it cannot allocate more than 64K at a time. Even if you can, the memory 204 won't be accessible. So limit zlib and libpng to 64K by defining MAXSEG_64K. 205 206 IX. Configuring for DOS 195 Most of the makefiles used to allow you to run "make install" to put 196 the library in its final resting place, but that feature is no longer 197 supported. The only tested and supported manners to install libpng are 198 the conventional build and install procedures driven by the configure 199 script or by the CMake file. 200 201 VIII. Configuring for DOS and other 16-bit platforms 202 203 Officially, the support for 16-bit platforms has been removed. 207 204 208 205 For DOS users who only have access to the lower 640K, you will … … 210 207 call. See zlib.h or zconf.h in the zlib library for more information. 211 208 212 X. Configuring for Medium Model 213 214 Libpng's support for medium model has been tested on most of the popular 215 compilers. Make sure MAXSEG_64K gets defined, USE_FAR_KEYWORD gets 216 defined, and FAR gets defined to far in pngconf.h, and you should be 217 all set. Everything in the library (except for zlib's structure) is 218 expecting far data. You must use the typedefs with the p or pp on 219 the end for pointers (or at least look at them and be careful). Make 220 note that the rows of data are defined as png_bytepp, which is 221 an "unsigned char far * far *". 222 223 XI. Prepending a prefix to exported symbols 209 You may be or may not be in luck if you target the "large" memory model, 210 but all the smaller models ("small", "compact" and "medium") are known 211 to be unworkable. For DOS users who have access beyond the lower 640K, 212 a "flat" 32-bit DOS model (such as DJGPP) is strongly recommended. 213 214 For DOS users who only have access to the lower 640K, you will have to 215 limit zlib's memory usage via a png_set_compression_mem_level() call. 216 You will also have to look into zconf.h to tell zlib (and thus libpng) 217 that it cannot allocate more than 64K at a time. Even if you can, the 218 memory won't be accessible. Therefore, you should limit zlib and libpng 219 to 64K by defining MAXSEG_64K. 220 221 IX. Prepending a prefix to exported symbols 224 222 225 223 Starting with libpng-1.6.0, you can configure libpng (when using the … … 232 230 the macros to use the modified names. 233 231 234 X II. Configuring for compiler xxx:232 X. Configuring for compiler xxx: 235 233 236 234 All includes for libpng are in pngconf.h. If you need to add, change … … 244 242 that previously appeared in the public headers. 245 243 246 XI II. Removing unwanted object code244 XI. Removing unwanted object code 247 245 248 246 There are a bunch of #define's in pngconf.h that control what parts of … … 283 281 those sections that are actually used will be loaded into memory. 284 282 285 XI V. Enabling or disabling hardware optimizations283 XII. Enabling or disabling hardware optimizations 286 284 287 285 Certain hardware capabilities, such as the Intel SSE instructions, … … 333 331 cmake . -DPNG_HARDWARE_OPTIMIZATIONS=no 334 332 335 X V. Changes to the build and configuration of libpng in libpng-1.5.x333 XIII. Changes to the build and configuration of libpng in libpng-1.5.x 336 334 337 335 Details of internal changes to the library code can be found in the CHANGES … … 424 422 that were used to build libpng. 425 423 426 X VI. Setjmp/longjmp issues424 XIV. Setjmp/longjmp issues 427 425 428 426 Libpng uses setjmp()/longjmp() for error handling. Unfortunately setjmp() … … 442 440 and PNG_SIMPLIFIED_WRITE_SUPPORTED undefined. 443 441 444 XV II. Common linking failures442 XV. Common linking failures 445 443 446 444 If your application fails to find libpng or zlib entries while linking: … … 454 452 project/vstudio/README.txt. 455 453 456 XVI II. Other sources of information about libpng:454 XVI. Other sources of information about libpng: 457 455 458 456 Further information can be found in the README and libpng-manual.txt … … 460 458 libpng.3 and png.5. 461 459 460 Copyright (c) 2022 Cosmin Truta 462 461 Copyright (c) 1998-2002,2006-2016 Glenn Randers-Pehrson 463 462 This document is released under the libpng license.
Note:
See TracChangeset
for help on using the changeset viewer.
