diff options
Diffstat (limited to 'graphics/mozjpeg/README')
| -rw-r--r-- | graphics/mozjpeg/README | 71 |
1 files changed, 45 insertions, 26 deletions
diff --git a/graphics/mozjpeg/README b/graphics/mozjpeg/README index 00b151318f373..a8d968a844c56 100644 --- a/graphics/mozjpeg/README +++ b/graphics/mozjpeg/README @@ -1,41 +1,60 @@ mozjpeg (Mozilla JPEG Encoder Project) -mozjpeg is a fork of libjpeg-turbo from Mozilla Research. Its goal is to -reduce the size of JPEG files without reducing quality or compatibility -with the vast majority of the world's deployed decoders. The idea is to -reduce transfer times for JPEGs on the Web, thus reducing page load times. - -mozjpeg is not intended to be a general JPEG library replacement. It makes -tradeoffs that are intended to benefit Web use cases and focuses solely -on improving encoding. It is best used as part of a Web encoding workflow. - -In essence, libjpeg-turbo (as shipped with Slackware) is optimized for -speed of encoding/decoding, while mozjpeg is optimized for encoding -smaller file sizes (at the expense of speed). mozjpeg will not interfere -with Slackware's libjpeg-turbo package, as it installs to /opt/mozjpeg/. +mozjpeg is a fork of libjpeg-turbo from Mozilla Research. Its +goal is to reduce the size of JPEG files without reducing quality +or compatibility with the vast majority of the world's deployed +decoders. The idea is to reduce transfer times for JPEGs on the Web, +thus reducing page load times. + +mozjpeg is not intended to be a general JPEG library replacement. It +makes tradeoffs that are intended to benefit Web use cases and +focuses solely on improving encoding. It is best used as part of a Web +encoding workflow. + +In essence, libjpeg-turbo (as shipped with Slackware) is optimized +for speed of encoding/decoding, while mozjpeg is optimized for +encoding smaller file sizes (at the expense of speed). mozjpeg will +not interfere with Slackware's libjpeg-turbo package, as it installs +to /opt/mozjpeg/. mozjpeg supports multiple versions of the libjpeg API. By default, version 6b is built. If you need compatibility with libjpeg 7 or 8, set API=7 or API=8 in the script's environment. -Optionally, mozjpeg can be built with Java wrapper support for -turbojpeg. To do this, install one of: jdk, openjdk, openjdk8, or -openjdk6. Then run this script with JAVA=yes in the environment. +Usage +----- +To run the binaries, either call them by their full paths, e.g: -To run the binaries, it's probably easiest to add this to ~/.bash_profile: +$ /opt/mozjpeg/bin/cjpeg -export PATH=/opt/mozjpeg/bin:$PATH -export MANPATH=/opt/mozjpeg/man:$MANPATH +...or else: -To compile & link with the mozjpeg libraries, use -I/opt/mozjpeg/include -and -L/opt/mozjpeg/lib (or lib64). You might also want -static, or -else -Wl,-rpath,/opt/mozjpeg/lib (or lib64). Starting with version 3.2, -there's also pkg-config support for mozjpeg. In ~/.bash_profile: +$ source /etc/profile.d/mozjpeg.sh -export PKG_CONFIG_PATH=/opt/mozjpeg/lib64/pkgconfig:$PKG_CONFIG_PATH +...to temporarily make mozjpeg the default, in the current shell. +Running e.g. "cjpeg" will now run the mozjpeg one. If you wanted to +do this permanently for all users (not recommended), you could: -(chage lib64 to lib, for 32-bit Slackware) +# chmod +x /etc/profile.d/mozjpeg.sh -If you built with JAVA=yes, the java library will be installed +...then log out and back in. The profile script isn't executable by +default, to avoid surprises. + +Development +----------- +To compile & link with the mozjpeg libraries, use -I/opt/mozjpeg/include +and -L/opt/mozjpeg/lib (or lib64). You might also want -static, or +else -Wl,-rpath,/opt/mozjpeg/lib (or lib64). Starting with version 3.2, +there's also pkg-config support for mozjpeg. If you source the profile +script, software that uses pkg-config should find and link with the +mozjpeg libraries automatically. + +Java Support +------------ +Optionally, mozjpeg can be built with Java wrapper support +for turbojpeg. To do this, install one of: jdk, openjdk8, +openjdk7, or openjdk6 (or possibly one of the zulu-openjdk* +or adoptopenjdk* packages; untested). Then run this script with +JAVA=yes in the environment. The Java library will be installed as /opt/mozjpeg/classes/turbojpeg.jar, and the docs will be in /usr/doc/mozjpeg-$VERSION/javadoc. |