diff options
Diffstat (limited to 'src/3rdparty/libtiff/html')
131 files changed, 30057 insertions, 0 deletions
diff --git a/src/3rdparty/libtiff/html/Makefile.am b/src/3rdparty/libtiff/html/Makefile.am new file mode 100644 index 0000000..6941dfb --- /dev/null +++ b/src/3rdparty/libtiff/html/Makefile.am @@ -0,0 +1,81 @@ +# $Id: Makefile.am,v 1.16 2006/03/23 14:54:01 dron Exp $ +# +# Tag Image File Format (TIFF) Software +# +# Copyright (C) 2004, Andrey Kiselev <dron@ak4719.spb.edu> +# +# Permission to use, copy, modify, distribute, and sell this software and +# its documentation for any purpose is hereby granted without fee, provided +# that (i) the above copyright notices and this permission notice appear in +# all copies of the software and related documentation, and (ii) the names of +# Sam Leffler and Silicon Graphics may not be used in any advertising or +# publicity relating to the software without the specific, prior written +# permission of Sam Leffler and Silicon Graphics. +# +# THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, +# EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY +# WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. +# +# IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR +# ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, +# OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, +# WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF +# LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE +# OF THIS SOFTWARE. + +# Process this file with automake to produce Makefile.in. + +docdir = $(LIBTIFF_DOCDIR)/html + +docfiles = \ + addingtags.html \ + bugs.html \ + build.html \ + contrib.html \ + document.html \ + images.html \ + index.html \ + internals.html \ + intro.html \ + libtiff.html \ + misc.html \ + support.html \ + TIFFTechNote2.html \ + tools.html \ + v3.4beta007.html \ + v3.4beta016.html \ + v3.4beta018.html \ + v3.4beta024.html \ + v3.4beta028.html \ + v3.4beta029.html \ + v3.4beta031.html \ + v3.4beta032.html \ + v3.4beta033.html \ + v3.4beta034.html \ + v3.4beta035.html \ + v3.4beta036.html \ + v3.5.1.html \ + v3.5.2.html \ + v3.5.3.html \ + v3.5.4.html \ + v3.5.5.html \ + v3.5.6-beta.html \ + v3.5.7.html \ + v3.6.0.html \ + v3.6.1.html \ + v3.7.0alpha.html \ + v3.7.0beta.html \ + v3.7.0beta2.html \ + v3.7.0.html \ + v3.7.1.html \ + v3.7.2.html \ + v3.7.3.html \ + v3.7.4.html \ + v3.8.0.html \ + v3.8.1.html \ + v3.8.2.html + +dist_doc_DATA = $(docfiles) + +SUBDIRS = images man + diff --git a/src/3rdparty/libtiff/html/Makefile.in b/src/3rdparty/libtiff/html/Makefile.in new file mode 100644 index 0000000..7aa9f82 --- /dev/null +++ b/src/3rdparty/libtiff/html/Makefile.in @@ -0,0 +1,626 @@ +# Makefile.in generated by automake 1.9.6 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ + +# $Id: Makefile.in,v 1.46 2006/03/23 14:54:01 dron Exp $ +# +# Tag Image File Format (TIFF) Software +# +# Copyright (C) 2004, Andrey Kiselev <dron@ak4719.spb.edu> +# +# Permission to use, copy, modify, distribute, and sell this software and +# its documentation for any purpose is hereby granted without fee, provided +# that (i) the above copyright notices and this permission notice appear in +# all copies of the software and related documentation, and (ii) the names of +# Sam Leffler and Silicon Graphics may not be used in any advertising or +# publicity relating to the software without the specific, prior written +# permission of Sam Leffler and Silicon Graphics. +# +# THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, +# EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY +# WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. +# +# IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR +# ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, +# OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, +# WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF +# LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE +# OF THIS SOFTWARE. + +# Process this file with automake to produce Makefile.in. + +srcdir = @srcdir@ +top_srcdir = @top_srcdir@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +top_builddir = .. +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +INSTALL = @INSTALL@ +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +target_triplet = @target@ +subdir = html +DIST_COMMON = $(dist_doc_DATA) $(srcdir)/Makefile.am \ + $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/acinclude.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/config/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/libtiff/tif_config.h \ + $(top_builddir)/libtiff/tiffconf.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ + html-recursive info-recursive install-data-recursive \ + install-exec-recursive install-info-recursive \ + install-recursive installcheck-recursive installdirs-recursive \ + pdf-recursive ps-recursive uninstall-info-recursive \ + uninstall-recursive +am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; +am__vpath_adj = case $$p in \ + $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ + *) f=$$p;; \ + esac; +am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; +am__installdirs = "$(DESTDIR)$(docdir)" +dist_docDATA_INSTALL = $(INSTALL_DATA) +DATA = $(dist_doc_DATA) +ETAGS = etags +CTAGS = ctags +DIST_SUBDIRS = $(SUBDIRS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +AMDEP_FALSE = @AMDEP_FALSE@ +AMDEP_TRUE = @AMDEP_TRUE@ +AMTAR = @AMTAR@ +AR = @AR@ +AS = @AS@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CXX = @CXX@ +CXXCPP = @CXXCPP@ +CXXDEPMODE = @CXXDEPMODE@ +CXXFLAGS = @CXXFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DLLTOOL = @DLLTOOL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +FGREP = @FGREP@ +GLUT_CFLAGS = @GLUT_CFLAGS@ +GLUT_LIBS = @GLUT_LIBS@ +GLU_CFLAGS = @GLU_CFLAGS@ +GLU_LIBS = @GLU_LIBS@ +GL_CFLAGS = @GL_CFLAGS@ +GL_LIBS = @GL_LIBS@ +GREP = @GREP@ +HAVE_CXX_FALSE = @HAVE_CXX_FALSE@ +HAVE_CXX_TRUE = @HAVE_CXX_TRUE@ +HAVE_OPENGL_FALSE = @HAVE_OPENGL_FALSE@ +HAVE_OPENGL_TRUE = @HAVE_OPENGL_TRUE@ +HAVE_RPATH_FALSE = @HAVE_RPATH_FALSE@ +HAVE_RPATH_TRUE = @HAVE_RPATH_TRUE@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBDIR = @LIBDIR@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTIFF_ALPHA_VERSION = @LIBTIFF_ALPHA_VERSION@ +LIBTIFF_DOCDIR = @LIBTIFF_DOCDIR@ +LIBTIFF_MAJOR_VERSION = @LIBTIFF_MAJOR_VERSION@ +LIBTIFF_MICRO_VERSION = @LIBTIFF_MICRO_VERSION@ +LIBTIFF_MINOR_VERSION = @LIBTIFF_MINOR_VERSION@ +LIBTIFF_RELEASE_DATE = @LIBTIFF_RELEASE_DATE@ +LIBTIFF_VERSION = @LIBTIFF_VERSION@ +LIBTIFF_VERSION_INFO = @LIBTIFF_VERSION_INFO@ +LIBTOOL = @LIBTOOL@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAINT = @MAINT@ +MAINTAINER_MODE_FALSE = @MAINTAINER_MODE_FALSE@ +MAINTAINER_MODE_TRUE = @MAINTAINER_MODE_TRUE@ +MAKEINFO = @MAKEINFO@ +NM = @NM@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PTHREAD_CC = @PTHREAD_CC@ +PTHREAD_CFLAGS = @PTHREAD_CFLAGS@ +PTHREAD_LIBS = @PTHREAD_LIBS@ +RANLIB = @RANLIB@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +VERSION = @VERSION@ +X_CFLAGS = @X_CFLAGS@ +X_EXTRA_LIBS = @X_EXTRA_LIBS@ +X_LIBS = @X_LIBS@ +X_PRE_LIBS = @X_PRE_LIBS@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_AS = @ac_ct_AS@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_CXX = @ac_ct_CXX@ +ac_ct_DLLTOOL = @ac_ct_DLLTOOL@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +ac_ct_OBJDUMP = @ac_ct_OBJDUMP@ +ac_ct_RANLIB = @ac_ct_RANLIB@ +ac_ct_STRIP = @ac_ct_STRIP@ +acx_pthread_config = @acx_pthread_config@ +am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ +am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ +am__fastdepCXX_FALSE = @am__fastdepCXX_FALSE@ +am__fastdepCXX_TRUE = @am__fastdepCXX_TRUE@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +datadir = @datadir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localstatedir = @localstatedir@ +lt_ECHO = @lt_ECHO@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +sysconfdir = @sysconfdir@ +target = @target@ +target_alias = @target_alias@ +target_cpu = @target_cpu@ +target_os = @target_os@ +target_vendor = @target_vendor@ +docdir = $(LIBTIFF_DOCDIR)/html +docfiles = \ + addingtags.html \ + bugs.html \ + build.html \ + contrib.html \ + document.html \ + images.html \ + index.html \ + internals.html \ + intro.html \ + libtiff.html \ + misc.html \ + support.html \ + TIFFTechNote2.html \ + tools.html \ + v3.4beta007.html \ + v3.4beta016.html \ + v3.4beta018.html \ + v3.4beta024.html \ + v3.4beta028.html \ + v3.4beta029.html \ + v3.4beta031.html \ + v3.4beta032.html \ + v3.4beta033.html \ + v3.4beta034.html \ + v3.4beta035.html \ + v3.4beta036.html \ + v3.5.1.html \ + v3.5.2.html \ + v3.5.3.html \ + v3.5.4.html \ + v3.5.5.html \ + v3.5.6-beta.html \ + v3.5.7.html \ + v3.6.0.html \ + v3.6.1.html \ + v3.7.0alpha.html \ + v3.7.0beta.html \ + v3.7.0beta2.html \ + v3.7.0.html \ + v3.7.1.html \ + v3.7.2.html \ + v3.7.3.html \ + v3.7.4.html \ + v3.8.0.html \ + v3.8.1.html \ + v3.8.2.html + +dist_doc_DATA = $(docfiles) +SUBDIRS = images man +all: all-recursive + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign html/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --foreign html/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs + +distclean-libtool: + -rm -f libtool +uninstall-info-am: +install-dist_docDATA: $(dist_doc_DATA) + @$(NORMAL_INSTALL) + test -z "$(docdir)" || $(mkdir_p) "$(DESTDIR)$(docdir)" + @list='$(dist_doc_DATA)'; for p in $$list; do \ + if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ + f=$(am__strip_dir) \ + echo " $(dist_docDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(docdir)/$$f'"; \ + $(dist_docDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(docdir)/$$f"; \ + done + +uninstall-dist_docDATA: + @$(NORMAL_UNINSTALL) + @list='$(dist_doc_DATA)'; for p in $$list; do \ + f=$(am__strip_dir) \ + echo " rm -f '$(DESTDIR)$(docdir)/$$f'"; \ + rm -f "$(DESTDIR)$(docdir)/$$f"; \ + done + +# This directory's subdirectories are mostly independent; you can cd +# into them and run `make' without going through this Makefile. +# To change the values of `make' variables: instead of editing Makefiles, +# (1) if the variable is set in `config.status', edit `config.status' +# (which will cause the Makefiles to be regenerated when you run `make'); +# (2) otherwise, pass the desired values on the `make' command line. +$(RECURSIVE_TARGETS): + @failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + target=`echo $@ | sed s/-recursive//`; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + dot_seen=yes; \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done; \ + if test "$$dot_seen" = "no"; then \ + $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ + fi; test -z "$$fail" + +mostlyclean-recursive clean-recursive distclean-recursive \ +maintainer-clean-recursive: + @failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + rev=''; for subdir in $$list; do \ + if test "$$subdir" = "."; then :; else \ + rev="$$subdir $$rev"; \ + fi; \ + done; \ + rev="$$rev ."; \ + target=`echo $@ | sed s/-recursive//`; \ + for subdir in $$rev; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done && test -z "$$fail" +tags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ + done +ctags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ + done + +ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) ' { files[$$0] = 1; } \ + END { for (i in files) print i; }'`; \ + mkid -fID $$unique +tags: TAGS + +TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + tags=; \ + here=`pwd`; \ + if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ + include_option=--etags-include; \ + empty_fix=.; \ + else \ + include_option=--include; \ + empty_fix=; \ + fi; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test ! -f $$subdir/TAGS || \ + tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \ + fi; \ + done; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) ' { files[$$0] = 1; } \ + END { for (i in files) print i; }'`; \ + if test -z "$(ETAGS_ARGS)$$tags$$unique"; then :; else \ + test -n "$$unique" || unique=$$empty_fix; \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + $$tags $$unique; \ + fi +ctags: CTAGS +CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + tags=; \ + here=`pwd`; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) ' { files[$$0] = 1; } \ + END { for (i in files) print i; }'`; \ + test -z "$(CTAGS_ARGS)$$tags$$unique" \ + || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ + $$tags $$unique + +GTAGS: + here=`$(am__cd) $(top_builddir) && pwd` \ + && cd $(top_srcdir) \ + && gtags -i $(GTAGS_ARGS) $$here + +distclean-tags: + -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ + list='$(DISTFILES)'; for file in $$list; do \ + case $$file in \ + $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ + $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ + esac; \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test "$$dir" != "$$file" && test "$$dir" != "."; then \ + dir="/$$dir"; \ + $(mkdir_p) "$(distdir)$$dir"; \ + else \ + dir=''; \ + fi; \ + if test -d $$d/$$file; then \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done + list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test -d "$(distdir)/$$subdir" \ + || $(mkdir_p) "$(distdir)/$$subdir" \ + || exit 1; \ + distdir=`$(am__cd) $(distdir) && pwd`; \ + top_distdir=`$(am__cd) $(top_distdir) && pwd`; \ + (cd $$subdir && \ + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$$top_distdir" \ + distdir="$$distdir/$$subdir" \ + distdir) \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-recursive +all-am: Makefile $(DATA) +installdirs: installdirs-recursive +installdirs-am: + for dir in "$(DESTDIR)$(docdir)"; do \ + test -z "$$dir" || $(mkdir_p) "$$dir"; \ + done +install: install-recursive +install-exec: install-exec-recursive +install-data: install-data-recursive +uninstall: uninstall-recursive + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-recursive +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-recursive + +clean-am: clean-generic clean-libtool mostlyclean-am + +distclean: distclean-recursive + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-libtool \ + distclean-tags + +dvi: dvi-recursive + +dvi-am: + +html: html-recursive + +info: info-recursive + +info-am: + +install-data-am: install-dist_docDATA + +install-exec-am: + +install-info: install-info-recursive + +install-man: + +installcheck-am: + +maintainer-clean: maintainer-clean-recursive + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-recursive + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-recursive + +pdf-am: + +ps: ps-recursive + +ps-am: + +uninstall-am: uninstall-dist_docDATA uninstall-info-am + +uninstall-info: uninstall-info-recursive + +.PHONY: $(RECURSIVE_TARGETS) CTAGS GTAGS all all-am check check-am \ + clean clean-generic clean-libtool clean-recursive ctags \ + ctags-recursive distclean distclean-generic distclean-libtool \ + distclean-recursive distclean-tags distdir dvi dvi-am html \ + html-am info info-am install install-am install-data \ + install-data-am install-dist_docDATA install-exec \ + install-exec-am install-info install-info-am install-man \ + install-strip installcheck installcheck-am installdirs \ + installdirs-am maintainer-clean maintainer-clean-generic \ + maintainer-clean-recursive mostlyclean mostlyclean-generic \ + mostlyclean-libtool mostlyclean-recursive pdf pdf-am ps ps-am \ + tags tags-recursive uninstall uninstall-am \ + uninstall-dist_docDATA uninstall-info-am + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/src/3rdparty/libtiff/html/TIFFTechNote2.html b/src/3rdparty/libtiff/html/TIFFTechNote2.html new file mode 100644 index 0000000..92bace4 --- /dev/null +++ b/src/3rdparty/libtiff/html/TIFFTechNote2.html @@ -0,0 +1,707 @@ +<pre> +DRAFT TIFF Technical Note #2 17-Mar-95 +============================ + +This Technical Note describes serious problems that have been found in +TIFF 6.0's design for embedding JPEG-compressed data in TIFF (Section 22 +of the TIFF 6.0 spec of 3 June 1992). A replacement TIFF/JPEG +specification is given. Some corrections to Section 21 are also given. + +To permit TIFF implementations to continue to read existing files, the 6.0 +JPEG fields and tag values will remain reserved indefinitely. However, +TIFF writers are strongly discouraged from using the 6.0 JPEG design. It +is expected that the next full release of the TIFF specification will not +describe the old design at all, except to note that certain tag numbers +are reserved. The existing Section 22 will be replaced by the +specification text given in the second part of this Tech Note. + + +Problems in TIFF 6.0 JPEG +========================= + +Abandoning a published spec is not a step to be taken lightly. This +section summarizes the reasons that have forced this decision. +TIFF 6.0's JPEG design suffers from design errors and limitations, +ambiguities, and unnecessary complexity. + + +Design errors and limitations +----------------------------- + +The fundamental design error in the existing Section 22 is that JPEG's +various tables and parameters are broken out as separate fields which the +TIFF control logic must manage. This is bad software engineering: that +information should be treated as private to the JPEG codec +(compressor/decompressor). Worse, the fields themselves are specified +without sufficient thought for future extension and without regard to +well-established TIFF conventions. Here are some of the significant +problems: + +* The JPEGxxTable fields do not store the table data directly in the +IFD/field structure; rather, the fields hold pointers to information +elsewhere in the file. This requires special-purpose code to be added to +*every* TIFF-manipulating application, whether it needs to decode JPEG +image data or not. Even a trivial TIFF editor, for example a program to +add an ImageDescription field to a TIFF file, must be explicitly aware of +the internal structure of the JPEG-related tables, or else it will probably +break the file. Every other auxiliary field in the TIFF spec contains +data, not pointers, and can be copied or relocated by standard code that +doesn't know anything about the particular field. This is a crucial +property of the TIFF format that must not be given up. + +* To manipulate these fields, the TIFF control logic is required to know a +great deal about JPEG details, for example such arcana as how to compute +the length of a Huffman code table --- the length is not supplied in the +field structure and can only be found by inspecting the table contents. +This is again a violation of good software practice. Moreover, it will +prevent easy adoption of future JPEG extensions that might change these +low-level details. + +* The design neglects the fact that baseline JPEG codecs support only two +sets of Huffman tables: it specifies a separate table for each color +component. This implies that encoders must waste space (by storing +duplicate Huffman tables) or else violate the well-founded TIFF convention +that prohibits duplicate pointers. Furthermore, baseline decoders must +test to find out which tables are identical, a waste of time and code +space. + +* The JPEGInterchangeFormat field also violates TIFF's proscription against +duplicate pointers: the normal strip/tile pointers are expected to point +into the larger data area pointed to by JPEGInterchangeFormat. All TIFF +editing applications must be specifically aware of this relationship, since +they must maintain it or else delete the JPEGInterchangeFormat field. The +JPEGxxTables fields are also likely to point into the JPEGInterchangeFormat +area, creating additional pointer relationships that must be maintained. + +* The JPEGQTables field is fixed at a byte per table entry; there is no +way to support 16-bit quantization values. This is a serious impediment +to extending TIFF to use 12-bit JPEG. + +* The 6.0 design cannot support using different quantization tables in +different strips/tiles of an image (so as to encode some areas at higher +quality than others). Furthermore, since quantization tables are tied +one-for-one to color components, the design cannot support table switching +options that are likely to be added in future JPEG revisions. + + +Ambiguities +----------- + +Several incompatible interpretations are possible for 6.0's treatment of +JPEG restart markers: + + * It is unclear whether restart markers must be omitted at TIFF segment + (strip/tile) boundaries, or whether they are optional. + + * It is unclear whether the segment size is required to be chosen as + a multiple of the specified restart interval (if any); perhaps the + JPEG codec is supposed to be reset at each segment boundary as if + there were a restart marker there, even if the boundary does not fall + at a multiple of the nominal restart interval. + + * The spec fails to address the question of restart marker numbering: + do the numbers begin again within each segment, or not? + +That last point is particularly nasty. If we make numbering begin again +within each segment, we give up the ability to impose a TIFF strip/tile +structure on an existing JPEG datastream with restarts (which was clearly a +goal of Section 22's authors). But the other choice interferes with random +access to the image segments: a reader must compute the first restart +number to be expected within a segment, and must have a way to reset its +JPEG decoder to expect a nonzero restart number first. This may not even +be possible with some JPEG chips. + +The tile height restriction found on page 104 contradicts Section 15's +general description of tiles. For an image that is not vertically +downsampled, page 104 specifies a tile height of one MCU or 8 pixels; but +Section 15 requires tiles to be a multiple of 16 pixels high. + +This Tech Note does not attempt to resolve these ambiguities, so +implementations that follow the 6.0 design should be aware that +inter-application compatibility problems are likely to arise. + + +Unnecessary complexity +---------------------- + +The 6.0 design creates problems for implementations that need to keep the +JPEG codec separate from the TIFF control logic --- for example, consider +using a JPEG chip that was not designed specifically for TIFF. JPEG codecs +generally want to produce or consume a standard ISO JPEG datastream, not +just raw compressed data. (If they were to handle raw data, a separate +out-of-band mechanism would be needed to load tables into the codec.) +With such a codec, the TIFF control logic must parse JPEG markers emitted +by the codec to create the TIFF table fields (when writing) or synthesize +JPEG markers from the TIFF fields to feed the codec (when reading). This +means that the control logic must know a great deal more about JPEG details +than we would like. The parsing and reconstruction of the markers also +represents a fair amount of unnecessary work. + +Quite a few implementors have proposed writing "TIFF/JPEG" files in which +a standard JPEG datastream is simply dumped into the file and pointed to +by JPEGInterchangeFormat. To avoid parsing the JPEG datastream, they +suggest not writing the JPEG auxiliary fields (JPEGxxTables etc) nor even +the basic TIFF strip/tile data pointers. This approach is incompatible +with implementations that handle the full TIFF 6.0 JPEG design, since they +will expect to find strip/tile pointers and auxiliary fields. Indeed this +is arguably not TIFF at all, since *all* TIFF-reading applications expect +to find strip or tile pointers. A subset implementation that is not +upward-compatible with the full spec is clearly unacceptable. However, +the frequency with which this idea has come up makes it clear that +implementors find the existing Section 22 too complex. + + +Overview of the solution +======================== + +To solve these problems, we adopt a new design for embedding +JPEG-compressed data in TIFF files. The new design uses only complete, +uninterpreted ISO JPEG datastreams, so it should be much more forgiving of +extensions to the ISO standard. It should also be far easier to implement +using unmodified JPEG codecs. + +To reduce overhead in multi-segment TIFF files, we allow JPEG overhead +tables to be stored just once in a JPEGTables auxiliary field. This +feature does not violate the integrity of the JPEG datastreams, because it +uses the notions of "tables-only datastreams" and "abbreviated image +datastreams" as defined by the ISO standard. + +To prevent confusion with the old design, the new design is given a new +Compression tag value, Compression=7. Readers that need to handle +existing 6.0 JPEG files may read both old and new files, using whatever +interpretation of the 6.0 spec they did before. Compression tag value 6 +and the field tag numbers defined by 6.0 section 22 will remain reserved +indefinitely, even though detailed descriptions of them will be dropped +from future editions of the TIFF specification. + + +Replacement TIFF/JPEG specification +=================================== + +[This section of the Tech Note is expected to replace Section 22 in the +next release of the TIFF specification.] + +This section describes TIFF compression scheme 7, a high-performance +compression method for continuous-tone images. + +Introduction +------------ + +This TIFF compression method uses the international standard for image +compression ISO/IEC 10918-1, usually known as "JPEG" (after the original +name of the standards committee, Joint Photographic Experts Group). JPEG +is a joint ISO/CCITT standard for compression of continuous-tone images. + +The JPEG committee decided that because of the broad scope of the standard, +no one algorithmic procedure was able to satisfy the requirements of all +applications. Instead, the JPEG standard became a "toolkit" of multiple +algorithms and optional capabilities. Individual applications may select +a subset of the JPEG standard that meets their requirements. + +The most important distinction among the JPEG processes is between lossy +and lossless compression. Lossy compression methods provide high +compression but allow only approximate reconstruction of the original +image. JPEG's lossy processes allow the encoder to trade off compressed +file size against reconstruction fidelity over a wide range. Typically, +10:1 or more compression of full-color data can be obtained while keeping +the reconstructed image visually indistinguishable from the original. Much +higher compression ratios are possible if a low-quality reconstructed image +is acceptable. Lossless compression provides exact reconstruction of the +source data, but the achievable compression ratio is much lower than for +the lossy processes; JPEG's rather simple lossless process typically +achieves around 2:1 compression of full-color data. + +The most widely implemented JPEG subset is the "baseline" JPEG process. +This provides lossy compression of 8-bit-per-channel data. Optional +extensions include 12-bit-per-channel data, arithmetic entropy coding for +better compression, and progressive/hierarchical representations. The +lossless process is an independent algorithm that has little in +common with the lossy processes. + +It should be noted that the optional arithmetic-coding extension is subject +to several US and Japanese patents. To avoid patent problems, use of +arithmetic coding processes in TIFF files intended for inter-application +interchange is discouraged. + +All of the JPEG processes are useful only for "continuous tone" data, +in which the difference between adjacent pixel values is usually small. +Low-bit-depth source data is not appropriate for JPEG compression, nor +are palette-color images good candidates. The JPEG processes work well +on grayscale and full-color data. + +Describing the JPEG compression algorithms in sufficient detail to permit +implementation would require more space than we have here. Instead, we +refer the reader to the References section. + + +What data is being compressed? +------------------------------ + +In lossy JPEG compression, it is customary to convert color source data +to YCbCr and then downsample it before JPEG compression. This gives +2:1 data compression with hardly any visible image degradation, and it +permits additional space savings within the JPEG compression step proper. +However, these steps are not considered part of the ISO JPEG standard. +The ISO standard is "color blind": it accepts data in any color space. + +For TIFF purposes, the JPEG compression tag is considered to represent the +ISO JPEG compression standard only. The ISO standard is applied to the +same data that would be stored in the TIFF file if no compression were +used. Therefore, if color conversion or downsampling are used, they must +be reflected in the regular TIFF fields; these steps are not considered to +be implicit in the JPEG compression tag value. PhotometricInterpretation +and related fields shall describe the color space actually stored in the +file. With the TIFF 6.0 field definitions, downsampling is permissible +only for YCbCr data, and it must correspond to the YCbCrSubSampling field. +(Note that the default value for this field is not 1,1; so the default for +YCbCr is to apply downsampling!) It is likely that future versions of TIFF +will provide additional PhotometricInterpretation values and a more general +way of defining subsampling, so as to allow more flexibility in +JPEG-compressed files. But that issue is not addressed in this Tech Note. + +Implementors should note that many popular JPEG codecs +(compressor/decompressors) provide automatic color conversion and +downsampling, so that the application may supply full-size RGB data which +is nonetheless converted to downsampled YCbCr. This is an implementation +convenience which does not excuse the TIFF control layer from its +responsibility to know what is really going on. The +PhotometricInterpretation and subsampling fields written to the file must +describe what is actually in the file. + +A JPEG-compressed TIFF file will typically have PhotometricInterpretation = +YCbCr and YCbCrSubSampling = [2,1] or [2,2], unless the source data was +grayscale or CMYK. + + +Basic representation of JPEG-compressed images +---------------------------------------------- + +JPEG compression works in either strip-based or tile-based TIFF files. +Rather than repeating "strip or tile" constantly, we will use the term +"segment" to mean either a strip or a tile. + +When the Compression field has the value 7, each image segment contains +a complete JPEG datastream which is valid according to the ISO JPEG +standard (ISO/IEC 10918-1). Any sequential JPEG process can be used, +including lossless JPEG, but progressive and hierarchical processes are not +supported. Since JPEG is useful only for continuous-tone images, the +PhotometricInterpretation of the image shall not be 3 (palette color) nor +4 (transparency mask). The bit depth of the data is also restricted as +specified below. + +Each image segment in a JPEG-compressed TIFF file shall contain a valid +JPEG datastream according to the ISO JPEG standard's rules for +interchange-format or abbreviated-image-format data. The datastream shall +contain a single JPEG frame storing that segment of the image. The +required JPEG markers within a segment are: + SOI (must appear at very beginning of segment) + SOFn + SOS (one for each scan, if there is more than one scan) + EOI (must appear at very end of segment) +The actual compressed data follows SOS; it may contain RSTn markers if DRI +is used. + +Additional JPEG "tables and miscellaneous" markers may appear between SOI +and SOFn, between SOFn and SOS, and before each subsequent SOS if there is +more than one scan. These markers include: + DQT + DHT + DAC (not to appear unless arithmetic coding is used) + DRI + APPn (shall be ignored by TIFF readers) + COM (shall be ignored by TIFF readers) +DNL markers shall not be used in TIFF files. Readers should abort if any +other marker type is found, especially the JPEG reserved markers; +occurrence of such a marker is likely to indicate a JPEG extension. + +The tables/miscellaneous markers may appear in any order. Readers are +cautioned that although the SOFn marker refers to DQT tables, JPEG does not +require those tables to precede the SOFn, only the SOS. Missing-table +checks should be made when SOS is reached. + +If no JPEGTables field is used, then each image segment shall be a complete +JPEG interchange datastream. Each segment must define all the tables it +references. To allow readers to decode segments in any order, no segment +may rely on tables being carried over from a previous segment. + +When a JPEGTables field is used, image segments may omit tables that have +been specified in the JPEGTables field. Further details appear below. + +The SOFn marker shall be of type SOF0 for strict baseline JPEG data, of +type SOF1 for non-baseline lossy JPEG data, or of type SOF3 for lossless +JPEG data. (SOF9 or SOF11 would be used for arithmetic coding.) All +segments of a JPEG-compressed TIFF image shall use the same JPEG +compression process, in particular the same SOFn type. + +The data precision field of the SOFn marker shall agree with the TIFF +BitsPerSample field. (Note that when PlanarConfiguration=1, this implies +that all components must have the same BitsPerSample value; when +PlanarConfiguration=2, different components could have different bit +depths.) For SOF0 only precision 8 is permitted; for SOF1, precision 8 or +12 is permitted; for SOF3, precisions 2 to 16 are permitted. + +The image dimensions given in the SOFn marker shall agree with the logical +dimensions of that particular strip or tile. For strip images, the SOFn +image width shall equal ImageWidth and the height shall equal RowsPerStrip, +except in the last strip; its SOFn height shall equal the number of rows +remaining in the ImageLength. (In other words, no padding data is counted +in the SOFn dimensions.) For tile images, each SOFn shall have width +TileWidth and height TileHeight; adding and removing any padding needed in +the edge tiles is the concern of some higher level of the TIFF software. +(The dimensional rules are slightly different when PlanarConfiguration=2, +as described below.) + +The ISO JPEG standard only permits images up to 65535 pixels in width or +height, due to 2-byte fields in the SOFn markers. In TIFF, this limits +the size of an individual JPEG-compressed strip or tile, but the total +image size can be greater. + +The number of components in the JPEG datastream shall equal SamplesPerPixel +for PlanarConfiguration=1, and shall be 1 for PlanarConfiguration=2. The +components shall be stored in the same order as they are described at the +TIFF field level. (This applies both to their order in the SOFn marker, +and to the order in which they are scanned if multiple JPEG scans are +used.) The component ID bytes are arbitrary so long as each component +within an image segment is given a distinct ID. To avoid any possible +confusion, we require that all segments of a TIFF image use the same ID +code for a given component. + +In PlanarConfiguration 1, the sampling factors given in SOFn markers shall +agree with the sampling factors defined by the related TIFF fields (or with +the default values that are specified in the absence of those fields). + +When DCT-based JPEG is used in a strip TIFF file, RowsPerStrip is required +to be a multiple of 8 times the largest vertical sampling factor, i.e., a +multiple of the height of an interleaved MCU. (For simplicity of +specification, we require this even if the data is not actually +interleaved.) For example, if YCbCrSubSampling = [2,2] then RowsPerStrip +must be a multiple of 16. An exception to this rule is made for +single-strip images (RowsPerStrip >= ImageLength): the exact value of +RowsPerStrip is unimportant in that case. This rule ensures that no data +padding is needed at the bottom of a strip, except perhaps the last strip. +Any padding required at the right edge of the image, or at the bottom of +the last strip, is expected to occur internally to the JPEG codec. + +When DCT-based JPEG is used in a tiled TIFF file, TileLength is required +to be a multiple of 8 times the largest vertical sampling factor, i.e., +a multiple of the height of an interleaved MCU; and TileWidth is required +to be a multiple of 8 times the largest horizontal sampling factor, i.e., +a multiple of the width of an interleaved MCU. (For simplicity of +specification, we require this even if the data is not actually +interleaved.) All edge padding required will therefore occur in the course +of normal TIFF tile padding; it is not special to JPEG. + +Lossless JPEG does not impose these constraints on strip and tile sizes, +since it is not DCT-based. + +Note that within JPEG datastreams, multibyte values appear in the MSB-first +order specified by the JPEG standard, regardless of the byte ordering of +the surrounding TIFF file. + + +JPEGTables field +---------------- + +The only auxiliary TIFF field added for Compression=7 is the optional +JPEGTables field. The purpose of JPEGTables is to predefine JPEG +quantization and/or Huffman tables for subsequent use by JPEG image +segments. When this is done, these rather bulky tables need not be +duplicated in each segment, thus saving space and processing time. +JPEGTables may be used even in a single-segment file, although there is no +space savings in that case. + +JPEGTables: + Tag = 347 (15B.H) + Type = UNDEFINED + N = number of bytes in tables datastream, typically a few hundred +JPEGTables provides default JPEG quantization and/or Huffman tables which +are used whenever a segment datastream does not contain its own tables, as +specified below. + +Notice that the JPEGTables field is required to have type code UNDEFINED, +not type code BYTE. This is to cue readers that expanding individual bytes +to short or long integers is not appropriate. A TIFF reader will generally +need to store the field value as an uninterpreted byte sequence until it is +fed to the JPEG decoder. + +Multibyte quantities within the tables follow the ISO JPEG convention of +MSB-first storage, regardless of the byte ordering of the surrounding TIFF +file. + +When the JPEGTables field is present, it shall contain a valid JPEG +"abbreviated table specification" datastream. This datastream shall begin +with SOI and end with EOI. It may contain zero or more JPEG "tables and +miscellaneous" markers, namely: + DQT + DHT + DAC (not to appear unless arithmetic coding is used) + DRI + APPn (shall be ignored by TIFF readers) + COM (shall be ignored by TIFF readers) +Since JPEG defines the SOI marker to reset the DAC and DRI state, these two +markers' values cannot be carried over into any image datastream, and thus +they are effectively no-ops in the JPEGTables field. To avoid confusion, +it is recommended that writers not place DAC or DRI markers in JPEGTables. +However readers must properly skip over them if they appear. + +When JPEGTables is present, readers shall load the table specifications +contained in JPEGTables before processing image segment datastreams. +Image segments may simply refer to these preloaded tables without defining +them. An image segment can still define and use its own tables, subject to +the restrictions below. + +An image segment may not redefine any table defined in JPEGTables. (This +restriction is imposed to allow readers to process image segments in random +order without having to reload JPEGTables between segments.) Therefore, use +of JPEGTables divides the available table slots into two groups: "global" +slots are defined in JPEGTables and may be used but not redefined by +segments; "local" slots are available for local definition and use in each +segment. To permit random access, a segment may not reference any local +tables that it does not itself define. + + +Special considerations for PlanarConfiguration 2 +------------------------------------------------ + +In PlanarConfiguration 2, each image segment contains data for only one +color component. To avoid confusing the JPEG codec, we wish the segments +to look like valid single-channel (i.e., grayscale) JPEG datastreams. This +means that different rules must be used for the SOFn parameters. + +In PlanarConfiguration 2, the dimensions given in the SOFn of a subsampled +component shall be scaled down by the sampling factors compared to the SOFn +dimensions that would be used in PlanarConfiguration 1. This is necessary +to match the actual number of samples stored in that segment, so that the +JPEG codec doesn't complain about too much or too little data. In strip +TIFF files the computed dimensions may need to be rounded up to the next +integer; in tiled files, the restrictions on tile size make this case +impossible. + +Furthermore, all SOFn sampling factors shall be given as 1. (This is +merely to avoid confusion, since the sampling factors in a single-channel +JPEG datastream have no real effect.) + +Any downsampling will need to happen externally to the JPEG codec, since +JPEG sampling factors are defined with reference to the full-precision +component. In PlanarConfiguration 2, the JPEG codec will be working on +only one component at a time and thus will have no reference component to +downsample against. + + +Minimum requirements for TIFF/JPEG +---------------------------------- + +ISO JPEG is a large and complex standard; most implementations support only +a subset of it. Here we define a "core" subset of TIFF/JPEG which readers +must support to claim TIFF/JPEG compatibility. For maximum +cross-application compatibility, we recommend that writers confine +themselves to this subset unless there is very good reason to do otherwise. + +Use the ISO baseline JPEG process: 8-bit data precision, Huffman coding, +with no more than 2 DC and 2 AC Huffman tables. Note that this implies +BitsPerSample = 8 for each component. We recommend deviating from baseline +JPEG only if 12-bit data precision or lossless coding is required. + +Use no subsampling (all JPEG sampling factors = 1) for color spaces other +than YCbCr. (This is, in fact, required with the TIFF 6.0 field +definitions, but may not be so in future revisions.) For YCbCr, use one of +the following choices: + YCbCrSubSampling field JPEG sampling factors + 1,1 1h1v, 1h1v, 1h1v + 2,1 2h1v, 1h1v, 1h1v + 2,2 (default value) 2h2v, 1h1v, 1h1v +We recommend that RGB source data be converted to YCbCr for best compression +results. Other source data colorspaces should probably be left alone. +Minimal readers need not support JPEG images with colorspaces other than +YCbCr and grayscale (PhotometricInterpretation = 6 or 1). + +A minimal reader also need not support JPEG YCbCr images with nondefault +values of YCbCrCoefficients or YCbCrPositioning, nor with values of +ReferenceBlackWhite other than [0,255,128,255,128,255]. (These values +correspond to the RGB<=>YCbCr conversion specified by JFIF, which is widely +implemented in JPEG codecs.) + +Writers are reminded that a ReferenceBlackWhite field *must* be included +when PhotometricInterpretation is YCbCr, because the default +ReferenceBlackWhite values are inappropriate for YCbCr. + +If any subsampling is used, PlanarConfiguration=1 is preferred to avoid the +possibly-confusing requirements of PlanarConfiguration=2. In any case, +readers are not required to support PlanarConfiguration=2. + +If possible, use a single interleaved scan in each image segment. This is +not legal JPEG if there are more than 4 SamplesPerPixel or if the sampling +factors are such that more than 10 blocks would be needed per MCU; in that +case, use a separate scan for each component. (The recommended color +spaces and sampling factors will not run into that restriction, so a +minimal reader need not support more than one scan per segment.) + +To claim TIFF/JPEG compatibility, readers shall support multiple-strip TIFF +files and the optional JPEGTables field; it is not acceptable to read only +single-datastream files. Support for tiled TIFF files is strongly +recommended but not required. + + +Other recommendations for implementors +-------------------------------------- + +The TIFF tag Compression=7 guarantees only that the compressed data is +represented as ISO JPEG datastreams. Since JPEG is a large and evolving +standard, readers should apply careful error checking to the JPEG markers +to ensure that the compression process is within their capabilities. In +particular, to avoid being confused by future extensions to the JPEG +standard, it is important to abort if unknown marker codes are seen. + +The point of requiring that all image segments use the same JPEG process is +to ensure that a reader need check only one segment to determine whether it +can handle the image. For example, consider a TIFF reader that has access +to fast but restricted JPEG hardware, as well as a slower, more general +software implementation. It is desirable to check only one image segment +to find out whether the fast hardware can be used. Thus, writers should +try to ensure that all segments of an image look as much "alike" as +possible: there should be no variation in scan layout, use of options such +as DRI, etc. Ideally, segments will be processed identically except +perhaps for using different local quantization or entropy-coding tables. + +Writers should avoid including "noise" JPEG markers (COM and APPn markers). +Standard TIFF fields provide a better way to transport any non-image data. +Some JPEG codecs may change behavior if they see an APPn marker they +think they understand; since the TIFF spec requires these markers to be +ignored, this behavior is undesirable. + +It is possible to convert an interchange-JPEG file (e.g., a JFIF file) to +TIFF simply by dropping the interchange datastream into a single strip. +(However, designers are reminded that the TIFF spec discourages huge +strips; splitting the image is somewhat more work but may give better +results.) Conversion from TIFF to interchange JPEG is more complex. A +strip-based TIFF/JPEG file can be converted fairly easily if all strips use +identical JPEG tables and no RSTn markers: just delete the overhead markers +and insert RSTn markers between strips. Converting tiled images is harder, +since the data will usually not be in the right order (unless the tiles are +only one MCU high). This can still be done losslessly, but it will require +undoing and redoing the entropy coding so that the DC coefficient +differences can be updated. + +There is no default value for JPEGTables: standard TIFF files must define all +tables that they reference. For some closed systems in which many files will +have identical tables, it might make sense to define a default JPEGTables +value to avoid actually storing the tables. Or even better, invent a +private field selecting one of N default JPEGTables settings, so as to allow +for future expansion. Either of these must be regarded as a private +extension that will render the files unreadable by other applications. + + +References +---------- + +[1] Wallace, Gregory K. "The JPEG Still Picture Compression Standard", +Communications of the ACM, April 1991 (vol. 34 no. 4), pp. 30-44. + +This is the best short technical introduction to the JPEG algorithms. +It is a good overview but does not provide sufficiently detailed +information to write an implementation. + +[2] Pennebaker, William B. and Mitchell, Joan L. "JPEG Still Image Data +Compression Standard", Van Nostrand Reinhold, 1993, ISBN 0-442-01272-1. +638pp. + +This textbook is by far the most complete exposition of JPEG in existence. +It includes the full text of the ISO JPEG standards (DIS 10918-1 and draft +DIS 10918-2). No would-be JPEG implementor should be without it. + +[3] ISO/IEC IS 10918-1, "Digital Compression and Coding of Continuous-tone +Still Images, Part 1: Requirements and guidelines", February 1994. +ISO/IEC DIS 10918-2, "Digital Compression and Coding of Continuous-tone +Still Images, Part 2: Compliance testing", final approval expected 1994. + +These are the official standards documents. Note that the Pennebaker and +Mitchell textbook is likely to be cheaper and more useful than the official +standards. + + +Changes to Section 21: YCbCr Images +=================================== + +[This section of the Tech Note clarifies section 21 to make clear the +interpretation of image dimensions in a subsampled image. Furthermore, +the section is changed to allow the original image dimensions not to be +multiples of the sampling factors. This change is necessary to support use +of JPEG compression on odd-size images.] + +Add the following paragraphs to the Section 21 introduction (p. 89), +just after the paragraph beginning "When a Class Y image is subsampled": + + In a subsampled image, it is understood that all TIFF image + dimensions are measured in terms of the highest-resolution + (luminance) component. In particular, ImageWidth, ImageLength, + RowsPerStrip, TileWidth, TileLength, XResolution, and YResolution + are measured in luminance samples. + + RowsPerStrip, TileWidth, and TileLength are constrained so that + there are an integral number of samples of each component in a + complete strip or tile. However, ImageWidth/ImageLength are not + constrained. If an odd-size image is to be converted to subsampled + format, the writer should pad the source data to a multiple of the + sampling factors by replication of the last column and/or row, then + downsample. The number of luminance samples actually stored in the + file will be a multiple of the sampling factors. Conversely, + readers must ignore any extra data (outside the specified image + dimensions) after upsampling. + + When PlanarConfiguration=2, each strip or tile covers the same + image area despite subsampling; that is, the total number of strips + or tiles in the image is the same for each component. Therefore + strips or tiles of the subsampled components contain fewer samples + than strips or tiles of the luminance component. + + If there are extra samples per pixel (see field ExtraSamples), + these data channels have the same number of samples as the + luminance component. + +Rewrite the YCbCrSubSampling field description (pp 91-92) as follows +(largely to eliminate possibly-misleading references to +ImageWidth/ImageLength of the subsampled components): + + (first paragraph unchanged) + + The two elements of this field are defined as follows: + + Short 0: ChromaSubsampleHoriz: + + 1 = there are equal numbers of luma and chroma samples horizontally. + + 2 = there are twice as many luma samples as chroma samples + horizontally. + + 4 = there are four times as many luma samples as chroma samples + horizontally. + + Short 1: ChromaSubsampleVert: + + 1 = there are equal numbers of luma and chroma samples vertically. + + 2 = there are twice as many luma samples as chroma samples + vertically. + + 4 = there are four times as many luma samples as chroma samples + vertically. + + ChromaSubsampleVert shall always be less than or equal to + ChromaSubsampleHoriz. Note that Cb and Cr have the same sampling + ratios. + + In a strip TIFF file, RowsPerStrip is required to be an integer + multiple of ChromaSubSampleVert (unless RowsPerStrip >= + ImageLength, in which case its exact value is unimportant). + If ImageWidth and ImageLength are not multiples of + ChromaSubsampleHoriz and ChromaSubsampleVert respectively, then the + source data shall be padded to the next integer multiple of these + values before downsampling. + + In a tiled TIFF file, TileWidth must be an integer multiple of + ChromaSubsampleHoriz and TileLength must be an integer multiple of + ChromaSubsampleVert. Padding will occur to tile boundaries. + + The default values of this field are [ 2,2 ]. Thus, YCbCr data is + downsampled by default! +</pre> diff --git a/src/3rdparty/libtiff/html/addingtags.html b/src/3rdparty/libtiff/html/addingtags.html new file mode 100644 index 0000000..452821c --- /dev/null +++ b/src/3rdparty/libtiff/html/addingtags.html @@ -0,0 +1,292 @@ +<HTML> +<HEAD> +<TITLE> +Modifying The TIFF Library +</TITLE> +</HEAD> +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> + +<H1> +Defining New TIFF Tags +</H1> + +Libtiff has built-in knowledge of all the standard TIFF tags, as +well as extentions. The following describes how to add knowledge of +new tags as builtins to libtiff, or how to application specific tags can +be used by applications without modifying libtiff. +<p> + +<h2>TIFFFieldInfo</h2> + +How libtiff manages specific tags is primarily controlled by the +definition for that tag value stored internally as a TIFFFieldInfo structure. +This structure looks like this: +<p> + +<pre> +typedef struct { + ttag_t field_tag; /* field's tag */ + short field_readcount; /* read count/TIFF_VARIABLE/TIFF_SPP */ + short field_writecount; /* write count/TIFF_VARIABLE */ + TIFFDataType field_type; /* type of associated data */ + unsigned short field_bit; /* bit in fieldsset bit vector */ + unsigned char field_oktochange;/* if true, can change while writing */ + unsigned char field_passcount;/* if true, pass dir count on set */ + char *field_name; /* ASCII name */ +} TIFFFieldInfo; +</pre> + +<ul> +<li> <b>field_tag</b>: the tag number. For instance 277 for the +SamplesPerPixel tag. Builtin tags will generally have a #define in +tiff.h for each known tag. <p> + +<li> <b>field_readcount</b>: The number of values which should be read. +The special value TIFF_VARIABLE (-1) indicates that a variable number of +values may be read. The special value TIFFTAG_SPP (-2) indicates that there +should be one value for each sample as defined by TIFFTAG_SAMPLESPERPIXEL. +The special value TIFF_VARIABLE2 (-3) is presumably similar to TIFF_VARIABLE +though I am not sure what the distinction in behaviour is. This field +is TIFF_VARIABLE for variable length ascii fields.<p> + +<li> <b>field_writecount</b>: The number of values which should be written. +Generally the same as field_readcount. A few built-in exceptions exist, but +I haven't analysed why they differ. <p> + +<li> <b>field_type</b>: Type of the field. One of TIFF_BYTE, TIFF_ASCII, +TIFF_SHORT, TIFF_LONG, TIFF_RATIONAL, TIFF_SBYTE, TIFF_UNDEFINED, +TIFF_SSHORT, TIFF_SLONG, TIFF_SRATIONAL, TIFF_FLOAT, TIFF_DOUBLE or +TIFF_IFD. Note that some fields can support more than one type (for +instance short and long). These fields should have multiple TIFFFieldInfos. +<p> + +<li> <b>field_bit</b>: Built-in tags stored in special fields in the +TIFF structure have assigned field numbers to distinguish them (ie. +FIELD_SAMPLESPERPIXEL). New tags should generally just use +FIELD_CUSTOM indicating they are stored in the generic tag list.<p> + +<li> <b>field_oktochange</b>: TRUE if it is OK to change this tag value +while an image is being written. FALSE for stuff that must be set once +and then left unchanged (like ImageWidth, or PhotometricInterpretation for +instance).<p> + +<li> <b>field_passcount</b>: If TRUE, then the count value must be passed +in TIFFSetField(), and TIFFGetField(), otherwise the count is not required. +This should generally be TRUE for non-ascii variable count tags unless +the count is implicit (such as with the colormap).<p> + +<li> <b>field_name</b>: A name for the tag. Normally mixed case (studly caps) +like "StripByteCounts" and relatively short. <p> + +</ul> + +A TIFFFieldInfo definition exists for each built-in tag in the tif_dirinfo.c +file. Some tags which support multiple data types have more than one +definition, one per data type supported. <p> + +Various functions exist for getting the internal TIFFFieldInfo definitions, +including _TIFFFindFieldInfo(), and _TIFFFindFieldInfoByName(). See +tif_dirinfo.c for details. There must be some mechanism to get the whole +list, though I don't see it off hand.<p> + +<h2>Default Tag Auto-registration</h2> + +In libtiff 3.6.0 a new mechanism was introduced allowing libtiff to +read unrecognised tags automatically. When an unknown tags is encountered, +it is automatically internally defined with a default name and a type +derived from the tag value in the file. Applications only need to predefine +application specific tags if they need to be able to set them in a file, or +if particular calling conventions are desired for TIFFSetField() and +TIFFGetField().<p> + +When tags are autodefined like this the <b>field_readcount</b> and +<b>field_writecount</b> values are always TIFF_VARIABLE. The +<b>field_passcount</b> is always TRUE, and the <b>field_bit</b> is +FIELD_CUSTOM. The field name will be "Tag %d" where the %d is the tag +number.<p> + +<h2>Defining Application Tags</h2> + +For various reasons, it is common for applications to want to define +their own tags to store information outside the core TIFF specification. +This is done by calling TIFFMergeFieldInfo() with one or more TIFFFieldInfos. +<p> + +The libgeotiff library provides geospatial information extentions within +a TIFF file. First, a set of TIFFFieldInfo's is prepared with information +on the new tags:<p> + +<pre> +static const TIFFFieldInfo xtiffFieldInfo[] = { + + /* XXX Insert Your tags here */ + { TIFFTAG_GEOPIXELSCALE, -1,-1, TIFF_DOUBLE, FIELD_CUSTOM, + TRUE, TRUE, "GeoPixelScale" }, + { TIFFTAG_GEOTRANSMATRIX, -1,-1, TIFF_DOUBLE, FIELD_CUSTOM, + TRUE, TRUE, "GeoTransformationMatrix" }, + { TIFFTAG_GEOTIEPOINTS, -1,-1, TIFF_DOUBLE, FIELD_CUSTOM, + TRUE, TRUE, "GeoTiePoints" }, + { TIFFTAG_GEOKEYDIRECTORY, -1,-1, TIFF_SHORT, FIELD_CUSTOM, + TRUE, TRUE, "GeoKeyDirectory" }, + { TIFFTAG_GEODOUBLEPARAMS, -1,-1, TIFF_DOUBLE, FIELD_CUSTOM, + TRUE, TRUE, "GeoDoubleParams" }, + { TIFFTAG_GEOASCIIPARAMS, -1,-1, TIFF_ASCII, FIELD_CUSTOM, + TRUE, FALSE, "GeoASCIIParams" } +}; +</pre> + +In order to define the tags, we call TIFFMergeFieldInfo() on the +desired TIFF handle with the list of TIFFFieldInfos.<p> + +<pre> +#define N(a) (sizeof (a) / sizeof (a[0])) + + /* Install the extended Tag field info */ + TIFFMergeFieldInfo(tif, xtiffFieldInfo, N(xtiffFieldInfo)); +</pre> + +The tags need to be defined for each TIFF file opened - and when reading +they should be defined before the tags of the file are read, yet a valid +TIFF * is needed to merge the tags against. In order to get them +registered at the appropriate part of the setup process, it is necessary +to register our merge function as an extender callback with libtiff. +This is done with TIFFSetTagExtender(). We also keep track of the +previous tag extender (if any) so that we can call it from our extender +allowing a chain of customizations to take effect. <P> + +<pre> +static TIFFExtendProc _ParentExtender = NULL; + +static +void _XTIFFInitialize(void) +{ + static int first_time=1; + + if (! first_time) return; /* Been there. Done that. */ + first_time = 0; + + /* Grab the inherited method and install */ + _ParentExtender = TIFFSetTagExtender(_XTIFFDefaultDirectory); +} +</pre> + +The extender callback is looks like this. It merges in our new fields +and then calls the next extender if there is one in effect.<p> + +<pre> +static void +_XTIFFDefaultDirectory(TIFF *tif) +{ + /* Install the extended Tag field info */ + TIFFMergeFieldInfo(tif, xtiffFieldInfo, N(xtiffFieldInfo)); + + /* Since an XTIFF client module may have overridden + * the default directory method, we call it now to + * allow it to set up the rest of its own methods. + */ + + if (_ParentExtender) + (*_ParentExtender)(tif); +} +</pre> + +The above approach ensures that our new definitions are used when reading +or writing any TIFF file. However, since on reading we already have +default definitions for tags, it is usually not critical to pre-define them. +If tag definitions are only required for writing custom tags, you can just +call TIFFMergeFieldInfo() before setting new tags. The whole extender +architecture can then be avoided.<p> + +<A NAME=AddingTags><P><H2>Adding New Builtin Tags</H2></A> + +A similar approach is taken to the above. However, the TIFFFieldInfo +should be added to the tiffFieldInfo[] list in tif_dirinfo.c. Ensure that +new tags are added in sorted order by the tag number.<p> + +Normally new built-in tags should be defined with FIELD_CUSTOM; however, if +it is desirable for the tag value to have it's own field in the TIFFDirectory +structure, then you will need to #define a new FIELD_ value for it, and +add appropriate handling as follows: + + +<OL> +<LI>Define the tag in <B>tiff.h</B>. +<LI>Add a field to the directory structure in <B>tif_dir.h</B> + and define a <TT>FIELD_*</TT> bit (also update the definition of + <TT>FIELD_CODEC</TT> to reflect your addition). +<LI>Add an entry in the <TT>TIFFFieldInfo</TT> array defined at the top of + <B>tif_dirinfo.c</B>. + Note that you must keep this array sorted by tag + number and that the widest variant entry for a tag should come + first (e.g. <TT>LONG</TT> before <TT>SHORT</TT>). +<LI>Add entries in <TT>_TIFFVSetField()</TT> and <TT>_TIFFVGetField()</TT> + for the new tag. +<LI>(<I>optional</I>) If the value associated with the tag is not a scalar value + (e.g. the array for <TT>TransferFunction</TT>) and requires + special processing, + then add the appropriate code to <TT>TIFFReadDirectory()</TT> and + <TT>TIFFWriteDirectory()</TT>. You're best off finding a similar tag and + cribbing code. +<LI>Add support to <TT>TIFFPrintDirectory()</TT> in <B>tif_print.c</B> + to print the tag's value. +</OL> + +<P> +If you want to maintain portability, beware of making assumptions +about data types. Use the typedefs (<TT>uint16</TT>, etc. when dealing with +data on disk and <TT>t*_t</TT> when stuff is in memory) and be careful about +passing items through printf or similar vararg interfaces. + +<A NAME=AddingCODECTags><P><H2>Adding New Codec-private Tags</H2></A> + +To add tags that are meaningful <EM>only when a particular compression +algorithm is used</EM> follow these steps: + +<OL> +<LI>Define the tag in <B>tiff.h</B>. +<LI>Allocate storage for the tag values in the private state block of + the codec. +<LI>Insure the state block is created when the codec is initialized. +<LI>At <TT>TIFFInitfoo</TT> time override the method pointers in the + TIFF structure + for getting, setting and printing tag values. For example, +<PRE> + sp->vgetparent = tif->tif_vgetfield; + tif->tif_vgetfield = fooVGetField; /* hook for codec tags */ + sp->vsetparent = tif->tif_vsetfield; + tif->tif_vsetfield = fooVSetField; /* hook for codec tags */ + tif->tif_printdir = fooPrintDir; /* hook for codec tags */ +</PRE> + (Actually you may decide not to override the + <TT>tif_printdir</TT> method, but rather just specify it). +<LI>Create a private <TT>TIFFFieldInfo</TT> array for your tags and + merge them into the core tags at initialization time using + <TT>_TIFFMergeFieldInfo</TT>; e.g. +<PRE> + _TIFFMergeFieldInfo(tif, fooFieldInfo, N(fooFieldInfo)); +</PRE> + (where <TT>N</TT> is a macro used liberaly throughout the distributed code). +<LI>Fill in the get and set routines. Be sure to call the parent method + for tags that you are not handled directly. Also be sure to set the + <TT>FIELD_*</TT> bits for tags that are to be written to the file. Note that + you can create ``pseudo-tags'' by defining tags that are processed + exclusively in the get/set routines and never written to file (see + the handling of <TT>TIFFTAG_FAXMODE</TT> in <B>tif_fax3.c</B> + for an example of this). +<LI>Fill in the print routine, if appropriate. +</OL> + +Note that space has been allocated in the <TT>FIELD_*</TT> bit space for +codec-private tags. Define your bits as <TT>FIELD_CODEC+<offset></TT> to +keep them away from the core tags. If you need more tags than there +is room for, just increase <TT>FIELD_SETLONGS</TT> at the top of +<B>tiffiop.h</B>. + +<HR> + +Last updated: $Date: 2004/09/10 14:43:18 $ + +</BODY> + +</HTML> diff --git a/src/3rdparty/libtiff/html/bugs.html b/src/3rdparty/libtiff/html/bugs.html new file mode 100644 index 0000000..9eeb8a5 --- /dev/null +++ b/src/3rdparty/libtiff/html/bugs.html @@ -0,0 +1,53 @@ +<HTML> +<HEAD> +<TITLE>Bugs and the TIFF Mailing List</TITLE> +</HEAD> +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> +<H1> +<IMG SRC=images/cover.jpg WIDTH=110 HEIGHT=110 ALIGN=left BORDER=1 HSPACE=6> +Bugs, Bugzilla, and the TIFF Mailing List +</H1> + +<P> +This software is free. Please let us know when you find a problem or +fix a bug. + +<P> +Thanks to <A HREF=http://www.remotesensing.org/>remotesensing.org</a>, libtiff now uses bugzilla to track bugs. +<P> +If you think you've discovered a bug, please first check to see if it is +already known by looking at the list of already reported bugs. You can do so +by visiting the buglist at +<A HREF=http://bugzilla.remotesensing.org/buglist.cgi?product=libtiff>http://bugzilla.remotesensing.org/buglist.cgi?product=libtiff</A>. Also verify that +the problem is still reproducable with the current development software +from CVS. +<p> +If you'd like to enter a new bug, you can do so at <A HREF=http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff>http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff</A>. +<P> + +Of course, reporting bugs is no substitute for discussion. The +<a href="mailto:tiff@lists.maptools.org">tiff@lists.maptools.org</a> mailing +list is for users of this software, and discussion TIFF issues in general. +It is managed with the Mailman software, and the web interface for subscribing +and managing your access to the list is at:<p> + + <a href="http://lists.maptools.org/mailman/listinfo/tiff">http://lists.maptools.org/mailman/listinfo/tiff</a><P> + +Posts to the list are only accepted from members of the list in order +to limit the amount of spam propagated. Also, to be approved as a member +you will need to email the list administrator with a brief description of +why you are interested in TIFF so we can weed out spammers.<p> + +A <A HREF="http://www.awaresystems.be/imaging/tiff/tml.html">Long Term +Archive</a> including recent messages, and most messages back to 1993, +with search capabilities is available, and +has been prepared and hosted by <a href="http://www.awaresystems.be">AWare +Systems</a>. <p> + + +<HR> + +Last updated: $Date: 2005/07/26 14:43:24 $ +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/build.html b/src/3rdparty/libtiff/html/build.html new file mode 100644 index 0000000..e0b2157 --- /dev/null +++ b/src/3rdparty/libtiff/html/build.html @@ -0,0 +1,880 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta name="generator" content= +"HTML Tidy for Solaris (vers 12 April 2005), see www.w3.org"> +<title>Building the TIFF Software Distribution</title> +</head> +<body bgcolor="white"> +<h1><font face="Arial, Helvetica, Sans"><img src= +"images/cramps.gif" width="159" height="203" align="left" border= +"1" hspace="6"> Building the Software Distribution</font></h1> +<ul> +<li><a href="#UNIX">Building on a UNIX system</a>.</li> +<li><a href="#MacMPW">Building on a Macintosh system with +MPW</a>.</li> +<li><a href="#MacCW">Building on a Macintosh system with +CodeWarrior</a>.</li> +<li><a href="#PC">Building on an MS-DOS or Windows system</a>.</li> +<li><a href="#DJGPP">Building on MS-DOS with the DJGPP v2 +compiler</a>.</li> +<li><a href="#VMS">Building on a VMS system</a>.</li> +<li><a href="#Acorn">Building on an Acorn RISC OS system</a>.</li> +<li><a href="#Other">Building the Software on Other +Systems</a></li> +</ul> +<br clear="left"> +This chapter contains step-by-step instructions on how to configure +and build the TIFF software distribution. The software is most +easily built on a UNIX system, but with a little bit of work it can +easily be built and used on other non-UNIX platforms. <a name= +"UNIX" id="UNIX"></a> +<hr> +<h2>Building on a UNIX System</h2> +To build the software on a UNIX system you need to first run the +configure shell script that is located in the top level of the +source directory. This script probes the target system for +necessary tools and functions and constructs a build environment in +which the software may be compiled. Once configuration is done, you +simply run <tt>make</tt> (or <tt>gmake</tt>) to build the software +and then <tt>make install</tt> to do the installation; for example: +<div style="margin-left: 2em"> +<pre> +hyla% <b>cd tiff-v3.4beta099</b> +hyla% <b>./configure</b> + <i>...lots of messages...</i> +hyla% <b>make</b> + <i>...lots of messages...</i> +hyla# <b>make install</b> +</pre></div> +Supplied makefiles are depend on GNU <tt>make</tt> utility, so you +will need the one. Depending on your installation <b>make</b> +command may invoke standard system <tt>make</tt> and <b>gmake</b> +invoke GNU make. In this case you should use former. If you don't +have <tt>make</tt> at all, but only <tt>gmake</tt>, you should +export environment variable <tt>MAKE=gmake</tt> before +<b>./configure</b>. +<p>In general, the software is designed such that the following +should be ``<i>make-able</i>'' in each directory:</p> +<div style="margin-left: 2em"> +<pre> +make [all] build stuff +make install build&install stuff +make clean remove .o files, executables and cruft +make distclean remove everything, that can be recreated +</pre></div> +Note that after running "<tt>make distclean</tt>" the +<tt>configure</tt> script must be run again to create the Makefiles +and other make-related files. <a name="BuildTrees" id= +"BuildTrees"></a> +<hr width="65%" align="right"> +<h3>Build Trees</h3> +There are two schemes for configuring and building the software. If +you intend to build the software for only one target system, you +can configure the software so that it is built in the same +directories as the source code. +<div style="margin-left: 2em"> +<pre> +hyla% <b>cd tiff-v3.4beta099</b> +hyla% <b>ls</b> +COPYRIGHT VERSION config.sub dist man +Makefile.in config.guess configure html port +README config.site contrib libtiff tools +hyla% <b>./configure</b> +</pre></div> +<p>Otherwise, you can configure a build tree that is parallel to +the source tree hierarchy but which contains only configured files +and files created during the build procedure.</p> +<div style="margin-left: 2em"> +<pre> +hyla% <b>cd tiff-v3.4beta099</b> +hyla% <b>mkdir obj obj/mycpu</b> +hyla% <b>cd obj/mycpu</b> +hyla% <b>../../configure</b> +</pre></div> +This second scheme is useful for: +<ul> +<li>building multiple targets from a single source tree</li> +<li>building from a read-only source tree (e.g. if you receive the +distribution on CD-ROM)</li> +</ul> +<a name="ConfigOptions" id="ConfigOptions"></a> +<hr width="65%" align="right"> +<h3>Configuration Options</h3> +The configuration process is critical to the proper compilation, +installation, and operation of the software. The configure script +runs a series of tests to decide whether or not the target system +supports required functionality and, if it does not, whether it can +emulate or workaround the missing functions. This procedure is +fairly complicated and, due to the nonstandard nature of most UNIX +systems, prone to error. The first time that you configure the +software for use you should check the output from the configure +script and look for anything that does not make sense for your +system. +<p>A second function of the configure script is to set the default +configuration parameters for the software. Of particular note are +the directories where the software is to be installed. By default +the software is installed in the <b>/usr/local</b> hierarchy. To +change this behaviour the appropriate parameters can be specified +on the command line to configure. Run <b>./configure --help</b> to +get a list of possible options. Installation related options are +shown below.</p> +<pre> +<tt> +Installation directories: + --prefix=PREFIX install architecture-independent files in PREFIX + [/usr/local] + --exec-prefix=EPREFIX install architecture-dependent files in EPREFIX + [PREFIX] + +By default, `make install' will install all the files in +`/usr/local/bin', `/usr/local/lib' etc. You can specify +an installation prefix other than `/usr/local' using `--prefix', +for instance `--prefix=$HOME'. + +For better control, use the options below. + +Fine tuning of the installation directories: + --bindir=DIR user executables [EPREFIX/bin] + --sbindir=DIR system admin executables [EPREFIX/sbin] + --libexecdir=DIR program executables [EPREFIX/libexec] + --datadir=DIR read-only architecture-independent data [PREFIX/share] + --sysconfdir=DIR read-only single-machine data [PREFIX/etc] + --sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com] + --localstatedir=DIR modifiable single-machine data [PREFIX/var] + --libdir=DIR object code libraries [EPREFIX/lib] + --includedir=DIR C header files [PREFIX/include] + --oldincludedir=DIR C header files for non-gcc [/usr/include] + --infodir=DIR info documentation [PREFIX/info] + --mandir=DIR man documentation [PREFIX/man] + +Program names: + --program-prefix=PREFIX prepend PREFIX to installed program names + --program-suffix=SUFFIX append SUFFIX to installed program names + --program-transform-name=PROGRAM run sed PROGRAM on installed program names +</tt> +</pre> +<a name="Packages" id="Packages"></a> +<hr width="65%" align="right"> +<h3>Configuring Optional Packages/Support</h3> +The TIFF software comes with several packages that are installed +only as needed, or only if specifically configured at the time the +configure script is run. Packages can be configured via the +<b>configure</b> script commandline parameters. +<dl> +<dt><i>Static/Shared Objects Support</i></dt> +<dd><tt>--enable-shared[=PKGS] build shared +libraries [default=yes]<br> +--enable-static[=PKGS] build static +libraries [default=yes]</tt> +<p>These options control whether or not to configure the software +to build a shared and static binaries for the TIFF library. Use of +shared libraries can significantly reduce the disk space needed for +users of the TIFF software. If shared libarries are not used then +the code is statically linked into each application that uses it. +By default both types of binaries is configured.</p> +<p><tt>--enable-rpath Enable runtime linker +paths (-R libtool option)</tt></p> +<p>Add library directories (see other options below) to the TIFF +library run-time linker path.</p> +</dd> +<dt><i>JPEG Support</i></dt> +<dd><tt>--disable-jpeg disable IJG JPEG +library usage (required for JPEG compression, enabled by default) +--with-jpeg-include-dir=DIR location of IJG +JPEG library headers +--with-jpeg-lib-dir=DIR location of IJG JPEG +library binary)</tt></dd> +<dd>The <tt>JPEG</tt> package enables support for the handling of +TIFF images with JPEG-encoded data. Support for JPEG-encoded data +requires the Independent JPEG Group (IJG) <tt>libjpeg</tt> +distribution; this software is available at <a href= +"ftp://ftp.uu.net/graphics/jpeg/">ftp.uu.net:/graphics/jpeg/</a>. +<b>configure</b> script automatically tries to search the working +IJG JPEG installation. If it fails to find library, JPEG support +will be automatically disabled.If you want specify the exact paths +to library binary and headers, use above switches for that.</dd> +<dt><i>ZIP Support</i></dt> +<dd>The <tt>ZIP</tt> support enables support for the handling of +TIFF images with deflate-encoded data. Support for deflate-encoded +data requires the freely available <tt>zlib</tt> distribution +written by Jean-loup Gailly and Mark Adler; this software is +available at <a href= +"ftp://ftp.uu.net/pub/archiving/zip/zlib/">ftp.uu.net:/pub/archiving/zip/zlib/</a> +(or try <a href= +"ftp://quest.jpl.nasa.gov/beta/zlib/">quest.jpl.nasa.gov:/beta/zlib/</a>). +If ZIP support is enabled the <tt>DIRS_LIBINC</tt> and +<tt>DIR_GZLIB</tt> parameters should also be set (see below). By +default this package is not configured.</dd> +</dl> +<a name="Sample" id="Sample"></a> +<hr width="65%" align="right"> +<h3>A Sample Configuration Session</h3> +This section shows a sample configuration session and describes the +work done. The session is shown indented in a <tt>fixed width +font</tt> with user-supplied input in a <tt><b>bold font</b></tt>. +Comments are shown in a normal or <i>italic</i> font. This session +was collected on a 486 machine running BSDI 1.1. +<div style="margin-left: 2em"> +<pre> +<tt> +wullbrandt% <b>mkdir tiff</b> +wullbrandt% <b>cd tiff</b> +wullbrandt% <b>ln -s /hosts/oxford/usr/people/sam/tiff src</b> +</tt> +</pre></div> +A build tree separate from the source tree is used here. In fact, +in this case the distribution is accessed from a read-only +NFS-mounted filesystem. +<div style="margin-left: 2em"> +<pre> +<tt> +wullbrandt% <b>src/configure</b> +Configuring TIFF Software v3.4beta015. + +Reading site-wide parameters from ../tiff-v3.4beta015/config.site. +Reading local parameters from config.local. +Gosh, aren't you lucky to have a i386-unknown-bsdi1.1 system! +</tt> +</pre></div> +Note that configure announces the distribution version and the +deduced target configuration (<tt>i386-unknown-bsdi1.1</tt> here). +<div style="margin-left: 2em"> +<pre> +<tt> +Using /usr/local/bin/gcc for a C compiler (set CC to override). +Looks like /usr/local/bin/gcc supports the -g option. +Using " -g" for C compiler options. +</tt> +</pre></div> +configure checked the normal shell search path for potential ANSI C +compilers. The compiler is selected according to it properly +compiling a small ANSI C test program. A specific compiler may be +requested by setting the <tt>CC</tt> environment variable to the +appropriate pathname, by supplying the parameter on the command +line, e.g. <tt>-with-CC=gcc</tt>, or by setting <tt>CC</tt> in a +configuration file. +<p><img src="images/info.gif" align="left" hspace="10"> <em>Note +that an ANSI C compiler is required to build the software. If a C +compiler requires options to enable ANSI C compilation, they can be +specified with the <tt>ENVOPTS</tt> parameter.</em></p> +<p>Once a compiler is selected configure checks to see if the +compiler accepts a -g option to enable the generation of debugging +symbols, and if the compiler includes an ANSI C preprocessor.</p> +<div style="margin-left: 2em"> +<pre> +<tt> +Using /usr/ucb/make to configure the software. +</tt> +</pre></div> +Next various system-specific libraries that may or may not be +needed are checked for (none are needed in this case). If your +system requires a library that is not automatically included it can +be specified by setting the <tt>MACHDEPLIBS</tt> parameter. +<p><i>Creating port.h.</i> The <b>port.h</b> file is included by +all the C code in the library (but not the tools). It includes +definitions for functions and type definitions that are missing +from system include files, <tt>#defines</tt> to enable or disable +system-specific functionality, and other odds and ends.</p> +<div style="margin-left: 2em"> +<pre> +<tt> +Creating libtiff/port.h with necessary definitions. +... using LSB2MSB bit order for your i386 cpu +... using big-endian byte order for your i386 cpu +... configure use of mmap for memory-mapped files +... O_RDONLY is in <fcntl.h> +... using double for promoted floating point parameters +... enabling use of inline functions +Done creating libtiff/port.h. +</tt> +</pre></div> +This file can take a long time to create so configure generates the +file only when it is needed, either because the file does not exist +or because a different target or compiler is to be used. Note that +running "<tt>make distclean</tt>" in the top-level directory of the +build tree will remove the <b>port.h</b> file (along with all the +other files generated by configure). +<p><i>Selecting emulated library functions.</i> Certain library +functions used by the tools are not present on all systems and can +be emulated using other system functionality. configure checks for +the presence of such functions and if they are missing, will +configure emulation code from the <b>port</b> directory to use +instead. Building the TIFF software on unsupported systems may +require adding to the code to the <b>port</b> directory.</p> +<div style="margin-left: 2em"> +<pre> +<tt> +Checking system libraries for functionality to emulate. +Done checking system libraries. +</tt> +</pre></div> +If a routine must be emulated and configure does not automatically +check for it, the routine name can be specified using the +<tt>PORTFUNCS</tt> parameter. To add emulation support for a new +function <tt>foo</tt>, create a file <b>port/foo.c</b> that +contains the emulation code and then set <tt>PORTFUNCS=foo</tt> in +a configuration file or modify the configure script to +automatically check for the missing function. +<div style="margin-left: 2em"> +<pre> +<tt> +Checking for Dynamic Shared Object (DSO) support. +Done checking for DSO support. +</tt> +</pre></div> +If the <tt>DSO</tt> package is enabled (<tt>DSO=auto</tt> or +<tt>DSO=yes</tt>), then configure will verify the system and +compiler are capable of constructing SVR4-style DSO's in the +expected way. Note that while a system may support DSO's the +compiler may not be capable of generating the required +position-independent code and/or the compiler may not pass the +needed options through to the loader. +<p><i>Selecting utility programs.</i> configure locates various +system utility programs that are used during installation of the +software.</p> +<div style="margin-left: 2em"> +<pre> +<tt> +Selecting programs used during installation. +Looks like mv supports the -f option to force a move. +Looks like /bin/ln supports the -s option to create a symbolic link. +Done selecting programs. +</tt> +</pre></div> +<p><i>Selecting default configuration parameters.</i> The remainder +of the work done by configure involves setting up configuration +parameters that control the placement and setup of files during the +installation procedure.</p> +<div style="margin-left: 2em"> +<pre> +<tt> +Selecting default TIFF configuration parameters. + +Looks like manual pages go in /usr/contrib/man. +Looks like manual pages should be installed with bsd-nroff-gzip-0.gz. + +TIFF configuration parameters are: + +[ 1] Directory for tools: /usr/contrib/bin +[ 2] Directory for libraries: /usr/contrib/lib +[ 3] Directory for include files: /usr/contrib/include +[ 4] Directory for manual pages: /usr/contrib/man +[ 5] Manual page installation scheme: bsd-nroff-gzip-0.gz + +Are these ok [yes]? +</tt> +</pre></div> +At this point you can interactively modify any of the displayed +parameters. Hitting a carriage return or typing <tt>yes</tt> will +accept the current parameters. Typing one of the number displayed +along the left hand side causes configure to prompt for a new value +of the specified parameter. Typing anything else causes configure +to prompt for a new value <em>for each parameter</em>. In general +hitting carriage return will accept the current value and typing +anything that is unacceptable will cause a help message to be +displayed. A description of each of the configuration parameters is +given below. +<p>Once acceptable parameters are setup configure will generate all +the files that depend on these parameters. Note that certain files +may or may not be created based on the configuration of optional +packages and/or the functions supported by target system.</p> +<div style="margin-left: 2em"> +<pre> +<tt> +Creating Makefile from ../tiff-v3.4beta015/Makefile.in +Creating libtiff/Makefile from ../tiff-v3.4beta015/libtiff/Makefile.in +Creating man/Makefile from ../tiff-v3.4beta015/man/Makefile.in +Creating tools/Makefile from ../tiff-v3.4beta015/tools/Makefile.in +Creating port/install.sh from ../tiff-v3.4beta015/port/install.sh.in +Done. +</tt> +</pre></div> +<a name="DSOSupport" id="DSOSupport"></a> +<hr> +<h3>Shared Library Support</h3> +It is desirable to make the TIFF library be a shared object on +systems that have support for shared libraries. Unfortunately the +rules to use to build a shared library vary between operating +systems and even compilers. The distributed software includes +support for building a shared version of the library on a number of +different systems. This support is split between rules in the file +<b>libtiff/Makefile.in</b> that construct the shared library and +checks done by the <tt>configure</tt> script to verify that the +expected rules are supported by compilation tools for the target +system. +<p>To add new support for building a shared library both these +files must be updated. In the configure script search for the +section where the autoconfiguration setting of the <tt>DSO</tt> +parameter is handled and add a new case for the target system that +sets the <tt>DSOSUF</tt>, <tt>DSOLD</tt>, <tt>DSOOPTS</tt>, and +<tt>LIBCOPTS</tt> options as appropriate for the system. +<tt>DSOSUF</tt> specifies the filename suffix used for the shared +library (e.g. ``.so'' for Dynamic Shared Objects on most SVR4-based +systems). <tt>DSOLD</tt> specifies the program to use to build the +shared library from a compiled object file; typically ``${LD}'' +though on some systems it is better to use the C compiler directly +so system-dependent options and libraries are automatically +supplied. <tt>DSOOPTS</tt> are options that must be specified to +<tt>DSOLD</tt> when building the shared library. <tt>LIBCOPTS</tt> +are options to pass to the C compiler when constructing a +relocatable object file to include in a shared library; e.g. ``-K +PIC'' on a Sun system. The <tt>DSO</tt> parameter must also be set +to a unique label that identifies the target system and compilation +tools. This label is used to select a target in +<b>libtiff/Makefile.in</b> to do the actual work in building the +shared library. Finally, to complete support for the shared library +added the appropriate rules to <b>libtiff/Makefile.in</b> under the +target specified in the <tt>configure</tt> script. <a name="PC" id= +"PC"></a></p> +<hr> +<h2>Building the Software under Windows 95/98/NT/2000 with MS +VC++</h2> +With Microsoft Visual C++ installed, and properly configured for +commandline use (you will likely need to source VCVARS32.BAT in +AUTOEXEC.bAT or somewhere similar) you should be able to use the +provided <tt>makefile.vc</tt>. +<p>The source package is delivered using Unix line termination +conventions, which work with MSVC but do not work with Windows +'notepad'. If you use unzip from the <a href= +"http://www.info-zip.org/pub/infozip/">Info-Zip</a> package, you +can extract the files using Windows normal line termination +conventions with a command similar to:</p> +<pre> + unzip -aa -a tiff-3.7.4.zip +</pre> +<p>By default libtiff expects that a pre-built zlib and jpeg +library are provided by the user. If this is not the case, then you +may edit libtiff\tiffconf.h using a text editor (e.g. notepad) and +comment out the entries for JPEG_SUPPORT, PIXARLOG_SUPPORT, and +ZIP_SUPPORT. Ignore the comment at the top of the file which says +that it has no influence on the build, because the statement is not +true for Windows. However, by taking this approach, libtiff will +not be able to open some TIFF files.</p> +<p>To build using the provided makefile.vc you may use:</p> +<pre> + C:\tiff-3.7.4> nmake /f makefile.vc clean + C:\tiff-3.7.4> nmake /f makefile.vc + + or (the hard way) + + C:\tiff-3.7.4> cd port + C:\tiff-3.7.4\port> nmake /f makefile.vc clean + C:\tiff-3.7.4\port> nmake /f makefile.vc + C:\tiff-3.7.4> cd ../libtiff + C:\tiff-3.7.4\libtiff> nmake /f makefile.vc clean + C:\tiff-3.7.4\libtiff> nmake /f makefile.vc + C:\tiff-3.7.4\libtiff> cd ..\tools + C:\tiff-3.7.4\tools> nmake /f makefile.vc clean + C:\tiff-3.7.4\tools> nmake /f makefile.vc +</pre> +<p>This will build the library file +<tt>libtiff\libtiff\libtiff.lib</tt>. This can be used in Win32 +programs. You may want to adjust the build options before start +compiling. All parameters contained in the <tt>nmake.opt</tt> +file.This is a plain text file you can open with your favorite text +editor.</p> +<p>The makefile also builds a DLL (libtiff.dll) with an associated +import library (libtiff_i.lib). Any builds using libtiff will need +to include the LIBTIFF\LIBTIFF directory in the include path.</p> +<p>The <tt>libtiff\tools\makefile.vc</tt> should build .exe's for +all the standard TIFF tool programs.</p> +<p><a name="DJGPP" id="DJGPP"></a></p> +<hr> +<h2>Building the Software under MS/DOS with the DJGPP v2 +compiler</h2> +[<i>From the file <b>contrib/dosdjgpp/README</b>.</i>] +<p>The directory <b>contrib/dosdjgpp</b> contains the files +necessary to build the library and tools with the DJGPP v2 compiler +under MSDOS.</p> +<p>All you have to do is copy the files in the directory into the +respective directories and run make. If you want, you can use the +<b>conf.bat</b> script to do that for you, make sure that the file +is stored with MSDOS text EOL-convention (CR/LF), otherwise the +<b>command.com</b> will not do anything.</p> +<p>Note that you probably will not be able to build the library +with the v1.x versions of djgpp, due to two problems. First, the +top makefile calls a sub-make for each directory and you are likely +to run out of memory, since each recursive invocation of a djgpp +v1.x program requires about 130k, to avoid that, you can enter the +directories manually and call make (well, there are only two dirs). +The 2nd problem is that djgpp 1.x doesn't call the coff2exe +(stubify) program when creating an executable. This means that all +programs compiled are not converted to exe and consequently are not +available for calling directly. For the tools directory, you can +just call coff2exe for each program after make finishes, but in the +libtiff directory, a few programs are created during the make +process that have to be called for make to continue (e.g. +mkg3states). Make will probably report an error at each such stage. +To fix that, either add a coff2exe call before each program is +called or call coff2exe manually and rerun make (there 2-3 such +programs). <a name="MacMPW" id="MacMPW"></a></p> +<hr> +<h2>Building the Software on a Macintosh with MPW</h2> +The directory <b>contrib/mac-mpw</b> contains support for compiling +the library and tools under the MPW Shell on a Macintosh system. +This support was contributed by Niles Ritter (<a href= +"mailto:ndr@tazboy.jpl.nasa.gov">ndr@tazboy.jpl.nasa.gov</a>). +<p>[<i>From the file <b>contrib/mac-mpw/README</b>.</i>]</p> +<p>This directory contains all of the utilities and makefile source +to build the LIBTIFF library and tools from the MPW Shell. The file +BUILD.mpw in this directory is an executable script which uses all +of these files to create the MPW makefiles and run them.</p> +<p>The <file>.make files are not MPW makefiles as such, but +are when run through the "mactrans" program, which turns the ascii +"%nn" metacharacters into the standard weird MPW make +characters.</p> +<p>This translation trick is necessary to protect the files when +they are put into unix tarfiles, which tend to mangle the special +characters. <a name="MacCW" id="MacCW"></a></p> +<hr> +<h2>Building the Software on a Macintosh with CodeWarrior</h2> +The directory <b>contrib/mac-cw</b> contains support for compiling +the library and tools with MetroWerks CodeWarrior 6.1 on a +Macintosh system. This support was contributed by Niles Ritter +(<a href= +"mailto:ndr@tazboy.jpl.nasa.gov">ndr@tazboy.jpl.nasa.gov</a>). +<p>[<i>From the file <b>contrib/mac-cw/README</b>.</i>] In this +directory you will find a Makefile.script Applescript file, which +should be run in order to build the libtiff code using MetroWerks +CodeWarrior. Refer to the "metrowerks.note" instructions on +building the library for 68k and PowerPC native code, as well as +building some of the libtiff tools, which are rather unix-like, but +at least give an example of how to link everything together. +<a name="VMS" id="VMS"></a></p> +<hr> +<h2>Building the Software on a VMS System</h2> +The VMS port was done by Karsten Spang (<a href= +"mailto:krs@kampsax.dk">krs@kampsax.dk</a>), who also "sort of" +maintains it. The VMS specific files are not in the main +directories. Instead they are placed under +<tt>[.CONTRIB.VMS...]</tt> in the distribution tree. Installation: +It is assumed that you have unpacked the tar file into a VMS +directory tree, in this text called DISK:[TIFF]. +<ol> +<li>Move the VMS specific files to their proper directories. +<pre> +$ SET DEFAULT DISK:[TIFF.CONTRIB.VMS] +$ RENAME [.LIBTIFF]*.* [-.-.LIBTIFF] +$ RENAME [.TOOLS]*.* [-.-.TOOLS] +</pre></li> +<li>Compile the library. +<pre> +$ SET DEFAULT DISK:[TIFF.LIBTIFF] +$ @MAKEVMS +</pre></li> +<li>Compile the tools. +<pre> +$ SET DEFAULT DISK:[TIFF.TOOLS] +$ @MAKEVMS +</pre></li> +<li>Define the programs. +<pre> +$ DEFINE TIFFSHR DISK:[TIFF.LIBTIFF]TIFFSHR +$ FAX2PS :==$DISK:[TIFF.TOOLS]FAX2PS +$ FAX2TIFF :==$DISK:[TIFF.TOOLS]FAX2TIFF +$ GIF2TIFF :==$DISK:[TIFF.TOOLS]GIF2TIFF +$ PAL2RGB :==$DISK:[TIFF.TOOLS]PAL2RGB +$ PPM2TIFF :==$DISK:[TIFF.TOOLS]PPM2TIFF +$ RAS2TIFF :==$DISK:[TIFF.TOOLS]RAS2TIFF +$ RGB2YCBCR :==$DISK:[TIFF.TOOLS]RGB2YCBCR +$ THUMBNAIL :==$DISK:[TIFF.TOOLS]THUMBNAIL +$ TIFF2BW :==$DISK:[TIFF.TOOLS]TIFF2BW +$ TIFF2PS :==$DISK:[TIFF.TOOLS]TIFF2PS +$ TIFFCMP :==$DISK:[TIFF.TOOLS]TIFFCMP +$ TIFFCP :==$DISK:[TIFF.TOOLS]TIFFCP +$ TIFFDITHER:==$DISK:[TIFF.TOOLS]TIFFDITHER +$ TIFFDUMP :==$DISK:[TIFF.TOOLS]TIFFDUMP +$ TIFFINFO :==$DISK:[TIFF.TOOLS]TIFFINFO +$ TIFFMEDIAN:==$DISK:[TIFF.TOOLS]TIFFMEDIAN +$ TIFFSPLIT :==$DISK:[TIFF.TOOLS]TIFFSPLIT +$ YCBCR :==$DISK:[TIFF.TOOLS]YCBCR +</pre></li> +</ol> +You will want to add these lines to your <tt>LOGIN.COM</tt> file, +after changing the name of the directory that you have used on your +machine. +<p>This release has been tested on OpenVMS/VAX 5.5-2, using VAX C +3.2. A previous release was tested under OpenVMS/AXP ?.? using DEC +C ?.?, it is believed that this release as well works on AXP. The +code contains some GNU C specific things. This does *not* imply, +however, that the VAX/GCC configuration has been tested, *it has +not*.</p> +<p>The command procedures (<tt>MAKEVMS.COM</tt>) for building the +library and tools, is believed to choose the correct options for +the VAX and AXP cases automatically.</p> +<p>On the AXP, IEEE floating point is used by default. If you want +VAX floating point, remove the <tt>/FLOAT=IEEE_FLOAT</tt> +qualifier, and change <tt>HAVE_IEEEFP=1</tt> to +<tt>HAVE_IEEEFP=0</tt> in the <tt>MAKEVMS.COM</tt> files in both +the <b>libtiff</b> and <b>tools</b> directories.</p> +<h3>Compiling your own program on a VMS system:</h3> +When compiling a source file in which you <tt>"#include +<tiffio.h>"</tt>, use the following command +<pre> + $ CC/INCLUDE=DISK:[TIFF.LIBTIFF] +</pre> +This ensures that the header file is found. On the AXP, also add +<tt>/FLOAT=IEEE_FLOAT</tt> (if used when building the library). +<h3>Linking your own program to the TIFF library on a VMS +system:</h3> +You can link to the library in two ways: Either using the shareable +library, or using the object library. On the VAX these +possibilities are: +<ol> +<li>Using the shareable TIFF library. +<pre> +$ LINK MY_PROGRAM,DISK:[TIFF.LIBTIFF]TIFF/OPTIONS,SYS$INPUT:/OPTIONS + SYS$SHARE:VAXCRTL/SHAREABLE +</pre></li> +<li>Using the TIFF object library. +<pre> +$ LINK MY_PROGRAM, - + DISK:[TIFF.LIBTIFF]TIFF/LIBRARY/INCLUDE=(TIF_FAX3SM,TIF_CODEC), - + SYS$INPUT:/OPTIONS + SYS$SHARE:VAXCRTL/SHAREABLE +</pre></li> +</ol> +On AXP (and possibly also using DEC C on VAX) the corresponding +commands are +<ol> +<li>Using the shareable TIFF library. +<pre> +$ LINK MY_PROGRAM,DISK:[TIFF.LIBTIFF]TIFF/OPTIONS +</pre></li> +<li>Using the TIFF object library. +<pre> +$ LINK MY_PROGRAM,DISK:[TIFF.LIBTIFF]TIFF/LIBRARY +</pre></li> +</ol> +Method 1 uses the shortest link time and smallest <tt>.EXE</tt> +files, but it requires that <tt>TIFFSHR</tt> is defined as above at +link time and <strong>at run time</strong>. Using the compilation +procedure above, the tools are linked in this way. +<p>Method 2 gives somewhat longer link time and larger +<tt>.EXE</tt> files, but does not require <tt>TIFFSHR</tt> to be +defined. This method is recommended if you want to run your program +on another machine, and for some reason don't want to have the +library on that machine. If you plan to have more than one program +(including the tools) on the machine, it is recommended that you +copy the library to the other machine and use method 1. <a name= +"Acorn" id="Acorn"></a></p> +<hr> +<h2>Building the Software on an Acorn RISC OS system</h2> +The directory <b>contrib/acorn</b> contains support for compiling +the library under Acorn C/C++ under Acorn's RISC OS 3.10 or above. +Subsequent pathnames will use the Acorn format: The full-stop or +period character is a pathname delimeter, and the slash character +is not interpreted; the reverse position from Unix. Thus +"libtiff/tif_acorn.c" becomes "libtiff.tif_acorn/c". +<p>This support was contributed by Peter Greenham. (<a href= +"mailto:peter@enlarion.demon.co.uk">peter@enlarion.demon.co.uk</a>).</p> +<h3>Installing LibTIFF:</h3> +<p>LIBTIFF uses several files which have names longer than the +normal RISC OS maximum of ten characters. This complicates matters. +Maybe one day Acorn will address the problem and implement long +filenames properly. Until then this gets messy, especially as I'm +trying to do this with obeyfiles and not have to include binaries +in this distribution.</p> +<p>First of all, ensure you have Truncate configured on (type +<tt>*Configure Truncate On</tt>)</p> +<p>Although it is, of course, preferable to have long filenames, +LIBTIFF can be installed with short filenames, and it will compile +and link without problems. However, <i>getting</i> it there is more +problematic. <b>contrib.acorn.install</b> is an installation +obeyfile which will create a normal Acorn-style library from the +source (ie: with c, h and o folders etc.), but needs the +distribution library to have been unpacked into a location which is +capable of supporting long filenames, even if only temporarily.</p> +<p>My recommendation, until Acorn address this problem properly, is +to use Jason Tribbeck's <a href= +"ftp://ftp.demon.co.uk/pub/mirrors/hensa/micros/arch/riscos/c/c020/longfiles.arc"> +LongFilenames</a>, or any other working system that gives you long +filenames, like a nearby NFS server for instance.</p> +<p>If you are using Longfilenames, even if only temporarily to +install LIBTIFF, unpack the TAR into a RAMDisc which has been +longfilenamed (ie: <tt>*addlongfs ram</tt>) and then install from +there to the hard disk. Unfortunately Longfilenames seems a bit +unhappy about copying a bunch of long-named files across the same +filing system, but is happy going between systems. You'll need to +create a ramdisk of about 2Mb.</p> +<p>Now you can run the installation script I've supplied (in +contrib.acorn), which will automate the process of installing +LIBTIFF as an Acorn-style library. The syntax is as follows:</p> +<p><tt>install <source_dir> <dest_dir></tt></p> +<p>Install will then create <dest_dir> and put the library in +there. For example, having used LongFilenames on the RAMDisk and +unpacked the library into there, you can then type:</p> +<p><tt>Obey RAM::RamDisc0.$.contrib.acorn.install RAM::RamDisc0.$ +ADFS::4.$.LIBTIFF</tt></p> +<p>It doesn't matter if the destination location can cope with long +filenames or not. The filenames will be truncated if necessary +(*Configure Truncate On if you get errors) and all will be +well.</p> +<h3>Compiling LibTIFF:</h3> +<p>Once the LibTIFF folder has been created and the files put +inside, making the library should be just a matter of running +'<b>SetVars</b>' to set the appropriate system variables, then +running '<b>Makefile</b>'.</p> +<p><b>OSLib</b></p> +<p><a href= +"ftp://ftp.acorn.co.uk/pub/riscos/releases/oslib/oslib.arc">OSLib</a> +is a comprehensive API for RISC OS machines, written by Jonathan +Coxhead of Acorn Computers (although OSLib is not an official Acorn +product). Using the OSLib SWI veneers produces code which is more +compact and more efficient than code written using _kernel_swi or +_swi. The Acorn port of LibTIFF can take advantage of this if +present. Edit the Makefile and go to the Static dependencies +section. The first entry is:</p> +<pre> +# Static dependencies: +@.o.tif_acorn: @.c.tif_acorn + cc $(ccflags) -o @.o.tif_acorn @.c.tif_acorn +</pre> +<p>Change the cc line to:</p> +<pre> + cc $(ccflags) -DINCLUDE_OSLIB -o @.o.tif_acorn @.c.tif_acorn +</pre> +<p>Remember, however, that OSLib is only <i>recommended</i> for +efficiency's sake. It is not required. <a name="Other" id= +"Other"></a></p> +<hr> +<h2>Building the Software on Other Systems</h2> +This section contains information that might be useful if you are +working on a non-UNIX system that is not directly supported. All +library-related files described below are located in the +<b>libtiff</b> directory. +<p>The library requires two files that are generated +<i>on-the-fly</i>. The file <b>tif_fax3sm.c</b> has the state +tables for the Group 3 and Group 4 decoders. This file is generated +by the <tt>mkg3states</tt> program on a UNIX system; for +example,</p> +<div style="margin-left: 2em"> +<pre> +<tt> +cd libtiff +cc -o mkg3states mkg3states.c +rm -f tif_fax3sm.c +./mkg3states -c const tif_fax3sm.c +</tt> +</pre></div> +The <tt>-c</tt> option can be used to control whether or not the +resutling tables are generated with a <tt>const</tt> declaration. +The <tt>-s</tt> option can be used to specify a C storage class for +the table declarations. The <tt>-b</tt> option can be used to force +data values to be explicitly bracketed with ``{}'' (apparently +needed for some MS-Windows compilers); otherwise the structures are +emitted in as compact a format as possible. Consult the source code +for this program if you have questions. +<p>The second file required to build the library, <b>version.h</b>, +contains the version information returned by the +<tt>TIFFGetVersion</tt> routine. This file is built on most systems +using the <tt>mkversion</tt> program and the contents of the +<tt>VERSION</tt> and <tt>tiff.alpha</tt> files; for example,</p> +<div style="margin-left: 2em"> +<pre> +cd libtiff +cc -o mkversion mkversion.c +rm -f version.h +./mkversion -v ../VERSION -a ../dist/tiff.alpha version.h +</pre></div> +<p>Otherwise, when building the library on a non-UNIX system be +sure to consult the files <b>tiffcomp.h</b> and <b>tiffconf.h</b>. +The former contains system compatibility definitions while the +latter is provided so that the software configuration can be +controlled on systems that do not support the make facility for +building the software.</p> +<p>Systems without a 32-bit compiler may not be able to handle some +of the codecs in the library; especially the Group 3 and 4 decoder. +If you encounter problems try disabling support for a particular +codec; consult the <a href= +"internals.html#Config">documentation</a>.</p> +<p>Programs in the tools directory are written to assume an ANSI C +compilation environment. There may be a few POSIX'isms as well. The +code in the <b>port</b> directory is provided to emulate routines +that may be missing on some systems. On UNIX systems the +<tt>configure</tt> script automatically figures out which routines +are not present on a system and enables the use of the equivalent +emulation routines from the <b>port</b> directory. It may be +necessary to manually do this work on a non-UNIX system. <a name= +"Testing" id="Testing"></a></p> +<hr> +<h2>Checking out the Software</h2> +<p>Assuming you have working versions of <tt>tiffgt</tt> and +<tt>tiffsv</tt>, you can just use them to view any of the sample +images available for testing (see the <a href="images.html">section +on obtaining the test images</a>). Otherwise, you can do a cursory +check of the library with the <tt>tiffcp</tt> and <tt>tiffcmp</tt> +programs. For example,</p> +<div style="margin-left: 2em"> +<pre> +tiffcp -lzw cramps.tif x.tif +tiffcmp cramps.tif x.tif +</pre></div> +<p>(<tt>tiffcmp</tt> should be silent if the files compare +correctly). <a name="TOC" id="TOC"></a></p> +<hr> +<h2>Table of Contents</h2> +The following files makup the core library: +<pre> +libtiff/tiff.h TIFF spec definitions +libtiff/tiffcomp.h non-UNIX OS-compatibility definitions +libtiff/tiffconf.h non-UNIX configuration definitions +libtiff/tiffio.h public TIFF library definitions +libtiff/tiffiop.h private TIFF library definitions +libtiff/t4.h CCITT Group 3/4 code tables+definitions +libtiff/tif_dir.h private defs for TIFF directory handling +libtiff/tif_fax3.h CCITT Group 3/4-related definitions +libtiff/tif_predict.h private defs for Predictor tag support +libtiff/uvcode.h LogL/LogLuv codec-specific definitions +libtiff/version.h version string (generated by Makefile) + +libtiff/tif_acorn.c Acorn-related OS support +libtiff/tif_apple.c Apple-related OS support +libtiff/tif_atari.c Atari-related OS support +libtiff/tif_aux.c auxilary directory-related functions +libtiff/tif_close.c close an open TIFF file +libtiff/tif_codec.c configuration table of builtin codecs +libtiff/tif_compress.c compression scheme support +libtiff/tif_dir.c directory tag interface code +libtiff/tif_dirinfo.c directory known tag support code +libtiff/tif_dirread.c directory reading code +libtiff/tif_dirwrite.c directory writing code +libtiff/tif_dumpmode.c "no" compression codec +libtiff/tif_error.c library error handler +libtiff/tif_fax3.c CCITT Group 3 and 4 codec +libtiff/tif_fax3sm.c G3/G4 state tables (generated by mkg3states) +libtiff/tif_flush.c i/o and directory state flushing +libtiff/tif_getimage.c TIFFRGBAImage support +libtiff/tif_jpeg.c JPEG codec (interface to the IJG distribution) +libtiff/tif_luv.c SGI LogL/LogLuv codec +libtiff/tif_lzw.c LZW codec +libtiff/tif_msdos.c MSDOS-related OS support +libtiff/tif_next.c NeXT 2-bit scheme codec (decoding only) +libtiff/tif_open.c open and simply query code +libtiff/tif_packbits.c Packbits codec +libtiff/tif_pixarlog.c Pixar codec +libtiff/tif_predict.c Predictor tag support +libtiff/tif_print.c directory printing support +libtiff/tif_read.c image data reading support +libtiff/tif_strip.c some strip-related code +libtiff/tif_swab.c byte and bit swapping support +libtiff/tif_thunder.c Thunderscan codec (decoding only) +libtiff/tif_tile.c some tile-related code +libtiff/tif_unix.c UNIX-related OS support +libtiff/tif_version.c library version support +libtiff/tif_vms.c VMS-related OS support +libtiff/tif_warning.c library warning handler +libtiff/tif_win3.c Windows-3.1-related OS support +libtiff/tif_win32.c Win32 (95/98/NT) related OS support +libtiff/tif_write.c image data writing support +libtiff/tif_zip.c Deflate codec + +libtiff/mkg3states.c program to generate G3/G4 decoder state tables +libtiff/mkspans.c program to generate black-white span tables +libtiff/mkversion.c program to generate libtiff/version.h. +</pre> +<hr> +Last updated: $Date: 2005/12/24 22:25:05 $ +</body> +</html> diff --git a/src/3rdparty/libtiff/html/contrib.html b/src/3rdparty/libtiff/html/contrib.html new file mode 100644 index 0000000..d138900 --- /dev/null +++ b/src/3rdparty/libtiff/html/contrib.html @@ -0,0 +1,209 @@ +<HTML> +<HEAD> +<TITLE> +Contributed TIFF Software +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> +<H1> +<IMG SRC=images/smallliz.jpg WIDTH=144 HEIGHT=108 ALIGN=left BORDER=1 HSPACE=6> +Contributed TIFF Software +</H1> + + +<P> +The <B>contrib</B> directory has contributed software that +uses the TIFF library or which is associated with the library +(typically glue and guidance for ports to non-UNIX platforms, or tools that +aren't directly TIFF related). + +<BR CLEAR=left> + +<P> +<TABLE BORDER CELLPADDING=3> + +<TR> +<TD VALIGN=top> +<B>contrib/vms</B> +</TD> +<TD> +scripts and files from Karsten Spang for building + the library and tools under VMS +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/dbs</B> +</TD> +<TD> +various tools from Dan & Chris Sears, including a simple X-based viewer +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/ras</B> +</TD> +<TD> +two programs by Patrick Naughton for converting + between Sun rasterfile format and TIFF (these + require <TT>libpixrect.a</TT>, as opposed to the one in + tools that doesn't) +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/mac-mpw</B><br> +<B>contrib/mac-cw</B> +</TD> +<TD> +scripts and files from Niles Ritter for building +the library and tools under Macintosh/MPW C and +code warrior. +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/acorn</B> +</TD> +<TD> +scripts and files from Peter Greenham for building + the library and tools on an Acorn RISC OS system. +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/win32</B> +</TD> +<TD> +scripts and files from Scott Wagner for building +the library under Windows NT and Windows 95. (The makefile.vc in the +libtiff/libtiff directory may be sufficient for most users.) +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/win_dib</B> +</TD> +<TD> +two separate implementations of TIFF to DIB code suitable for any Win32 +platform. Contributed by Mark James, and Philippe Tenenhaus. +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/ojpeg</B> +</TD> +<TD> +Patch for IJG JPEG library related to support for some Old JPEG in TIFF files. +Contributed by Scott Marovich. +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/dosdjgpp</B> +</TD> +<TD> +scripts and files from Alexander Lehmann for building + the library under MSDOS with the DJGPP v2 compiler. +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/tags</B> +</TD> +<TD> +scripts and files from Niles Ritter for adding private + tag support at runtime, without changing libtiff. +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/mfs</B> +</TD> +<TD> +code from Mike Johnson to read+write images in memory +without modifying the library +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/pds</B> +</TD> +<TD> +various routines from Conrad Poelman; a TIFF image iterator and + code to support ``private sub-directories'' +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/iptcutil</B> +</TD> + +<TD> + +A utility by <A HREF=mailto:billr@corbis.com>Bill Radcliffe</a> to +convert an extracted IPTC Newsphoto caption from a binary blob to +ASCII text, and vice versa. IPTC binary blobs can be extracted from +images via the <A +HREF=http://www.ImageMagick.org/>ImageMagick</a> convert(1) +utility. + + +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/addtiffo</B> +</TD> + +<TD> + +A utility (and supporting subroutine) for building +one or more reduce resolution +overviews to an existing TIFF file. Supplied by +<a href="http://pobox.com/~warmerdam">Frank Warmerdam</a>. + +</TD> +</TR> + +<TR> +<TD VALIGN=top> +<B>contrib/stream</B> +</TD> + +<TD> + +A class (TiffStream) for accessing TIFF files through a C++ stream +interface. Supplied by <a href="mailto:avi@shutterfly.com">Avi Bleiweiss</a>. + +</TD> +</TR> + +</TABLE> + +<P> +Questions regarding these packages are usually best directed toward +their authors. + +<P> +<HR> + +Last updated: $Date: 2006/01/03 01:42:30 $ + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/document.html b/src/3rdparty/libtiff/html/document.html new file mode 100644 index 0000000..e3e754f --- /dev/null +++ b/src/3rdparty/libtiff/html/document.html @@ -0,0 +1,52 @@ +<HTML> +<HEAD> +<TITLE> +TIFF Documentation +</TITLE> +</HEAD> +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> +<H1> +<IMG SRC=images/jim.gif WIDTH=139 HEIGHT=170 ALIGN=left BORDER=1 HSPACE=6> +TIFF Documentation +</H1> + +<P> +A copy of the 6.0 specification is available from Adobe at +<A HREF="http://partners.adobe.com/public/developer/en/tiff/TIFF6.pdf">http://partners.adobe.com/public/developer/en/tiff/TIFF6.pdf</A>, or from the libtiff +ftp site at <a href="ftp://ftp.remotesensing.org/pub/libtiff/TIFF6.pdf"> +ftp://ftp.remotesensing.org/pub/libtiff/TIFF6.pdf</A>.<p> + +<P> +Draft <a href="TIFFTechNote2.html">TIFF Technical Note #2</A> covers problems +with the TIFF 6.0 design for embedding JPEG-compressed data in TIFF, and +describes an alternative. <p> + +Other Adobe information on TIFF can be retrieved from: + +<A HREF="http://partners.adobe.com/public/developer/tiff/index.html"> +http://partners.adobe.com/public/developer/tiff/index.html</A> + +<P> +Joris Van Damme maintains a list of known tags and their descriptions and +definitions. It is available online at +<A HREF="http://www.awaresystems.be/imaging/tiff/tifftags.html"> +http://www.awaresystems.be/imaging/tiff/tifftags.html</A> + +<P> +There is a FAQ, related both to TIFF format and libtiff library: +<A HREF="http://www.awaresystems.be/imaging/tiff/faq.html"> +http://www.awaresystems.be/imaging/tiff/faq.html</A> + +<P> +There is a preliminary <a href="bigtiffdesign.html">BigTIFF Design</a> for +a TIFF variation supporting files larger than 4GB. + +<HR> + +<ADDRESS> + Last updated: $Date: 2004/12/02 14:51:19 $ +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/images.html b/src/3rdparty/libtiff/html/images.html new file mode 100644 index 0000000..150ed0c --- /dev/null +++ b/src/3rdparty/libtiff/html/images.html @@ -0,0 +1,41 @@ +<HTML> +<HEAD> +<TITLE> +TIFF Test Images +</TITLE> +</HEAD> +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> +<H1> +<IMG SRC=images/bali.jpg WIDTH=158 HEIGHT=107 ALIGN=left BORDER=1 HSPACE=6> +TIFF Test Images +</H1> + +<P> +Test images are available for most formats supported by the library. +Most of the images included in the test kit are also part of this +documentation (albeit in TIFF rather than GIF or JFIF). +The images are kept in a separate archive that should be located in +the same directory as this software. + +<BR CLEAR=left> + +<P> +The latest archive of test images is located at +<A HREF="ftp://ftp.remotesensing.org/pub/libtiff/pics-3.8.0.tar.gz"> +ftp://ftp.remotesensing.org/pub/libtiff/pics-3.8.0.tar.gz</A> + +<P> +There are two other good sources for TIFF test images: +the contributed software <B>contrib/dbs</B> includes several +programs that generate test images suitable for debugging, and +the <TT>tiffcp</TT> program can be used to generate a variety +of images with different storage characteristics. + +<P> +<HR> + +Last updated: $Date: 2006/01/02 23:50:44 $ + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/images/Makefile.am b/src/3rdparty/libtiff/html/images/Makefile.am new file mode 100644 index 0000000..840e149 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/Makefile.am @@ -0,0 +1,46 @@ +# Tag Image File Format (TIFF) Software +# +# Copyright (C) 2004, Andrey Kiselev <dron@ak4719.spb.edu> +# +# Permission to use, copy, modify, distribute, and sell this software and +# its documentation for any purpose is hereby granted without fee, provided +# that (i) the above copyright notices and this permission notice appear in +# all copies of the software and related documentation, and (ii) the names of +# Sam Leffler and Silicon Graphics may not be used in any advertising or +# publicity relating to the software without the specific, prior written +# permission of Sam Leffler and Silicon Graphics. +# +# THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, +# EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY +# WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. +# +# IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR +# ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, +# OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, +# WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF +# LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE +# OF THIS SOFTWARE. + +# Process this file with automake to produce Makefile.in. + +docdir = $(LIBTIFF_DOCDIR)/html/images + +docfiles = \ + back.gif \ + bali.jpg \ + cat.gif \ + cover.jpg \ + cramps.gif \ + dave.gif \ + info.gif \ + jello.jpg \ + jim.gif \ + note.gif \ + oxford.gif \ + quad.jpg \ + ring.gif \ + smallliz.jpg \ + strike.gif \ + warning.gif + +dist_doc_DATA = $(docfiles) diff --git a/src/3rdparty/libtiff/html/images/Makefile.in b/src/3rdparty/libtiff/html/images/Makefile.in new file mode 100644 index 0000000..5f71c02 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/Makefile.in @@ -0,0 +1,436 @@ +# Makefile.in generated by automake 1.9.6 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ + +# Tag Image File Format (TIFF) Software +# +# Copyright (C) 2004, Andrey Kiselev <dron@ak4719.spb.edu> +# +# Permission to use, copy, modify, distribute, and sell this software and +# its documentation for any purpose is hereby granted without fee, provided +# that (i) the above copyright notices and this permission notice appear in +# all copies of the software and related documentation, and (ii) the names of +# Sam Leffler and Silicon Graphics may not be used in any advertising or +# publicity relating to the software without the specific, prior written +# permission of Sam Leffler and Silicon Graphics. +# +# THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, +# EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY +# WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. +# +# IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR +# ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, +# OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, +# WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF +# LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE +# OF THIS SOFTWARE. + +# Process this file with automake to produce Makefile.in. + +srcdir = @srcdir@ +top_srcdir = @top_srcdir@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +top_builddir = ../.. +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +INSTALL = @INSTALL@ +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +target_triplet = @target@ +subdir = html/images +DIST_COMMON = $(dist_doc_DATA) $(srcdir)/Makefile.am \ + $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/acinclude.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/config/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/libtiff/tif_config.h \ + $(top_builddir)/libtiff/tiffconf.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; +am__vpath_adj = case $$p in \ + $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ + *) f=$$p;; \ + esac; +am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; +am__installdirs = "$(DESTDIR)$(docdir)" +dist_docDATA_INSTALL = $(INSTALL_DATA) +DATA = $(dist_doc_DATA) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +AMDEP_FALSE = @AMDEP_FALSE@ +AMDEP_TRUE = @AMDEP_TRUE@ +AMTAR = @AMTAR@ +AR = @AR@ +AS = @AS@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CXX = @CXX@ +CXXCPP = @CXXCPP@ +CXXDEPMODE = @CXXDEPMODE@ +CXXFLAGS = @CXXFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DLLTOOL = @DLLTOOL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +FGREP = @FGREP@ +GLUT_CFLAGS = @GLUT_CFLAGS@ +GLUT_LIBS = @GLUT_LIBS@ +GLU_CFLAGS = @GLU_CFLAGS@ +GLU_LIBS = @GLU_LIBS@ +GL_CFLAGS = @GL_CFLAGS@ +GL_LIBS = @GL_LIBS@ +GREP = @GREP@ +HAVE_CXX_FALSE = @HAVE_CXX_FALSE@ +HAVE_CXX_TRUE = @HAVE_CXX_TRUE@ +HAVE_OPENGL_FALSE = @HAVE_OPENGL_FALSE@ +HAVE_OPENGL_TRUE = @HAVE_OPENGL_TRUE@ +HAVE_RPATH_FALSE = @HAVE_RPATH_FALSE@ +HAVE_RPATH_TRUE = @HAVE_RPATH_TRUE@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBDIR = @LIBDIR@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTIFF_ALPHA_VERSION = @LIBTIFF_ALPHA_VERSION@ +LIBTIFF_DOCDIR = @LIBTIFF_DOCDIR@ +LIBTIFF_MAJOR_VERSION = @LIBTIFF_MAJOR_VERSION@ +LIBTIFF_MICRO_VERSION = @LIBTIFF_MICRO_VERSION@ +LIBTIFF_MINOR_VERSION = @LIBTIFF_MINOR_VERSION@ +LIBTIFF_RELEASE_DATE = @LIBTIFF_RELEASE_DATE@ +LIBTIFF_VERSION = @LIBTIFF_VERSION@ +LIBTIFF_VERSION_INFO = @LIBTIFF_VERSION_INFO@ +LIBTOOL = @LIBTOOL@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAINT = @MAINT@ +MAINTAINER_MODE_FALSE = @MAINTAINER_MODE_FALSE@ +MAINTAINER_MODE_TRUE = @MAINTAINER_MODE_TRUE@ +MAKEINFO = @MAKEINFO@ +NM = @NM@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PTHREAD_CC = @PTHREAD_CC@ +PTHREAD_CFLAGS = @PTHREAD_CFLAGS@ +PTHREAD_LIBS = @PTHREAD_LIBS@ +RANLIB = @RANLIB@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +VERSION = @VERSION@ +X_CFLAGS = @X_CFLAGS@ +X_EXTRA_LIBS = @X_EXTRA_LIBS@ +X_LIBS = @X_LIBS@ +X_PRE_LIBS = @X_PRE_LIBS@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_AS = @ac_ct_AS@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_CXX = @ac_ct_CXX@ +ac_ct_DLLTOOL = @ac_ct_DLLTOOL@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +ac_ct_OBJDUMP = @ac_ct_OBJDUMP@ +ac_ct_RANLIB = @ac_ct_RANLIB@ +ac_ct_STRIP = @ac_ct_STRIP@ +acx_pthread_config = @acx_pthread_config@ +am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ +am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ +am__fastdepCXX_FALSE = @am__fastdepCXX_FALSE@ +am__fastdepCXX_TRUE = @am__fastdepCXX_TRUE@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +datadir = @datadir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localstatedir = @localstatedir@ +lt_ECHO = @lt_ECHO@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +sysconfdir = @sysconfdir@ +target = @target@ +target_alias = @target_alias@ +target_cpu = @target_cpu@ +target_os = @target_os@ +target_vendor = @target_vendor@ +docdir = $(LIBTIFF_DOCDIR)/html/images +docfiles = \ + back.gif \ + bali.jpg \ + cat.gif \ + cover.jpg \ + cramps.gif \ + dave.gif \ + info.gif \ + jello.jpg \ + jim.gif \ + note.gif \ + oxford.gif \ + quad.jpg \ + ring.gif \ + smallliz.jpg \ + strike.gif \ + warning.gif + +dist_doc_DATA = $(docfiles) +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign html/images/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --foreign html/images/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs + +distclean-libtool: + -rm -f libtool +uninstall-info-am: +install-dist_docDATA: $(dist_doc_DATA) + @$(NORMAL_INSTALL) + test -z "$(docdir)" || $(mkdir_p) "$(DESTDIR)$(docdir)" + @list='$(dist_doc_DATA)'; for p in $$list; do \ + if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ + f=$(am__strip_dir) \ + echo " $(dist_docDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(docdir)/$$f'"; \ + $(dist_docDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(docdir)/$$f"; \ + done + +uninstall-dist_docDATA: + @$(NORMAL_UNINSTALL) + @list='$(dist_doc_DATA)'; for p in $$list; do \ + f=$(am__strip_dir) \ + echo " rm -f '$(DESTDIR)$(docdir)/$$f'"; \ + rm -f "$(DESTDIR)$(docdir)/$$f"; \ + done +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ + list='$(DISTFILES)'; for file in $$list; do \ + case $$file in \ + $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ + $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ + esac; \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test "$$dir" != "$$file" && test "$$dir" != "."; then \ + dir="/$$dir"; \ + $(mkdir_p) "$(distdir)$$dir"; \ + else \ + dir=''; \ + fi; \ + if test -d $$d/$$file; then \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile $(DATA) +installdirs: + for dir in "$(DESTDIR)$(docdir)"; do \ + test -z "$$dir" || $(mkdir_p) "$$dir"; \ + done +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-am + +clean-am: clean-generic clean-libtool mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-libtool + +dvi: dvi-am + +dvi-am: + +html: html-am + +info: info-am + +info-am: + +install-data-am: install-dist_docDATA + +install-exec-am: + +install-info: install-info-am + +install-man: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-dist_docDATA uninstall-info-am + +.PHONY: all all-am check check-am clean clean-generic clean-libtool \ + distclean distclean-generic distclean-libtool distdir dvi \ + dvi-am html html-am info info-am install install-am \ + install-data install-data-am install-dist_docDATA install-exec \ + install-exec-am install-info install-info-am install-man \ + install-strip installcheck installcheck-am installdirs \ + maintainer-clean maintainer-clean-generic mostlyclean \ + mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ + uninstall uninstall-am uninstall-dist_docDATA \ + uninstall-info-am + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/src/3rdparty/libtiff/html/images/back.gif b/src/3rdparty/libtiff/html/images/back.gif Binary files differnew file mode 100644 index 0000000..11d0c35 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/back.gif diff --git a/src/3rdparty/libtiff/html/images/bali.jpg b/src/3rdparty/libtiff/html/images/bali.jpg Binary files differnew file mode 100644 index 0000000..1f5c146 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/bali.jpg diff --git a/src/3rdparty/libtiff/html/images/cat.gif b/src/3rdparty/libtiff/html/images/cat.gif Binary files differnew file mode 100644 index 0000000..5bd3fac --- /dev/null +++ b/src/3rdparty/libtiff/html/images/cat.gif diff --git a/src/3rdparty/libtiff/html/images/cover.jpg b/src/3rdparty/libtiff/html/images/cover.jpg Binary files differnew file mode 100644 index 0000000..8698cfb --- /dev/null +++ b/src/3rdparty/libtiff/html/images/cover.jpg diff --git a/src/3rdparty/libtiff/html/images/cramps.gif b/src/3rdparty/libtiff/html/images/cramps.gif Binary files differnew file mode 100644 index 0000000..9153f9a --- /dev/null +++ b/src/3rdparty/libtiff/html/images/cramps.gif diff --git a/src/3rdparty/libtiff/html/images/dave.gif b/src/3rdparty/libtiff/html/images/dave.gif Binary files differnew file mode 100644 index 0000000..c36d447 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/dave.gif diff --git a/src/3rdparty/libtiff/html/images/info.gif b/src/3rdparty/libtiff/html/images/info.gif Binary files differnew file mode 100644 index 0000000..783d631 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/info.gif diff --git a/src/3rdparty/libtiff/html/images/jello.jpg b/src/3rdparty/libtiff/html/images/jello.jpg Binary files differnew file mode 100644 index 0000000..df99e66 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/jello.jpg diff --git a/src/3rdparty/libtiff/html/images/jim.gif b/src/3rdparty/libtiff/html/images/jim.gif Binary files differnew file mode 100644 index 0000000..9a18a03 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/jim.gif diff --git a/src/3rdparty/libtiff/html/images/note.gif b/src/3rdparty/libtiff/html/images/note.gif Binary files differnew file mode 100644 index 0000000..7177d68 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/note.gif diff --git a/src/3rdparty/libtiff/html/images/oxford.gif b/src/3rdparty/libtiff/html/images/oxford.gif Binary files differnew file mode 100644 index 0000000..dd4b86e --- /dev/null +++ b/src/3rdparty/libtiff/html/images/oxford.gif diff --git a/src/3rdparty/libtiff/html/images/quad.jpg b/src/3rdparty/libtiff/html/images/quad.jpg Binary files differnew file mode 100644 index 0000000..4b7df17 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/quad.jpg diff --git a/src/3rdparty/libtiff/html/images/ring.gif b/src/3rdparty/libtiff/html/images/ring.gif Binary files differnew file mode 100644 index 0000000..2a614f4 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/ring.gif diff --git a/src/3rdparty/libtiff/html/images/smallliz.jpg b/src/3rdparty/libtiff/html/images/smallliz.jpg Binary files differnew file mode 100644 index 0000000..8eb827f --- /dev/null +++ b/src/3rdparty/libtiff/html/images/smallliz.jpg diff --git a/src/3rdparty/libtiff/html/images/strike.gif b/src/3rdparty/libtiff/html/images/strike.gif Binary files differnew file mode 100644 index 0000000..0709d19 --- /dev/null +++ b/src/3rdparty/libtiff/html/images/strike.gif diff --git a/src/3rdparty/libtiff/html/images/warning.gif b/src/3rdparty/libtiff/html/images/warning.gif Binary files differnew file mode 100644 index 0000000..f51eb4b --- /dev/null +++ b/src/3rdparty/libtiff/html/images/warning.gif diff --git a/src/3rdparty/libtiff/html/index.html b/src/3rdparty/libtiff/html/index.html new file mode 100644 index 0000000..e48544e --- /dev/null +++ b/src/3rdparty/libtiff/html/index.html @@ -0,0 +1,121 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html lang="en"> +<head> + <title>LibTIFF - TIFF Library and Utilities</title> + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"> + <meta http-equiv="content-language" content="en"> + <style type="text/css"> + <!-- + th {text-align: left; vertical-align: top; padding-right: 1em; white-space: nowrap} + --> + </style> +</head> +<body lang="en" text="#000000" bgcolor="#ffffff" link="#0000ff" alink="#0000ff" vlink="#0000ff"> + <h1>LibTIFF - TIFF Library and Utilities</h1> + <hr> + <table cellspacing="0" cellpadding="0" border="0"> + <tr> + <th>Home Page</th> + <td><a href="http://www.remotesensing.org/libtiff/" title="Home of the LibTIFF software">http://www.remotesensing.org/libtiff/</a></td> + </tr> + <tr> + <th>Home Page Mirror</th> + <td><a href="http://libtiff.maptools.org/" title="Mirror of the LibTIFF software">http://libtiff.maptools.org/</a></td> + </tr> + <tr> + <th>Latest Stable Release</th> + <td><a href="v3.8.2.html">v3.8.2</a></td> + </tr> + <tr> + <th>Latest Development Release</th> + <td><a href="v3.8.2.html">v3.8.2</a></td> + </tr> + <tr> + <th>Master Download Site</th> + <td><a href="ftp://ftp.remotesensing.org/pub/libtiff">ftp.remotesensing.org</a>, directory pub/libtiff</td> + </tr> + <tr> + <th>Mirror Download Site</th> + <td><a href="http://libtiff.maptools.org/dl/">http://libtiff.maptools.org/dl/</a></td> + </tr> + <tr> + <th>Windows Binaries</th> + <td><a href="http://gnuwin32.sourceforge.net/packages/libtiff.htm">GnuWin32 Project</a></td> + </tr> + <tr> + <th>Mailing List</th> + <td><a href="mailto:tiff@lists.maptools.org">tiff@lists.maptools.org</a>, + <a href="http://lists.maptools.org/mailman/listinfo/tiff/">Subscription</a>, + <a href="http://www.awaresystems.be/imaging/tiff/tml.html">Archive</a>. + Please, read the <a href="http://www.awaresystems.be/imaging/tiff/faq.html">TIFF FAQ</a> + before asking questions.</td> + </tr> + <tr> + <th>Anonymous CVS</th> + <td><tt>export CVSROOT=:pserver:cvsanon@cvs.maptools.org:/cvs/maptools/cvsroot<br> + cvs login # use empty password"<br> + cvs checkout libtiff<br></tt></td> + </tr> + </table> + <hr> + <p> + This software provides support for the <i>Tag Image File Format</i> (TIFF), + a widely used format for storing image data. The latest version of + the TIFF specification is <a href="document.html">available on-line</a> + in several different formats. + </p> + <p> + Included in this software distribution is a library, libtiff, for + reading and writing TIFF, a small collection of tools for doing simple + manipulations of TIFF images on UNIX systems, + and documentation on the library and + tools. A small assortment of TIFF-related software for UNIX + that has been contributed by others is also included. + </p> + <p> + The library, along with associated tool programs, should handle most of + your needs for reading and writing TIFF images on 32- and 64-bit + machines. This software can also be used on older 16-bit systems + though it may require some effort and you may need to leave out some of + the compression support. + </p> + <p> + The software was orginally authored and maintained by Sam Leffler. + While he keeps a fatherly eye on the mailing list, he is no longer + responsible for day to day maintenance. + </p> + <p> + Questions should be sent to the TIFF mailing list: + <a href="mailto:tiff@lists.maptools.org">tiff@lists.maptools.org</a>, with + a subscription interface at + <a href="http://lists.maptools.org/mailman/listinfo/tiff">http://lists.maptools.org/mailman/listinfo/tiff</a>. + </p> + <p> + The persons responsible for putting up this site and putting together + versions >= 3.5.1 are + <a href="http://pobox.com/~warmerdam">Frank Warmerdam</a>, + <a href="mailto:dron@ak4719.spb.edu">Andrey Kiselev</a> and Mike Welles. + </p> + <p> + The following sections are included in this documentation: + </p> + <ul> + <li><a href="support.html">TIFF 6.0 specification coverage</a></li> + <li><a href="libtiff.html">Using the TIFF Library</a></li> + <li><a href="internals.html">Modifying the TIFF Library</a> + and <a href="addingtags.html">Adding New Tags</a></li> + <li><a href="tools.html">TIFF tools overview</a></li> + <li><a href="contrib.html">Contributed software</a></li> + <li><a href="document.html">TIFF documentation</a></li> + <li><a href="build.html">Building the software distribution</a></li> + <li><a href="bugs.html">Bugs, Bugzilla, and the TIFF mailing list</a></li> + <li><a href="images.html">Test images</a></li> + <li><a href="misc.html">Acknowledgements and copyright issues</a></li> + <li><a href="man/index.html">Man Pages</a></li> + </ul> + <hr> + <p> + Last updated $Date: 2006/03/23 14:54:01 $. + </p> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/internals.html b/src/3rdparty/libtiff/html/internals.html new file mode 100644 index 0000000..3cc9673 --- /dev/null +++ b/src/3rdparty/libtiff/html/internals.html @@ -0,0 +1,572 @@ +<HTML> +<HEAD> +<TITLE> +Modifying The TIFF Library +</TITLE> +</HEAD> +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> +<H1> +<IMG SRC=images/dave.gif WIDTH=107 HEIGHT=148 BORDER=2 ALIGN=left HSPACE=6> +Modifying The TIFF Library +</H1> + + +<P> +This chapter provides information about the internal structure of +the library, how to control the configuration when building it, and +how to add new support to the library. +The following sections are found in this chapter: + +<UL> +<LI><A HREF=#Config>Library Configuration</A> +<LI><A HREF=#Portability>General Portability Comments</A> +<LI><A HREF="#Types">Types and Portability</A> +<LI><A HREF="addingtags.html">Adding New Tags</A> +<LI><A HREF=#AddingCODECS>Adding New Builtin Codecs</A> +<LI><A HREF="addingtags.html#AddingCODECTags">Adding New Codec-private Tags</A> +<LI><A HREF=#Other>Other Comments</A> +</UL> + + +<A NAME="Config"><P><HR WIDTH=65% ALIGN=right><H3>Library Configuration</H3></A> + +Information on compiling the library is given +<A HREF=build.html>elsewhere in this documentation</A>. +This section describes the low-level mechanisms used to control +the optional parts of the library that are configured at build +time. Control is based on +a collection of C defines that are specified either on the compiler +command line or in a configuration file such as <TT>port.h</TT> +(as generated by the <TT>configure</TT> script for UNIX systems) +or <B>tiffconf.h</B>. + +<P> +Configuration defines are split into three areas: +<UL> +<LI>those that control which compression schemes are + configured as part of the builtin codecs, +<LI>those that control support for groups of tags that + are considered optional, and +<LI>those that control operating system or machine-specific support. +</UL> + +<P> +If the define <TT>COMPRESSION_SUPPORT</TT> is <STRONG>not defined</STRONG> +then a default set of compression schemes is automatically +configured: +<UL> +<LI>CCITT Group 3 and 4 algorithms (compression codes 2, 3, 4, and 32771), +<LI>the Macintosh PackBits algorithm (compression 32773), +<LI>a 4-bit run-length encoding scheme from ThunderScan (compression 32809), +<LI>a 2-bit encoding scheme used by NeXT (compression 32766), and +<LI>two experimental schemes intended for images with high dynamic range +(compression 34676 and 34677). +</UL> + +<P> + +To override the default compression behaviour define +<TT>COMPRESSION_SUPPORT</TT> and then one or more additional defines +to enable configuration of the appropriate codecs (see the table +below); e.g. + +<UL><PRE> +#define COMPRESSION_SUPPORT +#define CCITT_SUPPORT +#define PACKBITS_SUPPORT +</PRE></UL> + +Several other compression schemes are configured separately from +the default set because they depend on ancillary software +packages that are not distributed with <TT>libtiff</TT>. + +<P> +Support for JPEG compression is controlled by <TT>JPEG_SUPPORT</TT>. +The JPEG codec that comes with <TT>libtiff</TT> is designed for +use with release 5 or later of the Independent JPEG Group's freely +available software distribution. +This software can be retrieved from the directory +<A HREF=ftp://ftp.uu.net/graphics/jpeg>ftp.uu.net:/graphics/jpeg/</A>. + + +<P> +<IMG SRC="images/info.gif" ALT="NOTE: " ALIGN=left HSPACE=8> +<EM>Enabling JPEG support automatically enables support for +the TIFF 6.0 colorimetry and YCbCr-related tags.</EM> + +<P> +Experimental support for the deflate algorithm is controlled by +<TT>DEFLATE_SUPPORT</TT>. +The deflate codec that comes with <TT>libtiff</TT> is designed +for use with version 0.99 or later of the freely available +<TT>libz</TT> library written by Jean-loup Gailly and Mark Adler. +The data format used by this library is described +in the files +<A HREF=ftp://ftp.uu.net/pub/archiving/zip/doc/zlib-3.1.doc>zlib-3.1.doc</A>, +and +<A HREF=ftp://ftp.uu.net/pub/archiving/zip/doc/deflate-1.1.doc>deflate-1.1.doc</A>, +available in the directory +<A HREF=ftp://ftp.uu.net/pub/archiving/zip/doc>ftp.uu.net:/pub/archiving/zip/doc</A>.</EM> +The library can be retried from the directory +<A HREF=ftp://ftp.uu.net/pub/archiving/zip/zlib/>ftp.uu.net:/pub/archiving/zip/zlib/</A> +(or try <A HREF=ftp://quest.jpl.nasa.gov/beta/zlib/>quest.jpl.nasa.gov:/beta/zlib/</A>). + +<P> +<IMG SRC="images/warning.gif" ALT="NOTE: " ALIGN=left HSPACE=8 VSPACE=6> +<EM>The deflate algorithm is experimental. Do not expect +to exchange files using this compression scheme; +it is included only because the similar, and more common, +LZW algorithm is claimed to be governed by licensing restrictions.</EM> + + +<P> +By default <B>tiffconf.h</B> defines +<TT>COLORIMETRY_SUPPORT</TT>, +<TT>YCBCR_SUPPORT</TT>, +and +<TT>CMYK_SUPPORT</TT>. + +<P> +<TABLE BORDER CELLPADDING=3> + +<TR><TH ALIGN=left>Define</TH><TH ALIGN=left>Description</TH></TR> + +<TR> +<TD VALIGN=top><TT>CCITT_SUPPORT</TT></TD> +<TD>CCITT Group 3 and 4 algorithms (compression codes 2, 3, 4, + and 32771)</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>PACKBITS_SUPPORT</TT></TD> +<TD>Macintosh PackBits algorithm (compression 32773)</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>LZW_SUPPORT</TT></TD> +<TD>Lempel-Ziv & Welch (LZW) algorithm (compression 5)</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>THUNDER_SUPPORT</TT></TD> +<TD>4-bit +run-length encoding scheme from ThunderScan (compression 32809)</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>NEXT_SUPPORT</TT></TD> +<TD>2-bit encoding scheme used by NeXT (compression 32766)</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>OJPEG_SUPPORT</TT></TD> +<TD>obsolete JPEG scheme defined in the 6.0 spec (compression 6)</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>JPEG_SUPPORT</TT></TD> +<TD>current JPEG scheme defined in TTN2 (compression 7)</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>ZIP_SUPPORT</TT></TD> +<TD>experimental Deflate scheme (compression 32946)</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>PIXARLOG_SUPPORT</TT></TD> +<TD>Pixar's compression scheme for high-resolution color images (compression 32909)</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>SGILOG_SUPPORT</TT></TD> +<TD>SGI's compression scheme for high-resolution color images (compression 34676 and 34677)</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>COLORIMETRY_SUPPORT</TT></TD> +<TD>support for the TIFF 6.0 colorimetry tags</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>YCBCR_SUPPORT</TT></TD> +<TD>support for the TIFF 6.0 YCbCr-related tags</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>CMYK_SUPPORT</TT></TD> +<TD>support for the TIFF 6.0 CMYK-related tags</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>ICC_SUPPORT</TT></TD> +<TD>support for the ICC Profile tag; see +<I>The ICC Profile Format Specification</I>, +Annex B.3 "Embedding ICC Profiles in TIFF Files"; +available at +<A HREF=http://www.color.org>http://www.color.org</A> +</TD> +</TR> + +</TABLE> + + +<A NAME="Portability"><P><HR WIDTH=65% ALIGN=right><H3>General Portability Comments</H3></A> + +This software is developed on Silicon Graphics UNIX +systems (big-endian, MIPS CPU, 32-bit ints, +IEEE floating point). +The <TT>configure</TT> shell script generates the appropriate +include files and make files for UNIX systems. +Makefiles exist for non-UNIX platforms that the +code runs on -- this work has mostly been done by other people. + +<P> +In general, the code is guaranteed to work only on SGI machines. +In practice it is highly portable to any 32-bit or 64-bit system and much +work has been done to insure portability to 16-bit systems. +If you encounter portability problems please return fixes so +that future distributions can be improved. + +<P> +The software is written to assume an ANSI C compilation environment. +If your compiler does not support ANSI function prototypes, <TT>const</TT>, +and <TT><stdarg.h></TT> then you will have to make modifications to the +software. In the past I have tried to support compilers without <TT>const</TT> +and systems without <TT><stdarg.h></TT>, but I am +<EM>no longer interested in these +antiquated environments</EM>. With the general availability of +the freely available GCC compiler, I +see no reason to incorporate modifications to the software for these +purposes. + +<P> +An effort has been made to isolate as many of the +operating system-dependencies +as possible in two files: <B>tiffcomp.h</B> and +<B>libtiff/tif_<os>.c</B>. The latter file contains +operating system-specific routines to do I/O and I/O-related operations. +The UNIX (<B>tif_unix.c</B>), +Macintosh (<B>tif_apple.c</B>), +and VMS (<B>tif_vms.c</B>) +code has had the most use; +the MS/DOS support (<B>tif_msdos.c</B>) assumes +some level of UNIX system call emulation (i.e. +<TT>open</TT>, +<TT>read</TT>, +<TT>write</TT>, +<TT>fstat</TT>, +<TT>malloc</TT>, +<TT>free</TT>). + +<P> +Native CPU byte order is determined on the fly by +the library and does not need to be specified. +The <TT>HOST_FILLORDER</TT> and <TT>HOST_BIGENDIAN</TT> +definitions are not currently used, but may be employed by +codecs for optimization purposes. + +<P> +The following defines control general portability: + +<P> +<TABLE BORDER CELLPADDING=3 WIDTH=100%> + +<TR> +<TD VALIGN=top><TT>BSDTYPES</TT></TD> +<TD>Define this if your system does NOT define the + usual BSD typedefs: <TT>u_char</TT>, + <TT>u_short</TT>, <TT>u_int</TT>, <TT>u_long</TT>.</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>HAVE_IEEEFP</TT></TD> +<TD>Define this as 0 or 1 according to the floating point + format suported by the machine. If your machine does + not support IEEE floating point then you will need to + add support to tif_machdep.c to convert between the + native format and IEEE format.</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>HAVE_MMAP</TT></TD> +<TD>Define this if there is <I>mmap-style</I> support for +mapping files into memory (used only to read data).</TD> +</TR> + +<TR> +<TD VALIGN=top><TT>HOST_FILLORDER</TT></TD> +<TD>Define the native CPU bit order: one of <TT>FILLORDER_MSB2LSB</TT> + or <TT>FILLORDER_LSB2MSB</TT></TD> +</TR> + +<TR> +<TD VALIGN=top><TT>HOST_BIGENDIAN</TT></TD> +<TD>Define the native CPU byte order: 1 if big-endian (Motorola) + or 0 if little-endian (Intel); this may be used + in codecs to optimize code</TD> +</TR> +</TABLE> + +<P> +On UNIX systems <TT>HAVE_MMAP</TT> is defined through the running of +the <TT>configure</TT> script; otherwise support for memory-mapped +files is disabled. +Note that <B>tiffcomp.h</B> defines <TT>HAVE_IEEEFP</TT> to be +1 (<TT>BSDTYPES</TT> is not defined). + + +<A NAME="Types"><P><HR WIDTH=65% ALIGN=right><H3>Types and Portability</H3></A> + +The software makes extensive use of C typedefs to promote portability. +Two sets of typedefs are used, one for communication with clients +of the library and one for internal data structures and parsing of the +TIFF format. There are interactions between these two to be careful +of, but for the most part you should be able to deal with portability +purely by fiddling with the following machine-dependent typedefs: + + +<P> +<TABLE BORDER CELLPADDING=3 WIDTH=100%> + +<TR> +<TD>uint8</TD> +<TD>8-bit unsigned integer</TD> +<TD>tiff.h</TD> +</TR> + +<TR> +<TD>int8</TD> +<TD>8-bit signed integer</TD> +<TD>tiff.h</TD> +</TR> + +<TR> +<TD>uint16</TD> +<TD>16-bit unsigned integer</TD> +<TD>tiff.h</TD> +</TR> + +<TR> +<TD>int16</TD> +<TD>16-bit signed integer</TD> +<TD>tiff.h</TD> +</TR> + +<TR> +<TD>uint32</TD> +<TD>32-bit unsigned integer</TD> +<TD>tiff.h</TD> +</TR> + +<TR> +<TD>int32</TD> +<TD>32-bit signed integer</TD> +<TD>tiff.h</TD> +</TR> + +<TR> +<TD>dblparam_t</TD> +<TD>promoted type for floats</TD> +<TD>tiffcomp.h</TD> +</TR> + +</TABLE> + +<P> +(to clarify <TT>dblparam_t</TT>, it is the type that float parameters are +promoted to when passed by value in a function call.) + +<P> +The following typedefs are used throughout the library and interfaces +to refer to certain objects whose size is dependent on the TIFF image +structure: + + +<P> +<TABLE BORDER CELLPADDING=3 WIDTH=100%> + +<TR> +<TD WIDTH=25%>typedef unsigned int ttag_t;</TD> <TD>directory tag</TD> +</TR> + +<TR> +<TD>typedef uint16 tdir_t;</TD> <TD>directory index</TD> +</TR> + +<TR> +<TD>typedef uint16 tsample_t;</TD> <TD>sample number</TD> +</TR> + +<TR> +<TD>typedef uint32 tstrip_t;</TD> <TD>strip number</TD> +</TR> + +<TR> +<TD>typedef uint32 ttile_t;</TD> <TD>tile number</TD> +</TR> + +<TR> +<TD>typedef int32 tsize_t;</TD> <TD>i/o size in bytes</TD> +</TR> + +<TR> +<TD>typedef void* tdata_t;</TD> <TD>image data ref</TD> +</TR> + +<TR> +<TD>typedef void* thandle_t;</TD> <TD>client data handle</TD> +</TR> + +<TR> +<TD>typedef int32 toff_t;</TD> <TD>file offset (should be off_t)</TD> +</TR> + +<TR> +<TD>typedef unsigned char* tidata_t;</TD> <TD>internal image data</TD> +</TR> + +</TABLE> + +<P> +Note that <TT>tstrip_t</TT>, <TT>ttile_t</TT>, and <TT>tsize_t</TT> +are constrained to be +no more than 32-bit quantities by 32-bit fields they are stored +in in the TIFF image. Likewise <TT>tsample_t</TT> is limited by the 16-bit +field used to store the <TT>SamplesPerPixel</TT> tag. <TT>tdir_t</TT> +constrains +the maximum number of IFDs that may appear in an image and may +be an arbitrary size (without penalty). <TT>ttag_t</TT> must be either +<TT>int</TT>, <TT>unsigned int</TT>, pointer, or <TT>double</TT> +because the library uses a varargs +interface and ANSI C restricts the type of the parameter before an +ellipsis to be a promoted type. <TT>toff_t</TT> is defined as +<TT>int32</TT> because +TIFF file offsets are (unsigned) 32-bit quantities. A signed +value is used because some interfaces return -1 on error (sigh). +Finally, note that <TT>tidata_t</TT> is used internally to the library to +manipulate internal data. User-specified data references are +passed as opaque handles and only cast at the lowest layers where +their type is presumed. + + +<P><HR WIDTH=65% ALIGN=right><H3>General Comments</H3></A> + +The library is designed to hide as much of the details of TIFF from +applications as +possible. In particular, TIFF directories are read in their entirety +into an internal format. Only the tags known by the library are +available to a user and certain tag data may be maintained that a user +does not care about (e.g. transfer function tables). + +<A NAME=AddingCODECS><P><HR WIDTH=65% ALIGN=right><H3>Adding New Builtin Codecs</H3></A> + +To add builtin support for a new compression algorithm, you can either +use the "tag-extension" trick to override the handling of the +TIFF Compression tag (see <A HREF=addingtags.html>Adding New Tags</A>), +or do the following to add support directly to the core library: + +<OL> +<LI>Define the tag value in <B>tiff.h</B>. +<LI>Edit the file <B>tif_codec.c</B> to add an entry to the + _TIFFBuiltinCODECS array (see how other algorithms are handled). +<LI>Add the appropriate function prototype declaration to + <B>tiffiop.h</B> (close to the bottom). +<LI>Create a file with the compression scheme code, by convention files + are named <B>tif_*.c</B> (except perhaps on some systems where the + tif_ prefix pushes some filenames over 14 chars. +<LI>Edit <B>Makefile.in</B> (and any other Makefiles) + to include the new source file. +</OL> + +<P> +A codec, say <TT>foo</TT>, can have many different entry points: + +<PRE> +TIFFInitfoo(tif, scheme)/* initialize scheme and setup entry points in tif */ +fooSetupDecode(tif) /* called once per IFD after tags has been frozen */ +fooPreDecode(tif, sample)/* called once per strip/tile, after data is read, + but before the first row is decoded */ +fooDecode*(tif, bp, cc, sample)/* decode cc bytes of data into the buffer */ + fooDecodeRow(...) /* called to decode a single scanline */ + fooDecodeStrip(...) /* called to decode an entire strip */ + fooDecodeTile(...) /* called to decode an entire tile */ +fooSetupEncode(tif) /* called once per IFD after tags has been frozen */ +fooPreEncode(tif, sample)/* called once per strip/tile, before the first row in + a strip/tile is encoded */ +fooEncode*(tif, bp, cc, sample)/* encode cc bytes of user data (bp) */ + fooEncodeRow(...) /* called to decode a single scanline */ + fooEncodeStrip(...) /* called to decode an entire strip */ + fooEncodeTile(...) /* called to decode an entire tile */ +fooPostEncode(tif) /* called once per strip/tile, just before data is written */ +fooSeek(tif, row) /* seek forwards row scanlines from the beginning + of a strip (row will always be >0 and <rows/strip */ +fooCleanup(tif) /* called when compression scheme is replaced by user */ +</PRE> + +<P> +Note that the encoding and decoding variants are only needed when +a compression algorithm is dependent on the structure of the data. +For example, Group 3 2D encoding and decoding maintains a reference +scanline. The sample parameter identifies which sample is to be +encoded or decoded if the image is organized with <TT>PlanarConfig</TT>=2 +(separate planes). This is important for algorithms such as JPEG. +If <TT>PlanarConfig</TT>=1 (interleaved), then sample will always be 0. + +<A NAME=Other><P><HR WIDTH=65% ALIGN=right><H3>Other Comments</H3></A> + +The library handles most I/O buffering. There are two data buffers +when decoding data: a raw data buffer that holds all the data in a +strip, and a user-supplied scanline buffer that compression schemes +place decoded data into. When encoding data the data in the +user-supplied scanline buffer is encoded into the raw data buffer (from +where it is written). Decoding routines should never have to explicitly +read data -- a full strip/tile's worth of raw data is read and scanlines +never cross strip boundaries. Encoding routines must be cognizant of +the raw data buffer size and call <TT>TIFFFlushData1()</TT> when necessary. +Note that any pending data is automatically flushed when a new strip/tile is +started, so there's no need do that in the tif_postencode routine (if +one exists). Bit order is automatically handled by the library when +a raw strip or tile is filled. If the decoded samples are interpreted +by the decoding routine before they are passed back to the user, then +the decoding logic must handle byte-swapping by overriding the +<TT>tif_postdecode</TT> +routine (set it to <TT>TIFFNoPostDecode</TT>) and doing the required work +internally. For an example of doing this look at the horizontal +differencing code in the routines in <B>tif_predict.c</B>. + +<P> +The variables <TT>tif_rawcc</TT>, <TT>tif_rawdata</TT>, and +<TT>tif_rawcp</TT> in a <TT>TIFF</TT> structure +are associated with the raw data buffer. <TT>tif_rawcc</TT> must be non-zero +for the library to automatically flush data. The variable +<TT>tif_scanlinesize</TT> is the size a user's scanline buffer should be. The +variable <TT>tif_tilesize</TT> is the size of a tile for tiled images. This +should not normally be used by compression routines, except where it +relates to the compression algorithm. That is, the <TT>cc</TT> parameter to the +<TT>tif_decode*</TT> and <TT>tif_encode*</TT> +routines should be used in terminating +decompression/compression. This ensures these routines can be used, +for example, to decode/encode entire strips of data. + +<P> +In general, if you have a new compression algorithm to add, work from +the code for an existing routine. In particular, +<B>tif_dumpmode.c</B> +has the trivial code for the "nil" compression scheme, +<B>tif_packbits.c</B> is a +simple byte-oriented scheme that has to watch out for buffer +boundaries, and <B>tif_lzw.c</B> has the LZW scheme that has the most +complexity -- it tracks the buffer boundary at a bit level. +Of course, using a private compression scheme (or private tags) limits +the portability of your TIFF files. + +<P> +<HR> + +Last updated: $Date: 2004/09/10 14:47:31 $ + +</BODY> + +</HTML> diff --git a/src/3rdparty/libtiff/html/intro.html b/src/3rdparty/libtiff/html/intro.html new file mode 100644 index 0000000..61c01d4 --- /dev/null +++ b/src/3rdparty/libtiff/html/intro.html @@ -0,0 +1,68 @@ +<HTML> +<HEAD> +<TITLE> +Introduction to the TIFF Documentation +</TITLE> +</HEAD> +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> +<H1> +<IMG SRC=images/strike.gif WIDTH=128 HEIGHT=100 ALIGN=left HSPACE=6> +Introduction to the TIFF Documentation +</H1> + + +<P> +The following definitions are used throughout this documentation. +They are consistent with the terminology used in the TIFF 6.0 specification. + +<DL> +<DT><I>Sample</I> +<DD>The unit of information stored in an image; often called a + channel elsewhere. Sample values are numbers, usually unsigned + integers, but possibly in some other format if the SampleFormat + tag is specified in a TIFF +<DT><I>Pixel</I> +<DD>A collection of one or more samples that go together. +<DT><I>Row</I> +<DD>An Nx1 rectangular collection of pixels. +<DT><I>Tile</I> +<DD>An NxM rectangular organization of data (or pixels). +<DT><I>Strip</I> +<DD>A tile whose width is the full image width. +<DT><I>Compression</I> +<DD>A scheme by which pixel or sample data are stored in + an encoded form, specifically with the intent of reducing the + storage cost. +<DT><I>Codec</I> +<DD>Software that implements the decoding and encoding algorithms + of a compression scheme. +</UL> + +<P> +In order to better understand how TIFF works (and consequently this +software) it is important to recognize the distinction between the +physical organization of image data as it is stored in a TIFF and how +the data is interpreted and manipulated as pixels in an image. TIFF +supports a wide variety of storage and data compression schemes that +can be used to optimize retrieval time and/or minimize storage space. +These on-disk formats are independent of the image characteristics; it +is the responsibility of the TIFF reader to process the on-disk storage +into an in-memory format suitable for an application. Furthermore, it +is the responsibility of the application to properly interpret the +visual characteristics of the image data. TIFF defines a framework for +specifying the on-disk storage format and image characteristics with +few restrictions. This permits significant complexity that can be +daunting. Good applications that handle TIFF work by handling as wide +a range of storage formats as possible, while constraining the +acceptable image characteristics to those that make sense for the +application. + + +<P> +<HR> + +Last updated: $Date: 1999/08/09 20:21:21 $ + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/libtiff.html b/src/3rdparty/libtiff/html/libtiff.html new file mode 100644 index 0000000..6a2c42e --- /dev/null +++ b/src/3rdparty/libtiff/html/libtiff.html @@ -0,0 +1,747 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html lang="en"> +<head> + <title>Using The TIFF Library</title> + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"> + <meta http-equiv="content-language" content="en"> + <style type="text/css"> + <!-- + th {text-align: left; vertical-align: top; font-style: italic; font-weight: normal} + --> + </style> +</head> +<body lang="en" text="#000000" bgcolor="#ffffff" link="#0000ff" alink="#0000ff" vlink="#0000ff"> + <table border="0" cellspacing="0" cellpadding="0"> + <tr> + <td style="padding-left: 1em; padding-right: 1em"><img src="images/cat.gif" width="113" height="146" alt=""></td> + <td> + <h1>Using The TIFF Library</h1> + <p> + <tt>libtiff</tt> is a set of C functions (a library) that support + the manipulation of TIFF image files. + The library requires an ANSI C compilation environment for building + and presumes an ANSI C environment for use. + </p> + </td> + </tr> + </table> + <br> + <p> + <tt>libtiff</tt> + provides interfaces to image data at several layers of abstraction (and cost). + At the highest level image data can be read into an 8-bit/sample, + ABGR pixel raster format without regard for the underlying data organization, + colorspace, or compression scheme. Below this high-level interface + the library provides scanline-, strip-, and tile-oriented interfaces that + return data decompressed but otherwise untransformed. These interfaces + require that the application first identify the organization of stored + data and select either a strip-based or tile-based API for manipulating + data. At the lowest level the library + provides access to the raw uncompressed strips or tiles, + returning the data exactly as it appears in the file. + </p> + <p> + The material presented in this chapter is a basic introduction + to the capabilities of the library; it is not an attempt to describe + everything a developer needs to know about the library or about TIFF. + Detailed information on the interfaces to the library are given in + the <a href="http://www.remotesensing.org/libtiff/man/index.html">UNIX + manual pages</a> that accompany this software. + </p> + <p> + Michael Still has also written a useful introduction to libtiff for the + IBM DeveloperWorks site available at + <a href="http://www.ibm.com/developerworks/linux/library/l-libtiff">http://www.ibm.com/developerworks/linux/library/l-libtiff</a>. + </p> + <p> + The following sections are found in this chapter: + </p> + <ul> + <li><a href="#version">How to tell which version you have</a></li> + <li><a href="#typedefs">Library Datatypes</a></li> + <li><a href="#mman">Memory Management</a></li> + <li><a href="#errors">Error Handling</a></li> + <li><a href="#fio">Basic File Handling</a></li> + <li><a href="#dirs">TIFF Directories</a></li> + <li><a href="#tags">TIFF Tags</a></li> + <li><a href="#compression">TIFF Compression Schemes</a></li> + <li><a href="#byteorder">Byte Order</a></li> + <li><a href="#dataplacement">Data Placement</a></li> + <li><a href="#tiffrgbaimage">TIFFRGBAImage Support</a></li> + <li><a href="#scanlines">Scanline-based Image I/O</a></li> + <li><a href="#strips">Strip-oriented Image I/O</a></li> + <li><a href="#tiles">Tile-oriented Image I/O</a></li> + <li><a href="#other">Other Stuff</a></li> + </ul> + <hr> + <h2 id="version">How to tell which version you have</h2> + <p> + The software version can be found by looking at the file named + <tt>VERSION</tt> + that is located at the top of the source tree; the precise alpha number + is given in the file <tt>dist/tiff.alpha</tt>. + If you have need to refer to this + specific software, you should identify it as: + </p> + <p style="margin-left: 40px"> + <tt>TIFF <<i>version</i>> <<i>alpha</i>></tt> + </p> + <p> + where <tt><<i>version</i>></tt> is whatever you get from + <tt>"cat VERSION"</tt> and <tt><<i>alpha</i>></tt> is + what you get from <tt>"cat dist/tiff.alpha"</tt>. + </p> + <p> + Within an application that uses <tt>libtiff</tt> the <tt>TIFFGetVersion</tt> + routine will return a pointer to a string that contains software version + information. + The library include file <tt><tiffio.h></tt> contains a C pre-processor + define <tt>TIFFLIB_VERSION</tt> that can be used to check library + version compatiblity at compile time. + </p> + <hr> + <h2 id="typedefs">Library Datatypes</h2> + <p> + <tt>libtiff</tt> defines a portable programming interface through the + use of a set of C type definitions. + These definitions, defined in in the files <b>tiff.h</b> and + <b>tiffio.h</b>, + isolate the <tt>libtiff</tt> API from the characteristics + of the underlying machine. + To insure portable code and correct operation, applications that use + <tt>libtiff</tt> should use the typedefs and follow the function + prototypes for the library API. + </p> + <hr> + <h2 id="mman">Memory Management</h2> + <p> + <tt>libtiff</tt> uses a machine-specific set of routines for managing + dynamically allocated memory. + <tt>_TIFFmalloc</tt>, <tt>_TIFFrealloc</tt>, and <tt>_TIFFfree</tt> + mimic the normal ANSI C routines. + Any dynamically allocated memory that is to be passed into the library + should be allocated using these interfaces in order to insure pointer + compatibility on machines with a segmented architecture. + (On 32-bit UNIX systems these routines just call the normal <tt>malloc</tt>, + <tt>realloc</tt>, and <tt>free</tt> routines in the C library.) + </p> + <p> + To deal with segmented pointer issues <tt>libtiff</tt> also provides + <tt>_TIFFmemcpy</tt>, <tt>_TIFFmemset</tt>, and <tt>_TIFFmemmove</tt> + routines that mimic the equivalent ANSI C routines, but that are + intended for use with memory allocated through <tt>_TIFFmalloc</tt> + and <tt>_TIFFrealloc</tt>. + </p> + <hr> + <h2 id="errors">Error Handling</h2> + <p> + <tt>libtiff</tt> handles most errors by returning an invalid/erroneous + value when returning from a function call. + Various diagnostic messages may also be generated by the library. + All error messages are directed to a single global error handler + routine that can be specified with a call to <tt>TIFFSetErrorHandler</tt>. + Likewise warning messages are directed to a single handler routine + that can be specified with a call to <tt>TIFFSetWarningHandler</tt> + </p> + <hr> + <h2 id="fio">Basic File Handling</h2> + <p> + The library is modeled after the normal UNIX stdio library. + For example, to read from an existing TIFF image the + file must first be opened: + </p> + <p style="margin-left: 40px"> + <tt>#include "tiffio.h"<br> + main()<br> + {<br> + TIFF* tif = TIFFOpen("foo.tif", "r");<br> + ... do stuff ...<br> + TIFFClose(tif);<br> + }</tt> + </p> + <p> + The handle returned by <tt>TIFFOpen</tt> is <i>opaque</i>, that is + the application is not permitted to know about its contents. + All subsequent library calls for this file must pass the handle + as an argument. + </p> + <p> + To create or overwrite a TIFF image the file is also opened, but with + a <tt>"w"</tt> argument: + <p> + <p style="margin-left: 40px"> + <tt>#include "tiffio.h"<br> + main()<br> + {<br> + TIFF* tif = TIFFOpen("foo.tif", "w");<br> + ... do stuff ...<br> + TIFFClose(tif);<br> + }</tt> + </p> + <p> + If the file already exists it is first truncated to zero length. + </p> + <table> + <tr> + <td valign=top><img src="images/warning.gif" width="40" height="40" alt=""></td> + <td><i>Note that unlike the stdio library TIFF image files may not be + opened for both reading and writing; + there is no support for altering the contents of a TIFF file.</i></td> + </tr> + </table> + <p> + <tt>libtiff</tt> buffers much information associated with writing a + valid TIFF image. Consequently, when writing a TIFF image it is necessary + to always call <tt>TIFFClose</tt> or <tt>TIFFFlush</tt> to flush any + buffered information to a file. Note that if you call <tt>TIFFClose</tt> + you do not need to call <tt>TIFFFlush</tt>. + </p> + <hr> + <h2 id="dirs">TIFF Directories</h2> + <p> + TIFF supports the storage of multiple images in a single file. + Each image has an associated data structure termed a <i>directory</i> + that houses all the information about the format and content of the + image data. + Images in a file are usually related but they do not need to be; it + is perfectly alright to store a color image together with a black and + white image. + Note however that while images may be related their directories are + not. + That is, each directory stands on its own; their is no need to read + an unrelated directory in order to properly interpret the contents + of an image. + </p> + <p> + <tt>libtiff</tt> provides several routines for reading and writing + directories. In normal use there is no need to explicitly + read or write a directory: the library automatically reads the first + directory in a file when opened for reading, and directory information + to be written is automatically accumulated and written when writing + (assuming <tt>TIFFClose</tt> or <tt>TIFFFlush</tt> are called). + </p> + <p> + For a file open for reading the <tt>TIFFSetDirectory</tt> routine can + be used to select an arbitrary directory; directories are referenced by + number with the numbering starting at 0. Otherwise the + <tt>TIFFReadDirectory</tt> and <tt>TIFFWriteDirectory</tt> routines can + be used for sequential access to directories. + For example, to count the number of directories in a file the following + code might be used: + </p> + <p style="margin-left: 40px"> + <tt>#include "tiffio.h"<br> + main(int argc, char* argv[])<br> + {<br> + TIFF* tif = TIFFOpen(argv[1], "r");<br> + if (tif) {<br> + int dircount = 0;<br> + do {<br> + dircount++;<br> + } while (TIFFReadDirectory(tif));<br> + printf("%d directories in %s\n", dircount, argv[1]);<br> + TIFFClose(tif);<br> + }<br> + exit(0);<br> + }</tt> + </p> + <p> + Finally, note that there are several routines for querying the + directory status of an open file: + <tt>TIFFCurrentDirectory</tt> returns the index of the current + directory and + <tt>TIFFLastDirectory</tt> returns an indication of whether the + current directory is the last directory in a file. + There is also a routine, <tt>TIFFPrintDirectory</tt>, that can + be called to print a formatted description of the contents of + the current directory; consult the manual page for complete details. + </p> + <hr> + <h2 id="tags">TIFF Tags</h2> + <p> + Image-related information such as the image width and height, number + of samples, orientation, colorimetric information, etc. + are stored in each image + directory in <i>fields</i> or <i>tags</i>. + Tags are identified by a number that is usually a value registered + with the Aldus (now Adobe) Corporation. + Beware however that some vendors write + TIFF images with tags that are unregistered; in this case interpreting + their contents is usually a waste of time. + </p> + <p> + <tt>libtiff</tt> reads the contents of a directory all at once + and converts the on-disk information to an appropriate in-memory + form. While the TIFF specification permits an arbitrary set of + tags to be defined and used in a file, the library only understands + a limited set of tags. + Any unknown tags that are encountered in a file are ignored. + There is a mechanism to extend the set of tags the library handles + without modifying the library itself; + this is described <a href="addingtags.html">elsewhere</a>. + </p> + <p> + <tt>libtiff</tt> provides two interfaces for getting and setting tag + values: <tt>TIFFGetField</tt> and <tt>TIFFSetField</tt>. + These routines use a variable argument list-style interface to pass + parameters of different type through a single function interface. + The <i>get interface</i> takes one or more pointers to memory locations + where the tag values are to be returned and also returns one or + zero according to whether the requested tag is defined in the directory. + The <i>set interface</i> takes the tag values either by-reference or + by-value. + The TIFF specification defines + <i>default values</i> for some tags. + To get the value of a tag, or its default value if it is undefined, + the <tt>TIFFGetFieldDefaulted</tt> interface may be used. + </p> + <p> + The manual pages for the tag get and set routines specifiy the exact data types + and calling conventions required for each tag supported by the library. + </p> + <hr> + <h2 id="compression">TIFF Compression Schemes</h2> + <p> + <tt>libtiff</tt> includes support for a wide variety of + data compression schemes. + In normal operation a compression scheme is automatically used when + the TIFF <tt>Compression</tt> tag is set, either by opening a file + for reading, or by setting the tag when writing. + </p> + <p> + Compression schemes are implemented by software modules termed <i>codecs</i> + that implement decoder and encoder routines that hook into the + core library i/o support. + Codecs other than those bundled with the library can be registered + for use with the <tt>TIFFRegisterCODEC</tt> routine. + This interface can also be used to override the core-library + implementation for a compression scheme. + </p> + <hr> + <h2 id="byteorder">Byte Order</h2> + <p> + The TIFF specification says, and has always said, that + <em>a correct TIFF + reader must handle images in big-endian and little-endian byte order</em>. + <tt>libtiff</tt> conforms in this respect. + Consequently there is no means to force a specific + byte order for the data written to a TIFF image file (data is + written in the native order of the host CPU unless appending to + an existing file, in which case it is written in the byte order + specified in the file). + </p> + <hr> + <h2 id="dataplacement">Data Placement</h2> + <p> + The TIFF specification requires that all information except an + 8-byte header can be placed anywhere in a file. + In particular, it is perfectly legitimate for directory information + to be written after the image data itself. + Consequently TIFF is inherently not suitable for passing through a + stream-oriented mechanism such as UNIX pipes. + Software that require that data be organized in a file in a particular + order (e.g. directory information before image data) does not + correctly support TIFF. + <tt>libtiff</tt> provides no mechanism for controlling the placement + of data in a file; image data is typically written before directory + information. + </p> + <hr> + <h2 id="tiffrgbaimage">TIFFRGBAImage Support</h2> + <p> + <tt>libtiff</tt> provides a high-level interface for reading image + data from a TIFF file. This interface handles the details of + data organization and format for a wide variety of TIFF files; + at least the large majority of those files that one would normally + encounter. Image data is, by default, returned as ABGR + pixels packed into 32-bit words (8 bits per sample). Rectangular + rasters can be read or data can be intercepted at an intermediate + level and packed into memory in a format more suitable to the + application. + The library handles all the details of the format of data stored on + disk and, in most cases, if any colorspace conversions are required: + bilevel to RGB, greyscale to RGB, CMYK to RGB, YCbCr to RGB, 16-bit + samples to 8-bit samples, associated/unassociated alpha, etc. + </p> + <p> + There are two ways to read image data using this interface. If + all the data is to be stored in memory and manipulated at once, + then the routine <tt>TIFFReadRGBAImage</tt> can be used: + </p> + <p> + <p style="margin-left: 40px"> + <tt>#include "tiffio.h"<br> + main(int argc, char* argv[])<br> + {<br> + TIFF* tif = TIFFOpen(argv[1], "r");<br> + if (tif) {<br> + uint32 w, h;<br> + size_t npixels;<br> + uint32* raster;<br> + <br> + TIFFGetField(tif, TIFFTAG_IMAGEWIDTH, &w);<br> + TIFFGetField(tif, TIFFTAG_IMAGELENGTH, &h);<br> + npixels = w * h;<br> + raster = (uint32*) _TIFFmalloc(npixels * sizeof (uint32));<br> + if (raster != NULL) {<br> + if (TIFFReadRGBAImage(tif, w, h, raster, 0)) {<br> + ...process raster data...<br> + }<br> + _TIFFfree(raster);<br> + }<br> + TIFFClose(tif);<br> + }<br> + exit(0);<br> + }</tt> + </p> + <p> + Note above that <tt>_TIFFmalloc</tt> is used to allocate memory for + the raster passed to <tt>TIFFReadRGBAImage</tt>; this is important + to insure the ``appropriate type of memory'' is passed on machines + with segmented architectures. + </p> + <p> + Alternatively, <tt>TIFFReadRGBAImage</tt> can be replaced with a + more low-level interface that permits an application to have more + control over this reading procedure. The equivalent to the above + is: + </p> + <p style="margin-left: 40px"> + <tt>#include "tiffio.h"<br> + main(int argc, char* argv[])<br> + {<br> + TIFF* tif = TIFFOpen(argv[1], "r");<br> + if (tif) {<br> + TIFFRGBAImage img;<br> + char emsg[1024];<br> + <br> + if (TIFFRGBAImageBegin(&img, tif, 0, emsg)) {<br> + size_t npixels;<br> + uint32* raster;<br> + <br> + npixels = img.width * img.height;<br> + raster = (uint32*) _TIFFmalloc(npixels * sizeof (uint32));<br> + if (raster != NULL) {<br> + if (TIFFRGBAImageGet(&img, raster, img.width, img.height)) {<br> + ...process raster data...<br> + }<br> + _TIFFfree(raster);<br> + }<br> + TIFFRGBAImageEnd(&img);<br> + } else<br> + TIFFError(argv[1], emsg);<br> + TIFFClose(tif);<br> + }<br> + exit(0);<br> + }</tt> + </p> + <p> + However this usage does not take advantage of the more fine-grained + control that's possible. That is, by using this interface it is + possible to: + </p> + <ul> + <li>repeatedly fetch (and manipulate) an image without opening + and closing the file</li> + <li>interpose a method for packing raster pixel data according to + application-specific needs (or write the data at all)</li> + <li>interpose methods that handle TIFF formats that are not already + handled by the core library</li> + </ul> + <p> + The first item means that, for example, image viewers that want to + handle multiple files can cache decoding information in order to + speedup the work required to display a TIFF image. + </p> + <p> + The second item is the main reason for this interface. By interposing + a "put method" (the routine that is called to pack pixel data in + the raster) it is possible share the core logic that understands how + to deal with TIFF while packing the resultant pixels in a format that + is optimized for the application. This alternate format might be very + different than the 8-bit per sample ABGR format the library writes by + default. For example, if the application is going to display the image + on an 8-bit colormap display the put routine might take the data and + convert it on-the-fly to the best colormap indices for display. + </p> + <p> + The last item permits an application to extend the library + without modifying the core code. + By overriding the code provided an application might add support + for some esoteric flavor of TIFF that it needs, or it might + substitute a packing routine that is able to do optimizations + using application/environment-specific information. + </p> + <p> + The TIFF image viewer found in <b>tools/sgigt.c</b> is an example + of an application that makes use of the <tt>TIFFRGBAImage</tt> + support. + </p> + <hr> + <h2 id="scanlines">Scanline-based Image I/O</h2> + <p> + The simplest interface provided by <tt>libtiff</tt> is a + scanline-oriented interface that can be used to read TIFF + images that have their image data organized in strips + (trying to use this interface to read data written in tiles + will produce errors.) + A scanline is a one pixel high row of image data whose width + is the width of the image. + Data is returned packed if the image data is stored with samples + packed together, or as arrays of separate samples if the data + is stored with samples separated. + The major limitation of the scanline-oriented interface, other + than the need to first identify an existing file as having a + suitable organization, is that random access to individual + scanlines can only be provided when data is not stored in a + compressed format, or when the number of rows in a strip + of image data is set to one (<tt>RowsPerStrip</tt> is one). + </p> + <p> + Two routines are provided for scanline-based i/o: + <tt>TIFFReadScanline</tt> + and + <tt>TIFFWriteScanline</tt>. + For example, to read the contents of a file that + is assumed to be organized in strips, the following might be used: + </p> + <p style="margin-left: 40px"> + <tt>#include "tiffio.h"<br> + main()<br> + {<br> + TIFF* tif = TIFFOpen("myfile.tif", "r");<br> + if (tif) {<br> + uint32 imagelength;<br> + tdata_t buf;<br> + uint32 row;<br> + <br> + TIFFGetField(tif, TIFFTAG_IMAGELENGTH, &imagelength);<br> + buf = _TIFFmalloc(TIFFScanlineSize(tif));<br> + for (row = 0; row < imagelength; row++)<br> + tiffreadscanline(tif, buf, row);<br> + _tifffree(buf);<br> + tiffclose(tif);<br> + }<br> + }</tt> + </p> + <p> + <tt>TIFFScanlineSize</tt> returns the number of bytes in + a decoded scanline, as returned by <tt>TIFFReadScanline</tt>. + Note however that if the file had been create with samples + written in separate planes, then the above code would only + read data that contained the first sample of each pixel; + to handle either case one might use the following instead: + </p> + <p style="margin-left: 40px"> + <tt>#include "tiffio.h"<br> + main()<br> + {<br> + TIFF* tif = TIFFOpen("myfile.tif", "r");<br> + if (tif) {<br> + uint32 imagelength;<br> + tdata_t buf;<br> + uint32 row;<br> + <br> + TIFFGetField(tif, TIFFTAG_IMAGELENGTH, &imagelength);<br> + TIFFGetField(tif, TIFFTAG_PLANARCONFIG, &config);<br> + buf = _TIFFmalloc(TIFFScanlineSize(tif));<br> + if (config == PLANARCONFIG_CONTIG) {<br> + for (row = 0; row < imagelength; row++)<br> + tiffreadscanline(tif, buf, row);<br> + } else if (config == planarconfig_separate) {<br> + uint16 s, nsamples;<br> + <br> + tiffgetfield(tif, tifftag_samplesperpixel, &nsamples);<br> + for (s = 0; s < nsamples; s++)<br> + for (row = 0; row < imagelength; row++)<br> + tiffreadscanline(tif, buf, row, s);<br> + }<br> + _tifffree(buf);<br> + tiffclose(tif);<br> + }<br> + }</tt> + </p> + <p> + Beware however that if the following code were used instead to + read data in the case <tt>PLANARCONFIG_SEPARATE</tt>,... + </p> + <p style="margin-left: 40px"> + <tt> for (row = 0; row < imagelength; row++)<br> + for (s = 0; s < nsamples; s++)<br> + tiffreadscanline(tif, buf, row, s);</tt> + </p> + <p> + ...then problems would arise if <tt>RowsPerStrip</tt> was not one + because the order in which scanlines are requested would require + random access to data within strips (something that is not supported + by the library when strips are compressed). + </p> + <hr> + <h2 id="strips">Strip-oriented Image I/O</h2> + <p> + The strip-oriented interfaces provided by the library provide + access to entire strips of data. Unlike the scanline-oriented + calls, data can be read or written compressed or uncompressed. + Accessing data at a strip (or tile) level is often desirable + because there are no complications with regard to random access + to data within strips. + </p> + <p> + A simple example of reading an image by strips is: + </p> + <p style="margin-left: 40px"> + <tt>#include "tiffio.h"<br> + main()<br> + {<br> + TIFF* tif = TIFFOpen("myfile.tif", "r");<br> + if (tif) {<br> + tdata_t buf;<br> + tstrip_t strip;<br> + <br> + buf = _TIFFmalloc(TIFFStripSize(tif));<br> + for (strip = 0; strip < tiffnumberofstrips(tif); strip++)<br> + tiffreadencodedstrip(tif, strip, buf, (tsize_t) -1);<br> + _tifffree(buf);<br> + tiffclose(tif);<br> + }<br> + }</tt> + </p> + <p> + Notice how a strip size of <tt>-1</tt> is used; <tt>TIFFReadEncodedStrip</tt> + will calculate the appropriate size in this case. + </p> + <p> + The above code reads strips in the order in which the + data is physically stored in the file. If multiple samples + are present and data is stored with <tt>PLANARCONFIG_SEPARATE</tt> + then all the strips of data holding the first sample will be + read, followed by strips for the second sample, etc. + </p> + <p> + Finally, note that the last strip of data in an image may have fewer + rows in it than specified by the <tt>RowsPerStrip</tt> tag. A + reader should not assume that each decoded strip contains a full + set of rows in it. + </p> + <p> + The following is an example of how to read raw strips of data from + a file: + </p> + <p style="margin-left: 40px"> + <tt>#include "tiffio.h"<br> + main()<br> + {<br> + TIFF* tif = TIFFOpen("myfile.tif", "r");<br> + if (tif) {<br> + tdata_t buf;<br> + tstrip_t strip;<br> + uint32* bc;<br> + uint32 stripsize;<br> + <br> + TIFFGetField(tif, TIFFTAG_STRIPBYTECOUNTS, &bc);<br> + stripsize = bc[0];<br> + buf = _TIFFmalloc(stripsize);<br> + for (strip = 0; strip < tiffnumberofstrips(tif); strip++) {<br> + if (bc[strip] > stripsize) {<br> + buf = _TIFFrealloc(buf, bc[strip]);<br> + stripsize = bc[strip];<br> + }<br> + TIFFReadRawStrip(tif, strip, buf, bc[strip]);<br> + }<br> + _TIFFfree(buf);<br> + TIFFClose(tif);<br> + }<br> + }</tt> + </p> + <p> + As above the strips are read in the order in which they are + physically stored in the file; this may be different from the + logical ordering expected by an application. + </p> + <hr> + <h2 id="tiles">Tile-oriented Image I/O</h2> + <p> + Tiles of data may be read and written in a manner similar to strips. + With this interface, an image is + broken up into a set of rectangular areas that may have dimensions + less than the image width and height. All the tiles + in an image have the same size, and the tile width and length must each + be a multiple of 16 pixels. Tiles are ordered left-to-right and + top-to-bottom in an image. As for scanlines, samples can be packed + contiguously or separately. When separated, all the tiles for a sample + are colocated in the file. That is, all the tiles for sample 0 appear + before the tiles for sample 1, etc. + </p> + <p> + Tiles and strips may also be extended in a z dimension to form + volumes. Data volumes are organized as "slices". That is, all the + data for a slice is colocated. Volumes whose data is organized in + tiles can also have a tile depth so that data can be organized in + cubes. + </p> + <p> + There are actually two interfaces for tiles. + One interface is similar to scanlines, to read a tiled image, + code of the following sort might be used: + </p> + <p style="margin-left: 40px"> + <tt>main()<br> + {<br> + TIFF* tif = TIFFOpen("myfile.tif", "r");<br> + if (tif) {<br> + uint32 imageWidth, imageLength;<br> + uint32 tileWidth, tileLength;<br> + uint32 x, y;<br> + tdata_t buf;<br> + <br> + TIFFGetField(tif, TIFFTAG_IMAGEWIDTH, &imageWidth);<br> + TIFFGetField(tif, TIFFTAG_IMAGELENGTH, &imageLength);<br> + TIFFGetField(tif, TIFFTAG_TILEWIDTH, &tileWidth);<br> + TIFFGetField(tif, TIFFTAG_TILELENGTH, &tileLength);<br> + buf = _TIFFmalloc(TIFFTileSize(tif));<br> + for (y = 0; y < imagelength; y += tilelength)<br> + for (x = 0; x < imagewidth; x += tilewidth)<br> + tiffreadtile(tif, buf, x, y, 0);<br> + _tifffree(buf);<br> + tiffclose(tif);<br> + }<br> + }</tt> + </p> + <p> + (once again, we assume samples are packed contiguously.) + </p> + <p> + Alternatively a direct interface to the low-level data is provided + a la strips. Tiles can be read with + <tt>TIFFReadEncodedTile</tt> or <tt>TIFFReadRawTile</tt>, + and written with <tt>TIFFWriteEncodedTile</tt> or + <tt>TIFFWriteRawTile</tt>. For example, to read all the tiles in an image: + </p> + <p style="margin-left: 40px"> + <tt>#include "tiffio.h"<br> + main()<br> + {<br> + TIFF* tif = TIFFOpen("myfile.tif", "r");<br> + if (tif) {<br> + tdata_t buf;<br> + ttile_t tile;<br> + <br> + buf = _TIFFmalloc(TIFFTileSize(tif));<br> + for (tile = 0; tile < tiffnumberoftiles(tif); tile++)<br> + tiffreadencodedtile(tif, tile, buf, (tsize_t) -1);<br> + _tifffree(buf);<br> + tiffclose(tif);<br> + }<br> + }</tt> + </p> + <hr> + <h2 id="other">Other Stuff</h2> + <p> + Some other stuff will almost certainly go here... + </p> + <hr> + <p> + Last updated: $Date: 2005/12/28 06:53:18 $ + </p> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/Makefile.am b/src/3rdparty/libtiff/html/man/Makefile.am new file mode 100644 index 0000000..885f956 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/Makefile.am @@ -0,0 +1,118 @@ +# Tag Image File Format (TIFF) Software +# +# Copyright (C) 2004, Andrey Kiselev <dron@ak4719.spb.edu> +# +# Permission to use, copy, modify, distribute, and sell this software and +# its documentation for any purpose is hereby granted without fee, provided +# that (i) the above copyright notices and this permission notice appear in +# all copies of the software and related documentation, and (ii) the names of +# Sam Leffler and Silicon Graphics may not be used in any advertising or +# publicity relating to the software without the specific, prior written +# permission of Sam Leffler and Silicon Graphics. +# +# THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, +# EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY +# WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. +# +# IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR +# ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, +# OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, +# WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF +# LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE +# OF THIS SOFTWARE. + +# Process this file with automake to produce Makefile.in. + +docdir = $(LIBTIFF_DOCDIR)/html/man +MANSRCDIR = $(top_srcdir)/man +HTMLMANDIR = $(top_srcdir)/html/man + +GROFF = groff -Thtml -mandoc +ECHO = echo + +indexfile = index.html +docfiles = \ + libtiff.3tiff.html \ + TIFFbuffer.3tiff.html \ + TIFFClose.3tiff.html \ + TIFFcodec.3tiff.html \ + TIFFcolor.3tiff.html \ + TIFFDataWidth.3tiff.html \ + TIFFError.3tiff.html \ + TIFFFlush.3tiff.html \ + TIFFGetField.3tiff.html \ + TIFFmemory.3tiff.html \ + TIFFOpen.3tiff.html \ + TIFFPrintDirectory.3tiff.html \ + TIFFquery.3tiff.html \ + TIFFReadDirectory.3tiff.html \ + TIFFReadEncodedStrip.3tiff.html \ + TIFFReadEncodedTile.3tiff.html \ + TIFFReadRawStrip.3tiff.html \ + TIFFReadRawTile.3tiff.html \ + TIFFReadRGBAImage.3tiff.html \ + TIFFReadRGBAStrip.3tiff.html \ + TIFFReadRGBATile.3tiff.html \ + TIFFReadScanline.3tiff.html \ + TIFFReadTile.3tiff.html \ + TIFFRGBAImage.3tiff.html \ + TIFFSetDirectory.3tiff.html \ + TIFFSetField.3tiff.html \ + TIFFsize.3tiff.html \ + TIFFstrip.3tiff.html \ + TIFFswab.3tiff.html \ + TIFFtile.3tiff.html \ + TIFFWarning.3tiff.html \ + TIFFWriteDirectory.3tiff.html \ + TIFFWriteEncodedStrip.3tiff.html \ + TIFFWriteEncodedTile.3tiff.html \ + TIFFWriteRawStrip.3tiff.html \ + TIFFWriteRawTile.3tiff.html \ + TIFFWriteScanline.3tiff.html \ + TIFFWriteTile.3tiff.html \ + fax2ps.1.html \ + fax2tiff.1.html \ + gif2tiff.1.html \ + pal2rgb.1.html \ + ppm2tiff.1.html \ + ras2tiff.1.html \ + raw2tiff.1.html \ + rgb2ycbcr.1.html \ + sgi2tiff.1.html \ + thumbnail.1.html \ + tiff2bw.1.html \ + tiff2pdf.1.html \ + tiff2ps.1.html \ + tiff2rgba.1.html \ + tiffcmp.1.html \ + tiffcp.1.html \ + tiffdither.1.html \ + tiffdump.1.html \ + tiffgt.1.html \ + tiffinfo.1.html \ + tiffmedian.1.html \ + tiffset.1.html \ + tiffsplit.1.html \ + tiffsv.1.html + +dist_doc_DATA = $(indexfile) $(docfiles) + +INDEXSTART = '<HTML><HEAD><TITLE>Libtiff HTML manpage index</TITLE></HEAD><BODY BGCOLOR=white><ul><H2>Man Pages</h2><p>' +INDEXEND = '</ul></BODY></HTML>' + +.PHONY: index +index: $(docfiles) + ${ECHO} ${INDEXSTART} > $(indexfile) + for i in $^; do \ + ${ECHO} '<li><A HREF='$$i'>'$$i'</a>' >> $(indexfile); \ + done + ${ECHO} ${INDEXEND} >> $(indexfile) + +manpages = $(docfiles:.html=) + +.PHONY: htmldoc +htmldoc: index + for i in $(manpages); do \ + ${GROFF} $(MANSRCDIR)/$$i > $(HTMLMANDIR)/$$i.html; \ + done + diff --git a/src/3rdparty/libtiff/html/man/Makefile.in b/src/3rdparty/libtiff/html/man/Makefile.in new file mode 100644 index 0000000..5836a94 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/Makefile.in @@ -0,0 +1,504 @@ +# Makefile.in generated by automake 1.9.6 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ + +# Tag Image File Format (TIFF) Software +# +# Copyright (C) 2004, Andrey Kiselev <dron@ak4719.spb.edu> +# +# Permission to use, copy, modify, distribute, and sell this software and +# its documentation for any purpose is hereby granted without fee, provided +# that (i) the above copyright notices and this permission notice appear in +# all copies of the software and related documentation, and (ii) the names of +# Sam Leffler and Silicon Graphics may not be used in any advertising or +# publicity relating to the software without the specific, prior written +# permission of Sam Leffler and Silicon Graphics. +# +# THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, +# EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY +# WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. +# +# IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR +# ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, +# OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, +# WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF +# LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE +# OF THIS SOFTWARE. + +# Process this file with automake to produce Makefile.in. + +srcdir = @srcdir@ +top_srcdir = @top_srcdir@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +top_builddir = ../.. +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +INSTALL = @INSTALL@ +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +target_triplet = @target@ +subdir = html/man +DIST_COMMON = $(dist_doc_DATA) $(srcdir)/Makefile.am \ + $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/acinclude.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/config/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/libtiff/tif_config.h \ + $(top_builddir)/libtiff/tiffconf.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; +am__vpath_adj = case $$p in \ + $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ + *) f=$$p;; \ + esac; +am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; +am__installdirs = "$(DESTDIR)$(docdir)" +dist_docDATA_INSTALL = $(INSTALL_DATA) +DATA = $(dist_doc_DATA) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +AMDEP_FALSE = @AMDEP_FALSE@ +AMDEP_TRUE = @AMDEP_TRUE@ +AMTAR = @AMTAR@ +AR = @AR@ +AS = @AS@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CXX = @CXX@ +CXXCPP = @CXXCPP@ +CXXDEPMODE = @CXXDEPMODE@ +CXXFLAGS = @CXXFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DLLTOOL = @DLLTOOL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +FGREP = @FGREP@ +GLUT_CFLAGS = @GLUT_CFLAGS@ +GLUT_LIBS = @GLUT_LIBS@ +GLU_CFLAGS = @GLU_CFLAGS@ +GLU_LIBS = @GLU_LIBS@ +GL_CFLAGS = @GL_CFLAGS@ +GL_LIBS = @GL_LIBS@ +GREP = @GREP@ +HAVE_CXX_FALSE = @HAVE_CXX_FALSE@ +HAVE_CXX_TRUE = @HAVE_CXX_TRUE@ +HAVE_OPENGL_FALSE = @HAVE_OPENGL_FALSE@ +HAVE_OPENGL_TRUE = @HAVE_OPENGL_TRUE@ +HAVE_RPATH_FALSE = @HAVE_RPATH_FALSE@ +HAVE_RPATH_TRUE = @HAVE_RPATH_TRUE@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBDIR = @LIBDIR@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTIFF_ALPHA_VERSION = @LIBTIFF_ALPHA_VERSION@ +LIBTIFF_DOCDIR = @LIBTIFF_DOCDIR@ +LIBTIFF_MAJOR_VERSION = @LIBTIFF_MAJOR_VERSION@ +LIBTIFF_MICRO_VERSION = @LIBTIFF_MICRO_VERSION@ +LIBTIFF_MINOR_VERSION = @LIBTIFF_MINOR_VERSION@ +LIBTIFF_RELEASE_DATE = @LIBTIFF_RELEASE_DATE@ +LIBTIFF_VERSION = @LIBTIFF_VERSION@ +LIBTIFF_VERSION_INFO = @LIBTIFF_VERSION_INFO@ +LIBTOOL = @LIBTOOL@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAINT = @MAINT@ +MAINTAINER_MODE_FALSE = @MAINTAINER_MODE_FALSE@ +MAINTAINER_MODE_TRUE = @MAINTAINER_MODE_TRUE@ +MAKEINFO = @MAKEINFO@ +NM = @NM@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PTHREAD_CC = @PTHREAD_CC@ +PTHREAD_CFLAGS = @PTHREAD_CFLAGS@ +PTHREAD_LIBS = @PTHREAD_LIBS@ +RANLIB = @RANLIB@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +VERSION = @VERSION@ +X_CFLAGS = @X_CFLAGS@ +X_EXTRA_LIBS = @X_EXTRA_LIBS@ +X_LIBS = @X_LIBS@ +X_PRE_LIBS = @X_PRE_LIBS@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_AS = @ac_ct_AS@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_CXX = @ac_ct_CXX@ +ac_ct_DLLTOOL = @ac_ct_DLLTOOL@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +ac_ct_OBJDUMP = @ac_ct_OBJDUMP@ +ac_ct_RANLIB = @ac_ct_RANLIB@ +ac_ct_STRIP = @ac_ct_STRIP@ +acx_pthread_config = @acx_pthread_config@ +am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ +am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ +am__fastdepCXX_FALSE = @am__fastdepCXX_FALSE@ +am__fastdepCXX_TRUE = @am__fastdepCXX_TRUE@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +datadir = @datadir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localstatedir = @localstatedir@ +lt_ECHO = @lt_ECHO@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +sysconfdir = @sysconfdir@ +target = @target@ +target_alias = @target_alias@ +target_cpu = @target_cpu@ +target_os = @target_os@ +target_vendor = @target_vendor@ +docdir = $(LIBTIFF_DOCDIR)/html/man +MANSRCDIR = $(top_srcdir)/man +HTMLMANDIR = $(top_srcdir)/html/man +GROFF = groff -Thtml -mandoc +ECHO = echo +indexfile = index.html +docfiles = \ + libtiff.3tiff.html \ + TIFFbuffer.3tiff.html \ + TIFFClose.3tiff.html \ + TIFFcodec.3tiff.html \ + TIFFcolor.3tiff.html \ + TIFFDataWidth.3tiff.html \ + TIFFError.3tiff.html \ + TIFFFlush.3tiff.html \ + TIFFGetField.3tiff.html \ + TIFFmemory.3tiff.html \ + TIFFOpen.3tiff.html \ + TIFFPrintDirectory.3tiff.html \ + TIFFquery.3tiff.html \ + TIFFReadDirectory.3tiff.html \ + TIFFReadEncodedStrip.3tiff.html \ + TIFFReadEncodedTile.3tiff.html \ + TIFFReadRawStrip.3tiff.html \ + TIFFReadRawTile.3tiff.html \ + TIFFReadRGBAImage.3tiff.html \ + TIFFReadRGBAStrip.3tiff.html \ + TIFFReadRGBATile.3tiff.html \ + TIFFReadScanline.3tiff.html \ + TIFFReadTile.3tiff.html \ + TIFFRGBAImage.3tiff.html \ + TIFFSetDirectory.3tiff.html \ + TIFFSetField.3tiff.html \ + TIFFsize.3tiff.html \ + TIFFstrip.3tiff.html \ + TIFFswab.3tiff.html \ + TIFFtile.3tiff.html \ + TIFFWarning.3tiff.html \ + TIFFWriteDirectory.3tiff.html \ + TIFFWriteEncodedStrip.3tiff.html \ + TIFFWriteEncodedTile.3tiff.html \ + TIFFWriteRawStrip.3tiff.html \ + TIFFWriteRawTile.3tiff.html \ + TIFFWriteScanline.3tiff.html \ + TIFFWriteTile.3tiff.html \ + fax2ps.1.html \ + fax2tiff.1.html \ + gif2tiff.1.html \ + pal2rgb.1.html \ + ppm2tiff.1.html \ + ras2tiff.1.html \ + raw2tiff.1.html \ + rgb2ycbcr.1.html \ + sgi2tiff.1.html \ + thumbnail.1.html \ + tiff2bw.1.html \ + tiff2pdf.1.html \ + tiff2ps.1.html \ + tiff2rgba.1.html \ + tiffcmp.1.html \ + tiffcp.1.html \ + tiffdither.1.html \ + tiffdump.1.html \ + tiffgt.1.html \ + tiffinfo.1.html \ + tiffmedian.1.html \ + tiffset.1.html \ + tiffsplit.1.html \ + tiffsv.1.html + +dist_doc_DATA = $(indexfile) $(docfiles) +INDEXSTART = '<HTML><HEAD><TITLE>Libtiff HTML manpage index</TITLE></HEAD><BODY BGCOLOR=white><ul><H2>Man Pages</h2><p>' +INDEXEND = '</ul></BODY></HTML>' +manpages = $(docfiles:.html=) +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign html/man/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --foreign html/man/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs + +distclean-libtool: + -rm -f libtool +uninstall-info-am: +install-dist_docDATA: $(dist_doc_DATA) + @$(NORMAL_INSTALL) + test -z "$(docdir)" || $(mkdir_p) "$(DESTDIR)$(docdir)" + @list='$(dist_doc_DATA)'; for p in $$list; do \ + if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ + f=$(am__strip_dir) \ + echo " $(dist_docDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(docdir)/$$f'"; \ + $(dist_docDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(docdir)/$$f"; \ + done + +uninstall-dist_docDATA: + @$(NORMAL_UNINSTALL) + @list='$(dist_doc_DATA)'; for p in $$list; do \ + f=$(am__strip_dir) \ + echo " rm -f '$(DESTDIR)$(docdir)/$$f'"; \ + rm -f "$(DESTDIR)$(docdir)/$$f"; \ + done +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ + list='$(DISTFILES)'; for file in $$list; do \ + case $$file in \ + $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ + $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ + esac; \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test "$$dir" != "$$file" && test "$$dir" != "."; then \ + dir="/$$dir"; \ + $(mkdir_p) "$(distdir)$$dir"; \ + else \ + dir=''; \ + fi; \ + if test -d $$d/$$file; then \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile $(DATA) +installdirs: + for dir in "$(DESTDIR)$(docdir)"; do \ + test -z "$$dir" || $(mkdir_p) "$$dir"; \ + done +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-am + +clean-am: clean-generic clean-libtool mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-libtool + +dvi: dvi-am + +dvi-am: + +html: html-am + +info: info-am + +info-am: + +install-data-am: install-dist_docDATA + +install-exec-am: + +install-info: install-info-am + +install-man: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-dist_docDATA uninstall-info-am + +.PHONY: all all-am check check-am clean clean-generic clean-libtool \ + distclean distclean-generic distclean-libtool distdir dvi \ + dvi-am html html-am info info-am install install-am \ + install-data install-data-am install-dist_docDATA install-exec \ + install-exec-am install-info install-info-am install-man \ + install-strip installcheck installcheck-am installdirs \ + maintainer-clean maintainer-clean-generic mostlyclean \ + mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ + uninstall uninstall-am uninstall-dist_docDATA \ + uninstall-info-am + + +.PHONY: index +index: $(docfiles) + ${ECHO} ${INDEXSTART} > $(indexfile) + for i in $^; do \ + ${ECHO} '<li><A HREF='$$i'>'$$i'</a>' >> $(indexfile); \ + done + ${ECHO} ${INDEXEND} >> $(indexfile) + +.PHONY: htmldoc +htmldoc: index + for i in $(manpages); do \ + ${GROFF} $(MANSRCDIR)/$$i > $(HTMLMANDIR)/$$i.html; \ + done +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/src/3rdparty/libtiff/html/man/TIFFClose.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFClose.3tiff.html new file mode 100644 index 0000000..0a92e31 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFClose.3tiff.html @@ -0,0 +1,87 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFClose</title> +</head> +<body> + +<h1 align=center>TIFFClose</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFClose − close a previously opened +<small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>void TIFFClose(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFClose</i> closes a file that was previously opened +with <b>TIFFOpen</b>(3TIFF). Any buffered data are flushed +to the file, including the contents of the current directory +(if modified); and all resources are reclaimed.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the routine. Likewise, +warning messages are directed to the +<b>TIFFWarning</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>libtiff</b>(3TIFF), <b>TIFFOpen</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFDataWidth.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFDataWidth.3tiff.html new file mode 100644 index 0000000..5d82ef4 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFDataWidth.3tiff.html @@ -0,0 +1,98 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFDataWidth</title> +</head> +<body> + +<h1 align=center>TIFFDataWidth</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFDataWidth − Get the size of TIFF data types</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFDataWidth(TIFFDataType</b> +<i>type</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFDataWidth</i> returns a size of <i>type</i> in +bytes. Currently following data types are supported:<i><br> +TIFF_BYTE<br> +TIFF_ASCII<br> +TIFF_SBYTE<br> +TIFF_UNDEFINED<br> +TIFF_SHORT<br> +TIFF_SSHORT<br> +TIFF_LONG<br> +TIFF_SLONG<br> +TIFF_FLOAT<br> +TIFF_IFD<br> +TIFF_RATIONAL<br> +TIFF_SRATIONAL<br> +TIFF_DOUBLE</i></p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFDataWidth</i> returns a number of bytes occupied +by the item of given type. 0 returned when uknown data type +supplied.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>libtiff</b>(3TIFF),</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFError.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFError.3tiff.html new file mode 100644 index 0000000..c7453c3 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFError.3tiff.html @@ -0,0 +1,106 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFError</title> +</head> +<body> + +<h1 align=center>TIFFError</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFError, TIFFSetErrorHandler − library error +handling interface</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>void TIFFError(const char *</b><i>module</i><b>, const +char *</b><i>fmt</i><b>,</b> <i>...</i><b>)</b></p> +<!-- INDENTATION --> +<p><b>#include <stdarg.h></b></p> +<!-- INDENTATION --> +<p><b>typedef void (*TIFFErrorHandler)(const char +*</b><i>module</i><b>, const char *</b><i>fmt</i><b>, +va_list</b> <i>ap</i><b>);<br> +TIFFErrorHandler TIFFSetErrorHandler(TIFFErrorHandler +handler);</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFError</i> invokes the library-wide error handling +function to (normally) write an error message to the +<b>stderr</b>. The <i>fmt</i> parameter is a +<i>printf</i>(3S) format string, and any number arguments +can be supplied. The <i>module</i> parameter, if non-zero, +is printed before the message; it typically is used to +identify the software module in which an error is +detected.</p> +<!-- INDENTATION --> +<p>Applications that desire to capture control in the event +of an error should use <i>TIFFSetErrorHandler</i> to +override the default error handler. A <small>NULL</small> +(0) error handling function may be installed to suppress +error messages.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFSetErrorHandler</i> returns a reference to the +previous error handling function.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFWarning</b>(3TIFF), <b>libtiff</b>(3TIFF), +<b>printf</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFFlush.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFFlush.3tiff.html new file mode 100644 index 0000000..5e5a510 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFFlush.3tiff.html @@ -0,0 +1,113 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFFlush</title> +</head> +<body> + +<h1 align=center>TIFFFlush</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFFlush, TIFFFlushData − flush pending writes to +an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFFlush(TIFF *</b><i>tif</i><b>)<br> +int TIFFFlushData(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFFlush</i> causes any pending writes for the +specified file (including writes for the current directory) +to be done. In normal operation this call is never needed +− the library automatically does any flushing +required.</p> +<!-- INDENTATION --> +<p><i>TIFFFlushData</i> flushes any pending image data for +the specified file to be written out; directory-related data +are not flushed. In normal operation this call is never +needed − the library automatically does any flushing +required.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>0 is returned if an error is encountered, otherwise 1 is +returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteEncodedStrip</b>(3TIFF), +<b>TIFFWriteEncodedTile</b>(3TIFF), +<b>TIFFWriteRawStrip</b>(3TIFF), +<b>TIFFWriteRawTile</b>(3TIFF), +<b>TIFFWriteScanline</b>(3TIFF), <b>TIFFWriteTile</b>(3TIFF) +<b>libtiff</b>(3TIFF),</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFGetField.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFGetField.3tiff.html new file mode 100644 index 0000000..ca114a3 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFGetField.3tiff.html @@ -0,0 +1,1446 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFGetField</title> +</head> +<body> + +<h1 align=center>TIFFGetField</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#AUTOREGISTERED TAGS">AUTOREGISTERED TAGS</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFGetField, TIFFVGetField − get the value(s) of a +tag in an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFGetField(TIFF *</b><i>tif</i><b>, ttag_t</b> +<i>tag</i><b>,</b> <i>...</i><b>)</b></p> +<!-- INDENTATION --> +<p><b>#include <stdarg.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFVGetField(TIFF *</b><i>tif</i><b>, ttag_t</b> +<i>tag</i><b>, va_list</b> <i>ap</i><b>)<br> +int TIFFGetFieldDefaulted(TIFF *</b><i>tif</i><b>, +ttag_t</b> <i>tag</i><b>,</b> <i>...</i><b>)<br> +int TIFFVGetFieldDefaulted(TIFF *</b><i>tif</i><b>, +ttag_t</b> <i>tag</i><b>, va_list</b> <i>ap</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFGetField</i> returns the value of a tag or +pseudo-tag associated with the the current directory of the +opened <small>TIFF</small> file <i>tif</i>. (A +<i>pseudo-tag</i> is a parameter that is used to control the +operation of the <small>TIFF</small> library but whose value +is not read or written to the underlying file.) The file +must have been previously opened with +<i>TIFFOpen</i>(3TIFF). The tag is identified by <i>tag</i>, +one of the values defined in the include file <b>tiff.h</b> +(see also the table below). The type and number of values +returned is dependent on the tag being requested. The +programming interface uses a variable argument list as +prescribed by the <i>stdarg</i>(3) interface. The returned +values should only be interpreted if <i>TIFFGetField</i> +returns 1.</p> +<!-- INDENTATION --> +<p><i>TIFFVGetField</i> is functionally equivalent to +<i>TIFFGetField</i> except that it takes a pointer to a +variable argument list. <i>TIFFVGetField</i> is useful for +layering interfaces on top of the functionality provided by +<i>TIFFGetField</i>.</p> +<!-- INDENTATION --> +<p><i>TIFFGetFieldDefaulted</i> and +<i>TIFFVGetFieldDefaulted</i> are identical to +<i>TIFFGetField</i> and <i>TIFFVGetField</i>, except that if +a tag is not defined in the current directory and it has a +default value, then the default value is returned.</p> +<!-- INDENTATION --> +<p>The tags understood by <i>libtiff(3TIFF),</i> the number +of parameter values, and the types for the returned values +are shown below. The data types are specified as in C and +correspond to the types used to specify tag values to +<i>TIFFSetField</i>(3TIFF). Remember that +<i>TIFFGetField</i> returns parameter values, so all the +listed data types are pointers to storage where values +should be returned. Consult the <small>TIFF</small> +specification (or relevant industry specification) for +information on the meaning of each tag and their possible +values.</p></td> +</table> +<!-- TABS --> + +<p><i>Tag Name Count Types Notes</i></p> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ARTIST</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_BADFAXLINES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_BITSPERSAMPLE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_CLEANFAXDATA</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COLORMAP</p> +</td> +<td width="8%"> + +<p>3</p> +</td> +<td width="23%"> + +<p>uint16**</p> +</td> +<td width="17%"> + +<p>1<<BitsPerSample arrays</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COMPRESSION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_CONSECUTIVEBADFAXLINES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COPYRIGHT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DATATYPE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DATETIME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DOCUMENTNAME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DOTRANGE</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_EXTRASAMPLES</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*,uint16**</p> +</td> +<td width="17%"> + +<p>count & types array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FAXFILLFUNC</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>TIFFFaxFillFunc*</p> +</td> +<td width="17%"> + +<p>G3/G4 compression pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FAXMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>int*</p> +</td> +<td width="17%"> + +<p>G3/G4 compression pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FILLORDER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_GROUP3OPTIONS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_GROUP4OPTIONS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_HALFTONEHINTS</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_HOSTCOMPUTER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ICCPROFILE</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint32*,void**</p> +</td> +<td width="17%"> + +<p>count, profile data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEDEPTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEDESCRIPTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGELENGTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEWIDTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_INKNAMES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_INKSET</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGCOLORMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>int*</p> +</td> +<td width="17%"> + +<p>JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGQUALITY</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>int*</p> +</td> +<td width="17%"> + +<p>JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGTABLES</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint32*,void**</p> +</td> +<td width="17%"> + +<p>count & tables</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGTABLESMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>int*</p> +</td> +<td width="17%"> + +<p>JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MAKE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MATTEING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MAXSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MINSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MODEL</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ORIENTATION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PAGENAME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PAGENUMBER</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PHOTOMETRIC</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PHOTOSHOP</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint32*,void**</p> +</td> +<td width="17%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PLANARCONFIG</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PREDICTOR</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PRIMARYCHROMATICITIES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float**</p> +</td> +<td width="17%"> + +<p>6-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_REFERENCEBLACKWHITE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float**</p> +</td> +<td width="17%"> + +<p>2*SamplesPerPixel array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_RESOLUTIONUNIT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_RICHTIFFIPTC</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint32*,void**</p> +</td> +<td width="17%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ROWSPERSTRIP</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SAMPLEFORMAT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SAMPLESPERPIXEL</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SMAXSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>double*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SMINSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>double*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SOFTWARE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_STONITS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>double**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_STRIPBYTECOUNTS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_STRIPOFFSETS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SUBFILETYPE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SUBIFD</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*,uint32**</p> +</td> +<td width="17%"> + +<p>count & offsets array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TARGETPRINTER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>char**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_THRESHHOLDING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEBYTECOUNTS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEDEPTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILELENGTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEOFFSETS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32**</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEWIDTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint32*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TRANSFERFUNCTION</p> +</td> +<td width="8%"> + +<p>1 or 3†</p> +</td> +<td width="23%"></td> +<td width="17%"> + +<p>uint16**1<<BitsPerSample entry arrays</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_WHITEPOINT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float**</p> +</td> +<td width="17%"> + +<p>2-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XMLPACKET</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint32*,void**</p> +</td> +<td width="17%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XPOSITION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XRESOLUTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRCOEFFICIENTS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float**</p> +</td> +<td width="17%"> + +<p>3-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRPOSITIONING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRSUBSAMPLING</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="23%"> + +<p>uint16*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YPOSITION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float*</p> +</td> +<td width="17%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YRESOLUTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="23%"> + +<p>float*‡</p> +</td> +<td width="17%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>† If <i>SamplesPerPixel</i> is one, then a single +array is returned; otherwise three arrays are returned.<br> +‡ The contents of this field are quite complex. See +<i>The ICC Profile Format Specification</i>, Annex B.3 +"Embedding ICC Profiles in TIFF Files" (available +at http://www.color.org) for an explanation.</p> +</td> +</table> +<a name="AUTOREGISTERED TAGS"></a> +<h2>AUTOREGISTERED TAGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>If you can’t find the tag in the table above that +means this is unsupported tag. But you still be able to read +it’s value if you know the data type of that tag. For +example, if you want to read the LONG value from the tag +33424 and ASCII string from the tag 36867 you can use the +following code:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>uint16 count; +void *data; + +TIFFGetField(tiff, 33424, &count, &data); +printf("Tag %d: %d, count %d0, 33424, *(uint32 *)data, count); +TIFFGetField(tiff, 36867, &count, &data); +printf("Tag %d: %s, count %d0, 36867, (char *)data, count); +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>is not supported by <b>libtiff(3TIFF),</b> library</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned if the tag is defined in the current +directory; otherwise a 0 is returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Unknown field, tag 0x%x</b>. An unknown tag was +supplied.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFSetField</b>(3TIFF), +<b>TIFFSetDirectory</b>(3TIFF), +<b>TIFFReadDirectory</b>(3TIFF), +<b>TIFFWriteDirectory</b>(3TIFF) <b>libtiff</b>(3TIFF),</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFOpen.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFOpen.3tiff.html new file mode 100644 index 0000000..3d3ca66 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFOpen.3tiff.html @@ -0,0 +1,421 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFOpen</title> +</head> +<body> + +<h1 align=center>TIFFOpen</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BYTE ORDER">BYTE ORDER</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFOpen, TIFFFdOpen, TIFFClientOpen − open a +<small>TIFF</small> file for reading or writing</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>TIFF* TIFFOpen(const char *</b><i>filename</i><b>, +const char *</b><i>mode</i><b>)<br> +TIFF* TIFFFdOpen(const int</b> <i>fd</i><b>, const char +*</b><i>filename</i><b>, const char +*</b><i>mode</i><b>)</b></p> +<!-- INDENTATION --> +<p><b>typedef tsize_t (*TIFFReadWriteProc)(thandle_t, +tdata_t, tsize_t);<br> +typedef toff_t (*TIFFSeekProc)(thandle_t, toff_t, int);<br> +typedef int (*TIFFCloseProc)(thandle_t);<br> +typedef toff_t (*TIFFSizeProc)(thandle_t);<br> +typedef int (*TIFFMapFileProc)(thandle_t, tdata_t*, +toff_t*);<br> +typedef void (*TIFFUnmapFileProc)(thandle_t, tdata_t, +toff_t);</b></p> +<!-- INDENTATION --> +<p><b>TIFF* TIFFClientOpen(const char +*</b><i>filename</i><b>, const char *</b><i>mode</i><b>, +thandle_t</b> <i>clientdata</i><b>, TIFFReadWriteProc</b> +<i>readproc</i><b>, TIFFReadWriteProc</b> +<i>writeproc</i><b>, TIFFSeekProc</b> <i>seekproc</i><b>, +TIFFCloseProc</b> <i>closeproc</i><b>, TIFFSizeProc</b> +<i>sizeproc</i><b>, TIFFMapFileProc</b> <i>mapproc</i><b>, +TIFFUnmapFileProc</b> <i>unmapproc</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFOpen</i> opens a <small>TIFF</small> file whose +name is <i>filename</i> and returns a handle to be used in +subsequent calls to routines in <i>libtiff</i>. If the open +operation fails, then zero is returned. The <i>mode</i> +parameter specifies if the file is to be opened for reading +(‘‘r’’), writing +(‘‘w’’), or appending +(‘‘a’’) and, optionally, whether to +override certain default aspects of library operation (see +below). When a file is opened for appending, existing data +will not be touched; instead new data will be written as +additional subfiles. If an existing file is opened for +writing, all previous data is overwritten.</p> +<!-- INDENTATION --> +<p>If a file is opened for reading, the first +<small>TIFF</small> directory in the file is automatically +read (also see <i>TIFFSetDirectory</i>(3TIFF) for reading +directories other than the first). If a file is opened for +writing or appending, a default directory is automatically +created for writing subsequent data. This directory has all +the default values specified in <small>TIFF</small> Revision +6.0: <i>BitsPerSample</i>=1, <i>ThreshHolding</i>=bilevel +art scan, <i>FillOrder</i>=1 (most significant bit of each +data byte is filled first), <i>Orientation</i>=1 (the 0th +row represents the visual top of the image, and the 0th +column represents the visual left hand side), +<i>SamplesPerPixel</i>=1, <i>RowsPerStrip</i>=infinity, +<i>ResolutionUnit</i>=2 (inches), and <i>Compression</i>=1 +(no compression). To alter these values, or to define values +for additional fields, <i>TIFFSetField</i>(3TIFF) must be +used.</p> +<!-- INDENTATION --> +<p><i>TIFFFdOpen</i> is like <i>TIFFOpen</i> except that it +opens a <small>TIFF</small> file given an open file +descriptor <i>fd</i>. The file’s name and mode must +reflect that of the open descriptor. The object associated +with the file descriptor <b>must support random +access</b>.</p> +<!-- INDENTATION --> +<p><i>TIFFClientOpen</i> is like <i>TIFFOpen</i> except that +the caller supplies a collection of functions that the +library will use to do <small>UNIX</small> -like I/O +operations. The <i>readproc</i> and <i>writeproc</i> are +called to read and write data at the current file position. +<i>seekproc</i> is called to change the current file +position a la <i>lseek</i>(2). <i>closeproc</i> is invoked +to release any resources associated with an open file. +<i>sizeproc</i> is invoked to obtain the size in bytes of a +file. <i>mapproc</i> and <i>unmapproc</i> are called to map +and unmap a file’s contents in memory; c.f. +<i>mmap</i>(2) and <i>munmap</i>(2). The <i>clientdata</i> +parameter is an opaque ‘‘handle’’ +passed to the client-specified routines passed as parameters +to <i>TIFFClientOpen</i>.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The open mode parameter can include the following flags +in addition to the ‘‘r’’, +‘‘w’’, and +‘‘a’’ flags. Note however that +option flags must follow the read-write-append +specification.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>l</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>When creating a new file force information be written +with Little-Endian byte order (but see below). By default +the library will create new files using the native +<small>CPU</small> byte order.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>b</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>When creating a new file force information be written +with Big-Endian byte order (but see below). By default the +library will create new files using the native +<small>CPU</small> byte order.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>L</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Force image data that is read or written to be treated +with bits filled from Least Significant Bit ( +<small>LSB</small> ) to Most Significant Bit ( +<small>MSB</small> ). Note that this is the opposite to the +way the library has worked from its inception.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>B</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Force image data that is read or written to be treated +with bits filled from Most Significant Bit ( +<small>MSB</small> ) to Least Significant Bit ( +<small>LSB</small> ); this is the default.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>H</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Force image data that is read or written to be treated +with bits filled in the same order as the native +<small>CPU.</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>M</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Enable the use of memory-mapped files for images opened +read-only. If the underlying system does not support +memory-mapped files or if the specific image being opened +cannot be memory-mapped then the library will fallback to +using the normal system interface for reading information. +By default the library will attempt to use memory-mapped +files.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>m</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Disable the use of memory-mapped files.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>C</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Enable the use of ‘‘strip +chopping’’ when reading images that are +comprised of a single strip or tile of uncompressed data. +Strip chopping is a mechanism by which the library will +automatically convert the single-strip image to multiple +strips, each of which has about 8 Kilobytes of data. This +facility can be useful in reducing the amount of memory used +to read an image because the library normally reads each +strip in its entirety. Strip chopping does however alter the +apparent contents of the image because when an image is +divided into multiple strips it looks as though the +underlying file contains multiple separate strips. Finally, +note that default handling of strip chopping is a +compile-time configuration parameter. The default behaviour, +for backwards compatibility, is to enable strip +chopping.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>c</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Disable the use of strip chopping when reading +images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>h</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Read TIFF header only, do not load the first image +directory. That could be useful in case of the broken first +directory. We can open the file and proceed to the other +directories.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BYTE ORDER"></a> +<h2>BYTE ORDER</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The <small>TIFF</small> specification (<b>all +versions</b>) states that compliant readers <i>must be +capable of reading images written in either byte order</i>. +Nonetheless some software that claims to support the reading +of <small>TIFF</small> images is incapable of reading images +in anything but the native <small>CPU</small> byte order on +which the software was written. (Especially notorious are +applications written to run on Intel-based machines.) By +default the library will create new files with the native +byte-order of the <small>CPU</small> on which the +application is run. This ensures optimal performance and is +portable to any application that conforms to the TIFF +specification. To force the library to use a specific +byte-order when creating a new file the +‘‘b’’ and +‘‘l’’ option flags may be included +in the call to open a file; for example, +‘‘wb’’ or +‘‘wl’’.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Upon successful completion <i>TIFFOpen</i>, +<i>TIFFFdOpen</i>, and <i>TIFFClientOpen</i> return a +<small>TIFF</small> pointer. Otherwise, NULL is +returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine. Likewise, warning messages +are directed to the <i>TIFFWarning</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>"%s": Bad mode</b>. The specified +<i>mode</i> parameter was not one of +‘‘r’’ (read), +‘‘w’’ (write), or +‘‘a’’ (append).</p> +<!-- INDENTATION --> +<p><b>%s: Cannot open</b>. <i>TIFFOpen</i>() was unable to +open the specified filename for read/writing.</p> +<!-- INDENTATION --> +<p><b>Cannot read TIFF header</b>. An error occurred while +attempting to read the header information.</p> +<!-- INDENTATION --> +<p><b>Error writing TIFF header</b>. An error occurred while +writing the default header information for a new file.</p> +<!-- INDENTATION --> +<p><b>Not a TIFF file, bad magic number %d (0x%x)</b>. The +magic number in the header was not (hex) 0x4d4d or (hex) +0x4949.</p> +<!-- INDENTATION --> +<p><b>Not a TIFF file, bad version number %d (0x%x)</b>. The +version field in the header was not 42 (decimal).</p> +<!-- INDENTATION --> +<p><b>Cannot append to file that has opposite byte +ordering</b>. A file with a byte ordering opposite to the +native byte ordering of the current machine was opened for +appending (‘‘a’’). This is a +limitation of the library.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>libtiff</i>(3TIFF), <i>TIFFClose</i>(3TIFF)</p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFPrintDirectory.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFPrintDirectory.3tiff.html new file mode 100644 index 0000000..d40011d --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFPrintDirectory.3tiff.html @@ -0,0 +1,225 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:09 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFPrintDirectory</title> +</head> +<body> + +<h1 align=center>TIFFPrintDirectory</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFPrintDirectory − print a description of a +<small>TIFF</small> directory</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>void TIFFPrintDirectory(TIFF *</b><i>tif</i><b>, FILE +*</b><i>fd</i><b>, long</b> <i>flags</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFPrintDirectory</i> prints a description of the +current directory in the specified <small>TIFF</small> file +to the standard I/O output stream <i>fd</i>. The +<i>flags</i> parameter is used to control the <i>level of +detail</i> of the printed information; it is a bit-or of the +flags defined in <b>tiffio.h</b>:</p></td> +</table> +<!-- TABS --> + +<p>#define TIFFPRINT_NONE 0x0 /* no extra info */</p> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_STRIPS</p> +</td> +<td width="10%"> + +<p>0x1</p> +</td> +<td width="48%"> + +<p>/* strips/tiles info */</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_CURVES</p> +</td> +<td width="10%"> + +<p>0x2</p> +</td> +<td width="48%"> + +<p>/* color/gray response curves */</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_COLORMAP</p> +</td> +<td width="10%"> + +<p>0x4</p> +</td> +<td width="48%"> + +<p>/* colormap */</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_JPEGQTABLES</p> +</td> +<td width="10%"> + +<p>0x100</p> +</td> +<td width="48%"> + +<p>/* JPEG Q matrices */</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_JPEGACTABLES</p> +</td> +<td width="10%"> + +<p>0x200</p> +</td> +<td width="48%"> + +<p>/* JPEG AC tables */</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="1%"> + +<p>#define</p> +</td> +<td width="30%"> + +<p>TIFFPRINT_JPEGDCTABLES</p> +</td> +<td width="10%"> + +<p>0x200</p> +</td> +<td width="48%"> + +<p>/* JPEG DC tables */</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>In C++ the <i>flags</i> parameter defaults to 0.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>libtiff</i>(3TIFF), <i>TIFFOpen</i>(3TIFF), +<i>TIFFReadDirectory</i>(3TIFF), +<i>TIFFSetDirectory</i>(3TIFF)</p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFRGBAImage.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFRGBAImage.3tiff.html new file mode 100644 index 0000000..71b7ec8 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFRGBAImage.3tiff.html @@ -0,0 +1,319 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:10 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFRGBAImage</title> +</head> +<body> + +<h1 align=center>TIFFRGBAImage</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#ALTERNATE RASTER FORMATS">ALTERNATE RASTER FORMATS</a><br> +<a href="#SIMULTANEOUS RASTER STORE AND DISPLAY">SIMULTANEOUS RASTER STORE AND DISPLAY</a><br> +<a href="#SUPPORTING ADDITIONAL TIFF FORMATS">SUPPORTING ADDITIONAL TIFF FORMATS</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFRGBAImageOK, TIFFRGBAImageBegin, TIFFRGBAImageGet, +TIFFRGBAImageEnd − read and decode an image into a +raster</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>typedef unsigned char TIFFRGBValue; typedef struct +_TIFFRGBAImage TIFFRGBAImage;</b></p> +<!-- INDENTATION --> +<p><b>int TIFFRGBAImageOK(TIFF *</b><i>tif</i><b>, char</b> +<i>emsg[1024]</i><b>)<br> +int TIFFRGBAImageBegin(TIFFRGBAImage *</b><i>img</i><b>, +TIFF*</b> <i>tif</i><b>, int</b> <i>stopOnError</i><b>, +char</b> <i>emsg[1024]</i><b>)<br> +int TIFFRGBAImageGet(TIFFRGBAImage *</b><i>img</i><b>, +uint32*</b> <i>raster</i><b>, uint32</b> <i>width</i> <b>, +uint32</b> <i>height</i><b>)<br> +void TIFFRGBAImageEnd(TIFFRGBAImage +*</b><i>img</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The routines described here provide a high-level +interface through which <small>TIFF</small> images may be +read into memory. Images may be strip- or tile-based and +have a variety of different characteristics: bits/sample, +samples/pixel, photometric, etc. Decoding state is +encapsulated in a <i>TIFFRGBAImage</i> structure making it +possible to capture state for multiple images and quickly +switch between them. The target raster format can be +customized to a particular application’s needs by +installing custom routines that manipulate image data +according to application requirements.</p> +<!-- INDENTATION --> +<p>The default usage for these routines is: check if an +image can be processed using <i>TIFFRGBAImageOK</i>, +construct a decoder state block using +<i>TIFFRGBAImageBegin</i>, read and decode an image into a +target raster using <i>TIFFRGBAImageGet</i>, and then +release resources using <i>TIFFRGBAImageEnd</i>. +<i>TIFFRGBAImageGet</i> can be called multiple times to +decode an image using different state parameters. If +multiple images are to be displayed and there is not enough +space for each of the decoded rasters, multiple state blocks +can be managed and then calls can be made to +<i>TIFFRGBAImageGet</i> as needed to display an image.</p> +<!-- INDENTATION --> +<p>The generated raster is assumed to be an array of +<i>width</i> times <i>height</i> 32-bit entries, where +<i>width</i> must be less than or equal to the width of the +image (<i>height</i> may be any non-zero size). If the +raster dimensions are smaller than the image, the image data +is cropped to the raster bounds. If the raster height is +greater than that of the image, then the image data are +placed in the lower part of the raster. (Note that the +raster is assume to be organized such that the pixel at +location (<i>x</i>,<i>y</i>) is +<i>raster</i>[<i>y</i>*<i>width</i>+<i>x</i>]; with the +raster origin in the <b>lower-left</b> hand corner.)</p> +<!-- INDENTATION --> +<p>Raster pixels are 8-bit packed red, green, blue, alpha +samples. The macros <i>TIFFGetR</i>, <i>TIFFGetG</i>, +<i>TIFFGetB</i>, and <i>TIFFGetA</i> should be used to +access individual samples. Images without Associated Alpha +matting information have a constant Alpha of 1.0 (255).</p> +<!-- INDENTATION --> +<p><i>TIFFRGBAImageGet</i> converts non-8-bit images by +scaling sample values. Palette, grayscale, bilevel, +<small>CMYK</small> , and YCbCr images are converted to +<small>RGB</small> transparently. Raster pixels are returned +uncorrected by any colorimetry information present in the +directory.</p> +<!-- INDENTATION --> +<p>The parameter <i>stopOnError</i> specifies how to act if +an error is encountered while reading the image. If +<i>stopOnError</i> is non-zero, then an error will terminate +the operation; otherwise <i>TIFFRGBAImageGet</i> will +continue processing data until all the possible data in the +image have been requested.</p> +</td> +</table> +<a name="ALTERNATE RASTER FORMATS"></a> +<h2>ALTERNATE RASTER FORMATS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>To use the core support for reading and processing +<small>TIFF</small> images, but write the resulting raster +data in a different format one need only override the +‘‘<i>put methods</i>’’ used to store +raster data. These methods are are defined in the +<i>TIFFRGBAImage</i> structure and initially setup by +<i>TIFFRGBAImageBegin</i> to point to routines that pack +raster data in the default <small>ABGR</small> pixel format. +Two different routines are used according to the physical +organization of the image data in the file: +<i>PlanarConfiguration</i>=1 (packed samples), and +<i>PlanarConfiguration</i>=2 (separated samples). Note that +this mechanism can be used to transform the data before +storing it in the raster. For example one can convert data +to colormap indices for display on a colormap display.</p> +</td> +</table> +<a name="SIMULTANEOUS RASTER STORE AND DISPLAY"></a> +<h2>SIMULTANEOUS RASTER STORE AND DISPLAY</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>It is simple to display an image as it is being read into +memory by overriding the put methods as described above for +supporting alternate raster formats. Simply keep a reference +to the default put methods setup by +<i>TIFFRGBAImageBegin</i> and then invoke them before or +after each display operation. For example, the +<i>tiffgt</i>(1) utility uses the following put method to +update the display as the raster is being filled:</p> +<!-- INDENTATION --> +<pre>static void +putContigAndDraw(TIFFRGBAImage* img, uint32* raster, + uint32 x, uint32 y, uint32 w, uint32 h, + int32 fromskew, int32 toskew, + unsigned char* cp) +{ + (*putContig)(img, raster, x, y, w, h, fromskew, toskew, cp); + if (x+w == width) { + w = width; + if (img->orientation == ORIENTATION_TOPLEFT) + lrectwrite(0, y-(h-1), w-1, y, raster-x-(h-1)*w); + else + lrectwrite(0, y, w-1, y+h-1, raster); + } +} +</pre> +<!-- INDENTATION --> +<p>(the original routine provided by the library is saved in +the variable <i>putContig</i>.)</p> +</td> +</table> +<a name="SUPPORTING ADDITIONAL TIFF FORMATS"></a> +<h2>SUPPORTING ADDITIONAL TIFF FORMATS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The <i>TIFFRGBAImage</i> routines support the most +commonly encountered flavors of <small>TIFF.</small> It is +possible to extend this support by overriding the +‘‘<i>get method</i>’’ invoked by +<i>TIFFRGBAImageGet</i> to read <small>TIFF</small> image +data. Details of doing this are a bit involved, it is best +to make a copy of an existing get method and modify it to +suit the needs of an application.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Samples must be either 1, 2, 4, 8, or 16 bits. +Colorimetric samples/pixel must be either 1, 3, or 4 (i.e. +<i>SamplesPerPixel</i> minus <i>ExtraSamples</i>).</p> +<!-- INDENTATION --> +<p>Palette image colormaps that appear to be incorrectly +written as 8-bit values are automatically scaled to +16-bits.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All routines return 1 if the operation was successful. +Otherwise, 0 is returned if an error was encountered and +<i>stopOnError</i> is zero.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-bit pictures</b>. The image +had <i>BitsPerSample</i> other than 1, 2, 4, 8, or 16.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-channel images</b>. The image +had <i>SamplesPerPixel</i> other than 1, 3, or 4.</p> +<!-- INDENTATION --> +<p><b>Missing needed "PhotometricInterpretation" +tag</b>. The image did not have a tag that describes how to +display the data.</p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +RGB</b>. The image was missing a tag that describes how to +display it, but because it has 3 or 4 samples/pixel, it is +assumed to be <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +min-is-black</b>. The image was missing a tag that describes +how to display it, but because it has 1 sample/pixel, it is +assumed to be a grayscale or bilevel image.</p> +<!-- INDENTATION --> +<p><b>No space for photometric conversion table</b>. There +was insufficient memory for a table used to convert image +samples to 8-bit <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>Missing required "Colormap" tag</b>. A +Palette image did not have a required <i>Colormap</i> +tag.</p> +<!-- INDENTATION --> +<p><b>No space for tile buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>No space for strip buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>Can not handle format</b>. The image has a format +(combination of <i>BitsPerSample</i>, +<i>SamplesPerPixel</i>, and +<i>PhotometricInterpretation</i>) that can not be +handled.</p> +<!-- INDENTATION --> +<p><b>No space for B&W mapping table</b>. There was +insufficient memory to allocate a table used to map +grayscale data to <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No space for Palette mapping table</b>. There was +insufficient memory to allocate a table used to map data to +8-bit <small>RGB.</small></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFReadRGBAImage</b>(3TIFF), +<b>TIFFReadRGBAImageOriented</b>(3TIFF), +<b>TIFFReadRGBAStrip</b>(3TIFF), +<b>TIFFReadRGBATile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadDirectory.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadDirectory.3tiff.html new file mode 100644 index 0000000..d866352 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadDirectory.3tiff.html @@ -0,0 +1,218 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:09 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadDirectory</title> +</head> +<body> + +<h1 align=center>TIFFReadDirectory</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>TIFFReadDirectory − get the contents of the +next directory in an open</big> TIFF <big>file</big></p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>#include <tiffio.h></b></big></p> +<!-- INDENTATION --> +<p><big><b>int TIFFReadDirectory(TIFF +*</b><i>tif</i><b>)</b></big></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Read the next directory in the specified file and +make it the current directory. Applications only need to +call <i>TIFFReadDirectory</i> to read multiple subfiles in a +single</big> TIFF <big>file— the first directory in a +file is automatically read when <i>TIFFOpen</i> is +called.</big></p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>If the library is compiled with</big> +STRIPCHOP_SUPPORT <big>enabled, then images that have a +single uncompressed strip or tile of data are automatically +treated as if they were made up of multiple strips or tiles +of approximately 8 kilobytes each. This operation is done +only in-memory; it does not alter the contents of the file. +However, the construction of the ‘‘chopped +strips’’ is visible to the application through +the number of strips [tiles] returned by +<i>TIFFNumberOfStrips</i> +[<i>TIFFNumberOfTiles</i>].</big></p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>If the next directory was successfully read, 1 is +returned. Otherwise, 0 is returned if an error was +encountered, or if there are no more directories to be +read.</big></p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine. All warning messages are +directed to the <i>TIFFWarning</i>(3TIFF) routine.</big></p> +<!-- INDENTATION --> +<p><big><b>Seek error accessing TIFF directory</b>. An error +occurred while positioning to the location of the +directory.</big></p> +<!-- INDENTATION --> +<p><big><b>Wrong data type %d for field "%s"</b>. +The tag entry in the directory had an incorrect data type. +For example, an <i>ImageDescription</i> tag with a</big> +SHORT <big>data type.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing required "%s" +field</b>. The specified tag is required to be present by +the</big> TIFF <big>5.0 specification, but is missing. The +directory is (usually) unusable.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: Rational with zero denominator</b>. A +directory tag has a</big> RATIONAL <big>value whose +denominator is zero.</big></p> +<!-- INDENTATION --> +<p><big><b>Incorrect count %d for field "%s" (%lu, +expecting %lu); tag ignored</b>. The specified tag’s +count field is bad. For example, a count other than 1 for a +<i>SubFileType</i> tag.</big></p> +<!-- INDENTATION --> +<p><big><b>Cannot handle different per-sample values for +field "%s"</b>. The tag has <i>SamplesPerPixel</i> +values and they are not all the same; e.g. +<i>BitsPerSample</i>. The library is unable to handle images +of this sort.</big></p> +<!-- INDENTATION --> +<p><big><b>Count mismatch for field "%s"; +expecting %d, got %d</b>. The count field in a tag does not +agree with the number expected by the library. This should +never happen, so if it does, the library refuses to read the +directory.</big></p> +<!-- INDENTATION --> +<p><big><b>Invalid TIFF directory; tags are not sorted in +ascending order</b>. The directory tags are not properly +sorted as specified in the</big> TIFF <big>5.0 +specification. This error is not fatal.</big></p> +<!-- INDENTATION --> +<p><big><b>Ignoring unknown field with tag %d (0x%x)</b>. An +unknown tag was encountered in the directory; the library +ignores all such tags.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing requred +"ImageLength" field</b>. The image violates the +specification by not having a necessary field. There is no +way for the library to recover from this error.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing requred +"PlanarConfig" field</b>. The image violates the +specification by not having a necessary field. There is no +way for the library to recover from this error.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing requred +"StripOffsets" field</b>. The image has multiple +strips, but is missing the tag that specifies the file +offset to each strip of data. There is no way for the +library to recover from this error.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing requred +"TileOffsets" field</b>. The image has multiple +tiles, but is missing the tag that specifies the file offset +to each tile of data. There is no way for the library to +recover from this error.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing required +"StripByteCounts" field</b>. The image has +multiple strips, but is missing the tag that specifies the +size of each strip of data. There is no way for the library +to recover from this error.</big></p> +<!-- INDENTATION --> +<p><big><b>TIFF directory is missing required +"StripByteCounts" field, calculating from +imagelength</b>. The image violates the specification by not +having a necessary field. However, when the image is +comprised of only one strip or tile, the library will +estimate the missing value based on the file size.</big></p> +<!-- INDENTATION --> +<p><big><b>Bogus "StripByteCounts" field, ignoring +and calculating from imagelength</b>. Certain vendors +violate the specification by writing zero for the +StripByteCounts tag when they want to leave the value +unspecified. If the image has a single strip, the library +will estimate the missing value based on the file +size.</big></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteDirectory</b>(3TIFF), +<b>TIFFSetDirectory</b>(3TIFF), +<b>TIFFSetSubDirectory</b>(3TIFF), +<b>libtiff</b>(3TIFF)</big></p> +<!-- INDENTATION --> +<p><big>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></big></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadEncodedStrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadEncodedStrip.3tiff.html new file mode 100644 index 0000000..20798db --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadEncodedStrip.3tiff.html @@ -0,0 +1,133 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:09 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadEncodedStrip</title> +</head> +<body> + +<h1 align=center>TIFFReadEncodedStrip</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>TIFFReadEncodedStrip − read and decode a strip +of data from an open</big> TIFF <big>file</big></p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>#include <tiffio.h></b></big></p> +<!-- INDENTATION --> +<p><big><b>tsize_t TIFFReadEncodedStrip(TIFF +*</b><i>tif</i><b>, tstrip_t</b> <i>strip</i><b>, +tdata_t</b> <i>buf</i><b>, tsize_t</b> +<i>size</i><b>)</b></big></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Read the specified strip of data and place up to +<i>size</i> bytes of decompressed information in the (user +supplied) data buffer.</big></p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The value of <i>strip</i> is a ‘‘raw +strip number.’’ That is, the caller must take +into account whether or not the data are organized in +separate planes (<i>PlanarConfiguration</i>=2). To read a +full strip of data the data buffer should typically be at +least as large as the number returned by +<b>TIFFStripSize</b>(3TIFF). If the -1 passed in <i>size</i> +parameter, the whole strip will be read. You should be sure +you have enough space allocated for the buffer.</big></p> +<!-- INDENTATION --> +<p><big>The library attempts to hide bit- and byte-ordering +differences between the image and the native machine by +converting data to the native machine order. Bit reversal is +done if the <i>FillOrder</i> tag is opposite to the native +machine bit order. 16- and 32-bit samples are automatically +byte-swapped if the file was written with a byte order +opposite to the native machine byte order,</big></p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The actual number of bytes of data that were placed +in <i>buf</i> is returned; <i>TIFFReadEncodedStrip</i> +returns −1 if an error was encountered.</big></p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</big></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFOpen</b>(3TIFF), +<b>TIFFReadRawStrip</b>(3TIFF), +<b>TIFFReadScanline</b>(3TIFF), +<b>libtiff</b>(3TIFF)</big></p> +<!-- INDENTATION --> +<p><big>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></big></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadEncodedTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadEncodedTile.3tiff.html new file mode 100644 index 0000000..378bea8 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadEncodedTile.3tiff.html @@ -0,0 +1,130 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:09 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadEncodedTile</title> +</head> +<body> + +<h1 align=center>TIFFReadEncodedTile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadEncodedTile − read and decode a tile of +data from an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFReadEncodedTile(TIFF *</b><i>tif</i><b>, +u_long</b> <i>tile</i><b>, u_char *</b><i>buf</i><b>, +u_long</b> <i>size</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Read the specified tile of data and place up to +<i>size</i> bytes of decompressed information in the (user +supplied) data buffer.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The value of <i>tile</i> is a ‘‘raw tile +number.’’ That is, the caller must take into +account whether or not the data are organized in separate +planes (<i>PlanarConfiguration</i>=2). +<i>TIFFComputeTile</i> automatically does this when +converting an (x,y,z,sample) coordinate quadruple to a tile +number. To read a full tile of data the data buffer should +be at least as large as the value returned by +<i>TIFFTileSize</i>.</p> +<!-- INDENTATION --> +<p>The library attempts to hide bit- and byte-ordering +differences between the image and the native machine by +converting data to the native machine order. Bit reversal is +done if the <i>FillOrder</i> tag is opposite to the native +machine bit order. 16- and 32-bit samples are automatically +byte-swapped if the file was written with a byte order +opposite to the native machine byte order,</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The actual number of bytes of data that were placed in +<i>buf</i> is returned; <i>TIFFReadEncodedTile</i> returns +−1 if an error was encountered.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFReadRawTile</b>(3TIFF), +<b>TIFFReadTile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadRGBAImage.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadRGBAImage.3tiff.html new file mode 100644 index 0000000..a9a907a --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadRGBAImage.3tiff.html @@ -0,0 +1,301 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:09 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadRGBAImage</title> +</head> +<body> + +<h1 align=center>TIFFReadRGBAImage</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadRGBAImage, TIFFReadRGBAImageOriented − read +and decode an image into a fixed-format raster</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>#define TIFFGetR(abgr) ((abgr) & 0xff)<br> +#define TIFFGetG(abgr) (((abgr) >> 8) & 0xff)<br> +#define TIFFGetB(abgr) (((abgr) >> 16) & 0xff)<br> +#define TIFFGetA(abgr) (((abgr) >> 24) & +0xff)</b></p> +<!-- INDENTATION --> +<p><b>int TIFFReadRGBAImage(TIFF *</b><i>tif</i><b>, +u_long</b> <i>width</i><b>, u_long</b> <i>height</i><b>, +u_long *</b><i>raster</i><b>, int</b> +<i>stopOnError</i><b>)<br> +int TIFFReadRGBAImageOriented(TIFF *</b><i>tif</i><b>, +u_long</b> <i>width</i><b>, u_long</b> <i>height</i><b>, +u_long *</b><i>raster</i><b>, int</b> <i>orientation</i><b>, +int</b> <i>stopOnError</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFReadRGBAImage</i> reads a strip- or tile-based +image into memory, storing the result in the user supplied +<i>raster</i>. The raster is assumed to be an array of +<i>width</i> times <i>height</i> 32-bit entries, where +<i>width</i> must be less than or equal to the width of the +image (<i>height</i> may be any non-zero size). If the +raster dimensions are smaller than the image, the image data +is cropped to the raster bounds. If the raster height is +greater than that of the image, then the image data are +placed in the lower part of the raster. (Note that the +raster is assume to be organized such that the pixel at +location (<i>x</i>,<i>y</i>) is +<i>raster</i>[<i>y</i>*<i>width</i>+<i>x</i>]; with the +raster origin in the lower-left hand corner.)</p> +<!-- INDENTATION --> +<p><i>TIFFReadRGBAImageOriented</i> works like +<i>TIFFReadRGBAImage</i> with except of that user can +specify the raster origin position with the +<i>orientation</i> parameter. Four orientations +supported:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ORIENTATION_TOPLEFT</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>origin in top-left corner,</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ORIENTATION_TOPRIGHT</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>origin in top-right corner,</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ORIENTATION_BOTLEFT</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>origin in bottom-left corner and</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ORIENTATION_BOTRIGHT</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>origin in bottom-right corner.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>If you choose <b>ORIENTATION_BOTLEFT</b> result will be +the same as returned by the <i>TIFFReadRGBAImage.</i></p> +<!-- INDENTATION --> +<p>Raster pixels are 8-bit packed red, green, blue, alpha +samples. The macros <i>TIFFGetR</i>, <i>TIFFGetG</i>, +<i>TIFFGetB</i>, and <i>TIFFGetA</i> should be used to +access individual samples. Images without Associated Alpha +matting information have a constant Alpha of 1.0 (255).</p> +<!-- INDENTATION --> +<p><i>TIFFReadRGBAImage</i> converts non-8-bit images by +scaling sample values. Palette, grayscale, bilevel, +<small>CMYK</small> , and YCbCr images are converted to +<small>RGB</small> transparently. Raster pixels are returned +uncorrected by any colorimetry information present in the +directory.</p> +<!-- INDENTATION --> +<p>The paramater <i>stopOnError</i> specifies how to act if +an error is encountered while reading the image. If +<i>stopOnError</i> is non-zero, then an error will terminate +the operation; otherwise <i>TIFFReadRGBAImage</i> will +continue processing data until all the possible data in the +image have been requested.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>In C++ the <i>stopOnError</i> parameter defaults to +0.</p> +<!-- INDENTATION --> +<p>Samples must be either 1, 2, 4, 8, or 16 bits. +Colorimetric samples/pixel must be either 1, 3, or 4 (i.e. +<i>SamplesPerPixel</i> minus <i>ExtraSamples</i>).</p> +<!-- INDENTATION --> +<p>Palettte image colormaps that appear to be incorrectly +written as 8-bit values are automatically scaled to +16-bits.</p> +<!-- INDENTATION --> +<p><i>TIFFReadRGBAImage</i> is just a wrapper around the +more general <i>TIFFRGBAImage</i>(3TIFF) facilities.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned if the image was successfully read and +converted. Otherwise, 0 is returned if an error was +encountered and <i>stopOnError</i> is zero.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-bit pictures</b>. The image +had <i>BitsPerSample</i> other than 1, 2, 4, 8, or 16.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-channel images</b>. The image +had <i>SamplesPerPixel</i> other than 1, 3, or 4.</p> +<!-- INDENTATION --> +<p><b>Missing needed "PhotometricInterpretation" +tag</b>. The image did not have a tag that describes how to +display the data.</p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +RGB</b>. The image was missing a tag that describes how to +display it, but because it has 3 or 4 samples/pixel, it is +assumed to be <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +min-is-black</b>. The image was missing a tag that describes +how to display it, but because it has 1 sample/pixel, it is +assumed to be a grayscale or bilevel image.</p> +<!-- INDENTATION --> +<p><b>No space for photometric conversion table</b>. There +was insufficient memory for a table used to convert image +samples to 8-bit <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>Missing required "Colormap" tag</b>. A +Palette image did not have a required <i>Colormap</i> +tag.</p> +<!-- INDENTATION --> +<p><b>No space for tile buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>No space for strip buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>Can not handle format</b>. The image has a format +(combination of <i>BitsPerSample</i>, +<i>SamplesPerPixel</i>, and +<i>PhotometricInterpretation</i>) that +<i>TIFFReadRGBAImage</i> can not handle.</p> +<!-- INDENTATION --> +<p><b>No space for B&W mapping table</b>. There was +insufficient memory to allocate a table used to map +grayscale data to <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No space for Palette mapping table</b>. There was +insufficient memory to allocate a table used to map data to +8-bit <small>RGB.</small></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFRGBAImage</b>(3TIFF), +<b>TIFFReadRGBAStrip</b>(3TIFF), +<b>TIFFReadRGBATile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadRGBAStrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadRGBAStrip.3tiff.html new file mode 100644 index 0000000..3ec0776 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadRGBAStrip.3tiff.html @@ -0,0 +1,208 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:10 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadRGBAStrip</title> +</head> +<body> + +<h1 align=center>TIFFReadRGBAStrip</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadRGBAStrip − read and decode an image strip +into a fixed-format raster</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>#define TIFFGetR(abgr) ((abgr) & 0xff)<br> +#define TIFFGetG(abgr) (((abgr) >> 8) & 0xff)<br> +#define TIFFGetB(abgr) (((abgr) >> 16) & 0xff)<br> +#define TIFFGetA(abgr) (((abgr) >> 24) & +0xff)</b></p> +<!-- INDENTATION --> +<p><b>int TIFFReadRGBAStrip(TIFF *</b><i>tif</i><b>, +uint32</b> <i>row</i><b>, uint32 +*</b><i>raster</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFReadRGBAStrip</i> reads a single strip of a +strip-based image into memory, storing the result in the +user supplied RGBA <i>raster</i>. The raster is assumed to +be an array of width times rowsperstrip 32-bit entries, +where width is the width of the image (TIFFTAG_IMAGEWIDTH) +and rowsperstrip is the maximum lines in a strip +(TIFFTAG_ROWSPERSTRIP).</p> +<!-- INDENTATION --> +<p>The <i>row</i> value should be the row of the first row +in the strip (strip * rowsperstrip, zero based).</p> +<!-- INDENTATION --> +<p>Note that the raster is assume to be organized such that +the pixel at location (<i>x</i>,<i>y</i>) is +<i>raster</i>[<i>y</i>*<i>width</i>+<i>x</i>]; with the +raster origin in the <i>lower-left hand corner</i> of the +strip. That is bottom to top organization. When reading a +partial last strip in the file the last line of the image +will begin at the beginning of the buffer.</p> +<!-- INDENTATION --> +<p>Raster pixels are 8-bit packed red, green, blue, alpha +samples. The macros <i>TIFFGetR</i>, <i>TIFFGetG</i>, +<i>TIFFGetB</i>, and <i>TIFFGetA</i> should be used to +access individual samples. Images without Associated Alpha +matting information have a constant Alpha of 1.0 (255).</p> +<!-- INDENTATION --> +<p>See the <i>TIFFRGBAImage</i>(3TIFF) page for more details +on how various image types are converted to RGBA values.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Samples must be either 1, 2, 4, 8, or 16 bits. +Colorimetric samples/pixel must be either 1, 3, or 4 (i.e. +<i>SamplesPerPixel</i> minus <i>ExtraSamples</i>).</p> +<!-- INDENTATION --> +<p>Palette image colormaps that appear to be incorrectly +written as 8-bit values are automatically scaled to +16-bits.</p> +<!-- INDENTATION --> +<p><i>TIFFReadRGBAStrip</i> is just a wrapper around the +more general <i>TIFFRGBAImage</i>(3TIFF) facilities. +It’s main advantage over the similar +<i>TIFFReadRGBAImage()</i> function is that for large images +a single buffer capable of holding the whole image +doesn’t need to be allocated, only enough for one +strip. The <i>TIFFReadRGBATile()</i> function does a similar +operation for tiled images.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned if the image was successfully read and +converted. Otherwise, 0 is returned if an error was +encountered.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-bit pictures</b>. The image +had <i>BitsPerSample</i> other than 1, 2, 4, 8, or 16.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-channel images</b>. The image +had <i>SamplesPerPixel</i> other than 1, 3, or 4.</p> +<!-- INDENTATION --> +<p><b>Missing needed "PhotometricInterpretation" +tag</b>. The image did not have a tag that describes how to +display the data.</p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +RGB</b>. The image was missing a tag that describes how to +display it, but because it has 3 or 4 samples/pixel, it is +assumed to be <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +min-is-black</b>. The image was missing a tag that describes +how to display it, but because it has 1 sample/pixel, it is +assumed to be a grayscale or bilevel image.</p> +<!-- INDENTATION --> +<p><b>No space for photometric conversion table</b>. There +was insufficient memory for a table used to convert image +samples to 8-bit <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>Missing required "Colormap" tag</b>. A +Palette image did not have a required <i>Colormap</i> +tag.</p> +<!-- INDENTATION --> +<p><b>No space for tile buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>No space for strip buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>Can not handle format</b>. The image has a format +(combination of <i>BitsPerSample</i>, +<i>SamplesPerPixel</i>, and +<i>PhotometricInterpretation</i>) that +<i>TIFFReadRGBAImage</i> can not handle.</p> +<!-- INDENTATION --> +<p><b>No space for B&W mapping table</b>. There was +insufficient memory to allocate a table used to map +grayscale data to <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No space for Palette mapping table</b>. There was +insufficient memory to allocate a table used to map data to +8-bit <small>RGB.</small></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFRGBAImage</b>(3TIFF), +<b>TIFFReadRGBAImage</b>(3TIFF), +<b>TIFFReadRGBATile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadRGBATile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadRGBATile.3tiff.html new file mode 100644 index 0000000..cff9142 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadRGBATile.3tiff.html @@ -0,0 +1,261 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:10 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadRGBATile</title> +</head> +<body> + +<h1 align=center>TIFFReadRGBATile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadRGBATile − read and decode an image tile +into a fixed-format raster</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="-2%"> + +<p><b>#define TIFFGetR(abgr)</b></p> +</td> +<td width="25%"></td> +<td width="6%"></td> +<td width="61%"> + +<p><b>((abgr) & 0xff)</b></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="-2%"> + +<p><b>#define TIFFGetG(abgr)</b></p> +</td> +<td width="25%"></td> +<td width="6%"></td> +<td width="61%"> + +<p><b>(((abgr) >> 8) & 0xff)</b></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="-2%"> + +<p><b>#define TIFFGetB(abgr)</b></p> +</td> +<td width="25%"></td> +<td width="6%"></td> +<td width="61%"> + +<p><b>(((abgr) >> 16) & 0xff)</b></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="-2%"> + +<p><b>#define TIFFGetA(abgr)</b></p> +</td> +<td width="25%"></td> +<td width="6%"></td> +<td width="61%"> + +<p><b>(((abgr) >> 24) & 0xff)</b></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>int TIFFReadRGBATile(TIFF *</b><i>tif</i><b>, +uint32</b> <i>x</i><b>, uint32</b> <i>y</i><b>, uint32 +*</b><i>raster</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFReadRGBATile</i> reads a single tile of a +tile-based image into memory, storing the result in the user +supplied RGBA <i>raster</i>. The raster is assumed to be an +array of width times length 32-bit entries, where width is +the width of a tile (TIFFTAG_TILEWIDTH) and length is the +height of a tile (TIFFTAG_TILELENGTH).</p> +<!-- INDENTATION --> +<p>The <i>x</i> and <i>y</i> values are the offsets from the +top left corner to the top left corner of the tile to be +read. They must be an exact multiple of the tile width and +length.</p> +<!-- INDENTATION --> +<p>Note that the raster is assume to be organized such that +the pixel at location (<i>x</i>,<i>y</i>) is +<i>raster</i>[<i>y</i>*<i>width</i>+<i>x</i>]; with the +raster origin in the <i>lower-left hand corner</i> of the +tile. That is bottom to top organization. Edge tiles which +partly fall off the image will be filled out with +appropriate zeroed areas.</p> +<!-- INDENTATION --> +<p>Raster pixels are 8-bit packed red, green, blue, alpha +samples. The macros <i>TIFFGetR</i>, <i>TIFFGetG</i>, +<i>TIFFGetB</i>, and <i>TIFFGetA</i> should be used to +access individual samples. Images without Associated Alpha +matting information have a constant Alpha of 1.0 (255).</p> +<!-- INDENTATION --> +<p>See the <i>TIFFRGBAImage</i>(3TIFF) page for more details +on how various image types are converted to RGBA values.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Samples must be either 1, 2, 4, 8, or 16 bits. +Colorimetric samples/pixel must be either 1, 3, or 4 (i.e. +<i>SamplesPerPixel</i> minus <i>ExtraSamples</i>).</p> +<!-- INDENTATION --> +<p>Palette image colormaps that appear to be incorrectly +written as 8-bit values are automatically scaled to +16-bits.</p> +<!-- INDENTATION --> +<p><i>TIFFReadRGBATile</i> is just a wrapper around the more +general <i>TIFFRGBAImage</i>(3TIFF) facilities. It’s +main advantage over the similar <i>TIFFReadRGBAImage()</i> +function is that for large images a single buffer capable of +holding the whole image doesn’t need to be allocated, +only enough for one tile. The <i>TIFFReadRGBAStrip()</i> +function does a similar operation for stripped images.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned if the image was successfully read and +converted. Otherwise, 0 is returned if an error was +encountered.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-bit pictures</b>. The image +had <i>BitsPerSample</i> other than 1, 2, 4, 8, or 16.</p> +<!-- INDENTATION --> +<p><b>Sorry, can not handle %d-channel images</b>. The image +had <i>SamplesPerPixel</i> other than 1, 3, or 4.</p> +<!-- INDENTATION --> +<p><b>Missing needed "PhotometricInterpretation" +tag</b>. The image did not have a tag that describes how to +display the data.</p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +RGB</b>. The image was missing a tag that describes how to +display it, but because it has 3 or 4 samples/pixel, it is +assumed to be <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No "PhotometricInterpretation" tag, assuming +min-is-black</b>. The image was missing a tag that describes +how to display it, but because it has 1 sample/pixel, it is +assumed to be a grayscale or bilevel image.</p> +<!-- INDENTATION --> +<p><b>No space for photometric conversion table</b>. There +was insufficient memory for a table used to convert image +samples to 8-bit <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>Missing required "Colormap" tag</b>. A +Palette image did not have a required <i>Colormap</i> +tag.</p> +<!-- INDENTATION --> +<p><b>No space for tile buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>No space for strip buffer</b>. There was insufficient +memory to allocate an i/o buffer.</p> +<!-- INDENTATION --> +<p><b>Can not handle format</b>. The image has a format +(combination of <i>BitsPerSample</i>, +<i>SamplesPerPixel</i>, and +<i>PhotometricInterpretation</i>) that +<i>TIFFReadRGBAImage</i> can not handle.</p> +<!-- INDENTATION --> +<p><b>No space for B&W mapping table</b>. There was +insufficient memory to allocate a table used to map +grayscale data to <small>RGB.</small></p> +<!-- INDENTATION --> +<p><b>No space for Palette mapping table</b>. There was +insufficient memory to allocate a table used to map data to +8-bit <small>RGB.</small></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFRGBAImage</b>(3TIFF), +<b>TIFFReadRGBAImage</b>(3TIFF), +<b>TIFFReadRGBAStrip</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadRawStrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadRawStrip.3tiff.html new file mode 100644 index 0000000..4d9433d --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadRawStrip.3tiff.html @@ -0,0 +1,109 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:09 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadRawStrip</title> +</head> +<body> + +<h1 align=center>TIFFReadRawStrip</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadRawStrip − return the undecoded contents of +a strip of data from an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFReadRawStrip(TIFF *</b><i>tif</i><b>, +tstrip_t</b> <i>strip</i><b>, tdata_t</b> <i>buf</i><b>, +tsize_t</b> <i>size</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Read the contents of the specified strip into the (user +supplied) data buffer. Note that the value of <i>strip</i> +is a ‘‘raw strip number.’’ That is, +the caller must take into account whether or not the data is +organized in separate planes (<i>PlanarConfiguration</i>=2). +To read a full strip of data the data buffer should +typically be at least as large as the number returned by +<i>TIFFStripSize</i>.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The actual number of bytes of data that were placed in +<i>buf</i> is returned; <i>TIFFReadEncodedStrip</i> returns +−1 if an error was encountered.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFReadEncodedStrip</b>(3TIFF), +<b>TIFFReadScanline</b>(3TIFF), <b>TIFFStripSize</b>(3TIFF), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadRawTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadRawTile.3tiff.html new file mode 100644 index 0000000..916dc2e --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadRawTile.3tiff.html @@ -0,0 +1,111 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:09 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadRawTile</title> +</head> +<body> + +<h1 align=center>TIFFReadRawTile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadRawTile − return an undecoded tile of data +from an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFReadRawTile(TIFF *</b><i>tif</i><b>, +ttile_t</b> <i>tile</i><b>, tdata_t</b> <i>buf</i><b>, +tsize_t</b> <i>size</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Read the contents of the specified tile into the (user +supplied) data buffer. Note that the value of <i>tile</i> is +a ‘‘raw tile number.’’ That is, the +caller must take into account whether or not the data is +organized in separate planes (<i>PlanarConfiguration</i>=2). +<i>TIFFComputeTile</i> automatically does this when +converting an (x,y,z,sample) coordinate quadruple to a tile +number. To read a full tile of data the data buffer should +typically be at least as large as the value returned by +<i>TIFFTileSize</i>.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The actual number of bytes of data that were placed in +<i>buf</i> is returned; <i>TIFFReadEncodedTile</i> returns +−1 if an error was encountered.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFReadEncodedTile</b>(3TIFF), +<b>TIFFReadTile</b>(3TIFF), <b>TIFFTileSize</b>(3TIFF), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadScanline.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadScanline.3tiff.html new file mode 100644 index 0000000..3ecf88c --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadScanline.3tiff.html @@ -0,0 +1,157 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:10 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadScanline</title> +</head> +<body> + +<h1 align=center>TIFFReadScanline</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadScanline − read and decode a scanline of +data from an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFReadScanline(TIFF *</b><i>tif</i><b>, +tdata_t</b> <i>buf</i><b>, uint32</b> <i>row</i><b>, +tsample_t</b> <i>sample</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Read the data for the specified row into the (user +supplied) data buffer <i>buf</i>. The data are returned +decompressed and, in the native byte- and bit-ordering, but +are otherwise packed (see further below). The buffer must be +large enough to hold an entire scanline of data. +Applications should call the routine <i>TIFFScanlineSize</i> +to find out the size (in bytes) of a scanline buffer. The +<i>row</i> parameter is always used by +<i>TIFFReadScanline</i>; the <i>sample</i> parameter is used +only if data are organized in separate planes +(<i>PlanarConfiguration</i>=2).</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The library attempts to hide bit- and byte-ordering +differences between the image and the native machine by +converting data to the native machine order. Bit reversal is +done if the <i>FillOrder</i> tag is opposite to the native +machine bit order. 16- and 32-bit samples are automatically +byte-swapped if the file was written with a byte order +opposite to the native machine byte order,</p> +<!-- INDENTATION --> +<p>In C++ the <i>sample</i> parameter defaults to 0.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFReadScanline</i> returns −1 if it detects an +error; otherwise 1 is returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Compression algorithm does not support random +access</b>. Data was requested in a non-sequential order +from a file that uses a compression algorithm and that has +<i>RowsPerStrip</i> greater than one. That is, data in the +image is stored in a compressed form, and with multiple rows +packed into a strip. In this case, the library does not +support random access to the data. The data should either be +accessed sequentially, or the file should be converted so +that each strip is made up of one row of data.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Reading subsampled YCbCR data does not work correctly +because, for <i>PlanarConfiguration</i>=2 the size of a +scanline is not calculated on a per-sample basis, and for +<i>PlanarConfiguration</i>=1 the library does not unpack the +block-interleaved samples; use the strip- and tile-based +interfaces to read these formats.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFReadEncodedStrip</b>(3TIFF), +<b>TIFFReadRawStrip</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFReadTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFReadTile.3tiff.html new file mode 100644 index 0000000..f278d8d --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFReadTile.3tiff.html @@ -0,0 +1,133 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:10 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFReadTile</title> +</head> +<body> + +<h1 align=center>TIFFReadTile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadTile − read and decode a tile of data from +an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFReadTile(TIFF *</b><i>tif</i><b>, +tdata_t</b> <i>buf</i><b>, uint32</b> <i>x</i><b>, +uint32</b> <i>y</i><b>, uint32</b> <i>z</i><b>, +tsample_t</b> <i>sample</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Return the data for the tile <i>containing</i> the +specified coordinates. The data placed in <i>buf</i> are +returned decompressed and, typically, in the native byte- +and bit-ordering, but are otherwise packed (see further +below). The buffer must be large enough to hold an entire +tile of data. Applications should call the routine +<i>TIFFTileSize</i> to find out the size (in bytes) of a +tile buffer. The <i>x</i> and <i>y</i> parameters are always +used by <i>TIFFReadTile</i>. The <i>z</i> parameter is used +if the image is deeper than 1 slice +(<i>ImageDepth</i>>1). The <i>sample</i> parameter is +used only if data are organized in separate planes +(<i>PlanarConfiguration</i>=2).</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The library attempts to hide bit- and byte-ordering +differences between the image and the native machine by +converting data to the native machine order. Bit reversal is +done if the <i>FillOrder</i> tag is opposite to the native +machine bit order. 16- and 32-bit samples are automatically +byte-swapped if the file was written with a byte order +opposite to the native machine byte order,</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFReadTile</i> returns −1 if it detects an +error; otherwise the number of bytes in the decoded tile is +returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFCheckTile</b>(3TIFF), +<b>TIFFComputeTile</b>(3TIFF), <b>TIFFOpen</b>(3TIFF), +<b>TIFFReadEncodedTile</b>(3TIFF), +<b>TIFFReadRawTile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFSetDirectory.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFSetDirectory.3tiff.html new file mode 100644 index 0000000..1796853 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFSetDirectory.3tiff.html @@ -0,0 +1,122 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:10 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSetDirectory</title> +</head> +<body> + +<h1 align=center>TIFFSetDirectory</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFSetDirectory, TIFFSetSubDirectory − set the +current directory for an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFSetDirectory(TIFF *</b><i>tif</i><b>, +tdir_t</b> <i>dirnum</i><b>)<br> +int TIFFSetSubDirectory(TIFF *</b><i>tif</i><b>, uint32</b> +<i>diroff</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFSetDirectory</i> changes the current directory and +reads its contents with <i>TIFFReadDirectory</i>. The +parameter <i>dirnum</i> specifies the subfile/directory as +an integer number, with the first directory numbered +zero.</p> +<!-- INDENTATION --> +<p><i>TIFFSetSubDirectory</i> acts like +<i>TIFFSetDirectory</i>, except the directory is specified +as a file offset instead of an index; this is required for +accessing subdirectories linked through a <i>SubIFD</i> +tag.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>On successful return 1 is returned. Otherwise, 0 is +returned if <i>dirnum</i> or <i>diroff</i> specifies a +non-existent directory, or if an error was encountered while +reading the directory’s contents.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>%s: Error fetching directory count</b>. An error was +encountered while reading the ‘‘directory +count’’ field.</p> +<!-- INDENTATION --> +<p><b>%s: Error fetching directory link</b>. An error was +encountered while reading the ‘‘link +value’’ that points to the next directory in a +file.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFCurrentDirectory</i>(3TIFF), +<i>TIFFOpen</i>(3TIFF), <i>TIFFReadDirectory</i>(3TIFF), +<i>TIFFWriteDirectory</i>(3TIFF), <i>libtiff</i>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFSetField.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFSetField.3tiff.html new file mode 100644 index 0000000..ad938cd --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFSetField.3tiff.html @@ -0,0 +1,1362 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:10 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSetField</title> +</head> +<body> + +<h1 align=center>TIFFSetField</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFSetField, TIFFVSetField − set the value(s) of a +tag in a <small>TIFF</small> file open for writing</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFSetField(TIFF *</b><i>tif</i><b>, ttag_t</b> +<i>tag</i><b>,</b> <i>...</i><b>)</b></p> +<!-- INDENTATION --> +<p><b>#include <stdarg.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFVSetField(TIFF *</b><i>tif</i><b>, ttag_t</b> +<i>tag</i><b>, va_list</b> <i>ap</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFSetField</i> sets the value of a field or +pseudo-tag in the current directory associated with the open +<small>TIFF</small> file <i>tif</i>. (A <i>pseudo-tag</i> is +a parameter that is used to control the operation of the +<small>TIFF</small> library but whose value is not read or +written to the underlying file.) To set the value of a field +the file must have been previously opened for writing with +<i>TIFFOpen</i>(3TIFF); pseudo-tags can be set whether the +file was opened for reading or writing. The field is +identified by <i>tag</i>, one of the values defined in the +include file <b>tiff.h</b> (see also the table below). The +actual value is specified using a variable argument list, as +prescribed by the <i>stdarg</i>(3) interface (or, on some +machines, the <i>varargs</i>(3) interface.)</p> +<!-- INDENTATION --> +<p><i>TIFFVSetField</i> is functionally equivalent to +<i>TIFFSetField</i> except that it takes a pointer to a +variable argument list. <i>TIFFVSetField</i> is useful for +writing routines that are layered on top of the +functionality provided by <i>TIFFSetField</i>.</p> +<!-- INDENTATION --> +<p>The tags understood by <i>libtiff</i>, the number of +parameter values, and the expected types for the parameter +values are shown below. The data types are: <i>char*</i> is +null-terminated string and corresponds to the +<small>ASCII</small> data type; <i>uint16</i> is an unsigned +16-bit value; <i>uint32</i> is an unsigned 32-bit value; +<i>uint16*</i> is an array of unsigned 16-bit values. +<i>void*</i> is an array of data values of unspecified +type.</p> +<!-- INDENTATION --> +<p>Consult the <small>TIFF</small> specification for +information on the meaning of each tag.</p></td> +</table> +<!-- TABS --> + +<p><i>Tag Name Count Types Notes</i></p> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ARTIST</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_BADFAXLINES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_BITSPERSAMPLE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_CLEANFAXDATA</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COLORMAP</p> +</td> +<td width="8%"> + +<p>3</p> +</td> +<td width="24%"> + +<p>uint16*</p> +</td> +<td width="16%"> + +<p>1<<BitsPerSample arrays</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COMPRESSION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_CONSECUTIVEBADFAXLINES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_COPYRIGHT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DATETIME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DOCUMENTNAME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_DOTRANGE</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_EXTRASAMPLES</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16,uint16*</p> +</td> +<td width="16%"> + +<p>† count & types array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FAXFILLFUNC</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>TIFFFaxFillFunc</p> +</td> +<td width="16%"> + +<p>G3/G4 compression pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FAXMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>int</p> +</td> +<td width="16%"> + +<p>† G3/G4 compression pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_FILLORDER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_GROUP3OPTIONS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_GROUP4OPTIONS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_HALFTONEHINTS</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_HOSTCOMPUTER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ICCPROFILE</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint32,void*</p> +</td> +<td width="16%"> + +<p>count, profile data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEDEPTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEDESCRIPTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGELENGTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_IMAGEWIDTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_INKNAMES</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16, char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_INKSET</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGCOLORMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>int</p> +</td> +<td width="16%"> + +<p>† JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGQUALITY</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>int</p> +</td> +<td width="16%"> + +<p>JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGTABLES</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint32*,void*</p> +</td> +<td width="16%"> + +<p>† count & tables</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_JPEGTABLESMODE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>int</p> +</td> +<td width="16%"> + +<p>† JPEG pseudo-tag</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MAKE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MATTEING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MAXSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MINSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_MODEL</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ORIENTATION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PAGENAME</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PAGENUMBER</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PHOTOMETRIC</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PHOTOSHOP</p> +</td> +<td width="8%"> + +<p>?</p> +</td> +<td width="24%"> + +<p>uint32,void*</p> +</td> +<td width="16%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PLANARCONFIG</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PREDICTOR</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_PRIMARYCHROMATICITIES</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float*</p> +</td> +<td width="16%"> + +<p>6-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_REFERENCEBLACKWHITE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float*</p> +</td> +<td width="16%"> + +<p>† 2*SamplesPerPixel array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_RESOLUTIONUNIT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_RICHTIFFIPTC</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint32,void*</p> +</td> +<td width="16%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_ROWSPERSTRIP</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>† must be > 0</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SAMPLEFORMAT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SAMPLESPERPIXEL</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>† value must be <= 4</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SMAXSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>double</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SMINSAMPLEVALUE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>double</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SOFTWARE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_STONITS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>double</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SUBFILETYPE</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_SUBIFD</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16,uint32*</p> +</td> +<td width="16%"> + +<p>count & offsets array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TARGETPRINTER</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>char*</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_THRESHHOLDING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEDEPTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILELENGTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>† must be a multiple of 8</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TILEWIDTH</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint32</p> +</td> +<td width="16%"> + +<p>† must be a multiple of 8</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_TRANSFERFUNCTION</p> +</td> +<td width="8%"> + +<p>1 or 3‡ uint16*</p> +</td> +<td width="24%"></td> +<td width="16%"> + +<p>1<<BitsPerSample entry arrays</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_WHITEPOINT</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float*</p> +</td> +<td width="16%"> + +<p>2-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XMLPACKET</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint32,void*</p> +</td> +<td width="16%"> + +<p>count, data</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XPOSITION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_XRESOLUTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRCOEFFICIENTS</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float*</p> +</td> +<td width="16%"> + +<p>† 3-entry array</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRPOSITIONING</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YCBCRSAMPLING</p> +</td> +<td width="8%"> + +<p>2</p> +</td> +<td width="24%"> + +<p>uint16</p> +</td> +<td width="16%"> + +<p>†</p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YPOSITION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float</p> +</td> +<td width="16%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="41%"> + +<p>TIFFTAG_YRESOLUTION</p> +</td> +<td width="8%"> + +<p>1</p> +</td> +<td width="24%"> + +<p>float</p> +</td> +<td width="16%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>† Tag may not have its values changed once data is +written.<br> +‡ If <i>SamplesPerPixel</i> is one, then a single +array is passed; otherwise three arrays should be +passed.<br> +* The contents of this field are quite complex. See <b>The +ICC Profile Format Specification</b>, Annex B.3 +"Embedding ICC Profiles in TIFF Files" (available +at http://www.color.org) for an explanation.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned if the operation was successful. Otherwise, +0 is returned if an error was detected.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>%s: Cannot modify tag "%s" while +writing</b>. Data has already been written to the file, so +the specified tag’s value can not be changed. This +restriction is applied to all tags that affect the format of +written data.</p> +<!-- INDENTATION --> +<p><b>%d: Bad value for "%s"</b>. An invalid value +was supplied for the named tag.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFGetField</b>(3TIFF), +<b>TIFFSetDirectory</b>(3TIFF), +<b>TIFFWriteDirectory</b>(3TIFF), +<b>TIFFReadDirectory</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWarning.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWarning.3tiff.html new file mode 100644 index 0000000..d030df4 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWarning.3tiff.html @@ -0,0 +1,108 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:11 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWarning</title> +</head> +<body> + +<h1 align=center>TIFFWarning</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWarning, TIFFSetWarningHandler − library +warning interface</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>void TIFFWarning(const char *</b><i>module</i><b>, +const char *</b><i>fmt</i><b>,</b> <i>...</i><b>)</b></p> +<!-- INDENTATION --> +<p><b>#include <stdargh.h></b></p> +<!-- INDENTATION --> +<p><b>typedef void (*TIFFWarningHandler)(const char +*</b><i>module</i><b>, const char *</b><i>fmt</i><b>, +va_list</b> <i>ap</i><b>);</b></p> +<!-- INDENTATION --> +<p><b>TIFFWarningHandler +TIFFSetWarningHandler(TIFFWarningHandler</b> +<i>handler</i><b>);</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFWarning</i> invokes the library-wide warning +handler function to (normally) write a warning message to +the <b>stderr</b>. The <i>fmt</i> parameter is a +<i>printf</i>(3S) format string, and any number arguments +can be supplied. The <i>module</i> parameter is interpreted +as a string that, if non-zero, should be printed before the +message; it typically is used to identify the software +module in which a warning is detected.</p> +<!-- INDENTATION --> +<p>Applications that desire to capture control in the event +of a warning should use <i>TIFFSetWarningHandler</i> to +override the default warning handler. A <small>NULL</small> +(0) warning handler function may be installed to suppress +error messages.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFSetWarningHandler</i> returns a reference to the +previous error handling function.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFError</b>(3TIFF), <b>libtiff</b>(3TIFF), +<b>printf</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteDirectory.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteDirectory.3tiff.html new file mode 100644 index 0000000..ba22c0e --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteDirectory.3tiff.html @@ -0,0 +1,176 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:11 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteDirectory</title> +</head> +<body> + +<h1 align=center>TIFFWriteDirectory</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWriteDirectory, TIFFRewriteDirectory, +TIFFCheckpointDirectory − write the current directory +in an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFWriteDirectory(TIFF *</b><i>tif</i><b>)<br> +int TIFFRewriteDirectory(TIFF *</b><i>tif</i><b>)<br> +int TIFFCheckpointDirectory(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFWriteDirectory</i> will write the contents of the +current directory to the file and setup to create a new +subfile in the same file. Applications only need to call +<i>TIFFWriteDirectory</i> when writing multiple subfiles to +a single <small>TIFF</small> file. <i>TIFFWriteDirectory</i> +is automatically called by <i>TIFFClose</i> and +<i>TIFFFlush</i> to write a modified directory if the file +is open for writing.</p> +<!-- INDENTATION --> +<p>The <i>TIFFRewriteDirectory</i> function operates +similarly to <i>TIFFWriteDirectory,</i> but can be called +with directories previously read or written that already +have an established location in the file. It will rewrite +the directory, but instead of place it at it’s old +location (as <i>TIFFWriteDirectory</i> would) it will place +them at the end of the file, correcting the pointer from the +preceeding directory or file header to point to it’s +new location. This is particularly important in cases where +the size of the directory and pointed to data has grown, so +it won’t fit in the space available at the old +location.</p> +<!-- INDENTATION --> +<p>The <i>TIFFCheckpointDirectory</i> writes the current +state of the tiff directory into the file to make what is +currently in the file readable. Unlike +<i>TIFFWriteDirectory, TIFFCheckpointDirectory</i> does not +free up the directory data structures in memory, so they can +be updated (as strips/tiles are written) and written again. +Reading such a partial file you will at worst get a tiff +read error for the first strip/tile encountered that is +incomplete, but you will at least get all the valid data in +the file before that. When the file is complete, just use +<i>TIFFWriteDirectory</i> as usual to finish it off +cleanly.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>1 is returned when the contents are successfully written +to the file. Otherwise, 0 is returned if an error was +encountered when writing the directory contents.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>Error post-encoding before directory write</b>. Before +writing the contents of the current directory, any pending +data are flushed. This message indicates that an error +occurred while doing this.</p> +<!-- INDENTATION --> +<p><b>Error flushing data before directory write</b>. Before +writing the contents of the current directory, any pending +data are flushed. This message indicates that an error +occurred while doing this.</p> +<!-- INDENTATION --> +<p><b>Cannot write directory, out of space</b>. There was +not enough space to allocate a temporary area for the +directory that was to be written.</p> +<!-- INDENTATION --> +<p><b>Error writing directory count</b>. A write error +occurred when writing the count of fields in the +directory.</p> +<!-- INDENTATION --> +<p><b>Error writing directory contents</b>. A write error +occurred when writing the directory fields.</p> +<!-- INDENTATION --> +<p><b>Error writing directory link</b>. A write error +occurred when writing the link to the next directory.</p> +<!-- INDENTATION --> +<p><b>Error writing data for field "%s"</b>. A +write error occurred when writing indirect data for the +specified field.</p> +<!-- INDENTATION --> +<p><b>Error writing TIFF header</b>. A write error occurred +when re-writing header at the front of the file.</p> +<!-- INDENTATION --> +<p><b>Error fetching directory count</b>. A read error +occurred when fetching the directory count field for a +previous directory. This can occur when setting up a link to +the directory that is being written.</p> +<!-- INDENTATION --> +<p><b>Error fetching directory link</b>. A read error +occurred when fetching the directory link field for a +previous directory. This can occur when setting up a link to +the directory that is being written.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFError</b>(3TIFF), +<b>TIFFReadDirectory</b>(3TIFF), +<b>TIFFSetDirectory</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteEncodedStrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteEncodedStrip.3tiff.html new file mode 100644 index 0000000..78c4e76 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteEncodedStrip.3tiff.html @@ -0,0 +1,153 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:11 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteEncodedStrip</title> +</head> +<body> + +<h1 align=center>TIFFWriteEncodedStrip</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>TIFFWritedEncodedStrip − compress and write a +strip of data to an open</big> TIFF <big>file</big></p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>#include <tiffio.h></b></big></p> +<!-- INDENTATION --> +<p><big><b>tsize_t TIFFWriteEncodedStrip(TIFF +*</b><i>tif</i><b>, tstrip_t</b> <i>strip</i><b>, +tdata_t</b> <i>buf</i><b>, tsize_t</b> +<i>size</i><b>)</b></big></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Compress <i>size</i> bytes of raw data from +<i>buf</i> and write the result to the specified strip; +replacing any previously written data. Note that the value +of <i>strip</i> is a ‘‘raw strip +number.’’ That is, the caller must take into +account whether or not the data are organized in separate +planes (<i>PlanarConfiguration</i>=2).</big></p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The library writes encoded data using the native +machine byte order. Correctly implemented</big> TIFF +<big>readers are expected to do any necessary byte-swapping +to correctly process image data with BitsPerSample greater +than 8.</big></p> +<!-- INDENTATION --> +<p><big>The strip number must be valid according to the +current settings of the <i>ImageLength</i> and +<i>RowsPerStrip</i> tags. An image may be dynamically grown +by increasing the value of <i>ImageLength</i> prior to each +call to <i>TIFFWriteEncodedStrip</i>.</big></p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>−1 is returned if an error was encountered. +Otherwise, the value of <i>size</i> is returned.</big></p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: File not open for writing</b>. The file was +opened for reading, not writing.</big></p> +<!-- INDENTATION --> +<p><big><b>Can not write scanlines to a tiled image</b>. The +image is assumed to be organized in tiles because the +<i>TileWidth</i> and <i>TileLength</i> tags have been set +with <i>TIFFSetField</i>(3TIFF).</big></p> +<!-- INDENTATION --> +<p><big><b>%s: Must set "ImageWidth" before +writing data</b>. The image’s width has not be set +before the first write. See <i>TIFFSetField</i>(3TIFF) for +information on how to do this.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: Must set "PlanarConfiguration" +before writing data</b>. The organization of data has not be +defined before the first write. See +<i>TIFFSetField</i>(3TIFF) for information on how to do +this.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: No space for strip arrays"</b>. There +was not enough space for the arrays that hold strip offsets +and byte counts.</big></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteScanline</b>(3TIFF), +<b>TIFFWriteRawStrip</b>(3TIFF), +<b>libtiff</b>(3TIFF)</big></p> +<!-- INDENTATION --> +<p><big>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></big></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteEncodedTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteEncodedTile.3tiff.html new file mode 100644 index 0000000..dcbf479 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteEncodedTile.3tiff.html @@ -0,0 +1,147 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:11 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteEncodedTile</title> +</head> +<body> + +<h1 align=center>TIFFWriteEncodedTile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>TIFFWritedEncodedTile − compress and write a +tile of data to an open</big> TIFF <big>file</big></p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>#include <tiffio.h></b></big></p> +<!-- INDENTATION --> +<p><big><b>tsize_t TIFFWriteEncodedTile(TIFF +*</b><i>tif</i><b>, ttile_t</b> <i>tile</i><b>, tdata_t</b> +<i>buf</i><b>, tsize_t</b> <i>size</i><b>)</b></big></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Compress <i>size</i> bytes of raw data from +<i>buf</i> and <b>append</b> the result to the end of the +specified tile. Note that the value of <i>tile</i> is a +‘‘raw tile number.’’ That is, the +caller must take into account whether or not the data are +organized in separate places (<i>PlanarConfiguration</i>=2). +<i>TIFFComputeTile</i> automatically does this when +converting an (x,y,z,sample) coordinate quadruple to a tile +number.</big></p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The library writes encoded data using the native +machine byte order. Correctly implemented</big> TIFF +<big>readers are expected to do any necessary byte-swapping +to correctly process image data with BitsPerSample greater +than 8.</big></p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>−1 is returned if an error was encountered. +Otherwise, the value of <i>size</i> is returned.</big></p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: File not open for writing</b>. The file was +opened for reading, not writing.</big></p> +<!-- INDENTATION --> +<p><big><b>Can not write tiles to a stripped image</b>. The +image is assumed to be organized in strips because neither +of the <i>TileWidth</i> or <i>TileLength</i> tags have been +set with <b>TIFFSetField</b>(3TIFF).</big></p> +<!-- INDENTATION --> +<p><big><b>%s: Must set "ImageWidth" before +writing data</b>. The image’s width has not be set +before the first write. See <b>TIFFSetField</b>(3TIFF) for +information on how to do this.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: Must set "PlanarConfiguration" +before writing data</b>. The organization of data has not be +defined before the first write. See +<b>TIFFSetField</b>(3TIFF) for information on how to do +this.</big></p> +<!-- INDENTATION --> +<p><big><b>%s: No space for tile arrays"</b>. There was +not enough space for the arrays that hold tile offsets and +byte counts.</big></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFOpen</b>(3TIFF), <b>TIFFWriteTile</b>(3TIFF), +<b>TIFFWriteRawTile</b>(3TIFF), +<b>libtiff</b>(3TIFF)</big></p> +<!-- INDENTATION --> +<p><big>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></big></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteRawStrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteRawStrip.3tiff.html new file mode 100644 index 0000000..eaceba6 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteRawStrip.3tiff.html @@ -0,0 +1,144 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:11 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteRawstrip</title> +</head> +<body> + +<h1 align=center>TIFFWriteRawstrip</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWriteRawStrip − write a strip of raw data to an +open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFWriteRawStrip(TIFF *</b><i>tif</i><b>, +tstrip_t</b> <i>strip</i><b>, tdata_t</b> <i>buf</i><b>, +tsize_t</b> <i>size</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Append <i>size</i> bytes of raw data to the specified +strip.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The strip number must be valid according to the current +settings of the <i>ImageLength</i> and <i>RowsPerStrip</i> +tags. An image may be dynamically grown by increasing the +value of <i>ImageLength</i> prior to each call to +<i>TIFFWriteRawStrip</i>.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>−1 is returned if an error occurred. Otherwise, the +value of <i>size</i> is returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>%s: File not open for writing</b>. The file was opened +for reading, not writing.</p> +<!-- INDENTATION --> +<p><b>Can not write scanlines to a tiled image</b>. The +image is assumed to be organized in tiles because the +<i>TileWidth</i> and <i>TileLength</i> tags have been set +with <b>TIFFSetField</b>(3TIFF).</p> +<!-- INDENTATION --> +<p><b>%s: Must set "ImageWidth" before writing +data</b>. The image’s width has not be set before the +first write. See <b>TIFFSetField</b>(3TIFF) for information +on how to do this.</p> +<!-- INDENTATION --> +<p><b>%s: Must set "PlanarConfiguration" before +writing data</b>. The organization of data has not be +defined before the first write. See +<b>TIFFSetField</b>(3TIFF) for information on how to do +this.</p> +<!-- INDENTATION --> +<p><b>%s: No space for strip arrays"</b>. There was not +enough space for the arrays that hold strip offsets and byte +counts.</p> +<!-- INDENTATION --> +<p><b>%s: Strip %d out of range, max %d</b>. The specified +strip is not a valid strip according to the currently +specified image dimensions.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteEncodedStrip</b>(3TIFF), +<b>TIFFWriteScanline</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteRawTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteRawTile.3tiff.html new file mode 100644 index 0000000..543b078 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteRawTile.3tiff.html @@ -0,0 +1,128 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:11 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteRawtile</title> +</head> +<body> + +<h1 align=center>TIFFWriteRawtile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWriteRawTile − write a tile of raw data to an +open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFWriteRawTile(TIFF *</b><i>tif</i><b>, +ttile_t</b> <i>tile</i><b>, tdata_t</b> <i>buf</i><b>, +tsize_t</b> <i>size</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Append <i>size</i> bytes of raw data to the specified +tile.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>−1 is returned if an error occurred. Otherwise, the +value of <i>size</i> is returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>%s: File not open for writing</b>. The file was opened +for reading, not writing.</p> +<!-- INDENTATION --> +<p><b>Can not write tiles to a stripped image</b>. The image +is assumed to be organized in strips because neither of the +<i>TileWidth</i> or <i>TileLength</i> tags have been set +with <b>TIFFSetField</b>(3TIFF).</p> +<!-- INDENTATION --> +<p><b>%s: Must set "ImageWidth" before writing +data</b>. The image’s width has not be set before the +first write. See <b>TIFFSetField</b>(3TIFF) for information +on how to do this.</p> +<!-- INDENTATION --> +<p><b>%s: Must set "PlanarConfiguration" before +writing data</b>. The organization of data has not be +defined before the first write. See +<b>TIFFSetField</b>(3TIFF) for information on how to do +this.</p> +<!-- INDENTATION --> +<p><b>%s: No space for tile arrays"</b>. There was not +enough space for the arrays that hold tile offsets and byte +counts.</p> +<!-- INDENTATION --> +<p><b>%s: Specified tile %d out of range, max %d</b>. The +specified tile is not valid according to the currently +specified image dimensions.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteEncodedTile</b>(3TIFF), +<b>TIFFWriteScanline</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteScanline.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteScanline.3tiff.html new file mode 100644 index 0000000..da929e7 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteScanline.3tiff.html @@ -0,0 +1,206 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:11 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteScanline</title> +</head> +<body> + +<h1 align=center>TIFFWriteScanline</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWriteScanline − write a scanline to an open +<small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFWriteScanline(TIFF *</b><i>tif</i><b>, +tdata_t</b> <i>buf</i><b>, uint32</b> <i>row</i><b>, +tsample_t</b> <i>sample</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Write data to a file at the specified row. The +<i>sample</i> parameter is used only if data are organized +in separate planes (<i>PlanarConfiguration</i>=2). The data +are assumed to be uncompressed and in the native bit- and +byte-order of the host machine. The data written to the file +is compressed according to the compression scheme of the +current <small>TIFF</small> directory (see further below). +If the current scanline is past the end of the current +subfile, the <i>ImageLength</i> field is automatically +increased to include the scanline (except for +<i>PlanarConfiguration</i>=2, where the <i>ImageLength</i> +cannot be changed once the first data are written). If the +<i>ImageLength</i> is increased, the <i>StripOffsets</i> and +<i>StripByteCounts</i> fields are similarly enlarged to +reflect data written past the previous end of image.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The library writes encoded data using the native machine +byte order. Correctly implemented <small>TIFF</small> +readers are expected to do any necessary byte-swapping to +correctly process image data with BitsPerSample greater than +8. The library attempts to hide bit-ordering differences +between the image and the native machine by converting data +from the native machine order.</p> +<!-- INDENTATION --> +<p>In C++ the <i>sample</i> parameter defaults to 0.</p> +<!-- INDENTATION --> +<p>Once data are written to a file for the current +directory, the values of certain tags may not be altered; +see <i>TIFFSetField</i>(3TIFF) for more information.</p> +<!-- INDENTATION --> +<p>It is not possible to write scanlines to a file that uses +a tiled organization. The routine <i>TIFFIsTiled</i> can be +used to determine if the file is organized as tiles or +strips.</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFWriteScanline</i> returns −1 if it +immediately detects an error and 1 for a successful +write.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<i>TIFFError</i>(3TIFF) routine.</p> +<!-- INDENTATION --> +<p><b>%s: File not open for writing .</b> The file was +opened for reading, not writing.</p> +<!-- INDENTATION --> +<p><b>Can not write scanlines to a tiled image</b>. An +attempt was made to write a scanline to a tiled image. The +image is assumed to be organized in tiles because the +<i>TileWidth</i> and <i>TileLength</i> tags have been set +with <i>TIFFSetField</i>(3TIFF).</p> +<!-- INDENTATION --> +<p><b>Compression algorithm does not support random +access</b>. Data was written in a non-sequential order to a +file that uses a compression algorithm and that has +<i>RowsPerStrip</i> greater than one. That is, data in the +image is to be stored in a compressed form, and with +multiple rows packed into a strip. In this case, the library +does not support random access to the data. The data should +either be written as entire strips, sequentially by rows, or +the value of <i>RowsPerStrip</i> should be set to one.</p> +<!-- INDENTATION --> +<p><b>%s: Must set "ImageWidth" before writing +data</b>. The image’s width has not be set before the +first write. See <b>TIFFSetField</b>(3TIFF) for information +on how to do this.</p> +<!-- INDENTATION --> +<p><b>%s: Must set "PlanarConfiguration" before +writing data</b>. The organization of data has not be +defined before the first write. See +<b>TIFFSetField</b>(3TIFF) for information on how to do +this.</p> +<!-- INDENTATION --> +<p><b>Can not change "ImageLength" when using +separate planes</b>. Separate image planes are being used +(<i>PlanarConfiguration</i>=2), but the number of rows has +not been specified before the first write. The library +supports the dynamic growth of an image only when data are +organized in a contiguous manner +(<i>PlanarConfiguration</i>=1).</p> +<!-- INDENTATION --> +<p><b>%d: Sample out of range, max %d</b>. The <i>sample</i> +parameter was greater than the value of the SamplesPerPixel +tag.</p> +<!-- INDENTATION --> +<p><b>%s: No space for strip arrays .</b> There was not +enough space for the arrays that hold strip offsets and byte +counts.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Writing subsampled YCbCR data does not work correctly +because, for <i>PlanarConfiguration</i>=2 the size of a +scanline is not calculated on a per-sample basis, and for +<i>PlanarConfiguration</i>=1 the library does not pack the +block-interleaved samples.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), +<b>TIFFWriteEncodedStrip</b>(3TIFF), +<b>TIFFWriteRawStrip</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFWriteTile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFWriteTile.3tiff.html new file mode 100644 index 0000000..fa9ddc3 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFWriteTile.3tiff.html @@ -0,0 +1,115 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:11 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFWriteTile</title> +</head> +<body> + +<h1 align=center>TIFFWriteTile</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#RETURN VALUES">RETURN VALUES</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFWriteTile − encode and write a tile of data to +an open <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFWriteTile(TIFF *</b><i>tif</i><b>, +tdata_t</b> <i>buf</i><b>, uint32</b> <i>x</i><b>, +uint32</b> <i>y</i><b>, uint32</b> <i>z</i><b>, +tsample_t</b> <i>sample</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Write the data for the tile <i>containing</i> the +specified coordinates. The data in <i>buf</i> are is +(potentially) compressed, and written to the indicated file, +normally being appended to the end of the file. The buffer +must be contain an entire tile of data. Applications should +call the routine <i>TIFFTileSize</i> to find out the size +(in bytes) of a tile buffer. The <i>x</i> and <i>y</i> +parameters are always used by <i>TIFFWriteTile</i>. The +<i>z</i> parameter is used if the image is deeper than 1 +slice (<i>ImageDepth</i>>1). The <i>sample</i> parameter +is used only if data are organized in separate planes +(<i>PlanarConfiguration</i>=2).</p> +</td> +</table> +<a name="RETURN VALUES"></a> +<h2>RETURN VALUES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFWriteTile</i> returns −1 if it detects an +error; otherwise the number of bytes in the tile is +returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>All error messages are directed to the +<b>TIFFError</b>(3TIFF) routine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFCheckTile</b>(3TIFF), +<b>TIFFComputeTile</b>(3TIFF), <b>TIFFOpen</b>(3TIFF), +<b>TIFFReadTile</b>(3TIFF), <b>TIFFWriteScanline</b>(3TIFF), +<b>TIFFWriteEncodedTile</b>(3TIFF), +<b>TIFFWriteRawTile</b>(3TIFF), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFbuffer.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFbuffer.3tiff.html new file mode 100644 index 0000000..ac667be --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFbuffer.3tiff.html @@ -0,0 +1,116 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFBUFFER</title> +</head> +<body> + +<h1 align=center>TIFFBUFFER</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFReadBufferSetup, TIFFWriteBufferSetup − I/O +buffering control routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<pre><b>#include <tiffio.h> + +int TIFFReadBufferSetup(TIFF *</b><i>tif</i><b>, tdata_t</b> <i>buffer</i><b>, tsize_t</b> <i>size</i><b>); +int TIFFWriteBufferSetup(TIFF *</b><i>tif</i><b>, tdata_t</b> <i>buffer</i><b>, tsize_t</b> <i>size</i><b>); +</b></pre> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following routines are provided for client-control of +the I/O buffers used by the library. Applications need never +use these routines; they are provided only for +‘‘intelligent clients’’ that wish to +optimize memory usage and/or eliminate potential copy +operations that can occur when working with images that have +data stored without compression.</p> +<!-- INDENTATION --> +<p><i>TIFFReadBufferSetup</i> sets up the data buffer used +to read raw (encoded) data from a file. If the specified +pointer is <small>NULL</small> (zero), then a buffer of the +appropriate size is allocated. Otherwise the caller must +guarantee that the buffer is large enough to hold any +individual strip of raw data. <i>TIFFReadBufferSetup</i> +returns a non-zero value if the setup was successful and +zero otherwise.</p> +<!-- INDENTATION --> +<p><i>TIFFWriteBufferSetup</i> sets up the data buffer used +to write raw (encoded) data to a file. If the specified +<i>size</i> is −1 then the buffer size is selected to +hold a complete tile or strip, or at least 8 kilobytes, +whichever is greater. If the specified <i>buffer</i> is +<small>NULL</small> (zero), then a buffer of the appropriate +size is dynamically allocated. <i>TIFFWriteBufferSetup</i> +returns a non-zero value if the setup was successful and +zero otherwise.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>%s: No space for data buffer at scanline %ld</b>. +<i>TIFFReadBufferSetup</i> was unable to dynamically +allocate space for a data buffer.</p> +<!-- INDENTATION --> +<p><b>%s: No space for output buffer</b>. +<i>TIFFWriteBufferSetup</i> was unable to dynamically +allocate space for a data buffer.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFcodec.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFcodec.3tiff.html new file mode 100644 index 0000000..08c6643 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFcodec.3tiff.html @@ -0,0 +1,116 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>CODEC</title> +</head> +<body> + +<h1 align=center>CODEC</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFFindCODEC, TIFFRegisterCODEC, TIFFUnRegisterCODEC, +TIFFIsCODECConfigured − codec-related utility +routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>const TIFFCodec* TIFFFindCODEC(uint16</b> +<i>scheme</i><b>);<br> +TIFFCodec* TIFFRegisterCODEC(uint16</b> <i>scheme</i><b>, +const char *</b><i>method</i><b>, TIFFInitMethod</b> +<i>init</i><b>);<br> +void TIFFUnRegisterCODEC(TIFFCodec +*</b><i>codec</i><b>);<br> +int TIFFIsCODECConfigured(uint16</b> +<i>scheme</i><b>);</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>libtiff</i> supports a variety of compression schemes +implemented by software <i>codecs</i>. Each codec adheres to +a modular interface that provides for the decoding and +encoding of image data; as well as some other methods for +initialization, setup, cleanup, and the control of default +strip and tile sizes. Codecs are identified by the +associated value of the <small>TIFF</small> +<i>Compression</i> tag; e.g. 5 for <small>LZW</small> +compression.</p> +<!-- INDENTATION --> +<p>The <i>TIFFRegisterCODEC</i> routine can be used to +augment or override the set of codecs available to an +application. If the specified <i>scheme</i> already has a +registered codec then it is <i>overridden</i> and any images +with data encoded with this compression scheme will be +decoded using the supplied coded.</p> +<!-- INDENTATION --> +<p><i>TIFFIsCODECConfigured</i> returns 1 if the codec is +configured and working. Otherwise 0 will be returned.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>No space to register compression scheme %s</b>. +<i>TIFFRegisterCODEC</i> was unable to allocate memory for +the data structures needed to register a codec.</p> +<!-- INDENTATION --> +<p><b>Cannot remove compression scheme %s; not +registered</b>. <i>TIFFUnRegisterCODEC</i> did not locate +the specified codec in the table of registered compression +schemes.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFcolor.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFcolor.3tiff.html new file mode 100644 index 0000000..38fb745 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFcolor.3tiff.html @@ -0,0 +1,975 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>COLOR</title> +</head> +<body> + +<h1 align=center>COLOR</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFYCbCrToRGBInit, TIFFYCbCrtoRGB, TIFFCIELabToRGBInit, +TIFFCIELabToXYZ, TIFFXYZToRGB − color conversion +routines.</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>int TIFFYCbCrToRGBInit(TIFFYCbCrToRGB +*</b><i>ycbcr</i><b>, float *</b><i>luma</i><b>, float +*</b><i>refBlackWhite"</i><b>);"<br> +void TIFFYCbCrtoRGB(TIFFYCbCrToRGB *</b><i>ycbcr</i><b>, +uint32</b> <i>Y</i><b>, int32</b> <i>Cb</i><b>, int32</b> +<i>Cr</i><b>, uint32 *</b><i>R</i><b>, uint32 +*</b><i>G</i><b>, uint32 *</b><i>B</i> <b>);</b></p> +<!-- INDENTATION --> +<p><b>int TIFFCIELabToRGBInit(TIFFCIELabToRGB +*</b><i>cielab</i><b>, TIFFDisplay *</b><i>display</i><b>, +float *</b><i>refWhite</i><b>);<br> +void TIFFCIELabToXYZ(TIFFCIELabToRGB *</b><i>cielab</i><b>, +uint32</b> <i>L</i><b>, int32</b> <i>a</i><b>, int32</b> +<i>b</i><b>, float *</b><i>X</i><b>, float *</b><i>Y</i><b>, +float *</b><i>Z</i><b>);<br> +void TIFFXYZToRGB(TIFFCIELabToRGB *</b><i>cielab</i><b>, +float</b> <i>X</i><b>, float</b> <i>Y</i><b>, float</b> +<i>Z"</i><b>,</b><i>uint32</i><b>*"</b><i>R</i><b>, +uint32 *</b><i>G</i><b>, uint32 *</b><i>B</i><b>);</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFF supports several color spaces for images stored in +that format. There is usually a problem of application to +handle the data properly and convert between different +colorspaces for displaying and printing purposes. To +simplify this task libtiff implements several color +conversion routines itself. In particular, these routines +used in <b>TIFFRGBAImage(3TIFF)</b> interface.</p> +<!-- INDENTATION --> +<p><b>TIFFYCbCrToRGBInit()</b> used to initialize +<i>YCbCr</i> to <i>RGB</i> conversion state. Allocating and +freeing of the <i>ycbcr</i> structure belongs to programmer. +<i>TIFFYCbCrToRGB</i> defined in <b>tiffio.h</b> as</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>typedef struct { /* YCbCr->RGB support */ + TIFFRGBValue* clamptab; /* range clamping table */ +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> + +<p>int*</p> +<td width="28%"></td> +<td width="-3%"></td> +<td width="12%"></td> +<td width="6%"> + +<p>Cr_r_tab;<br> +int*</p> +</td> +<td width="56%"> +</td> +<tr valign="top" align="left"> +<td width="28%"></td> +<td width="-3%"></td> +<td width="12%"></td> +<td width="6%"> + +<p>Cb_b_tab;<br> +int32*</p> +</td> +<td width="56%"> +</td> +<tr valign="top" align="left"> +<td width="28%"></td> +<td width="-3%"></td> +<td width="12%"></td> +<td width="6%"> + +<p>Cr_g_tab;<br> +int32*</p> +</td> +<td width="56%"> +</td> +<tr valign="top" align="left"> +<td width="28%"></td> +<td width="-3%"></td> +<td width="12%"></td> +<td width="6%"> + +<p>Cb_g_tab;</p> +</td> +<td width="56%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>int32* Y_tab;<br> +} TIFFYCbCrToRGB;</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>luma</i> is a float array of three values representing +proportions of the red, green and blue in luminance, Y (see +section 21 of the TIFF 6.0 specification, where the YCbCr +images discussed). <i>TIFFTAG_YCBCRCOEFFICIENTS</i> holds +that values in TIFF file. <i>refBlackWhite</i> is a float +array of 6 values which specifies a pair of headroom and +footroom image data values (codes) for each image component +(see section 20 of the TIFF 6.0 specification where the +colorinmetry fields discussed). +<i>TIFFTAG_REFERENCEBLACKWHITE</i> is responsible for +storing these values in TIFF file. Following code snippet +should helps to understand the the technique:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>float *luma, *refBlackWhite; +uint16 hs, vs; + +/* Initialize structures */ +ycbcr = (TIFFYCbCrToRGB*) +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>_TIFFmalloc(TIFFroundup(sizeof(TIFFYCbCrToRGB), +sizeof(long))</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>+ 4*256*sizeof(TIFFRGBValue)</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>+ 2*256*sizeof(int)</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>+ 3*256*sizeof(int32));</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>if (ycbcr == NULL) {<br> +TIFFError("YCbCr->RGB",</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="4" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>"No space for YCbCr->RGB conversion +state");</p> +</td> +<td width="62%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>exit(0);<br> +}</p> +<!-- INDENTATION --> +<p>TIFFGetFieldDefaulted(tif, TIFFTAG_YCBCRCOEFFICIENTS, +&luma);<br> +TIFFGetFieldDefaulted(tif, TIFFTAG_REFERENCEBLACKWHITE, +&refBlackWhite);<br> +if (TIFFYCbCrToRGBInit(ycbcr, luma, refBlackWhite) < +0)</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>exit(0);</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>/* Start conversion */<br> +uint32 r, g, b;<br> +uint32 Y;<br> +int32 Cb, Cr;</p> +<!-- INDENTATION --> +<p>for each pixel in image</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>TIFFYCbCrtoRGB(img->ycbcr, Y, Cb, Cr, &r, &g, +&b);</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>/* Free state structure */<br> +_TIFFfree(ycbcr);</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFCIELabToRGBInit()</b> initializes the <i>CIE +L*a*b* 1976</i> to <i>RGB</i> conversion state. +<b>TIFFCIELabToRGB</b> defined as</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>#define CIELABTORGB_TABLE_RANGE 1500 + +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="9" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> + +<p>typedef struct {</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>/* CIE Lab 1976->RGB support */</p> +</td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>int</p> +</td> +<td width="6%"> + +<p>range;</p> +</td> +<td width="6%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>/* Size of conversion table */</p> +</td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>float</p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>rstep, gstep, bstep;</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>float</p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>X0, Y0, Z0;</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"> + +<p>/* Reference white point */</p> +</td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"></td> +<td width="6%"> + +<p>TIFFDisplay display;</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>float</p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>Yr2r[CIELABTORGB_TABLE_RANGE + 1]; /* Conversion of Yr +to r */</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>float</p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>Yg2g[CIELABTORGB_TABLE_RANGE + 1]; /* Conversion of Yg +to g */</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="37%"> +</td> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>float</p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>Yb2b[CIELABTORGB_TABLE_RANGE + 1]; /* Conversion of Yb +to b */</p> +</td> +<td width="6%"></td> +<td width="6%"></td> +<td width="6%"></td> +<td width="37%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>} TIFFCIELabToRGB;</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>display</i> is a display device description, declared +as</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>typedef struct { +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_mat[3][3]; /* XYZ -> luminance matrix */</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_YCR; /* Light o/p for reference white */</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_YCG;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_YCB;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>uint32 d_Vrwr; /* Pixel values for ref. white */</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>uint32 d_Vrwg;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>uint32 d_Vrwb;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_Y0R; /* Residual light for black pixel */</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_Y0G;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_Y0B;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_gammaR; /* Gamma values for the three guns +*/</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_gammaG;</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>float d_gammaB;</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>} TIFFDisplay;</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>For example, the one can use sRGB device, which has the +following parameters:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>TIFFDisplay display_sRGB = { +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>{ /* XYZ -> luminance matrix */</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>{ 3.2410F, -1.5374F, -0.4986F },</p> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>{ -0.9692F, 1.8760F, 0.0416F },</p> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>{ 0.0556F, -0.2040F, 1.0570F }</p> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>},</p> +</td> +<td width="6%"> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>100.0F, 100.0F, 100.0F, /* Light o/p for reference white +*/</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>255, 255, 255, /* Pixel values for ref. white */</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>1.0F, 1.0F, 1.0F, /* Residual light o/p for black pixel +*/</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>2.4F, 2.4F, 2.4F, /* Gamma values for the three guns +*/</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>};</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>refWhite</i> is a color temperature of the reference +white. The <i>TIFFTAG_WHITEPOINT</i> contains the +chromaticity of the white point of the image from where the +reference white can be calculated using following +formulae:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>refWhite_Y = 100.0<br> +refWhite_X = whitePoint_x / whitePoint_y * refWhite_Y<br> +refWhite_Z = (1.0 - whitePoint_x - whitePoint_y) / +whitePoint_y * refWhite_X</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The conversion itself performed in two steps: at the +first one we will convert <i>CIE L*a*b* 1976</i> to <i>CIE +XYZ</i> using <b>TIFFCIELabToXYZ()</b> routine, and at the +second step we will convert <i>CIE XYZ</i> to <i>RGB</i> +using <b>TIFFXYZToRGB().</b> Look at the code sample +below:</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>float *whitePoint; +float refWhite[3]; + +/* Initialize structures */ +img->cielab = (TIFFCIELabToRGB *) +</pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>_TIFFmalloc(sizeof(TIFFCIELabToRGB));</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>if (!cielab) {</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>TIFFError("CIE L*a*b*->RGB",</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>"No space for CIE L*a*b*->RGB conversion +state.");</p> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>exit(0);</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>}</p> +<!-- INDENTATION --> +<p>TIFFGetFieldDefaulted(tif, TIFFTAG_WHITEPOINT, +&whitePoint);<br> +refWhite[1] = 100.0F;<br> +refWhite[0] = whitePoint[0] / whitePoint[1] * +refWhite[1];<br> +refWhite[2] = (1.0F - whitePoint[0] - +whitePoint[1])</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>/ whitePoint[1] * refWhite[1];</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>if (TIFFCIELabToRGBInit(cielab, &display_sRGB, +refWhite) < 0) {</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>TIFFError("CIE L*a*b*->RGB",</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>"Failed to initialize CIE L*a*b*->RGB conversion +state.");</p> +</td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>_TIFFfree(cielab);</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="0%"></td> +<td width="6%"> + +<p>exit(0);</p> +</td> +<td width="6%"></td> +<td width="62%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>}</p> +<!-- INDENTATION --> +<p>/* Now we can start to convert */<br> +uint32 r, g, b;<br> +uint32 L;<br> +int32 a, b;<br> +float X, Y, Z;</p> +<!-- INDENTATION --> +<p>for each pixel in image</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>TIFFCIELabToXYZ(cielab, L, a, b, &X, &Y, +&Z);</p> +</td> +<tr valign="top" align="left"> +<td width="24%"></td> +<td width="75%"> + +<p>TIFFXYZToRGB(cielab, X, Y, Z, &r, &g, +&b);</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>/* Don’t forget to free the state structure */<br> +_TIFFfree(cielab);</p></td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFRGBAImage</b>(3TIFF) <b>libtiff</b>(3TIFF),</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFmemory.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFmemory.3tiff.html new file mode 100644 index 0000000..296f4fa --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFmemory.3tiff.html @@ -0,0 +1,110 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:08 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>MEMORY</title> +</head> +<body> + +<h1 align=center>MEMORY</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>_TIFFmalloc, _TIFFrealloc, _TIFFfree, _TIFFmemset, +_TIFFmemcpy, _TIFFmemcmp, − memory management-related +functions for use with <small>TIFF</small> files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tdata_t _TIFFmalloc(tsize_t</b> <i>size</i><b>);<br> +tdata_t _TIFFrealloc(tdata_t</b> <i>buffer</i><b>, +tsize_t</b> <i>size</i><b>);<br> +void _TIFFfree(tdata_t</b> <i>buffer</i><b>);<br> +void _TIFFmemset(tdata_t</b> <i>s</i><b>, int</b> +<i>c</i><b>, tsize_t</b> <i>n</i><b>);<br> +void _TIFFmemcpy(tdata_t</b> <i>dest</i><b>, const +tdata_t</b> <i>src</i><b>, tsize_t</b> <i>n</i><b>);<br> +int _TIFFmemcmp(const tdata_t</b> <i>s1</i><b>, const +tdata_t</b> <i>s2</i><b>, tsize_t</b> <i>n</i><b>);</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>These routines are provided for writing portable software +that uses <i>libtiff</i>; they hide any memory-management +related issues, such as dealing with segmented architectures +found on 16-bit machines.</p> +<!-- INDENTATION --> +<p><i>_TIFFmalloc</i> and <i>_TIFFrealloc</i> are used to +dynamically allocate and reallocate memory used by +<i>libtiff</i>; such as memory passed into the I/O routines. +Memory allocated through these interfaces is released back +to the system using the <i>_TIFFfree</i> routine.</p> +<!-- INDENTATION --> +<p>Memory allocated through one of the above interfaces can +be set to a known value using <i>_TIFFmemset</i>, copied to +another memory location using <i>_TIFFmemcpy</i>, or +compared for equality using <i>_TIFFmemcmp</i>. These +routines conform to the equivalent <small>ANSI</small> C +routines: <i>memset</i>, <i>memcpy</i>, and <i>memcmp</i>, +repsectively.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>malloc</b>(3), <b>memory</b>(3), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFquery.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFquery.3tiff.html new file mode 100644 index 0000000..f896d26 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFquery.3tiff.html @@ -0,0 +1,148 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:09 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>QUERY</title> +</head> +<body> + +<h1 align=center>QUERY</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFCurrentRow, TIFFCurrentStrip, TIFFCurrentTile, +TIFFCurrentDirectory, TIFFLastDirectory, TIFFFileno, +TIFFFileName, TIFFGetMode, TIFFIsTiled, TIFFIsByteSwapped, +TIFFIsUpSampled, TIFFIsMSB2LSB, TIFFGetVersion − query +routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>uint32 TIFFCurrentRow(TIFF*</b> <i>tif</i><b>)<br> +tstrip_t TIFFCurrentStrip(TIFF*</b> <i>tif</i><b>)<br> +ttile_t TIFFCurrentTile(TIFF*</b> <i>tif</i><b>)<br> +tdir_t TIFFCurrentDirectory(TIFF*</b> <i>tif</i><b>)<br> +int TIFFLastDirectory(TIFF*</b> <i>tif</i><b>)<br> +int TIFFFileno(TIFF*</b> <i>tif</i><b>)<br> +char* TIFFFileName(TIFF*</b> <i>tif</i><b>)<br> +int TIFFGetMode(TIFF*</b> <i>tif</i><b>)<br> +int TIFFIsTiled(TIFF*</b> <i>tif</i><b>)<br> +int TIFFIsByteSwapped(TIFF*</b> <i>tif</i><b>)<br> +int TIFFIsUpSampled(TIFF*</b> <i>tif</i><b>)<br> +int TIFFIsMSB2LSB(TIFF*</b> <i>tif</i><b>)<br> +const char* TIFFGetVersion(void)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following routines return status information about an +open <small>TIFF</small> file.</p> +<!-- INDENTATION --> +<p><i>TIFFCurrentDirectory</i> returns the index of the +current directory (directories are numbered starting at 0). +This number is suitable for use with the +<i>TIFFSetDirectory</i> routine.</p> +<!-- INDENTATION --> +<p><i>TIFFLastDirectory</i> returns a non-zero value if the +current directory is the last directory in the file; +otherwise zero is returned.</p> +<!-- INDENTATION --> +<p><i>TIFFCurrentRow</i>, <i>TIFFCurrentStrip</i>, and +<i>TIFFCurrentTile</i>, return the current row, strip, and +tile, respectively, that is being read or written. These +values are updated each time a read or write is done.</p> +<!-- INDENTATION --> +<p><i>TIFFFileno</i> returns the underlying file descriptor +used to access the <small>TIFF</small> image in the +filesystem.</p> +<!-- INDENTATION --> +<p><i>TIFFFileName</i> returns the pathname argument passed +to <i>TIFFOpen</i> or <i>TIFFFdOpen</i>.</p> +<!-- INDENTATION --> +<p><i>TIFFGetMode</i> returns the mode with which the +underlying file was opened. On <small>UNIX</small> systems, +this is the value passed to the <i>open</i>(2) system +call.</p> +<!-- INDENTATION --> +<p><i>TIFFIsTiled</i> returns a non-zero value if the image +data has a tiled organization. Zero is returned if the image +data is organized in strips.</p> +<!-- INDENTATION --> +<p><i>TIFFIsByteSwapped</i> returns a non-zero value if the +image data was in a different byte-order than the host +machine. Zero is returned if the TIFF file and local host +byte-orders are the same. Note that TIFFReadTile(), +TIFFReadStrip() and TIFFReadScanline() functions already +normally perform byte swapping to local host order if +needed.</p> +<!-- INDENTATION --> +<p><i>TIFFIsUpSampled</i> returns a non-zero value if image +data returned through the read interface routines is being +up-sampled. This can be useful to applications that want to +calculate I/O buffer sizes to reflect this usage (though the +usual strip and tile size routines already do this).</p> +<!-- INDENTATION --> +<p><i>TIFFIsMSB2LSB</i> returns a non-zero value if the +image data is being returned with bit 0 as the most +significant bit.</p> +<!-- INDENTATION --> +<p><i>TIFFGetVersion</i> returns an <small>ASCII</small> +string that has a version stamp for the <small>TIFF</small> +library software.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>libtiff</i>(3TIFF), <i>TIFFOpen</i>(3TIFF), +<i>TIFFFdOpen</i>(3TIFF)</p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFsize.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFsize.3tiff.html new file mode 100644 index 0000000..1c81247 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFsize.3tiff.html @@ -0,0 +1,95 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:10 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSIZE</title> +</head> +<body> + +<h1 align=center>TIFFSIZE</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFScanlineSize, TIFFRasterScanlineSize, − return +the size of various items associated with an open +<small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>tsize_t TIFFRasterScanlineSize(TIFF +*</b><i>tif</i><b>)<br> +tsize_t TIFFScanlineSize(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFScanlineSize</i> returns the size in bytes of a +row of data as it would be returned in a call to +<i>TIFFReadScanline</i>, or as it would be expected in a +call to <i>TIFFWriteScanline</i>.</p> +<!-- INDENTATION --> +<p><i>TIFFRasterScanlineSize</i> returns the size in bytes +of a complete decoded and packed raster scanline. Note that +this value may be different from the value returned by +<i>TIFFScanlineSize</i> if data is stored as separate +planes.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFOpen</b>(3TIFF), <b>TIFFReadScanline</b>(3TIFF), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFstrip.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFstrip.3tiff.html new file mode 100644 index 0000000..1b7ac9c --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFstrip.3tiff.html @@ -0,0 +1,129 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:10 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSTRIP</title> +</head> +<body> + +<h1 align=center>TIFFSTRIP</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFDefaultStripSize, TIFFStripSize, TIFFVStripSize, +TIFFRawStripSize, TIFFComputeStrip, TIFFNumberOfStrips +− strip-related utility routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>uint32 TIFFDefaultStripSize(TIFF *</b><i>tif</i><b>, +uint32</b> <i>estimate</i><b>)<br> +tsize_t TIFFStripSize(TIFF *</b><i>tif</i><b>)<br> +tsize_t TIFFVStripSize(TIFF *</b><i>tif</i><b>, uint32</b> +<i>nrows</i><b>)<br> +tsize_t TIFFRawStripSize(TIFF *</b><i>tif</i><b>, +tstrip_t</b> <i>strip</i><b>)<br> +tstrip_t TIFFComputeStrip(TIFF *</b><i>tif</i><b>, +uint32</b> <i>row</i><b>, tsample_t</b> +<i>sample</i><b>)<br> +tstrip_t TIFFNumberOfStrips(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFDefaultStripSize</i> returns the number of rows +for a reasonable-sized strip according to the current +settings of the <i>ImageWidth</i>, <i>BitsPerSample</i>, +<i>SamplesPerPixel</i>, tags and any compression-specific +requirements. If the <i>estimate</i> parameter, if non-zero, +then it is taken as an estimate of the desired strip size +and adjusted according to any compression-specific +requirements. The value returned by this function is +typically used to define the <i>RowsPerStrip</i> tag. In +lieu of any unusual requirements <i>TIFFDefaultStripSize</i> +tries to create strips that have approximately 8 kilobytes +of uncompressed data.</p> +<!-- INDENTATION --> +<p><i>TIFFStripSize</i> returns the equivalent size for a +strip of data as it would be returned in a call to +<i>TIFFReadEncodedStrip</i> or as it would be expected in a +call to <i>TIFFWriteEncodedStrip</i>.</p> +<!-- INDENTATION --> +<p><i>TIFFVStripSize</i> returns the number of bytes in a +strip with <i>nrows</i> rows of data.</p> +<!-- INDENTATION --> +<p><i>TIFFRawStripSize</i> returns the number of bytes in a +raw strip (i.e. not decoded).</p> +<!-- INDENTATION --> +<p><i>TIFFComputeStrip</i> returns the strip that contains +the specified coordinates. A valid strip is always returned; +out-of-range coordinate values are clamped to the bounds of +the image. The <i>row</i> parameter is always used in +calculating a strip. The <i>sample</i> parameter is used +only if data are organized in separate planes +(<i>PlanarConfiguration</i>=2).</p> +<!-- INDENTATION --> +<p><i>TIFFNumberOfStrips</i> returns the number of strips in +the image.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFReadEncodedStrip</b>(3TIFF), +<b>TIFFReadRawStrip</b>(3TIFF), +<b>TIFFWriteEncodedStrip</b>(3TIFF), +<b>TIFFWriteRawStrip</b>(3TIFF), <b>libtiff</b>(3TIFF),</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFswab.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFswab.3tiff.html new file mode 100644 index 0000000..0663168 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFswab.3tiff.html @@ -0,0 +1,110 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:10 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>SWAB</title> +</head> +<body> + +<h1 align=center>SWAB</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFGetBitRevTable, TIFFReverseBits, TIFFSwabShort, +TIFFSwabLong, TIFFSwabArrayOfShort, TIFFSwabArrayOfLong +− byte- and bit-swapping routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>const unsigned char* TIFFGetBitRevTable(int</b> +<i>reversed</i><b>)<br> +void TIFFReverseBits(u_char *</b><i>data</i><b>, unsigned +long</b> <i>nbytes</i><b>)<br> +void TIFFSwabShort(uint16 *</b><i>data</i><b>)<br> +void TIFFSwabLong(uint32 *</b><i>data</i><b>)<br> +void TIFFSwabArrayOfShort(uint16 *</b><i>data</i><b>, +unsigned long</b> <i>nshorts</i><b>)<br> +void TIFFSwabArrayOfLong(uint32 *</b><i>data</i><b>, +unsigned long</b> <i>nlongs</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following routines are used by the library to swap +16- and 32-bit data and to reverse the order of bits in +bytes.</p> +<!-- INDENTATION --> +<p><i>TIFFSwabShort</i> and <i>TIFFSwabLong</i> swap the +bytes in a single 16-bit and 32-bit item, respectively. +<i>TIFFSwabArrayOfShort</i> and <i>TIFFSwabArrayOfLong</i> +swap the bytes in an array of 16-bit and 32-bit items, +respectively.</p> +<!-- INDENTATION --> +<p><i>TIFFReverseBits</i> replaces each byte in <i>data</i> +with the equivalent bit-reversed value. This operation is +performed with a lookup table, which is returned using the +<i>TIFFGetBitRevTable</i> function. <i>reversed</i> +parameter specifies which table should be returned. Supply +<i>1</i> if you want bit reversal table. Supply <i>0</i> to +get the table that do not reverse bit values. It is a lookup +table that can be used as an <i>identity function</i>; i.e. +<i>TIFFNoBitRevTable[n] == n</i>.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/TIFFtile.3tiff.html b/src/3rdparty/libtiff/html/man/TIFFtile.3tiff.html new file mode 100644 index 0000000..a37009d --- /dev/null +++ b/src/3rdparty/libtiff/html/man/TIFFtile.3tiff.html @@ -0,0 +1,141 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:11 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFTILE</title> +</head> +<body> + +<h1 align=center>TIFFTILE</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>TIFFTileSize, TIFFTileRowSize, TIFFVTileSize, +TIFFDefaultTileSize, TIFFComputeTile, TIFFCheckTile, +TIFFNumberOfTiles − tile-related utility routines</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>#include <tiffio.h></b></p> +<!-- INDENTATION --> +<p><b>void TIFFDefaultTileSize(TIFF *</b><i>tif</i><b>, +uint32 *</b><i>tw</i><b>, uint32 *</b><i>th</i><b>)<br> +tsize_t TIFFTileSize(TIFF *</b><i>tif</i><b>)<br> +tsize_t TIFFTileRowSize(TIFF *</b><i>tif</i><b>)<br> +tsize_t TIFFVTileSize(TIFF *</b><i>tif</i><b>, uint32</b> +<i>nrows</i><b>)<br> +ttile_t TIFFComputeTile(TIFF *</b><i>tif</i><b>, uint32</b> +<i>x</i><b>, uint32</b> <i>y</i><b>, uint32</b> <i>z</i><b>, +tsample_t</b> <i>sample</i><b>)<br> +int TIFFCheckTile(TIFF *</b><i>tif</i><b>, uint32</b> +<i>x</i><b>, uint32</b> <i>y</i><b>, uint32</b> <i>z</i><b>, +tsample_t</b> <i>sample</i><b>)<br> +ttile_t TIFFNumberOfTiles(TIFF *</b><i>tif</i><b>)</b></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>TIFFDefaultTileSize</i> returns the pixel width and +height of a reasonable-sized tile; suitable for setting up +the <i>TileWidth</i> and <i>TileLength</i> tags. If the +<i>tw</i> and <i>th</i> values passed in are non-zero, then +they are adjusted to reflect any compression-specific +requirements. The returned width and height are constrained +to be a multiple of 16 pixels to conform with the +<small>TIFF</small> specification.</p> +<!-- INDENTATION --> +<p><i>TIFFTileSize</i> returns the equivalent size for a +tile of data as it would be returned in a call to +<i>TIFFReadTile</i> or as it would be expected in a call to +<i>TIFFWriteTile</i>.</p> +<!-- INDENTATION --> +<p><i>TIFFVTileSize</i> returns the number of bytes in a +row-aligned tile with <i>nrows</i> of data.</p> +<!-- INDENTATION --> +<p><i>TIFFTileRowSize</i> returns the number of bytes of a +row of data in a tile.</p> +<!-- INDENTATION --> +<p><i>TIFFComputeTile</i> returns the tile that contains the +specified coordinates. A valid tile is always returned; +out-of-range coordinate values are clamped to the bounds of +the image. The <i>x</i> and <i>y</i> parameters are always +used in calculating a tile. The <i>z</i> parameter is used +if the image is deeper than 1 slice +(<i>ImageDepth</i>>1). The <i>sample</i> parameter is +used only if data are organized in separate planes +(<i>PlanarConfiguration</i>=2).</p> +<!-- INDENTATION --> +<p><i>TIFFCheckTile</i> returns a non-zero value if the +supplied coordinates are within the bounds of the image and +zero otherwise. The <i>x</i> parameter is checked against +the value of the <i>ImageWidth</i> tag. The <i>y</i> +parameter is checked against the value of the +<i>ImageLength</i> tag. The <i>z</i> parameter is checked +against the value of the <i>ImageDepth</i> tag (if defined). +The <i>sample</i> parameter is checked against the value of +the <i>SamplesPerPixel</i> parameter if the data are +organized in separate planes.</p> +<!-- INDENTATION --> +<p><i>TIFFNumberOfTiles</i> returns the number of tiles in +the image.</p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>TIFFReadEncodedTile</b>(3TIFF), +<b>TIFFReadRawTile</b>(3TIFF), <b>TIFFReadTile</b>(3TIFF), +<b>TIFFWriteEncodedTile</b>(3TIFF), +<b>TIFFWriteRawTile</b>(3TIFF), <b>TIFFWriteTile</b>(3TIFF), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/fax2ps.1.html b/src/3rdparty/libtiff/html/man/fax2ps.1.html new file mode 100644 index 0000000..3e8c0d7 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/fax2ps.1.html @@ -0,0 +1,254 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:11 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>FAX2PS</title> +</head> +<body> + +<h1 align=center>FAX2PS</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>fax2ps − convert a <small>TIFF</small> facsimile to +compressed ™</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>fax2ps</b> [ <i>options</i> ] [ <i>file</i>... ]</p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>fax2ps</i> reads one or more <small>TIFF</small> +facsimile image files and prints a compressed form of on the +standard output that is suitable for printing.</p> +<!-- INDENTATION --> +<p>By default, each page is scaled to reflect the image +dimensions and resolutions stored in the file. The +<b>−x</b> and <b>−y</b> options can be used to +specify the horizontal and vertical image resolutions +(lines/inch), respectively. If the <b>−S</b> option is +specified, each page is scaled to fill an output page. The +default output page is 8.5 by 11 inches. Alternate page +dimensions can be specified in inches with the +<b>−W</b> and <b>−H</b> options.</p> +<!-- INDENTATION --> +<p>By default <i>fax2ps</i> generates for all pages in the +file. The <b>−p</b> option can be used to select one +or more pages from a multi-page document.</p> +<!-- INDENTATION --> +<p><i>fax2ps</i> generates a compressed form of that is +optimized for sending pages of text to a printer attached to +a host through a low-speed link (such as a serial line). +Each output page is filled with white and then only the +black areas are drawn. The specification of the black +drawing operations is optimized by using a special font that +encodes the move-draw operations required to fill the black +regions on the page. This compression scheme typically +results in a substantially reduced description, relative to +the straightforward imaging of the page with a <i>image</i> +operator. This algorithm can, however, be ineffective for +continuous-tone and white-on-black images. For these images, +it sometimes is more efficient to send the raster bitmap +image directly; see <i>tiff2ps</i>(1).</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="11%"> + +<p><b>−p</b> <i>number</i></p> +</td> +<td width="1%"></td> +<td width="76%"> + +<p>Print only the indicated page. Multiple pages may be +printed by specifying this option more than once.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−x</b> <i>resolution</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="23%"></td> +<td width="76%"> +<p>Use <i>resolution</i> as the horizontal resolution, in +dots/inch, of the image data. By default this value is taken +from the file.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−y</b> <i>resolution</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="23%"></td> +<td width="76%"> +<p>Use <i>resolution</i> as the vertical resolution, in +lines/inch, of the image data. By default this value is +taken from the file.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="11%"> + +<p><b>−S</b></p> +</td> +<td width="1%"></td> +<td width="76%"> + +<p>Scale each page of image data to fill the output page +dimensions. By default images are presented according to the +dimension information recorded in the <small>TIFF</small> +file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="11%"> + +<p><b>−W</b> <i>width</i></p> +</td> +<td width="1%"></td> +<td width="76%"> + +<p>Use <i>width</i> as the width, in inches, of the output +page.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="11%"> + +<p><b>−H</b> <i>height</i></p> +</td> +<td width="1%"></td> +<td width="76%"> + +<p>Use <i>height</i> as the height, in inches, of the +output page.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Some messages about malformed <small>TIFF</small> images +come from the <small>TIFF</small> library.</p> +<!-- INDENTATION --> +<p>Various messages about badly formatted facsimile images +may be generated due to transmission errors in received +facsimile. <i>fax2ps</i> attempts to recover from such data +errors by resynchronizing decoding at the end of the current +scanline. This can result in long horizontal black lines in +the resultant image.</p> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>If the destination printer supports Level II then it is +always faster to just send the encoded bitmap generated by +the <b>tiff2ps</b>(1) program.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>fax2ps</i> should probably figure out when it is doing +a poor job of compressing the output and just generate to +image the bitmap raster instead.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiff2ps</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/fax2tiff.1.html b/src/3rdparty/libtiff/html/man/fax2tiff.1.html new file mode 100644 index 0000000..dca50e1 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/fax2tiff.1.html @@ -0,0 +1,607 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>FAX2TIFF</title> +</head> +<body> + +<h1 align=center>FAX2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>fax2tiff − create a <small>TIFF</small> Class F fax +file from raw fax data</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>fax2tiff</b> [ <i>options</i> ] [ <b>−o</b> +<i>output.tif</i> ] <i>input.raw</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Fax2tiff</i> creates a <small>TIFF</small> file +containing <small>CCITT</small> Group 3 or Group 4 encoded +data from one or more files containing +‘‘raw’’ Group 3 or Group 4 encoded +data (typically obtained directly from a fax modem). By +default, each row of data in the resultant +<small>TIFF</small> file is 1-dimensionally encoded and +padded or truncated to 1728 pixels, as needed. The resultant +image is a set of low resolution (98 lines/inch) or medium +resolution (196 lines/inch) pages, each of which is a single +strip of data. The generated file conforms to the +<small>TIFF</small> Class F ( <small>FAX</small> ) +specification for storing facsimile data. This means, in +particular, that each page of the data does <b>not</b> +include the trailing <i>return to control</i> ( +<small>RTC</small> ) code; as required for transmission by +the <small>CCITT</small> Group 3 specifications. The old, +‘‘classic’’, format is created if +the <b>−c</b> option is used. (The Class F format can +also be requested with the <b>−f</b> option.)</p> +<!-- INDENTATION --> +<p>The default name of the output image is <i>fax.tif</i>; +this can be changed with the <b>−o</b> option. Each +input file is assumed to be a separate page of facsimile +data from the same document. The order in which input files +are specified on the command line is the order in which the +resultant pages appear in the output file.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Options that affect the interpretation of input data +are:</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−3</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is <small>CCITT</small> Group 3 +encoded (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−4</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is <small>CCITT</small> Group 4 +encoded.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−U</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is uncompressed (Group 3 or Group +4).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−1</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is encoded with the 1-dimensional +version of the <small>CCITT</small> Group 3 Huffman encoding +algorithm (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−2</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is 2-dimensional version of the +<small>CCITT</small> Group 3 Huffman encoding algorithm.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−P</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is <b>not</b> EOL-aligned (default). +This option has effect with Group 3 encoded input only.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−A</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data is EOL-aligned. This option has effect +with Group 3 encoded input only.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−M</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Treat input data as having bits filled from most +significant bit ( <small>MSB</small> ) to most least bit ( +<small>LSB</small> ).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−L</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Treat input data as having bits filled from least +significant bit ( <small>LSB</small> ) to most significant +bit ( <small>MSB</small> ) (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−B</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data was encoded with black as 0 and white +as 1.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−W</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Assume input data was encoded with black as 1 and white +as 0 (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−R</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the vertical resolution, in lines/inch, of the +input images. By default input are assumed to have a +vertical resolution of 196 lines/inch. If images are low +resolution facsimile, a value of 98 lines/inch should be +specified.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−X</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the width, in pixels, of the input images. By +default input are assumed to have a width of 1728 +pixels.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Options that affect the output file format are:</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−o</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the name of the output file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−7</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be compressed with the +<small>CCITT</small> Group 3 Huffman encoding algorithm +(default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−8</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be compressed with the +<small>CCITT</small> Group 4 Huffman encoding.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−u</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be uncompressed (Group 3 or Group +4).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−5</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be encoded with the 1-dimensional +version of the <small>CCITT</small> Group 3 Huffman encoding +algorithm.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−6</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be encoded with the 2-dimensional +version of the <small>CCITT</small> Group 3 Huffman encoding +algorithm (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−a</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the last bit of each <i>End Of Line</i> ( +<small>EOL</small> ) code to land on a byte boundary +(default). This ‘‘zero padding’’ +will be reflected in the contents of the +<i>Group3Options</i> tag of the resultant +<small>TIFF</small> file. This option has effect with Group +3 encoded output only.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Do not EOL-align output. This option has effect with +Group 3 encoded output only.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate "classic" Group 3 TIFF format.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−f</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate TIFF Class F (TIFF/F) format (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−m</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output data to have bits filled from most +significant bit ( <small>MSB</small> ) to most least bit ( +<small>LSB</small> ).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output data to have bits filled from least +significant bit ( <small>LSB</small> ) to most significant +bit ( <small>MSB</small> ) (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the number of rows (scanlines) in each strip of +data written to the output file. By default (or when value +<b>0</b> is specified), <i>tiffcp</i> attempts to set the +rows/strip that no more than 8 kilobytes of data appear in a +strip (with except of G3/G4 compression schemes). If you +specify special value <b>-1</b> it will results in infinite +number of the rows per strip. The entire image will be the +one strip in that case. This is default in case of G3/G4 +output compression schemes.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Stretch the input image vertically by writing each input +row of data twice to the output file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−v</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force <i>fax2tiff</i> to print the number of rows of +data it retrieved from the input file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−z</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be compressed with the LZW encoding.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following warnings and errors come from the decoding +routines in the library.</p> +<!-- INDENTATION --> +<p><b>Warning, %s: Premature EOL at scanline %d (x +%d).\n</b>. The input data had a row that was shorter than +the expected width. The row is padded with white.</p> +<!-- INDENTATION --> +<p><b>%s: Premature EOF at scanline %d (x %d).\n</b>. The +decoder ran out of data in the middle of a scanline. The +resultant row is padded with white.</p> +<!-- INDENTATION --> +<p><b>%s: Bad code word at row %d, x %d\n</b>. An invalid +Group 3 <i>code</i> was encountered while decoding the input +file. The row number and horizontal position is given. The +remainder of the input row is discarded, while the +corresponding output row is padded with white.</p> +<!-- INDENTATION --> +<p><b>%s: Bad 2D code word at scanline %d.\n</b>. An invalid +Group 4 or 2D Group 3 <i>code</i> was encountered while +decoding the input file. The row number and horizontal +position is given. The remainder of the input row is +discarded, while the corresponding output row is padded with +white.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Input data are assumed to have a a ‘‘top +left’’ orientation; it should be possible to +override this assumption from the command line.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b><small>CCITT</small> Recommendation T.4</b> +(Standardization of Group 3 Facsimile Apparatus for Document +Transmission).</p> +<!-- INDENTATION --> +<p><b>The Spirit of TIFF Class F</b>, an appendix to the +TIFF 5.0 specification prepared by Cygnet Technologies.</p> +<!-- INDENTATION --> +<p><b>tiffinfo</b>(1), <b>tiffdither</b>(1), +<b>tiffgt</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/gif2tiff.1.html b/src/3rdparty/libtiff/html/man/gif2tiff.1.html new file mode 100644 index 0000000..ffd3cac --- /dev/null +++ b/src/3rdparty/libtiff/html/man/gif2tiff.1.html @@ -0,0 +1,141 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>GIF2TIFF</title> +</head> +<body> + +<h1 align=center>GIF2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>gif2tiff − create a <small>TIFF</small> file from a +GIF87 format image file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>gif2tiff</b> [ <i>options</i> ] <i>input.gif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Gif2tiff</i> converts a file in the GIF87 format to +<small>TIFF.</small> The <small>TIFF</small> image is +created as a palette image, with samples compressed with the +Lempel-Ziv & Welch algorithm (<i>Compression</i>=5). +These characteristics can overridden, or explicitly +specified with the options described below.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>-c +packbits</b> for the PackBits compression algorithm, <b>-c +zip</b> for the Deflate compression algorithm, and +<b>−c lzw</b> for Lempel-Ziv & Welch (the +default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Write data with a specified number of rows per strip; by +default the number of rows/strip is selected so that each +strip is approximately 8 kilobytes.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The program is based on Paul Haeberli’s +<i>fromgif</i> program which, in turn, is based on Marcel +J.E. Mol’s GIF reader.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Should have more options to control output format.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/index.html b/src/3rdparty/libtiff/html/man/index.html new file mode 100644 index 0000000..9fdba2e --- /dev/null +++ b/src/3rdparty/libtiff/html/man/index.html @@ -0,0 +1,64 @@ +<HTML><HEAD><TITLE>Libtiff HTML manpage index</TITLE></HEAD><BODY BGCOLOR=white><ul><H2>Man Pages</h2><p> +<li><A HREF=libtiff.3tiff.html>libtiff.3tiff.html</a> +<li><A HREF=TIFFbuffer.3tiff.html>TIFFbuffer.3tiff.html</a> +<li><A HREF=TIFFClose.3tiff.html>TIFFClose.3tiff.html</a> +<li><A HREF=TIFFcodec.3tiff.html>TIFFcodec.3tiff.html</a> +<li><A HREF=TIFFcolor.3tiff.html>TIFFcolor.3tiff.html</a> +<li><A HREF=TIFFDataWidth.3tiff.html>TIFFDataWidth.3tiff.html</a> +<li><A HREF=TIFFError.3tiff.html>TIFFError.3tiff.html</a> +<li><A HREF=TIFFFlush.3tiff.html>TIFFFlush.3tiff.html</a> +<li><A HREF=TIFFGetField.3tiff.html>TIFFGetField.3tiff.html</a> +<li><A HREF=TIFFmemory.3tiff.html>TIFFmemory.3tiff.html</a> +<li><A HREF=TIFFOpen.3tiff.html>TIFFOpen.3tiff.html</a> +<li><A HREF=TIFFPrintDirectory.3tiff.html>TIFFPrintDirectory.3tiff.html</a> +<li><A HREF=TIFFquery.3tiff.html>TIFFquery.3tiff.html</a> +<li><A HREF=TIFFReadDirectory.3tiff.html>TIFFReadDirectory.3tiff.html</a> +<li><A HREF=TIFFReadEncodedStrip.3tiff.html>TIFFReadEncodedStrip.3tiff.html</a> +<li><A HREF=TIFFReadEncodedTile.3tiff.html>TIFFReadEncodedTile.3tiff.html</a> +<li><A HREF=TIFFReadRawStrip.3tiff.html>TIFFReadRawStrip.3tiff.html</a> +<li><A HREF=TIFFReadRawTile.3tiff.html>TIFFReadRawTile.3tiff.html</a> +<li><A HREF=TIFFReadRGBAImage.3tiff.html>TIFFReadRGBAImage.3tiff.html</a> +<li><A HREF=TIFFReadRGBAStrip.3tiff.html>TIFFReadRGBAStrip.3tiff.html</a> +<li><A HREF=TIFFReadRGBATile.3tiff.html>TIFFReadRGBATile.3tiff.html</a> +<li><A HREF=TIFFReadScanline.3tiff.html>TIFFReadScanline.3tiff.html</a> +<li><A HREF=TIFFReadTile.3tiff.html>TIFFReadTile.3tiff.html</a> +<li><A HREF=TIFFRGBAImage.3tiff.html>TIFFRGBAImage.3tiff.html</a> +<li><A HREF=TIFFSetDirectory.3tiff.html>TIFFSetDirectory.3tiff.html</a> +<li><A HREF=TIFFSetField.3tiff.html>TIFFSetField.3tiff.html</a> +<li><A HREF=TIFFsize.3tiff.html>TIFFsize.3tiff.html</a> +<li><A HREF=TIFFstrip.3tiff.html>TIFFstrip.3tiff.html</a> +<li><A HREF=TIFFswab.3tiff.html>TIFFswab.3tiff.html</a> +<li><A HREF=TIFFtile.3tiff.html>TIFFtile.3tiff.html</a> +<li><A HREF=TIFFWarning.3tiff.html>TIFFWarning.3tiff.html</a> +<li><A HREF=TIFFWriteDirectory.3tiff.html>TIFFWriteDirectory.3tiff.html</a> +<li><A HREF=TIFFWriteEncodedStrip.3tiff.html>TIFFWriteEncodedStrip.3tiff.html</a> +<li><A HREF=TIFFWriteEncodedTile.3tiff.html>TIFFWriteEncodedTile.3tiff.html</a> +<li><A HREF=TIFFWriteRawStrip.3tiff.html>TIFFWriteRawStrip.3tiff.html</a> +<li><A HREF=TIFFWriteRawTile.3tiff.html>TIFFWriteRawTile.3tiff.html</a> +<li><A HREF=TIFFWriteScanline.3tiff.html>TIFFWriteScanline.3tiff.html</a> +<li><A HREF=TIFFWriteTile.3tiff.html>TIFFWriteTile.3tiff.html</a> +<li><A HREF=fax2ps.1.html>fax2ps.1.html</a> +<li><A HREF=fax2tiff.1.html>fax2tiff.1.html</a> +<li><A HREF=gif2tiff.1.html>gif2tiff.1.html</a> +<li><A HREF=pal2rgb.1.html>pal2rgb.1.html</a> +<li><A HREF=ppm2tiff.1.html>ppm2tiff.1.html</a> +<li><A HREF=ras2tiff.1.html>ras2tiff.1.html</a> +<li><A HREF=raw2tiff.1.html>raw2tiff.1.html</a> +<li><A HREF=rgb2ycbcr.1.html>rgb2ycbcr.1.html</a> +<li><A HREF=sgi2tiff.1.html>sgi2tiff.1.html</a> +<li><A HREF=thumbnail.1.html>thumbnail.1.html</a> +<li><A HREF=tiff2bw.1.html>tiff2bw.1.html</a> +<li><A HREF=tiff2pdf.1.html>tiff2pdf.1.html</a> +<li><A HREF=tiff2ps.1.html>tiff2ps.1.html</a> +<li><A HREF=tiff2rgba.1.html>tiff2rgba.1.html</a> +<li><A HREF=tiffcmp.1.html>tiffcmp.1.html</a> +<li><A HREF=tiffcp.1.html>tiffcp.1.html</a> +<li><A HREF=tiffdither.1.html>tiffdither.1.html</a> +<li><A HREF=tiffdump.1.html>tiffdump.1.html</a> +<li><A HREF=tiffgt.1.html>tiffgt.1.html</a> +<li><A HREF=tiffinfo.1.html>tiffinfo.1.html</a> +<li><A HREF=tiffmedian.1.html>tiffmedian.1.html</a> +<li><A HREF=tiffset.1.html>tiffset.1.html</a> +<li><A HREF=tiffsplit.1.html>tiffsplit.1.html</a> +<li><A HREF=tiffsv.1.html>tiffsv.1.html</a> +</ul></BODY></HTML> diff --git a/src/3rdparty/libtiff/html/man/libtiff.3tiff.html b/src/3rdparty/libtiff/html/man/libtiff.3tiff.html new file mode 100644 index 0000000..8a4f507 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/libtiff.3tiff.html @@ -0,0 +1,3137 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:07 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>INTRO</title> +</head> +<body> + +<h1 align=center>INTRO</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#DATA TYPES">DATA TYPES</a><br> +<a href="#LIST OF ROUTINES">LIST OF ROUTINES</a><br> +<a href="#TAG USAGE">TAG USAGE</a><br> +<a href="#PSEUDO TAGS">PSEUDO TAGS</a><br> +<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> +<a href="#BUGS">BUGS</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>libtiff − introduction to <i>libtiff</i>, a +library for reading and writing</big> TIFF +<big>files</big></p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>#include <tiffio.h></b></big></p> +<!-- INDENTATION --> +<p><big>cc file.c <b>-ltiff</b></big></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><i>libtiff</i> is a library for reading and writing +data files encoded with the <i>Tag Image File</i> format, +Revision 6.0 (or revision 5.0 or revision 4.0). This file +format is suitable for archiving multi-color and +monochromatic image data.</big></p> +<!-- INDENTATION --> +<p><big>The library supports several compression algorithms, +as indicated by the <i>Compression</i> field, including: no +compression (1),</big> CCITT <big>1D Huffman compression +(2),</big> CCITT <big>Group 3 Facsimile compression +(3),</big> CCITT <big>Group 4 Facsimile compression (4), +Lempel-Ziv & Welch compression (5), baseline JPEG +compression (7), word-aligned 1D Huffman compression +(32771), and PackBits compression (32773). In addition, +several nonstandard compression algorithms are supported: +the 4-bit compression algorithm used by the +<i>ThunderScan</i> program (32809) (decompression only), +NeXT’s 2-bit compression algorithm (32766) +(decompression only), an experimental LZ-style algorithm +known as Deflate (32946), and an experimental CIE LogLuv +compression scheme designed for images with high dynamic +range (32845 for LogL and 32845 for LogLuv). Directory +information may be in either little- or big-endian byte +order−byte swapping is automatically done by the +library. Data bit ordering may be either Most Significant +Bit (</big> MSB <big>) to Least Significant Bit (</big> LSB +<big>) or</big> LSB <big>to</big> MSB. <big>Finally, the +library does not support files in which the +<i>BitsPerSample</i>, <i>Compression</i>, +<i>MinSampleValue</i>, or <i>MaxSampleValue</i> fields are +defined differently on a per-sample basis (in Rev. 6.0 the +<i>Compression</i> tag is not defined on a per-sample basis, +so this is immaterial).</big></p> +</td> +</table> +<a name="DATA TYPES"></a> +<h2>DATA TYPES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The library makes extensive use of C typedefs to +promote portability. Two sets of typedefs are used, one for +communication with clients of the library and one for +internal data structures and parsing of the</big> TIFF +<big>format. The following typedefs are exposed to users +either through function definitions or through parameters +passed through the varargs interfaces.</big></p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef unsigned short uint16;</big></p> +</td> +<td width="38%"> + +<p><big>16-bit unsigned integer</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef unsigned <<i>thing</i>> +uint32;</big></p> +</td> +<td width="38%"> + +<p><big>32-bit unsigned integer</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef unsigned int ttag_t;</big></p> +</td> +<td width="38%"> + +<p><big>directory tag</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef uint16 tdir_t;</big></p> +</td> +<td width="38%"> + +<p><big>directory index</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef uint16 tsample_t;</big></p> +</td> +<td width="38%"> + +<p><big>sample number</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef uint32 tstrip_t;</big></p> +</td> +<td width="38%"> + +<p><big>strip number</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef uint32 ttile_t;</big></p> +</td> +<td width="38%"> + +<p><big>tile number</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef int32 tsize_t;</big></p> +</td> +<td width="38%"> + +<p><big>i/o size in bytes</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef void* tdata_t;</big></p> +</td> +<td width="38%"> + +<p><big>image data ref</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef void* thandle_t;</big></p> +</td> +<td width="38%"> + +<p><big>client data handle</big></p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="46%"> + +<p><big>typedef int32 toff_t;</big></p> +</td> +<td width="38%"> + +<p><big>file offset</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Note that <i>tstrip_t</i>, <i>ttile_t</i>, and +<i>tsize_t</i> are constrained to be no more than 32-bit +quantities by 32-bit fields they are stored in in the</big> +TIFF <big>image. Likewise <i>tsample_t</i> is limited by the +16-bit field used to store the <i>SamplesPerPixel</i> tag. +<i>tdir_t</i> constrains the maximum number of</big> IFDs +<big>that may appear in an image and may be an arbitrary +size (w/o penalty). <i>ttag_t</i> must be either int, +unsigned int, pointer, or double because the library uses a +varargs interface and</big> ANSI C <big>restricts the type +of the parameter before an ellipsis to be a promoted type. +<i>toff_t</i> is defined as int32 because TIFF file offsets +are (unsigned) 32-bit quantities. A signed value is used +because some interfaces return −1 on error. Finally, +note that user-specified data references are passed as +opaque handles and only cast at the lowest layers where +their type is presumed.</big></p> +</td> +</table> +<a name="LIST OF ROUTINES"></a> +<h2>LIST OF ROUTINES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The following routines are part of the library. +Consult specific manual pages for details on their +operation; on most systems doing ‘‘man +function-name’’ will work.</big></p></td> +</table> +<!-- TABS --> + +<p><big><i>Name Description</i></big></p> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCheckpointDirectory</big></p> +</td> +<td width="67%"> + +<p><big>writes the current state of the directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCheckTile</big></p> +</td> +<td width="67%"> + +<p><big>very x,y,z,sample is within image</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCIELabToRGBInit</big></p> +</td> +<td width="67%"> + +<p><big>initialize CIE L*a*b* 1976 to RGB conversion +state</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCIELabToXYZ</big></p> +</td> +<td width="67%"> + +<p><big>perform CIE L*a*b* 1976 to CIE XYZ +conversion</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFClientOpen</big></p> +</td> +<td width="67%"> + +<p><big>open a file for reading or writing</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFClose</big></p> +</td> +<td width="67%"> + +<p><big>close an open file</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFComputeStrip</big></p> +</td> +<td width="67%"> + +<p><big>return strip containing y,sample</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFComputeTile</big></p> +</td> +<td width="67%"> + +<p><big>return tile containing x,y,z,sample</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCurrentDirectory</big></p> +</td> +<td width="67%"> + +<p><big>return index of current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCurrentRow</big></p> +</td> +<td width="67%"> + +<p><big>return index of current scanline</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCurrentStrip</big></p> +</td> +<td width="67%"> + +<p><big>return index of current strip</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFCurrentTile</big></p> +</td> +<td width="67%"> + +<p><big>return index of current tile</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFDataWidth</big></p> +</td> +<td width="67%"> + +<p><big>return the size of TIFF data types</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFError</big></p> +</td> +<td width="67%"> + +<p><big>library error handler</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFdOpen</big></p> +</td> +<td width="67%"> + +<p><big>open a file for reading or writing</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFileName</big></p> +</td> +<td width="67%"> + +<p><big>return name of open file</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFileno</big></p> +</td> +<td width="67%"> + +<p><big>return open file descriptor</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFindCODEC</big></p> +</td> +<td width="67%"> + +<p><big>find standard codec for the specific +scheme</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFlush</big></p> +</td> +<td width="67%"> + +<p><big>flush all pending writes</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFFlushData</big></p> +</td> +<td width="67%"> + +<p><big>flush pending data writes</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFGetBitRevTable</big></p> +</td> +<td width="67%"> + +<p><big>return bit reversal table</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFGetField</big></p> +</td> +<td width="67%"> + +<p><big>return tag value in current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFGetFieldDefaulted</big></p> +</td> +<td width="67%"> + +<p><big>return tag value in current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFGetMode</big></p> +</td> +<td width="67%"> + +<p><big>return open file mode</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFGetVersion</big></p> +</td> +<td width="67%"> + +<p><big>return library version string</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFIsCODECConfigured</big></p> +</td> +<td width="67%"> + +<p><big>check, whether we have working codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFIsMSB2LSB</big></p> +</td> +<td width="67%"> + +<p><big>return true if image data is being +returned</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"></td> +<td width="67%"> + +<p><big>with bit 0 as the most significant bit</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFIsTiled</big></p> +</td> +<td width="67%"> + +<p><big>return true if image data is tiled</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFIsByteSwapped</big></p> +</td> +<td width="67%"> + +<p><big>return true if image data is byte-swapped</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFNumberOfStrips</big></p> +</td> +<td width="67%"> + +<p><big>return number of strips in an image</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFNumberOfTiles</big></p> +</td> +<td width="67%"> + +<p><big>return number of tiles in an image</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFOpen</big></p> +</td> +<td width="67%"> + +<p><big>open a file for reading or writing</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFPrintDirectory</big></p> +</td> +<td width="67%"> + +<p><big>print description of the current +directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadBufferSetup</big></p> +</td> +<td width="67%"> + +<p><big>specify i/o buffer for reading</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadDirectory</big></p> +</td> +<td width="67%"> + +<p><big>read the next directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadEncodedStrip</big></p> +</td> +<td width="67%"> + +<p><big>read and decode a strip of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadEncodedTile</big></p> +</td> +<td width="67%"> + +<p><big>read and decode a tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadRawStrip</big></p> +</td> +<td width="67%"> + +<p><big>read a raw strip of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadRawTile</big></p> +</td> +<td width="67%"> + +<p><big>read a raw tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadRGBAImage</big></p> +</td> +<td width="67%"> + +<p><big>read an image into a fixed format raster</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadScanline</big></p> +</td> +<td width="67%"> + +<p><big>read and decode a row of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReadTile</big></p> +</td> +<td width="67%"> + +<p><big>read and decode a tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRegisterCODEC</big></p> +</td> +<td width="67%"> + +<p><big>override standard codec for the specific +scheme</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFReverseBits</big></p> +</td> +<td width="67%"> + +<p><big>reverse bits in an array of bytes</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRGBAImageBegin</big></p> +</td> +<td width="67%"> + +<p><big>setup decoder state for TIFFRGBAImageGet</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRGBAImageEnd</big></p> +</td> +<td width="67%"> + +<p><big>release TIFFRGBAImage decoder state</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRGBAImageGet</big></p> +</td> +<td width="67%"> + +<p><big>read and decode an image</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRGBAImageOK</big></p> +</td> +<td width="67%"> + +<p><big>is image readable by TIFFRGBAImageGet</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFScanlineSize</big></p> +</td> +<td width="67%"> + +<p><big>return size of a scanline</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSetDirectory</big></p> +</td> +<td width="67%"> + +<p><big>set the current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSetSubDirectory</big></p> +</td> +<td width="67%"> + +<p><big>set the current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSetErrorHandler</big></p> +</td> +<td width="67%"> + +<p><big>set error handler function</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSetField</big></p> +</td> +<td width="67%"> + +<p><big>set a tag’s value in the current +directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSetWarningHandler</big></p> +</td> +<td width="67%"> + +<p><big>set warning handler function</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFStripSize</big></p> +</td> +<td width="67%"> + +<p><big>returns size of a strip</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFRawStripSize</big></p> +</td> +<td width="67%"> + +<p><big>returns the number of bytes in a raw +strip</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSwabShort</big></p> +</td> +<td width="67%"> + +<p><big>swap bytes of short</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSwabLong</big></p> +</td> +<td width="67%"> + +<p><big>swap bytes of long</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSwabArrayOfShort</big></p> +</td> +<td width="67%"> + +<p><big>swap bytes of an array of shorts</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFSwabArrayOfLong</big></p> +</td> +<td width="67%"> + +<p><big>swap bytes of an array of longs</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFTileRowSize</big></p> +</td> +<td width="67%"> + +<p><big>return size of a row in a tile</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFTileSize</big></p> +</td> +<td width="67%"> + +<p><big>return size of a tile</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFUnRegisterCODEC</big></p> +</td> +<td width="67%"> + +<p><big>unregisters the codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFVGetField</big></p> +</td> +<td width="67%"> + +<p><big>return tag value in current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFVGetFieldDefaulted</big></p> +</td> +<td width="67%"> + +<p><big>return tag value in current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFVSetField</big></p> +</td> +<td width="67%"> + +<p><big>set a tag’s value in the current +directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFVStripSize</big></p> +</td> +<td width="67%"> + +<p><big>returns the number of bytes in a strip</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWarning</big></p> +</td> +<td width="67%"> + +<p><big>library warning handler</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteDirectory</big></p> +</td> +<td width="67%"> + +<p><big>write the current directory</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteEncodedStrip</big></p> +</td> +<td width="67%"> + +<p><big>compress and write a strip of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteEncodedTile</big></p> +</td> +<td width="67%"> + +<p><big>compress and write a tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteRawStrip</big></p> +</td> +<td width="67%"> + +<p><big>write a raw strip of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteRawTile</big></p> +</td> +<td width="67%"> + +<p><big>write a raw tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteScanline</big></p> +</td> +<td width="67%"> + +<p><big>write a scanline of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFWriteTile</big></p> +</td> +<td width="67%"> + +<p><big>compress and write a tile of data</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFXYZToRGB</big></p> +</td> +<td width="67%"> + +<p><big>perform CIE XYZ to RGB conversion</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFYCbCrToRGBInit</big></p> +</td> +<td width="67%"> + +<p><big>initialize YCbCr to RGB conversion state</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>TIFFYCbCrtoRGB</big></p> +</td> +<td width="67%"> + +<p><big>perform YCbCr to RGB conversion</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Auxiliary functions:</big></p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFfree</big></p> +</td> +<td width="67%"> + +<p><big>free memory buffer</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFmalloc</big></p> +</td> +<td width="67%"> + +<p><big>dynamically allocate memory buffer</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFmemcmp</big></p> +</td> +<td width="67%"> + +<p><big>compare contents of the memory buffers</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFmemcpy</big></p> +</td> +<td width="67%"> + +<p><big>copy contents of the one buffer to +another</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFmemset</big></p> +</td> +<td width="67%"> + +<p><big>fill memory buffer with a constant byte</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="23%"> + +<p><big>_TIFFrealloc</big></p> +</td> +<td width="67%"> + +<p><big>dynamically reallocate memory buffer</big></p> +</td> +</table> +<a name="TAG USAGE"></a> +<h2>TAG USAGE</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The table below lists the</big> TIFF <big>tags that +are recognized and handled by the library. If no use is +indicated in the table, then the library reads and writes +the tag, but does not use it internally. Note that some tags +are meaningful only when a particular compression scheme is +being used; e.g. <i>Group3Options</i> is only useful if +<i>Compression</i> is set to</big> CCITT <big>Group 3 +encoding. Tags of this sort are considered +<i>codec-specific</i> tags and the library does not +recognize them except when the <i>Compression</i> tag has +been previously set to the relevant compression +scheme.</big></p> +<!-- INDENTATION --> +<pre><big><i>Tag Name Value R/W Library Use/Notes +</i></big></pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Artist</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>315</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>BadFaxLines</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>326</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>BitsPerSample</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>258</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>lots</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>CellLength</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>265</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>CellWidth</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>264</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>CleanFaxData</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>327</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ColorMap</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>320</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ColorResponseUnit</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>300</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Compression</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>259</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>choosing codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ConsecutiveBadFaxLines</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>328</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>Copyright 33432 R/W</big></p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>DataType</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>32996</big></p> +</td> +<td width="53%"> + +<p><big>R</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>obsoleted by SampleFormat tag</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>DateTime</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>306</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>DocumentName</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>269</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>DotRange</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>336</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ExtraSamples</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>338</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>lots</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FaxRecvParams</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>34908</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FaxSubAddress</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>34909</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FaxRecvTime</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>34910</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FillOrder</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>266</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>control bit order</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FreeByteCounts</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>289</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>FreeOffsets</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>288</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>GrayResponseCurve</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>291</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>GrayResponseUnit</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>290</big></p> +</td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>parsed but ignored</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Group3Options</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>292</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by Group 3 codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Group4Options</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>293</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>HostComputer</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>316</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ImageDepth</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>32997</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>tile/strip calculations</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ImageDescription</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>270</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ImageLength</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>257</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>lots</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ImageWidth</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>256</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>lots</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>InkNames</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>333</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>InkSet</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>332</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>JPEGTables</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>347</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by JPEG codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Make</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>271</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Matteing</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>32995</big></p> +</td> +<td width="53%"> + +<p><big>R</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>obsoleted by ExtraSamples tag</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>MaxSampleValue</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>281</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>MinSampleValue</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>280</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Model</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>272</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>NewSubFileType</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>254</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>called SubFileType in spec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>NumberOfInks</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>334</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Orientation</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>274</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>PageName</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>285</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>PageNumber</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>297</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>PhotometricInterpretation</big></p> +</td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>262</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>R/Wused by Group 3 and JPEG codecs</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>PlanarConfiguration</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>284</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Predictor</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>317</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by LZW and Deflate codecs</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>PrimaryChromacities</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>319</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ReferenceBlackWhite</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>532</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>ResolutionUnit</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>296</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by Group 3 codec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>RowsPerStrip</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>278</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>SampleFormat</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>339</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>SamplesPerPixel</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>277</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>lots</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>SMinSampleValue</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>340</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>SMaxSampleValue</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>341</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Software</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>305</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>StoNits</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>37439</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>StripByteCounts</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>279</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>StripOffsets</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>273</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>SubFileType</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>255</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>called OSubFileType in spec</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TargetPrinter</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>337</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>Thresholding</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>263</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TileByteCounts</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>324</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TileDepth</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>32998</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>tile/strip calculations</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TileLength</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>323</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TileOffsets</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>324</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TileWidth</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>322</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>data i/o</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TransferFunction</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>301</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>WhitePoint</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>318</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>XPosition</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>286</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>XResolution</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>282</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>YCbCrCoefficients</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>529</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by TIFFRGBAImage support</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>YCbCrPositioning</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>531</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>tile/strip size calulcations</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>YCbCrSubsampling</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>530</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>YPosition</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>286</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>YResolution</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>283</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>used by Group 3 codec</big></p> +</td> +</table> +<a name="PSEUDO TAGS"></a> +<h2>PSEUDO TAGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>In addition to the normal</big> TIFF <big>tags the +library supports a collection of tags whose values lie in a +range outside the valid range of</big> TIFF <big>tags. These +tags are termed <i>pseud-tags</i> and are used to control +various codec-specific functions within the library. The +table below summarizes the defined pseudo-tags.</big></p> +<!-- INDENTATION --> +<pre><big><i>Tag Name Codec R/W Library Use/Notes +</i></big></pre> +</td> +</table> +<!-- TABS --> + +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_FAXMODE</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>G3</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>general codec operation</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_FAXFILLFUNC</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>G3/G4</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>bitmap fill function</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_JPEGQUALITY</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>JPEG</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>compression quality control</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_JPEGCOLORMODE</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>JPEG</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>control colorspace conversions</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_JPEGTABLESMODE</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>JPEG</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>control contents of <i>JPEGTables</i> tag</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_ZIPQUALITY</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>Deflate</big></p> +</td> +<td width="53%"> + +<p><big>R/Wcompression quality level</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_PIXARLOGDATAFMT</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>PixarLog</big></p> +</td> +<td width="53%"> + +<p><big>R/Wuser data format</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_PIXARLOGQUALITY</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>PixarLog</big></p> +</td> +<td width="53%"> + +<p><big>R/Wcompression quality level</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"> + +<p><big>TIFFTAG_SGILOGDATAFMT</big></p> +</td> +<td width="8%"></td> +<td width="6%"> + +<p><big>SGILog</big></p> +</td> +<td width="53%"> + +<p><big>R/W</big></p> +</td> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="21%"></td> +<td width="8%"></td> +<td width="6%"></td> +<td width="53%"> + +<p><big>user data format</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_FAXMODE</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the operation of the Group 3 codec. Possible +values (independent bits that can be combined by +or’ing them together) are: FAXMODE_CLASSIC (enable +old-style format in which the</big> RTC <big>is written at +the end of the last strip), FAXMODE_NORTC (opposite of +FAXMODE_CLASSIC; also called FAXMODE_CLASSF), FAXMODE_NOEOL +(do not write</big> EOL <big>codes at the start of each row +of data), FAXMODE_BYTEALIGN (align each encoded row to an +8-bit boundary), FAXMODE_WORDALIGN (align each encoded row +to an 16-bit boundary), The default value is dependent on +the compression scheme; this pseudo-tag is used by the +various G3 and G4 codecs to share code.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_FAXFILLFUNC</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the function used to convert arrays of black +and white runs to packed bit arrays. This hook can be used +to image decoded scanlines in multi-bit depth rasters (e.g. +for display in colormap mode) or for other purposes. The +default value is a pointer to a builtin function that images +packed bilevel data.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_IPTCNEWSPHOTO</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Tag contaings image metadata per the IPTC newsphoto +spec: Headline, captioning, credit, etc... Used by most wire +services.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_PHOTOSHOP</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Tag contains Photoshop captioning information and +metadata. Photoshop uses in parallel and redundantly +alongside IPTCNEWSPHOTO information.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_JPEGQUALITY</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the compression quality level used in the +baseline algorithm. Note that quality levels are in the +range 0-100 with a default value of 75.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_JPEGCOLORMODE</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control whether or not conversion is done between +RGB and YCbCr colorspaces. Possible values are: +JPEGCOLORMODE_RAW (do not convert), and JPEGCOLORMODE_RGB +(convert to/from RGB) The default value is +JPEGCOLORMODE_RAW.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_JPEGTABLESMODE</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the information written in the +<i>JPEGTables</i> tag. Possible values (independent bits +that can be combined by or’ing them together) are: +JPEGTABLESMODE_QUANT (include quantization tables), and +JPEGTABLESMODE_HUFF (include Huffman encoding tables). The +default value is +JPEGTABLESMODE_QUANT|JPEGTABLESMODE_HUFF.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_ZIPQUALITY</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the compression technique used by the +Deflate codec. Quality levels are in the range 1-9 with +larger numbers yielding better compression at the cost of +more computation. The default quality level is 6 which +yields a good time-space tradeoff.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_PIXARLOGDATAFMT</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the format of user data passed <i>in</i> to +the PixarLog codec when encoding and passed <i>out</i> from +when decoding. Possible values are: PIXARLOGDATAFMT_8BIT for +8-bit unsigned pixels, PIXARLOGDATAFMT_8BITABGR for 8-bit +unsigned ABGR-ordered pixels, PIXARLOGDATAFMT_11BITLOG for +11-bit log-encoded raw data, PIXARLOGDATAFMT_12BITPICIO for +12-bit PICIO-compatible data, PIXARLOGDATAFMT_16BIT for +16-bit signed samples, and PIXARLOGDATAFMT_FLOAT for 32-bit +IEEE floating point samples.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_PIXARLOGQUALITY</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the compression technique used by the +PixarLog codec. This value is treated identically to +TIFFTAG_ZIPQUALITY; see the above description.</big></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>TIFFTAG_SGILOGDATAFMT</b></big></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p><big>Control the format of client data passed <i>in</i> +to the SGILog codec when encoding and passed <i>out</i> from +when decoding. Possible values are: SGILOGDATAFMT_FLTXYZ for +converting between LogLuv and 32-bit IEEE floating valued +XYZ pixels, SGILOGDATAFMT_16BITLUV for 16-bit encoded Luv +pixels, SGILOGDATAFMT_32BITRAW and SGILOGDATAFMT_24BITRAW +for no conversion of data, SGILOGDATAFMT_8BITRGB for +returning 8-bit RGB data (valid only when decoding +LogLuv-encoded data), SGILOGDATAFMT_FLTY for converting +between LogL and 32-bit IEEE floating valued Y pixels, +SGILOGDATAFMT_16BITL for 16-bit encoded L pixels, and +SGILOGDATAFMT_8BITGRY for returning 8-bit greyscale data +(valid only when decoding LogL-encoded data).</big></p> +</td> +</table> +<a name="DIAGNOSTICS"></a> +<h2>DIAGNOSTICS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>All error messages are directed through the +<i>TIFFError</i> routine. By default messages are directed +to <b>stderr</b> in the form: <i>module: message\n.</i> +Warning messages are likewise directed through the +<i>TIFFWarning</i> routine.</big></p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big><b>fax2tiff</b>(1), <b>gif2tiff</b>(1), +<b>pal2rgb</b>(1), <b>ppm2tiff</b>(1), <b>rgb2ycbcr</b>(1), +<b>ras2tiff</b>(1), <b>raw2tiff</b>(1), <b>sgi2tiff</b>(1), +<b>tiff2bw</b>(1), <b>tiffdither</b>(1), <b>tiffdump</b>(1), +<b>tiffcp</b>(1), <b>tiffcmp</b>(1), <b>tiffgt</b>(1), +<b>tiffinfo</b>(1), <b>tiffmedian</b>(1), +<b>tiffsplit</b>(1), <b>tiffsv</b>(1).</big></p> +<!-- INDENTATION --> +<p><big><b>Tag Image File Format Specification — +Revision 6.0</b>, an Aldus Technical Memorandum.</big></p> +<!-- INDENTATION --> +<p><big><b>The Spirit of TIFF Class F</b>, an appendix to +the TIFF 5.0 specification prepared by Cygnet +Technologies.</big></p> +<!-- INDENTATION --> +<p><big>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></big></p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><big>The library does not support multi-sample images +where some samples have different bits/sample.</big></p> +<!-- INDENTATION --> +<p><big>The library does not support random access to +compressed data that is organized with more than one row per +tile or strip.</big></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/pal2rgb.1.html b/src/3rdparty/libtiff/html/man/pal2rgb.1.html new file mode 100644 index 0000000..5708161 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/pal2rgb.1.html @@ -0,0 +1,189 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>PAL2RGB</title> +</head> +<body> + +<h1 align=center>PAL2RGB</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>pal2rgb − convert a palette color +<small>TIFF</small> image to a full color image</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b> [ <i>options</i> ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Pal2rgb</i> converts a palette color +<small>TIFF</small> image to a full color image by applying +the colormap of the palette image to each sample to generate +a full color <small>RGB</small> image.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Options that affect the interpretation of input data +are:</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−C</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>This option overrides the default behavior of +<i>pal2rgb</i> in determining whether or not colormap +entries contain 16-bit or 8-bit values. By default the +colormap is inspected and if no colormap entry greater than +255 is found, the colormap is assumed to have only 8-bit +values; otherwise 16-bit values (as required by the +<small>TIFF</small> specification) are assumed. The +<b>−C</b> option can be used to explicitly specify the +number of bits for colormap entries: <b>−C 8</b> for +8-bit values, <b>−C 16</b> for 16-bit values.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Options that affect the output file format are:</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="5%"> + +<p><b>−p</b></p> +</td> +<td width="3%"></td> +<td width="80%"> + +<p>Explicitly select the planar configuration used in +organizing data samples in the output image: <b>−p +contig</b> for samples packed contiguously, and <b>−p +separate</b> for samples stored separately. By default +samples are packed.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="5%"> + +<p><b>−c</b></p> +</td> +<td width="3%"></td> +<td width="80%"> + +<p>Use the specific compression algorithm to encoded image +data in the output file: <b>−c packbits</b> for +Macintosh Packbits, <b>−c lzw</b> for Lempel-Ziv & +Welch, <b>−c zip</b> for Deflate, <b>−c none</b> +for no compression. If no compression-related option is +specified, the input file’s compression algorithm is +used.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="5%"> + +<p><b>−r</b></p> +</td> +<td width="3%"></td> +<td width="80%"> + +<p>Explicitly specify the number of rows in each strip of +the output file. If the <b>−r</b> option is not +specified, a number is selected such that each output strip +has approximately 8 kilobytes of data in it.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Only 8-bit images are handled.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/ppm2tiff.1.html b/src/3rdparty/libtiff/html/man/ppm2tiff.1.html new file mode 100644 index 0000000..b2e1bcc --- /dev/null +++ b/src/3rdparty/libtiff/html/man/ppm2tiff.1.html @@ -0,0 +1,141 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>PPM2TIFF</title> +</head> +<body> + +<h1 align=center>PPM2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>ppm2tiff − create a <small>TIFF</small> file from +<small>PPM, PGM</small> and <small>PBM</small> image +files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ppm2tiff</b> [ <i>options</i> ] [ <i>input.ppm</i> ] +<i>output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>ppm2tiff</i> converts a file in the <small>PPM, +PGM</small> and <small>PBM</small> image formats to +<small>TIFF.</small> By default, the <small>TIFF</small> +image is created with data samples packed +(<i>PlanarConfiguration</i>=1), compressed with the Packbits +algorithm (<i>Compression</i>=32773), and with each strip no +more than 8 kilobytes. These characteristics can be +overridden, or explicitly specified with the options +described below</p> +<!-- INDENTATION --> +<p>If the <small>PPM</small> file contains greyscale data, +then the <i>PhotometricInterpretation</i> tag is set to 1 +(min-is-black), otherwise it is set to 2 (RGB).</p> +<!-- INDENTATION --> +<p>If no <small>PPM</small> file is specified on the command +line, <i>ppm2tiff</i> will read from the standard input.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>none</b> for no compression, <b>packbits</b> for +PackBits compression (will be used by default), <b>lzw</b> +for Lempel-Ziv & Welch compression, <b>jpeg</b> for +baseline JPEG compression, <b>zip</b> for Deflate +compression, <b>g3</b> for CCITT Group 3 (T.4) compression, +and <b>g4</b> for CCITT Group 4 (T.6) compression.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Write data with a specified number of rows per strip; by +default the number of rows/strip is selected so that each +strip is approximately 8 kilobytes.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−R</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Mark the resultant image to have the specified X and Y +resolution (in dots/inch).</p> +</td> +<td width="0%"> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/ras2tiff.1.html b/src/3rdparty/libtiff/html/man/ras2tiff.1.html new file mode 100644 index 0000000..f36a472 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/ras2tiff.1.html @@ -0,0 +1,139 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>RAS2TIFF</title> +</head> +<body> + +<h1 align=center>RAS2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>ras2tiff − create a <small>TIFF</small> file from a +Sun rasterfile</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>ras2tiff</b> [ <i>options</i> ] <i>input.ras +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>ras2tiff</i> converts a file in the Sun rasterfile +format to <small>TIFF.</small> By default, the +<small>TIFF</small> image is created with data samples +packed (<i>PlanarConfiguration</i>=1), compressed with the +Lempel-Ziv & Welch algorithm (<i>Compression</i>=5), and +with each strip no more than 8 kilobytes. These +characteristics can overridden, or explicitly specified with +the options described below.</p> +<!-- INDENTATION --> +<p>Any colormap information in the rasterfile is carried +over to the <small>TIFF</small> file by including a +<i>Colormap</i> tag in the output file. If the rasterfile +has a colormap, the <i>PhotometricInterpretation</i> tag is +set to 3 (palette); otherwise it is set to 2 (RGB) if the +depth is 24 or 1 (min-is-black) if the depth is not 24.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−c</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>-c +packbits</b> for the PackBits compression algorithm, <b>-c +jpeg</b> for the baseline JPEG compression algorithm, <b>-c +zip</b> for the Deflate compression algorithm, and +<b>−c lzw</b> for Lempel-Ziv & Welch (the +default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−r</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Write data with a specified number of rows per strip; by +default the number of rows/strip is selected so that each +strip is approximately 8 kilobytes.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Does not handle all possible rasterfiles. In particular, +<i>ras2tiff</i> does not handle run-length encoded +images.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/raw2tiff.1.html b/src/3rdparty/libtiff/html/man/raw2tiff.1.html new file mode 100644 index 0000000..21e4f4f --- /dev/null +++ b/src/3rdparty/libtiff/html/man/raw2tiff.1.html @@ -0,0 +1,553 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>RAW2TIFF</title> +</head> +<body> + +<h1 align=center>RAW2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#GUESSING THE IMAGE GEOMETRY">GUESSING THE IMAGE GEOMETRY</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>raw2tiff − create a <small>TIFF</small> file from a +raw data</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>raw2tiff</b> [ <i>options</i> ] <i>input.raw +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>raw2tiff</i> converts a raw byte sequence into +<small>TIFF.</small> By default, the <small>TIFF</small> +image is created with data samples packed +(<i>PlanarConfiguration</i>=1), compressed with the PackBits +algorithm (<i>Compression</i>=<i>32773),</i> and with each +strip no more than 8 kilobytes. These characteristics can +overridden, or explicitly specified with the options +described below.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−H <number></b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>size of input image file header in bytes (0 by default). +This amount of data just will be skipped from the start of +file while reading.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−w <number></b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>width of input image in pixels (can be guessed, see +<b><small>GUESSING THE IMAGE GEOMETRY</small></b> +below).</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−l <number></b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>length of input image in lines(can be guessed, see +<b><small>GUESSING THE IMAGE GEOMETRY</small></b> +below).</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−b <number></b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>number of bands in input image (1 by default).</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−d data_type</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>type of samples in input image, where <b>data_type</b> +may be:</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>byte</i></p> +</td> +<td width="6%"> +</td> +<td width="6%"> + +<p>8-bit unsigned integer (default),</p> +</td> +<td width="61%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>short</i></p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>16-bit unsigned integer,</p> +</td> +<td width="61%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>long</i></p> +</td> +<td width="6%"> +</td> +<td width="6%"> + +<p>32-bit unsigned integer,</p> +</td> +<td width="61%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>sbyte</i></p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>8-bit signed integer,</p> +</td> +<td width="61%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>sshort</i></p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>16-bit signed integer,</p> +</td> +<td width="61%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>slong</i></p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>32-bit signed integer,</p> +</td> +<td width="61%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>float</i></p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>32-bit IEEE floating point,</p> +</td> +<td width="61%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>double</i></p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>64-bit IEEE floating point,</p> +</td> +<td width="61%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−i config</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>type of samples interleaving in input image, where +<b>config</b> may be:</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>pixel</i></p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>pixel interleaved data (default),</p> +</td> +<td width="61%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>band</i></p> +</td> +<td width="6%"> +</td> +<td width="6%"> + +<p>band interleaved data.</p> +</td> +<td width="61%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−p photo</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>photometric interpretation (color space) of the input +image, where <b>photo</b> may be:<i><br> +miniswhite</i> white color represented with 0 value,<i><br> +minisblack</i> black color represented with 0 value +(default),</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="6" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>rgb</i></p> +</td> +<td width="6%"> +</td> +<td width="6%"> + +<p>image has RGB color model,</p> +</td> +<td width="6%"></td> +<td width="55%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>cmyk</i></p> +</td> +<td width="6%"> +</td> +<td width="6%"> + +<p>image has CMYK (separated) color model,</p> +</td> +<td width="6%"></td> +<td width="55%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>ycbcr</i></p> +</td> +<td width="6%"></td> +<td width="6%"> +</td> +<td width="6%"> + +<p>image has YCbCr color model,</p> +</td> +<td width="55%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>cielab</i></p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>image has CIE L*a*b color model,</p> +</td> +<td width="6%"></td> +<td width="55%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>icclab</i></p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>image has ICC L*a*b color model,</p> +</td> +<td width="6%"></td> +<td width="55%"> +</td> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="6%"> + +<p><i>itulab</i></p> +</td> +<td width="6%"></td> +<td width="6%"> + +<p>image has ITU L*a*b color model,</p> +</td> +<td width="6%"></td> +<td width="55%"> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>swap bytes fetched from the input file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−L</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>input data has LSB2MSB bit order (default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−M</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>input data has MSB2LSB bit order.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>-c +packbits</b> for the PackBits compression algorithm (the +default), <b>-c jpeg</b> for the baseline JPEG compression +algorithm, <b>-c zip</b> for the Deflate compression +algorithm, and <b>−c lzw</b> for Lempel-Ziv & +Welch.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−r <number></b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Write data with a specified number of rows per strip; by +default the number of rows/strip is selected so that each +strip is approximately 8 kilobytes.</p> +</td> +</table> +<a name="GUESSING THE IMAGE GEOMETRY"></a> +<h2>GUESSING THE IMAGE GEOMETRY</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>raw2tiff</i> can guess image width and height in case +one or both of these parameters are not specified. If you +omit one of those parameters, the complementary one will be +calculated based on the file size (taking into account +header size, number of bands and data type). If you omit +both parameters, the statistical approach will be used. +Utility will compute correlation coefficient between two +lines at the image center using several appropriate line +sizes and the highest absolute value of the coefficient will +indicate the right line size. That is why you should be +cautious with the very large images, because guessing +process may take a while (depending on your system +performance). Of course, the utility can’t guess the +header size, number of bands and data type, so it should be +specified manually. If you don’t know anything about +your image, just try with the several combinations of those +options.</p> +<!-- INDENTATION --> +<p>There is no magic, it is just a mathematical statistics, +so it can be wrong in some cases. But for most ordinary +images guessing method will work fine.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/rgb2ycbcr.1.html b/src/3rdparty/libtiff/html/man/rgb2ycbcr.1.html new file mode 100644 index 0000000..6b81a9e --- /dev/null +++ b/src/3rdparty/libtiff/html/man/rgb2ycbcr.1.html @@ -0,0 +1,154 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>RGB2YCBCR</title> +</head> +<body> + +<h1 align=center>RGB2YCBCR</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>rgb2ycbcr − convert non-YCbCr <small>TIFF</small> +images to a YCbCr <small>TIFF</small> image</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>rgb2ycbcr</b> [ <i>options</i> ] <i>src1.tif src2.tif +... dst.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>rgb2ycbcr</i> converts <small>RGB</small> color, +greyscale, or bi-level <small>TIFF</small> images to YCbCr +images by transforming and sampling pixel data. If multiple +files are specified on the command line each source file is +converted to a separate directory in the destination +file.</p> +<!-- INDENTATION --> +<p>By default, chrominance samples are created by sampling 2 +by 2 blocks of luminance values; this can be changed with +the <b>−h</b> and <b>−v</b> options. Output data +are compressed with the <small>PackBits</small> compression +scheme, by default; an alternate scheme can be selected with +the <b>−c</b> option. By default, output data are +compressed in strips with the number of rows in each strip +selected so that the size of a strip is never more than 8 +kilobytes; the <b>−r</b> option can be used to +explicitly set the number of rows per strip.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>-c +packbits</b> for the PackBits compression algorithm (the +default), <b>-c jpeg</b> for the JPEG compression algorithm, +<b>-c zip</b> for the deflate compression algorithm, and +<b>−c lzw</b> for Lempel-Ziv & Welch.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−h</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the horizontal sampling dimension to one of: 1, 2 +(default), or 4.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Write data with a specified number of rows per strip; by +default the number of rows/strip is selected so that each +strip is approximately 8 kilobytes.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−v</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the vertical sampling dimension to one of: 1, 2 +(default), or 4.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/sgi2tiff.1.html b/src/3rdparty/libtiff/html/man/sgi2tiff.1.html new file mode 100644 index 0000000..0a5c3b7 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/sgi2tiff.1.html @@ -0,0 +1,147 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>SGI2TIFF</title> +</head> +<body> + +<h1 align=center>SGI2TIFF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>sgi2tiff − create a <small>TIFF</small> file from +an <small>SGI</small> image file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>sgi2tiff</b> [ <i>options</i> ] <i>input.rgb +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>sgi2tiff</i> converts a file in the <small>SGI</small> +image format to <small>TIFF.</small> By default, the +<small>TIFF</small> image is created with data samples +packed (<i>PlanarConfiguration</i>=1), compressed with the +Lempel-Ziv & Welch algorithm (<i>Compression</i>=5), and +with each strip no more than 8 kilobytes. These +characteristics can overridden, or explicitly specified with +the options described below.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>-c +packbits</b> for the PackBits compression algorithm), <b>-c +jpeg</b> for the baseline JPEG compression algorithm, <b>-c +zip</b> for the Deflate compression algorithm, and +<b>−c lzw</b> for Lempel-Ziv & Welch (the +default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Explicitly select the planar configuration used in +organizing data samples in the output image: <b>−p +contig</b> for samples packed contiguously, and <b>−p +separate</b> for samples stored separately. By default +samples are packed.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Write data with a specified number of rows per strip; by +default the number of rows/strip is selected so that each +strip is approximately 8 kilobytes.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Does not record colormap information.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/thumbnail.1.html b/src/3rdparty/libtiff/html/man/thumbnail.1.html new file mode 100644 index 0000000..b78b461 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/thumbnail.1.html @@ -0,0 +1,148 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>THUMBNAIL</title> +</head> +<body> + +<h1 align=center>THUMBNAIL</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>thumbnail − create a <small>TIFF</small> file with +thumbnail images</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>thumbnail</b> [ <i>options</i> ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>thumbnail</i> is a program written to show how one +might use the SubIFD tag (#330) to store thumbnail images. +<i>thumbnail</i> copies a <small>TIFF</small> Class F +facsimile file to the output file and for each image an +8-bit greyscale <i>thumbnail sketch</i>. The output file +contains the thumbnail image with the associated +full-resolution page linked below with the SubIFD tag.</p> +<!-- INDENTATION --> +<p>By default, thumbnail images are 216 pixels wide by 274 +pixels high. Pixels are calculated by sampling and filtering +the input image with each pixel value passed through a +contrast curve.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−w</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the width of thumbnail images in pixels.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−h</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the height of thumbnail images in pixels.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a contrast curve to apply in generating the +thumbnail images. By default pixels values are passed +through a linear contrast curve that simply maps the pixel +value ranges. Alternative curves are: <b>exp50</b> for a 50% +exponential curve, <b>exp60</b> for a 60% exponential curve, +<b>exp70</b> for a 70% exponential curve, <b>exp80</b> for a +80% exponential curve, <b>exp90</b> for a 90% exponential +curve, <b>exp</b> for a pure exponential curve, +<b>linear</b> for a linear curve.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>There are no options to control the format of the saved +thumbnail images.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffdump</b>(1), <b>tiffgt</b>(1), <b>tiffinfo</b>(1), +<b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiff2bw.1.html b/src/3rdparty/libtiff/html/man/tiff2bw.1.html new file mode 100644 index 0000000..3acd5fe --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiff2bw.1.html @@ -0,0 +1,160 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFF2BW</title> +</head> +<body> + +<h1 align=center>TIFF2BW</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiff2bw − convert a color <small>TIFF</small> image +to greyscale</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiff2bw</b> [ options ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Tiff2bw</i> converts an <small>RGB</small> or Palette +color <small>TIFF</small> image to a greyscale image by +combining percentages of the red, green, and blue channels. +By default, output samples are created by taking 28% of the +red channel, 59% of the green channel, and 11% of the blue +channel. To alter these percentages, the <b>−R</b>, +<b>−G</b>, and <b>−B</b> options may be +used.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression, <b>-c +packbits</b> for the PackBits compression algorithm, <b>-c +zip</b> for the Deflate compression algorithm, <b>-c g3</b> +for the CCITT Group 3 compression algorithm, <b>-c g4</b> +for the CCITT Group 4 compression algorithm, and <b>−c +lzw</b> for Lempel-Ziv & Welch (the default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Write data with a specified number of rows per strip; by +default the number of rows/strip is selected so that each +strip is approximately 8 kilobytes.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−R</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the percentage of the red channel to use +(default 28).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−G</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the percentage of the green channel to use +(default 59).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−B</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the percentage of the blue channel to use +(default 11).</p> +</td> +<td width="0%"> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiff2pdf.1.html b/src/3rdparty/libtiff/html/man/tiff2pdf.1.html new file mode 100644 index 0000000..0efb263 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiff2pdf.1.html @@ -0,0 +1,599 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:12 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFF2PDF</title> +</head> +<body> + +<h1 align=center>TIFF2PDF</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#EXAMPLES">EXAMPLES</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p>tiff2pdf - convert a TIFF image to a PDF document</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>tiff2pdf [</b> <i>options</i> <b>]</b> +<i>input.tiff</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>tiff2pdf</b> opens a TIFF image and writes a PDF +document to standard output.</p> +<!-- INDENTATION --> +<p>The program converts one TIFF file to one PDF file, +including multiple page TIFF files, tiled TIFF files, black +and white. grayscale, and color TIFF files that contain data +of TIFF photometric interpretations of bilevel, grayscale, +RGB, YCbCr, CMYK separation, and ICC L*a*b* as supported by +<i>libtiff</i> and PDF.</p> +<!-- INDENTATION --> +<p>If you have multiple TIFF files to convert into one PDF +file then use <i>tiffcp</i> or other program to concatenate +the files into a multiple page TIFF file. If the input TIFF +file is of huge dimensions (greater than 10000 pixels height +or width) convert the input image to a tiled TIFF if it is +not already.</p> +<!-- INDENTATION --> +<p>The standard output is standard output. Set the output +file name with the <b>-o</b><i>output.pdf</i> option.</p> +<!-- INDENTATION --> +<p>All black and white files are compressed into a single +strip CCITT G4 Fax compressed PDF, unless tiled, where tiled +black and white images are compressed into tiled CCITT G4 +Fax compressed PDF, <i>libtiff</i> CCITT support is +assumed.</p> +<!-- INDENTATION --> +<p>Color and grayscale data can be compressed using either +JPEG compression, ITU-T T.81, or Zip/Deflate LZ77 +compression. Set the compression type using the +<b>−j</b> or <b>−z</b> options. JPEG compression +support requires that <i>libtiff</i> be configured with JPEG +support, and Zip/Deflate compression support requires that +<i>libtiff</i> be configured with Zip support, in +tiffconf.h. Use only one or the other of <b>−j</b> and +<b>−z.</b></p> +<!-- INDENTATION --> +<p>If the input TIFF contains single strip CCITT G4 Fax +compressed information, then that is written to the PDF file +without transcoding, unless the options of no compression +and no passthrough are set, <b>−d</b> and +<b>−n.</b></p> +<!-- INDENTATION --> +<p>If the input TIFF contains JPEG or single strip +Zip/Deflate compressed information, and they are configured, +then that is written to the PDF file without transcoding, +unless the options of no compression and no passthrough are +set.</p> +<!-- INDENTATION --> +<p>The default page size upon which the TIFF image is placed +is determined by the resolution and extent of the image +data. Default values for the TIFF image resolution can be +set using the <b>−x</b> and <b>−y</b> options. +The page size can be set using the <b>−p</b> option +for paper size, or <b>−w</b> and <b>−l</b> for +paper width and length, then each page of the TIFF image is +centered on its page. The distance unit for default +resolution and page width and length can be set by the +<b>−u</b> option, the default unit is inch.</p> +<!-- INDENTATION --> +<p>Various items of the output document information can be +set with the <b>−e, −c, −a, −t, +−s,</b> and <b>−k</b> options. Setting the +argument of the option to "" for these tags causes +the relevant document information field to be not written. +Some of the document information values otherwise get their +information from the input TIFF image, the software, author, +document name, and image description.</p> +<!-- INDENTATION --> +<p>The Portable Document Format (PDF) specification is +copyrighted by Adobe Systems, Incorporated.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−o</b><i>output-file</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set the output to go to file <i>output-file</i></p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="4" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="4%"> + +<p><b>−j</b></p> +</td> +<td width="5%"></td> +<td width="77%"> + +<p>Compress with JPEG (requires libjpeg configured with +libtiff).</p> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="4%"> + +<p><b>−z</b></p> +</td> +<td width="5%"></td> +<td width="77%"> + +<p>Compress with Zip/Deflate (requires zlib configured with +libtiff).</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−q</b><i>quality</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set the compression quality, 1-100 for JPEG.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="4" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−n</b></p> +</td> +<td width="7%"></td> +<td width="77%"> + +<p>Do not allow data to be converted without uncompressing, +no compressed data passthrough.</p> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−b</b></p> +</td> +<td width="7%"></td> +<td width="77%"> + +<p>Set PDF "Interpolate" user preference.</p> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−d</b></p> +</td> +<td width="7%"></td> +<td width="77%"> + +<p>Do not compress (decompress).</p> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−i</b></p> +</td> +<td width="7%"></td> +<td width="77%"> + +<p>Invert colors.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−p</b><i>paper-size</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set paper size, eg "letter", "legal", +"A4".</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−u</b><i>[i|m]</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set distance unit, <i>i</i> for inch, <i>m</i> for +centimeter.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−w</b><i>width</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set width in units.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−l</b><i>length</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set length in units.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="8%"> + +<p><b>−x</b><i>xres</i></p> +</td> +<td width="13%"></td> +<td width="47%"> + +<p>Set x/width resolution default.</p> +</td> +<td width="19%"> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="8%"> + +<p><b>−y</b><i>yres</i></p> +</td> +<td width="13%"></td> +<td width="47%"> + +<p>Set y/length resolution default.</p> +</td> +<td width="19%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−r</b><i>[d|o]</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set <i>d</i> for resolution default for images without +resolution, <i>o for resolution override for all +images.</i></p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−f</b></p> +</td> +<td width="13%"></td> +<td width="54%"> + +<p>Set PDF "Fit Window" user preference.</p> +</td> +<td width="17%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−e</b><i>YYYYMMDDHHMMSS</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information date, overrides image or current +date/time default, <i>YYYYMMDDHHMMSS.</i></p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−c</b><i>creator</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information creator, overrides image +software default.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−a</b><i>author</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information author, overrides image artist +default</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−t</b><i>title</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information title, overrides image document +name default</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−s</b><i>subject</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information subject, overrides image image +description default</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>−k</b><i>keywords</i></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="21%"></td> +<td width="77%"> +<p>Set document information keywords.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−h</b></p> +</td> +<td width="13%"></td> +<td width="57%"> + +<p>List usage reminder to stderr and exit.</p> +</td> +<td width="14%"> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> +</td> +<td width="13%"></td> +<td width="57%"> +<a name="EXAMPLES"></a> +<h2>EXAMPLES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p>The following example would generate the file output.pdf +from input.tiff.</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="20%"></td> +<td width="79%"> +<p>tiff2pdf -o output.pdf input.tiff</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p>The following example would generate PDF output from +input.tiff and write it to standard output.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="20%"></td> +<td width="79%"> +<p>tiff2pdf input.tiff</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p>The following example would generate the file output.pdf +from input.tiff, putting the image pages on a letter sized +page, compressing the output with JPEG, with JPEG quality +75, setting the title to "Document", and setting +the "Fit Window" option.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="20%"></td> +<td width="79%"> +<p>tiff2pdf -p letter -j -q 75 -t "Document" -f -o +output.pdf input.tiff</p></td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p>Please report bugs via the web interface at</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="20%"></td> +<td width="79%"> + +<p>http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="89%"> +<p><b>libtiff</b>(3)<b>, tiffcp</b>(1)<b>, +tiff2ps</b>(1)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiff2ps.1.html b/src/3rdparty/libtiff/html/man/tiff2ps.1.html new file mode 100644 index 0000000..e58887d --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiff2ps.1.html @@ -0,0 +1,536 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFF2PS</title> +</head> +<body> + +<h1 align=center>TIFF2PS</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#EXAMPLES">EXAMPLES</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiff2ps − convert a <small>TIFF</small> image to +™</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiff2ps</b> [ <i>options</i> ] <i>input.tif +...</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiff2ps</i> reads <small>TIFF</small> images and +writes or Encapsulated (EPS) on the standard output. By +default, <i>tiff2ps</i> writes Encapsulated for the first +image in the specified <small>TIFF</small> image file.</p> +<!-- INDENTATION --> +<p>By default, <i>tiff2ps</i> will generate that fills a +printed area specified by the <small>TIFF</small> tags in +the input file. If the file does not contain +<i>XResolution</i> or <i>YResolution</i> tags, then the +printed area is set according to the image dimensions. The +<b>−w</b> and <b>−h</b> options (see below) can +be used to set the dimensions of the printed area in inches; +overriding any relevant <small>TIFF</small> tags.</p> +<!-- INDENTATION --> +<p>The generated for <small>RGB,</small> palette, and +<small>CMYK</small> images uses the <i>colorimage</i> +operator. The generated for greyscale and bilevel images +uses the <i>image</i> operator. When the <i>colorimage</i> +operator is used, code to emulate this operator on older +printers is also generated. Note that this emulation code +can be very slow.</p> +<!-- INDENTATION --> +<p>Color images with associated alpha data are composited +over a white background.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−1</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate Level 1 (the default).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−2</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate Level 2.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−3</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate Level 3. It basically allows one to use the +/flateDecode filter for ZIP compressed TIFF images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−a</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate output for all IFDs (pages) in the input +file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−b</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the bottom margin for the output (in inches). +This does not affect the height of the printed image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Center the image in the output. This option only shows +an effect if both the -w and the -h option are given.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−d</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the initial <small>TIFF</small> directory to the +specified directory number. (NB: directories are numbered +starting at zero.) This option is useful for selecting +individual pages in a multi-page (e.g. facsimile) file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−e</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the generation of Encapsulated (implies -z).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−h</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the vertical size of the printed area (in +inches).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−H</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the maximum height of image (in inches). Images +with larger sizes will be split in several pages. Option +<b>−L</b> may be used for specifying size of split +images overlapping.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−i</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Enable/disable pixel interpolation. This option requires +a single numeric value: zero to disable pixel interpolation +and non-zero to enable. The default is enabled.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−L</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the size of overlapping for split images (in +inches). Used in conjunction with <b>−H</b> +option.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the left margin for the output (in inches). This +does not affect the width of the printed image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−m</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Where possible render using the <b>imagemask</b> +operator instead of the image operator. When this option is +specified <i>tiff2ps</i> will use <b>imagemask</b> for +rendering 1 bit deep images. If this option is not specified +or if the image depth is greater than 1 then the image +operator is used.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−o</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the initial <small>TIFF</small> directory to the +<small>IFD</small> at the specified file offset. This option +is useful for selecting thumbnail images and the like which +are hidden using the SubIFD tag.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the generation of (non-Encapsulated) .</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Rotate image by 180 degrees.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Generate output for a single IFD (page) in the input +file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−w</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the horizontal size of the printed area (in +inches).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−x</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Override resolution units specified in the TIFF as +centimeters.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−y</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Override resolution units specified in the TIFF as +inches.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−z</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>When generating Level 2, data is scaled so that it does +not image into the <i>deadzone</i> on a page (the outer +margin that the printing device is unable to mark). This +option suppresses this behavior. When Level 1 is generated, +data is imaged to the entire printed page and this option +has no affect.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="EXAMPLES"></a> +<h2>EXAMPLES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following generates Level 2 for all pages of a +facsimile:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiff2ps -a2 fax.tif | lpr +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Note also that if you have version 2.6.1 or newer of +Ghostscript then you can efficiently preview facsimile +generated with the above command.</p> +<!-- INDENTATION --> +<p>To generate Encapsulated for a the image at directory 2 +of an image use:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiff2ps -d 1 foo.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>(notice that directories are numbered starting at +zero.)</p> +<!-- INDENTATION --> +<p>If you have a long image, it may be split in several +pages:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiff2ps -h11 -w8.5 -H14 -L.5 foo.tif > foo.ps +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The page size is set to 8.5x11 by <b>−w</b> and +<b>−h</b> options. We will accept a small amount of +vertical compression, so <b>−H</b> set to 14. Any +pages between 11 and 14 inches will be fit onto one page. +Pages longer than 14 inches are cut off at 11 and continued +on the next page. The <b>−L.5</b> option says to +repeat a half inch on the next page (to improve +readability).</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Because does not support the notion of a colormap, 8-bit +palette images produce 24-bit images. This conversion +results in output that is six times bigger than the original +image and which takes a long time to send to a printer over +a serial line. Matters are even worse for 4-, 2-, and 1-bit +palette images.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Does not handle tiled images when generating PS Level I +output.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffgt</b>(1), <b>tiffmedian</b>(1), <b>tiff2bw</b>(1), +<b>tiffsv</b>(1), <b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiff2rgba.1.html b/src/3rdparty/libtiff/html/man/tiff2rgba.1.html new file mode 100644 index 0000000..b39a279 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiff2rgba.1.html @@ -0,0 +1,161 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFF2RGBA</title> +</head> +<body> + +<h1 align=center>TIFF2RGBA</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiff2rgba − convert a <small>TIFF</small> image to +RGBA color space</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiff2rgba</b> [ options ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Tiff2rgba</i> converts a wide variety of TIFF images +into an RGBA TIFF image. This includes the ability to +translate different color spaces and photometric +interpretation into RGBA, support for alpha blending, and +translation of many different bit depths into a 32bit RGBA +image.</p> +<!-- INDENTATION --> +<p>Internally this program is implemented using the +<i>TIFFReadRGBAImage()</i> function, and it suffers any +limitations of that image. This includes limited support for +> 8 BitsPerSample images, and flaws with some esoteric +combinations of BitsPerSample, photometric interpretation, +block organization and planar configuration.</p> +<!-- INDENTATION --> +<p>The generated images are stripped images with four +samples per pixel (red, green, blue and alpha) or if the -n +flag is used, three samples per pixel (red, green, and +blue). The resulting images are always planar configuration +contiguous. For this reason, this program is a useful +utility for transform exotic TIFF files into a form +ingestible by almost any TIFF supporting software.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify a compression scheme to use when writing image +data: <b>−c none</b> for no compression (the default), +<b>-c packbits</b> for the PackBits compression algorithm, +<b>-c zip</b> for the Deflate compression algorithm, <b>-c +jpeg</b> for the JPEG compression algorithm, and <b>−c +lzw</b> for Lempel-Ziv & Welch.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Write data with a specified number of rows per strip; by +default the number of rows/strip is selected so that each +strip is approximately 8 kilobytes.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−b</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Process the image one block (strip/tile) at a time +instead of by reading the whole image into memory at once. +This may be necessary for very large images on systems with +limited RAM.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−n</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Drop the alpha component from the output file, producing +a pure RGB file. Currently this does not work if the -b flag +is also in effect.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiff2bw</b>(1), <b>TIFFReadRGBAImage</b>(3t), +<b>libtiff</b>(3)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffcmp.1.html b/src/3rdparty/libtiff/html/man/tiffcmp.1.html new file mode 100644 index 0000000..339bce9 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffcmp.1.html @@ -0,0 +1,156 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFCMP</title> +</head> +<body> + +<h1 align=center>TIFFCMP</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffcmp − compare two <small>TIFF</small> files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffcmp</b> [ <i>options</i> ] <i>file1.tif +file2.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Tiffcmp</i> compares the tags and data in two files +created according to the Tagged Image File Format, Revision +6.0. The schemes used for compressing data in each file are +immaterial when data are compared−data are compared on +a scanline-by-scanline basis after decompression. Most +directory tags are checked; notable exceptions are: +<i>GrayResponseCurve</i>, <i>ColorResponseCurve</i>, and +<i>ColorMap</i> tags. Data will not be compared if any of +the <i>BitsPerSample</i>, <i>SamplesPerPixel</i>, or +<i>ImageWidth</i> values are not equal. By default, +<i>tiffcmp</i> will terminate if it encounters any +difference.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>List each byte of image data that differs between the +files.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−z number</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>List specified number of image data bytes that differs +between the files.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−t</b></p> +</td> +<td width="11%"></td> +<td width="52%"> + +<p>Ignore any differences in directory tags.</p> +</td> +<td width="23%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Tags that are not recognized by the library are not +compared; they may also generate spurious diagnostics.</p> +<!-- INDENTATION --> +<p>The image data of tiled files is not compared, since the +TIFFReadScanline() function is used. A error will be +reported for tiled files.</p> +<!-- INDENTATION --> +<p>The pixel and/or sample number reported in differences +may be off in some exotic cases.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffcp.1.html b/src/3rdparty/libtiff/html/man/tiffcp.1.html new file mode 100644 index 0000000..310783a --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffcp.1.html @@ -0,0 +1,484 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFCP</title> +</head> +<body> + +<h1 align=center>TIFFCP</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#EXAMPLES">EXAMPLES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffcp − copy (and possibly convert) a +<small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffcp</b> [ <i>options</i> ] <i>src1.tif ... srcN.tif +dst.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffcp</i> combines one or more files created +according to the Tag Image File Format, Revision 6.0 into a +single <small>TIFF</small> file. Because the output file may +be compressed using a different algorithm than the input +files, <i>tiffcp</i> is most often used to convert between +different compression schemes.</p> +<!-- INDENTATION --> +<p>By default, <i>tiffcp</i> will copy all the understood +tags in a <small>TIFF</small> directory of an input file to +the associated directory in the output file.</p> +<!-- INDENTATION --> +<p><i>tiffcp</i> can be used to reorganize the storage +characteristics of data in a file, but it is explicitly +intended to not alter or convert the image data content in +any way.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−b image</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>subtract the following monochrome image from all others +processed. This can be used to remove a noise bias from a +set of images. This bias image is typically an image of +noise the camera saw with its shutter closed.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−B</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be written with Big-Endian byte order. +This option only has an effect when the output file is +created or overwritten and not when it is appended to.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−C</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Suppress the use of ‘‘strip +chopping’’ when reading images that have a +single strip/tile of uncompressed data.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the compression to use for data written to the +output file: <b>none</b> for no compression, <b>packbits</b> +for PackBits compression, <b>lzw</b> for Lempel-Ziv & +Welch compression, <b>jpeg</b> for baseline JPEG +compression, <b>zip</b> for Deflate compression, <b>g3</b> +for CCITT Group 3 (T.4) compression, and <b>g4</b> for CCITT +Group 4 (T.6) compression. By default <i>tiffcp</i> will +compress data according to the value of the +<i>Compression</i> tag found in the source file.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>The <small>CCITT</small> Group 3 and Group 4 compression +algorithms can only be used with bilevel data.</p> +<!-- INDENTATION --> +<p>Group 3 compression can be specified together with +several T.4-specific options: <b>1d</b> for 1-dimensional +encoding, <b>2d</b> for 2-dimensional encoding, and +<b>fill</b> to force each encoded scanline to be zero-filled +so that the terminating EOL code lies on a byte boundary. +Group 3-specific options are specified by appending a +‘‘:’’-separated list to the +‘‘g3’’ option; e.g. <b>−c +g3:2d:fill</b> to get 2D-encoded data with byte-aligned EOL +codes.</p> +<!-- INDENTATION --> +<p><small>LZW</small> compression can be specified together +with a <i>predictor</i> value. A predictor value of 2 causes +each scanline of the output image to undergo horizontal +differencing before it is encoded; a value of 1 forces each +scanline to be encoded without differencing. LZW-specific +options are specified by appending a +‘‘:’’-separated list to the +‘‘lzw’’ option; e.g. <b>−c +lzw:2</b> for <small>LZW</small> compression with horizontal +differencing.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−f</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the bit fill order to use in writing output +data. By default, <i>tiffcp</i> will create a new file with +the same fill order as the original. Specifying <b>−f +lsb2msb</b> will force data to be written with the FillOrder +tag set to <small>LSB2MSB,</small> while <b>−f +msb2lsb</b> will force data to be written with the FillOrder +tag set to <small>MSB2LSB.</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the length of a tile (in pixels). <i>tiffcp</i> +attempts to set the tile dimensions so that no more than 8 +kilobytes of data appear in a tile.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−L</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force output to be written with Little-Endian byte +order. This option only has an effect when the output file +is created or overwritten and not when it is appended +to.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−M</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Suppress the use of memory-mapped files when reading +images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the planar configuration to use in writing image +data that has one 8-bit sample per pixel. By default, +<i>tiffcp</i> will create a new file with the same planar +configuration as the original. Specifying <b>−p +contig</b> will force data to be written with multi-sample +data packed together, while <b>−p separate</b> will +force samples to be written in separate planes.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the number of rows (scanlines) in each strip of +data written to the output file. By default (or when value +<b>0</b> is specified), <i>tiffcp</i> attempts to set the +rows/strip that no more than 8 kilobytes of data appear in a +strip. If you specify special value <b>-1</b> it will +results in infinite number of the rows per strip. The entire +image will be the one strip in that case.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the output file to be written with data organized +in strips (rather than tiles).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−t</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the output file to be written with data organized +in tiles (rather than strips). options can be used to force +the resultant image to be written as strips or tiles of +data, respectively.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−w</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the width of a tile (in pixels). <i>tiffcp</i> +attempts to set the tile dimensions so that no more than 8 +kilobytes of data appear in a tile. <i>tiffcp</i> attempts +to set the tile dimensions so that no more than 8 kilobytes +of data appear in a tile.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−,={character}</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>substitute {character} for ’,’ in parsing +image directory indices in files. This is necessary if +filenames contain commas. Note that ’,=’ with +whitespace immediately following will disable the special +meaning of the ’,’ entirely. See examples.</p> +</td> +</table> +<a name="EXAMPLES"></a> +<h2>EXAMPLES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following concatenates two files and writes the +result using <small>LZW</small> encoding:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp -c lzw a.tif b.tif result.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>To convert a G3 1d-encoded <small>TIFF</small> to a +single strip of G4-encoded data the following might be +used:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp -c g4 -r 10000 g3.tif g4.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>(1000 is just a number that is larger than the number of +rows in the source file.)</p> +<!-- INDENTATION --> +<p>To extract a selected set of images from a multi-image +TIFF file, the file name may be immediately followed by a +’,’ separated list of image directory indices. +The first image is always in directory 0. Thus, to copy the +1st and 3rd images of image file "album.tif" to +"result.tif":</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp album.tif,0,2 result.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Given file "CCD.tif" whose first image is a +noise bias followed by images which include that bias, +subtract the noise from all those images following it (while +decompressing) with the command:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp -c none -b CCD.tif CCD.tif,1, result.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>If the file above were named "CCD,X.tif", the +"-,=" option would be required to correctly parse +this filename with image numbers, as follows:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffcp -c none -,=% -b CCD,X.tif CCD,X%1%.tif result.tif + +</pre> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcmp</b>(1), +<b>tiffmedian</b>(1), <b>tiffsplit</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffdither.1.html b/src/3rdparty/libtiff/html/man/tiffdither.1.html new file mode 100644 index 0000000..162c0e6 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffdither.1.html @@ -0,0 +1,182 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFDITHER</title> +</head> +<body> + +<h1 align=center>TIFFDITHER</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffdither − convert a greyscale image to bilevel +using dithering</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffdither</b> [ <i>options</i> ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffdither</i> converts a single channel 8-bit +greyscale image to a bilevel image using Floyd-Steinberg +error propagation with thresholding.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−c</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Specify the compression to use for data written to the +output file: <b>none</b> for no compression, <b>packbits</b> +for PackBits compression, <b>lzw</b> for Lempel-Ziv & +Welch compression, <b>zip</b> for Deflate compression, +<b>g3</b> for CCITT Group 3 (T.4) compression, and <b>g4</b> +for CCITT Group 4 (T.6) compression. By default +<i>tiffdither</i> will compress data according to the value +of the <i>Compression</i> tag found in the source file.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p>The <small>CCITT</small> Group 3 and Group 4 compression +algorithms can only be used with bilevel data.</p> +<!-- INDENTATION --> +<p>Group 3 compression can be specified together with +several T.4-specific options: <b>1d</b> for 1-dimensional +encoding, <b>2d</b> for 2-dimensional encoding, and +<b>fill</b> to force each encoded scanline to be zero-filled +so that the terminating EOL code lies on a byte boundary. +Group 3-specific options are specified by appending a +‘‘:’’-separated list to the +‘‘g3’’ option; e.g. <b>−c +g3:2d:fill</b> to get 2D-encoded data with byte-aligned EOL +codes.</p> +<!-- INDENTATION --> +<p><small>LZW</small> compression can be specified together +with a <i>predictor</i> value. A predictor value of 2 causes +each scanline of the output image to undergo horizontal +differencing before it is encoded; a value of 1 forces each +scanline to be encoded without differencing. LZW-specific +options are specified by appending a +‘‘:’’-separated list to the +‘‘lzw’’ option; e.g. <b>−c +lzw:2</b> for <small>LZW</small> compression with horizontal +differencing.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−f</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the bit fill order to use in writing output +data. By default, <i>tiffdither</i> will create a new file +with the same fill order as the original. Specifying +<b>−f lsb2msb</b> will force data to be written with +the FillOrder tag set to <small>LSB2MSB ,</small> while +<b>−f msb2lsb</b> will force data to be written with +the FillOrder tag set to <small>MSB2LSB .</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−t</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the threshold value for dithering. By default the +threshold value is 128.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The dither algorithm is taken from the +<b>tiffmedian</b>(1) program (written by Paul Heckbert).</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>fax2tiff</b>(1), +<b>tiffinfo</b>(1), <b>tiffcp</b>(1), <b>tiff2bw</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffdump.1.html b/src/3rdparty/libtiff/html/man/tiffdump.1.html new file mode 100644 index 0000000..da04dcb --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffdump.1.html @@ -0,0 +1,145 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFDUMP</title> +</head> +<body> + +<h1 align=center>TIFFDUMP</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffdump − print verbatim information about +<small>TIFF</small> files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffdump</b> [ <i>options</i> ] <i>name ...</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffdump</i> displays directory information from files +created according to the Tag Image File Format, Revision +6.0. The header of each <small>TIFF</small> file (magic +number, version, and first directory offset) is displayed, +followed by the tag contents of each directory in the file. +For each tag, the name, data type, count, and value(s) is +displayed. When the symbolic name for a tag or data type is +known, the symbolic name is displayed followed by it’s +numeric (decimal) value. Tag values are displayed enclosed +in ‘‘<>’’ characters +immediately preceded by the value of the count field. For +example, an <i>ImageWidth</i> tag might be displayed as +‘‘ImageWidth (256) SHORT (3) +1<800>’’.</p> +<!-- INDENTATION --> +<p><i>tiffdump</i> is particularly useful for investigating +the contents of <small>TIFF</small> files that +<i>libtiff</i> does not understand.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−h</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Force numeric data to be printed in hexadecimal rather +than the default decimal.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−m items</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Change the number of indirect data items that are +printed. By default, this will be 24.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−o offset</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Dump the contents of the <small>IFD</small> at the a +particular file offset. The file offset may be specified +using the usual C-style syntax; i.e. a leading +‘‘0x’’ for hexadecimal and a leading +‘‘0’’ for octal.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b>(1), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffgt.1.html b/src/3rdparty/libtiff/html/man/tiffgt.1.html new file mode 100644 index 0000000..bf8a138 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffgt.1.html @@ -0,0 +1,551 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFGT</title> +</head> +<body> + +<h1 align=center>TIFFGT</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffgt − display an image stored in a +<small>TIFF</small> file (Silicon Graphics version)</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffgt</b> [ <i>options</i> ] <i>input.tif ...</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffgt</i> displays one or more images stored using +the Tag Image File Format, Revision 6.0. Each image is +placed in a fixed size window that the user must position on +the display (unless configured otherwise through X +defaults). If the display has fewer than 24 bitplanes, or if +the image does not warrant full color, then +<small>RGB</small> color values are mapped to the closest +values that exist in the colormap (this is done using the +<i>rgbi</i> routine found in the graphics utility library +<b>−lgutil</b>.)</p> +<!-- INDENTATION --> +<p><i>tiffgt</i> correctly handles files with any of the +following characteristics:</p></td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="3" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="34%"> + +<p>BitsPerSample</p> +</td> +<td width="50%"> + +<p>1, 2, 4, 8, 16</p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="34%"> + +<p>SamplesPerPixel</p> +</td> +<td width="50%"> + +<p>1, 3, 4 (the 4th sample is ignored)</p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="34%"> + +<p>PhotometricInterpretation</p> +</td> +<td width="50%"> + +<p>0 (min-is-white), 1 (min-is-black), 2 (RGB), 3 +(palette), 6 (YCbCr)</p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="34%"> + +<p>PlanarConfiguration</p> +</td> +<td width="50%"> + +<p>1 (contiguous), 2 (separate)</p> +</td> +<tr valign="top" align="left"> +<td width="15%"></td> +<td width="34%"> + +<p>Orientation</p> +</td> +<td width="50%"> + +<p>1 (top-left), 4 (bottom-left)</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Data may be organized as strips or tiles and may be +compressed with any of the compression algorithms supported +by the <i>libtiff</i>(3) library.</p> +<!-- INDENTATION --> +<p>For palette images (<i>PhotometricInterpretation</i>=3), +<i>tiffgt</i> inspects the colormap values and assumes +either 16-bit or 8-bit values according to the maximum +value. That is, if no colormap entry greater than 255 is +found, <i>tiffgt</i> assumes the colormap has only 8-bit +values; otherwise it assumes 16-bit values. This inspection +is done to handle old images written by previous (incorrect) +versions of <i>libtiff</i>.</p> +<!-- INDENTATION --> +<p><i>tiffgt</i> can be used to display multiple images +one-at-a-time. The left mouse button switches the display to +the first image in the <i>next</i> file in the list of files +specified on the command line. The right mouse button +switches to the first image in the <i>previous</i> file in +the list. The middle mouse button causes the first image in +the first file specified on the command line to be +displayed. In addition the following keyboard commands are +recognized:</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="4" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>b</b></p> +</td> +<td width="80%"> + +<p>Use a <i>PhotometricInterpretation</i> of MinIsBlack in +displaying the current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>l</b></p> +</td> +<td width="80%"> + +<p>Use a <i>FillOrder</i> of lsb-to-msb in decoding the +current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>m</b></p> +</td> +<td width="80%"> + +<p>Use a <i>FillOrder</i> of msb-to-lsb in decoding the +current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>c</b></p> +</td> +<td width="80%"> + +<p>Use a colormap visual to display the current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>r</b></p> +</td> +<td width="80%"> + +<p>Use a true color (24-bit RGB) visual to display the +current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>w</b></p> +</td> +<td width="80%"> + +<p>Use a <i>PhotometricInterpretation</i> of MinIsWhite in +displaying the current image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>W</b></p> +</td> +<td width="80%"> + +<p>Toggle (enable/disable) display of warning messages from +the <small>TIFF</small> library when decoding images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>E</b></p> +</td> +<td width="80%"> + +<p>Toggle (enable/disable) display of error messages from +the <small>TIFF</small> library when decoding images.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>z</b></p> +</td> +<td width="80%"> + +<p>Reset all parameters to their default settings +(<i>FillOrder</i>, <i>PhotometricInterpretation</i>, +handling of warnings and errors).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="8%"> + +<p><b>PageUp</b></p> +</td> +<td width="80%"> + +<p>Display the previous image in the current file or the +last image in the previous file.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>PageDown</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Display the next image in the current file or the first +image in the next file.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>Home</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Display the first image in the current file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="6%"> + +<p><b>End</b></p> +</td> +<td width="2%"></td> +<td width="80%"> + +<p>Display the last image in the current file +(unimplemented).</p> +</td> +<td width="0%"> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force image display in a colormap window.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−d</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify an image to display by directory number. By +default the first image in the file is displayed. +Directories are numbered starting at zero.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−e</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Enable reporting of error messages from the +<small>TIFF</small> library. By default <i>tiffgt</i> +silently ignores images that cannot be read.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−f</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force <i>tiffgt</i> to run as a foreground process. By +default <i>tiffgt</i> will place itself in the background +once it has opened the requested image file.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−l</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the presumed bit ordering to be <small>LSB</small> +to <small>MSB.</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−m</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force the presumed bit ordering to be <small>MSB</small> +to <small>LSB.</small></p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−o</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify an image to display by directory offset. By +default the first image in the file is displayed. +Directories offsets may be specified using C-style syntax; +i.e. a leading ‘‘0x’’ for +hexadecimal and a leading ‘‘0’’ for +octal.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Override the value of the +<i>PhotometricInterpretation</i> tag; the parameter may be +one of: <i>miniswhite</i>, <i>minisblack</i>, <i>rgb</i>, +<i>palette</i>, <i>mask</i>, <i>separated</i>, <i>ycbcr</i>, +and <i>cielab</i>.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Force image display in a full color window.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Stop on the first read error. By default all errors in +the input data are ignored and <i>tiffgt</i> does it’s +best to display as much of an image as possible.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−w</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Enable reporting of warning messages from the +<small>TIFF</small> library. By default <i>tiffgt</i> +ignores warning messages generated when reading an +image.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−v</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Place information in the title bar describing what type +of window (full color or colormap) is being used, the name +of the input file, and the directory index of the image (if +non-zero). By default, the window type is not shown in the +title bar.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Images wider and taller than the display are silently +truncated to avoid crashing old versions of the window +manager.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffdump</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffinfo.1.html b/src/3rdparty/libtiff/html/man/tiffinfo.1.html new file mode 100644 index 0000000..59bdd38 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffinfo.1.html @@ -0,0 +1,196 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFINFO</title> +</head> +<body> + +<h1 align=center>TIFFINFO</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffinfo − print information about +<small>TIFF</small> files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffinfo</b> [ <i>options</i> ] <i>input.tif +...</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Tiffinfo</i> displays information about files created +according to the Tag Image File Format, Revision 6.0. By +default, the contents of each <small>TIFF</small> directory +in each file is displayed, with the value of each tag shown +symbolically (where sensible).</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Display the colormap and color/gray response curves, if +present.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−D</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>In addition to displaying the directory tags, read and +decompress all the data in each image (but not display +it).</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−d</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>In addition to displaying the directory tags, print each +byte of decompressed data in hexadecimal.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−j</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Display any <small>JPEG</small> -related tags that are +present.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−o</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the initial <small>TIFF</small> directory according +to the specified file offset. The file offset may be +specified using the usual C-style syntax; i.e. a leading +‘‘0x’’ for hexadecimal and a leading +‘‘0’’ for octal.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−s</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Display the offsets and byte counts for each data strip +in a directory.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−z</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Enable strip chopping when reading image data.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−#</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Set the initial <small>TIFF</small> directory to +<i>#</i>.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffcp</b>(1), <b>tiffcmp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffmedian.1.html b/src/3rdparty/libtiff/html/man/tiffmedian.1.html new file mode 100644 index 0000000..afe3aa9 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffmedian.1.html @@ -0,0 +1,183 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFMEDIAN</title> +</head> +<body> + +<h1 align=center>TIFFMEDIAN</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#NOTES">NOTES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffmedian − apply the median cut algorithm to data +in a <small>TIFF</small> file</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffmedian</b> [ <i>options</i> ] <i>input.tif +output.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffmedian</i> applies the median cut algorithm to an +<small>RGB</small> image in <i>input.tif</i> to generate a +palette image that is written to <i>output.tif</i>. The +generated colormap has, by default, 256 entries. The image +data is quantized by mapping each pixel to the closest color +values in the colormap.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="11%"></td> +<td width="2%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the compression to use for data written to the +output file: <b>none</b> for no compression, <b>packbits</b> +for PackBits compression, <b>lzw</b> for Lempel-Ziv & +Welch compression, and <b>zip</b> for Deflate compression. +By default <i>tiffmedian</i> will compress data according to +the value of the <i>Compression</i> tag found in the source +file.</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p><small>LZW</small> compression can be specified together +with a <i>predictor</i> value. A predictor value of 2 causes +each scanline of the output image to undergo horizontal +differencing before it is encoded; a value of 1 forces each +scanline to be encoded without differencing. LZW-specific +options are specified by appending a +‘‘:’’-separated list to the +‘‘lzw’’ option; e.g. <b>−c +lzw:2</b> for <small>LZW</small> compression with horizontal +differencing.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−C</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Specify the number of entries to use in the generated +colormap. By default all 256 entries/colors are used.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−f</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Apply Floyd-Steinberg dithering before selecting a +colormap entry.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="2%"> + +<p><b>−r</b></p> +</td> +<td width="6%"></td> +<td width="80%"> + +<p>Specify the number of rows (scanlines) in each strip of +data written to the output file. By default, +<i>tiffmedian</i> attempts to set the rows/strip that no +more than 8 kilobytes of data appear in a strip.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="NOTES"></a> +<h2>NOTES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>This program is derived from Paul Heckbert’s +<i>median</i> program.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffcmp</b>(1), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p><b>Color Image Quantization for Frame Buffer Display</b>, +Paul Heckbert, SIGGRAPH proceedings, 1982, pp. 297-307.</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffset.1.html b/src/3rdparty/libtiff/html/man/tiffset.1.html new file mode 100644 index 0000000..0069cb6 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffset.1.html @@ -0,0 +1,174 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSET</title> +</head> +<body> + +<h1 align=center>TIFFSET</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#EXAMPLES">EXAMPLES</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffset − set a field in a <small>TIFF</small> +header</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffset</b> [ options ] <i>filename.tif</i></p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>Tiffset</i> sets the value of a <small>TIFF</small> +header to a specified value.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−s tagnumber [count] value ...</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Set the value of the named tag to the value or values +specified.</p> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>−sf tagnumber filename</b></p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="19%"></td> +<td width="80%"> +<p>Set the value of the tag to the contents of filename. +This option is supported for ASCII tags only.</p> +</td> +</table> +<a name="EXAMPLES"></a> +<h2>EXAMPLES</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following example sets the image description tag +(270) of a.tif to the contents of the file descrip:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffset -sf 270 descrip a.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>The following example sets the artist tag (315) of a.tif +to the string "Anonymous":</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffset -s 305 Anonymous a.tif +</pre> +</td> +</table> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>This example sets the resolution of the file a.tif to 300 +dpi:</p></td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<pre>tiffset -s 296 2 a.tif +tiffset -s 282 300.0 a.tif +tiffset -s 283 300.0 a.tif +</pre> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> + +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffdump</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffsplit.1.html b/src/3rdparty/libtiff/html/man/tiffsplit.1.html new file mode 100644 index 0000000..6f5ada6 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffsplit.1.html @@ -0,0 +1,102 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:13 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSPLIT</title> +</head> +<body> + +<h1 align=center>TIFFSPLIT</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffsplit − split a multi-image <small>TIFF</small> +into single-image <small>TIFF</small> files</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffsplit</b> <i>src.tif</i> [ <i>prefix</i> ]</p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffsplit</i> takes a multi-directory (page) +<small>TIFF</small> file and creates one or more +single-directory (page) <small>TIFF</small> files from it. +The output files are given names created by concatenating a +prefix, a lexically ordered suffix in the range +[<i>aaa</i>-<i>zzz</i>], the suffix <i>.tif</i> (e.g. +<i>xaaa.tif</i>, <i>xaab.tif</i>, <i>xzzz.tif</i>). If a +prefix is not specified on the command line, the default +prefix of <i>x</i> is used.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>None.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Only a select set of ‘‘known +tags’’ is copied when splitting.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffcp</b>(1), <b>tiffinfo</b>(1), +<b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/man/tiffsv.1.html b/src/3rdparty/libtiff/html/man/tiffsv.1.html new file mode 100644 index 0000000..8237096 --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiffsv.1.html @@ -0,0 +1,207 @@ +<!-- Creator : groff version 1.18.1 --> +<!-- CreationDate: Mon Mar 13 18:03:14 2006 --> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta name="Content-Style" content="text/css"> +<title>TIFFSV</title> +</head> +<body> + +<h1 align=center>TIFFSV</h1> +<a href="#NAME">NAME</a><br> +<a href="#SYNOPSIS">SYNOPSIS</a><br> +<a href="#DESCRIPTION">DESCRIPTION</a><br> +<a href="#OPTIONS">OPTIONS</a><br> +<a href="#NOTE">NOTE</a><br> +<a href="#BUGS">BUGS</a><br> +<a href="#SEE ALSO">SEE ALSO</a><br> + +<hr> +<a name="NAME"></a> +<h2>NAME</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>tiffsv − save an image from the framebuffer in a +<small>TIFF</small> file (Silicon Graphics version)</p> +</td> +</table> +<a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>tiffsv</b> [ <i>options</i> ] <i>output.tif</i> [ +<i>x1 x2 y1 y2</i> ]</p> +</td> +</table> +<a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><i>tiffsv</i> saves all or part of the framebuffer in a +file using the Tag Image File Format, Revision 6.0. By +default, the image is saved with data samples packed +(<i>PlanarConfiguration</i>=1), compressed with the +Lempel-Ziv & Welch algorithm (<i>Compression</i>=5), and +with each strip no more than 8 kilobytes. These +characteristics can be overridden, or explicitly specified +with the options described below.</p> +</td> +</table> +<a name="OPTIONS"></a> +<h2>OPTIONS</h2> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−b</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Save the image as a greyscale image as if it were +processed by <i>tiff2bw</i>(1). This option is included for +compatibility with the standard <i>scrsave</i>(6D) +program.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−c</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the compression to use for data written to the +output file: <b>none</b> for no compression, <b>packbits</b> +for PackBits compression, <b>jpeg</b> for baseline JPEG +compression, <b>zip</b> for Deflate compression, and +<b>lzw</b> for Lempel-Ziv & Welch compression +(default).</p> +</td> +<td width="0%"> +</td> +</table> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="17%"></td> +<td width="82%"> +<p><small>LZW</small> compression can be specified together +with a <i>predictor</i> value. A predictor value of 2 causes +each scanline of the output image to undergo horizontal +differencing before it is encoded; a value of 1 forces each +scanline to be encoded without differencing. LZW-specific +options are specified by appending a +‘‘:’’-separated list to the +‘‘lzw’’ option; e.g. <b>−c +lzw:2</b> for <small>LZW</small> compression with horizontal +differencing.</p> +</td> +</table> +<!-- TABS --> +<table width="100%" border=0 rules="none" frame="void" + cols="5" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−p</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the planar configuration to use in writing image +data. By default, <i>tiffsv</i> will create a new file with +the data samples packed contiguously. Specifying <b>−p +contig</b> will force data to be written with multi-sample +data packed together, while <b>−p separate</b> will +force samples to be written in separate planes.</p> +</td> +<td width="0%"> +</td> +<tr valign="top" align="left"> +<td width="10%"></td> +<td width="3%"> + +<p><b>−r</b></p> +</td> +<td width="5%"></td> +<td width="80%"> + +<p>Specify the number of rows (scanlines) in each strip of +data written to the output file. By default, <i>tiffsv</i> +attempts to set the rows/strip that no more than 8 kilobytes +of data appear in a strip.</p> +</td> +<td width="0%"> +</td> +</table> +<a name="NOTE"></a> +<h2>NOTE</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>Except for the use of <small>TIFF,</small> this program +is equivalent to the standard <i>scrsave</i> program. This +means, for example, that you can use it in conjunction with +the standard <i>icut</i> program simply by creating a link +called <i>scrsave</i>, or by creating a shell script called +<i>scrsave</i> that invokes <i>tiffgt</i> with the +appropriate options.</p> +</td> +</table> +<a name="BUGS"></a> +<h2>BUGS</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p>If data are saved compressed and in separate planes, then +the rows in each strip is silently set to one to avoid +limitations in the <b>libtiff</b>(3TIFF) library.</p> +</td> +</table> +<a name="SEE ALSO"></a> +<h2>SEE ALSO</h2> +<!-- INDENTATION --> +<table width="100%" border=0 rules="none" frame="void" + cols="2" cellspacing="0" cellpadding="0"> +<tr valign="top" align="left"> +<td width="8%"></td> +<td width="91%"> +<p><b>scrsave</b>(6D) <b>pal2rgb</b>(1), <b>tiffdump</b>(1), +<b>tiffgt</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1), +<b>tiffmedian</b>(1), <b>libtiff</b>(3TIFF)</p> +<!-- INDENTATION --> +<p>Libtiff library home page: +<b>http://www.remotesensing.org/libtiff/</b></p> +</td> +</table> +<hr> +</body> +</html> diff --git a/src/3rdparty/libtiff/html/misc.html b/src/3rdparty/libtiff/html/misc.html new file mode 100644 index 0000000..2ea9ad4 --- /dev/null +++ b/src/3rdparty/libtiff/html/misc.html @@ -0,0 +1,112 @@ +<HTML> +<HEAD> +<TITLE> +Acknowledgments and Other Issues +</TITLE> +</HEAD> +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> +<H1> +<IMG SRC=images/ring.gif WIDTH=124 HEIGHT=124 ALIGN=left BORDER=1 HSPACE=6> +Acknowledgments and Other Issues +</H1> + +<P> +Silicon Graphics has seen fit to allow us to give this work away. It +is free. There is no support or guarantee of any sort as to its +operations, correctness, or whatever. If you do anything useful with +all or parts of it you need to honor the copyright notices. It would +also be nice to be acknowledged.<p> + +<BR CLEAR=left> + +<H2>Acknowledgements</H2> + +The libtiff software was written by Sam Leffler while working for +Silicon Graphics.<p> + +The LZW algorithm is derived from the compress program (the proper +attribution is included in the source code). The Group 3 fax stuff +originated as code from Jef Poskanzer, but has since been rewritten +several times. The latest version uses an algorithm from Frank +Cringle -- consult <TT>libtiff/mkg3states.c</TT> and +<TT>libtiff/tif_fax3.h</TT> for further information. +The JPEG support was written by Tom Lane and is dependent on the +excellent work of Tom Lane and the Independent JPEG Group (IJG) +who distribute their work under friendly licensing similar to this +software. +Many other people have by now helped with bug fixes and code; a +few of the more persistent contributors have been: + +<PRE> + Bjorn P. Brox + Dan McCoy + J.T. Conklin + Richard Minner + Frank D. Cringle + Richard Mlynarik + Soren Pingel Dalsgaard + Niles Ritter + Steve Johnson + Karsten Spang + Tom Lane + Peter Smith + Brent Roman + Mike Welles + Frank Warmerdam + Greg Ward + Stanislav Brabec + Roman Shpount + Peter Skarpetis + Arvan Pritchard + Bernt Herd + Joseph Orost + Phil Beffery + Ivo Penzar + Francois Dagand + Albert Chin-A-Young + Bruce A. Mallett + Dwight Kelly + Andrey Kiselev + Ross Finlayson + Dmitry V. Levin + Bob Friesenhahn + Lee Howard + Joris Van Damme +</PRE> + +(my apology to anyone that was inadvertently not listed.) + +<H2>Use and Copyright</H2> + +<P><H5><PRE> +Copyright (c) 1988-1997 Sam Leffler +Copyright (c) 1991-1997 Silicon Graphics, Inc. + +Permission to use, copy, modify, distribute, and sell this software and +its documentation for any purpose is hereby granted without fee, provided +that (i) the above copyright notices and this permission notice appear in +all copies of the software and related documentation, and (ii) the names of +Sam Leffler and Silicon Graphics may not be used in any advertising or +publicity relating to the software without the specific, prior written +permission of Sam Leffler and Silicon Graphics. + +THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, +EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY +WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR +ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, +OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, +WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF +LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE +OF THIS SOFTWARE. +</PRE></H5> + +<P> +<HR> + + +Last updated: $Date: 2005/10/23 19:43:29 $ +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/support.html b/src/3rdparty/libtiff/html/support.html new file mode 100644 index 0000000..f6f5d60 --- /dev/null +++ b/src/3rdparty/libtiff/html/support.html @@ -0,0 +1,655 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html lang="en"> +<head> + <title>TIFF 6.0 Specification Coverage</title> + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"> + <meta http-equiv="content-language" content="en"> + <style type="text/css"> + <!-- + th {text-align: left; vertical-align: top; font-style: italic; font-weight: normal} + --> + </style> +</head> +<body lang="en" text="#000000" bgcolor="#ffffff" link="#0000ff" alink="#0000ff" vlink="#0000ff"> + <table border="0" cellspacing="0" cellpadding="0"> + <tr> + <td style="padding-left: 1em; padding-right: 1em"><img src="images/strike.gif" width="128" height="100" alt=""></td> + <td> + <h1>TIFF 6.0 Specification Coverage</h1> + <p> + The library is capable of dealing with images that are written to + follow the 5.0 or 6.0 TIFF spec. There is also considerable support + for some of the more esoteric portions of the 6.0 TIFF spec. + </p> + </td> + </tr> + </table> + <br> + <table border="1" cellspacing="0" cellpadding="5"> + <tr> + <th>Core requirements</th> + <td> + <p> + Both <tt>"MM"</tt> and <tt>"II"</tt> byte orders are handled. + Both packed and separated planar configuration of samples. + Any number of samples per pixel (memory permitting). + Any image width and height (memory permitting). + Multiple subfiles can be read and written. + Editing is <b>not</b> supported in that related subfiles (e.g. + a reduced resolution version of an image) are not automatically + updated. + </p> + <p> + Tags handled: <tt>ExtraSamples</tt>, <tt>ImageWidth</tt>, + <tt>ImageLength</tt>, <tt>NewSubfileType</tt>, <tt>ResolutionUnit</tt>. + <tt>Rowsperstrip</tt>, <tt>StripOffsets</tt>, <tt>StripByteCounts</tt>, + <tt>XResolution</tt>, <tt>YResolution</tt> + </p> + </td> + </tr> + <tr> + <th>Tiled Images</th> + <td><tt>TileWidth</tt>, <tt>TileLength</tt>, <tt>TileOffsets</tt>, + <tt>TileByteCounts</tt></td> + </tr> + <tr> + <th>Image Colorimetry Information</th> + <td><tt>WhitePoint</tt>, <tt>PrimaryChromaticities</tt>, <tt>TransferFunction</tt>, + <tt>ReferenceBlackWhite</tt></td> + </tr> + <tr> + <th>Class B for bilevel images</th> + <td><tt>SamplesPerPixel</tt> = 1<br> + <tt>BitsPerSample</tt> = 1<br> + <tt>Compression</tt> = 1 (none), 2 (CCITT 1D), or 32773 (PackBits)<br> + <tt>PhotometricInterpretation</tt> = 0 (Min-is-White), 1 (Min-is-Black)</td> + </tr> + <tr> + <th>Class G for grayscale images</th> + <td><tt>SamplesPerPixel</tt> = 1<br> + <tt>BitsPerSample</tt> = 4, 8<br> + <tt>Compression</tt> = 1 (none) 5 (LZW)<br> + <tt>PhotometricInterpretation</tt> = 0 (Min-is-White), 1 (Min-is-Black)</td> + </tr> + <tr> + <th>Class P for palette color images</th> + <td><tt>SamplesPerPixel</tt> = 1<br> + <tt>BitsPerSample</tt> = 1-8<br> + <tt>Compression</tt> = 1 (none) 5 (LZW)<br> + <tt>PhotometricInterpretation</tt> = 3 (Palette RGB)<br> + <tt>ColorMap</tt></td> + </tr> + <tr> + <th>Class R for RGB full color images</th> + <td><tt>SamplesPerPixel</tt> = 3<br> + <tt>BitsPerSample</tt> = <8,8,8><br> + <tt>PlanarConfiguration</tt> = 1, 2<br> + <tt>Compression</tt> = 1 (none) 5 (LZW)<br> + <tt>PhotometricInterpretation</tt> = 2 (RGB)</td> + </tr> + <tr> + <th>Class F for facsimile</th> + <td>(<i>Class B tags plus...</i>)<br> + <tt>Compression</tt> = 3 (CCITT Group 3), 4 (CCITT Group 4)<br> + <tt>FillOrder</tt> = 1 (MSB), 2 (LSB)<br> + <tt>Group3Options</tt> = 1 (2d encoding), 4 (zero fill), 5 (2d+fill)<br> + <tt>ImageWidth</tt> = 1728, 2048, 2482<br> + <tt>NewSubFileType</tt> = 2<br> + <tt>ResolutionUnit</tt> = 2 (Inch), 3 (Centimeter)<br> + <tt>PageNumber</tt>, + <tt>XResolution</tt>, + <tt>YResolution</tt>, + <tt>Software</tt>, + <tt>BadFaxLines</tt>, + <tt>CleanFaxData</tt>, + <tt>ConsecutiveBadFaxLines</tt>, + <tt>DateTime</tt>, + <tt>DocumentName</tt>, + <tt>ImageDescription</tt>, + <tt>Orientation</tt></td> + </tr> + <tr> + <th>Class S for separated images</th> + <td><tt>SamplesPerPixel</tt> = 4<br> + <tt>PlanarConfiguration</tt> = 1, 2<br> + <tt>Compression</tt> = 1 (none), 5 (LZW)<br> + <tt>PhotometricInterpretation</tt> = 5 (Separated)<br> + <tt>InkSet</tt> = 1 (CMYK)<br> + <tt>DotRange</tt>, + <tt>InkNames</tt>, + <tt>DotRange</tt>, + <tt>TargetPrinter</tt></td> + </tr> + <tr> + <th>Class Y for YCbCr images</th> + <td><tt>SamplesPerPixel</tt> = 3<br> + <tt>BitsPerSample</tt> = <8,8,8><br> + <tt>PlanarConfiguration</tt> = 1, 2<br> + <tt>Compression</tt> = 1 (none), 5 (LZW), 7 (JPEG)<br> + <tt>PhotometricInterpretation</tt> = 6 (YCbCr)<br> + <tt>YCbCrCoefficients</tt>, + <tt>YCbCrSubsampling</tt>, + <tt>YCbCrPositioning</tt><br> + (<i>colorimetry info from Appendix H; see above</i>)</td> + </tr> + <tr> + <th>Class "JPEG" for JPEG images (per TTN2)</th> + <td><tt>PhotometricInterpretation</tt> = 1 (grayscale), 2 (RGB), 5 (CMYK), 6 (YCbCr)<br> + (<i>Class Y tags if YCbCr</i>)<br> + (<i>Class S tags if CMYK</i>)<br> + <tt>Compression</tt> = 7 (JPEG)</td> + </tr> + </table> + <p> + In addition, the library supports some optional compression algorithms + that are, in some cases, of dubious value. + </p> + <table border="0" cellspacing="0" cellpadding="2"> + <tr><th>Compression tag value</th><th>Compression algorithm</th></tr> + <tr><td>32766</td><td>NeXT 2-bit encoding</td></tr> + <tr><td>32809</td><td>ThunderScan 4-bit encoding</td></tr> + <tr><td>32909</td><td>Pixar companded 11-bit ZIP encoding</td></tr> + <tr><td>32946</td><td>PKZIP-style Deflate encoding (experimental)</td></tr> + <tr><td>34676</td><td>SGI 32-bit Log Luminance encoding (experimental)</td></tr> + <tr><td>34677</td><td>SGI 24-bit Log Luminance encoding (experimental)</td></tr> + </table> + <br> + <p> + Note that there is no support for the JPEG-related tags defined + in the 6.0 specification; the JPEG support is based on the post-6.0 + proposal given in TIFF Technical Note #2. + </p> + <table> + <tr> + <td valign=top><img src="images/info.gif" width="32" height="32" alt=""></td> + <td>For more information on the experimental Log Luminance encoding + consult the materials available at + <a href="http://www.anyhere.com/gward/pixformat/tiffluv.html">http://www.anyhere.com/gward/pixformat/tiffluv.html</a>.</td> + </tr> + </table> + <br> + <p> + The following table shows the tags that are recognized + and how they are used by the library. If no use is indicated, + then the library reads and writes the tag, but does not use it internally. + </p> + <table border="1" cellspacing="0" cellpadding="5"> + <tr> + <th>Tag Name</th> + <th>Value</th> + <th>R/W</th> + <th>Library's Use (Comments)</th> + </tr> + <tr> + <td><tt>NewSubFileType</tt></td> + <td>254</td> + <td>R/W</td> + <td>none (called <tt>SubFileType</tt> in <tiff.h>)</td> + </tr> + <tr> + <td><tt>SubFileType</tt></td> + <td>255</td> + <td>R/W</td> + <td>none (called <tt>OSubFileType</tt> in <tiff.h>)</td> + </tr> + <tr> + <td><tt>ImageWidth</tt></td> + <td>256</td> + <td>R/W</td> + <td>lots</td> + </tr> + <tr> + <td><tt>ImageLength</tt></td> + <td>257</td> + <td>R/W</td> + <td>lots</td> + </tr> + <tr> + <td><tt>BitsPerSample</tt></td> + <td>258</td> + <td>R/W</td> + <td>lots</td> + </tr> + <tr> + <td><tt>Compression</tt></td> + <td>259</td> + <td>R/W</td> + <td>to select appropriate codec</td> + </tr> + <tr> + <td><tt>PhotometricInterpretation</tt></td> + <td>262</td> + <td>R/W</td> + <td>lots</td> + </tr> + <tr> + <td><tt>Thresholding</tt></td> + <td>263</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>CellWidth</tt></td> + <td>264</td> + <td> </td> + <td>parsed but ignored</td> + </tr> + <tr> + <td><tt>CellLength</tt></td> + <td>265</td> + <td> </td> + <td>parsed but ignored</td> + </tr> + <tr> + <td><tt>FillOrder</tt></td> + <td>266</td> + <td>R/W</td> + <td>control bit order</td> + </tr> + <tr> + <td><tt>DocumentName</tt></td> + <td>269</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>ImageDescription</tt></td> + <td>270</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>Make</tt></td> + <td>271</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>Model</tt></td> + <td>272</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>StripOffsets</tt></td> + <td>273</td> + <td>R/W</td> + <td>data i/o</td> + </tr> + <tr> + <td><tt>Orientation</tt></td> + <td>274</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>SamplesPerPixel</tt></td> + <td>277</td> + <td>R/W</td> + <td>lots</td> + </tr> + <tr> + <td><tt>RowsPerStrip</tt></td> + <td>278</td> + <td>R/W</td> + <td>data i/o</td> + </tr> + <tr> + <td><tt>StripByteCounts</tt></td> + <td>279</td> + <td>R/W</td> + <td>data i/o</td> + </tr> + <tr> + <td><tt>MinSampleValue</tt></td> + <td>280</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>MaxSampleValue</tt></td> + <td>281</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>XResolution</tt></td> + <td>282</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>YResolution</tt></td> + <td>283</td> + <td>R/W</td> + <td>used by Group 3 2d encoder</td> + </tr> + <tr> + <td><tt>PlanarConfiguration</tt></td> + <td>284</td> + <td>R/W</td> + <td>data i/o</td> + </tr> + <tr> + <td><tt>PageName</tt></td> + <td>285</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>XPosition</tt></td> + <td>286</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>YPosition</tt></td> + <td>286</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>FreeOffsets</tt></td> + <td>288</td> + <td> </td> + <td>parsed but ignored</td> + </tr> + <tr> + <td><tt>FreeByteCounts</tt></td> + <td>289</td> + <td> </td> + <td>parsed but ignored</td> + </tr> + <tr> + <td><tt>GrayResponseUnit</tt></td> + <td>290</td> + <td> </td> + <td>parsed but ignored</td> + </tr> + <tr> + <td><tt>GrayResponseCurve</tt></td> + <td>291</td> + <td> </td> + <td>parsed but ignored</td> + </tr> + <tr> + <td><tt>Group3Options</tt></td> + <td>292</td> + <td>R/W</td> + <td>used by Group 3 codec</td> + </tr> + <tr> + <td><tt>Group4Options</tt></td> + <td>293</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>ResolutionUnit</tt></td> + <td>296</td> + <td>R/W</td> + <td>used by Group 3 2d encoder</td> + </tr> + <tr> + <td><tt>PageNumber</tt></td> + <td>297</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>ColorResponseUnit</tt></td> + <td>300</td> + <td> </td> + <td>parsed but ignored</td> + </tr> + <tr> + <td><tt>TransferFunction</tt></td> + <td>301</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>Software</tt></td> + <td>305</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>DateTime</tt></td> + <td>306</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>Artist</tt></td> + <td>315</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>HostComputer</tt></td> + <td>316</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>Predictor</tt></td> + <td>317</td> + <td>R/W</td> + <td>used by LZW codec</td> + </tr> + <tr> + <td><tt>WhitePoint</tt></td> + <td>318</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>PrimaryChromacities</tt></td> + <td>319</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>ColorMap</tt></td> + <td>320</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>TileWidth</tt></td> + <td>322</td> + <td>R/W</td> + <td>data i/o</td> + </tr> + <tr> + <td><tt>TileLength</tt></td> + <td>323</td> + <td>R/W</td> + <td>data i/o</td> + </tr> + <tr> + <td><tt>TileOffsets</tt></td> + <td>324</td> + <td>R/W</td> + <td>data i/o</td> + </tr> + <tr> + <td><tt>TileByteCounts</tt></td> + <td>324</td> + <td>R/W</td> + <td>data i/o</td> + </tr> + <tr> + <td><tt>BadFaxLines</tt></td> + <td>326</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>CleanFaxData</tt></td> + <td>327</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>ConsecutiveBadFaxLines</tt></td> + <td>328</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>SubIFD</tt></td> + <td>330</td> + <td>R/W</td> + <td>subimage descriptor support</td> + </tr> + <tr> + <td><tt>InkSet</tt></td> + <td>332</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>InkNames</tt></td> + <td>333</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>DotRange</tt></td> + <td>336</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>TargetPrinter</tt></td> + <td>337</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>ExtraSamples</tt></td> + <td>338</td> + <td>R/W</td> + <td>lots</td> + </tr> + <tr> + <td><tt>SampleFormat</tt></td> + <td>339</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>SMinSampleValue</tt></td> + <td>340</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>SMaxSampleValue</tt></td> + <td>341</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>JPEGTables</tt></td> + <td>347</td> + <td>R/W</td> + <td>used by JPEG codec</td> + </tr> + <tr> + <td><tt>YCbCrCoefficients</tt></td> + <td>529</td> + <td>R/W</td> + <td>used by <tt>TIFFReadRGBAImage</tt> support</td> + </tr> + <tr> + <td><tt>YCbCrSubsampling</tt></td> + <td>530</td> + <td>R/W</td> + <td>tile/strip size calculations</td> + </tr> + <tr> + <td><tt>YCbCrPositioning</tt></td> + <td>531</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>ReferenceBlackWhite</tt></td> + <td>532</td> + <td>R/W</td> + <td> </td> + </tr> + <tr> + <td><tt>Matteing</tt></td> + <td>32995</td> + <td>R</td> + <td>none (obsoleted by <tt>ExtraSamples</tt> tag)</td> + </tr> + <tr> + <td><tt>DataType</tt></td> + <td>32996</td> + <td>R</td> + <td>none (obsoleted by <tt>SampleFormat</tt> tag)</td> + </tr> + <tr> + <td><tt>ImageDepth</tt></td> + <td>32997</td> + <td>R/W</td> + <td>tile/strip calculations</td> + </tr> + <tr> + <td><tt>TileDepth</tt></td> + <td>32998</td> + <td>R/W</td> + <td>tile/strip calculations</td> + </tr> + <tr> + <td><tt>StoNits</tt></td> + <td>37439</td> + <td>R/W</td> + <td> </td> + </tr> + </table> + <p> + The <tt>Matteing</tt> and <tt>DataType</tt> + tags have been obsoleted by the 6.0 + <tt>ExtraSamples</tt> and <tt>SampleFormat</tt> tags. + Consult the documentation on the + <tt>ExtraSamples</tt> tag and Associated Alpha for elaboration. Note however + that if you use Associated Alpha, you are expected to save data that is + pre-multipled by Alpha. If this means nothing to you, check out + Porter & Duff's paper in the '84 SIGGRAPH proceedings: "Compositing Digital + Images". + </p> + <p> + The <tt>ImageDepth</tt> + tag is a non-standard, but registered tag that specifies + the Z-dimension of volumetric data. The combination of <tt>ImageWidth</tt>, + <tt>ImageLength</tt>, and <tt>ImageDepth</tt>, + defines a 3D volume of pixels that are + further specified by <tt>BitsPerSample</tt> and + <tt>SamplesPerPixel</tt>. The <tt>TileDepth</tt> + tag (also non-standard, but registered) can be used to specified a + subvolume "tiling" of a volume of data. + </p> + <p> + The Colorimetry, and CMYK tags are additions that appear in TIFF 6.0. + Consult the TIFF 6.0 specification included in the <b>doc</b> directory + and <a href="document.html">online</a>. + </p> + <p> + The JPEG-related tag is specified in + <a href="TIFFTechNote2.html">TIFF Technical Note #2</a> which defines + a revised JPEG-in-TIFF scheme (revised over that appendix that was + part of the TIFF 6.0 specification). + </p> + <hr> + <p> + Last updated: $Date: 2005/12/28 06:53:18 $ + </p> +</body> +</html> + diff --git a/src/3rdparty/libtiff/html/tools.html b/src/3rdparty/libtiff/html/tools.html new file mode 100644 index 0000000..d085dbc --- /dev/null +++ b/src/3rdparty/libtiff/html/tools.html @@ -0,0 +1,155 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta name="generator" content= +"HTML Tidy for Solaris (vers 12 April 2005), see www.w3.org"> +<title>TIFF Tools Overview</title> +</head> +<body bgcolor="white"> +<h1><font face="Arial, Helvetica, Sans"><img src="images/quad.jpg" +width="144" height="108" align="left" border="1" hspace="6"> TIFF +Tools Overview</font></h1> +<p>This software distribution comes with a small collection of +programs for converting non-TIFF format images to TIFF and for +manipulating and interogating the contents of TIFF images. Several +of these tools are useful in their own right. Many of them however +are more intended to serve as programming examples for using the +TIFF library.</p> +<h3>Device-dependent Programs</h3> +There are two device-dependent programs that serve as simple +examples for writing programs to display and save TIFF images. +<table border cellpadding="3"> +<tr> +<td valign="top" width="10%"> +<tt>tiffgt </tt></td> +<td>Display the contents of one or more TIFF images using OpenGL. +The software makes extensive use of the <tt>TIFFRGBAImage</tt> +facilities described elsewhere.</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiffsv</tt></td> +<td>A program to save all or part of a screen dump on a Silicon +Graphics system. As for <tt>tiffgt</tt> this code, while written to +use the IRIS GL, can be easily tailored to other devices.</td> +</tr> +</table> +<h3>Device-independent Programs</h3> +The remaining programs should be device-independent: +<table border cellpadding="3"> +<tr> +<td valign="top" width="10%"><tt>bmp2tiff</tt></td> +<td>Convert BMP images to TIFF</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>fax2ps</tt></td> +<td>Convert a Group 3- or Group 4- compressed TIFF to PostScript +that is significantly more compressed than is generated by +<tt>tiff2ps</tt> (unless <tt>tiff2ps</tt> writes PS Level II)</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>fax2tiff</tt></td> +<td>Convert raw Group 3 or Group 4 facsimile data to TIFF</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>gif2tiff</tt></td> +<td>A quick hack that converts GIF 87a format images to TIFF</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>pal2rgb</tt></td> +<td>Convert a Palette-style image to a full color RGB image by +applying the colormap</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>ppm2tiff</tt></td> +<td>A quick hack that converts PPM format images to TIFF</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>ras2tiff</tt></td> +<td>A quick hack that converts Sun rasterfile format images to TIFF +-- it's less than complete</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>raw2tiff</tt></td> +<td>Create a TIFF file from raw data</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>rgb2ycbcr</tt></td> +<td>Convert an RGB, grayscale, or bilevel TIFF image to a YCbCr +TIFF image; it's mainly provided for testing</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>sgi2tiff</tt></td> +<td>A program to convert SGI image files to TIFF. This program is +only useful on SGI machines as it uses <tt>-limage</tt>.</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>thumbnail</tt></td> +<td>Copy a bilevel TIFF to one that includes 8-bit greyscale +"thumbnail images" for each page; it is provided as an example of +how one might use the <tt>SubIFD</tt> tag (and the library support +for it)</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiff2bw</tt></td> +<td>A simple program to convert a color image to grayscale</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiff2pdf</tt></td> +<td>Convert TIFF images to PDF</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiff2ps</tt></td> +<td>Convert TIFF images to PostScript</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiff2rgba</tt></td> +<td>Convert a TIFF image to RGBA color space</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiffcmp</tt></td> +<td>Compare the contents of two TIFF files (it does not check all +the directory information, but does check all the data)</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiffcp</tt></td> +<td>Copy, concatenate, and convert TIFF images (e.g. switching from +Compression=5 to Compression=1)</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiffdither</tt></td> +<td>Dither a b&w image into a bilevel image (suitable for use +in creating fax files)</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiffdump</tt></td> +<td>Display the verbatim contents of the TIFF directory in a file +(it's very useful for debugging bogus files that you may get from +someone that claims they support TIFF)</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiffinfo</tt></td> +<td>Display information about one or more TIFF files.</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiffmedian</tt></td> +<td>A version of Paul Heckbert's median cut program that reads an +RGB TIFF image, and creates a TIFF palette file as a result; it's +useful for converting full-color RGB images to 8-bit color for your +friends that have cheapo 8-bit framebuffers.</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiffset</tt></td> +<td>Set a field in a TIFF header</td> +</tr> +<tr> +<td valign="top" width="10%"><tt>tiffsplit</tt></td> +<td>Create one or more single-image files from a (possibly) +multi-image file</td> +</tr> +</table> +<p>Check out the manual pages for details about the above +programs.</p> +<hr> +Last updated: $Date: 2006/01/03 02:16:07 $ +</body> +</html> diff --git a/src/3rdparty/libtiff/html/v3.4beta007.html b/src/3rdparty/libtiff/html/v3.4beta007.html new file mode 100644 index 0000000..c535d27 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta007.html @@ -0,0 +1,112 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta007 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta007<BR> +<B>Previous Version</B>: v3.4beta004<BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#port">Changes in the portability support</A> +<LI><A HREF="#tools">Changes in the tools</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI>bit order was corrected for Pentium systems +<LI>a new define, <TT>HOST_BIGENDIAN</TT>, was added for code that + wants to statically use information about native cpu byte order +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>the G3/G4 decoder was replaced by a new one that is faster and + has smaller state tables +<LI>Niles Ritter's client tag extension hooks were added +<LI>a new routine <TT>TIFFCurrentDirOffset</TT> was added for + applications that want to find out the file offset of a TIFF directory +<LI>the calculation of the number of strips in an image was corected + for images with certain esoteric configurations +<LI>a potential memory leak (very unlikely) was plugged +<LI>the <TT>TIFFReadRGBAImage</TT> support was completely rewritten + and new, more flexible support was added for reading images into + a fixed-format raster +<LI>YCbCr to RGB conversion done in the <TT>TIFFReadRGBAImage</TT> support + was optimized +<LI>a bug in JPEG support calculation of strip size was corrected +<LI>the LZW decoder was changed to initialize the code table to zero + to lessen potential problems that arise when invalid data is decoded +<LI><B>tiffcomp.h</B> is now aware of OS/2 +<LI>some function prototypes in <B>tiffio.h</B> and <B>tiffiop.h</B> + that contained parameter + names have been changed to avoid complaints from certain compilers +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="port"><B><FONT SIZE=+3>C</FONT>HANGES IN THE PORTABILITY SUPPORT:</B></A> + +<UL> +<LI><B>Makefile.in</B> has been corrected to use the parameters + chosen by the configure script +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> +<LI><TT>fax2ps</TT> has been rewritten and moved over from the user + contributed software +<LI>an uninitialized variable in <TT>pal2rgb</TT> has been fixed +<LI><TT>ras2tiff</TT> now converts 24-bit RGB raster data so that + samples are written in the proper order +<LI><TT>tiff2ps</TT> has been updated to include fixes + and enhancements from Alberto Accomazzi +<LI><TT>tiffcp</TT> now has a <TT>-o</TT> option to select a directory + by file offset +<LI><TT>tiffinfo</TT> is now capable of displaying the raw undecoded + image data in a file +<LI><TT>tiffgt</TT> has been rewritten to use the new <TT>TIFFRGBAImage</TT> + support and to handle multiple files +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta016.html b/src/3rdparty/libtiff/html/v3.4beta016.html new file mode 100644 index 0000000..22f185f --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta016.html @@ -0,0 +1,122 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta016 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta016<BR> +<B>Previous Version</B>: <A HREF=v3.4beta007.html>v3.4beta007</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#man">Changes in the manual pages</A> +<LI><A HREF="#html">Changes in the documentation</A> +<LI><A HREF="#contrib">Changes in contributed software</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI>support was added for configuring the Deflate codec +<LI>support was added for the HTML documentation +<LI>codecs that are not configured for inclusion in the library + are no longer compiled +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>support was added for registering new codecs external to the library + and for overriding the codecs that are builtin to the library +<LI>emulation support for the old <TT>DataType</TT> tag was improved +<LI>suppport was added for the <TT>SMinSampleValue</TT> + and <TT>SMaxSampleValue</TT> tags +<LI>the library no longer ignores <TT>TileWidth</TT> and <TT>TileLength</TT> + tags whose values are not a multiple of 16 (per the spec); this + permits old, improperly written, images to be read +<LI>the support for the <TT>Predictor</TT> tag was placed in a reusable + module so that it can be shared by multiple codecs +<LI>experimental compression support was added for the Deflate algorithm + (using the freely available zlib package) +<LI>a new routine, <TT>TIFFWriteBufferSetup</TT> was added a la the + routine <TT>TIFFReadBufferSetup</TT> +<LI>the DSO version of the library is now statically linked with the + JPEG and Deflate libraries; this means applications that link against + the DSO do not also need to link against these ancillary libraries +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> +<LI>all the tools now use common code to process compress-oriented arguments +<LI><TT>tiffdump</TT> should now compile on a Macintosh with MPW +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="man"><B><FONT SIZE=+3>C</FONT>HANGES IN THE MANUAL PAGES:</B></A> + +<UL> +<LI>everything was updated +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="html"><B><FONT SIZE=+3>C</FONT>HANGES IN THE DOCUMENTATION:</B></A> + +<UL> +<LI>everything was updated +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN CONTRIBUTED SOFTWARE:</B></A> + +<UL> +<LI><B>contrib/dbs/xtiff</B> was made to compile +<LI><B>contrib/mac-mpw</B> is new support for compiling the software on + a Macintosh under MPW; consult <A HREF=build.html#Mac>the documentation</A> + for details +<LI><B>contrib/tags</B> is information on how to use the tag extenion + facilities; consult + <A HREF=../contrib/tags/README>contrib/tags/README</A> for details +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta018.html b/src/3rdparty/libtiff/html/v3.4beta018.html new file mode 100644 index 0000000..ac1877f --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta018.html @@ -0,0 +1,84 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta018 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta018<BR> +<B>Previous Version</B>: <A HREF=v3.4beta016.html>v3.4beta016</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI>configure now recognizes IRIX 6.x systems +<LI>configure now uses <TT>ENVOPTS</TT> when searching for an ANSI + C compiler; this fixes a problem configuring the software under + HP/UX with the native C compiler +<LI>configure now correctly recognizes memory-mapped files are supported + under AIX +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI><TT>make install</TT> now properly installs the include files +<LI>some portability fixes from Bjorn Brox +<LI>the G3/G4 codec now warns about decoded rows that are longer than + the image/tile width +<LI>changes from Frank Cringle to make the library work with the + gcc-specific bounds checking software +<LI>miscellaneous fixes to <TT>TIFFPrintDirectory</TT> +<LI>bug fix to correct a problem where <TT>TIFFWriteRawStrip</TT> + could not be used to automatically grow an image's length +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> +<LI>fixes from Frank Cringle to update <TT>fax2tiff</TT> +<LI>portability fixes to <TT>tiff2bw</TT> and <TT>tiffcmp</TT> +<LI><TT>tiffdump</TT> now uses the byte swapping routines in the library +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta024.html b/src/3rdparty/libtiff/html/v3.4beta024.html new file mode 100644 index 0000000..25a3347 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta024.html @@ -0,0 +1,139 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta024 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta024<BR> +<B>Previous Version</B>: <A HREF=v3.4beta018.html>v3.4beta018</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#man">Changes in the manual pages</A> +<LI><A HREF="#contrib">Changes in the contributed software</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI>It is now possible to setup the software to build only the + library; configure reconizes this is the intent when the + <B>VERSION</B>, <B>tiff.alpha</B>, and <B>tif_version.c</B> + files are in the local directory (i.e. ``.'') +<LI>configure no longer tries to setup HTML materials +<LI>include file directories needed in building the library are now + specified with a <TT>DIRS_LIBINC</TT> config parameter +<LI>configure no longer checks for alternate compilers if <TT>CC</TT> + is set; if the specified compiler is not found or is not appropriate + the configuration procedure aborts +<LI>the <B>port.h</B> file generated by configure is now used only by + the library and as such as have been moved to the <B>libtiff</B> + directory +<LI>there is beginning support for building DSO's on systems other than IRIX +<LI>configure now verifies the JPEG and zlib directory pathnames by + checking for well-known include files in these directories +<LI>configure no longer creates the <B>dist</B> directory needed only + on SGI machines (for building SGI binary distributions) +<LI>a bug was fixed whereby configure would incorrectly set + <TT>ENVOPTS</TT> when building the software with gcc under AIX +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>two new typedefs were added to <B>tiff.h</TT>: <TT>int8</TT> + and <TT>uint8</TT> for signed and unsigned 8-bit quantities, + respectively; these are currently used only by + programs in the <B>tools</B> directory +<LI>the <TT>BadFaxLines</TT>, <TT>CleanFaxData</TT>, and + <TT>ConsecutiveBadFaxLines</B> tags are now supported with + Group 4 compression +<LI>byte order is now correctly identified on 64-bit machines +<LI>a bug was fixed in the PackBits decoder where input data would + appear short when a no-op run was present +<LI>a bug was fixed in calculations with very wide strips +<LI><TT>TIFFWriteEncodedStrip</TT> and <TT>TIFFWriteRawStrip</TT> + were extended to support dynamically growing the number of + strips in an image (must set <TT>ImageLength</TT> prior to + making calls though) +<LI><TT>TIFFDefaultTileSize</TT> now rounds tile width and height + up to a multiple of 16 pixels, as required by the TIFF 6.0 specification +<LI>the file <B>version.h</B> is now built by a new <B>mkversion</B> + program; this was done for portability to non-UNIX systems +<LI>support was added for the Acorn RISC OS (from Peter Greenham) +<LI>the builtin codec table is now made <TT>const</TT> when compiling + under VMS so that <B>libtiff</B> can be built as a shared library +<LI>support for the PowerPC Mac (from Ruedi Boesch) +<LI>support for Window NT/Window 95 (from Scott Wagner) +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> +<LI>the tools no longer include <B>port.h</B> +<LI>various portability fixes; mostly to eliminate implicit assumptions + about how long <TT>int32</TT> data types are +<LI>PostScript Level II additions to <TT>tiff2ps</TT> from Bjorn Brox +<LI><TT>sgi2tiff</TT> now handles RGBA images +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="man"><B><FONT SIZE=+3>C</FONT>HANGES IN THE MANUAL PAGES:</B></A> + +<UL> +<LI>the documentation has been updated to reflect the current state of + the software +<LI>some routines have been moved to different manual pages + to group like-routines together +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIBUTED SOFTWARE:</B></A> + +<UL> +<LI>support was added for the Acorn RISC OS (from Peter Greenham) +<LI>support for Windows NT/Windows 95 contributed for a previous + version of this software was sort of incorporated (it's broken + right now) (from Scott Wagner) +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta028.html b/src/3rdparty/libtiff/html/v3.4beta028.html new file mode 100644 index 0000000..ff7ef69 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta028.html @@ -0,0 +1,146 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta028 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta028<BR> +<B>Previous Version</B>: <A HREF=v3.4beta024.html>v3.4beta024</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#man">Changes in the manual pages</A> +<LI><A HREF="#contrib">Changes in the contributed software</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI>a <TT>-noninteractive</TT> flag was added to configure to + control whether or not it prints and prompts for configuration information +<LI>various typos and fixes were made in configure for the the + library-only build support (this and other configure fixes from + Richard Mlynarik <A HREF=mailto:mly@adoc.xerox.com><mly@adoc.xerox.com></A>) +<LI>bugs were fixed in the handling of pathnames supplied for external + packages; e.g. <TT>DIR_JPEG</TT> +<LI>the handling of <TT>SETMAKE</TT> is now done properly +<LI>the default prototype function declaration for <TT>pow</TT> was corrected +<LI>a bug was fixed in <B>libtiff/Makefile.in</B> that caused installation + to fail on systems without DSO support +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>Acorn RISC O/S support that was accidentally left out of the + left out of the previous distribution is present (from Peter Greenham) +<LI>complaints about unknown and/or unsupported codecs have been + delayed until they are invoked; this permits applications to open + images and look at tags even if the image data is compressed with + an unknown/unsupported compression scheme +<LI>bugs in handling unknown tags have been corrected; applications + that use multiple codecs, each with codec-specific tags, no longer + generate confusing error messages +<LI>a missing pseudo-tag definition in the CCITT G3 codec was fixed + (this problem caused core dumps in the <TT>tiffcp</TT> program) +<LI>pseudo-tags are now treated specially; they are always considered + to be set (i.e. they do not use bits in the <TT>FIELD_*</TT> bit-vectors). +<LI>the use of strip chopping can now be controlled on a per-file basis + through a mode parameter supplied when opening a file (``C'' to + enable strip chopping and ``c'' to disable) +<LI>two bugs were fixed in the writing of opposite-endian byte-order + files +<LI>support was added for three new fax-related tags registered to + SGI: FaxRecvParams, FaxRecvTime, and FaxSubAddress +<LI>the bit order of image data read and written can now be controlled + on a per-file basis through a mode parameter supplied when opening + a file (``B'' to force MSB2LSB bit order, ``L'' for LSB2MSB bit + order, and ``H'' for the bit order of the native CPU) +<LI>the byte order of image and tag data written to newly-created files + can now be controlled on a per-file basis through a mode parameter + supplied when openening a file (``b'' to force Big-Endian byte order + and ``l'' to force Little-Endian byte order) +<LI>the use memory-mapped files for images opened read-only can now + be controlled on a per-file basis through a mode parameter supplied + when opening a file (``M'' to enable use of memory-mapped files + and ``m'' to disable use) +<LI>the use of the <TT>WIN32</TT> define in <B>tiffiop.h</B> has + been replaced by <TT>__WIN32__</TT> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> +<LI><TT>fax2ps</TT> now does a <TT>save</TT> and <TT>restore</TT> + around each page of PostScript; this fixes a problem with VM + overflow when printing a many-page document on some printers +<LI>a bug in the handling of 3-channel images by <TT>ras2tiff</TT> + was fixed +<LI><TT>tiffcp</TT> has new options to control the byte order of + newly created files: <B>-B</B> for Big-Endian byte order, <B>-L</B> + for Little-Endian byte order; a <B>-M</B> option to disable the + use of memory-mapped files, and a <B>-C</B> option to disable the + use of strip chopping +<LI>bugs were fixed in <TT>tiffcp</TT>'s handling of codec-specific tags +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="man"><B><FONT SIZE=+3>C</FONT>HANGES IN THE MANUAL PAGES:</B></A> + +<UL> +<LI>the <TT>TIFFOpen</TT> page has been updated to reflect the new + optional open mode parameters +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIBUTED SOFTWARE:</B></A> + +<UL> +<LI><B>contrib/win95</B> contains information and code from Philippe Tenenhaus + <A HREF=mailto:100423.3705@compuserve.com><100423.3705@compuserve.com></A> + about using the software under Windows 95 +<LI><B>contrib/winnt</B> contains information and code from Dave Dyer + <A HREF=mailto:ddyer@triple-i.com><ddyer@triple-i.com></A> + about using the software under Windows NT +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta029.html b/src/3rdparty/libtiff/html/v3.4beta029.html new file mode 100644 index 0000000..f2a3d3f --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta029.html @@ -0,0 +1,86 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta029 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta029<BR> +<B>Previous Version</B>: <A HREF=v3.4beta028.html>v3.4beta028</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#contrib">Changes in the contributed software</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI><B>configure</B> now relativizes pathname references given in + <TT>-L</TT> options (as frequently specified when configuring + ancillary packages) +<LI>problems related to configuring the software on Ultrix 4.4 have + been corrected +<LI>the shell to use in Makefiles and scripts can now be set with the + <TT>SCRIPT_SH</TT> configuration parameter +<LI>comments in <B>config.site</B> now correctly indicate how to setup the + use of ancillary packages +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>mods for building the software on a Mac using the + MetroWerks CodeWarrior compilers +<LI>a bug in the CCITT T.4/T.6 decoder was fixed where the last codeword in + a strip/tile might not be decoded; this was seen only when decoding + multi-strip images +<LI>a bug in the CCITT RLE codecs was fixed whereby the pseudo tags were not + being properly registered +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIBUTED SOFTWARE:</B></A> + +<UL> +<LI><B>contrib/mac-cw</B> contains information and code from Niles Ritter + <A HREF=mailto:ndr@tazboy.jpl.nasa.gov><ndr@tazboy.jpl.nasa.gov></A> + about building the software with the MetroWerks CodeWarrior compilers + on Macintosh systems +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta031.html b/src/3rdparty/libtiff/html/v3.4beta031.html new file mode 100644 index 0000000..d5b7eac --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta031.html @@ -0,0 +1,94 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta031 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta031<BR> +<B>Previous Version</B>: <A HREF=v3.4beta029.html>v3.4beta029</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#man">Changes in the manual pages</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI><B>configure</B> now captures significantly more information + in the <B>config.log</B> file and provides more information when + it is unable to setup a configuration +<LI>support was added for building shared libraries on more systems: + AIX, HPUX, Solaris, and Linux. +<LI>a new configuration parameter <TT>LIBCOPTS</TT> was added for + passing arguments to the C compiler to use when building only + the library; this is part of the enhanced support for building + shared libraries +<LI>include files for optional packages that reside in <B>/usr/include</B> + are now handled correctly +<LI>build trees may now be configured using either relative or absolute + pathnames to the source distribution +<LI>several new configuration parameters were added, mainly for building + shared libraries: <TT>DIST_MAJOR</TT>, <TT>DIST_MINOR</TT>, + <TT>DIST_ALPHA</TT>, and <TT>DSOSUF_VERSION</TT> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>the Deflate support has been revised: it requires version 0.99 of + the zlib software distribution, <B>the output format has changed and + is incompatible with previous versions of this library</B> (each + strip now includes a header read and written by the zlib library) +<LI>the codec name printed by the TIFFPrintDirectory routine is now + taken from the codec table instead of from a builtin table; this means + that application-defined codecs are handled correctly +<LI>a new symbol was added that contains the library version number; + this can be used to do a compile-time compatibility check of the + library version +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="man"><B><FONT SIZE=+3>C</FONT>HANGES IN THE MANUAL PAGES:</B></A> + +<UL> +<LI>the creation and installation of manual pages was redone; it now + implements the documented ``configuration scheme'' +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta032.html b/src/3rdparty/libtiff/html/v3.4beta032.html new file mode 100644 index 0000000..bc14ef3 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta032.html @@ -0,0 +1,90 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta032 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta032<BR> +<B>Previous Version</B>: <A HREF=v3.4beta031.html>v3.4beta031</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contributed software</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI>various fixups and subtle improvements to <B>configure</B> + from Richard Mlynarik +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>a new codec from Pixar designed for high-resolution color images; + note that this codec is not configured by default +<LI>a bug fix for reading tags with a single <TT>FLOAT</TT> value +<LI>change to the <TT>TIFFGetField</TT> calling convention: + a tag that has a single value of + type <TT>DOUBLE</TT> is now retrieved by passing a + ``<TT>double*</TT>'' instead of a + ``<TT>double**</TT>'' (this change makes the handling of tags with + <TT>DOUBLE</TT> values identical to the handling of tags with + <TT>FLOAT</TT> values) +<LI>fix to VMS support for the handling of floating point values +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> +<LI><B>tiffdump</B> now handles tags with <TT>FLOAT</TT> and <TT>DOUBLE</TT> + values +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIBUTED SOFTWARE:</B></A> + +<UL> +<LI>updates to the Acorn OS support from Peter Greenham +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta033.html b/src/3rdparty/libtiff/html/v3.4beta033.html new file mode 100644 index 0000000..8d8345a --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta033.html @@ -0,0 +1,82 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta033 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta033 (aka the v3.4 release)<BR> +<B>Previous Version</B>: <A HREF=v3.4beta032.html>v3.4beta032</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contributed software</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI>support was added for building the library as a DSO under OSF/1 +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>fixes to the Pixar codec +<LI>portability mods for VMS +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> +<LI>fixes to <B>gif2tiff</B> and <B>ppm2tiff</B> for building under MS/DOS +<LI>portability mods to <B>fax2ps</B> and <B>ycbcr</B> for VMS +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIBUTED SOFTWARE:</B></A> + +<UL> +<LI>a new package from Alexander Lehmann + for building the library and tools under MS/DOS with DJGPP v2 +<LI>updated VMS support from Karsten Spang +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta034.html b/src/3rdparty/libtiff/html/v3.4beta034.html new file mode 100644 index 0000000..77d9863 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta034.html @@ -0,0 +1,68 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta034 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta034<BR> +<B>Previous Version</B>: <A HREF=v3.4beta033.html>v3.4beta033</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI>support was added for building the library as a DSO under NetBSD +<LI>a bug was fixed in the DSO support for Linux +<LI>the handling of version strings has changed slightly to simplify parsing +<LI>a new parameter, <TT>TIFFLIBREF</TT>, was added to control how the + library is referenced when linking programs in the <B>tools</B> directory +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>DSO creation under Solaris now forces the DSO name with a <TT>-h</TT> option +<LI>the interface to the <B>mkversion</B> program was changed + to eliminate the need to parse files +<LI>a bug was fixed in the EOL-detection logic of the T.4/T.6 decoder +<LI>ANSI IT8 TIFF/IT tag definitions were added to <B>tiff.h</B> +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta035.html b/src/3rdparty/libtiff/html/v3.4beta035.html new file mode 100644 index 0000000..22fb2b8 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta035.html @@ -0,0 +1,63 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta035 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta035<BR> +<B>Previous Version</B>: <A HREF=v3.4beta034.html>v3.4beta034</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI>support was added installing the HTML documentation +<LI>support was added for building the library as a DSO under FreeBSD +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>the interface to the <B>mkversion</B> program was restored to + the form used prior to v3.4beta034 +<LI>several portability problems for 16-bit systems were fixed +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.4beta036.html b/src/3rdparty/libtiff/html/v3.4beta036.html new file mode 100644 index 0000000..e36754d --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.4beta036.html @@ -0,0 +1,117 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.4beta036 +</TITLE> +</HEAD> + +<BODY> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.4beta036<BR> +<B>Previous Version</B>: <A HREF=v3.4beta035.html>v3.4beta035</A><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.sgi.com/graphics/tiff">ftp.sgi.com (192.48.153.1), directory graphics/tiff</A><BR> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<LI>support was added for building the library as a DSO under HP-UX with + the native C compiler +<LI>tools are now built with explicit pathnames for the DSO under IRIX, + Solaris, and Linux +<LI>DSO configuration support for Linux was changed to require that + <B>libc.so</B> only be readable (not executable) +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> +<LI>support was add for ICC: <TT>NumberOfInks</TT>, and <TT>ICCProfile</TT> +<LI>a memory leak caused by doing <TT>TIFFSetDirectory(0)</TT> was fixed +<LI>a bug was fixed whereby certain multi-directory files were not + properly handled when accessed by mapping the data into memory +<LI>the strip chopping support is now always compiled + into the library with the default usage controlled by a + <TT>STRIPCHOP_DEFAULT</TT> configuration parameter +<LI>the strip chopping support no longer chops tiled images +<LI>all static strings are now const--for shared libraries +<LI>the logic for estimating the strip size of images without + a <TT>StripByteCounts</TT> tag was improved by handling + <TT>PlanarContig</TT> images differently from <TT>PlanarSeparate</TT> +<LI>a bug was fixed in the G3 codec when converting the Y resolution + of data specified in metric units +<LI>a bug was fixed in the G3/G4 decoder for data where lines terminate + with a v0 code +<LI>the <TT>TIFFRGBAImage</TT> support was changed to scale 16-bit colormap + entries more conservatively to avoid problems with applications + that do not generate fully saturated pixel values +<LI>the LZW decoder was changed to use a more conservative scheme when + bounds checking the hash table array; this avoids pitfalls with + systems that load objects into memory in unusual locations +<LI>a bug was fixed in <TT>TIFFPrintDirectory</TT>'s handling of the + <TT>InkNames</TT> tag +<LI><TT>TIFFPrintDirectory</TT> now understands <TT>NumberOfInks</TT> + and ICC-related tags +<LI>the routines for reading image data now provide more useful information + when a read error is encountered +<LI>support was added for compiling with Microsoft Visual C++ 4.0 +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> +<LI>a bug was fixed in <B>pal2rgb</B>'s colormap handling +<LI><B>tiff2ps</B> now includes John Wehle's changes for maintaining + the aspect ratio + of images when scaling and for honoring the deadzone on a page when + generating PostScript Level II +<LI><B>tiff2ps</B> does a better job guarding against the mishandling + of greyscale images +<LI><B>tiff2ps</B> now correctly converts X- and Y-resolution values + specified in metric units +<LI><B>tiffdump</B> has a new <TT>-m</TT> option to control the maximum + number of indirect + data values printed for a tag (by default 24) +<LI><B>tiffdump</B> understands several new tags +<LI><B>tiffdump</B> now shows any terminating null in ASCII strings +<LI><B>tiffinfo</B> now suppresses strip chopping when interpreting an image; + a new <TT>-z</TT> option has been added to enable strip chopping +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +<ADDRESS> +<A HREF="sam.html">Sam Leffler</A> / <A HREF="mailto:sam@engr.sgi.com">sam@engr.sgi.com</A> +Last updated $Date: 1999/08/09 20:21:21 $. +</ADDRESS> + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.5.1.html b/src/3rdparty/libtiff/html/v3.5.1.html new file mode 100644 index 0000000..0c88de9 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.5.1.html @@ -0,0 +1,75 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.5.1 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.5.1<BR> +<B>Previous Version</B>: v3.4beta037<BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.onshore.com/pub/libtiff">ftp.onshore.com, directory graphics/tiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff/>http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <LI> <em> None of consequence </em> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + + +<UL> +<LI> Support was added for IPTC Newsphoto metadata (TIFFTAGE_IPTCNEWSPHOTO) +<LI> Support was added for photoshop caption handling (TIFFTAG_PHOTOSHOP) +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> +<LI> <A HREF=mailto:billr@corbis.com>Bill Radcliffe's</a> iptcutil was +added to the "contrib" subdirectory . It can convert an IPTC binary +blob to ASCII text and vice-versa. The blob itself can be extracted +from or added to an image with the <A +href=http://www.ImageMagick.org/>ImageMagick</a> convert(1) +utility. +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2006/01/03 01:42:30 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.5.2.html b/src/3rdparty/libtiff/html/v3.5.2.html new file mode 100644 index 0000000..71b486a --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.5.2.html @@ -0,0 +1,108 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.5.2 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.5.2<BR> +<B>Previous Version</B>: <A HREF=v3.5.1.html>v3.5.1</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.onshore.com/pub/libtiff">ftp.onshore.com, directory graphics/tiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff/">http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <LI> Corrected alpha versioning. + + <LI> Removed distinction between alpha and release targets in Makefile.in. + + <LI> Added release.stamp target, which tags cvs tree, and updates + "RELEASE-DATE" + + <LI> Added releasediff target, which diffs tree with source as of + date in "RELEASE-DATE" + + <LI>Ticked up version to 3.5.2 (alpha 01 -- but I think we'll moving + away from alpha/non-alpha distinctions). + +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + + +<UL> + <LI> Added IRIX/gcc, and OSF/1 4.x support on behalf of + Albert Chin-A-Young <china@thewrittenword.com> + + <LI> Added TIFFReassignTagToIgnore() API on behalf of + Bruce Cameron <cameron@petris.com>. Man page still pending. + + <LI> pre-remove so link before softlink in LINUXdso action in + libtiff/Makefile.in to avoid failure on LINUXdso builds other than + the first. + + <LI> Fixed problem with cvtcmap() in tif_getimage.c modifying the + colormaps owned by the TIFF handle itself when trying to fixup wrong + (eight bit) colormaps. Corrected by maintaining a private copy of + the colormap. + + <LI> Added TIFFReadRGBATile()/TIFFReadRGBAStrip() support in + tif_getimage.c. + + <LI> Applied "a" mode fix to tif_win32.c/TIFFOpen() as suggested + by Christopher Lawton <clawton@mathworks.com> + + <LI> Set O_BINARY for tif_unix.c open() ... used on cygwin for instance. + + <LI> Added CYGWIN case in configure. + + <LI> Applied Francois Dagand's patch to handle fax decompression bug. + (sizes >= 65536 were failing) +</UL> + +<P><HR WIDTH=65% ALIGN=right> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <LI> Added addtiffo (add overviews to a TIFF file) in contrib. Didn't + put it in tools since part of it is in C++. +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2004/11/26 14:37:20 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.5.3.html b/src/3rdparty/libtiff/html/v3.5.3.html new file mode 100644 index 0000000..e7910d9 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.5.3.html @@ -0,0 +1,132 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.5.3 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Arial, Helvetica, Sans"> +<FONT FACE="Arial, Helvetica, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.5.3<BR> +<B>Previous Version</B>: <A HREF=v3.5.2.html>v3.5.2</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.onshore.com/pub/libtiff">ftp.onshore.com</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff/">http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +</UL> +<p> +The ChangeLog will follow, but please note the most important change: +LZW compression has been removed. +<p> +Unisys has the patent on LZW compression and have been very active in +their enforcement of late, demanding payments of $5000 or more from +websites using unlicensed software to create GIF's. They could well +do the same do persons using libtiff to create LZW compressed TIFF +images. +<p> +From <A HREF=http://burnallgifs.org>Burn All GIF's Day</a>: +<br> +<em>The catch is that it appears to be difficult or impossible to get a +Unisys license to use LZW in free software that complies with the Open +Source Definition</em> +<P> +Unfortunatly, the removal of LZW compression means that saved image size has +grown dramatically. Without a change in the TIFF spec to support +another lossless compression format, this is unavoidable. +<P> +The library can use zip for lossless compression, but as this is not +part of the spec, TIFFs using zip compression may not work with other +software +<P> +We will be making a patch available that will contain the LZW +compression code for users who have either obtained a license from +Unisys or are willing to risk it. +<p> +LZW decompression is unchanged. +<p> +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <LI> Added zip creation to release makefile target + + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + + +<UL> + + <LI> Added html for TIFFWriteTile.3t man page. + + <LI> Added some changes to tif_write.c to support rewriting existing + fixed sized tiles and strips. Code mods disabled by default, only + enabled if REWRITE_HACK is defined for now. + + <LI> Added TIFFWriteTile.3t man page. + + <LI> Added notes on use of makefile.vc in build.html, and fixed + email subscription address. + + <LI> Fixed apocalypse-inducing y2k bug in contrib/ras/ras2tiff.c + + <LI> Did some casts cleaning up to reduce compiler warnings in tif_fax3.c, + from Bruce Carmeron <cameron@petris.com> -- modifications of + changes made by Frank (sun cc still complained on cast). + + <LI> fixed various VC++ warnings as suggested by Gilles Vollant + <info@winimage.com>. + + <LI> Modified TIFFquery.3t man pages info on TIFFIsByteSwapped() to + not imply applications are responsible for image data swapping. + + <LI> HTML-ized the man pages, added to html/man + + <LI> Removed LZW Compression to comply with Unisys patent extortion. + + <LI> Corrected one remaining 16 -> 32 bit value in tif_fax3.c, + From Ivo Penzar <ivo.penzar@infolink-software.com. + + <LI> Added patch from Ivo Penzar to have TiffAdvanceDirectory handle + memory mapped files. <ivo.penzar@infolink-software.com> +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <LI> Fixed apocalypse-inducing y2k bug in contrib/ras/ras2tiff.c +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2004/11/26 14:37:20 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.5.4.html b/src/3rdparty/libtiff/html/v3.5.4.html new file mode 100644 index 0000000..714621e --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.5.4.html @@ -0,0 +1,88 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.5.4 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.5.4<BR> +<B>Previous Version</B>: <A HREF=v3.5.3.html>v3.5.3</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.onshore.com/pub/libtiff">ftp.onshore.com</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff/">http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <LI> None + + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + + +<UL> + + <li> Added Pixar tag support. Contributed by Phil Beffery <phil@pixar.com> + + <li> Made one more change to tif_dir.c for removal of LZW compression. Also added notice + when LZW compression invoked. + + <li> Fixed bug that caused LZW (non) compression to segfault. Added + warning about LZW compression removed being removed, and why. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <li> Changed default compression in tools to TIFF_PACKBITS, and changed usage descriptions + in tools to reflect removal of LZW compression + + <li> Added nostrip to install in tools/Makefile.in so that debugging + symbols are kept. + + <li> Made Packbits the default compression in tools/tiff2rgba.c instead + of LZW. + + +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2006/01/03 01:45:41 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.5.5.html b/src/3rdparty/libtiff/html/v3.5.5.html new file mode 100644 index 0000000..20be92f --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.5.5.html @@ -0,0 +1,155 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.5.5 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.5.5<BR> +<B>Previous Version</B>: <A HREF=v3.5.4.html>v3.5.4</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.onshore.com/pub/libtiff">ftp.onshore.com</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff/">http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#lzwkit">Changes in the LZW compression kit</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + + <LI> configure: added test for libc6 for linux targets. Bug reported by + Stanislav Brabec <utx@k332.feld.cvut.cz> + + <LI> configure: fixed bugs in sed scripts + (applied sed script s:/@:s;@:;s:/s;;:;: to configure). + fix submitted by Stanislav Brabec <utx@k332.feld.cvut.cz> + + <LI> tools/iptcutil was not in files list, and wasn't being + added to tar archive. Updated Makefile.in. + + <LI> Added 3.5 docs to html/Makefile.in. + Thanks to Stanislav Brabec <utx@k332.feld.cvut.cz> + + <LI> Fixed tools/tiffcmp so that stopondiff testing works. + Patch care of Joseph Orost <joe@sanskrit.lz.att.com>. + + <LI> Added fax3sm_winnt.c to distribution list in Makefile.in. + + <LI> Added libtiff/libtiff.def to TIFFILES distribution list. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + + +<UL> + <LI>tif_fax3.c: Fixed serious bug introduced during the uint16->uint32 + conversion for the run arrays. + + <LI> Set td_sampleformat default to SAMPLEFORMAT_UINT instead of + SAMPLEFORMAT_VOID in TIFFDefaultDirectory() in tif_dir.c. + + <LI> Added "GetDefaulted" support for TIFFTAG_SAMPLEFORMAT in tif_aux.c. + + <LI> Patched tif_fax3.c so that dsp->runs is allocated a bit bigger + to avoid overruns encountered with frle_bug.tif. + + + <LI> Modified tif_unix.c to support 2-4GB seeks if USE_64BIT_API is + set to 1, and added default (off) setting in tiffconf.h. This + should eventually be set by the configure script somehow. + + The original work on all these 2-4GB changes was done by + Peter Smith (psmith@creo.com). + + <LI> Modified tif_win32.c to support 2-4GB seeks. + + <LI> tentatively changed toff_t to be unsigned instead of signed to + facilitate support for 2-4GB files. + + <LI> Updated a variety of files to use toff_t. Fixed some mixups + between toff_t and tsize_t. + + <LI> Set tif_rawdatasize to zero when freeing raw data buffer in + TIFFWriteDirectory(). + + <LI> Enabled "REWRITE_HACK" in tif_write.c by default. + + <LI> Fix bug in tif_write.c when switching between reading one directory + and writing to another. + + <LI> Made TIFFWriteCheck() public, and added TIFFCreateDirectory() + + <LI> Added TIFFmemory(3t) functions to libtiff.def. + + <LI> Added libtiff/libtiff.def to TIFFILES distribution list. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <LI> fax2ps: Fixed mixup of width and height in bounding box statement + as per submission by Nalin Dahyabhai <nalin@redhat.com>. + + <LI> fax2ps: Modified printruns to take uint32 instead of uint16. + Patch courtesy of Bernt Herd <herd@herdsoft.com> + + + <LI> Largely reimplemented contrib/addtiffo to avoid temp files, + updating the TIFF file in place. Fixed a few other bugs to. + + <LI> Altered descriptions in tools to reflect "by default" lzw not supported +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="lzwkit"><B><FONT SIZE=+3>C</FONT>HANGES IN THE LZW COMPRESSION KIT</B></A> +<UL> + <LI>created mangle-src.sh -- sed scripts to munge src into LZW enabled format. Thanks to Stanislav Brabec <utx@k332.feld.cvut.cz> + + <LI>created Makefile + + <LI>merged tif_dir.c with current source. + + + <LI> Created lzw compression kit, as a new CVS module (libtiff-lzw-compression-kit). + + <LI> Updated index.html to note lzw compression kit. + +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2004/11/26 14:37:20 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.5.6-beta.html b/src/3rdparty/libtiff/html/v3.5.6-beta.html new file mode 100644 index 0000000..682f845 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.5.6-beta.html @@ -0,0 +1,185 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.5.6 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.5.6beta<BR> +<B>Previous Version</B>: <A HREF=v3.5.5.html>v3.5.5</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.onshore.com/pub/libtiff">ftp.onshore.com</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff/">http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in contrib</A> +<LI><A HREF="#lzwkit">Changes in the LZW compression kit</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + + <LI> Added GNULDdso target and switched linux and freebsd to use it. + <LI> tools/Makefile.in: Modified to install properly on SGI. + <LI> configure: Fixed DSO test for Linux as per patch from + Jan Van Buggenhout <chipzz@Ace.ULYSSIS.Student.KULeuven.Ac.Be>. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + + +<UL> + + <LI> tif_dir.c: Clear TIFF_ISTILED flag in TIFFDefaultDirectory + as per http://bugzilla.remotesensing.org/show_bug.cgi?id=18 + from vandrove@vc.cvut.cz. + + <LI> Modified tif_packbits.c decoding to avoid overrunning the + output buffer, and to issue a warning if data needs to be + discarded. See http://bugzilla.remotesensing.org/show_bug.cgi?id=18 + + <LI> Modified TIFFClientOpen() to emit an error on an attempt to + open a comperessed file for update (O_RDWR/r+) access. This is + because the compressor/decompressor code gets very confused when + the mode is O_RDWR, assuming this means writing only. See + bug http://bugzilla.remotesensing.org/show_bug.cgi?id=13 + + <LI> Applied patch for 0x0000 sequences in tif_fax3.h's definition + of EXPAND1D() as per bug 11 (from Roman). + + <LI> Fixed tiffcomp.h to avoid win32 stuff if unix #defined, to improve + cygwin compatibility. + + <LI> Applied patch from Roman Shpount to tif_fax3.c. This seems to + be a proper fix to the buffer sizing problem. See + http://bugzilla.remotesensing.org/show_bug.cgi?id=11 + + <LI> Fixed tif_getimage.c to fix overrun bug with YCbCr images without + downsampling. http://bugzilla.remotesensing.org/show_bug.cgi?id=10 + Thanks to Nick Lamb <njl98r@ecs.soton.ac.uk> for reporting the + bug and proving the patch. + + <LI> Fixed tif_jpeg.c so avoid destroying the decompressor before + we are done access data thanks to bug report from: + Michael Eckstein <eckstein@gepro.cz>. + + <LI> tif_open.c: Don't set MMAP for O_RDWR files. + + <LI> tif_open.c: Set STRIPCHOP_DEFAULT for O_RDWR as well as O_RDONLY + so that files opened for update can be strip chopped too. + + <LI> tif_read.c: fixed up bug with files missing rowsperstrip and + the strips per separation fix done a few weeks ago. + + <LI> Tentatively added support for SAMPLEFORMAT_COMPLEXIEEEFP, and + SAMPLEFORMAT_COMPLEXINT. + + <LI> index.html, bugs.html: added bugzilla info. + + <LI> tif_read.c: fix subtle bug with determining the number of + rows for strips that are the last strip in a separation but + not the last strip of all in TIFFReadEncodedStrip(). + + <LI> Applied 16/32 bit fix to tif_fax3.c. Fix supplied by + Peter Skarpetis <peters@serendipity-software.com.au> + + <LI> Modified tiffio.h logic with regard to including windows.h. It + won't include it when building with __CYGWIN__. + + <LI> README: update to mention www.libtiff.org, don't list Sam's old + email address. + + <LI> libtiff/tif_dirread.c: Don't use estimate strip byte count for + one tile/strip images with an offset, and byte count of zero. These + could be "unpopulated" images. + + <LI> tif_win32.c: Applied patch to fix overreads and ovverwrites + caught by BoundsChecker. From Arvan Pritchard + <arvan.pritchard@infomatix.co.uk> (untested). + + <LI> tif_getimage.c: Applied patch to silence VC6 warnings. From + Arvan Pritchard <arvan.pritchard@informatix.co.uk> + + <LI> tif_lzw.c: Applied patch to silence VC6 warnings. From + Arvan Pritchard <arvan.pritchard@informatix.co.uk> + + <LI> libtiff/tif_apple.c: Applied "Carbon" support patches supplied by + Leonard Rosenthol <leonardr@lazerware.com>. May interfere + with correct building on older systems. If so, please let me know. + + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + + <LI> tools/rgb2ycbcr.c: fixed output strip size to account for vertical + roundup if rows_per_strip not a multiple of vertical sample size. + + <LI> tools/tiffsplit.c: Copy TIFFTAG_SAMPLEFORMAT. + + <LI> Modified tiff2bw to ensure portions add to 100%, and that + white is properly recovered. See bug + http://bugzilla.remotesensing.org/show_bug.cgi?id=15 Patch + c/o Stanislav Brabec <utx@penguin.cz> + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN CONTRIB:</B></A> + +<UL> + + <LI> contrib/addtiffo: Added "averaging" resampling option. + + <LI> Added contrib/stream (stream io) code submitted by Avi Bleiweiss. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<A NAME="lzwkit"><B><FONT SIZE=+3>C</FONT>HANGES IN THE LZW COMPRESSION KIT</B></A> +<UL> + + <LI> updated tif_dir.c to reflect changes to no-lzw tif_dir.c + +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2006/03/18 17:12:47 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.5.7.html b/src/3rdparty/libtiff/html/v3.5.7.html new file mode 100644 index 0000000..528df74 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.5.7.html @@ -0,0 +1,259 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.5.7 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.5.7<BR> +<B>Previous Version</B>: <A HREF=v3.5.6-beta.html>v3.5.6 Beta</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff">ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff/">http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#lzwkit">Changes in the LZW compression kit</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<li> libtiff/libtiff.def: Brent Roman submitted new version adding +serveral missing entry points. Also add a few other entry points +later. + +<li> configure, Makefile.in, etc: added support for OPTIMIZER being + set from config.site. +<li> config.guess: updated wholesale to an FSF version apparently + from 1998 (as opposed to 1994). This is mainly inspired by + providing for MacOS X support. + +<li> configure/config.site: modified to check if -lm is needed for + MACHDEPLIBS if not supplied by config.site. Needed for Darwin. +<li> libtiff/tiff.h: Applied hac to try and resolve the problem + with the inttypes.h include file on AIX. (Bug 39) + +<li> configure, *Makefile.in: Various changes to improve configuration + for HP/UX specifically, and also in general. (Bug 40) They include: +<ul> + <li> Try to handle /usr/bin/sh instead of /bin/sh where necessary. + <li> Upgrade to HP/UX 10.x+ compiler, linker and dso options. + <li> Fixed mmap() test to avoid MMAP_FIXED ... it isn't available on HP + <li> Use -${MAKEFLAGS} in sub makes from makefiles. + <li> Fixed SCRIPT_SH/SHELL handling. +</ul> +<li> configure: Changes for DSO generation on AIX provided by + John Marquart <jomarqua@indiana.edu>. + +<li> configure, libtiff/Makefile.in: Modified to build DSOs properly + on Darwin thanks to Robert Krajewski (rpk@alum.mit.edu) and + Keisuke Fujii (fujiik@jlcuxf.kek.jp). + +<li> configure, libtiff/Makefile.in: applied OpenBSD patches as per bug 61. + +<li> Makefile.in: added DESTDIR support as per bug 60. + +<li> libtiff/tif_jpeg.c: Define HAVE_BOOLEAN on windows if RPCNDR.H + has been included. +<li> man/Makefile.in: add TIFFClientOpen link as per debian submitted + bug 66. +<li> libtiff/Makefile.in: Fixed @DSOSUB_VERSION to be @DSOSUF_VERSION@ + in two places. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + + +<UL> +<li> tif_fax3.c: keep rw_mode flag internal to fax3 state to remember + whether we are encoding or decoding. This is to ensure graceful + recovery if TIFFClientOpen() discovers an attempt to open a compressed + file for "r+" access, and subsequently close it, as it resets the + tif_mode flag to O_RDONLY in this case to avoid writes, confusing the + compressor's concept of whether it is in encode or decode mode. +<li> tif_luv.c/tiff.h/tiffio.h: + New version of TIFF LogLuv (SGILOG) modules contributed by Greg Ward + (greg@shutterfly.com). He writes: + +<ol> + <li> I improved the gamut-mapping function in tif_luv.c for imaginary + colors, because some images were being super-saturated on the input + side and this resulted in some strange color shifts in the output. + + <li> I added a psuedotag in tiff.h to control random dithering during + LogLuv encoding. This is turned off by default for 32-bit LogLuv and + on for 24-bit LogLuv output. Dithering improves the average color + accuracy over the image. + + <li> I added a #define for LOG_LUV_PUBLIC, which is enabled by default in + tiffio.h, to expose internal routines for converting between LogLuv and + XYZ coordinates. This is helpful for writing more efficient, + specialized conversion routines, especially for reading LogLuv files. +</ol> + +<li> libtiff/tif_dirinfo.c: don't declare tiffFieldInfo static on VMS. + +<li> Added TIFFTAG_COPYRIGHT support. +<li> tif_getimage.c: Added support for 16bit minisblack/miniswhite + images in RGBA interface. +<li> libtiff/tif_dirinfo.c: removed duplicate TIFFTAG_PHOTOSHOP as per + bug 44. +<li> libtiff/tif_dirwrite.c: Added support for TIFF_VARIABLE2 in the + case of writing TIFF_BYTE/TIFF_SBYTE fields as per bug 43. + +<li> libtiff/tif_dirinfo.c: Modified the TIFF_BYTE definition for + TIFFTAG_PHOTOSHOP to use a writecount of TIFF_VARIABLE2 (-3) to + force use of uint32 counts instead of short counts. + +<li> libtiff/tif_dirinfo.c: moved pixar and copyright flags to + ensure everything is in order. + +<li> Integrated experimental OJPEG support from Scott Marovich of HP. + +<li> libtiff/tif_open.c: Seek back to zero after failed read, + before writing header. + +<li> libtiff/tiff.h, libtiff/tif_fax3.c: added check for __LP64__ + when checking for 64 bit architectures as per bugzilla bug 67. +<li> libtiff/tif_getimage.c: Use memmove() instead of TIFFmemcpy() + in TIFFReadRGBATile() to avoid issues in cases of overlapping + buffers. See Bug 69 in Bugzilla. +<li> libtiff/tif_getimage.c: Don't complain for CMYK (separated) + images with more than four samples per pixel as per bug 73. + +<li> libtiff/tif_getimage.c: relax handling of contig case where +there are extra samples that are supposed to be ignored as per bug 75. This +should now work for 8bit greyscale or palletted images. + +<li> libtiff/tif_packbits.c: fixed memory overrun error as per bug 77. + +<li> libtiff/tif_getimage.c: Fixed problem with reading strips or +tiles that don't start on a tile boundary. Fix contributed by +Josep Vallverdu (from HP), and further described in bug 47. + +<li> libtif/tif_fax3.c: Removed #ifdef PURIFY logic, and modified to + always use the "safe" version, even if there is a very slight + cost in performance as per bug 54. +<li> libtiff/tif_lzw.c: added dummy LZWSetupEncode() to report an + error about LZW not being available. + +<li> libtiff/tif_dir.c: propagate failure to initialize compression + back from TIFFSetField() as an error status, so applications can + detect failure. + +<li> libtiff/tif_lzw.c: Avoid MS VC++ 5.0 optimization bug as per bug 78. + +<li> libtiff/tif_dirwrite.c: added TIFFRewriteDirectory() function. +Updated TIFFWriteDirectory man page to include TIFFRewriteDirectory. + +<li> libtiff/tiff.h: I have created COMPRESSION_CCITT_T4, + COMPRESSION_CCITT_T6, TIFFTAG_T4OPTIONS and TIFFTAG_T6OPTIONS aliases + in keeping with TIFF 6.0 standard in tiff.h as per bug 83. + +<li> Added PHOTOMETRIC_ITULAB as per bug 90. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> +<li> Brent Roman contributed updated tiffcp utility (and tiffcp.1) + with support for extracting subimages with the ,n syntax, and also + adding the -b bias removal flag. +<li> tiff2ps.c/tiff2ps.1: Substantial changes to tiff2ps by + Bruce A. Mallett, including a faster encoder, fixes for level + 2 PostScript, and support for the imagemask operator. +<li> fax2ps.c: Helge (libtiff at oldach.net) submitted fix +that corrects behaviour for non-Letter paper +sizes. (Bug 35) It fixes two problems: +<br> + Without scaling (-S) the fax is now centered on the page size specified + with -H and/or -W. Before, fax2ps was using an obscure and practially + useless algorithm to allocate the image relative to Letter sized paper + which sometime sled to useless whitespace on the paper, while at the + same time cutting of the faxes printable area at the opposite border. +<br> + + Second, scaling now preserves aspect ratio, which makes unusual faxes + (in particular short ones) print properly. + +<li> thumbnail.c: changed default output compression + to packbits from LZW since LZW isn't generally available. +<li> tiff2rgba.c: added -n flag to avoid emitting alpha component. Also added +a man page for tiff2rgba. + +<li> tiffcmp.c: Fixed multi samples per pixel support for ContigCompare +as per bug 53. +Updated bug section of tiffcmp.1 to note tiled file issues. + +<li> libtiff/tif_getimage.c: Fixed so that failure is properly + reported by gtTileContig, gtStripContig, gtTileSeparate and + gtStripSeparate as per bug 51. + + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="lzwkit"><B><FONT SIZE=+3>C</FONT>HANGES IN THE LZW COMPRESSION KIT:</B></A> +<UL> + <LI> Rewrote lzw patching process so that is required to enable full + LZW support is to drop the tif_lzw.c from the + libtiff-lzw-compression-kit over the one in the libtiff directory. + + <LI> Some changes were made to make recovery from failure to + initialize the LZW compressor more graceful. + + <LI> Note that as distributed libtiff support LZW decompression, but + not LZW compression. +</UL> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> +<UL> +<li> Fixed distribution to include contrib/addtiffo/tif_ovrcache.{c,h}. +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2004/11/26 14:37:20 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.6.0.html b/src/3rdparty/libtiff/html/v3.6.0.html new file mode 100644 index 0000000..888e547 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.6.0.html @@ -0,0 +1,434 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.6.0 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.6.0<BR> +<B>Previous Version</B>: <A HREF=v3.5.7.html>v3.5.7</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +<LI><A HREF="#lzwkit">Changes in the LZW compression kit</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<ul> + <li> New utility <a href=./man/raw2tiff.1.html>raw2tiff</a> +for converting raw rasters into TIFF files. + <li> Lots of new <a href=./man/tiff2ps.1.html>tiff2ps</a> options. + <li> Lots of new <a href=./man/fax2tiff.1.html>fax2tiff</a> options. + <li> Lots of bug fixes for LZW, JPEG and OJPEG compression. +</ul> + +<h3>Custom Tag Support</h3> + +The approach to extending libtiff with custom tags has changed radically. +Previously, all internally supported TIFF tags had a place in the +private TIFFDirectory structure within libtiff to hold the values (if read), +and a "field number" (ie. FIELD_SUBFILETYPE) used to identify that tag. +However, every time a new tag was added to the core, the size of the +TIFFDirectory structure would changing, breaking any dynamically linked +software that used the private data structures.<p> + +Also, any tag not recognised +by libtiff would not be read and accessable to applications without some +fairly complicated work on the applications part to pre-register the tags +as exemplified by the support for "Geo"TIFF tags by libgeotiff layered on +libtiff. <p> + +Amoung other things this approach required the extension code +to access the private libtiff structures ... which made the higher level +non-libtiff code be locked into a specific version of libtiff at compile time. +This caused no end of bug reports!<p> + +The new approach is for libtiff to read all tags from TIFF files. Those that +aren't recognised as "core tags" (those having an associated FIELD_ value, +and place for storage in the TIFFDirectory structure) are now read into a +dynamic list of extra tags (td_customValues in TIFFDirectory). When a new +tag code is encountered for the first time in a given TIFF file, a new +anonymous tag definition is created for the tag in the tag definition list. +The type, and some other metadata is worked out from the instance encountered. +These fields are known as "custom tags". <p> + +Custom tags can be set and fetched normally using TIFFSetField() and +TIFFGetField(), and appear pretty much like normal tags to application code. +However, they have no impact on internal libtiff processing (such as +compression). Some utilities, such as tiffcp will now copy these custom +tags to the new output files. <p> + +As well as the internal work with custom tags, new C API entry points +were added so that extension libraries, such as libgeotiff, could +define new tags more easily without accessing internal data structures. +Because tag handling of extension tags is done via the "custom fields" +mechanism as well, the definition provided externally mostly serves to provide +a meaningful name for the tag. + +The addition of "custom tags" and the altered approach to extending libtiff +with externally defined tags is the primary reason for the shift to the +3.6.x version number from 3.5.x.<p> + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> +<li> configure, config.site: Fix for large files (>2GiB) support. New +option in the config.site: LARGEFILE="yes". Should be enougth for the large +files I/O. + +<li> configure: Set -DPIXARLOG_SUPPORT option along with -DZIP_SUPPORT. + +<li> html/Makefile.in: Updated to use groffhtml for generating html pages +from man pages. + +<li> configure, libtiff/Makefile.in: Added SCO OpenServer 5.0.6 support +from John H. DuBois III. + +<li> libtiff/{Makefile.vc, libtiff.def}: Missed declarations added. + +<li> libtiff/Makefile.in, tools/Makefile.in: Shared library will not be +stripped when installing, utility binaries will do be stripped. As per bug 93. + +<li> man/Makefile.in: Patch DESTDIR handling as per bug 95. + +<li> configure: OpenBSD changes for Sparc64 and DSO version as per bug 96. + +<li> config.site/configure: added support for OJPEG=yes option to enable +OJPEG support from config.site. + +<li> config.guess, config.sub: Updated from ftp.gnu.org/pub/config. + +<li> configure: Modify CheckForBigEndian so it can work in a cross +compiled situation. + +<li> configure, libtiff/Makefile.in: Changes for building on MacOS 10.1 +as per bug 94. + +<li> html/Makefile.in: added missing images per bug 92. + +<li> port/Makefile.in: fixed clean target per bug 92. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + +<li> libtiff/tif_getimage.c: New function <A +HREF="./man/TIFFReadRGBAImage.3t.html">TIFFReadRGBAImageOriented()</A> +implemented to retrieve raster array with user-specified origin position. + +<li> libtiff/tif_fax3.c: Fix wrong line numbering. + +<li> libtiff/tif_dirread.c: Check field counter against number of fields. + +<li> Store a list of opened IFD to prevent directory looping. + +<li> libtiff/tif_jpeg.c: modified segment_height calculation to always +be a full height tile for tiled images. Also changed error to just +be a warning. + +<li> libtiff/tif_lzw.c: fixed so that decoder state isn't allocated till +LZWSetupDecode(). Needed to read LZW files in "r+" mode. + +<li> libtiff/tif_dir.c: fixed up the tif_postdecode settings responsible +for byte swapping complex image data. + +<li> libtiff/tif_open.c: Removed error if opening a compressed file +in update mode bug (198). + +<li> libtiff/tif_write.c: TIFFWriteCheck() now fails if the image is +a pre-existing compressed image. That is, image writing to pre-existing +compressed images is not allowed. + +<li> html/man/*.html: Web pages regenerated from man pages. + +<li> libtiff/tif_jpeg.c: Hack to ensure that "boolean" is defined properly +on Windows so as to avoid the structure size mismatch error from libjpeg +(bug 188). + +<li> libtiff/tiff.h: #ifdef USING_VISUALAGE around previous Visual Age +AIX porting hack as it screwed up gcc. (bug 39) + +<li> libtiff/tiff.h: added COMPRESSION_JP2000 (34712) for LEAD tools +custom compression. + +<li> libtiff/tif_dirread.c: Another fix for the fetching SBYTE arrays +by the TIFFFetchByteArray() function. (bug 52) + +<li> libtiff/tif_dirread.c: Expand v[2] to v[4] in TIFFFetchShortPair() +as per bug 196. + +<li> libtiff/tif_lzw.c: Additional consistency checking added in +LZWDecode() and LZWDecodeCompat() fixing bugs 190 and 100. + +<li> libtiff/tif_lzw.c: Added check for valid code lengths in LZWDecode() +and LZWDecodeCompat(). Fixes bug 115. + +<li> tif_getimage.c: Ensure that TIFFRGBAImageBegin() returns the +return code from the underlying pick function as per bug 177. + +<li> libtiff/{tif_jpeg.c,tif_strip.c,tif_print.c}: Hacked tif_jpeg.c to +fetch TIFFTAG_YCBCRSUBSAMPLING from the jpeg data stream if it isn't +present in the tiff tags as per bug 168. + +<li> libtiff/tif_jpeg.c: Fixed problem with setting of nrows in +JPEGDecode() as per bug 129. + +<li> libtiff/tif_read.c, libtiff/tif_write.c: TIFFReadScanline() and +TIFFWriteScanline() now set tif_row explicitly in case the codec has +fooled with the value as per bug 129. + +<li> libtiff/tif_ojpeg.c: Major upgrade from Scott. Details in bug 156. + +<li> libtiff/tif_open.c: Pointers to custom procedures +in TIFFClientOpen() are checked to be not NULL-pointers. + +<li> libtiff/tif_lzw.c: Assertions in LZWDecode and LZWDecodeCompat +replaced by warnings. Now libtiff should read corrupted LZW-compressed +files by skipping bad strips as per bug 100. + +<li> libtiff/: tif_dirwrite.c, tif_write.c, tiffio.h: +<a href=./man/TIFFWriteDirectory.3t.html>TIFFCheckpointDirectory()</a> +routine added as per bug 124. The +<a href=./man/TIFFWriteDirectory.3t.html>TIFFWriteDirectory</a> +man page discusses this new function as well as the related +<a href=./man/TIFFWriteDirectory.3t.html>TIFFRewriteDirectory()</a>. + +<li> libtiff/: tif_codec.c, tif_compress.c, tiffiop.h, tif_getimage.c: +Introduced +additional members tif->tif_decodestatus and tif->tif_encodestatus +for correct handling of unconfigured codecs (we should not try to read +data or to define data size without correct codecs). See bug 119. + +<li> tif_dirread.c: avoid div-by-zero if rowbytes is zero in chop func as +per bug 111. + +<li> libtiff/: tiff.h, tif_dir.c, tif_dir.h, tif_dirinfo.c, tif_dirread.c, +tif_dirwrite.c: Dwight Kelly added get/put code for new tag XMLPACKET as +defined in Adobe XMP Technote. Added missing INKSET tag value from TIFF 6.0 +spec INKSET_MULTIINK (=2). Added missing tags from Adobe TIFF technotes: +CLIPPATH, XCLIPPATHUNITS, YCLIPPATHUNITS, OPIIMAGEID, OPIPROXY and +INDEXED. Added PHOTOMETRIC tag value from TIFF technote 4 ICCLAB (=9). + +<li> libtiff/tif_getimage.c: Additional check for supported codecs added in +TIFFRGBAImageOK, TIFFReadRGBAImage, TIFFReadRGBAStrip and TIFFReadRGBATile now +use TIFFRGBAImageOK before reading a per bug 110. + +<li> libtiff/: tif_dir.c, tif_dir.h, tif_dirinfo.c, tif_dirread.c, +tif_dirwrite.c: Added routine +<a href=./man/TIFFDataWidth.3t.html>TIFFDataWidth</a> for determining +TIFFDataType sizes instead of working with tiffDataWidth array +directly as per bug 109. + +<li>libtiff/: tif_dirinfo.c, tif_dirwrite.c: Added possibility to +read broken TIFFs with LONG type used for TIFFTAG_COMPRESSION, +TIFFTAG_BITSPERSAMPLE, TIFFTAG_PHOTOMETRIC as per bug 99. + +<li> libtiff/{tiff.h,tif_fax3.c}: Add support for __arch64__ as per bug 94. + +<li> libtiff/tif_read.c: Fixed TIFFReadEncodedStrip() to fail if the +decodestrip function returns anything not greater than zero as per bug 97. + +<li> libtiff/tif_jpeg.c: fixed computation of segment_width for +tiles files to avoid error about it not matching the +cinfo.d.image_width values ("JPEGPreDecode: Improper JPEG strip/tile +size.") for ITIFF files. Apparently the problem was incorporated since +3.5.5, presumably during the OJPEG/JPEG work recently. + +<li> libtiff/tif_getimage.c: If DEFAULT_EXTRASAMPLE_AS_ALPHA is 1 +(defined in tiffconf.h - 1 by default) then the RGBA interface +will assume that a fourth extra sample is ASSOCALPHA if the +EXTRASAMPLE value isn't set for it. This changes the behaviour of +the library, but makes it work better with RGBA files produced by +lots of applications that don't mark the alpha values properly. +As per bugs 93 and 65. + +<li> libtiff/tif_jpeg.c: allow jpeg data stream sampling values to +override those from tiff directory. This makes this work with +ImageGear generated files. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + +<li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Added page size setting +when creating PS Level 2. + +<li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Fixed PS comment emitted when +FlateDecode is being used. + +<li> <a href=./man/tiffsplit.1.html>tiffsplit</a>: increased the maximum +number of pages that can be split. + +<li> <a href=./man/raw2tiff.1.html>raw2tiff</a>: Added option `-p' to +explicitly select color space of input image data. + +<li> <a href=./man/tiffmedian.1.html>tiffmedian</a>: Suppiort for large +(> 2GB) images. + +<li> <a href=./man/ppm2tiff.1.html>ppm2tiff</a>: Fixed possible endless loop. + +<li> <a href=./man/tiff2rgba.1.html>tiff2rgba</a>: Switched to use +<A HREF="./man/TIFFReadRGBAImage.3t.html">TIFFReadRGBAImageOriented()</A> +instead of <A HREF="./man/TIFFReadRGBAImage.3t.html">TIFFReadRGBAImage()</A>. + +<li> <a href=./man/tiffcmp.1.html>tiffcmp</a>: Fixed problem with unused data +comparing (bug 349). `-z' option now can be used to set the number of reported +different bytes. + +<li> <a href=./man/tiffcp.1.html>tiffcp</a>: Added possibility to specify +value -1 to -r option to get the entire image as one strip (bug 343). + +<li> <a href=./man/tiffcp.1.html>tiffcp</a>: Set the correct RowsPerStrip +and PageNumber values (bug 343). + +<li> <a href=./man/fax2tiff.1.html>fax2tiff</a>: Page numbering fixed (bug +341). + +<li> <a href=./man/ppm2tiff.1.html>ppm2tiff</a>: PPM header parser improved: +now able to skip comments. + +<li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Force deadzone printing when +EPS output specified (bug 325). + +<li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Add ability to generate +PS Level 3. It basically allows one to use the /flateDecode filter for ZIP +compressed TIFF images. Patch supplied by Tom Kacvinsky (bug 328). + +<li> <a href=./man/tiffcp.1.html>tiffcp</a>: Fixed problem with colorspace +conversion for JPEG encoded images (bugs 23 and 275) + +<li> <a href=./man/fax2tiff.1.html>fax2tiff</a>: Applied patch from +Julien Gaulmin. More switches for fax2tiff tool for better control +of input and output (bugs 272 and 293). + +<li> <a href=./man/raw2tiff.1.html>raw2tiff</a>: +New utility for turning raw raster images into TIFF files +written by Andrey Kiselev. + +<li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: +Sebastian Eken provided patches (bug 200) to add new these new +switches: + <ul> + <li> <b>-b #</b>: for a bottom margin of # inches + <li> <b>-c</b>: center image + <li> <b>-l #</b>: for a left margin of # inches + <li> <b>-r</b>: rotate the image by 180 degrees + </ul> + +Also, new features merged with code for shrinking/overlapping. + +<li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Don't emit BeginData/EndData +DSC comments since we are unable to properly include the amount to skip +as per bug 80. + +<li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Added workaround for some +software that may crash when last strip of image contains fewer number +of scanlines than specified by the `/Height' variable as per bug 164. + +<li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: Patch from John Williams to add new +functionality for tiff2ps utility splitting long images in several pages as +per bug 142. New switches: + <ul> + <li> <b>-H #</b>: split image if height is more than # inches + <li> <b>-L #</b>: overLap split images by # inches + </ul> + +<li> <a href=./man/tiff2ps.1.html>tiff2ps</a>: New commandline +switches to override resolution units obtained from the input file per bug 131: + <ul> + <li> <b>-x</b>: override resolution units as centimeters + <li> <b>-y</b>: override resolution units as inches + </ul> + +<li> <a href=./man/fax2tiff.1.html>fax2tiff</a>: Updated to reflect +latest changes in libtiff per bug 125. + +<li> tiff2ps: Division by zero fixed as per bug 88. + +<li> <a href=./man/tiffcp.1.html>tiffcp<a>: +Added support for 'Orientation' tag. + +<li> <a href=./man/tiffdump.1.html>tiffdump</a>: +include TIFFTAG_JPEGTABLES in tag list. + +<li> tiffset: fix bug in error reporting. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> +<UL> + +<li> Fixed distribution to include contrib/addtiffo/tif_ovrcache.{c,h}. +<li> libtiff/contrib/win95: renamed to contrib/win_dib. Added new +Tiffile.cpp example of converting TIFF files into a DIB on Win32 as per +bug 143. + +</UL> + +<!---------------------------------------------------------------------------> + +<A NAME="lzwkit"><B><FONT SIZE=+3>C</FONT>HANGES IN THE LZW COMPRESSION +KIT:</B></A> +<UL> + +<li> LZW compression kit synchronized with actual libtiff version. + +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2003/10/04 11:38:17 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.6.1.html b/src/3rdparty/libtiff/html/v3.6.1.html new file mode 100644 index 0000000..d106062 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.6.1.html @@ -0,0 +1,199 @@ +<HTML> +<HEAD> +<TITLE> +Changes in TIFF v3.6.1 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.6.1<BR> +<B>Previous Version</B>: <A HREF=v3.6.0.html>v3.6.0</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +<LI><A HREF="#lzwkit">Changes in the LZW compression kit</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<ul> + <li> New utility <a href="./man/tiff2pdf.1.html">tiff2pdf</a> + for converting TIFF images directly into PDF. + <li> New <a href="./man/TIFFcolor.3t.html">color conversion module</a>. + <li> Full support for Orientation tag in + <a href="./man/TIFFReadRGBAImage.3t.html">TIFFRGBAImage</a> interface. + <li> Many bugs fixed. +</ul> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + +<li> libtiff/makefile.vc, tools/makefile.vc: Support for IJG JPEG library. + +<li> Makefile.in: Add an absolute path to the test_pics.sh call. + +<li> Makefile.in: Add an absolute path to the test_pics.sh call. + +<li> libtiff/tiffcomp.h: #define _BSDTYPES_DEFINED when defining BSD typedefs. + +<li> configure, libtiff/{Makefile.in, mkversion.c}: Relative buildings fixed. + +<li> Makefile.in: Add an absolute path to the test_pics.sh call. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + +<li> libtiff/{tif_color.c, tif_getimage.c, tiffio.h}: Added support +for ReferenceBlackWhite tag handling when converted from YCbCr color space as +per bug 120. + +<li> libtiff/{tif_getimage.c, tif_aux.c}: Read WhitePoint tag from the +file and properly use it for CIE Lab 1976 to RGB transform. + +<li> libtiff/{tif_getimage.c, tiffio.h}: Finally resolved problems with +orientation handling. TIFFRGBAImage interface now properly supports all +possible orientations, i.e. images will be flipped both in horizontal and +vertical directions if required. 'Known bugs' section now removed from the +appropriate manual pages. + +<li> libtiff/tif_luv.c: Fixed bug in 48-bit to 24-bit conversion routine, +reported by Antonio Scuri. + +<li> libtiff/{tiffio.h, tif_codec.c}: Added new function +TIFFIsCODECConfigured(), suggested by Ross Finlayson. + +<li> libtiff/tif_ojpeg.c: TIFFVGetField() function now can properly extract +the fields from the OJPEG files. Patch supplied by Ross Finlayson. + +<li> libtiff/tif_dir.h: _TIFFFindOrRegisterdInfo declaration replaced +with _TIFFFindOrRegisterFieldInfo as reported by Ross Finlayson. + +<li> libtiff/tif_dirinfo.c: Implemented binary search in _TIFFMergeFieldInfo(). +Patch supplied by Ross Finlayson. + +<li> tif_dirread.c: do not mark all anonymously defined tags to be IGNOREd (as +it was done in 3.6.0). + +<li> libtiff/{tiff.h, tif_dirinfo.c}: Added support for IFD (13) datatype, +intruduced in "Adobe PageMaker TIFF Technical Notes". + +<li> libtiff/{tif_color.c, tif_getimage.c, tiffio.h}: New color space +conversion code: CIE L*a*b* 1976 images now supported by the TIFFRGBAImage +interface. YCbCr to RGB conversion code also moved there and now has +<a href="./man/TIFFcolor.3t.html">publicly available interface</a>. These +routines currently used in TIFFRGBAImage interface only and not supported in +other libtiff tools yet. So if you want, for example, to convert CIE Lab image +into PostScript file you should do it in two steps: chnge colorspace to RGB +using <a href="./man/tiff2rgba.1.html">tiff2rgba</a> utility abd then process +it with the <a href="./man/tiff2ps.1.html">tiff2ps</a>. + +<li> libtiff/tif_tile.c: Remove spurious use of "s" (sample) in the +planarconfig_contig case in TIFFComputeTile() as per bug 387 + +<li> libtiff/tiffiop.h: New macros: TIFFmax and TIFFmin. + +<li> libtiff/{tiffio.h, tif_strip.c}: Added TIFFRawStripSize() function +as suggested by Chris Hanson. + +<li> libtiff/{tif_lzw.c, tif_fax3.c}: Proper support for update mode +as per bug 424. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + +<li> <a href=./man/tiff2pdf.1.html>tiff2pdf</a>: New tool, written by +Ross Finlayson, to directly convert TIFF files to PDF. + +<li> <a href=./man/tiffgt.1.html>tiffgt</a>: Unmaintained and platform +dependent sgigt utility removed and replaced with the completely rewritten +portable <a href=./man/tiffgt.1.html>tiffgt</a> tool (depend on OpenGL and +GLUT). This tool will not build by default. + +<li> <a href=./man/ras2tiff.1.html>ras2tiff</a>: Properly determine +SUN Rasterfiles with the reverse byte order (it is reported by the magic +header field). Problem reported by Andreas Wiesmann. + +<li> <a href=./man/raw2tiff.1.html>raw2tiff</a>: Implemented image size +guessing using correlation coefficient calculation between two neighbour +lines. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> +<UL> + +<li> contrib/pds/{tif_pdsdirread.c, tif_pdsdirwrite.c}: Use TIFFDataWidth() +function insted of tiffDataWidth array. + +</UL> + +<!---------------------------------------------------------------------------> + +<A NAME="lzwkit"><B><FONT SIZE=+3>C</FONT>HANGES IN THE LZW COMPRESSION +KIT:</B></A> +<UL> + +<li> Proper support for update mode as per bug 424. + +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2003/12/24 22:14:15 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.7.0.html b/src/3rdparty/libtiff/html/v3.7.0.html new file mode 100644 index 0000000..413f2c6 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.7.0.html @@ -0,0 +1,144 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.7.0 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.7.0<BR> +<B>Previous Version</B>: <A HREF=v3.7.0beta2.html>v3.7.0beta2</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +<LI><A HREF="#lzwkit">Changes in the LZW compression kit</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<UL> + + <li> Several bugs found after 3.7.0beta2 release were fixed. + +</UL> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <li> ltmain.sh: Fix for MinGW compilation. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + + <li> libtiff/{tif_dirread.c, tif_jpeg.c, tif_luv.c, tif_ojpeg.c, + tif_pixarlog.c, tif_write.c}: Handle the zero strip/tile sizes + properly (Dmitry V. Levin, Marcus Meissner). + + <li> libtiff/tif_dirinfo.c: Type of the TIFFTAG_SUBIFD field changed + to TIFF_IFD. + + <li> Preliminary support for BigTIFF files: now libtiff can + recognize and reject to open such images. ;-) + + <li> libtiff/tif_dir.c: Initialize td_tilewidth and td_tilelength fields + of the TIFFDirectory structure with the 0 instead of -1 to avoid + confusing integer overflows in TIFFTileRowSize() for striped images. + + <li> libtiff/tif_dir.c: Initialize td_tilewidth and td_tilelength fields + of the TIFFDirectory structure with the 0 instead of -1 to avoid + confusing integer overflows in TIFFTileRowSize() for striped images. + + <li> libtiff/tif_dirinfo.c: Fix bug with tif_foundfield and reallocation + of tif_fieldinfo as per bug + <A HREF="http://bugzilla.remotesensing.org/show_bug.cgi?id=630"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=630</A> + + <li> libtiff/tif_compress.c: Improved error reporting in + TIFFGetConfiguredCODECs() (Dmitry V. Levin). + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <li> tiffcmp.c (leof): Renamed from 'eof' in order to avoid + conflict noticed under MinGW. + + <li> tiff2pdf.c: Fixed TransferFunction tag handling reported + by Ross A. Finlayson. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> + + <li> No changes. + +</UL> + +<!---------------------------------------------------------------------------> + +<A NAME="lzwkit"><B><FONT SIZE=+3>C</FONT>HANGES IN THE LZW COMPRESSION +KIT:</B></A> +<UL> + + <li> This one is not longer needed. + +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2004/12/20 19:31:44 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.7.0alpha.html b/src/3rdparty/libtiff/html/v3.7.0alpha.html new file mode 100644 index 0000000..95c633c --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.7.0alpha.html @@ -0,0 +1,249 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.7.0alpha +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.7.0alpha<BR> +<B>Previous Version</B>: <A HREF=v3.6.1.html>v3.6.1</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +<LI><A HREF="#lzwkit">Changes in the LZW compression kit</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<ul> + <li> Significant changes in software configuration: we are switched + to GNU autotools now. + + <li> tiffset: tiffset now can set any libtiff supported tags. Tags + can be supplied by the mnemonic name or number. +</ul> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <li> Get rid of the old configuration system and switch to + GNU autotools. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + <li> libtiff/tif_ojpeg.c: Fixed problem with duplicated SOI and SOF + markers as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=581" + http://bugzilla.remotesensing.org/show_bug.cgi?id=581</a>. + + <li> libtiff/{tif_open.c, tiffio.h}: New function added: + TIFFIsBigEndian(). Function returns nonzero if given was file written + in big-endian order. + + <li> libtiff/tif_print.c: added (untested) support for printing + SSHORT, SLONG and SRATIONAL fields. + + <li> libtiff/tif_fax3.c: Avoid reading CCITT compression options + if compression type mismatches. See + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=565"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=565</a>. + + <li> libtiff/tif_strip.c: Never return 0 from the TIFFNumberOfStrips(). + + <li> libtiff/tif_dirread.c: Workaround for broken TIFF writers which + store single SampleFormat value for multisampled images. See + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=562"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=562</a>. + + <li> libtiff/tif_write.c: Allow in-place updating of the compressed + images (don't work properly with all codecs). For details see GDAL bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=534"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=534</a>. + + <li> libtiff/tif_jpeg.c: Workaround for wrong sampling factors used + in the Intergarph JPEG compressed TIFF images as per bug: + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=532"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=532</a>. + + <li> libtiff/tif_open.c: Use dummy mmap/munmap functions in + TIFFClientOpen() when the appropriate client functions was not + supplied by user. + + <li> libtiff/tif_dirread.c: Fixed problem with handling TIFF_UNDEFINED + tag type in TIFFFetchNormalTag() as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=508" + http://bugzilla.remotesensing.org/show_bug.cgi?id=508</a>. + + <li> libtiff/tif_codec.c: Fixed typo in TIFFInitPackBits name as per: + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=494"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=494</a>. + + <li> libtiff/tif_fax3.c: Fixed problem, introdiced in 3.6.1 release, + with the CCITT encoding modes as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=483"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=483</a>. + We need more work on fax codec to support update mode. + + <li> libtiff/tiff.h: Fixed tag definitions for TIFFTAG_YCLIPPATHUNITS + and TIFFTAG_INDEXED as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=475"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=475</a>. + + <li> libtiff/{tif_win32.c, tif_unix.c}: Check whether the pointer is + NULL before proceeding further as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=474"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=474</a>. + Check results, returned by the TIFFFdOpen() before returning and close + file if TIFFFdOpen() failed as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=468"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=468</a>. + + <li> libtiff/{libtiff.def, tif_close.c, tiffio.h, tif_open.c}: + Separate TIFFCleanup() from the TIFFClose() in order to fix the bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=468"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=468</a>. + + <li> libtiff/tif_dirwrite.c: Fixed handling of writable ASCII tags + that are field_passcount=TRUE properly. Arguably anonymous custom + tags should be declared as passcount=FALSE, but I don't want to change + that without a careful review. + + <li> libtiff/tif_write.c: Fixed reporting size of the buffer in case + of stripped image in TIFFWriteBufferSetup(). As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=460"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=460</a>. + + <li> libtiff/tif_dir.c: Incomplete cleanup in TIFFFreeDirectory(), + patch from Gerben Koopmans. + + <li> libtiff/tif_dirread.c: Check field_passcount value before setting + the value of undefined type, patch from Gerben Koopmans. + + <li> libtiff/{tiff.h, tif_fax3.c}:Fixes for AMD 64 platform as + suggested by Jeremy C. Reed. + + <li> libtiff/tif_win32.c: Fixed problem with _TIFFrealloc() when + the NULL pointer passed. Patch supplied by Larry Grill. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <li> tiffset: tiffset now can set any libtiff supported tags. Tags + can be supplied by the mnemonic name or number. + + <li> ycbcr.c: fixed main() declaration as per: + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=513"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=513</a>. + + <li> <a href=./man/tiffsplit.1.html>tiffsplit</a>: Don't forget + to copy Photometric Interpretation tag. + + <li> <a href=./man/tiffsplit.1.html>tiffsplit</a>: Fixed problem with + unproperly written multibyte files. Now output files will be written + using the same byte order flag as in the input image. See + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=574" + http://bugzilla.remotesensing.org/show_bug.cgi?id=574</a>. + + <li> <a href=./man/tiffsplit.1.html>tiffsplit</a>: Copy JPEGTables + tag contents for JPEG compressed images. Reported by Artem Mirolubov. + + <li> <a href=./man/tiffcp.1.html>tiffcp</a>: Close output file + on normal exit. + + <li> <a href=./man/tiffcp.1.html>tiffcp</a>: Don't emit warnings + when Orientation tag does not present in the input image. + + <li> <a href=./man/tiffcp.1.html>tiffcp</a>: Properly set + Photometric Interpretation in case of JPEG compression of grayscale + images. + + <li> <a href=./man/tiffcp.1.html>tiffcp</a>: Fixed problem with wrong + interpretation of the InkNames tag as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=466"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=466</a>. + Memory leak fixed. + + <li> <a href=./man/tiffcp.1.html>tiffcp</a>: Fixed problem with + wrong Photometric setting for non-RGB images. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> + + <li> Outdated stuff removed. + + <li> Almost all programs are sinchronized with the current libtiff + and should compile without problems. + +</UL> + +<!---------------------------------------------------------------------------> + +<A NAME="lzwkit"><B><FONT SIZE=+3>C</FONT>HANGES IN THE LZW COMPRESSION +KIT:</B></A> +<UL> + +<li> No changes. + +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2006/03/18 17:12:47 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.7.0beta.html b/src/3rdparty/libtiff/html/v3.7.0beta.html new file mode 100644 index 0000000..7d7c868 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.7.0beta.html @@ -0,0 +1,162 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.7.0beta +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.7.0beta<BR> +<B>Previous Version</B>: <A HREF=v3.7.0alpha.html>v3.7.0alpha</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +<LI><A HREF="#lzwkit">Changes in the LZW compression kit</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<ul> + <li> LZW compression enabled by default. You don't need the separate + compression kit anymore. + + <li> bmp2tiff: Added new utility to convert Windows BMP files + into TIFFs. + + <li> The first attempt to implement a test suite. +</ul> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <li> Many portability fixes in the new autotooled build suite. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + <li> libtiff/{tif_luv.c, tif_next.c, tif_thunder.c}: Several buffer + overruns fixed, as noted by Chris Evans. + + <li> BSD data types (u_char, u_short, u_int, u_long) is no longer + used internally in the libtiff. Should result in simpler configuration + and better portability. + + <li> libtiff/tiff.h: Fix column tagging. Reference current Adobe XMP + specification. Reference libtiff bug tracking system to submit + private tag additions. + + <li> libtiff/tif_dirread.c: Don't reject to read tags of the + SamplesPerPixel size when the tag count is greater than number of + samples as per bug + <A HREF="http://bugzilla.remotesensing.org/show_bug.cgi?id=576"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=576</A>. + + <li> libtiff/{tiffio.h, tif_open.c}: Applied patches from + Joris Van Damme to avoid requirement for tiffiop.h inclusion in + some applications. Look for details here: + <A HREF="http://www.asmail.be/msg0054799560.html"> + http://www.asmail.be/msg0054799560.html</A>. + + <li> libtiff/{tiffiop.h, tif_dirinfo.c}: Fixed problem with the static + variable as per bug + <A HREF="http://bugzilla.remotesensing.org/show_bug.cgi?id=593"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=593</A>. + + <li> libtiff/tif_lzw.c: LZW compression code is merged back from the + separate package. All libtiff tools are updated to not advertise an + abcence of LZW support. + + <li> libtiff/tif_dir.c: Call TIFFError() instead of producing warnings + when setting custom tags by value. Reported by Eric Fieleke. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <li> tiff2ps: Avoid zero division in setupPageState() function; + properly initialize array in PSDataBW(). + + <li> tiff2pdf: Multiple bugfixes. + + <li> ras2tiff: Fixed issue with missed big-endian checks as per bug + </A HREF="http://bugzilla.remotesensing.org/show_bug.cgi?id=586"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=586</A>. + + <li> bmp2tiff: Added new utility to convert Windows BMP files + into TIFFs. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> + + <li> No changes. + +</UL> + +<!---------------------------------------------------------------------------> + +<A NAME="lzwkit"><B><FONT SIZE=+3>C</FONT>HANGES IN THE LZW COMPRESSION +KIT:</B></A> +<UL> + + <li> This one is not longer needed. + +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2006/03/18 17:12:47 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.7.0beta2.html b/src/3rdparty/libtiff/html/v3.7.0beta2.html new file mode 100644 index 0000000..67dd8da --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.7.0beta2.html @@ -0,0 +1,131 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.7.0beta2 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.7.0beta2<BR> +<B>Previous Version</B>: <A HREF=v3.7.0beta.html>v3.7.0beta</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +<LI><A HREF="#lzwkit">Changes in the LZW compression kit</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<UL> + + <li> The code has been reviewed by Dmitry Levin: added checks + for values, returned by the space allocation functions, fixed + problems with the possible integer overflows. + +</UL> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <li> Several fixes in the test suite. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + + <li> Preliminary support for BigTIFF files: now libtiff can + recognize and reject to open such images. ;-) + + <li> libtiff/tif_dirinfo.c: changed type of XMLPacket (tag 700) to + TIFFTAG_BYTE instead of TIFFTAG_UNDEFINED to comply with the info + in the Adobe XMP Specification. + + <li> Added many checks for integer overflow and for successful space + allocations in the different parts of library. Code review + completed by Dmitry V. Levin. + + <li> libtiff/{tiffio.h, tif_compress.c}: Added + TIFFGetConfiguredCODECs()function to get the list of configured codecs. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <li> tiff2bw: Write ImageWidth/Height tags to output file, as + noted by Gennady Khokhorin. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> + + <li> No changes. + +</UL> + +<!---------------------------------------------------------------------------> + +<A NAME="lzwkit"><B><FONT SIZE=+3>C</FONT>HANGES IN THE LZW COMPRESSION +KIT:</B></A> +<UL> + + <li> This one is not longer needed. + +</UL> + +<A HREF="index.html"><IMG SRC="images/back.gif"></A> TIFF home page.<BR> + +<HR> + +Last updated $Date: 2006/03/18 17:12:47 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.7.1.html b/src/3rdparty/libtiff/html/v3.7.1.html new file mode 100644 index 0000000..b888792 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.7.1.html @@ -0,0 +1,233 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.7.1 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.7.1<BR> +<B>Previous Version</B>: <A HREF=v3.7.0.html>v3.7.0</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<UL> + + <li> This is mostly bugfix release. Most important fix is the one + related to wrong custom tag read/write code. + +</UL> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + + <li> autogen.sh: aclocal and autoheader should be executed after + libtoolize. Also add '-I .' to aclocal invocation to check + current directory for macros. + + <li> nmake.opt: Link with the user32.lib in windowed mode. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=697"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=697</a> + + <li> nmake.opt, makefile.vc: make it easier to rename the libtiff DLL. + + <li> configure, configure.ac: Added --enable-rpath option to embed + linker paths into library binary. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + + <li> tiff.h: Revert back libtiff data type definitions as per + bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=687"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=687</a> + + <li> tif_dirread.c: Do not forget about TIFF_VARIABLE2 when + checking for tag count in TIFFReadDirectory() function. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=713"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=713</a> + + <li> tif_getimage.c: Support for multiple-alpha-channelled + RGB-images as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=718"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=718</a> + + <li> tif_getimage.c: #define A1 bracketing for clean build on + SunPro compiler. + + <li> tif_dirwrite.c: Always write TIFFTAG_SUBIFD using LONG type + as per bugs + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=703"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=703</a> and + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=704"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=704</a>. + + <li> tif_win32.c: Use char* strings instead of TCHAR in windowed + mode as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=697"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=697</a> + + <li> tif_dir.c, tif_dirread.c: Remove TIFFReassignTagToIgnore() + call from the TIFFReadDirectory() function. TIFFReassignTagToIgnore + must be removed in the future, as it was never used properly. As per + bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=692"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=692</a> + + <li> tif_jpeg.c: Added a work-around in order to allow + compilation with the heavily modified version of libjpeg delivered + with Cygwin. + + <li> tif_dir.c: Properly handle tags, which have the uint32 + counts. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=693"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=693</a> + + <li> tif_unix.c: Make UNIX module compilable (and usable) + on Windows. + + <li> tiff.h: Added Adobe DNG tags. + + <li> tif_aux.c: Set the appropriate ReferenceBlackWhite array for + YCbCr image which lacks that tag (noted by Hans Petter Selasky). + + <li> tif_color.c: Division by zero fixed (Hans Petter Selasky). + + <li> tif_stream.cxx, tiffio.h: Added C++ stream interface + contributed by Edward Lam (see + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=654"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=654</a> + for details). Those who want to use C++ streams should + #include <tiffio.hxx>. + + <li> tif_open.c: Removed close() in TIFFClientOpen() if file + is bad. This is the callers responsibility. + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=651"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=651</a> + + <li> tiffio.h, tif_win32.c, libtiff.def}: Added TIFFOpenW() + function to work with the double byte strings (used to represent + filenames in some locales). As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=625"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=625</a> + + <li> tif_dirread.c: Fixed problem when fetching BitsPerSample and + Compression tags of type LONG from broken TIFFS as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=662"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=662</a> + + <li> tif_dirinfo.c: Fixed definition for TIFFTAG_RICHTIFFIPTC, + the writecount should have uint32 type. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=662"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=662</a> + + <li> tif_write.c: Fixed wrong if() statement in + TIFFAppendToStrip() function as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=660"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=660</a> + + <li> tif_dirinfo.c: Change definition for TIFFTAG_EXTRASAMPLES + field. The caller should supply a count when setting this field. As + per bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=648"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=648</a>. + + <li> tif_jpeg.c, tif_ojpeg.c: TIFFTAG_JPEGTABLES should have + uint32 count. Use this type everywhere. + + <li> tif_next.c: avoid use of u_long and u_char types. + + <li> tif_fax3.c: Fixed case with the wrong decode routines + choosing when the incorrect Group4Options tag set. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=323"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=323</a> + + <li> tif_dirwrite.c: Fixed problem with passing count variable of + wrong type when writing the TIFF_BYTE/TIFF_SBYTE tags in + TIFFWriteNormalTag(). + + <li> tif_compress.c: Zero division problem fixed (Vladimir Nadvornik, + Dmitry V. Levin). + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + + <li> fax2ps.c: Be able to extract the first page (#0). As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=690"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=690</a> + + <li> tiff2ps.c: Fixed wrong variable data type when read Position + tags (Tristan Hill). + + <li> tiff2ps.c: Fixed wrong variable data type when read Resolution + tags (Peter Fales). + + <li> tiffset.c: Check the malloc return value (Dmitry V. Levin). + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> + + <li> No changes. + +</UL> + +Last updated $Date: 2004/12/20 19:31:44 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.7.2.html b/src/3rdparty/libtiff/html/v3.7.2.html new file mode 100644 index 0000000..6cb6f7c --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.7.2.html @@ -0,0 +1,222 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.7.2 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.7.2<BR> +<B>Previous Version</B>: <A HREF=v3.7.1.html>v3.7.1</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<UL> + + <li> Maintainance release. Many bugfixes in the build environment + and compatibility improvements. + +</UL> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <li> configure.ac: Use -rpath option instead of -R as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=732"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=732</a> + + <li> tif_stream.cxx: Fixes for C++ stream interface from + Michael Rinne and Edward Lam. + + <li> configure.ac: Make the documentation directory location + configurable via the --with-docdir option (as suggested by + Jeremy C. Reed). + + <li> Place the C++ stream API in the separate library called + libtiffxx to avoid unneeded dependencies. Probably there will be + more C++ API in the future. As per bugs + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=733"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=733</a> + and <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=730"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=730</a> + + <li> configure, configure.ac: Replace --disable-c++ with the + --disable-cxx option as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=730"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=730</a>. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + + <li> Applied patch from Lee Howard to support a new tag TIFFTAG_FAXDCS + (34911) used in HylaFax software. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=771"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=771</a> + + <li> tif_open.c: Remove unnesessary TIFFSeekFile() call as per + bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=756"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=756</a> + + <li> tiff.h: Changed the int8 definition to be always signed char + as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=727"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=727</a> + + <li> tiffio.h: Move TIFFOpenW() function into the extern "C"{} + block as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=763"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=763</a> + + <li> tif_dirread.c: Estimate strip size in case of wrong or + suspicious values in the tags. As per bugs + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=705"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=705</a> + and <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=320"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=320</a> + + <li> tif_color.c: Use double as the second argument of pow() + function in TIFFCIELabToRGBInit(). As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=741"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=741</a> + + <li> tif_pixarlog.c: Avoid warnings when converting float to + integer as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=740"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=740</a> + + <li> tif_getimage.c: Always fill the error message buffer in + TIFFRGBAImageBegin() as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=739"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=739</a> + + <li> tif_jpeg.c: Added ability to read/write the fax specific + TIFFTAG_FAXRECVPARAMS, TIFFTAG_FAXSUBADDRESS and TIFFTAG_FAXRECVTIME + tags as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=736"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=736</a> + + <li> tif_win32.c: Fixed message formatting in functions + Win32WarningHandler() and Win32ErrorHandler() as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=735"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=735</a> + + <li> tiffio.h: Move the color conversion routines in the 'extern + "C"' section as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=727"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=727</a> + + <li> tiff.h: Restore back the workaround for AIX Visual Age C + compiler to avoid double definition of BSD types as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=39"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=39</a> + + <li> tif_getimage.c: More fixes for multiple-alpha-channelled + RGB-images as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=713"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=713</a> + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + + <li> tiffcmp.c: Added ability to compare the 32-bit integer and + floating point data; complain on unsupported bit depths. + + <li> tiffcmp.c: Use properly sized buffer in short arrays comparison + as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=785"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=785</a> + + <li> fax2ps.c: Replace insecure mktemp() function with the + tmpfile() as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=786"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=786</a> + + <li> tiffgt.c: Fix problem on big-endian CPUs so that images + display more correctly. Images display brighter than they should + on a Sun workstation. + + <li> tiff2ps.c: Fixed problem with page sizes as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=742"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=742</a> + + <li> tiff2ps.c: Interpret the -w and -h options independently. As + per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=689"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=689</a> + + <li> tiffdump.c: Fixed problem when read broken TIFFs with the + wrong tag counts (Dmitry V. Levin, Martin Pitt). + + <li> tiffset.c: Convert character option to integer value as per + bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=725"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=725</a>. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> + + <li> No changes. + +</UL> + +Last updated $Date: 2005/03/15 15:17:44 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.7.3.html b/src/3rdparty/libtiff/html/v3.7.3.html new file mode 100644 index 0000000..d698451 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.7.3.html @@ -0,0 +1,230 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.7.3 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.7.3<BR> +<B>Previous Version</B>: <A HREF=v3.7.2.html>v3.7.2</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<UL> + <li> Replace runtime endianess check with the compile time one. + + <li> Added support for the new predictor type (floating point + predictor), defined at the TIFF Technical Note 3. + + <li> Added Support for custom tags, passed by value. + Added support for all DNG tags. +</UL> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <li> Do not use empty -R option when linking with --enable-rpath. + + <li> Added workaround for OpenBSD/MirOS soname problem as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=838"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=838</a> + + <li> Fixed parallel compilation of the libtiff and + libtiffxx libraries as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=826"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=826</a> + + <li> configure.ac, libtiff/Makefile.am: Use libtool machinery to pass + rpath option. + + <li> make.opt: Build with Win32 CRT library by default. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + <li> tiffiop.h, tif_open.c: Added open option 'h' to avoid reading + the first IFD when needed. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=875"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=875</a> + + <li> tiff.h: Use correct int size on Sparc 64bit/Sun compiler + platform. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=855"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=855</a> + + <li> tif_dirinfo.c: Added support for ClipPath, XClipPathUnits + and YClipPathUnits tags. + + <li> tif_dirinfo.c, tif_dir.h, tif_dir.c, tif_print.c: Make + DocumentName, Artist, HostComputer, ImageDescription, Make, Model, + Copyright, DateTime, PageName, TextureFormat, TextureWrapModes and + TargetPrinter tags custom. + + <li> tif_jpeg.c: Cleanup the codec state depending on TIFF_CODERSETUP + flag (to fix memory leaks). + + <li> tif_dirwrite.c: Use tdir_count when calling + TIFFCvtNativeToIEEEDouble() in the TIFFWriteDoubleArray() function as + per bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=845"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=845</a> + + <li> tif_dirinfo.c, tif_print.c: TIFFFetchByteArray() returns + uint16 array when fetching the BYTE and SBYTE fields, so we should + consider result as pointer to uint16 array and not as array of chars. + As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=831"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=831</a> + + <li> tif_dir.c: More efficient custom tags retrieval as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=830"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=830</a> + + <li> tif_win32.c: Use FILE_SHARE_READ | FILE_SHARE_WRITE share + mode in CreateFile() call as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=829"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=829</a> + + <li> tif_jpeg.c: Substantial fix for addtiffo problems with + JPEG encoded TIFF files. Pre-allocate lots of space for jpegtables + in directory. + + <li> tif_dirread.c: Changed the code that computes + stripbytecount[0] if it appears bogus to ignore if stripoffset[0] is + zero. This is a common case with GDAL indicating a "null" tile/strip. + + <li> tif_jpeg.c: added LIB_JPEG_MK1 support in JPEGDecodeRaw(). + + <li> tif_dirread.c: Ensure that broken files with too many + values in PerSampleShorts, TIFFFetchPerSampleLongs and + TIFFFetchPerSampleAnys work ok instead of crashing. + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=843"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=843</a> + + <li> tif_predict.h, tif_predict.c: Added ability to decode and encode + floating point predictor, as per TIFF Technical Note 3. + See http://chriscox.org/TIFF_TN3_Draft2.pdf for details. + + <li> tiffio.h, tiffiop.h, tif_dir.c, tif_read.c, tif_swab.c: + Added _TIFFSwab24BitData() and TIFFSwabArrayOfLong() functions used to + swap 24-bit floating point values. + + <li> tiff.h: Added predictor constants. + + <li> tiffiop.h, tif_dir.c: Use uint32 type for appropriate values + in _TIFFVSetField() function. Inspired by the bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=816"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=816</a> + + <li> tif_open.c: Do not read header in case the output file should + be truncated (Ron). + + <li> tif_dirinfo.c, tif_config.h.vc: Use lfind() instead of bsearch() + in _TIFFFindFieldInfoByName() function (Ron). + + <li> tif_dir.c, tif_print.c: Properly handle all data types in custom + tags. + + <li> dirinfo.c: Added DNG tags. + + <li> tiff.h: Added missed DNG tag (LensInfo); added DNG 1.1.0.0 tags. + + <li> tif_dir.c, tif_print.c: Added Support for custom tags, passed + by value. + + <li> tiff.h, tif_dirinfo.c, tiffiop.h: Added EXIF related tags. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <li> tiff2pdf.c: Print two characters per loop in the + t2p_write_pdf_trailer(). As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=594"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=594</a> + + <li> tiffgt.c: Use MacOS X OpenGL framework when appropriate. As + per bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=844"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=844</a> + + <li> ppm2tiff.c: Fixed format string when read PPM file header with + the fscanf() function. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=861"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=861</a> + + <li> tiffsplit.c: Check for JPEGTables tag presence before copying. + + <li> tiff2pdfr.c: Calculate the tile width properly; added new + option '-b' to use interpolation in output PDF files (Bruno Ledoux). + + <li> tiffdither.c: Copy the PhotometricInterpretation tag from the + input file. + + <li> tif2pdf.c: Fixed problem with alpha channel handling as per + bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=794"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=794</a>. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> + + <li> addtiffo/{tif_overview.c, tif_ovrcache.c, tif_ovrcache.h}: + Make overviews working for contiguous images. + +</UL> + +Last updated $Date: 2006/01/04 22:04:46 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.7.4.html b/src/3rdparty/libtiff/html/v3.7.4.html new file mode 100644 index 0000000..9437320 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.7.4.html @@ -0,0 +1,133 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.7.4 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.7.4<BR> +<B>Previous Version</B>: <A HREF=v3.7.3.html>v3.7.3</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<UL> + <li> Fixed important bug in custom tags handling code.. +</UL> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <li> Applied patch from Patrick Welche (all scripts moved in the + 'config' and 'm4' directories). + + <li> SConstruct, libtiff/SConstruct: Added the first very preliminary + support for SCons software building tool (http://www.scons.org/). + This is experimental infrastructure and it will exist along with the + autotools stuff. + + <li> port/lfind.c: Added lfind() replacement module. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + <li> tif_dir.c: When prefreeing tv->value in TIFFSetFieldV + also set it to NULL to avoid double free when re-setting custom + string fields as per: + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=922"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=922</a> + + <li> tif_dir.c: Fixed up support for swapping "double complex" + values (128 bits as 2 64 bits doubles). GDAL gcore tests now + pass on bigendian (macosx) system. + + <li> libtiff/{tif_dirread.c, tif_dirinfo.c}: Do not upcast BYTEs to + SHORTs in the TIFFFetchByteArray(). Remove TIFFFetchExtraSamples() + function, use TIFFFetchNormalTag() instead as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=831"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=831</a> + + Remove TIFFFetchExtraSamples() function, use TIFFFetchNormalTag() + instead. + + <li> tif_print.c: Fixed printing of the BYTE and SBYTE arrays. + + <li> tif_write.c: Do not check the PlanarConfiguration field in + the TIFFWriteCheck() function in case of single band images (as per + TIFF spec). + + <li> libtiff/{tif_dir.c, tif_dir.h, tif_dirinfo.c, tif_print.c}: + Make FieldOfViewCotangent, MatrixWorldToScreen, MatrixWorldToCamera, + ImageFullWidth, ImageFullLength and PrimaryChromaticities tags custom. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <li> tiffcp.c: Fixed WhitePoint tag copying. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> + <li> tiffdump.c: Added support for TIFF_IFD datatype. + + <li> addtiffo/{tif_overview.c, tif_ovrcache.c, tif_ovrcache.h}: + Make overviews working for contiguous images. + +</UL> + +Last updated $Date: 2005/11/03 14:18:43 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.8.0.html b/src/3rdparty/libtiff/html/v3.8.0.html new file mode 100644 index 0000000..914dcb0 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.8.0.html @@ -0,0 +1,199 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.8.0 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.8.0<BR> +<B>Previous Version</B>: <A HREF=v3.7.4.html>v3.7.4</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<UL> + <li> Read-only support for custom directories (e.g. EXIF directory). + + <li> Preliminary support for MS MDI format. +</UL> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <li> Make the default strip size configurable via the + --with-default-strip-size and STRIP_SIZE_DEFAULT options. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + <li> tiffio.h: Added VC_EXTRALEAN definition before including + windows.h, to reduce the compile time. + + <li> tif_jpeg.c: Improve compilation under MinGW. + + <li> {tif_aux.c, tif_dir.c, tif_dir.h, tif_dirwrite.c, + tif_print.c, tif_getimage.c}: Make InkSet, NumberOfInks, DotRange and + StoNits tags custom. + + <li> {tif_aux.c, tif_dir.c, tif_dir.h, tif_print.c}: Make + WhitePoint tag custom. + + <li> tiffio.h: fixed typo that potentially resulted in + redefininition of USE_WIN32_FILEIO + + <li> {tif_dir.c, tif_dir.h, tif_print.c}: Make RichTIFFIPTC, + Photoshop and ICCProfile tags custom. + + <li> libtiff/*, contrib/*: Added 'dual-mode' error handling, enabling + newer code to get context indicator in error handler and still + remain compatible with older code: Done TIFFError calls everywhere + except in tools. + + <li> tiffinfo.c: Print EXIF directory contents if exist. + + <li> {tif_dirinfo.c, tif_dirread.c, tif_dir.h, tif_dir.c}: + Custom directory read-only support. + + <li> {tif_aux.c, tif_dirinfo.c, tif_dirread.c, tif_dir.h, + tif_dir.c, tif_print.c}: Make YCbCrCoefficients and ReferenceBlackWhite + tags custom. + + <li> tif_dirread.c: One more workaround for broken StripByteCounts + tag. Handle the case when StripByteCounts array filled with + completely wrong values. + + <li> tif_dirinfo.c: Release file descriptor in case of failure + in the TIFFOpenW() function as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1003"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1003</a> + + <li> tif_dirinfo.c: Correctly yse bsearch() and lfind() + functions as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1008"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1008</a> + + <li> tif_open.c, tiff.h, tiffdump.c: Incorporate preliminary support + for MS MDI format. + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1002"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1002</a> + + <li> libtiff.def, tiffiop.h, tiffio.h: Made TIFFFreeDirectory + public. + + <li> /tif_dirinfo.c: Make XResolution, YResolution and + ResolutionUnit tags modifiable during write process. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=977"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=977</a> + + <li> if_dirread.c: Don't try and split single strips into "0" strips + in ChopUpSingleUncompressedStrip. This happens in some degenerate + cases (like 1x1 files with stripbytecounts==0 (gtsmall.jp2 embed tiff) + + <li> tif_fax3.c: changed 'at scanline ...' style warning/errors + with incorrect use of tif_row, to 'at line ... of + strip/tile ...' style. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <li> tiffcp.c: Added many error reporting messages; fixed integer + overflow as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=789"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=789</a> + + <li> tiffcp.c: Return non-zero status when reading fails. + + <li> fax2tiff.c: Properly calculate sizes of temporary arrays + as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=943"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=943</a> + + <li> fax2tiff.c: Added option '-r' to set RowsPerStrip parameter + as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=944"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=944</a> + + <li> tiffdump.c: Fixed typeshift and typemask arrays initialization + problem as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=946"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=946</a> + + <li> bmp2tiff.c: Fixed possible integer overflow error as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=965"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=965</a> + + <li> tiffsplit.c: Copy fax related fields over splitted parts + as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=983"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=983</a> + + <li> tiffdump.c: Fixed crash when reading malformed tags. + + <li> tiff2pdf.c: Added missed 'break' statement as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=932"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=932</a> +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> + <li> contrib/addtiffo/*: Major upgrade by Joris to support subsampled + YCbCr images in jpeg compressed TIFF files. + +</UL> + +Last updated $Date: 2006/01/04 23:38:38 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.8.1.html b/src/3rdparty/libtiff/html/v3.8.1.html new file mode 100644 index 0000000..9fea140 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.8.1.html @@ -0,0 +1,217 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.8.1 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.8.1<BR> +<B>Previous Version</B>: <A HREF=v3.8.0.html>v3.8.0</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<UL> + <li> Bug-fix release. +</UL> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + <li> libtool related stuff updated from the 2.1a branch. + + <li> Fix with_default_strip_size comparison as reported by + Norihiko Murase. +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + + <li> tif_dirread.c: Fixed error reporting in TIFFFetchAnyArray() + function as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1102"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1102</a> + + <li> tif_jpeg.c, tif_pixarlog.c, tif_fax3.c, tif_zip.c: + Properly restore setfield/getfield methods in cleanup functions. As + per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1102"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1102</a> + + <li> tif_lzw.c, tif_pixarlog.c, tif_zip.c: Use + TIFFPredictorCleanup() in codec cleanup methods. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1102"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1102</a> + + <li> tif_predict.c, tif_predict.h: Added new function + TIFFPredictorCleanup() to restore parent decode/encode/field methods. + + <li> tif_dirread.c: Fixed integer overflow condition in + TIFFFetchData() function. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1102"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1102</a> + + <li> tif_ojpeg.c: Set the ReferenceBlackWhite with the + TIFFSetField() method, not directly. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1043"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1043</a> + + <li> tif_write.c: Small code rearrangement in TIFFWriteScanline() + to avoid crash as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1081"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1081</a> + + <li> tif_dirwrite.c: Properly write TIFFTAG_DOTRANGE tag as per + bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1088"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1088</a> + + <li> tif_print.c: Properly read TIFFTAG_PAGENUMBER, + TIFFTAG_HALFTONEHINTS, TIFFTAG_YCBCRSUBSAMPLING and TIFFTAG_DOTRANGE + tags as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1088"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1088</a> + + <li> tif_tile.c: Fix error reporting in TIFFCheckTile() as per + bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1063"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1063</a> + + <li> tif_color.c: Avoid overflow in case of wrong input as per + bug <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1065"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1065</a> + + <li> tif_dirinfo.c: Use TIFF_NOTYPE instead of 0 when + appropriate. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1033"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1033</a> + + <li> tif_aux.c: Fixed type of temporary variable in + _TIFFCheckMalloc() as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=103"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=103</a> + + <li> tif_aux.c: Return static array when fetching default + YCbCrCoefficients (another problem, reported a the + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1029"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1029</a> + entry). + + <li> tif_dir.c: Special handling for PageNumber, HalftoneHints, + YCbCrSubsampling and DotRange tags as per bugs + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1029"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1029</a> + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1034"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1034</a> + + <li> tif_dirread.c: Use _TIFFGetExifFieldInfo() instead of + _TIFFGetFieldInfo() in TIFFReadEXIFDirectory() call as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1026"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1026</a> + + <li> tif_dirinfo.c: Change definitions for TIFFTAG_ICCPROFILE, + TIFFTAG_PHOTOSHOP, TIFFTAG_RICHTIFFIPTC, TIFFTAG_XMLPACKET: + readcount should be uint32 value. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <li> ppm2tiff.c: Added support for PBM files as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1044"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1044</a> + + <li> tiff2pdf.c: Functions t2p_sample_rgbaa_to_rgb() and + t2p_sample_rgba_to_rgb() was used in place of each other, that was + resulted in problems with RGBA images with associated alpha. + As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1097"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1097</a> + + <li> tiff2ps.c: Properly scale all the pages when converting + multipage TIFF with /width/height/center options set. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1080"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1080</a> + + <li> tiff2pdf.c: Do not create output file until all option checks + will be done. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1072"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1072</a> + + <li> bmp2tiff.c: Added ability to create multipage TIFFs from the + list of input files as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1077"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1077</a> + + <li> tiffgt.c: Avoid crashing in case of image unsupported by + TIFFRGBAImage interface. + + <li> tiff2pdf.c: Fixed support for non-YCbCr encoded JPEG + compressed TIFF files, per submission from Dan Cobra. + + <li> bmp2tiff, pal2rgb, ppm2tiff, ras2tiff, raw2tiff, sgi2tiff, + tiff2bw, tiffcp: Fixed jpeg option processing so -c jpeg:r:50 works + properly as per bug: + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1025"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1025</a> + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> +</UL> + +Last updated $Date: 2006/03/13 14:52:12 $. + +</BODY> +</HTML> diff --git a/src/3rdparty/libtiff/html/v3.8.2.html b/src/3rdparty/libtiff/html/v3.8.2.html new file mode 100644 index 0000000..e648127 --- /dev/null +++ b/src/3rdparty/libtiff/html/v3.8.2.html @@ -0,0 +1,137 @@ +<HTML> +<HEAD> +<TITLE> + Changes in TIFF v3.8.2 +</TITLE> +</HEAD> + +<BODY BGCOLOR=white> +<FONT FACE="Helvetica, Arial, Sans"> +<FONT FACE="Helvetica, Arial, Sans"> + +<BASEFONT SIZE=4> +<B><FONT SIZE=+3>T</FONT>IFF <FONT SIZE=+2>C</FONT>HANGE <FONT SIZE=+2>I</FONT>NFORMATION</B> +<BASEFONT SIZE=3> + +<UL> +<HR SIZE=4 WIDTH=65% ALIGN=left> +<B>Current Version</B>: v3.8.2<BR> +<B>Previous Version</B>: <A HREF=v3.8.1.html>v3.8.1</a><BR> +<B>Master FTP Site</B>: <A HREF="ftp://ftp.remotesensing.org/pub/libtiff"> +ftp.remotesensing.org</a>, directory pub/libtiff</A><BR> +<B>Master HTTP Site</B>: <A HREF="http://www.remotesensing.org/libtiff"> +http://www.remotesensing.org/libtiff</a> +<HR SIZE=4 WIDTH=65% ALIGN=left> +</UL> + +<P> +This document describes the changes made to the software between the +<I>previous</I> and <I>current</I> versions (see above). +If you don't find something listed here, then it was not done in this +timeframe, or it was not considered important enough to be mentioned. +The following information is located here: +<UL> +<LI><A HREF="#hightlights">Major Changes</A> +<LI><A HREF="#configure">Changes in the software configuration</A> +<LI><A HREF="#libtiff">Changes in libtiff</A> +<LI><A HREF="#tools">Changes in the tools</A> +<LI><A HREF="#contrib">Changes in the contrib area</A> +</UL> +<p> +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="highlights"><B><FONT SIZE=+3>M</FONT>AJOR CHANGES:</B></A> + +<UL> + <li> Bug-fix release. +</UL> + + +<P><HR WIDTH=65% ALIGN=left> +<!---------------------------------------------------------------------------> + +<A NAME="configure"><B><FONT SIZE=+3>C</FONT>HANGES IN THE SOFTWARE CONFIGURATION:</B></A> + +<UL> + + <li> tools/Makefile.am: Use runtime paths linker flags when rpath + option enabled. + + <li> Makefiles improvements as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1128"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1128</a> + + <li> Fixed win32 I/O functions usage as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1127"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1127</a> + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="libtiff"><B><FONT SIZE=+3>C</FONT>HANGES IN LIBTIFF:</B></A> + +<UL> + <li> tif_strip.c: Take subsampling in account when calculating + TIFFScanlineSize(). + + <li> tif_jpeg.c, tif_fax3.c, tif_zip.c, tif_pixarlog.c, + tif_lzw.c, tif_luv.c: Use _TIFFSetDefaultCompressionState() in all + codec cleanup methods. As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1120"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1120</a> + + <li> tif_jpeg.c: Do not cleanup codec state in TIFFInitJPEG(). As + per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1119"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1119</a> + + <li> tif_dir.c: Use double type instead of dblparam_t. + + <li> tif_dirread.c: Do not check the PlanarConfig tag presence + in TIFFReadDirectory, because it is always set at the start of + function and we allow TIFFs without that tag set. + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!--------------------------------------------------------------------------> + +<A NAME="tools"><B><FONT SIZE=+3>C</FONT>HANGES IN THE TOOLS:</B></A> + +<UL> + <li> tiffcp.c: Do not set RowsPerStrip bigger than image length. + + <li> fax2tiff.c: Fixed wrong TIFFerror() invocations as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1125"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1125</a> + + <li> fax2ps.c: Fixed reading the input stream from stdin as per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1124"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1124</a> + + <li> raw2tiff.c: Do not set RowsPerStrip larger than ImageLength. + As per bug + <a href="http://bugzilla.remotesensing.org/show_bug.cgi?id=1110"> + http://bugzilla.remotesensing.org/show_bug.cgi?id=1110</a> + +</UL> + +<P><HR WIDTH=65% ALIGN=left> + +<!---------------------------------------------------------------------------> + +<A NAME="contrib"><B><FONT SIZE=+3>C</FONT>HANGES IN THE CONTRIB AREA:</B></A> + +<UL> +</UL> + +Last updated $Date: 2006/03/23 14:54:01 $. + +</BODY> +</HTML> |
