Split build instructions into a new file and add SDK usage notes to README-turbo.txt
git-svn-id: svn+ssh://svn.code.sf.net/p/libjpeg-turbo/code/trunk@111 632fc199-4ca6-4c93-a231-07263d6284db
This commit is contained in:
DRC
282
BUILDING.txt
Normal file
282
BUILDING.txt
Normal file
@@ -0,0 +1,282 @@
|
|||||||
|
*******************************************************************************
|
||||||
|
** Building on Unix Platforms, Cygwin, and MinGW
|
||||||
|
*******************************************************************************
|
||||||
|
|
||||||
|
==================
|
||||||
|
Build Requirements
|
||||||
|
==================
|
||||||
|
|
||||||
|
-- autoconf 2.56 or later
|
||||||
|
* If using MinGW, this can be obtained by installing the MSYS DTK
|
||||||
|
|
||||||
|
-- automake 1.7 or later
|
||||||
|
* If using MinGW, this can be obtained by installing the MSYS DTK
|
||||||
|
|
||||||
|
-- libtool 1.4 or later
|
||||||
|
* If using MinGW, this can be obtained by installing the MSYS DTK
|
||||||
|
|
||||||
|
-- NASM
|
||||||
|
* 0.98 or later is required for a 32-bit build
|
||||||
|
* NASM 2.05 or later is required for a 64-bit build
|
||||||
|
* NASM 2.07 or later is required for a 64-bit build on OS/X (10.6 "Snow
|
||||||
|
Leopard" or later.) This can be obtained from MacPorts
|
||||||
|
(http://www.macports.org/).
|
||||||
|
|
||||||
|
The NASM 2.05 RPMs do not work on older Linux systems, such as Enterprise
|
||||||
|
Linux 4. On such systems, you can easily build and install NASM 2.05
|
||||||
|
from the source RPM by executing the following as root:
|
||||||
|
|
||||||
|
ARCH=`uname -m`
|
||||||
|
wget http://www.nasm.us/pub/nasm/releasebuilds/2.05.01/nasm-2.05.01-1.src.rpm
|
||||||
|
rpmbuild --rebuild nasm-2.05.01-1.src.rpm
|
||||||
|
rpm -Uvh /usr/src/redhat/RPMS/$ARCH/nasm-2.05.01-1.$ARCH.rpm
|
||||||
|
|
||||||
|
-- GCC v4 or later recommended for best performance
|
||||||
|
|
||||||
|
======================
|
||||||
|
Building libjpeg-turbo
|
||||||
|
======================
|
||||||
|
|
||||||
|
The following procedure will build libjpeg-turbo on Linux, 32-bit OS X, and
|
||||||
|
Solaris/x86 systems (on Solaris, this generates a 32-bit library. See below
|
||||||
|
for 64-bit build instructions.)
|
||||||
|
|
||||||
|
cd libjpeg-turbo
|
||||||
|
autoreconf -fiv
|
||||||
|
sh ./configure
|
||||||
|
make
|
||||||
|
|
||||||
|
NOTE: Running autoreconf is only necessary if building libjpeg-turbo from the
|
||||||
|
SVN repository.
|
||||||
|
|
||||||
|
This will generate the following files under .libs/
|
||||||
|
|
||||||
|
libjpeg.a
|
||||||
|
Static link library for libjpeg-turbo
|
||||||
|
|
||||||
|
libjpeg.so.62.0.0 (Linux, Solaris)
|
||||||
|
libjpeg.62.dylib (OS X)
|
||||||
|
libjpeg-62.dll (MinGW)
|
||||||
|
cygjpeg-62.dll (Cygwin)
|
||||||
|
Shared library for libjpeg-turbo
|
||||||
|
|
||||||
|
libjpeg.so (Linux, Solaris)
|
||||||
|
libjpeg.dylib (OS X)
|
||||||
|
libjpeg.dll.a (Cygwin, MinGW)
|
||||||
|
Development stub for libjpeg-turbo shared library
|
||||||
|
|
||||||
|
libturbojpeg.a
|
||||||
|
Static link library for TurboJPEG/OSS
|
||||||
|
|
||||||
|
libturbojpeg.so (Linux, Solaris)
|
||||||
|
libturbojpeg.dylib (OS X)
|
||||||
|
Shared library and development stub for TurboJPEG/OSS
|
||||||
|
|
||||||
|
libturbojpeg.dll (MinGW)
|
||||||
|
cygturbojpeg.dll (Cygwin)
|
||||||
|
Shared library for TurboJPEG/OSS
|
||||||
|
|
||||||
|
libturbojpeg.dll.a (Cygwin, MinGW)
|
||||||
|
Development stub for TurboJPEG/OSS shared library
|
||||||
|
|
||||||
|
========================
|
||||||
|
Installing libjpeg-turbo
|
||||||
|
========================
|
||||||
|
|
||||||
|
If you intend to install these libraries and the associated header files, then
|
||||||
|
replace 'make' in the instructions above with
|
||||||
|
|
||||||
|
make install prefix={base dir} libdir={library directory}
|
||||||
|
|
||||||
|
For example,
|
||||||
|
|
||||||
|
make install prefix=/usr/local libdir=/usr/local/lib64
|
||||||
|
|
||||||
|
will install the header files in /usr/local/include and the library files in
|
||||||
|
/usr/local/lib64. If 'prefix' and 'libdir' are not specified, then the default
|
||||||
|
is to install the header files in /opt/libjpeg-turbo/include and the library
|
||||||
|
files in /opt/libjpeg-turbo/lib.
|
||||||
|
|
||||||
|
NOTE: You can specify a prefix of /usr and a libdir of, for instance,
|
||||||
|
/usr/lib64 to overwrite the system's version of libjpeg. If you do this,
|
||||||
|
however, then be sure to BACK UP YOUR SYSTEM'S INSTALLATION OF LIBJPEG before
|
||||||
|
overwriting it. It is recommended that you instead install libjpeg-turbo into
|
||||||
|
a non-system directory and manipulate the LD_LIBRARY_PATH or create sym links
|
||||||
|
to force applications to use libjpeg-turbo instead of libjpeg. See
|
||||||
|
README-turbo.txt for more information.
|
||||||
|
|
||||||
|
=============
|
||||||
|
Build Recipes
|
||||||
|
=============
|
||||||
|
|
||||||
|
32-bit Library Build on 64-bit Linux
|
||||||
|
------------------------------------
|
||||||
|
|
||||||
|
Same instructions as above, but add
|
||||||
|
|
||||||
|
--host i686-pc-linux-gnu CFLAGS='-O3 -m32' CXXFLAGS='-O3 -m32'
|
||||||
|
|
||||||
|
to the configure command line.
|
||||||
|
|
||||||
|
|
||||||
|
64-bit Library Build on 64-bit OS/X
|
||||||
|
-----------------------------------
|
||||||
|
|
||||||
|
Same instructions as above, but add
|
||||||
|
|
||||||
|
--host x86_64-apple-darwin10.0.0 NASM=/opt/local/bin/nasm
|
||||||
|
|
||||||
|
to the configure command line. NASM 2.07 from MacPorts must be installed.
|
||||||
|
|
||||||
|
|
||||||
|
32-bit Library Build on 64-bit OS/X
|
||||||
|
-----------------------------------
|
||||||
|
|
||||||
|
Same instructions as above, but add
|
||||||
|
|
||||||
|
CFLAGS='-O3 -m32' CXXFLAGS='-O3 -m32' LDFLAGS=-m32
|
||||||
|
|
||||||
|
to the configure command line.
|
||||||
|
|
||||||
|
|
||||||
|
32-bit Backward-Compatible Library Build on 64-bit OS/X
|
||||||
|
-------------------------------------------------------
|
||||||
|
|
||||||
|
Same instructions as above, but add
|
||||||
|
|
||||||
|
CC=gcc-4.0 CXX=g++-4.0 CFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk \
|
||||||
|
-mmacosx-version-min=10.4 -O3 -m32' CXXFLAGS='-isysroot \
|
||||||
|
/Developer/SDKs/MacOSX10.4u.sdk -mmacosx-version-min=10.4 -O3 -m32' \
|
||||||
|
LDFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk \
|
||||||
|
-mmacosx-version-min=10.4 -m32'
|
||||||
|
|
||||||
|
to the configure command line. The OS X 10.4 SDK must be installed.
|
||||||
|
|
||||||
|
|
||||||
|
64-bit Library Build on 64-bit Solaris
|
||||||
|
--------------------------------------
|
||||||
|
|
||||||
|
Same instructions as above, but add
|
||||||
|
|
||||||
|
--host x86_64-pc-solaris CFLAGS='-O3 -m64' CXXFLAGS='-O3 -m64' LDFLAGS=-m64
|
||||||
|
|
||||||
|
to the configure command line.
|
||||||
|
|
||||||
|
|
||||||
|
MinGW Build on Cygwin
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
Same instructions as above, but add
|
||||||
|
|
||||||
|
--host mingw32
|
||||||
|
|
||||||
|
to the configure command line. This will produce libraries which do not
|
||||||
|
depend on cygwin1.dll or other Cygwin DLL's.
|
||||||
|
|
||||||
|
|
||||||
|
*******************************************************************************
|
||||||
|
** Windows (Visual C++)
|
||||||
|
*******************************************************************************
|
||||||
|
|
||||||
|
==================
|
||||||
|
Build Requirements
|
||||||
|
==================
|
||||||
|
|
||||||
|
-- GNU Make v3.7 or later
|
||||||
|
* Can be found in MSYS (http://www.mingw.org/download.shtml) or
|
||||||
|
Cygwin (http://www.cygwin.com/)
|
||||||
|
|
||||||
|
-- Microsoft Visual C++ 2003 or later
|
||||||
|
* Tested with Microsoft Visual C++ 2008 Express Edition (free download):
|
||||||
|
|
||||||
|
http://msdn.microsoft.com/vstudio/express/visualc/
|
||||||
|
|
||||||
|
* Add the compiler binary directories (for instance,
|
||||||
|
c:\Program Files\Microsoft Visual Studio 9.0\VC\BIN;
|
||||||
|
c:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE)
|
||||||
|
to the system or user PATH environment variable prior to building
|
||||||
|
libjpeg-turbo.
|
||||||
|
* Add the compiler include directory (for instance,
|
||||||
|
c:\Program Files\Microsoft Visual Studio 9.0\VC\INCLUDE)
|
||||||
|
to the system or user INCLUDE environment variable prior to building
|
||||||
|
libjpeg-turbo.
|
||||||
|
* Add the compiler library directory (for instance,
|
||||||
|
c:\Program Files\Microsoft Visual Studio 9.0\VC\LIB)
|
||||||
|
to the system or user LIB environment variable prior to building
|
||||||
|
libjpeg-turbo.
|
||||||
|
|
||||||
|
-- Microsoft Windows SDK
|
||||||
|
* This is included with Microsoft Visual C++ 2008 Express Edition, but users
|
||||||
|
of prior editions of Visual C++ can download the SDK from:
|
||||||
|
|
||||||
|
http://msdn2.microsoft.com/en-us/windowsserver/bb980924.aspx
|
||||||
|
|
||||||
|
* Add the SDK binary directory (for instance,
|
||||||
|
c:\Program Files\Microsoft SDKs\Windows\v6.0A\bin)
|
||||||
|
to the system or user PATH environment variable prior to building
|
||||||
|
libjpeg-turbo.
|
||||||
|
* Add the SDK include directory (for instance,
|
||||||
|
c:\Program Files\Microsoft SDKs\Windows\v6.0A\include)
|
||||||
|
to the system or user INCLUDE environment variable prior to building
|
||||||
|
libjpeg-turbo.
|
||||||
|
* Add the SDK library directory (for instance,
|
||||||
|
c:\Program Files\Microsoft SDKs\Windows\v6.0A\lib)
|
||||||
|
to the system or user LIB environment variable prior to building
|
||||||
|
libjpeg-turbo.
|
||||||
|
|
||||||
|
-- NASM (http://www.nasm.us/) 0.98 or later
|
||||||
|
|
||||||
|
======================
|
||||||
|
Building libjpeg-turbo
|
||||||
|
======================
|
||||||
|
|
||||||
|
cd libjpeg-turbo
|
||||||
|
make -f win/Makefile
|
||||||
|
|
||||||
|
This will generate the following files:
|
||||||
|
|
||||||
|
jpeg-static.lib Static link library for libjpeg-turbo
|
||||||
|
jpeg62.dll Shared library for libjpeg-turbo
|
||||||
|
jpeg.lib Development stub for libjpeg-turbo shared library
|
||||||
|
turbojpeg-static.lib Static link library for TurboJPEG/OSS
|
||||||
|
turbojpeg.dll Shared library for TurboJPEG/OSS
|
||||||
|
turbojpeg.lib Development stub for TurboJPEG/OSS shared library
|
||||||
|
|
||||||
|
|
||||||
|
*******************************************************************************
|
||||||
|
** Creating Release Packages
|
||||||
|
*******************************************************************************
|
||||||
|
|
||||||
|
The following commands can be used to create various types of release packages:
|
||||||
|
|
||||||
|
make rpm
|
||||||
|
|
||||||
|
Create RedHat-style binary RPM package. Requires RPM v4 or later.
|
||||||
|
|
||||||
|
make srpm
|
||||||
|
|
||||||
|
This runs 'make dist' to create a pristine source tarball, then creates a
|
||||||
|
RedHat-style source RPM package from the tarball. Requires RPM v4 or later.
|
||||||
|
|
||||||
|
make deb
|
||||||
|
|
||||||
|
Create Debian-style binary package. Requires dpkg.
|
||||||
|
|
||||||
|
make dmg
|
||||||
|
|
||||||
|
Create Macintosh package/disk image. This requires the PackageMaker
|
||||||
|
application, which must be installed in /Developer/Applications/Utilities.
|
||||||
|
|
||||||
|
make udmg
|
||||||
|
|
||||||
|
On 64-bit OS X (10.6 "Snow Leopard" or later), this creates a version of the
|
||||||
|
Macintosh package/disk image which contains universal i386/x86-64 binaries.
|
||||||
|
The 32-bit fork of these binaries is backward compatible with OS X 10.4 and
|
||||||
|
later, whereas the 64-bit fork is compatible with OS X 10.6 and later. OS X
|
||||||
|
10.4 compatibility SDK required.
|
||||||
|
|
||||||
|
make -f win/Makefile dist
|
||||||
|
|
||||||
|
This creates a Win32 installer for the libjpeg-turbo SDK. This requires the
|
||||||
|
Nullsoft Install System (http://nsis.sourceforge.net/.) makensis.exe should
|
||||||
|
be in your PATH.
|
||||||
@@ -82,7 +82,7 @@ DISTMANS= cjpeg.1 djpeg.1 jpegtran.1 rdjpgcom.1 wrjpgcom.1
|
|||||||
|
|
||||||
DOCS= README install.doc usage.doc wizard.doc example.c libjpeg.doc \
|
DOCS= README install.doc usage.doc wizard.doc example.c libjpeg.doc \
|
||||||
structure.doc coderules.doc filelist.doc jconfig.doc change.log \
|
structure.doc coderules.doc filelist.doc jconfig.doc change.log \
|
||||||
README-turbo.txt rdrle.c wrrle.c LICENSE.txt LGPL.txt
|
README-turbo.txt rdrle.c wrrle.c LICENSE.txt LGPL.txt BUILDING.txt
|
||||||
|
|
||||||
TESTFILES= testorig.jpg testimg.ppm testimg.bmp testimg.jpg testprog.jpg \
|
TESTFILES= testorig.jpg testimg.ppm testimg.bmp testimg.jpg testprog.jpg \
|
||||||
testimgp.jpg
|
testimgp.jpg
|
||||||
|
|||||||
410
README-turbo.txt
410
README-turbo.txt
@@ -17,9 +17,8 @@ and TurboVNC. libjpeg-turbo generally performs in the range of 80-120% of
|
|||||||
TurboJPEG/IPP. It is faster in some areas but slower in others.
|
TurboJPEG/IPP. It is faster in some areas but slower in others.
|
||||||
|
|
||||||
It was decided to split libjpeg-turbo into a separate SDK so that other
|
It was decided to split libjpeg-turbo into a separate SDK so that other
|
||||||
projects could take advantage of this technology. The shared libraries
|
projects could take advantage of this technology. The libjpeg-turbo shared
|
||||||
built from the libjpeg-turbo source can be used as drop-in replacements for
|
libraries can be used as drop-in replacements for libjpeg on most systems.
|
||||||
libjpeg on most systems.
|
|
||||||
|
|
||||||
|
|
||||||
*******************************************************************************
|
*******************************************************************************
|
||||||
@@ -27,258 +26,163 @@ libjpeg on most systems.
|
|||||||
*******************************************************************************
|
*******************************************************************************
|
||||||
|
|
||||||
Some of the optimizations to the Huffman encoder/decoder were borrowed from
|
Some of the optimizations to the Huffman encoder/decoder were borrowed from
|
||||||
VirtualGL, and thus libjpeg-turbo, as a whole, falls under the wxWindows
|
VirtualGL, and thus the libjpeg-turbo distribution, as a whole, falls under the
|
||||||
Library Licence, Version 3.1. A copy of this license can be found in this
|
wxWindows Library Licence, Version 3.1. A copy of this license can be found in
|
||||||
directory under LICENSE.txt. The rest of the source code, apart from these
|
this directory under LICENSE.txt. The rest of the source code, apart from
|
||||||
modifications, falls under a less restrictive license (see README.)
|
these modifications, falls under a less restrictive license (see README.)
|
||||||
|
|
||||||
|
|
||||||
*******************************************************************************
|
*******************************************************************************
|
||||||
** Building on Unix Platforms, Cygwin, and MinGW
|
** Using libjpeg-turbo
|
||||||
*******************************************************************************
|
*******************************************************************************
|
||||||
|
|
||||||
==================
|
=============================
|
||||||
Build Requirements
|
Replacing libjpeg at Run Time
|
||||||
==================
|
=============================
|
||||||
|
|
||||||
-- autoconf 2.56 or later
|
If a Unix application is dynamically linked with libjpeg, then you can replace
|
||||||
* If using MinGW, this can be obtained by installing the MSYS DTK
|
libjpeg with libjpeg-turbo at run time by manipulating the LD_LIBRARY_PATH.
|
||||||
|
For instance:
|
||||||
-- automake 1.7 or later
|
|
||||||
* If using MinGW, this can be obtained by installing the MSYS DTK
|
[Using libjpeg]
|
||||||
|
> time cjpeg <vgl_5674_0098.ppm >vgl_5674_0098.jpg
|
||||||
-- libtool 1.4 or later
|
real 0m0.392s
|
||||||
* If using MinGW, this can be obtained by installing the MSYS DTK
|
user 0m0.074s
|
||||||
|
sys 0m0.020s
|
||||||
-- NASM
|
|
||||||
* 0.98 or later is required for a 32-bit build
|
[Using libjpeg-turbo]
|
||||||
* NASM 2.05 or later is required for a 64-bit build
|
> export LD_LIBRARY_PATH=/opt/libjpeg-turbo/{lib}:$LD_LIBRARY_PATH
|
||||||
* NASM 2.07 or later is required for a 64-bit build on OS/X (10.6 "Snow
|
> time cjpeg <vgl_5674_0098.ppm >vgl_5674_0098.jpg
|
||||||
Leopard" or later.) This can be obtained from MacPorts
|
real 0m0.109s
|
||||||
(http://www.macports.org/).
|
user 0m0.029s
|
||||||
|
sys 0m0.010s
|
||||||
The NASM 2.05 RPMs do not work on older Linux systems, such as Enterprise
|
|
||||||
Linux 4. On such systems, you can easily build and install NASM 2.05
|
NOTE: {lib} can be lib, lib32, lib64, or lib/amd64, depending on the O/S and
|
||||||
from the source RPM by executing the following as root:
|
architecture.
|
||||||
|
|
||||||
ARCH=`uname -m`
|
System administrators can also replace the libjpeg sym links in /usr/{lib} with
|
||||||
wget http://www.nasm.us/pub/nasm/releasebuilds/2.05.01/nasm-2.05.01-1.src.rpm
|
links to the libjpeg dynamic library located in /opt/libjpeg-turbo/{lib}. This
|
||||||
rpmbuild --rebuild nasm-2.05.01-1.src.rpm
|
will effectively accelerate every dynamically linked libjpeg application on the
|
||||||
rpm -Uvh /usr/src/redhat/RPMS/$ARCH/nasm-2.05.01-1.$ARCH.rpm
|
system.
|
||||||
|
|
||||||
-- GCC v4 or later recommended for best performance
|
The Windows version of libjpeg-turbo installs jpeg62.dll into
|
||||||
|
%systemroot%\system32. However, if jpeg62.dll also exists in an application's
|
||||||
======================
|
install directory, then Windows will load the application's version of it
|
||||||
Building libjpeg-turbo
|
first. Thus, if an application ships with jpeg62.dll, then back up the
|
||||||
======================
|
application's version of jpeg62.dll and copy %systemroot%\system32\jpeg62.dll
|
||||||
|
into the application's install directory to accelerate it.
|
||||||
The following procedure will build libjpeg-turbo on Linux, 32-bit OS X, and
|
|
||||||
Solaris/x86 systems (on Solaris, this generates a 32-bit library. See below
|
Mac applications typically embed their own copies of libjpeg.62.dylib inside
|
||||||
for 64-bit build instructions.)
|
the (hidden) application bundle, so it is not possible to globally replace
|
||||||
|
libjpeg on OS X systems. If an application uses a shared library version of
|
||||||
cd libjpeg-turbo
|
libjpeg, then it may be possible to replace the application's version of it.
|
||||||
autoreconf -fiv
|
This would generally involve copying libjpeg.62.dylib into the appropriate
|
||||||
sh ./configure
|
place in the application bundle and using install_name_tool to repoint the
|
||||||
make
|
dylib to the new directory. This requires an advanced knowledge of OS X and
|
||||||
|
would not survive an upgrade or a re-install of the application. Thus, it is
|
||||||
NOTE: Running autoreconf is only necessary if building libjpeg-turbo from the
|
not recommended for most users.
|
||||||
SVN repository.
|
|
||||||
|
=======================
|
||||||
This will generate the following files under .libs/
|
Replacing TurboJPEG/IPP
|
||||||
|
=======================
|
||||||
libjpeg.a
|
|
||||||
Static link library for libjpeg-turbo
|
libjpeg-turbo is a drop-in replacement for the TurboJPEG/IPP SDK used by
|
||||||
|
VirtualGL 2.1.x (and prior) and TurboVNC. libjpeg-turbo contains a wrapper
|
||||||
libjpeg.so.62.0.0 (Linux, Solaris)
|
library (TurboJPEG/OSS) that emulates the TurboJPEG API using libjpeg-turbo
|
||||||
libjpeg.62.dylib (OS X)
|
instead of the closed source Intel Performance Primitives. You can replace the
|
||||||
libjpeg-62.dll (MinGW)
|
TurboJPEG/IPP package on Linux systems with the libjpeg-turbo package in order
|
||||||
cygjpeg-62.dll (Cygwin)
|
to make existing releases of VirtualGL 2.1.x and TurboVNC use the new codec at
|
||||||
Shared library for libjpeg-turbo
|
run time. Note that the 64-bit libjpeg-turbo packages contain only 64-bit
|
||||||
|
binaries, whereas the TurboJPEG/IPP 64-bit packages contain both 64-bit and
|
||||||
libjpeg.so (Linux, Solaris)
|
32-bit binaries. Thus, to replace a TurboJPEG/IPP 64-bit package, install
|
||||||
libjpeg.dylib (OS X)
|
both the 64-bit and 32-bit versions of libjpeg-turbo.
|
||||||
libjpeg.dll.a (Cygwin, MinGW)
|
|
||||||
Development stub for libjpeg-turbo shared library
|
You can also build the VirtualGL 2.1.x and TurboVNC source code with
|
||||||
|
the libjpeg-turbo SDK instead of TurboJPEG/IPP. It should work identically.
|
||||||
libturbojpeg.a
|
libjpeg-turbo also includes static library versions of TurboJPEG/OSS, which
|
||||||
Static link library for TurboJPEG/OSS
|
are used to build VirtualGL 2.2 and later.
|
||||||
|
|
||||||
libturbojpeg.so (Linux, Solaris)
|
========================================
|
||||||
libturbojpeg.dylib (OS X)
|
Using libjpeg-turbo in Your Own Programs
|
||||||
Shared library and development stub for TurboJPEG/OSS
|
========================================
|
||||||
|
|
||||||
libturbojpeg.dll (MinGW)
|
For the most part, libjpeg-turbo should work identically to libjpeg, so in
|
||||||
cygturbojpeg.dll (Cygwin)
|
most cases, an application can be built against libjpeg and then run against
|
||||||
Shared library for TurboJPEG/OSS
|
libjpeg-turbo. On Unix systems, you can build against libjpeg-turbo instead
|
||||||
|
of libjpeg by setting
|
||||||
libturbojpeg.dll.a (Cygwin, MinGW)
|
|
||||||
Development stub for TurboJPEG/OSS shared library
|
CPATH=/opt/libjpeg-turbo/include
|
||||||
|
and
|
||||||
========================
|
LIBRARY_PATH=/opt/libjpeg-turbo/{lib}
|
||||||
Installing libjpeg-turbo
|
|
||||||
========================
|
({lib} = lib, lib32, lib64, or lib/amd64, as appropriate.)
|
||||||
|
|
||||||
If you intend to install these libraries and the associated header files, then
|
This is useful, for instance, if you want to build an application that
|
||||||
replace 'make' in the instructions above with
|
leverages the libjpeg-turbo colorspace extensions (see below.) On Linux and
|
||||||
|
Solaris systems, you would still need to manipulate the LD_LIBRARY_PATH or sym
|
||||||
make install prefix={base dir} libdir={library directory}
|
links appropriately to use libjpeg-turbo at run time. On such systems, you can
|
||||||
|
pass -R /opt/libjpeg-turbo/{lib} to the linker to force the use of
|
||||||
For example,
|
libjpeg-turbo at run time rather than libjpeg (also useful if you want to
|
||||||
|
leverage the colorspace extensions), or you can link against the libjpeg-turbo
|
||||||
make install prefix=/usr libdir=/usr/lib64
|
static library.
|
||||||
|
|
||||||
will overwrite the system version of libjpeg on a 64-bit RedHat-based Linux
|
To force a Linux or Solaris application to link against the static version of
|
||||||
machine, causing any 64-bit applications that use libjpeg to be instantly
|
libjpeg-turbo, you can use the following linker options:
|
||||||
accelerated. BACK UP YOUR SYSTEM'S INSTALLATION OF LIBJPEG BEFORE OVERWRITING
|
|
||||||
IT.
|
-Wl,-Bstatic -ljpeg -Wl,-Bdynamic
|
||||||
|
|
||||||
The same can be done for 32-bit applications by building libjpeg-turbo as a
|
or you can simply add /opt/libjpeg-turbo/{lib}/libjpeg.a to the linker command
|
||||||
32-bit library (see below) and installing with a libdir of /usr/lib. On
|
line (the latter is the only way to link against the static version of
|
||||||
Debian-based systems, 64-bit libraries are stored in /usr/lib and 32-bit
|
libjpeg-turbo on OS X.)
|
||||||
libraries in /usr/lib32. On Solaris, 64-bit libraries are stored in
|
|
||||||
/usr/lib/amd64 and 32-bit libraries in /usr/lib.
|
To build Visual C++ applications using libjpeg-turbo, add
|
||||||
|
c:\libjpeg-turbo\include to your system or user INCLUDE environment variable
|
||||||
Mac applications typically bundle their own copies of libjpeg.62.dylib, so it
|
and c:\libjpeg-turbo\lib to your system or user LIB environment variable, and
|
||||||
is not possible to globally replace libjpeg on OS X systems. However, libjpeg
|
then link against either jpeg.lib (to use jpeg62.dll) or jpeg-static.lib (to
|
||||||
can be replaced on an application-by-application basis, for those applications
|
use the static version of libjpeg-turbo.)
|
||||||
which use a shared library version of it. This would generally involve copying
|
|
||||||
libjpeg.62.dylib into the appropriate place in the application's Contents and
|
If building an application using Cygwin, then set
|
||||||
using install_name_tool to repoint the dylib to the new directory. This
|
|
||||||
requires an advanced knowledge of OS X and is not recommended for most users.
|
CPATH=/cygdrive/c/libjpeg-turbo/include
|
||||||
|
and
|
||||||
=============
|
LIBRARY_PATH=/cygdrive/c/libjpeg-turbo/lib
|
||||||
Build Recipes
|
|
||||||
=============
|
If using MinGW, then set
|
||||||
|
|
||||||
32-bit Library Build on 64-bit Linux
|
CPATH=/c/libjpeg-turbo/include
|
||||||
------------------------------------
|
and
|
||||||
|
LIBRARY_PATH=/c/libjpeg-turbo/lib
|
||||||
Same instructions as above, but add
|
|
||||||
|
and link using -ljpeg in both cases. NOTE: The static libraries shipped with
|
||||||
--host i686-pc-linux-gnu CFLAGS='-O3 -m32' CXXFLAGS='-O3 -m32'
|
the Windows version of libjpeg-turbo cannot be used with MinGW and Cygwin. If
|
||||||
|
you wish to link statically with libjpeg-turbo using MinGW or Cygwin, then you
|
||||||
to the configure command line.
|
will need to build libjpeg-turbo from source using GCC.
|
||||||
|
|
||||||
|
=====================
|
||||||
64-bit Library Build on 64-bit OS/X
|
Colorspace Extensions
|
||||||
-----------------------------------
|
=====================
|
||||||
|
|
||||||
Same instructions as above, but add
|
libjpeg-turbo includes extensions which allow JPEG images to be compressed
|
||||||
|
directly from (and decompressed directly to) buffers which use BGR, BGRA,
|
||||||
--host x86_64-apple-darwin10.0.0 NASM=/opt/local/bin/nasm
|
RGBA, ABGR, and ARGB pixel ordering. This is implemented with six new
|
||||||
|
colorspace constants:
|
||||||
to the configure command line. NASM 2.07 from MacPorts must be installed.
|
|
||||||
|
JCS_EXT_RGB /* red/green/blue */
|
||||||
|
JCS_EXT_RGBX /* red/green/blue/x */
|
||||||
32-bit Library Build on 64-bit OS/X
|
JCS_EXT_BGR /* blue/green/red */
|
||||||
-----------------------------------
|
JCS_EXT_BGRX /* blue/green/red/x */
|
||||||
|
JCS_EXT_XBGR /* x/blue/green/red */
|
||||||
Same instructions as above, but add
|
JCS_EXT_XRGB /* x/red/green/blue */
|
||||||
|
|
||||||
CFLAGS='-O3 -m32' CXXFLAGS='-O3 -m32' LDFLAGS=-m32
|
Setting cinfo.in_color_space (compression) or cinfo.out_color_space
|
||||||
|
(decompression) to one of these values will cause libjpeg-turbo to read the
|
||||||
to the configure command line.
|
red, green, and blue values from (or write them to) the appropriate position in
|
||||||
|
the pixel when YUV conversion is performed.
|
||||||
|
|
||||||
32-bit Backward-Compatible Library Build on 64-bit OS/X
|
Your application can check for the existence of these extensions at compile
|
||||||
-------------------------------------------------------
|
time with:
|
||||||
|
|
||||||
Same instructions as above, but add
|
#ifdef JCS_EXTENSIONS
|
||||||
|
|
||||||
CC=gcc-4.0 CXX=g++-4.0 CFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk \
|
At run time, attempting to use these extensions with a version of libjpeg
|
||||||
-mmacosx-version-min=10.4 -O3 -m32' CXXFLAGS='-isysroot \
|
that doesn't support them will result in a "Bogus input colorspace" error.
|
||||||
/Developer/SDKs/MacOSX10.4u.sdk -mmacosx-version-min=10.4 -O3 -m32' \
|
|
||||||
LDFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk \
|
|
||||||
-mmacosx-version-min=10.4 -m32'
|
|
||||||
|
|
||||||
to the configure command line. The OS X 10.4 SDK must be installed.
|
|
||||||
|
|
||||||
|
|
||||||
64-bit Library Build on 64-bit Solaris
|
|
||||||
--------------------------------------
|
|
||||||
|
|
||||||
Same instructions as above, but add
|
|
||||||
|
|
||||||
--host x86_64-pc-solaris CFLAGS='-O3 -m64' CXXFLAGS='-O3 -m64' LDFLAGS=-m64
|
|
||||||
|
|
||||||
to the configure command line.
|
|
||||||
|
|
||||||
|
|
||||||
MinGW Build on Cygwin
|
|
||||||
---------------------
|
|
||||||
|
|
||||||
Same instructions as above, but add
|
|
||||||
|
|
||||||
--host mingw32
|
|
||||||
|
|
||||||
to the configure command line. This will produce libraries which do not
|
|
||||||
depend on cygwin1.dll or other Cygwin DLL's.
|
|
||||||
|
|
||||||
|
|
||||||
*******************************************************************************
|
|
||||||
** Windows (Visual C++)
|
|
||||||
*******************************************************************************
|
|
||||||
|
|
||||||
==================
|
|
||||||
Build Requirements
|
|
||||||
==================
|
|
||||||
|
|
||||||
-- GNU Make v3.7 or later
|
|
||||||
* Can be found in MSYS (http://www.mingw.org/download.shtml) or
|
|
||||||
Cygwin (http://www.cygwin.com/)
|
|
||||||
|
|
||||||
-- Microsoft Visual C++ 2003 or later
|
|
||||||
* Tested with Microsoft Visual C++ 2008 Express Edition (free download):
|
|
||||||
|
|
||||||
http://msdn.microsoft.com/vstudio/express/visualc/
|
|
||||||
|
|
||||||
* Add the compiler binary directories (for instance,
|
|
||||||
c:\Program Files\Microsoft Visual Studio 9.0\VC\BIN;
|
|
||||||
c:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE)
|
|
||||||
to the system or user PATH environment variable prior to building
|
|
||||||
libjpeg-turbo.
|
|
||||||
* Add the compiler include directory (for instance,
|
|
||||||
c:\Program Files\Microsoft Visual Studio 9.0\VC\INCLUDE)
|
|
||||||
to the system or user INCLUDE environment variable prior to building
|
|
||||||
libjpeg-turbo.
|
|
||||||
* Add the compiler library directory (for instance,
|
|
||||||
c:\Program Files\Microsoft Visual Studio 9.0\VC\LIB)
|
|
||||||
to the system or user LIB environment variable prior to building
|
|
||||||
libjpeg-turbo.
|
|
||||||
|
|
||||||
-- Microsoft Windows SDK
|
|
||||||
* This is included with Microsoft Visual C++ 2008 Express Edition, but users
|
|
||||||
of prior editions of Visual C++ can download the SDK from:
|
|
||||||
|
|
||||||
http://msdn2.microsoft.com/en-us/windowsserver/bb980924.aspx
|
|
||||||
|
|
||||||
* Add the SDK binary directory (for instance,
|
|
||||||
c:\Program Files\Microsoft SDKs\Windows\v6.0A\bin)
|
|
||||||
to the system or user PATH environment variable prior to building
|
|
||||||
libjpeg-turbo.
|
|
||||||
* Add the SDK include directory (for instance,
|
|
||||||
c:\Program Files\Microsoft SDKs\Windows\v6.0A\include)
|
|
||||||
to the system or user INCLUDE environment variable prior to building
|
|
||||||
libjpeg-turbo.
|
|
||||||
* Add the SDK library directory (for instance,
|
|
||||||
c:\Program Files\Microsoft SDKs\Windows\v6.0A\lib)
|
|
||||||
to the system or user LIB environment variable prior to building
|
|
||||||
libjpeg-turbo.
|
|
||||||
|
|
||||||
-- NASM (http://www.nasm.us/) 0.98 or later
|
|
||||||
|
|
||||||
======================
|
|
||||||
Building libjpeg-turbo
|
|
||||||
======================
|
|
||||||
|
|
||||||
cd libjpeg-turbo
|
|
||||||
make -f win/Makefile
|
|
||||||
|
|
||||||
This will generate the following files:
|
|
||||||
|
|
||||||
jpeg-static.lib Static link library for libjpeg-turbo
|
|
||||||
jpeg62.dll Shared library for libjpeg-turbo
|
|
||||||
jpeg.lib Development stub for libjpeg-turbo shared library
|
|
||||||
turbojpeg-static.lib Static link library for TurboJPEG/OSS
|
|
||||||
turbojpeg.dll Shared library for TurboJPEG/OSS
|
|
||||||
turbojpeg.lib Development stub for TurboJPEG/OSS shared library
|
|
||||||
|
|||||||
Reference in New Issue
Block a user