diff options
author | Chris E Ferron <chris.e.ferron@linux.intel.com> | 2012-11-06 10:17:46 -0800 |
---|---|---|
committer | Chris E Ferron <chris.e.ferron@linux.intel.com> | 2012-11-06 10:17:46 -0800 |
commit | d944ade4016ecf00d871d8b9ae121b1cb4919da0 (patch) | |
tree | 2803c8e03fc27dacd704510de21a7718e686c437 /docs | |
download | gdk-pixbuf-d944ade4016ecf00d871d8b9ae121b1cb4919da0.tar.gz gdk-pixbuf-d944ade4016ecf00d871d8b9ae121b1cb4919da0.tar.bz2 gdk-pixbuf-d944ade4016ecf00d871d8b9ae121b1cb4919da0.zip |
Imported Upstream version 2.26.4upstream/2.26.4
Diffstat (limited to 'docs')
65 files changed, 15234 insertions, 0 deletions
diff --git a/docs/Makefile.am b/docs/Makefile.am new file mode 100644 index 0000000..470cddf --- /dev/null +++ b/docs/Makefile.am @@ -0,0 +1,5 @@ +include $(top_srcdir)/Makefile.decl + +SUBDIRS = reference + +-include $(top_srcdir)/git.mk diff --git a/docs/Makefile.in b/docs/Makefile.in new file mode 100644 index 0000000..8c38aec --- /dev/null +++ b/docs/Makefile.in @@ -0,0 +1,762 @@ +# Makefile.in generated by automake 1.12.2 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994-2012 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@ + +# GTK+ - The GIMP Toolkit +VPATH = @srcdir@ +am__make_dryrun = \ + { \ + am__dry=no; \ + case $$MAKEFLAGS in \ + *\\[\ \ ]*) \ + echo 'am--echo: ; @echo "AM" OK' | $(MAKE) -f - 2>/dev/null \ + | grep '^AM OK$$' >/dev/null || am__dry=yes;; \ + *) \ + for am__flg in $$MAKEFLAGS; do \ + case $$am__flg in \ + *=*|--*) ;; \ + *n*) am__dry=yes; break;; \ + esac; \ + done;; \ + esac; \ + test $$am__dry = yes; \ + } +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +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@ +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ + $(top_srcdir)/Makefile.decl +subdir = docs +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/gettext.m4 \ + $(top_srcdir)/m4/gtk-doc.m4 $(top_srcdir)/m4/iconv.m4 \ + $(top_srcdir)/m4/intlmacosx.m4 \ + $(top_srcdir)/m4/introspection.m4 $(top_srcdir)/m4/lib-ld.m4 \ + $(top_srcdir)/m4/lib-link.m4 $(top_srcdir)/m4/lib-prefix.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/m4/nls.m4 \ + $(top_srcdir)/m4/po.m4 $(top_srcdir)/m4/progtest.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(install_sh) -d +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = +SOURCES = +DIST_SOURCES = +RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ + html-recursive info-recursive install-data-recursive \ + install-dvi-recursive install-exec-recursive \ + install-html-recursive install-info-recursive \ + install-pdf-recursive install-ps-recursive install-recursive \ + installcheck-recursive installdirs-recursive pdf-recursive \ + ps-recursive uninstall-recursive +am__can_run_installinfo = \ + case $$AM_UPDATE_INFO_DIR in \ + n|no|NO) false;; \ + *) (install-info --version) >/dev/null 2>&1;; \ + esac +RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ + distclean-recursive maintainer-clean-recursive +AM_RECURSIVE_TARGETS = $(RECURSIVE_TARGETS:-recursive=) \ + $(RECURSIVE_CLEAN_TARGETS:-recursive=) tags TAGS ctags CTAGS \ + distdir +ETAGS = etags +CTAGS = ctags +DIST_SUBDIRS = $(SUBDIRS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +am__relativize = \ + dir0=`pwd`; \ + sed_first='s,^\([^/]*\)/.*$$,\1,'; \ + sed_rest='s,^[^/]*/*,,'; \ + sed_last='s,^.*/\([^/]*\)$$,\1,'; \ + sed_butlast='s,/*[^/]*$$,,'; \ + while test -n "$$dir1"; do \ + first=`echo "$$dir1" | sed -e "$$sed_first"`; \ + if test "$$first" != "."; then \ + if test "$$first" = ".."; then \ + dir2=`echo "$$dir0" | sed -e "$$sed_last"`/"$$dir2"; \ + dir0=`echo "$$dir0" | sed -e "$$sed_butlast"`; \ + else \ + first2=`echo "$$dir2" | sed -e "$$sed_first"`; \ + if test "$$first2" = "$$first"; then \ + dir2=`echo "$$dir2" | sed -e "$$sed_rest"`; \ + else \ + dir2="../$$dir2"; \ + fi; \ + dir0="$$dir0"/"$$first"; \ + fi; \ + fi; \ + dir1=`echo "$$dir1" | sed -e "$$sed_rest"`; \ + done; \ + reldir="$$dir2" +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ +AR = @AR@ +AS = @AS@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +BASE_DEPENDENCIES_CFLAGS = @BASE_DEPENDENCIES_CFLAGS@ +BASE_DEPENDENCIES_LIBS = @BASE_DEPENDENCIES_LIBS@ +CC = @CC@ +CCAS = @CCAS@ +CCASDEPMODE = @CCASDEPMODE@ +CCASFLAGS = @CCASFLAGS@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DB2HTML = @DB2HTML@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DLLTOOL = @DLLTOOL@ +DSYMUTIL = @DSYMUTIL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +EXE_MANIFEST_ARCHITECTURE = @EXE_MANIFEST_ARCHITECTURE@ +FGREP = @FGREP@ +GDK_PIXBUF_API_VERSION = @GDK_PIXBUF_API_VERSION@ +GDK_PIXBUF_BINARY_VERSION = @GDK_PIXBUF_BINARY_VERSION@ +GDK_PIXBUF_CSOURCE = @GDK_PIXBUF_CSOURCE@ +GDK_PIXBUF_DEP_CFLAGS = @GDK_PIXBUF_DEP_CFLAGS@ +GDK_PIXBUF_DEP_LIBS = @GDK_PIXBUF_DEP_LIBS@ +GDK_PIXBUF_EXTRA_CFLAGS = @GDK_PIXBUF_EXTRA_CFLAGS@ +GDK_PIXBUF_EXTRA_LIBS = @GDK_PIXBUF_EXTRA_LIBS@ +GDK_PIXBUF_LINK_FLAGS = @GDK_PIXBUF_LINK_FLAGS@ +GDK_PIXBUF_MAJOR = @GDK_PIXBUF_MAJOR@ +GDK_PIXBUF_MICRO = @GDK_PIXBUF_MICRO@ +GDK_PIXBUF_MINOR = @GDK_PIXBUF_MINOR@ +GDK_PIXBUF_PACKAGES = @GDK_PIXBUF_PACKAGES@ +GDK_PIXBUF_VERSION = @GDK_PIXBUF_VERSION@ +GDK_PIXBUF_XLIB_DEP_CFLAGS = @GDK_PIXBUF_XLIB_DEP_CFLAGS@ +GDK_PIXBUF_XLIB_DEP_LIBS = @GDK_PIXBUF_XLIB_DEP_LIBS@ +GETTEXT_MACRO_VERSION = @GETTEXT_MACRO_VERSION@ +GETTEXT_PACKAGE = @GETTEXT_PACKAGE@ +GLIB_CFLAGS = @GLIB_CFLAGS@ +GLIB_COMPILE_RESOURCES = @GLIB_COMPILE_RESOURCES@ +GLIB_GENMARSHAL = @GLIB_GENMARSHAL@ +GLIB_LIBS = @GLIB_LIBS@ +GLIB_MKENUMS = @GLIB_MKENUMS@ +GMSGFMT = @GMSGFMT@ +GMSGFMT_015 = @GMSGFMT_015@ +GOBJECT_QUERY = @GOBJECT_QUERY@ +GREP = @GREP@ +GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ +GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ +GTKDOC_MKPDF = @GTKDOC_MKPDF@ +GTKDOC_REBASE = @GTKDOC_REBASE@ +GTK_UPDATE_ICON_CACHE = @GTK_UPDATE_ICON_CACHE@ +HTML_DIR = @HTML_DIR@ +INCLUDED_LOADER_DEFINE = @INCLUDED_LOADER_DEFINE@ +INCLUDED_LOADER_OBJ = @INCLUDED_LOADER_OBJ@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +INTLLIBS = @INTLLIBS@ +INTL_MACOSX_LIBS = @INTL_MACOSX_LIBS@ +INTROSPECTION_CFLAGS = @INTROSPECTION_CFLAGS@ +INTROSPECTION_COMPILER = @INTROSPECTION_COMPILER@ +INTROSPECTION_GENERATE = @INTROSPECTION_GENERATE@ +INTROSPECTION_GIRDIR = @INTROSPECTION_GIRDIR@ +INTROSPECTION_LIBS = @INTROSPECTION_LIBS@ +INTROSPECTION_MAKEFILE = @INTROSPECTION_MAKEFILE@ +INTROSPECTION_SCANNER = @INTROSPECTION_SCANNER@ +INTROSPECTION_TYPELIBDIR = @INTROSPECTION_TYPELIBDIR@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBICONV = @LIBICONV@ +LIBINTL = @LIBINTL@ +LIBJASPER = @LIBJASPER@ +LIBJPEG = @LIBJPEG@ +LIBOBJS = @LIBOBJS@ +LIBPNG = @LIBPNG@ +LIBS = @LIBS@ +LIBTIFF = @LIBTIFF@ +LIBTOOL = @LIBTOOL@ +LIBTOOL_EXPORT_OPTIONS = @LIBTOOL_EXPORT_OPTIONS@ +LIB_EXE_MACHINE_FLAG = @LIB_EXE_MACHINE_FLAG@ +LIPO = @LIPO@ +LN_S = @LN_S@ +LTLIBICONV = @LTLIBICONV@ +LTLIBINTL = @LTLIBINTL@ +LTLIBOBJS = @LTLIBOBJS@ +LT_CURRENT_MINUS_AGE = @LT_CURRENT_MINUS_AGE@ +LT_VERSION_INFO = @LT_VERSION_INFO@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MANIFEST_TOOL = @MANIFEST_TOOL@ +MATH_LIB = @MATH_LIB@ +MKDIR_P = @MKDIR_P@ +MSGFMT = @MSGFMT@ +MSGFMT_015 = @MSGFMT_015@ +MSGMERGE = @MSGMERGE@ +NM = @NM@ +NMEDIT = @NMEDIT@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +OTOOL = @OTOOL@ +OTOOL64 = @OTOOL64@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ +PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ +PNG_DEP_CFLAGS_PACKAGES = @PNG_DEP_CFLAGS_PACKAGES@ +POSUB = @POSUB@ +RANLIB = @RANLIB@ +REBUILD = @REBUILD@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +USE_NLS = @USE_NLS@ +VERSION = @VERSION@ +WINDRES = @WINDRES@ +XGETTEXT = @XGETTEXT@ +XGETTEXT_015 = @XGETTEXT_015@ +XGETTEXT_EXTRA_OPTIONS = @XGETTEXT_EXTRA_OPTIONS@ +XSLTPROC = @XSLTPROC@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +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@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +ms_librarian = @ms_librarian@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +GTESTER = gtester # in $PATH for non-GLIB packages +GTESTER_REPORT = gtester-report # in $PATH for non-GLIB packages + +# initialize variables for unconditional += appending +EXTRA_DIST = +TEST_PROGS = + +### testing rules + +# Xvfb based test rules +XVFB = Xvfb -ac -noreset -screen 0 800x600x16 +XIDS = 101 102 103 104 105 106 107 197 199 211 223 227 293 307 308 309 310 311 \ + 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 \ + 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 \ + 1008 1009 4703 4721 4723 4729 4733 4751 9973 9974 9975 9976 9977 9978 9979 \ + 9980 9981 9982 9983 9984 9985 9986 9987 9988 9989 9990 9991 9992 9993 9994 \ + 9995 9996 9997 9998 9999 + +SKIP_GDKTARGET = \ + test "$(gdktarget)" != "x11" \ + && echo "Gtk+Tests:INFO: Skipping GUI tests for non-X11 target." + +XVFB_START = \ + ${XVFB} -help 2>/dev/null 1>&2 \ + && XID=`for id in $(XIDS) ; do test -e /tmp/.X$$id-lock || { echo $$id; exit 0; }; done; exit 1` \ + && { ${XVFB} :$$XID -screen 0 800x600x16 -nolisten tcp -auth /dev/null >/dev/null 2>&1 & \ + trap "kill -15 $$! " 0 HUP INT QUIT TRAP USR1 PIPE TERM ; } \ + || { echo "Gtk+Tests:ERROR: Failed to start Xvfb environment for X11 target tests."; exit 1; } \ + && DISPLAY=:$$XID && export DISPLAY + +SUBDIRS = reference +all: all-recursive + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/Makefile.decl $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign docs/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --foreign docs/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_srcdir)/Makefile.decl: + +$(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 +$(am__aclocal_m4_deps): + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs + +# 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) $(RECURSIVE_CLEAN_TARGETS): + @fail= 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//`; \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + 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; \ + ($(am__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" +tags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ + done +ctags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ + done +cscopelist-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) cscopelist); \ + 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; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + mkid -fID $$unique +tags: TAGS + +TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + set x; \ + 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 || \ + set "$$@" "$$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; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + shift; \ + if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \ + test -n "$$unique" || unique=$$empty_fix; \ + if test $$# -gt 0; then \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + "$$@" $$unique; \ + else \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + $$unique; \ + fi; \ + fi +ctags: CTAGS +CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + 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; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + test -z "$(CTAGS_ARGS)$$unique" \ + || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ + $$unique + +GTAGS: + here=`$(am__cd) $(top_builddir) && pwd` \ + && $(am__cd) $(top_srcdir) \ + && gtags -i $(GTAGS_ARGS) "$$here" + +cscopelist: cscopelist-recursive $(HEADERS) $(SOURCES) $(LISP) + list='$(SOURCES) $(HEADERS) $(LISP)'; \ + case "$(srcdir)" in \ + [\\/]* | ?:[\\/]*) sdir="$(srcdir)" ;; \ + *) sdir=$(subdir)/$(srcdir) ;; \ + esac; \ + for i in $$list; do \ + if test -f "$$i"; then \ + echo "$(subdir)/$$i"; \ + else \ + echo "$$sdir/$$i"; \ + fi; \ + done >> $(top_builddir)/cscope.files + +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)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$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 \ + $(am__make_dryrun) \ + || test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ + dir1=$$subdir; dir2="$(distdir)/$$subdir"; \ + $(am__relativize); \ + new_distdir=$$reldir; \ + dir1=$$subdir; dir2="$(top_distdir)"; \ + $(am__relativize); \ + new_top_distdir=$$reldir; \ + echo " (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) top_distdir="$$new_top_distdir" distdir="$$new_distdir" \\"; \ + echo " am__remove_distdir=: am__skip_length_check=: am__skip_mode_fix=: distdir)"; \ + ($(am__cd) $$subdir && \ + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$$new_top_distdir" \ + distdir="$$new_distdir" \ + am__remove_distdir=: \ + am__skip_length_check=: \ + am__skip_mode_fix=: \ + distdir) \ + || exit 1; \ + fi; \ + done +check-am: all-am + $(MAKE) $(AM_MAKEFLAGS) check-local +check: check-recursive +all-am: Makefile +installdirs: installdirs-recursive +installdirs-am: +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: + if test -z '$(STRIP)'; then \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + install; \ + else \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \ + fi +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_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-tags + +dvi: dvi-recursive + +dvi-am: + +html: html-recursive + +html-am: + +info: info-recursive + +info-am: + +install-data-am: + +install-dvi: install-dvi-recursive + +install-dvi-am: + +install-exec-am: + +install-html: install-html-recursive + +install-html-am: + +install-info: install-info-recursive + +install-info-am: + +install-man: + +install-pdf: install-pdf-recursive + +install-pdf-am: + +install-ps: install-ps-recursive + +install-ps-am: + +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: + +.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) check-am \ + cscopelist-recursive ctags-recursive install-am install-strip \ + tags-recursive + +.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \ + all all-am check check-am check-local clean clean-generic \ + clean-libtool cscopelist cscopelist-recursive ctags \ + ctags-recursive distclean distclean-generic distclean-libtool \ + distclean-tags distdir dvi dvi-am html html-am info info-am \ + install install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + installdirs-am maintainer-clean maintainer-clean-generic \ + mostlyclean mostlyclean-generic mostlyclean-libtool pdf pdf-am \ + ps ps-am tags tags-recursive uninstall uninstall-am + +# call as: $(XVFB_START) && someprogram + +# test: run all tests in cwd and subdirs +test: ${TEST_PROGS} + @$(SKIP_GDKTARGET) || test -z "${TEST_PROGS}" || { \ + $(XVFB_START) && { set -e; ${GTESTER} --verbose ${TEST_PROGS}; }; \ + } + @ for subdir in $(SUBDIRS) ; do \ + test "$$subdir" = "." -o "$$subdir" = "po" -o "$$subdir" = "po-properties" || \ + ( cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $@ ) || exit $? ; \ + done +# test-report: run tests in subdirs and generate report +# perf-report: run tests in subdirs with -m perf and generate report +# full-report: like test-report: with -m perf and -m slow +test-report perf-report full-report: ${TEST_PROGS} + @ ignore_logdir=true ; \ + if test -z "$$GTESTER_LOGDIR" ; then \ + GTESTER_LOGDIR=`mktemp -d "\`pwd\`/.testlogs-XXXXXX"`; export GTESTER_LOGDIR ; \ + ignore_logdir=false ; \ + fi ; \ + for subdir in $(SUBDIRS) ; do \ + test "$$subdir" = "." -o "$$subdir" = "po" -o "$$subdir" = "po-properties" || \ + ( cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $@ ) || exit $? ; \ + done ; \ + $(SKIP_GDKTARGET) || test -z "${TEST_PROGS}" || { \ + case $@ in \ + test-report) test_options="-k";; \ + perf-report) test_options="-k -m=perf";; \ + full-report) test_options="-k -m=perf -m=slow";; \ + esac ; \ + $(XVFB_START) && { \ + set -e; \ + if test -z "$$GTESTER_LOGDIR" ; then \ + ${GTESTER} --verbose $$test_options -o test-report.xml ${TEST_PROGS} ; \ + elif test -n "${TEST_PROGS}" ; then \ + ${GTESTER} --verbose $$test_options -o `mktemp "$$GTESTER_LOGDIR/log-XXXXXX"` ${TEST_PROGS} ; \ + fi ; \ + }; \ + }; \ + $$ignore_logdir || { \ + echo '<?xml version="1.0"?>' > $@.xml ; \ + echo '<report-collection>' >> $@.xml ; \ + for lf in `ls -L "$$GTESTER_LOGDIR"/.` ; do \ + sed '1,1s/^<?xml\b[^>?]*?>//' <"$$GTESTER_LOGDIR"/"$$lf" >> $@.xml ; \ + done ; \ + echo >> $@.xml ; \ + echo '</report-collection>' >> $@.xml ; \ + rm -rf "$$GTESTER_LOGDIR"/ ; \ + ${GTESTER_REPORT} --version 2>/dev/null 1>&2 ; test "$$?" != 0 || ${GTESTER_REPORT} $@.xml >$@.html ; \ + } +.PHONY: test test-report perf-report full-report +# run make test as part of make check +check-local: test + +-include $(top_srcdir)/git.mk + +# 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/docs/reference/Makefile.am b/docs/reference/Makefile.am new file mode 100644 index 0000000..bc0b954 --- /dev/null +++ b/docs/reference/Makefile.am @@ -0,0 +1,7 @@ +include $(top_srcdir)/Makefile.decl + +SUBDIRS = gdk-pixbuf + +GITIGNOREFILES = */*.1 + +-include $(top_srcdir)/git.mk diff --git a/docs/reference/Makefile.in b/docs/reference/Makefile.in new file mode 100644 index 0000000..cb0c7aa --- /dev/null +++ b/docs/reference/Makefile.in @@ -0,0 +1,763 @@ +# Makefile.in generated by automake 1.12.2 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994-2012 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@ + +# GTK+ - The GIMP Toolkit +VPATH = @srcdir@ +am__make_dryrun = \ + { \ + am__dry=no; \ + case $$MAKEFLAGS in \ + *\\[\ \ ]*) \ + echo 'am--echo: ; @echo "AM" OK' | $(MAKE) -f - 2>/dev/null \ + | grep '^AM OK$$' >/dev/null || am__dry=yes;; \ + *) \ + for am__flg in $$MAKEFLAGS; do \ + case $$am__flg in \ + *=*|--*) ;; \ + *n*) am__dry=yes; break;; \ + esac; \ + done;; \ + esac; \ + test $$am__dry = yes; \ + } +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +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@ +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ + $(top_srcdir)/Makefile.decl +subdir = docs/reference +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/gettext.m4 \ + $(top_srcdir)/m4/gtk-doc.m4 $(top_srcdir)/m4/iconv.m4 \ + $(top_srcdir)/m4/intlmacosx.m4 \ + $(top_srcdir)/m4/introspection.m4 $(top_srcdir)/m4/lib-ld.m4 \ + $(top_srcdir)/m4/lib-link.m4 $(top_srcdir)/m4/lib-prefix.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/m4/nls.m4 \ + $(top_srcdir)/m4/po.m4 $(top_srcdir)/m4/progtest.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(install_sh) -d +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = +SOURCES = +DIST_SOURCES = +RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ + html-recursive info-recursive install-data-recursive \ + install-dvi-recursive install-exec-recursive \ + install-html-recursive install-info-recursive \ + install-pdf-recursive install-ps-recursive install-recursive \ + installcheck-recursive installdirs-recursive pdf-recursive \ + ps-recursive uninstall-recursive +am__can_run_installinfo = \ + case $$AM_UPDATE_INFO_DIR in \ + n|no|NO) false;; \ + *) (install-info --version) >/dev/null 2>&1;; \ + esac +RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ + distclean-recursive maintainer-clean-recursive +AM_RECURSIVE_TARGETS = $(RECURSIVE_TARGETS:-recursive=) \ + $(RECURSIVE_CLEAN_TARGETS:-recursive=) tags TAGS ctags CTAGS \ + distdir +ETAGS = etags +CTAGS = ctags +DIST_SUBDIRS = $(SUBDIRS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +am__relativize = \ + dir0=`pwd`; \ + sed_first='s,^\([^/]*\)/.*$$,\1,'; \ + sed_rest='s,^[^/]*/*,,'; \ + sed_last='s,^.*/\([^/]*\)$$,\1,'; \ + sed_butlast='s,/*[^/]*$$,,'; \ + while test -n "$$dir1"; do \ + first=`echo "$$dir1" | sed -e "$$sed_first"`; \ + if test "$$first" != "."; then \ + if test "$$first" = ".."; then \ + dir2=`echo "$$dir0" | sed -e "$$sed_last"`/"$$dir2"; \ + dir0=`echo "$$dir0" | sed -e "$$sed_butlast"`; \ + else \ + first2=`echo "$$dir2" | sed -e "$$sed_first"`; \ + if test "$$first2" = "$$first"; then \ + dir2=`echo "$$dir2" | sed -e "$$sed_rest"`; \ + else \ + dir2="../$$dir2"; \ + fi; \ + dir0="$$dir0"/"$$first"; \ + fi; \ + fi; \ + dir1=`echo "$$dir1" | sed -e "$$sed_rest"`; \ + done; \ + reldir="$$dir2" +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ +AR = @AR@ +AS = @AS@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +BASE_DEPENDENCIES_CFLAGS = @BASE_DEPENDENCIES_CFLAGS@ +BASE_DEPENDENCIES_LIBS = @BASE_DEPENDENCIES_LIBS@ +CC = @CC@ +CCAS = @CCAS@ +CCASDEPMODE = @CCASDEPMODE@ +CCASFLAGS = @CCASFLAGS@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DB2HTML = @DB2HTML@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DLLTOOL = @DLLTOOL@ +DSYMUTIL = @DSYMUTIL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +EXE_MANIFEST_ARCHITECTURE = @EXE_MANIFEST_ARCHITECTURE@ +FGREP = @FGREP@ +GDK_PIXBUF_API_VERSION = @GDK_PIXBUF_API_VERSION@ +GDK_PIXBUF_BINARY_VERSION = @GDK_PIXBUF_BINARY_VERSION@ +GDK_PIXBUF_CSOURCE = @GDK_PIXBUF_CSOURCE@ +GDK_PIXBUF_DEP_CFLAGS = @GDK_PIXBUF_DEP_CFLAGS@ +GDK_PIXBUF_DEP_LIBS = @GDK_PIXBUF_DEP_LIBS@ +GDK_PIXBUF_EXTRA_CFLAGS = @GDK_PIXBUF_EXTRA_CFLAGS@ +GDK_PIXBUF_EXTRA_LIBS = @GDK_PIXBUF_EXTRA_LIBS@ +GDK_PIXBUF_LINK_FLAGS = @GDK_PIXBUF_LINK_FLAGS@ +GDK_PIXBUF_MAJOR = @GDK_PIXBUF_MAJOR@ +GDK_PIXBUF_MICRO = @GDK_PIXBUF_MICRO@ +GDK_PIXBUF_MINOR = @GDK_PIXBUF_MINOR@ +GDK_PIXBUF_PACKAGES = @GDK_PIXBUF_PACKAGES@ +GDK_PIXBUF_VERSION = @GDK_PIXBUF_VERSION@ +GDK_PIXBUF_XLIB_DEP_CFLAGS = @GDK_PIXBUF_XLIB_DEP_CFLAGS@ +GDK_PIXBUF_XLIB_DEP_LIBS = @GDK_PIXBUF_XLIB_DEP_LIBS@ +GETTEXT_MACRO_VERSION = @GETTEXT_MACRO_VERSION@ +GETTEXT_PACKAGE = @GETTEXT_PACKAGE@ +GLIB_CFLAGS = @GLIB_CFLAGS@ +GLIB_COMPILE_RESOURCES = @GLIB_COMPILE_RESOURCES@ +GLIB_GENMARSHAL = @GLIB_GENMARSHAL@ +GLIB_LIBS = @GLIB_LIBS@ +GLIB_MKENUMS = @GLIB_MKENUMS@ +GMSGFMT = @GMSGFMT@ +GMSGFMT_015 = @GMSGFMT_015@ +GOBJECT_QUERY = @GOBJECT_QUERY@ +GREP = @GREP@ +GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ +GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ +GTKDOC_MKPDF = @GTKDOC_MKPDF@ +GTKDOC_REBASE = @GTKDOC_REBASE@ +GTK_UPDATE_ICON_CACHE = @GTK_UPDATE_ICON_CACHE@ +HTML_DIR = @HTML_DIR@ +INCLUDED_LOADER_DEFINE = @INCLUDED_LOADER_DEFINE@ +INCLUDED_LOADER_OBJ = @INCLUDED_LOADER_OBJ@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +INTLLIBS = @INTLLIBS@ +INTL_MACOSX_LIBS = @INTL_MACOSX_LIBS@ +INTROSPECTION_CFLAGS = @INTROSPECTION_CFLAGS@ +INTROSPECTION_COMPILER = @INTROSPECTION_COMPILER@ +INTROSPECTION_GENERATE = @INTROSPECTION_GENERATE@ +INTROSPECTION_GIRDIR = @INTROSPECTION_GIRDIR@ +INTROSPECTION_LIBS = @INTROSPECTION_LIBS@ +INTROSPECTION_MAKEFILE = @INTROSPECTION_MAKEFILE@ +INTROSPECTION_SCANNER = @INTROSPECTION_SCANNER@ +INTROSPECTION_TYPELIBDIR = @INTROSPECTION_TYPELIBDIR@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBICONV = @LIBICONV@ +LIBINTL = @LIBINTL@ +LIBJASPER = @LIBJASPER@ +LIBJPEG = @LIBJPEG@ +LIBOBJS = @LIBOBJS@ +LIBPNG = @LIBPNG@ +LIBS = @LIBS@ +LIBTIFF = @LIBTIFF@ +LIBTOOL = @LIBTOOL@ +LIBTOOL_EXPORT_OPTIONS = @LIBTOOL_EXPORT_OPTIONS@ +LIB_EXE_MACHINE_FLAG = @LIB_EXE_MACHINE_FLAG@ +LIPO = @LIPO@ +LN_S = @LN_S@ +LTLIBICONV = @LTLIBICONV@ +LTLIBINTL = @LTLIBINTL@ +LTLIBOBJS = @LTLIBOBJS@ +LT_CURRENT_MINUS_AGE = @LT_CURRENT_MINUS_AGE@ +LT_VERSION_INFO = @LT_VERSION_INFO@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MANIFEST_TOOL = @MANIFEST_TOOL@ +MATH_LIB = @MATH_LIB@ +MKDIR_P = @MKDIR_P@ +MSGFMT = @MSGFMT@ +MSGFMT_015 = @MSGFMT_015@ +MSGMERGE = @MSGMERGE@ +NM = @NM@ +NMEDIT = @NMEDIT@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +OTOOL = @OTOOL@ +OTOOL64 = @OTOOL64@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ +PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ +PNG_DEP_CFLAGS_PACKAGES = @PNG_DEP_CFLAGS_PACKAGES@ +POSUB = @POSUB@ +RANLIB = @RANLIB@ +REBUILD = @REBUILD@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +USE_NLS = @USE_NLS@ +VERSION = @VERSION@ +WINDRES = @WINDRES@ +XGETTEXT = @XGETTEXT@ +XGETTEXT_015 = @XGETTEXT_015@ +XGETTEXT_EXTRA_OPTIONS = @XGETTEXT_EXTRA_OPTIONS@ +XSLTPROC = @XSLTPROC@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +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@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +ms_librarian = @ms_librarian@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +GTESTER = gtester # in $PATH for non-GLIB packages +GTESTER_REPORT = gtester-report # in $PATH for non-GLIB packages + +# initialize variables for unconditional += appending +EXTRA_DIST = +TEST_PROGS = + +### testing rules + +# Xvfb based test rules +XVFB = Xvfb -ac -noreset -screen 0 800x600x16 +XIDS = 101 102 103 104 105 106 107 197 199 211 223 227 293 307 308 309 310 311 \ + 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 \ + 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 \ + 1008 1009 4703 4721 4723 4729 4733 4751 9973 9974 9975 9976 9977 9978 9979 \ + 9980 9981 9982 9983 9984 9985 9986 9987 9988 9989 9990 9991 9992 9993 9994 \ + 9995 9996 9997 9998 9999 + +SKIP_GDKTARGET = \ + test "$(gdktarget)" != "x11" \ + && echo "Gtk+Tests:INFO: Skipping GUI tests for non-X11 target." + +XVFB_START = \ + ${XVFB} -help 2>/dev/null 1>&2 \ + && XID=`for id in $(XIDS) ; do test -e /tmp/.X$$id-lock || { echo $$id; exit 0; }; done; exit 1` \ + && { ${XVFB} :$$XID -screen 0 800x600x16 -nolisten tcp -auth /dev/null >/dev/null 2>&1 & \ + trap "kill -15 $$! " 0 HUP INT QUIT TRAP USR1 PIPE TERM ; } \ + || { echo "Gtk+Tests:ERROR: Failed to start Xvfb environment for X11 target tests."; exit 1; } \ + && DISPLAY=:$$XID && export DISPLAY + +SUBDIRS = gdk-pixbuf +GITIGNOREFILES = */*.1 +all: all-recursive + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/Makefile.decl $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign docs/reference/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --foreign docs/reference/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_srcdir)/Makefile.decl: + +$(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 +$(am__aclocal_m4_deps): + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs + +# 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) $(RECURSIVE_CLEAN_TARGETS): + @fail= 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//`; \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + 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; \ + ($(am__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" +tags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ + done +ctags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ + done +cscopelist-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) cscopelist); \ + 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; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + mkid -fID $$unique +tags: TAGS + +TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + set x; \ + 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 || \ + set "$$@" "$$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; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + shift; \ + if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \ + test -n "$$unique" || unique=$$empty_fix; \ + if test $$# -gt 0; then \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + "$$@" $$unique; \ + else \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + $$unique; \ + fi; \ + fi +ctags: CTAGS +CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + 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; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + test -z "$(CTAGS_ARGS)$$unique" \ + || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ + $$unique + +GTAGS: + here=`$(am__cd) $(top_builddir) && pwd` \ + && $(am__cd) $(top_srcdir) \ + && gtags -i $(GTAGS_ARGS) "$$here" + +cscopelist: cscopelist-recursive $(HEADERS) $(SOURCES) $(LISP) + list='$(SOURCES) $(HEADERS) $(LISP)'; \ + case "$(srcdir)" in \ + [\\/]* | ?:[\\/]*) sdir="$(srcdir)" ;; \ + *) sdir=$(subdir)/$(srcdir) ;; \ + esac; \ + for i in $$list; do \ + if test -f "$$i"; then \ + echo "$(subdir)/$$i"; \ + else \ + echo "$$sdir/$$i"; \ + fi; \ + done >> $(top_builddir)/cscope.files + +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)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$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 \ + $(am__make_dryrun) \ + || test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ + dir1=$$subdir; dir2="$(distdir)/$$subdir"; \ + $(am__relativize); \ + new_distdir=$$reldir; \ + dir1=$$subdir; dir2="$(top_distdir)"; \ + $(am__relativize); \ + new_top_distdir=$$reldir; \ + echo " (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) top_distdir="$$new_top_distdir" distdir="$$new_distdir" \\"; \ + echo " am__remove_distdir=: am__skip_length_check=: am__skip_mode_fix=: distdir)"; \ + ($(am__cd) $$subdir && \ + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$$new_top_distdir" \ + distdir="$$new_distdir" \ + am__remove_distdir=: \ + am__skip_length_check=: \ + am__skip_mode_fix=: \ + distdir) \ + || exit 1; \ + fi; \ + done +check-am: all-am + $(MAKE) $(AM_MAKEFLAGS) check-local +check: check-recursive +all-am: Makefile +installdirs: installdirs-recursive +installdirs-am: +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: + if test -z '$(STRIP)'; then \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + install; \ + else \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \ + fi +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_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-tags + +dvi: dvi-recursive + +dvi-am: + +html: html-recursive + +html-am: + +info: info-recursive + +info-am: + +install-data-am: + +install-dvi: install-dvi-recursive + +install-dvi-am: + +install-exec-am: + +install-html: install-html-recursive + +install-html-am: + +install-info: install-info-recursive + +install-info-am: + +install-man: + +install-pdf: install-pdf-recursive + +install-pdf-am: + +install-ps: install-ps-recursive + +install-ps-am: + +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: + +.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) check-am \ + cscopelist-recursive ctags-recursive install-am install-strip \ + tags-recursive + +.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \ + all all-am check check-am check-local clean clean-generic \ + clean-libtool cscopelist cscopelist-recursive ctags \ + ctags-recursive distclean distclean-generic distclean-libtool \ + distclean-tags distdir dvi dvi-am html html-am info info-am \ + install install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + installdirs-am maintainer-clean maintainer-clean-generic \ + mostlyclean mostlyclean-generic mostlyclean-libtool pdf pdf-am \ + ps ps-am tags tags-recursive uninstall uninstall-am + +# call as: $(XVFB_START) && someprogram + +# test: run all tests in cwd and subdirs +test: ${TEST_PROGS} + @$(SKIP_GDKTARGET) || test -z "${TEST_PROGS}" || { \ + $(XVFB_START) && { set -e; ${GTESTER} --verbose ${TEST_PROGS}; }; \ + } + @ for subdir in $(SUBDIRS) ; do \ + test "$$subdir" = "." -o "$$subdir" = "po" -o "$$subdir" = "po-properties" || \ + ( cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $@ ) || exit $? ; \ + done +# test-report: run tests in subdirs and generate report +# perf-report: run tests in subdirs with -m perf and generate report +# full-report: like test-report: with -m perf and -m slow +test-report perf-report full-report: ${TEST_PROGS} + @ ignore_logdir=true ; \ + if test -z "$$GTESTER_LOGDIR" ; then \ + GTESTER_LOGDIR=`mktemp -d "\`pwd\`/.testlogs-XXXXXX"`; export GTESTER_LOGDIR ; \ + ignore_logdir=false ; \ + fi ; \ + for subdir in $(SUBDIRS) ; do \ + test "$$subdir" = "." -o "$$subdir" = "po" -o "$$subdir" = "po-properties" || \ + ( cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $@ ) || exit $? ; \ + done ; \ + $(SKIP_GDKTARGET) || test -z "${TEST_PROGS}" || { \ + case $@ in \ + test-report) test_options="-k";; \ + perf-report) test_options="-k -m=perf";; \ + full-report) test_options="-k -m=perf -m=slow";; \ + esac ; \ + $(XVFB_START) && { \ + set -e; \ + if test -z "$$GTESTER_LOGDIR" ; then \ + ${GTESTER} --verbose $$test_options -o test-report.xml ${TEST_PROGS} ; \ + elif test -n "${TEST_PROGS}" ; then \ + ${GTESTER} --verbose $$test_options -o `mktemp "$$GTESTER_LOGDIR/log-XXXXXX"` ${TEST_PROGS} ; \ + fi ; \ + }; \ + }; \ + $$ignore_logdir || { \ + echo '<?xml version="1.0"?>' > $@.xml ; \ + echo '<report-collection>' >> $@.xml ; \ + for lf in `ls -L "$$GTESTER_LOGDIR"/.` ; do \ + sed '1,1s/^<?xml\b[^>?]*?>//' <"$$GTESTER_LOGDIR"/"$$lf" >> $@.xml ; \ + done ; \ + echo >> $@.xml ; \ + echo '</report-collection>' >> $@.xml ; \ + rm -rf "$$GTESTER_LOGDIR"/ ; \ + ${GTESTER_REPORT} --version 2>/dev/null 1>&2 ; test "$$?" != 0 || ${GTESTER_REPORT} $@.xml >$@.html ; \ + } +.PHONY: test test-report perf-report full-report +# run make test as part of make check +check-local: test + +-include $(top_srcdir)/git.mk + +# 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/docs/reference/gdk-pixbuf/Makefile.am b/docs/reference/gdk-pixbuf/Makefile.am new file mode 100644 index 0000000..c28e34f --- /dev/null +++ b/docs/reference/gdk-pixbuf/Makefile.am @@ -0,0 +1,127 @@ +## Process this file with automake to produce Makefile.in +include $(top_srcdir)/Makefile.decl + +AUTOMAKE_OPTIONS = 1.6 + +# The name of the module. +DOC_MODULE=gdk-pixbuf + +# The top-level SGML file. +DOC_MAIN_SGML_FILE=gdk-pixbuf.xml + +# Extra options to supply to gtkdoc-scan +SCAN_OPTIONS= \ + --source-dir=../../../contrib/gdk-pixbuf-xlib \ + --deprecated-guards="GDK_PIXBUF_ENABLE_BROKEN|GDK_PIXBUF_DISABLE_DEPRECATED" + +# The directory containing the source code. Relative to $(srcdir) +DOC_SOURCE_DIR=../../../gdk-pixbuf + +# Used for dependencies +HFILE_GLOB=$(top_srcdir)/gdk-pixbuf/*.h $(top_srcdir)/contrib/gdk-pixbuf-xlib/*.h +CFILE_GLOB=$(top_srcdir)/gdk-pixbuf/*.c $(top_srcdir)/contrib/gdk-pixbuf-xlib/*.c + +# Header files to ignore when scanning +IGNORE_HFILES= \ + pixops \ + gdk-pixbuf-alias.h \ + gdk-pixbuf-marshal.h \ + gdk-pixbuf-i18n.h \ + gdk-pixbuf-private.h \ + gdk-pixbuf-xlib-private.h \ + io-gif-animation.h \ + io-ani-animation.h \ + xpm-color-table.h \ + test-images.h + +INCLUDES = \ + -I$(top_srcdir) \ + -I$(top_builddir) \ + $(GDK_PIXBUF_DEBUG_FLAGS) \ + $(GDK_PIXBUF_DEP_CFLAGS) + +GTKDOC_LIBS = \ + $(top_builddir)/gdk-pixbuf/libgdk_pixbuf-$(GDK_PIXBUF_API_VERSION).la \ + $(GDK_PIXBUF_DEP_LIBS) + + +# Extra options to supply to gtkdoc-mkdb +MKDB_OPTIONS= \ + --main-sgml-file=$(DOC_MAIN_SGML_FILE) \ + --sgml-mode \ + --source-dir=../../../contrib/gdk-pixbuf-xlib \ + --output-format=xml \ + --name-space=gdk_pixbuf + +# Extra SGML files that are included by DOC_MAIN_SGML_FILE +content_files = \ + version.xml \ + gdk-pixbuf-from-drawables.xml \ + gdk-pixbuf-rendering.xml \ + gdk-pixbuf.xml \ + gdk-pixbuf-csource.xml \ + gdk-pixbuf-query-loaders.xml + +# Images to copy into HTML directory +HTML_IMAGES = composite.png + +# Extra options to supply to gtkdoc-fixref +FIXXREF_OPTIONS= --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gobject \ + --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/glib + + +include $(top_srcdir)/gtk-doc.make + +# Other files to distribute +EXTRA_DIST += version.xml.in \ + composite.png \ + composite.dia \ + apple-red-1a.png \ + apple-red-2c.png \ + gnome-gmush-1.png + +######################################################################## + +man_MANS = \ + gdk-pixbuf-csource.1 \ + gdk-pixbuf-query-loaders.1 + +if ENABLE_MAN + +XSLTPROC_FLAGS = \ + --nonet \ + --stringparam man.output.quietly 1 \ + --stringparam funcsynopsis.style ansi \ + --stringparam man.th.extra1.suppress 1 \ + --stringparam man.authors.section.enabled 0 \ + --stringparam man.copyright.section.enabled 0 + +.xml.1: + $(AM_V_GEN) $(XSLTPROC) $(XSLTPROC_FLAGS) http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $< + +dist-local-check-mans-enabled: + if grep "Man generation disabled" $(man_MANS) >/dev/null; then $(RM) $(man_MANS); fi + +else + +$(man_MANS): + echo Man generation disabled. Creating dummy $@. Configure with --enable-man to enable it. + echo Man generation disabled. Remove this file, configure with --enable-man, and rebuild > $@ + + +dist-local-check-mans-enabled: + echo "*** --enable-man must be used in order to make dist" + false + +endif + +MAINTAINERCLEANFILES = $(man_MANS) $(BUILT_SOURCES) + +EXTRA_DIST += $(man_MANS) + +dist-hook-local: dist-local-check-mans-enabled all-local + +gtk-docs-clean: clean + cd $(srcdir) && rm -rf xml html + +-include $(top_srcdir)/git.mk diff --git a/docs/reference/gdk-pixbuf/Makefile.in b/docs/reference/gdk-pixbuf/Makefile.in new file mode 100644 index 0000000..45269e7 --- /dev/null +++ b/docs/reference/gdk-pixbuf/Makefile.in @@ -0,0 +1,1017 @@ +# Makefile.in generated by automake 1.12.2 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994-2012 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@ + +# GTK+ - The GIMP Toolkit + +# -*- mode: makefile -*- + +#################################### +# Everything below here is generic # +#################################### +VPATH = @srcdir@ +am__make_dryrun = \ + { \ + am__dry=no; \ + case $$MAKEFLAGS in \ + *\\[\ \ ]*) \ + echo 'am--echo: ; @echo "AM" OK' | $(MAKE) -f - 2>/dev/null \ + | grep '^AM OK$$' >/dev/null || am__dry=yes;; \ + *) \ + for am__flg in $$MAKEFLAGS; do \ + case $$am__flg in \ + *=*|--*) ;; \ + *n*) am__dry=yes; break;; \ + esac; \ + done;; \ + esac; \ + test $$am__dry = yes; \ + } +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +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@ +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ + $(srcdir)/version.xml.in $(top_srcdir)/Makefile.decl \ + $(top_srcdir)/gtk-doc.make +subdir = docs/reference/gdk-pixbuf +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/gettext.m4 \ + $(top_srcdir)/m4/gtk-doc.m4 $(top_srcdir)/m4/iconv.m4 \ + $(top_srcdir)/m4/intlmacosx.m4 \ + $(top_srcdir)/m4/introspection.m4 $(top_srcdir)/m4/lib-ld.m4 \ + $(top_srcdir)/m4/lib-link.m4 $(top_srcdir)/m4/lib-prefix.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/m4/nls.m4 \ + $(top_srcdir)/m4/po.m4 $(top_srcdir)/m4/progtest.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(install_sh) -d +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = version.xml +CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = +SOURCES = +DIST_SOURCES = +am__can_run_installinfo = \ + case $$AM_UPDATE_INFO_DIR in \ + n|no|NO) false;; \ + *) (install-info --version) >/dev/null 2>&1;; \ + esac +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 = f=`echo $$p | sed -e 's|^.*/||'`; +am__install_max = 40 +am__nobase_strip_setup = \ + srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'` +am__nobase_strip = \ + for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||" +am__nobase_list = $(am__nobase_strip_setup); \ + for p in $$list; do echo "$$p $$p"; done | \ + sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \ + $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \ + if (++n[$$2] == $(am__install_max)) \ + { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \ + END { for (dir in files) print dir, files[dir] }' +am__base_list = \ + sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ + sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g' +am__uninstall_files_from_dir = { \ + test -z "$$files" \ + || { test ! -d "$$dir" && test ! -f "$$dir" && test ! -r "$$dir"; } \ + || { echo " ( cd '$$dir' && rm -f" $$files ")"; \ + $(am__cd) "$$dir" && rm -f $$files; }; \ + } +man1dir = $(mandir)/man1 +am__installdirs = "$(DESTDIR)$(man1dir)" +NROFF = nroff +MANS = $(man_MANS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ +AR = @AR@ +AS = @AS@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +BASE_DEPENDENCIES_CFLAGS = @BASE_DEPENDENCIES_CFLAGS@ +BASE_DEPENDENCIES_LIBS = @BASE_DEPENDENCIES_LIBS@ +CC = @CC@ +CCAS = @CCAS@ +CCASDEPMODE = @CCASDEPMODE@ +CCASFLAGS = @CCASFLAGS@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DB2HTML = @DB2HTML@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DLLTOOL = @DLLTOOL@ +DSYMUTIL = @DSYMUTIL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +EXE_MANIFEST_ARCHITECTURE = @EXE_MANIFEST_ARCHITECTURE@ +FGREP = @FGREP@ +GDK_PIXBUF_API_VERSION = @GDK_PIXBUF_API_VERSION@ +GDK_PIXBUF_BINARY_VERSION = @GDK_PIXBUF_BINARY_VERSION@ +GDK_PIXBUF_CSOURCE = @GDK_PIXBUF_CSOURCE@ +GDK_PIXBUF_DEP_CFLAGS = @GDK_PIXBUF_DEP_CFLAGS@ +GDK_PIXBUF_DEP_LIBS = @GDK_PIXBUF_DEP_LIBS@ +GDK_PIXBUF_EXTRA_CFLAGS = @GDK_PIXBUF_EXTRA_CFLAGS@ +GDK_PIXBUF_EXTRA_LIBS = @GDK_PIXBUF_EXTRA_LIBS@ +GDK_PIXBUF_LINK_FLAGS = @GDK_PIXBUF_LINK_FLAGS@ +GDK_PIXBUF_MAJOR = @GDK_PIXBUF_MAJOR@ +GDK_PIXBUF_MICRO = @GDK_PIXBUF_MICRO@ +GDK_PIXBUF_MINOR = @GDK_PIXBUF_MINOR@ +GDK_PIXBUF_PACKAGES = @GDK_PIXBUF_PACKAGES@ +GDK_PIXBUF_VERSION = @GDK_PIXBUF_VERSION@ +GDK_PIXBUF_XLIB_DEP_CFLAGS = @GDK_PIXBUF_XLIB_DEP_CFLAGS@ +GDK_PIXBUF_XLIB_DEP_LIBS = @GDK_PIXBUF_XLIB_DEP_LIBS@ +GETTEXT_MACRO_VERSION = @GETTEXT_MACRO_VERSION@ +GETTEXT_PACKAGE = @GETTEXT_PACKAGE@ +GLIB_CFLAGS = @GLIB_CFLAGS@ +GLIB_COMPILE_RESOURCES = @GLIB_COMPILE_RESOURCES@ +GLIB_GENMARSHAL = @GLIB_GENMARSHAL@ +GLIB_LIBS = @GLIB_LIBS@ +GLIB_MKENUMS = @GLIB_MKENUMS@ +GMSGFMT = @GMSGFMT@ +GMSGFMT_015 = @GMSGFMT_015@ +GOBJECT_QUERY = @GOBJECT_QUERY@ +GREP = @GREP@ +GTKDOC_CHECK = @GTKDOC_CHECK@ +GTKDOC_DEPS_CFLAGS = @GTKDOC_DEPS_CFLAGS@ +GTKDOC_DEPS_LIBS = @GTKDOC_DEPS_LIBS@ +GTKDOC_MKPDF = @GTKDOC_MKPDF@ +GTKDOC_REBASE = @GTKDOC_REBASE@ +GTK_UPDATE_ICON_CACHE = @GTK_UPDATE_ICON_CACHE@ +HTML_DIR = @HTML_DIR@ +INCLUDED_LOADER_DEFINE = @INCLUDED_LOADER_DEFINE@ +INCLUDED_LOADER_OBJ = @INCLUDED_LOADER_OBJ@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +INTLLIBS = @INTLLIBS@ +INTL_MACOSX_LIBS = @INTL_MACOSX_LIBS@ +INTROSPECTION_CFLAGS = @INTROSPECTION_CFLAGS@ +INTROSPECTION_COMPILER = @INTROSPECTION_COMPILER@ +INTROSPECTION_GENERATE = @INTROSPECTION_GENERATE@ +INTROSPECTION_GIRDIR = @INTROSPECTION_GIRDIR@ +INTROSPECTION_LIBS = @INTROSPECTION_LIBS@ +INTROSPECTION_MAKEFILE = @INTROSPECTION_MAKEFILE@ +INTROSPECTION_SCANNER = @INTROSPECTION_SCANNER@ +INTROSPECTION_TYPELIBDIR = @INTROSPECTION_TYPELIBDIR@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBICONV = @LIBICONV@ +LIBINTL = @LIBINTL@ +LIBJASPER = @LIBJASPER@ +LIBJPEG = @LIBJPEG@ +LIBOBJS = @LIBOBJS@ +LIBPNG = @LIBPNG@ +LIBS = @LIBS@ +LIBTIFF = @LIBTIFF@ +LIBTOOL = @LIBTOOL@ +LIBTOOL_EXPORT_OPTIONS = @LIBTOOL_EXPORT_OPTIONS@ +LIB_EXE_MACHINE_FLAG = @LIB_EXE_MACHINE_FLAG@ +LIPO = @LIPO@ +LN_S = @LN_S@ +LTLIBICONV = @LTLIBICONV@ +LTLIBINTL = @LTLIBINTL@ +LTLIBOBJS = @LTLIBOBJS@ +LT_CURRENT_MINUS_AGE = @LT_CURRENT_MINUS_AGE@ +LT_VERSION_INFO = @LT_VERSION_INFO@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MANIFEST_TOOL = @MANIFEST_TOOL@ +MATH_LIB = @MATH_LIB@ +MKDIR_P = @MKDIR_P@ +MSGFMT = @MSGFMT@ +MSGFMT_015 = @MSGFMT_015@ +MSGMERGE = @MSGMERGE@ +NM = @NM@ +NMEDIT = @NMEDIT@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +OTOOL = @OTOOL@ +OTOOL64 = @OTOOL64@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ +PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ +PNG_DEP_CFLAGS_PACKAGES = @PNG_DEP_CFLAGS_PACKAGES@ +POSUB = @POSUB@ +RANLIB = @RANLIB@ +REBUILD = @REBUILD@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +USE_NLS = @USE_NLS@ +VERSION = @VERSION@ +WINDRES = @WINDRES@ +XGETTEXT = @XGETTEXT@ +XGETTEXT_015 = @XGETTEXT_015@ +XGETTEXT_EXTRA_OPTIONS = @XGETTEXT_EXTRA_OPTIONS@ +XSLTPROC = @XSLTPROC@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +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@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +ms_librarian = @ms_librarian@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +GTESTER = gtester # in $PATH for non-GLIB packages +GTESTER_REPORT = gtester-report # in $PATH for non-GLIB packages + +# Other files to distribute +EXTRA_DIST = $(HTML_IMAGES) $(SETUP_FILES) version.xml.in \ + composite.png composite.dia apple-red-1a.png apple-red-2c.png \ + gnome-gmush-1.png $(man_MANS) +TEST_PROGS = + +### testing rules + +# Xvfb based test rules +XVFB = Xvfb -ac -noreset -screen 0 800x600x16 +XIDS = 101 102 103 104 105 106 107 197 199 211 223 227 293 307 308 309 310 311 \ + 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 \ + 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 \ + 1008 1009 4703 4721 4723 4729 4733 4751 9973 9974 9975 9976 9977 9978 9979 \ + 9980 9981 9982 9983 9984 9985 9986 9987 9988 9989 9990 9991 9992 9993 9994 \ + 9995 9996 9997 9998 9999 + +SKIP_GDKTARGET = \ + test "$(gdktarget)" != "x11" \ + && echo "Gtk+Tests:INFO: Skipping GUI tests for non-X11 target." + +XVFB_START = \ + ${XVFB} -help 2>/dev/null 1>&2 \ + && XID=`for id in $(XIDS) ; do test -e /tmp/.X$$id-lock || { echo $$id; exit 0; }; done; exit 1` \ + && { ${XVFB} :$$XID -screen 0 800x600x16 -nolisten tcp -auth /dev/null >/dev/null 2>&1 & \ + trap "kill -15 $$! " 0 HUP INT QUIT TRAP USR1 PIPE TERM ; } \ + || { echo "Gtk+Tests:ERROR: Failed to start Xvfb environment for X11 target tests."; exit 1; } \ + && DISPLAY=:$$XID && export DISPLAY + +AUTOMAKE_OPTIONS = 1.6 + +# The name of the module. +DOC_MODULE = gdk-pixbuf + +# The top-level SGML file. +DOC_MAIN_SGML_FILE = gdk-pixbuf.xml + +# Extra options to supply to gtkdoc-scan +SCAN_OPTIONS = \ + --source-dir=../../../contrib/gdk-pixbuf-xlib \ + --deprecated-guards="GDK_PIXBUF_ENABLE_BROKEN|GDK_PIXBUF_DISABLE_DEPRECATED" + + +# The directory containing the source code. Relative to $(srcdir) +DOC_SOURCE_DIR = ../../../gdk-pixbuf + +# Used for dependencies +HFILE_GLOB = $(top_srcdir)/gdk-pixbuf/*.h $(top_srcdir)/contrib/gdk-pixbuf-xlib/*.h +CFILE_GLOB = $(top_srcdir)/gdk-pixbuf/*.c $(top_srcdir)/contrib/gdk-pixbuf-xlib/*.c + +# Header files to ignore when scanning +IGNORE_HFILES = \ + pixops \ + gdk-pixbuf-alias.h \ + gdk-pixbuf-marshal.h \ + gdk-pixbuf-i18n.h \ + gdk-pixbuf-private.h \ + gdk-pixbuf-xlib-private.h \ + io-gif-animation.h \ + io-ani-animation.h \ + xpm-color-table.h \ + test-images.h + +INCLUDES = \ + -I$(top_srcdir) \ + -I$(top_builddir) \ + $(GDK_PIXBUF_DEBUG_FLAGS) \ + $(GDK_PIXBUF_DEP_CFLAGS) + +GTKDOC_LIBS = \ + $(top_builddir)/gdk-pixbuf/libgdk_pixbuf-$(GDK_PIXBUF_API_VERSION).la \ + $(GDK_PIXBUF_DEP_LIBS) + + +# Extra options to supply to gtkdoc-mkdb +MKDB_OPTIONS = \ + --main-sgml-file=$(DOC_MAIN_SGML_FILE) \ + --sgml-mode \ + --source-dir=../../../contrib/gdk-pixbuf-xlib \ + --output-format=xml \ + --name-space=gdk_pixbuf + + +# Extra SGML files that are included by DOC_MAIN_SGML_FILE +content_files = \ + version.xml \ + gdk-pixbuf-from-drawables.xml \ + gdk-pixbuf-rendering.xml \ + gdk-pixbuf.xml \ + gdk-pixbuf-csource.xml \ + gdk-pixbuf-query-loaders.xml + + +# Images to copy into HTML directory +HTML_IMAGES = composite.png + +# Extra options to supply to gtkdoc-fixref +FIXXREF_OPTIONS = --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gobject \ + --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/glib + +@GTK_DOC_USE_LIBTOOL_FALSE@GTKDOC_CC = $(CC) $(INCLUDES) $(GTKDOC_DEPS_CFLAGS) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) +@GTK_DOC_USE_LIBTOOL_TRUE@GTKDOC_CC = $(LIBTOOL) --tag=CC --mode=compile $(CC) $(INCLUDES) $(GTKDOC_DEPS_CFLAGS) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) +@GTK_DOC_USE_LIBTOOL_FALSE@GTKDOC_LD = $(CC) $(GTKDOC_DEPS_LIBS) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) $(LDFLAGS) +@GTK_DOC_USE_LIBTOOL_TRUE@GTKDOC_LD = $(LIBTOOL) --tag=CC --mode=link $(CC) $(GTKDOC_DEPS_LIBS) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) $(LDFLAGS) +@GTK_DOC_USE_LIBTOOL_FALSE@GTKDOC_RUN = +@GTK_DOC_USE_LIBTOOL_TRUE@GTKDOC_RUN = $(LIBTOOL) --mode=execute + +# We set GPATH here; this gives us semantics for GNU make +# which are more like other make's VPATH, when it comes to +# whether a source that is a target of one rule is then +# searched for in VPATH/GPATH. +# +GPATH = $(srcdir) +TARGET_DIR = $(HTML_DIR)/$(DOC_MODULE) +SETUP_FILES = \ + $(content_files) \ + $(DOC_MAIN_SGML_FILE) \ + $(DOC_MODULE)-sections.txt \ + $(DOC_MODULE)-overrides.txt + +DOC_STAMPS = setup-build.stamp scan-build.stamp sgml-build.stamp \ + html-build.stamp pdf-build.stamp \ + sgml.stamp html.stamp pdf.stamp + +SCANOBJ_FILES = \ + $(DOC_MODULE).args \ + $(DOC_MODULE).hierarchy \ + $(DOC_MODULE).interfaces \ + $(DOC_MODULE).prerequisites \ + $(DOC_MODULE).signals + +REPORT_FILES = \ + $(DOC_MODULE)-undocumented.txt \ + $(DOC_MODULE)-undeclared.txt \ + $(DOC_MODULE)-unused.txt + +CLEANFILES = $(SCANOBJ_FILES) $(REPORT_FILES) $(DOC_STAMPS) +@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_FALSE@HTML_BUILD_STAMP = +@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_HTML_TRUE@HTML_BUILD_STAMP = html-build.stamp +@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_FALSE@PDF_BUILD_STAMP = +@ENABLE_GTK_DOC_TRUE@@GTK_DOC_BUILD_PDF_TRUE@PDF_BUILD_STAMP = pdf-build.stamp + +######################################################################## +man_MANS = \ + gdk-pixbuf-csource.1 \ + gdk-pixbuf-query-loaders.1 + +@ENABLE_MAN_TRUE@XSLTPROC_FLAGS = \ +@ENABLE_MAN_TRUE@ --nonet \ +@ENABLE_MAN_TRUE@ --stringparam man.output.quietly 1 \ +@ENABLE_MAN_TRUE@ --stringparam funcsynopsis.style ansi \ +@ENABLE_MAN_TRUE@ --stringparam man.th.extra1.suppress 1 \ +@ENABLE_MAN_TRUE@ --stringparam man.authors.section.enabled 0 \ +@ENABLE_MAN_TRUE@ --stringparam man.copyright.section.enabled 0 + +MAINTAINERCLEANFILES = $(man_MANS) $(BUILT_SOURCES) +all: all-am + +.SUFFIXES: +.SUFFIXES: .1 .xml +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/Makefile.decl $(top_srcdir)/gtk-doc.make $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign docs/reference/gdk-pixbuf/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --foreign docs/reference/gdk-pixbuf/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_srcdir)/Makefile.decl $(top_srcdir)/gtk-doc.make: + +$(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 +$(am__aclocal_m4_deps): +version.xml: $(top_builddir)/config.status $(srcdir)/version.xml.in + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs +install-man1: $(man_MANS) + @$(NORMAL_INSTALL) + @list1=''; \ + list2='$(man_MANS)'; \ + test -n "$(man1dir)" \ + && test -n "`echo $$list1$$list2`" \ + || exit 0; \ + echo " $(MKDIR_P) '$(DESTDIR)$(man1dir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(man1dir)" || exit 1; \ + { for i in $$list1; do echo "$$i"; done; \ + if test -n "$$list2"; then \ + for i in $$list2; do echo "$$i"; done \ + | sed -n '/\.1[a-z]*$$/p'; \ + fi; \ + } | while read p; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ + sed 'N;N;s,\n, ,g' | { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst" || exit $$?; \ + fi; \ + done; \ + for i in $$list; do echo "$$i"; done | $(am__base_list) | \ + while read files; do \ + test -z "$$files" || { \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man1dir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(man1dir)" || exit $$?; }; \ + done; } + +uninstall-man1: + @$(NORMAL_UNINSTALL) + @list=''; test -n "$(man1dir)" || exit 0; \ + files=`{ for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.1[a-z]*$$/p'; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + dir='$(DESTDIR)$(man1dir)'; $(am__uninstall_files_from_dir) +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + +cscope cscopelist: + + +distdir: $(DISTFILES) + @list='$(MANS)'; if test -n "$$list"; then \ + list=`for p in $$list; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \ + if test -n "$$list" && \ + grep 'ab help2man is required to generate this page' $$list >/dev/null; then \ + echo "error: found man pages containing the 'missing help2man' replacement text:" >&2; \ + grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/ /' >&2; \ + echo " to fix them, install help2man, remove and regenerate the man pages;" >&2; \ + echo " typically 'make maintainer-clean' will remove them" >&2; \ + exit 1; \ + else :; fi; \ + else :; fi + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$(top_distdir)" distdir="$(distdir)" \ + dist-hook +check-am: all-am + $(MAKE) $(AM_MAKEFLAGS) check-local +check: check-am +all-am: Makefile $(MANS) all-local +installdirs: + for dir in "$(DESTDIR)$(man1dir)"; 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: + if test -z '$(STRIP)'; then \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + install; \ + else \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \ + fi +mostlyclean-generic: + +clean-generic: + -test -z "$(CLEANFILES)" || rm -f $(CLEANFILES) + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." + -test -z "$(MAINTAINERCLEANFILES)" || rm -f $(MAINTAINERCLEANFILES) +clean: clean-am + +clean-am: clean-generic clean-libtool clean-local mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-local + +dvi: dvi-am + +dvi-am: + +html: html-am + +html-am: + +info: info-am + +info-am: + +install-data-am: install-data-local install-man + +install-dvi: install-dvi-am + +install-dvi-am: + +install-exec-am: + +install-html: install-html-am + +install-html-am: + +install-info: install-info-am + +install-info-am: + +install-man: install-man1 + +install-pdf: install-pdf-am + +install-pdf-am: + +install-ps: install-ps-am + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic \ + maintainer-clean-local + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-local uninstall-man + +uninstall-man: uninstall-man1 + +.MAKE: check-am install-am install-strip + +.PHONY: all all-am all-local check check-am check-local clean \ + clean-generic clean-libtool clean-local dist-hook distclean \ + distclean-generic distclean-libtool distclean-local distdir \ + dvi dvi-am html html-am info info-am install install-am \ + install-data install-data-am install-data-local install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-man1 install-pdf install-pdf-am install-ps \ + install-ps-am install-strip installcheck installcheck-am \ + installdirs maintainer-clean maintainer-clean-generic \ + maintainer-clean-local mostlyclean mostlyclean-generic \ + mostlyclean-libtool pdf pdf-am ps ps-am uninstall uninstall-am \ + uninstall-local uninstall-man uninstall-man1 + +# call as: $(XVFB_START) && someprogram + +# test: run all tests in cwd and subdirs +test: ${TEST_PROGS} + @$(SKIP_GDKTARGET) || test -z "${TEST_PROGS}" || { \ + $(XVFB_START) && { set -e; ${GTESTER} --verbose ${TEST_PROGS}; }; \ + } + @ for subdir in $(SUBDIRS) ; do \ + test "$$subdir" = "." -o "$$subdir" = "po" -o "$$subdir" = "po-properties" || \ + ( cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $@ ) || exit $? ; \ + done +# test-report: run tests in subdirs and generate report +# perf-report: run tests in subdirs with -m perf and generate report +# full-report: like test-report: with -m perf and -m slow +test-report perf-report full-report: ${TEST_PROGS} + @ ignore_logdir=true ; \ + if test -z "$$GTESTER_LOGDIR" ; then \ + GTESTER_LOGDIR=`mktemp -d "\`pwd\`/.testlogs-XXXXXX"`; export GTESTER_LOGDIR ; \ + ignore_logdir=false ; \ + fi ; \ + for subdir in $(SUBDIRS) ; do \ + test "$$subdir" = "." -o "$$subdir" = "po" -o "$$subdir" = "po-properties" || \ + ( cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $@ ) || exit $? ; \ + done ; \ + $(SKIP_GDKTARGET) || test -z "${TEST_PROGS}" || { \ + case $@ in \ + test-report) test_options="-k";; \ + perf-report) test_options="-k -m=perf";; \ + full-report) test_options="-k -m=perf -m=slow";; \ + esac ; \ + $(XVFB_START) && { \ + set -e; \ + if test -z "$$GTESTER_LOGDIR" ; then \ + ${GTESTER} --verbose $$test_options -o test-report.xml ${TEST_PROGS} ; \ + elif test -n "${TEST_PROGS}" ; then \ + ${GTESTER} --verbose $$test_options -o `mktemp "$$GTESTER_LOGDIR/log-XXXXXX"` ${TEST_PROGS} ; \ + fi ; \ + }; \ + }; \ + $$ignore_logdir || { \ + echo '<?xml version="1.0"?>' > $@.xml ; \ + echo '<report-collection>' >> $@.xml ; \ + for lf in `ls -L "$$GTESTER_LOGDIR"/.` ; do \ + sed '1,1s/^<?xml\b[^>?]*?>//' <"$$GTESTER_LOGDIR"/"$$lf" >> $@.xml ; \ + done ; \ + echo >> $@.xml ; \ + echo '</report-collection>' >> $@.xml ; \ + rm -rf "$$GTESTER_LOGDIR"/ ; \ + ${GTESTER_REPORT} --version 2>/dev/null 1>&2 ; test "$$?" != 0 || ${GTESTER_REPORT} $@.xml >$@.html ; \ + } +.PHONY: test test-report perf-report full-report +# run make test as part of make check +check-local: test + +@ENABLE_GTK_DOC_TRUE@all-local: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) +@ENABLE_GTK_DOC_FALSE@all-local: + +docs: $(HTML_BUILD_STAMP) $(PDF_BUILD_STAMP) + +$(REPORT_FILES): sgml-build.stamp + +#### setup #### + +setup-build.stamp: + -@if test "$(abs_srcdir)" != "$(abs_builddir)" ; then \ + echo ' DOC Preparing build'; \ + files=`echo $(SETUP_FILES) $(expand_content_files) $(DOC_MODULE).types`; \ + if test "x$$files" != "x" ; then \ + for file in $$files ; do \ + test -f $(abs_srcdir)/$$file && \ + cp -pu $(abs_srcdir)/$$file $(abs_builddir)/ || true; \ + done; \ + fi; \ + fi + @touch setup-build.stamp + +#### scan #### + +scan-build.stamp: $(HFILE_GLOB) $(CFILE_GLOB) + @echo ' DOC Scanning header files' + @_source_dir='' ; \ + for i in $(DOC_SOURCE_DIR) ; do \ + _source_dir="$${_source_dir} --source-dir=$$i" ; \ + done ; \ + gtkdoc-scan --module=$(DOC_MODULE) --ignore-headers="$(IGNORE_HFILES)" $${_source_dir} $(SCAN_OPTIONS) $(EXTRA_HFILES) + @if grep -l '^..*$$' $(DOC_MODULE).types > /dev/null 2>&1 ; then \ + echo " DOC Introspecting gobjects"; \ + scanobj_options=""; \ + gtkdoc-scangobj 2>&1 --help | grep >/dev/null "\-\-verbose"; \ + if test "$(?)" = "0"; then \ + if test "x$(V)" = "x1"; then \ + scanobj_options="--verbose"; \ + fi; \ + fi; \ + CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" RUN="$(GTKDOC_RUN)" CFLAGS="$(GTKDOC_CFLAGS) $(CFLAGS)" LDFLAGS="$(GTKDOC_LIBS) $(LDFLAGS)" \ + gtkdoc-scangobj $(SCANGOBJ_OPTIONS) $$scanobj_options --module=$(DOC_MODULE); \ + else \ + for i in $(SCANOBJ_FILES) ; do \ + test -f $$i || touch $$i ; \ + done \ + fi + @touch scan-build.stamp + +$(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt: scan-build.stamp + @true + +#### xml #### + +sgml-build.stamp: setup-build.stamp $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt $(expand_content_files) + @echo ' DOC Building XML' + @_source_dir='' ; \ + for i in $(DOC_SOURCE_DIR) ; do \ + _source_dir="$${_source_dir} --source-dir=$$i" ; \ + done ; \ + gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --expand-content-files="$(expand_content_files)" --main-sgml-file=$(DOC_MAIN_SGML_FILE) $${_source_dir} $(MKDB_OPTIONS) + @touch sgml-build.stamp + +sgml.stamp: sgml-build.stamp + @true + +#### html #### + +html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) + @echo ' DOC Building HTML' + @rm -rf html + @mkdir html + @mkhtml_options=""; \ + gtkdoc-mkhtml 2>&1 --help | grep >/dev/null "\-\-verbose"; \ + if test "$(?)" = "0"; then \ + if test "x$(V)" = "x1"; then \ + mkhtml_options="$$mkhtml_options --verbose"; \ + fi; \ + fi; \ + gtkdoc-mkhtml 2>&1 --help | grep >/dev/null "\-\-path"; \ + if test "$(?)" = "0"; then \ + mkhtml_options="$$mkhtml_options --path=\"$(abs_srcdir)\""; \ + fi; \ + cd html && gtkdoc-mkhtml $$mkhtml_options $(MKHTML_OPTIONS) $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) + -@test "x$(HTML_IMAGES)" = "x" || \ + for file in $(HTML_IMAGES) ; do \ + if test -f $(abs_srcdir)/$$file ; then \ + cp $(abs_srcdir)/$$file $(abs_builddir)/html; \ + fi; \ + if test -f $(abs_builddir)/$$file ; then \ + cp $(abs_builddir)/$$file $(abs_builddir)/html; \ + fi; \ + done; + @echo ' DOC Fixing cross-references' + @gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) + @touch html-build.stamp + +#### pdf #### + +pdf-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) + @echo ' DOC Building PDF' + @rm -f $(DOC_MODULE).pdf + @mkpdf_options=""; \ + gtkdoc-mkpdf 2>&1 --help | grep >/dev/null "\-\-verbose"; \ + if test "$(?)" = "0"; then \ + if test "x$(V)" = "x1"; then \ + mkpdf_options="$$mkpdf_options --verbose"; \ + fi; \ + fi; \ + if test "x$(HTML_IMAGES)" != "x"; then \ + for img in $(HTML_IMAGES); do \ + part=`dirname $$img`; \ + echo $$mkpdf_options | grep >/dev/null "\-\-imgdir=$$part "; \ + if test $$? != 0; then \ + mkpdf_options="$$mkpdf_options --imgdir=$$part"; \ + fi; \ + done; \ + fi; \ + gtkdoc-mkpdf --path="$(abs_srcdir)" $$mkpdf_options $(DOC_MODULE) $(DOC_MAIN_SGML_FILE) $(MKPDF_OPTIONS) + @touch pdf-build.stamp + +############## + +clean-local: + @rm -f *~ *.bak + @rm -rf .libs + +distclean-local: + @rm -rf xml html $(REPORT_FILES) $(DOC_MODULE).pdf \ + $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt + @if test "$(abs_srcdir)" != "$(abs_builddir)" ; then \ + rm -f $(SETUP_FILES) $(expand_content_files) $(DOC_MODULE).types; \ + fi + +maintainer-clean-local: clean + @rm -rf xml html + +install-data-local: + @installfiles=`echo $(builddir)/html/*`; \ + if test "$$installfiles" = '$(builddir)/html/*'; \ + then echo 1>&2 'Nothing to install' ; \ + else \ + if test -n "$(DOC_MODULE_VERSION)"; then \ + installdir="$(DESTDIR)$(TARGET_DIR)-$(DOC_MODULE_VERSION)"; \ + else \ + installdir="$(DESTDIR)$(TARGET_DIR)"; \ + fi; \ + $(mkinstalldirs) $${installdir} ; \ + for i in $$installfiles; do \ + echo ' $(INSTALL_DATA) '$$i ; \ + $(INSTALL_DATA) $$i $${installdir}; \ + done; \ + if test -n "$(DOC_MODULE_VERSION)"; then \ + mv -f $${installdir}/$(DOC_MODULE).devhelp2 \ + $${installdir}/$(DOC_MODULE)-$(DOC_MODULE_VERSION).devhelp2; \ + fi; \ + $(GTKDOC_REBASE) --relative --dest-dir=$(DESTDIR) --html-dir=$${installdir}; \ + fi + +uninstall-local: + @if test -n "$(DOC_MODULE_VERSION)"; then \ + installdir="$(DESTDIR)$(TARGET_DIR)-$(DOC_MODULE_VERSION)"; \ + else \ + installdir="$(DESTDIR)$(TARGET_DIR)"; \ + fi; \ + rm -rf $${installdir} + +# +# Require gtk-doc when making dist +# +@ENABLE_GTK_DOC_TRUE@dist-check-gtkdoc: +@ENABLE_GTK_DOC_FALSE@dist-check-gtkdoc: +@ENABLE_GTK_DOC_FALSE@ @echo "*** gtk-doc must be installed and enabled in order to make dist" +@ENABLE_GTK_DOC_FALSE@ @false + +dist-hook: dist-check-gtkdoc dist-hook-local + @mkdir $(distdir)/html + @cp ./html/* $(distdir)/html + @-cp ./$(DOC_MODULE).pdf $(distdir)/ + @-cp ./$(DOC_MODULE).types $(distdir)/ + @-cp ./$(DOC_MODULE)-sections.txt $(distdir)/ + @cd $(distdir) && rm -f $(DISTCLEANFILES) + @$(GTKDOC_REBASE) --online --relative --html-dir=$(distdir)/html + +.PHONY : dist-hook-local docs + +@ENABLE_MAN_TRUE@.xml.1: +@ENABLE_MAN_TRUE@ $(AM_V_GEN) $(XSLTPROC) $(XSLTPROC_FLAGS) http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $< + +@ENABLE_MAN_TRUE@dist-local-check-mans-enabled: +@ENABLE_MAN_TRUE@ if grep "Man generation disabled" $(man_MANS) >/dev/null; then $(RM) $(man_MANS); fi + +@ENABLE_MAN_FALSE@$(man_MANS): +@ENABLE_MAN_FALSE@ echo Man generation disabled. Creating dummy $@. Configure with --enable-man to enable it. +@ENABLE_MAN_FALSE@ echo Man generation disabled. Remove this file, configure with --enable-man, and rebuild > $@ + +@ENABLE_MAN_FALSE@dist-local-check-mans-enabled: +@ENABLE_MAN_FALSE@ echo "*** --enable-man must be used in order to make dist" +@ENABLE_MAN_FALSE@ false + +dist-hook-local: dist-local-check-mans-enabled all-local + +gtk-docs-clean: clean + cd $(srcdir) && rm -rf xml html + +-include $(top_srcdir)/git.mk + +# 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/docs/reference/gdk-pixbuf/apple-red-1a.png b/docs/reference/gdk-pixbuf/apple-red-1a.png Binary files differnew file mode 100644 index 0000000..40f1be2 --- /dev/null +++ b/docs/reference/gdk-pixbuf/apple-red-1a.png diff --git a/docs/reference/gdk-pixbuf/apple-red-2c.png b/docs/reference/gdk-pixbuf/apple-red-2c.png Binary files differnew file mode 100644 index 0000000..5c96576 --- /dev/null +++ b/docs/reference/gdk-pixbuf/apple-red-2c.png diff --git a/docs/reference/gdk-pixbuf/composite.dia b/docs/reference/gdk-pixbuf/composite.dia Binary files differnew file mode 100644 index 0000000..ad0c5a2 --- /dev/null +++ b/docs/reference/gdk-pixbuf/composite.dia diff --git a/docs/reference/gdk-pixbuf/composite.png b/docs/reference/gdk-pixbuf/composite.png Binary files differnew file mode 100644 index 0000000..1c9485c --- /dev/null +++ b/docs/reference/gdk-pixbuf/composite.png diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf-csource.1 b/docs/reference/gdk-pixbuf/gdk-pixbuf-csource.1 new file mode 100644 index 0000000..0fbdac5 --- /dev/null +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf-csource.1 @@ -0,0 +1,137 @@ +'\" t +.\" Title: gdk-pixbuf-csource +.\" Author: Tim Janik +.\" Generator: DocBook XSL Stylesheets v1.77.1 <http://docbook.sf.net/> +.\" Date: 09/17/2012 +.\" Manual: User Commands +.\" Source: gdk-pixbuf +.\" Language: English +.\" +.TH "GDK\-PIXBUF\-CSOURCE" "1" "" "gdk-pixbuf" "User Commands" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +gdk-pixbuf-csource \- C code generation utility for GdkPixbuf images +.SH "SYNOPSIS" +.HP \w'\fBgdk\-pixbuf\-csource\fR\ 'u +\fBgdk\-pixbuf\-csource\fR [OPTION...] [IMAGE] +.HP \w'\fBgdk\-pixbuf\-csource\fR\ 'u +\fBgdk\-pixbuf\-csource\fR [OPTION...] \-\-build\-list [[NAME]\ [IMAGE]...] +.SH "DESCRIPTION" +.PP + +\fBgdk\-pixbuf\-csource\fR +is a small utility that generates C code containing images, useful for compiling images directly into programs\&. +.PP + +\fBgdk\-pixbuf\-csource\fR +either takes as input one image file name to generate code for, or, using the +\fB\-\-build\-list\fR +option, a list of (\fIname\fR, +\fIimage\fR) pairs to generate code for a list of images into named variables\&. +.SH "OPTIONS" +.PP +\fB\-\-stream\fR +.RS 4 +Generate pixbuf data stream (a single string containing a serialized +GdkPixdata +structure in network byte order)\&. +.RE +.PP +\fB\-\-struct\fR +.RS 4 +Generate GdkPixdata structure (needs the +GdkPixdata +structure definition from +gdk\-pixdata\&.h)\&. +.RE +.PP +\fB\-\-macros\fR +.RS 4 +Generate *_ROWSTRIDE, *_WIDTH, *_HEIGHT, *_BYTES_PER_PIXEL and *_RLE_PIXEL_DATA or *_PIXEL_DATA macro definitions for the image\&. +.RE +.PP +\fB\-\-rle\fR +.RS 4 +Enables run\-length encoding for the generated pixel data (default)\&. +.RE +.PP +\fB\-\-raw\fR +.RS 4 +Disables run\-length encoding for the generated pixel data\&. +.RE +.PP +\fB\-\-extern\fR +.RS 4 +Generate extern symbols\&. +.RE +.PP +\fB\-\-static\fR +.RS 4 +Generate static symbols (default)\&. +.RE +.PP +\fB\-\-decoder\fR +.RS 4 +Provide a *_RUN_LENGTH_DECODE(image_buf, rle_data, size, bpp) macro definition to decode run\-length encoded image data\&. +.RE +.PP +\fB\-\-name=identifier\fR +.RS 4 +Specifies the identifier name (prefix) for the generated variables or macros (useful only if +\fB\-\-build\-list\fR +was not specified)\&. +.RE +.PP +\fB\-\-build\-list\fR +.RS 4 +Enables (\fIname\fR, +\fIimage\fR) pair parsing mode\&. +.RE +.PP +\fB\-h\fR, \fB\-\-help\fR +.RS 4 +Print brief help and exit\&. +.RE +.PP +\fB\-v\fR, \fB\-\-version\fR +.RS 4 +Print version and exit\&. +.RE +.PP +\fB\-\-g\-fatal\-warnings\fR +.RS 4 +Make warnings fatal (causes the program to abort)\&. +.RE +.SH "SEE ALSO" +.PP +The +GdkPixbuf +documentation, shipped with the Gtk+ distribution, available from +\m[blue]\fBwww\&.gtk\&.org\fR\m[]\&\s-2\u[1]\d\s+2\&. +.SH "BUGS" +.PP +The runlength encoder gets out of sync with the pixel boundaries, since it includes the rowstride padding in the encoded stream\&. Furthermore, it generates pixbufs with suboptimal rowstride in some cases\&. +.SH "NOTES" +.IP " 1." 4 +www.gtk.org +.RS 4 +\%http://www.gtk.org +.RE diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf-csource.xml b/docs/reference/gdk-pixbuf/gdk-pixbuf-csource.xml new file mode 100644 index 0000000..d9d8487 --- /dev/null +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf-csource.xml @@ -0,0 +1,177 @@ +<?xml version="1.0"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" + "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ +]> +<refentry id="gdk-pixbuf-csource"> + +<refentryinfo> +<title>gdk-pixbuf-csource</title> +<productname>gdk-pixbuf</productname> +<authorgroup> +<author> +<contrib>Developer</contrib> +<firstname>Tim</firstname> +<surname>Janik</surname> +</author> +</authorgroup> +</refentryinfo> + +<refmeta> +<refentrytitle>gdk-pixbuf-csource</refentrytitle> +<manvolnum>1</manvolnum> +<refmiscinfo class="manual">User Commands</refmiscinfo> +</refmeta> + +<refnamediv> +<refname>gdk-pixbuf-csource</refname> +<refpurpose>C code generation utility for GdkPixbuf images</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<cmdsynopsis> +<command>gdk-pixbuf-csource</command> +<arg choice="opt" rep="repeat">OPTION</arg> +<arg choice="opt">IMAGE</arg> +</cmdsynopsis> +<cmdsynopsis> +<command>gdk-pixbuf-csource</command> +<arg choice="opt" rep="repeat">OPTION</arg> +<arg choice="plain">--build-list</arg> +<arg rep="repeat"> + <arg>NAME</arg> + <arg>IMAGE</arg> +</arg> +</cmdsynopsis> +</refsynopsisdiv> + +<refsect1><title>Description</title> +<para> +<command>gdk-pixbuf-csource</command> is a small utility that generates +C code containing images, useful for compiling images directly into programs. +</para> +<para> +<command>gdk-pixbuf-csource</command> either takes as input one image file +name to generate code for, or, using the <option>--build-list</option> option, +a list of (<replaceable>name</replaceable>, <replaceable>image</replaceable>) +pairs to generate code for a list of images into named variables. +</para> +</refsect1> + +<refsect1><title>Options</title> +<variablelist> + +<varlistentry> +<term><option>--stream</option></term> +<listitem><para> +Generate pixbuf data stream (a single string containing a serialized +<structname>GdkPixdata</structname> structure in network byte order). +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--struct</option></term> +<listitem><para> +Generate GdkPixdata structure (needs the <structname>GdkPixdata</structname> +structure definition from <filename>gdk-pixdata.h</filename>). +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--macros</option></term> +<listitem><para> +Generate *_ROWSTRIDE, *_WIDTH, *_HEIGHT, *_BYTES_PER_PIXEL and +*_RLE_PIXEL_DATA or *_PIXEL_DATA macro definitions for the image. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--rle</option></term> +<listitem><para> +Enables run-length encoding for the generated pixel data (default). +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--raw</option></term> +<listitem><para> +Disables run-length encoding for the generated pixel data. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--extern</option></term> +<listitem><para> +Generate extern symbols. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--static</option></term> +<listitem><para> +Generate static symbols (default). +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--decoder</option></term> +<listitem><para> +Provide a *_RUN_LENGTH_DECODE(image_buf, rle_data, size, bpp) macro definition +to decode run-length encoded image data. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--name=identifier</option></term> +<listitem><para> +Specifies the identifier name (prefix) for the generated variables or +macros (useful only if <option>--build-list</option> was not specified). +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--build-list</option></term> +<listitem><para> +Enables (<replaceable>name</replaceable>, <replaceable>image</replaceable>) +pair parsing mode. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>-h</option>, <option>--help</option></term> +<listitem><para> +Print brief help and exit. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>-v</option>, <option>--version</option></term> +<listitem><para> +Print version and exit. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><option>--g-fatal-warnings</option></term> +<listitem><para> +Make warnings fatal (causes the program to abort). +</para></listitem> +</varlistentry> + +</variablelist> +</refsect1> + +<refsect1><title>See also</title> +<para> +The <structname>GdkPixbuf</structname> documentation, shipped with the +Gtk+ distribution, available from <ulink url="http://www.gtk.org">www.gtk.org</ulink>. +</para> +</refsect1> + +<refsect1><title>Bugs</title> +<para> +The runlength encoder gets out of sync with the pixel boundaries, since +it includes the rowstride padding in the encoded stream. Furthermore, it +generates pixbufs with suboptimal rowstride in some cases. +</para> +</refsect1> +</refentry> diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf-from-drawables.xml b/docs/reference/gdk-pixbuf/gdk-pixbuf-from-drawables.xml new file mode 100644 index 0000000..2d9f43a --- /dev/null +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf-from-drawables.xml @@ -0,0 +1,29 @@ +<?xml version="1.0"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" + "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ +]> +<refentry id="gdk-pixbuf-gdk-pixbuf-from-drawables"> +<refmeta> +<refentrytitle>Drawables to Pixbufs</refentrytitle> +<manvolnum>3</manvolnum> +<refmiscinfo>GDK-PIXBUF Library</refmiscinfo> +</refmeta> + +<refnamediv> +<refname>Drawables to Pixbufs</refname><refpurpose>Getting parts of a GDK drawable's image data into a pixbuf.</refpurpose> +</refnamediv> + +<refsect1> +<title>Description</title> + <para> + The functions to take the image data from a GDK drawable and dump it + into a pixbuf are contained in GDK, see the + <link linkend="gdk-Pixbufs">Pixbufs</link> section of the GDK + documentation. + </para> +</refsect1> + + + + +</refentry> diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf-overrides.txt b/docs/reference/gdk-pixbuf/gdk-pixbuf-overrides.txt new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf-overrides.txt diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf-query-loaders.1 b/docs/reference/gdk-pixbuf/gdk-pixbuf-query-loaders.1 new file mode 100644 index 0000000..cac48b6 --- /dev/null +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf-query-loaders.1 @@ -0,0 +1,74 @@ +'\" t +.\" Title: gdk-pixbuf-query-loaders +.\" Author: Owen Taylor +.\" Generator: DocBook XSL Stylesheets v1.77.1 <http://docbook.sf.net/> +.\" Date: 09/17/2012 +.\" Manual: User Commands +.\" Source: gdk-pixbuf +.\" Language: English +.\" +.TH "GDK\-PIXBUF\-QUERY\-" "1" "" "gdk-pixbuf" "User Commands" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +gdk-pixbuf-query-loaders \- GdkPixbuf loader registration utility +.SH "SYNOPSIS" +.HP \w'\fBgdk\-pixbuf\-query\-loaders\fR\ 'u +\fBgdk\-pixbuf\-query\-loaders\fR [\-\-update\-cache] [MODULE...] +.SH "DESCRIPTION" +.PP + +\fBgdk\-pixbuf\-query\-loaders\fR +collects information about loadable modules for +gdk\-pixbuf +and writes it to the default cache file location, or to +stdout\&. +.PP +If called without arguments, it looks for modules in the +gdk\-pixbuf +loader directory\&. +.PP +If called with arguments, it looks for the specified modules\&. The arguments may be absolute or relative paths\&. +.PP +Normally, the output of +\fBgdk\-pixbuf\-queryloaders\fR +is written to +\fIlibdir\fR/gdk\-pixbuf\-2\&.0/2\&.10\&.0/loaders\&.cache, where +gdk\-pixbuf +looks for it by default\&. If it is written to some other location, the environment variable +\fBGDK_PIXBUF_MODULE_FILE\fR +can be set to point +gdk\-pixbuf +at the file\&. +.SH "OPTIONS" +.PP +\-\-update\-cache +.RS 4 +Write the output to the default cache location instead of +stdout +.RE +.SH "ENVIRONMENT" +.PP +The environment variable +\fBGDK_PIXBUF_MODULEDIR\fR +can be used to specify a different loader directory\&. The default +gdk\-pixbuf +loader directory is +\fIlibdir\fR/gdk\-pixbuf\-2\&.0/\fIversion\fR/loaders\&. diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf-query-loaders.xml b/docs/reference/gdk-pixbuf/gdk-pixbuf-query-loaders.xml new file mode 100644 index 0000000..bc9523e --- /dev/null +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf-query-loaders.xml @@ -0,0 +1,79 @@ +<?xml version="1.0"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" + "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ +]> +<refentry id="gdk-pixbuf-query-loaders"> + +<refentryinfo> +<title>gdk-pixbuf-query-loaders</title> +<productname>gdk-pixbuf</productname> +<authorgroup> +<author> +<contrib>Developer</contrib> +<firstname>Owen</firstname> +<surname>Taylor</surname> +</author> +</authorgroup> +</refentryinfo> + +<refmeta> +<refentrytitle>gdk-pixbuf-query-loaders</refentrytitle> +<manvolnum>1</manvolnum> +<refmiscinfo class="manual">User Commands</refmiscinfo> +</refmeta> + +<refnamediv> +<refname>gdk-pixbuf-query-loaders</refname> +<refpurpose>GdkPixbuf loader registration utility</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<cmdsynopsis> +<command>gdk-pixbuf-query-loaders</command> +<arg choice="opt">--update-cache</arg> +<arg choice="opt" rep="repeat">MODULE</arg> +</cmdsynopsis> +</refsynopsisdiv> + +<refsect1><title>Description</title> +<para> +<command>gdk-pixbuf-query-loaders</command> collects information about +loadable modules for <application>gdk-pixbuf</application> and writes it to +the default cache file location, or to <filename>stdout</filename>. +</para> +<para> +If called without arguments, it looks for modules in the +<application>gdk-pixbuf</application> loader directory. +</para> +<para> +If called with arguments, it looks for the specified modules. The arguments +may be absolute or relative paths. +</para> +<para> +Normally, the output of <command>gdk-pixbuf-queryloaders</command> is written +to <filename><replaceable>libdir</replaceable>/gdk-pixbuf-2.0/2.10.0/loaders.cache</filename>, where <application>gdk-pixbuf</application> looks for it by default. If it is written to some other +location, the environment variable <link linkend="GDK_PIXBUF_MODULE_FILE"><envar>GDK_PIXBUF_MODULE_FILE</envar></link> +can be set to point <application>gdk-pixbuf</application> at the file. +</para> +</refsect1> + +<refsect1><title>Options</title> +<variablelist> + <varlistentry> + <term>--update-cache</term> + <listitem><para>Write the output to the default cache location instead of + <filename>stdout</filename></para></listitem> + </varlistentry> +</variablelist> +</refsect1> + +<refsect1><title>Environment</title> +<para> +The environment variable <envar>GDK_PIXBUF_MODULEDIR</envar> can be used +to specify a different loader directory. The default +<application>gdk-pixbuf</application> loader +directory is <filename><replaceable>libdir</replaceable>/gdk-pixbuf-2.0/<replaceable>version</replaceable>/loaders</filename>. +</para> +</refsect1> + +</refentry> diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf-rendering.xml b/docs/reference/gdk-pixbuf/gdk-pixbuf-rendering.xml new file mode 100644 index 0000000..336004c --- /dev/null +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf-rendering.xml @@ -0,0 +1,32 @@ +<?xml version="1.0"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" + "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ +]> +<refentry id="gdk-pixbuf-gdk-pixbuf-rendering"> +<refmeta> +<refentrytitle>Rendering</refentrytitle> +<manvolnum>3</manvolnum> +<refmiscinfo>GDK-PIXBUF Library</refmiscinfo> +</refmeta> + +<refnamediv> +<refname>Rendering</refname><refpurpose>Rendering a pixbuf to a GDK drawable.</refpurpose> +</refnamediv> + + +<refsect1> +<title>Description</title> + <para> + The functions to render pixbufs to GDK drawables are contained in + GDK, see the <link linkend="gdk-Pixbufs">Pixbufs</link> section + of the GDK documentation. + </para> +</refsect1> + + + + +</refentry> + + + diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf-sections.txt b/docs/reference/gdk-pixbuf/gdk-pixbuf-sections.txt new file mode 100644 index 0000000..5b5c58c --- /dev/null +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf-sections.txt @@ -0,0 +1,316 @@ +<INCLUDE>gdk-pixbuf/gdk-pixbuf.h</INCLUDE> + +<SECTION> +<TITLE>Versioning</TITLE> +<FILE>initialization_versions</FILE> + +<SUBSECTION> +gdk_pixbuf_version +gdk_pixbuf_major_version +gdk_pixbuf_minor_version +gdk_pixbuf_micro_version +GDK_PIXBUF_VERSION +GDK_PIXBUF_MAJOR +GDK_PIXBUF_MINOR +GDK_PIXBUF_MICRO + +<SUBSECTION Private> +GDK_PIXBUF_VAR +</SECTION> + +<SECTION> +<FILE>gdk-pixbuf</FILE> +GdkPixbufError +GDK_PIXBUF_ERROR +GdkColorspace +GdkPixbufAlphaMode +GdkPixbuf +gdk_pixbuf_get_colorspace +gdk_pixbuf_get_n_channels +gdk_pixbuf_get_has_alpha +gdk_pixbuf_get_bits_per_sample +gdk_pixbuf_get_pixels +gdk_pixbuf_get_pixels_with_length +gdk_pixbuf_get_width +gdk_pixbuf_get_height +gdk_pixbuf_get_rowstride +gdk_pixbuf_get_byte_length +gdk_pixbuf_get_option + +<SUBSECTION Standard> +GDK_TYPE_PIXBUF_ERROR +GDK_TYPE_COLORSPACE +GDK_TYPE_PIXBUF_ALPHA_MODE +GDK_PIXBUF +GDK_TYPE_PIXBUF +GDK_IS_PIXBUF + + +<SUBSECTION Private> +gdk_pixbuf_get_type +gdk_pixbuf_error_quark +gdk_colorspace_get_type +gdk_pixbuf_alpha_mode_get_type +gdk_pixbuf_error_get_type +</SECTION> + +<SECTION> +<FILE>refcounting</FILE> +gdk_pixbuf_ref +gdk_pixbuf_unref +GdkPixbufDestroyNotify +</SECTION> + +<SECTION> +<FILE>file-loading</FILE> +gdk_pixbuf_new_from_file +gdk_pixbuf_new_from_file_at_size +gdk_pixbuf_new_from_file_at_scale +gdk_pixbuf_get_file_info +gdk_pixbuf_new_from_resource +gdk_pixbuf_new_from_resource_at_scale +gdk_pixbuf_new_from_stream +gdk_pixbuf_new_from_stream_async +gdk_pixbuf_new_from_stream_finish +gdk_pixbuf_new_from_stream_at_scale +gdk_pixbuf_new_from_stream_at_scale_async +</SECTION> + +<SECTION> +<FILE>file-saving</FILE> +gdk_pixbuf_savev +gdk_pixbuf_save +GdkPixbufSaveFunc +gdk_pixbuf_save_to_callback +gdk_pixbuf_save_to_callbackv +gdk_pixbuf_save_to_buffer +gdk_pixbuf_save_to_bufferv +gdk_pixbuf_save_to_stream +gdk_pixbuf_save_to_stream_async +gdk_pixbuf_save_to_stream_finish +</SECTION> + +<SECTION> +<FILE>creating</FILE> +gdk_pixbuf_new +gdk_pixbuf_new_from_data +gdk_pixbuf_new_from_xpm_data +gdk_pixbuf_new_from_inline +gdk_pixbuf_new_subpixbuf +gdk_pixbuf_copy +</SECTION> + +<SECTION> +<INCLUDE>gdk-pixbuf/gdk-pixdata.h</INCLUDE> +<FILE>inline</FILE> +GdkPixdata +GdkPixdataType +GdkPixdataDumpType +GDK_PIXBUF_MAGIC_NUMBER +GDK_PIXDATA_HEADER_LENGTH +gdk_pixdata_from_pixbuf +gdk_pixbuf_from_pixdata +gdk_pixdata_serialize +gdk_pixdata_deserialize +gdk_pixdata_to_csource +</SECTION> + +<SECTION> +<FILE>util</FILE> +gdk_pixbuf_add_alpha +gdk_pixbuf_copy_area +gdk_pixbuf_saturate_and_pixelate +gdk_pixbuf_apply_embedded_orientation +gdk_pixbuf_fill +</SECTION> + +<SECTION> +<FILE>animation</FILE> +GdkPixbufAnimation +GdkPixbufAnimationIter +gdk_pixbuf_animation_new_from_file +gdk_pixbuf_animation_ref +gdk_pixbuf_animation_unref +gdk_pixbuf_animation_get_width +gdk_pixbuf_animation_get_height +gdk_pixbuf_animation_get_iter +gdk_pixbuf_animation_is_static_image +gdk_pixbuf_animation_get_static_image +gdk_pixbuf_animation_iter_advance +gdk_pixbuf_animation_iter_get_delay_time +gdk_pixbuf_animation_iter_on_currently_loading_frame +gdk_pixbuf_animation_iter_get_pixbuf + +<SUBSECTION> +GdkPixbufSimpleAnim +gdk_pixbuf_simple_anim_new +gdk_pixbuf_simple_anim_add_frame +gdk_pixbuf_simple_anim_set_loop +gdk_pixbuf_simple_anim_get_loop + +<SUBSECTION Standard> +GDK_PIXBUF_ANIMATION +GDK_TYPE_PIXBUF_ANIMATION +GDK_IS_PIXBUF_ANIMATION +GDK_IS_PIXBUF_ANIMATION_ITER +GDK_PIXBUF_ANIMATION_ITER +GDK_TYPE_PIXBUF_ANIMATION_ITER + +GDK_PIXBUF_SIMPLE_ANIM_GET_CLASS +GDK_IS_PIXBUF_SIMPLE_ANIM +GDK_PIXBUF_SIMPLE_ANIM_CLASS +GDK_IS_PIXBUF_SIMPLE_ANIM_CLASS +GDK_TYPE_PIXBUF_SIMPLE_ANIM +GDK_PIXBUF_SIMPLE_ANIM +GDK_TYPE_PIXBUF_SCALED_ANIM +GDK_TYPE_PIXBUF_SCALED_ANIM_ITER +<SUBSECTION Private> +gdk_pixbuf_non_anim_new + +gdk_pixbuf_animation_get_type +gdk_pixbuf_animation_iter_get_type + +gdk_pixbuf_simple_anim_get_type +gdk_pixbuf_simple_anim_iter_get_type +GdkPixbufSimpleAnimClass +gdk_pixbuf_scaled_anim_get_type +gdk_pixbuf_scaled_anim_iter_get_type +GdkPixbufScaledAnimClass +GdkPixbufScaledAnim +</SECTION> + +<SECTION> +<FILE>scaling</FILE> +GdkInterpType +gdk_pixbuf_scale_simple +gdk_pixbuf_scale +gdk_pixbuf_composite_color_simple +gdk_pixbuf_composite +gdk_pixbuf_composite_color +GdkPixbufRotation +gdk_pixbuf_rotate_simple +gdk_pixbuf_flip + +<SUBSECTION Standard> +GDK_TYPE_INTERP_TYPE +GDK_TYPE_PIXBUF_ROTATION + +<SUBSECTION Private> +gdk_interp_type_get_type +gdk_pixbuf_rotation_get_type +</SECTION> + +<SECTION> +<FILE>gdk-pixbuf-loader</FILE> +<TITLE>GdkPixbufLoader</TITLE> +GdkPixbufLoader +gdk_pixbuf_loader_new +gdk_pixbuf_loader_new_with_type +gdk_pixbuf_loader_new_with_mime_type +gdk_pixbuf_loader_get_format +gdk_pixbuf_loader_write +gdk_pixbuf_loader_set_size +gdk_pixbuf_loader_get_pixbuf +gdk_pixbuf_loader_get_animation +gdk_pixbuf_loader_close +<SUBSECTION Standard> +GDK_PIXBUF_LOADER +GDK_PIXBUF_LOADER_GET_CLASS +GDK_TYPE_PIXBUF_LOADER +GDK_IS_PIXBUF_LOADER +GDK_PIXBUF_LOADER_CLASS +GDK_IS_PIXBUF_LOADER_CLASS +<SUBSECTION Private> +GdkPixbufLoaderClass +gdk_pixbuf_loader_get_type +</SECTION> + +<SECTION> +<TITLE>Module Interface</TITLE> +<FILE>module_interface</FILE> +gdk_pixbuf_set_option +gdk_pixbuf_get_formats +gdk_pixbuf_format_copy +gdk_pixbuf_format_free +gdk_pixbuf_format_get_name +gdk_pixbuf_format_get_description +gdk_pixbuf_format_get_mime_types +gdk_pixbuf_format_get_extensions +gdk_pixbuf_format_is_writable +gdk_pixbuf_format_is_scalable +gdk_pixbuf_format_is_disabled +gdk_pixbuf_format_set_disabled +gdk_pixbuf_format_get_license +GdkPixbufFormat +GdkPixbufFormatFlags +GdkPixbufModulePattern +GdkPixbufModuleFillVtableFunc +GdkPixbufModuleFillInfoFunc +GdkPixbufModuleSizeFunc +GdkPixbufModulePreparedFunc +GdkPixbufModuleUpdatedFunc +GdkPixbufModule + +<SUBSECTION Animation> +GdkPixbufAnimationClass +GdkPixbufAnimationIterClass + +<SUBSECTION Standard> +GDK_PIXBUF_ANIMATION_GET_CLASS +GDK_IS_PIXBUF_ANIMATION_ITER_CLASS +GDK_PIXBUF_ANIMATION_ITER_CLASS +GDK_IS_PIXBUF_ANIMATION_CLASS +GDK_PIXBUF_ANIMATION_ITER_GET_CLASS +GDK_PIXBUF_ANIMATION_CLASS + +<SUBSECTION Private> +gdk_pixbuf_format_get_type +</SECTION> + +<SECTION> +<FILE>gdk-pixbuf-xlib-init</FILE> +gdk_pixbuf_xlib_init +gdk_pixbuf_xlib_init_with_depth +</SECTION> + +<SECTION> +<FILE>gdk-pixbuf-xlib-rendering</FILE> +gdk_pixbuf_xlib_render_threshold_alpha +gdk_pixbuf_xlib_render_to_drawable +gdk_pixbuf_xlib_render_to_drawable_alpha +gdk_pixbuf_xlib_render_pixmap_and_mask +</SECTION> + +<SECTION> +<FILE>gdk-pixbuf-xlib-from-drawables</FILE> +gdk_pixbuf_xlib_get_from_drawable +</SECTION> + +<SECTION> +<FILE>gdk-pixbuf-xlib-rgb</FILE> +XlibRgbCmap +XlibRgbDither +xlib_rgb_init +xlib_rgb_init_with_depth +xlib_rgb_xpixel_from_rgb +xlib_rgb_gc_set_foreground +xlib_rgb_gc_set_background +xlib_draw_rgb_image +xlib_draw_rgb_image_dithalign +xlib_draw_rgb_32_image +xlib_draw_gray_image +xlib_rgb_cmap_new +xlib_rgb_cmap_free +xlib_draw_indexed_image +xlib_rgb_ditherable +xlib_rgb_set_verbose +xlib_rgb_set_install +xlib_rgb_set_min_colors +xlib_rgb_get_cmap +xlib_rgb_get_visual +xlib_rgb_get_visual_info +xlib_rgb_get_depth +xlib_rgb_get_display +xlib_rgb_get_screen +</SECTION> + diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf.types b/docs/reference/gdk-pixbuf/gdk-pixbuf.types new file mode 100644 index 0000000..d49e973 --- /dev/null +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf.types @@ -0,0 +1,7 @@ +#include <gdk-pixbuf/gdk-pixbuf.h> + +gdk_pixbuf_get_type +gdk_pixbuf_loader_get_type +gdk_pixbuf_animation_get_type +gdk_pixbuf_animation_iter_get_type +gdk_pixbuf_simple_anim_get_type diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf.xml b/docs/reference/gdk-pixbuf/gdk-pixbuf.xml new file mode 100644 index 0000000..41dab6e --- /dev/null +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf.xml @@ -0,0 +1,191 @@ +<?xml version="1.0"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" + "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ +<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'"> +<!ENTITY version SYSTEM "version.xml"> + +<!ENTITY gdk-pixbuf "<application>gdk-pixbuf</application>"> +<!ENTITY Imlib "<application>Imlib</application>"> +]> +<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude"> + <bookinfo> + <title>GDK-PixBuf Reference Manual</title> + <releaseinfo> + Version &version; + The latest version of this documentation can be found on-line at + <ulink role="online-location" url="http://library.gnome.org/devel/gdk-pixbuf/unstable/">http://library.gnome.org/devel/gdk-pixbuf/unstable/</ulink>. + </releaseinfo> + <authorgroup> + <author> + <firstname>Federico</firstname> + <surname>Mena Quintero</surname> + <affiliation> + <address> + <email>federico@gimp.org</email> + </address> + </affiliation> + </author> + </authorgroup> + + <copyright> + <year>2000</year> + <holder>The Free Software Foundation</holder> + </copyright> + + <legalnotice> + <para> + Permission is granted to copy, distribute and/or modify this + document under the terms of the <citetitle>GNU Free + Documentation License</citetitle>, Version 1.1 or any later + version published by the Free Software Foundation with no + Invariant Sections, no Front-Cover Texts, and no Back-Cover + Texts. You may obtain a copy of the <citetitle>GNU Free + Documentation License</citetitle> from the Free Software + Foundation by visiting <ulink type="http" + url="http://www.fsf.org">their Web site</ulink> or by writing + to: + + <address> + The Free Software Foundation, Inc., + <street>59 Temple Place</street> - Suite 330, + <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>, + <country>USA</country> + </address> + </para> + + <para> + Many of the names used by companies to distinguish their + products and services are claimed as trademarks. Where those + names appear in any GNOME documentation, and those trademarks + are made aware to the members of the GNOME Documentation + Project, the names have been printed in caps or initial caps. + </para> + </legalnotice> + </bookinfo> + + <reference> + <title>API Reference</title> + + <partintro> + <para> + This part presents the class and function reference for the + &gdk-pixbuf; library. Classes are described together with + their methods; individual functions are grouped by functional + group. + </para> + </partintro> + + <xi:include href="xml/initialization_versions.xml" /> + + <xi:include href="xml/gdk-pixbuf.xml" /> + <xi:include href="xml/refcounting.xml" /> + <xi:include href="xml/file-loading.xml" /> + <xi:include href="xml/file-saving.xml" /> + <xi:include href="xml/creating.xml" /> + <xi:include href="xml/inline.xml" /> + <xi:include href="xml/scaling.xml" /> + <xi:include href="gdk-pixbuf-rendering.xml" /> + <xi:include href="gdk-pixbuf-from-drawables.xml" /> + <xi:include href="xml/util.xml" /> + <xi:include href="xml/animation.xml" /> + + <xi:include href="xml/gdk-pixbuf-loader.xml" /> + <xi:include href="xml/module_interface.xml" /> + + <xi:include href="xml/gdk-pixbuf-xlib-init.xml" /> + <xi:include href="xml/gdk-pixbuf-xlib-rendering.xml" /> + <xi:include href="xml/gdk-pixbuf-xlib-from-drawables.xml" /> + <xi:include href="xml/gdk-pixbuf-xlib-rgb.xml" /> + </reference> + + <reference> + <title>Tools Reference</title> + + <partintro> + <para> + This part presents the tools which are shipped with the + &gdk-pixbuf; library. + </para> + </partintro> + + <xi:include href="gdk-pixbuf-csource.xml" /> + <xi:include href="gdk-pixbuf-query-loaders.xml" /> + </reference> + + <index id="api-index-full"> + <title>Index of all symbols</title> + <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include> + </index> + <index id="api-index-deprecated" role="deprecated"> + <title>Index of deprecated symbols</title> + <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include> + </index> + <index id="api-index-2-2" role="2.2"> + <title>Index of new symbols in 2.2</title> + <xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include> + </index> + <index id="api-index-2-4" role="2.4"> + <title>Index of new symbols in 2.4</title> + <xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include> + </index> + <index id="api-index-2-6" role="2.6"> + <title>Index of new symbols in 2.6</title> + <xi:include href="xml/api-index-2.6.xml"><xi:fallback /></xi:include> + </index> + <index id="api-index-2-8" role="2.8"> + <title>Index of new symbols in 2.8</title> + <xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include> + </index> + <index id="api-index-2-12" role="2.12"> + <title>Index of new symbols in 2.12</title> + <xi:include href="xml/api-index-2.12.xml"><xi:fallback /></xi:include> + </index> + <index id="api-index-2-14" role="2.14"> + <title>Index of new symbols in 2.14</title> + <xi:include href="xml/api-index-2.14.xml"><xi:fallback /></xi:include> + </index> + <index id="api-index-2-26" role="2.26"> + <title>Index of new symbols in 2.26</title> + <xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include> + </index> + + <!-- License --> + + <appendix id="license"> + <title>License</title> + + <para> + This library is free software; you can redistribute it and/or + modify it under the terms of the <citetitle>GNU Library General + Public License</citetitle> as published by the Free Software + Foundation; either version 2 of the License, or (at your option) + any later version. + </para> + + <para> + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + <citetitle>GNU Library General Public License</citetitle> for + more details. + </para> + + <para> + You may obtain a copy of the <citetitle>GNU Library General + Public License</citetitle> from the Free Software Foundation by + visiting <ulink type="http" url="http://www.fsf.org">their Web + site</ulink> or by writing to: + + <address> + Free Software Foundation, Inc. + <street>59 Temple Place</street> - Suite 330 + <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode> + <country>USA</country> + </address> + </para> + </appendix> + + <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include> + +</book> + diff --git a/docs/reference/gdk-pixbuf/gnome-gmush-1.png b/docs/reference/gdk-pixbuf/gnome-gmush-1.png Binary files differnew file mode 100644 index 0000000..9e6d829 --- /dev/null +++ b/docs/reference/gdk-pixbuf/gnome-gmush-1.png diff --git a/docs/reference/gdk-pixbuf/html/GdkPixbufLoader.html b/docs/reference/gdk-pixbuf/html/GdkPixbufLoader.html new file mode 100644 index 0000000..b0872a4 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/GdkPixbufLoader.html @@ -0,0 +1,635 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>GdkPixbufLoader</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-Animations.html" title="Animations"> +<link rel="next" href="gdk-pixbuf-Module-Interface.html" title="Module Interface"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-Animations.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-Module-Interface.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#GdkPixbufLoader.synopsis" class="shortcut">Top</a> + | + <a href="#GdkPixbufLoader.description" class="shortcut">Description</a> + | + <a href="#GdkPixbufLoader.object-hierarchy" class="shortcut">Object Hierarchy</a> + | + <a href="#GdkPixbufLoader.signals" class="shortcut">Signals</a> +</td></tr> +</table> +<div class="refentry"> +<a name="GdkPixbufLoader"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="GdkPixbufLoader.top_of_page"></a>GdkPixbufLoader</span></h2> +<p>GdkPixbufLoader — Application-driven progressive image loading.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="GdkPixbufLoader.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +struct <a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-struct" title="struct GdkPixbufLoader">GdkPixbufLoader</a>; +<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="returnvalue">GdkPixbufLoader</span></a> * <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-new" title="gdk_pixbuf_loader_new ()">gdk_pixbuf_loader_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="returnvalue">GdkPixbufLoader</span></a> * <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-new-with-type" title="gdk_pixbuf_loader_new_with_type ()">gdk_pixbuf_loader_new_with_type</a> (<em class="parameter"><code>const <span class="type">char</span> *image_type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="returnvalue">GdkPixbufLoader</span></a> * <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-new-with-mime-type" title="gdk_pixbuf_loader_new_with_mime_type ()">gdk_pixbuf_loader_new_with_mime_type</a> + (<em class="parameter"><code>const <span class="type">char</span> *mime_type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-format" title="gdk_pixbuf_loader_get_format ()">gdk_pixbuf_loader_get_format</a> (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-write" title="gdk_pixbuf_loader_write ()">gdk_pixbuf_loader_write</a> (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *buf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> count</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<span class="returnvalue">void</span> <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-set-size" title="gdk_pixbuf_loader_set_size ()">gdk_pixbuf_loader_set_size</a> (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-pixbuf" title="gdk_pixbuf_loader_get_pixbuf ()">gdk_pixbuf_loader_get_pixbuf</a> (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>); +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="returnvalue">GdkPixbufAnimation</span></a> * <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-animation" title="gdk_pixbuf_loader_get_animation ()">gdk_pixbuf_loader_get_animation</a> (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-close" title="gdk_pixbuf_loader_close ()">gdk_pixbuf_loader_close</a> (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="GdkPixbufLoader.object-hierarchy"></a><h2>Object Hierarchy</h2> +<pre class="synopsis"> + <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> + +----GdkPixbufLoader +</pre> +</div> +<div class="refsect1"> +<a name="GdkPixbufLoader.signals"></a><h2>Signals</h2> +<pre class="synopsis"> + "<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-prepared" title='The "area-prepared" signal'>area-prepared</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a> + "<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-updated" title='The "area-updated" signal'>area-updated</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a> + "<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-closed" title='The "closed" signal'>closed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a> + "<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-size-prepared" title='The "size-prepared" signal'>size-prepared</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a> +</pre> +</div> +<div class="refsect1"> +<a name="GdkPixbufLoader.description"></a><h2>Description</h2> +<p> +<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> provides a way for applications to drive the +process of loading an image, by letting them send the image data +directly to the loader instead of having the loader read the data +from a file. Applications can use this functionality instead of +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file" title="gdk_pixbuf_new_from_file ()"><code class="function">gdk_pixbuf_new_from_file()</code></a> or <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file" title="gdk_pixbuf_animation_new_from_file ()"><code class="function">gdk_pixbuf_animation_new_from_file()</code></a> +when they need to parse image data in +small chunks. For example, it should be used when reading an +image from a (potentially) slow network connection, or when +loading an extremely large file. +</p> +<p> +To use <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> to load an image, just create a new one, +and call <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-write" title="gdk_pixbuf_loader_write ()"><code class="function">gdk_pixbuf_loader_write()</code></a> to send the data to it. When +done, <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-close" title="gdk_pixbuf_loader_close ()"><code class="function">gdk_pixbuf_loader_close()</code></a> should be called to end the stream +and finalize everything. The loader will emit three important +signals throughout the process. The first, "<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-size-prepared" title='The "size-prepared" signal'>size_prepared</a>", +will be called as soon as the image has enough information to +determine the size of the image to be used. If you want to scale +the image while loading it, you can call <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-set-size" title="gdk_pixbuf_loader_set_size ()"><code class="function">gdk_pixbuf_loader_set_size()</code></a> +in response to this signal. +</p> +<p> +The second signal, "<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-prepared" title='The "area-prepared" signal'>area_prepared</a>", +will be called as soon as the pixbuf of the desired has been +allocated. You can obtain it by calling <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-pixbuf" title="gdk_pixbuf_loader_get_pixbuf ()"><code class="function">gdk_pixbuf_loader_get_pixbuf()</code></a>. +If you want to use it, simply ref it. +In addition, no actual information will be passed in yet, so the +pixbuf can be safely filled with any temporary graphics (or an +initial color) as needed. You can also call +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-pixbuf" title="gdk_pixbuf_loader_get_pixbuf ()"><code class="function">gdk_pixbuf_loader_get_pixbuf()</code></a> later and get the same pixbuf. +</p> +<p> +The last signal, "<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-updated" title='The "area-updated" signal'>area_updated</a>" gets +called every time a region is updated. This way you can update a +partially completed image. Note that you do not know anything +about the completeness of an image from the area updated. For +example, in an interlaced image, you need to make several passes +before the image is done loading. +</p> +<p> +</p> +<div class="refsect2"> +<a name="idp5518640"></a><h3>Loading an animation</h3> +<p> +Loading an animation is almost as easy as loading an +image. Once the first "<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-prepared" title='The "area-prepared" signal'>area_prepared</a>" signal +has been emitted, you can call <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-animation" title="gdk_pixbuf_loader_get_animation ()"><code class="function">gdk_pixbuf_loader_get_animation()</code></a> +to get the <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> struct and <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-iter" title="gdk_pixbuf_animation_get_iter ()"><code class="function">gdk_pixbuf_animation_get_iter()</code></a> +to get an <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> for displaying it. +</p> +</div> +<p> +</p> +</div> +<div class="refsect1"> +<a name="GdkPixbufLoader.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="GdkPixbufLoader-struct"></a><h3>struct GdkPixbufLoader</h3> +<pre class="programlisting">struct GdkPixbufLoader;</pre> +<p> +The <span class="structname">GdkPixbufLoader</span> struct contains only private +fields. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-loader-new"></a><h3>gdk_pixbuf_loader_new ()</h3> +<pre class="programlisting"><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="returnvalue">GdkPixbufLoader</span></a> * gdk_pixbuf_loader_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +Creates a new pixbuf loader object. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf loader.</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-loader-new-with-type"></a><h3>gdk_pixbuf_loader_new_with_type ()</h3> +<pre class="programlisting"><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="returnvalue">GdkPixbufLoader</span></a> * gdk_pixbuf_loader_new_with_type (<em class="parameter"><code>const <span class="type">char</span> *image_type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Creates a new pixbuf loader object that always attempts to parse +image data as if it were an image of type <em class="parameter"><code>image_type</code></em>, instead of +identifying the type automatically. Useful if you want an error if +the image isn't the expected type, for loading image formats +that can't be reliably identified by looking at the data, or if +the user manually forces a specific type. +</p> +<p> +The list of supported image formats depends on what image loaders +are installed, but typically "png", "jpeg", "gif", "tiff" and +"xpm" are among the supported formats. To obtain the full list of +supported image formats, call <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-name" title="gdk_pixbuf_format_get_name ()"><code class="function">gdk_pixbuf_format_get_name()</code></a> on each +of the <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> structs returned by <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-get-formats" title="gdk_pixbuf_get_formats ()"><code class="function">gdk_pixbuf_get_formats()</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>image_type</code></em> :</span></p></td> +<td>name of the image format to be loaded with the image</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf loader.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-loader-new-with-mime-type"></a><h3>gdk_pixbuf_loader_new_with_mime_type ()</h3> +<pre class="programlisting"><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="returnvalue">GdkPixbufLoader</span></a> * gdk_pixbuf_loader_new_with_mime_type + (<em class="parameter"><code>const <span class="type">char</span> *mime_type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Creates a new pixbuf loader object that always attempts to parse +image data as if it were an image of mime type <em class="parameter"><code>mime_type</code></em>, instead of +identifying the type automatically. Useful if you want an error if +the image isn't the expected mime type, for loading image formats +that can't be reliably identified by looking at the data, or if +the user manually forces a specific mime type. +</p> +<p> +The list of supported mime types depends on what image loaders +are installed, but typically "image/png", "image/jpeg", "image/gif", +"image/tiff" and "image/x-xpixmap" are among the supported mime types. +To obtain the full list of supported mime types, call +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-mime-types" title="gdk_pixbuf_format_get_mime_types ()"><code class="function">gdk_pixbuf_format_get_mime_types()</code></a> on each of the <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +structs returned by <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-get-formats" title="gdk_pixbuf_get_formats ()"><code class="function">gdk_pixbuf_get_formats()</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>mime_type</code></em> :</span></p></td> +<td>the mime type to be loaded</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for an allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf loader.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.4</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-loader-get-format"></a><h3>gdk_pixbuf_loader_get_format ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * gdk_pixbuf_loader_get_format (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>);</pre> +<p> +Obtains the available information about the format of the +currently loading image file. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>loader</code></em> :</span></p></td> +<td>A pixbuf loader.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The return +value is owned by GdkPixbuf and should not be freed. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-loader-write"></a><h3>gdk_pixbuf_loader_write ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_loader_write (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *buf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> count</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +This will cause a pixbuf loader to parse the next <em class="parameter"><code>count</code></em> bytes of +an image. It will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the data was loaded successfully, +and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if an error occurred. In the latter case, the loader +will be closed, and will not accept further writes. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is +returned, <em class="parameter"><code>error</code></em> will be set to an error from the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> +or <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>loader</code></em> :</span></p></td> +<td>A pixbuf loader.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>buf</code></em> :</span></p></td> +<td>Pointer to image data. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=count]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td> +<td>Length of the <em class="parameter"><code>buf</code></em> buffer in bytes.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for errors</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the write was successful, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the loader +cannot parse the buffer.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-loader-set-size"></a><h3>gdk_pixbuf_loader_set_size ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_loader_set_size (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>);</pre> +<p> +Causes the image to be scaled while it is loaded. The desired +image size can be determined relative to the original size of +the image by calling <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-set-size" title="gdk_pixbuf_loader_set_size ()"><code class="function">gdk_pixbuf_loader_set_size()</code></a> from a +signal handler for the ::size-prepared signal. +</p> +<p> +Attempts to set the desired image size are ignored after the +emission of the ::size-prepared signal. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>loader</code></em> :</span></p></td> +<td>A pixbuf loader.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>The desired width of the image being loaded.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>The desired height of the image being loaded.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-loader-get-pixbuf"></a><h3>gdk_pixbuf_loader_get_pixbuf ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_loader_get_pixbuf (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>);</pre> +<p> +Queries the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> that a pixbuf loader is currently creating. +In general it only makes sense to call this function after the +"area-prepared" signal has been emitted by the loader; this means +that enough data has been read to know the size of the image that +will be allocated. If the loader has not received enough data via +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-write" title="gdk_pixbuf_loader_write ()"><code class="function">gdk_pixbuf_loader_write()</code></a>, then this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The +returned pixbuf will be the same in all future calls to the loader, +so simply calling <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> should be sufficient to continue +using it. Additionally, if the loader is an animation, it will +return the "static image" of the animation +(see <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-static-image" title="gdk_pixbuf_animation_get_static_image ()"><code class="function">gdk_pixbuf_animation_get_static_image()</code></a>). +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>loader</code></em> :</span></p></td> +<td>A pixbuf loader.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>The <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> that the loader is creating, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not +enough data has been read to determine how to create the image buffer. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-loader-get-animation"></a><h3>gdk_pixbuf_loader_get_animation ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="returnvalue">GdkPixbufAnimation</span></a> * gdk_pixbuf_loader_get_animation (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>);</pre> +<p> +Queries the <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> that a pixbuf loader is currently creating. +In general it only makes sense to call this function after the "area-prepared" +signal has been emitted by the loader. If the loader doesn't have enough +bytes yet (hasn't emitted the "area-prepared" signal) this function will +return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>loader</code></em> :</span></p></td> +<td>A pixbuf loader</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>The <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> that the loader is loading, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if +not enough data has been read to determine the information. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-loader-close"></a><h3>gdk_pixbuf_loader_close ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_loader_close (<em class="parameter"><code><a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Informs a pixbuf loader that no further writes with +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-write" title="gdk_pixbuf_loader_write ()"><code class="function">gdk_pixbuf_loader_write()</code></a> will occur, so that it can free its +internal loading structures. Also, tries to parse any data that +hasn't yet been parsed; if the remaining data is partial or +corrupt, an error will be returned. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned, <em class="parameter"><code>error</code></em> +will be set to an error from the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> +domains. If you're just cancelling a load rather than expecting it +to be finished, passing <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for <em class="parameter"><code>error</code></em> to ignore it is +reasonable. +</p> +<p> +Remember that this does not unref the loader, so if you plan not to +use it anymore, please <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> it. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>loader</code></em> :</span></p></td> +<td>A pixbuf loader.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if all image data written so far was successfully +passed out via the update_area signal</td> +</tr> +</tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="GdkPixbufLoader.signal-details"></a><h2>Signal Details</h2> +<div class="refsect2"> +<a name="GdkPixbufLoader-area-prepared"></a><h3>The <code class="literal">"area-prepared"</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader, + <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre> +<p> +This signal is emitted when the pixbuf loader has allocated the +pixbuf in the desired size. After this signal is emitted, +applications can call <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-pixbuf" title="gdk_pixbuf_loader_get_pixbuf ()"><code class="function">gdk_pixbuf_loader_get_pixbuf()</code></a> to fetch +the partially-loaded pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>loader</code></em> :</span></p></td> +<td>the object which received the signal.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>user data set when the signal handler was connected.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufLoader-area-updated"></a><h3>The <code class="literal">"area-updated"</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader, + <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x, + <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y, + <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width, + <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height, + <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre> +<p> +This signal is emitted when a significant area of the image being +loaded has been updated. Normally it means that a complete +scanline has been read in, but it could be a different area as +well. Applications can use this signal to know when to repaint +areas of an image that is being loaded. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>loader</code></em> :</span></p></td> +<td>the object which received the signal.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> +<td>X offset of upper-left corner of the updated area.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> +<td>Y offset of upper-left corner of the updated area.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of updated area.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of updated area.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>user data set when the signal handler was connected.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufLoader-closed"></a><h3>The <code class="literal">"closed"</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader, + <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre> +<p> +This signal is emitted when <a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-close" title="gdk_pixbuf_loader_close ()"><code class="function">gdk_pixbuf_loader_close()</code></a> is called. +It can be used by different parts of an application to receive +notification when an image loader is closed by the code that +drives it. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>loader</code></em> :</span></p></td> +<td>the object which received the signal.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>user data set when the signal handler was connected.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufLoader-size-prepared"></a><h3>The <code class="literal">"size-prepared"</code> signal</h3> +<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> *loader, + <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width, + <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height, + <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre> +<p> +This signal is emitted when the pixbuf loader has been fed the +initial amount of data that is required to figure out the size +of the image that it will create. Applications can call +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-set-size" title="gdk_pixbuf_loader_set_size ()"><code class="function">gdk_pixbuf_loader_set_size()</code></a> in response to this signal to set +the desired size to which the image should be scaled. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>loader</code></em> :</span></p></td> +<td>the object which received the signal.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>the original width of the image</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>the original height of the image</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>user data set when the signal handler was connected.</td> +</tr> +</tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="GdkPixbufLoader.see-also"></a><h2>See Also</h2> +gdk_pixbuf_new_from_file(), <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file" title="gdk_pixbuf_animation_new_from_file ()"><code class="function">gdk_pixbuf_animation_new_from_file()</code></a> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/annotation-glossary.html b/docs/reference/gdk-pixbuf/html/annotation-glossary.html new file mode 100644 index 0000000..2d102cc --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/annotation-glossary.html @@ -0,0 +1,89 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Annotation Glossary</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="license.html" title="Appendix A. License"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="license.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td> </td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a class="shortcut" href="#glsO">O</a> + | + <a class="shortcut" href="#glsS">S</a> + | + <a class="shortcut" href="#glsA">A</a> + | + <a class="shortcut" href="#glsC">C</a> + | + <a class="shortcut" href="#glsT">T</a> + | + <a class="shortcut" href="#glsA">A</a> + | + <a class="shortcut" href="#glsE">E</a> + | + <a class="shortcut" href="#glsT">T</a> + | + <a class="shortcut" href="#glsS">S</a> +</td></tr> +</table> +<div class="glossary"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="annotation-glossary"></a>Annotation Glossary</h1></div></div></div> +<a name="glsO"></a><h3 class="title">O</h3> +<dt> +<a name="annotation-glossterm-out"></a>out</dt> +<dd><p>Parameter for returning results. Default is <acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>.</p></dd> +<a name="glsS"></a><h3 class="title">S</h3> +<dt> +<a name="annotation-glossterm-scope%20async"></a>scope async</dt> +<dd><p>The callback is valid until first called.</p></dd> +<a name="glsA"></a><h3 class="title">A</h3> +<dt> +<a name="annotation-glossterm-allow-none"></a>allow-none</dt> +<dd><p>NULL is ok, both for passing and for returning.</p></dd> +<a name="glsC"></a><h3 class="title">C</h3> +<dt> +<a name="annotation-glossterm-closure"></a>closure</dt> +<dd><p>This parameter is a 'user_data', for callbacks; many bindings can pass NULL here.</p></dd> +<a name="glsT"></a><h3 class="title">T</h3> +<dt> +<a name="annotation-glossterm-transfer%20none"></a>transfer none</dt> +<dd><p>Don't free data after the code is done.</p></dd> +<a name="glsA"></a><h3 class="title">A</h3> +<dt> +<a name="annotation-glossterm-array"></a>array</dt> +<dd><p>Parameter points to an array of items.</p></dd> +<a name="glsE"></a><h3 class="title">E</h3> +<dt> +<a name="annotation-glossterm-element-type"></a>element-type</dt> +<dd><p>Generics and defining elements of containers and arrays.</p></dd> +<a name="glsT"></a><h3 class="title">T</h3> +<dt> +<a name="annotation-glossterm-transfer%20container"></a>transfer container</dt> +<dd><p>Free data container after the code is done.</p></dd> +<dt> +<a name="annotation-glossterm-transfer%20full"></a>transfer full</dt> +<dd><p>Free data after the code is done.</p></dd> +<a name="glsS"></a><h3 class="title">S</h3> +<dt> +<a name="annotation-glossterm-scope%20call"></a>scope call</dt> +<dd><p>The callback is valid only during the call to the method.</p></dd> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/api-index-2-12.html b/docs/reference/gdk-pixbuf/html/api-index-2-12.html new file mode 100644 index 0000000..34143ff --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/api-index-2-12.html @@ -0,0 +1,38 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Index of new symbols in 2.12</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="api-index-2-8.html" title="Index of new symbols in 2.8"> +<link rel="next" href="api-index-2-14.html" title="Index of new symbols in 2.14"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="api-index-2-8.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="api-index-2-14.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"><a class="shortcut" href="#idxA">A</a></td></tr> +</table> +<div class="index"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="api-index-2-12"></a>Index of new symbols in 2.12</h1></div></div></div> +<a name="idx"></a><a name="idxA"></a><h3 class="title">A</h3> +<dt> +<a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-apply-embedded-orientation" title="gdk_pixbuf_apply_embedded_orientation ()">gdk_pixbuf_apply_embedded_orientation</a>, function in <a class="link" href="gdk-pixbuf-Utilities.html" title="Utilities">Utilities</a> +</dt> +<dd></dd> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/api-index-2-14.html b/docs/reference/gdk-pixbuf/html/api-index-2-14.html new file mode 100644 index 0000000..2eaf8d7 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/api-index-2-14.html @@ -0,0 +1,51 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Index of new symbols in 2.14</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="api-index-2-12.html" title="Index of new symbols in 2.12"> +<link rel="next" href="api-index-2-26.html" title="Index of new symbols in 2.26"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="api-index-2-12.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="api-index-2-26.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a class="shortcut" href="#idxN">N</a> + | + <a class="shortcut" href="#idxS">S</a> +</td></tr> +</table> +<div class="index"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="api-index-2-14"></a>Index of new symbols in 2.14</h1></div></div></div> +<a name="idx"></a><a name="idxN"></a><h3 class="title">N</h3> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream" title="gdk_pixbuf_new_from_stream ()">gdk_pixbuf_new_from_stream</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale" title="gdk_pixbuf_new_from_stream_at_scale ()">gdk_pixbuf_new_from_stream_at_scale</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<a name="idxS"></a><h3 class="title">S</h3> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream" title="gdk_pixbuf_save_to_stream ()">gdk_pixbuf_save_to_stream</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/api-index-2-2.html b/docs/reference/gdk-pixbuf/html/api-index-2-2.html new file mode 100644 index 0000000..8fb12c3 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/api-index-2-2.html @@ -0,0 +1,113 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Index of new symbols in 2.2</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="api-index-deprecated.html" title="Index of deprecated symbols"> +<link rel="next" href="api-index-2-4.html" title="Index of new symbols in 2.4"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="api-index-deprecated.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="api-index-2-4.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a class="shortcut" href="#idxF">F</a> + | + <a class="shortcut" href="#idxG">G</a> + | + <a class="shortcut" href="#idxL">L</a> + | + <a class="shortcut" href="#idxS">S</a> +</td></tr> +</table> +<div class="index"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="api-index-2-2"></a>Index of new symbols in 2.2</h1></div></div></div> +<a name="idx"></a><a name="idxF"></a><h3 class="title">F</h3> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-description" title="gdk_pixbuf_format_get_description ()">gdk_pixbuf_format_get_description</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-extensions" title="gdk_pixbuf_format_get_extensions ()">gdk_pixbuf_format_get_extensions</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-mime-types" title="gdk_pixbuf_format_get_mime_types ()">gdk_pixbuf_format_get_mime_types</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-name" title="gdk_pixbuf_format_get_name ()">gdk_pixbuf_format_get_name</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-writable" title="gdk_pixbuf_format_is_writable ()">gdk_pixbuf_format_is_writable</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<a name="idxG"></a><h3 class="title">G</h3> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat">GdkPixbufFormat</a>, struct in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormatFlags" title="enum GdkPixbufFormatFlags">GdkPixbufFormatFlags</a>, enum in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillInfoFunc" title="GdkPixbufModuleFillInfoFunc ()">GdkPixbufModuleFillInfoFunc</a>, user_function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc" title="GdkPixbufModuleFillVtableFunc ()">GdkPixbufModuleFillVtableFunc</a>, user_function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern" title="struct GdkPixbufModulePattern">GdkPixbufModulePattern</a>, struct in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePreparedFunc" title="GdkPixbufModulePreparedFunc ()">GdkPixbufModulePreparedFunc</a>, user_function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleSizeFunc" title="GdkPixbufModuleSizeFunc ()">GdkPixbufModuleSizeFunc</a>, user_function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleUpdatedFunc" title="GdkPixbufModuleUpdatedFunc ()">GdkPixbufModuleUpdatedFunc</a>, user_function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-get-formats" title="gdk_pixbuf_get_formats ()">gdk_pixbuf_get_formats</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<a name="idxL"></a><h3 class="title">L</h3> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-format" title="gdk_pixbuf_loader_get_format ()">gdk_pixbuf_loader_get_format</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-set-size" title="gdk_pixbuf_loader_set_size ()">gdk_pixbuf_loader_set_size</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<a name="idxS"></a><h3 class="title">S</h3> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-set-option" title="gdk_pixbuf_set_option ()">gdk_pixbuf_set_option</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/api-index-2-26.html b/docs/reference/gdk-pixbuf/html/api-index-2-26.html new file mode 100644 index 0000000..46c98cf --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/api-index-2-26.html @@ -0,0 +1,55 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Index of new symbols in 2.26</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="api-index-2-14.html" title="Index of new symbols in 2.14"> +<link rel="next" href="license.html" title="Appendix A. License"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="api-index-2-14.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="license.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a class="shortcut" href="#idxG">G</a> + | + <a class="shortcut" href="#idxN">N</a> +</td></tr> +</table> +<div class="index"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="api-index-2-26"></a>Index of new symbols in 2.26</h1></div></div></div> +<a name="idx"></a><a name="idxG"></a><h3 class="title">G</h3> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-byte-length" title="gdk_pixbuf_get_byte_length ()">gdk_pixbuf_get_byte_length</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-pixels-with-length" title="gdk_pixbuf_get_pixels_with_length ()">gdk_pixbuf_get_pixels_with_length</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<a name="idxN"></a><h3 class="title">N</h3> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-resource" title="gdk_pixbuf_new_from_resource ()">gdk_pixbuf_new_from_resource</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-resource-at-scale" title="gdk_pixbuf_new_from_resource_at_scale ()">gdk_pixbuf_new_from_resource_at_scale</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/api-index-2-4.html b/docs/reference/gdk-pixbuf/html/api-index-2-4.html new file mode 100644 index 0000000..2a9cf64 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/api-index-2-4.html @@ -0,0 +1,77 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Index of new symbols in 2.4</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="api-index-2-2.html" title="Index of new symbols in 2.2"> +<link rel="next" href="api-index-2-6.html" title="Index of new symbols in 2.6"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="api-index-2-2.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="api-index-2-6.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a class="shortcut" href="#idxG">G</a> + | + <a class="shortcut" href="#idxL">L</a> + | + <a class="shortcut" href="#idxN">N</a> + | + <a class="shortcut" href="#idxS">S</a> +</td></tr> +</table> +<div class="index"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="api-index-2-4"></a>Index of new symbols in 2.4</h1></div></div></div> +<a name="idx"></a><a name="idxG"></a><h3 class="title">G</h3> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc" title="GdkPixbufSaveFunc ()">GdkPixbufSaveFunc</a>, user_function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-get-file-info" title="gdk_pixbuf_get_file_info ()">gdk_pixbuf_get_file_info</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<a name="idxL"></a><h3 class="title">L</h3> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-new-with-mime-type" title="gdk_pixbuf_loader_new_with_mime_type ()">gdk_pixbuf_loader_new_with_mime_type</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<a name="idxN"></a><h3 class="title">N</h3> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-size" title="gdk_pixbuf_new_from_file_at_size ()">gdk_pixbuf_new_from_file_at_size</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<a name="idxS"></a><h3 class="title">S</h3> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-buffer" title="gdk_pixbuf_save_to_buffer ()">gdk_pixbuf_save_to_buffer</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-bufferv" title="gdk_pixbuf_save_to_bufferv ()">gdk_pixbuf_save_to_bufferv</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback" title="gdk_pixbuf_save_to_callback ()">gdk_pixbuf_save_to_callback</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callbackv" title="gdk_pixbuf_save_to_callbackv ()">gdk_pixbuf_save_to_callbackv</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/api-index-2-6.html b/docs/reference/gdk-pixbuf/html/api-index-2-6.html new file mode 100644 index 0000000..a54709e --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/api-index-2-6.html @@ -0,0 +1,70 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Index of new symbols in 2.6</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="api-index-2-4.html" title="Index of new symbols in 2.4"> +<link rel="next" href="api-index-2-8.html" title="Index of new symbols in 2.8"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="api-index-2-4.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="api-index-2-8.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a class="shortcut" href="#idxF">F</a> + | + <a class="shortcut" href="#idxN">N</a> + | + <a class="shortcut" href="#idxR">R</a> +</td></tr> +</table> +<div class="index"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="api-index-2-6"></a>Index of new symbols in 2.6</h1></div></div></div> +<a name="idx"></a><a name="idxF"></a><h3 class="title">F</h3> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-flip" title="gdk_pixbuf_flip ()">gdk_pixbuf_flip</a>, function in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-license" title="gdk_pixbuf_format_get_license ()">gdk_pixbuf_format_get_license</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-disabled" title="gdk_pixbuf_format_is_disabled ()">gdk_pixbuf_format_is_disabled</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-scalable" title="gdk_pixbuf_format_is_scalable ()">gdk_pixbuf_format_is_scalable</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-set-disabled" title="gdk_pixbuf_format_set_disabled ()">gdk_pixbuf_format_set_disabled</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<a name="idxN"></a><h3 class="title">N</h3> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-scale" title="gdk_pixbuf_new_from_file_at_scale ()">gdk_pixbuf_new_from_file_at_scale</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<a name="idxR"></a><h3 class="title">R</h3> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-rotate-simple" title="gdk_pixbuf_rotate_simple ()">gdk_pixbuf_rotate_simple</a>, function in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/api-index-2-8.html b/docs/reference/gdk-pixbuf/html/api-index-2-8.html new file mode 100644 index 0000000..4fe3abf --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/api-index-2-8.html @@ -0,0 +1,42 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Index of new symbols in 2.8</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="api-index-2-6.html" title="Index of new symbols in 2.6"> +<link rel="next" href="api-index-2-12.html" title="Index of new symbols in 2.12"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="api-index-2-6.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="api-index-2-12.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"><a class="shortcut" href="#idxS">S</a></td></tr> +</table> +<div class="index"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="api-index-2-8"></a>Index of new symbols in 2.8</h1></div></div></div> +<a name="idx"></a><a name="idxS"></a><h3 class="title">S</h3> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-add-frame" title="gdk_pixbuf_simple_anim_add_frame ()">gdk_pixbuf_simple_anim_add_frame</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-new" title="gdk_pixbuf_simple_anim_new ()">gdk_pixbuf_simple_anim_new</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/api-index-deprecated.html b/docs/reference/gdk-pixbuf/html/api-index-deprecated.html new file mode 100644 index 0000000..d7a16ac --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/api-index-deprecated.html @@ -0,0 +1,58 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Index of deprecated symbols</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="api-index-full.html" title="Index of all symbols"> +<link rel="next" href="api-index-2-2.html" title="Index of new symbols in 2.2"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="api-index-full.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="api-index-2-2.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a class="shortcut" href="#idxA">A</a> + | + <a class="shortcut" href="#idxR">R</a> + | + <a class="shortcut" href="#idxU">U</a> +</td></tr> +</table> +<div class="index"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="api-index-deprecated"></a>Index of deprecated symbols</h1></div></div></div> +<a name="idx"></a><a name="idxA"></a><h3 class="title">A</h3> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-ref" title="gdk_pixbuf_animation_ref ()">gdk_pixbuf_animation_ref</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-unref" title="gdk_pixbuf_animation_unref ()">gdk_pixbuf_animation_unref</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<a name="idxR"></a><h3 class="title">R</h3> +<dt> +<a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-ref" title="gdk_pixbuf_ref ()">gdk_pixbuf_ref</a>, function in <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html" title="Reference Counting and Memory Mangement">Reference Counting and Memory Mangement</a> +</dt> +<dd></dd> +<a name="idxU"></a><h3 class="title">U</h3> +<dt> +<a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref" title="gdk_pixbuf_unref ()">gdk_pixbuf_unref</a>, function in <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html" title="Reference Counting and Memory Mangement">Reference Counting and Memory Mangement</a> +</dt> +<dd></dd> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/api-index-full.html b/docs/reference/gdk-pixbuf/html/api-index-full.html new file mode 100644 index 0000000..e895591 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/api-index-full.html @@ -0,0 +1,772 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Index of all symbols</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="gdk-pixbuf-query-loaders.html" title="gdk-pixbuf-query-loaders"> +<link rel="next" href="api-index-deprecated.html" title="Index of deprecated symbols"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-query-loaders.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="api-index-deprecated.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a class="shortcut" href="#idxA">A</a> + | + <a class="shortcut" href="#idxC">C</a> + | + <a class="shortcut" href="#idxE">E</a> + | + <a class="shortcut" href="#idxF">F</a> + | + <a class="shortcut" href="#idxG">G</a> + | + <a class="shortcut" href="#idxL">L</a> + | + <a class="shortcut" href="#idxM">M</a> + | + <a class="shortcut" href="#idxN">N</a> + | + <a class="shortcut" href="#idxR">R</a> + | + <a class="shortcut" href="#idxS">S</a> + | + <a class="shortcut" href="#idxU">U</a> + | + <a class="shortcut" href="#idxV">V</a> + | + <a class="shortcut" href="#idxX">X</a> +</td></tr> +</table> +<div class="index"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="api-index-full"></a>Index of all symbols</h1></div></div></div> +<a name="idx"></a><a name="idxA"></a><h3 class="title">A</h3> +<dt> +<a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-add-alpha" title="gdk_pixbuf_add_alpha ()">gdk_pixbuf_add_alpha</a>, function in <a class="link" href="gdk-pixbuf-Utilities.html" title="Utilities">Utilities</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-height" title="gdk_pixbuf_animation_get_height ()">gdk_pixbuf_animation_get_height</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-iter" title="gdk_pixbuf_animation_get_iter ()">gdk_pixbuf_animation_get_iter</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-static-image" title="gdk_pixbuf_animation_get_static_image ()">gdk_pixbuf_animation_get_static_image</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-width" title="gdk_pixbuf_animation_get_width ()">gdk_pixbuf_animation_get_width</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-is-static-image" title="gdk_pixbuf_animation_is_static_image ()">gdk_pixbuf_animation_is_static_image</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-advance" title="gdk_pixbuf_animation_iter_advance ()">gdk_pixbuf_animation_iter_advance</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-delay-time" title="gdk_pixbuf_animation_iter_get_delay_time ()">gdk_pixbuf_animation_iter_get_delay_time</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf" title="gdk_pixbuf_animation_iter_get_pixbuf ()">gdk_pixbuf_animation_iter_get_pixbuf</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-on-currently-loading-frame" title="gdk_pixbuf_animation_iter_on_currently_loading_frame ()">gdk_pixbuf_animation_iter_on_currently_loading_frame</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file" title="gdk_pixbuf_animation_new_from_file ()">gdk_pixbuf_animation_new_from_file</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-ref" title="gdk_pixbuf_animation_ref ()">gdk_pixbuf_animation_ref</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-unref" title="gdk_pixbuf_animation_unref ()">gdk_pixbuf_animation_unref</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-apply-embedded-orientation" title="gdk_pixbuf_apply_embedded_orientation ()">gdk_pixbuf_apply_embedded_orientation</a>, function in <a class="link" href="gdk-pixbuf-Utilities.html" title="Utilities">Utilities</a> +</dt> +<dd></dd> +<a name="idxC"></a><h3 class="title">C</h3> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite" title="gdk_pixbuf_composite ()">gdk_pixbuf_composite</a>, function in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color" title="gdk_pixbuf_composite_color ()">gdk_pixbuf_composite_color</a>, function in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple" title="gdk_pixbuf_composite_color_simple ()">gdk_pixbuf_composite_color_simple</a>, function in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-copy" title="gdk_pixbuf_copy ()">gdk_pixbuf_copy</a>, function in <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html" title="Image Data in Memory">Image Data in Memory</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-copy-area" title="gdk_pixbuf_copy_area ()">gdk_pixbuf_copy_area</a>, function in <a class="link" href="gdk-pixbuf-Utilities.html" title="Utilities">Utilities</a> +</dt> +<dd></dd> +<a name="idxE"></a><h3 class="title">E</h3> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR">GDK_PIXBUF_ERROR</a>, macro in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<a name="idxF"></a><h3 class="title">F</h3> +<dt> +<a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-fill" title="gdk_pixbuf_fill ()">gdk_pixbuf_fill</a>, function in <a class="link" href="gdk-pixbuf-Utilities.html" title="Utilities">Utilities</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-flip" title="gdk_pixbuf_flip ()">gdk_pixbuf_flip</a>, function in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-copy" title="gdk_pixbuf_format_copy ()">gdk_pixbuf_format_copy</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-free" title="gdk_pixbuf_format_free ()">gdk_pixbuf_format_free</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-description" title="gdk_pixbuf_format_get_description ()">gdk_pixbuf_format_get_description</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-extensions" title="gdk_pixbuf_format_get_extensions ()">gdk_pixbuf_format_get_extensions</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-license" title="gdk_pixbuf_format_get_license ()">gdk_pixbuf_format_get_license</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-mime-types" title="gdk_pixbuf_format_get_mime_types ()">gdk_pixbuf_format_get_mime_types</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-name" title="gdk_pixbuf_format_get_name ()">gdk_pixbuf_format_get_name</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-disabled" title="gdk_pixbuf_format_is_disabled ()">gdk_pixbuf_format_is_disabled</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-scalable" title="gdk_pixbuf_format_is_scalable ()">gdk_pixbuf_format_is_scalable</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-writable" title="gdk_pixbuf_format_is_writable ()">gdk_pixbuf_format_is_writable</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-set-disabled" title="gdk_pixbuf_format_set_disabled ()">gdk_pixbuf_format_set_disabled</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixbuf-from-pixdata" title="gdk_pixbuf_from_pixdata ()">gdk_pixbuf_from_pixdata</a>, function in <a class="link" href="gdk-pixbuf-Inline-data.html" title="Inline data">Inline data</a> +</dt> +<dd></dd> +<a name="idxG"></a><h3 class="title">G</h3> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace">GdkColorspace</a>, enum in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType">GdkInterpType</a>, enum in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct" title="GdkPixbuf">GdkPixbuf</a>, struct in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--bits-per-sample" title='The "bits-per-sample" property'>GdkPixbuf:bits-per-sample</a>, object property in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--colorspace" title='The "colorspace" property'>GdkPixbuf:colorspace</a>, object property in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--has-alpha" title='The "has-alpha" property'>GdkPixbuf:has-alpha</a>, object property in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--height" title='The "height" property'>GdkPixbuf:height</a>, object property in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--n-channels" title='The "n-channels" property'>GdkPixbuf:n-channels</a>, object property in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--pixels" title='The "pixels" property'>GdkPixbuf:pixels</a>, object property in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--rowstride" title='The "rowstride" property'>GdkPixbuf:rowstride</a>, object property in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--width" title='The "width" property'>GdkPixbuf:width</a>, object property in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufAlphaMode" title="enum GdkPixbufAlphaMode">GdkPixbufAlphaMode</a>, enum in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct" title="struct GdkPixbufAnimation">GdkPixbufAnimation</a>, struct in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationClass" title="struct GdkPixbufAnimationClass">GdkPixbufAnimationClass</a>, struct in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter-struct" title="struct GdkPixbufAnimationIter">GdkPixbufAnimationIter</a>, struct in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationIterClass" title="struct GdkPixbufAnimationIterClass">GdkPixbufAnimationIterClass</a>, struct in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()">GdkPixbufDestroyNotify</a>, user_function in <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html" title="Reference Counting and Memory Mangement">Reference Counting and Memory Mangement</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufError" title="enum GdkPixbufError">GdkPixbufError</a>, enum in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat">GdkPixbufFormat</a>, struct in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormatFlags" title="enum GdkPixbufFormatFlags">GdkPixbufFormatFlags</a>, enum in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-struct" title="struct GdkPixbufLoader">GdkPixbufLoader</a>, struct in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-prepared" title='The "area-prepared" signal'>GdkPixbufLoader::area-prepared</a>, object signal in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-updated" title='The "area-updated" signal'>GdkPixbufLoader::area-updated</a>, object signal in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-closed" title='The "closed" signal'>GdkPixbufLoader::closed</a>, object signal in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-size-prepared" title='The "size-prepared" signal'>GdkPixbufLoader::size-prepared</a>, object signal in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule">GdkPixbufModule</a>, struct in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillInfoFunc" title="GdkPixbufModuleFillInfoFunc ()">GdkPixbufModuleFillInfoFunc</a>, user_function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc" title="GdkPixbufModuleFillVtableFunc ()">GdkPixbufModuleFillVtableFunc</a>, user_function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern" title="struct GdkPixbufModulePattern">GdkPixbufModulePattern</a>, struct in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePreparedFunc" title="GdkPixbufModulePreparedFunc ()">GdkPixbufModulePreparedFunc</a>, user_function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleSizeFunc" title="GdkPixbufModuleSizeFunc ()">GdkPixbufModuleSizeFunc</a>, user_function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleUpdatedFunc" title="GdkPixbufModuleUpdatedFunc ()">GdkPixbufModuleUpdatedFunc</a>, user_function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#GdkPixbufRotation" title="enum GdkPixbufRotation">GdkPixbufRotation</a>, enum in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc" title="GdkPixbufSaveFunc ()">GdkPixbufSaveFunc</a>, user_function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim-struct" title="GdkPixbufSimpleAnim">GdkPixbufSimpleAnim</a>, struct in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim--loop" title='The "loop" property'>GdkPixbufSimpleAnim:loop</a>, object property in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata">GdkPixdata</a>, struct in <a class="link" href="gdk-pixbuf-Inline-data.html" title="Inline data">Inline data</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdataDumpType" title="enum GdkPixdataDumpType">GdkPixdataDumpType</a>, enum in <a class="link" href="gdk-pixbuf-Inline-data.html" title="Inline data">Inline data</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdataType" title="enum GdkPixdataType">GdkPixdataType</a>, enum in <a class="link" href="gdk-pixbuf-Inline-data.html" title="Inline data">Inline data</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixdata-deserialize" title="gdk_pixdata_deserialize ()">gdk_pixdata_deserialize</a>, function in <a class="link" href="gdk-pixbuf-Inline-data.html" title="Inline data">Inline data</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixdata-from-pixbuf" title="gdk_pixdata_from_pixbuf ()">gdk_pixdata_from_pixbuf</a>, function in <a class="link" href="gdk-pixbuf-Inline-data.html" title="Inline data">Inline data</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-HEADER-LENGTH:CAPS" title="GDK_PIXDATA_HEADER_LENGTH">GDK_PIXDATA_HEADER_LENGTH</a>, macro in <a class="link" href="gdk-pixbuf-Inline-data.html" title="Inline data">Inline data</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixdata-serialize" title="gdk_pixdata_serialize ()">gdk_pixdata_serialize</a>, function in <a class="link" href="gdk-pixbuf-Inline-data.html" title="Inline data">Inline data</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixdata-to-csource" title="gdk_pixdata_to_csource ()">gdk_pixdata_to_csource</a>, function in <a class="link" href="gdk-pixbuf-Inline-data.html" title="Inline data">Inline data</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-bits-per-sample" title="gdk_pixbuf_get_bits_per_sample ()">gdk_pixbuf_get_bits_per_sample</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-byte-length" title="gdk_pixbuf_get_byte_length ()">gdk_pixbuf_get_byte_length</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-colorspace" title="gdk_pixbuf_get_colorspace ()">gdk_pixbuf_get_colorspace</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-get-file-info" title="gdk_pixbuf_get_file_info ()">gdk_pixbuf_get_file_info</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-get-formats" title="gdk_pixbuf_get_formats ()">gdk_pixbuf_get_formats</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-has-alpha" title="gdk_pixbuf_get_has_alpha ()">gdk_pixbuf_get_has_alpha</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-height" title="gdk_pixbuf_get_height ()">gdk_pixbuf_get_height</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-n-channels" title="gdk_pixbuf_get_n_channels ()">gdk_pixbuf_get_n_channels</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-option" title="gdk_pixbuf_get_option ()">gdk_pixbuf_get_option</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-pixels" title="gdk_pixbuf_get_pixels ()">gdk_pixbuf_get_pixels</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-pixels-with-length" title="gdk_pixbuf_get_pixels_with_length ()">gdk_pixbuf_get_pixels_with_length</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-rowstride" title="gdk_pixbuf_get_rowstride ()">gdk_pixbuf_get_rowstride</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-width" title="gdk_pixbuf_get_width ()">gdk_pixbuf_get_width</a>, function in <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">The GdkPixbuf Structure</a> +</dt> +<dd></dd> +<a name="idxL"></a><h3 class="title">L</h3> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-close" title="gdk_pixbuf_loader_close ()">gdk_pixbuf_loader_close</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-animation" title="gdk_pixbuf_loader_get_animation ()">gdk_pixbuf_loader_get_animation</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-format" title="gdk_pixbuf_loader_get_format ()">gdk_pixbuf_loader_get_format</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-get-pixbuf" title="gdk_pixbuf_loader_get_pixbuf ()">gdk_pixbuf_loader_get_pixbuf</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-new" title="gdk_pixbuf_loader_new ()">gdk_pixbuf_loader_new</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-new-with-mime-type" title="gdk_pixbuf_loader_new_with_mime_type ()">gdk_pixbuf_loader_new_with_mime_type</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-new-with-type" title="gdk_pixbuf_loader_new_with_type ()">gdk_pixbuf_loader_new_with_type</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-set-size" title="gdk_pixbuf_loader_set_size ()">gdk_pixbuf_loader_set_size</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="GdkPixbufLoader.html#gdk-pixbuf-loader-write" title="gdk_pixbuf_loader_write ()">gdk_pixbuf_loader_write</a>, function in <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader">GdkPixbufLoader</a> +</dt> +<dd></dd> +<a name="idxM"></a><h3 class="title">M</h3> +<dt> +<a class="link" href="gdk-pixbuf-Inline-data.html#GDK-PIXBUF-MAGIC-NUMBER:CAPS" title="GDK_PIXBUF_MAGIC_NUMBER">GDK_PIXBUF_MAGIC_NUMBER</a>, macro in <a class="link" href="gdk-pixbuf-Inline-data.html" title="Inline data">Inline data</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MAJOR:CAPS" title="GDK_PIXBUF_MAJOR">GDK_PIXBUF_MAJOR</a>, macro in <a class="link" href="gdk-pixbuf-Versioning.html" title="Initialization and Versions">Versioning</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Versioning.html#gdk-pixbuf-major-version" title="gdk_pixbuf_major_version">gdk_pixbuf_major_version</a>, variable in <a class="link" href="gdk-pixbuf-Versioning.html" title="Initialization and Versions">Versioning</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MICRO:CAPS" title="GDK_PIXBUF_MICRO">GDK_PIXBUF_MICRO</a>, macro in <a class="link" href="gdk-pixbuf-Versioning.html" title="Initialization and Versions">Versioning</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Versioning.html#gdk-pixbuf-micro-version" title="gdk_pixbuf_micro_version">gdk_pixbuf_micro_version</a>, variable in <a class="link" href="gdk-pixbuf-Versioning.html" title="Initialization and Versions">Versioning</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MINOR:CAPS" title="GDK_PIXBUF_MINOR">GDK_PIXBUF_MINOR</a>, macro in <a class="link" href="gdk-pixbuf-Versioning.html" title="Initialization and Versions">Versioning</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Versioning.html#gdk-pixbuf-minor-version" title="gdk_pixbuf_minor_version">gdk_pixbuf_minor_version</a>, variable in <a class="link" href="gdk-pixbuf-Versioning.html" title="Initialization and Versions">Versioning</a> +</dt> +<dd></dd> +<a name="idxN"></a><h3 class="title">N</h3> +<dt> +<a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new" title="gdk_pixbuf_new ()">gdk_pixbuf_new</a>, function in <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html" title="Image Data in Memory">Image Data in Memory</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()">gdk_pixbuf_new_from_data</a>, function in <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html" title="Image Data in Memory">Image Data in Memory</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file" title="gdk_pixbuf_new_from_file ()">gdk_pixbuf_new_from_file</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-scale" title="gdk_pixbuf_new_from_file_at_scale ()">gdk_pixbuf_new_from_file_at_scale</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-size" title="gdk_pixbuf_new_from_file_at_size ()">gdk_pixbuf_new_from_file_at_size</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline" title="gdk_pixbuf_new_from_inline ()">gdk_pixbuf_new_from_inline</a>, function in <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html" title="Image Data in Memory">Image Data in Memory</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-resource" title="gdk_pixbuf_new_from_resource ()">gdk_pixbuf_new_from_resource</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-resource-at-scale" title="gdk_pixbuf_new_from_resource_at_scale ()">gdk_pixbuf_new_from_resource_at_scale</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream" title="gdk_pixbuf_new_from_stream ()">gdk_pixbuf_new_from_stream</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-async" title="gdk_pixbuf_new_from_stream_async ()">gdk_pixbuf_new_from_stream_async</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale" title="gdk_pixbuf_new_from_stream_at_scale ()">gdk_pixbuf_new_from_stream_at_scale</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale-async" title="gdk_pixbuf_new_from_stream_at_scale_async ()">gdk_pixbuf_new_from_stream_at_scale_async</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-finish" title="gdk_pixbuf_new_from_stream_finish ()">gdk_pixbuf_new_from_stream_finish</a>, function in <a class="link" href="gdk-pixbuf-File-Loading.html" title="File Loading">File Loading</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-xpm-data" title="gdk_pixbuf_new_from_xpm_data ()">gdk_pixbuf_new_from_xpm_data</a>, function in <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html" title="Image Data in Memory">Image Data in Memory</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-subpixbuf" title="gdk_pixbuf_new_subpixbuf ()">gdk_pixbuf_new_subpixbuf</a>, function in <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html" title="Image Data in Memory">Image Data in Memory</a> +</dt> +<dd></dd> +<a name="idxR"></a><h3 class="title">R</h3> +<dt> +<a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-ref" title="gdk_pixbuf_ref ()">gdk_pixbuf_ref</a>, function in <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html" title="Reference Counting and Memory Mangement">Reference Counting and Memory Mangement</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-rotate-simple" title="gdk_pixbuf_rotate_simple ()">gdk_pixbuf_rotate_simple</a>, function in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +<a name="idxS"></a><h3 class="title">S</h3> +<dt> +<a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-saturate-and-pixelate" title="gdk_pixbuf_saturate_and_pixelate ()">gdk_pixbuf_saturate_and_pixelate</a>, function in <a class="link" href="gdk-pixbuf-Utilities.html" title="Utilities">Utilities</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save" title="gdk_pixbuf_save ()">gdk_pixbuf_save</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-savev" title="gdk_pixbuf_savev ()">gdk_pixbuf_savev</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-buffer" title="gdk_pixbuf_save_to_buffer ()">gdk_pixbuf_save_to_buffer</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-bufferv" title="gdk_pixbuf_save_to_bufferv ()">gdk_pixbuf_save_to_bufferv</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback" title="gdk_pixbuf_save_to_callback ()">gdk_pixbuf_save_to_callback</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callbackv" title="gdk_pixbuf_save_to_callbackv ()">gdk_pixbuf_save_to_callbackv</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream" title="gdk_pixbuf_save_to_stream ()">gdk_pixbuf_save_to_stream</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream-async" title="gdk_pixbuf_save_to_stream_async ()">gdk_pixbuf_save_to_stream_async</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream-finish" title="gdk_pixbuf_save_to_stream_finish ()">gdk_pixbuf_save_to_stream_finish</a>, function in <a class="link" href="gdk-pixbuf-File-saving.html" title="File saving">File saving</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()">gdk_pixbuf_scale</a>, function in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()">gdk_pixbuf_scale_simple</a>, function in <a class="link" href="gdk-pixbuf-Scaling.html" title="Scaling">Scaling</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-set-option" title="gdk_pixbuf_set_option ()">gdk_pixbuf_set_option</a>, function in <a class="link" href="gdk-pixbuf-Module-Interface.html" title="Module Interface">Module Interface</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-add-frame" title="gdk_pixbuf_simple_anim_add_frame ()">gdk_pixbuf_simple_anim_add_frame</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-get-loop" title="gdk_pixbuf_simple_anim_get_loop ()">gdk_pixbuf_simple_anim_get_loop</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-new" title="gdk_pixbuf_simple_anim_new ()">gdk_pixbuf_simple_anim_new</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-set-loop" title="gdk_pixbuf_simple_anim_set_loop ()">gdk_pixbuf_simple_anim_set_loop</a>, function in <a class="link" href="gdk-pixbuf-Animations.html" title="Animations">Animations</a> +</dt> +<dd></dd> +<a name="idxU"></a><h3 class="title">U</h3> +<dt> +<a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref" title="gdk_pixbuf_unref ()">gdk_pixbuf_unref</a>, function in <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html" title="Reference Counting and Memory Mangement">Reference Counting and Memory Mangement</a> +</dt> +<dd></dd> +<a name="idxV"></a><h3 class="title">V</h3> +<dt> +<a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-VERSION:CAPS" title="GDK_PIXBUF_VERSION">GDK_PIXBUF_VERSION</a>, macro in <a class="link" href="gdk-pixbuf-Versioning.html" title="Initialization and Versions">Versioning</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Versioning.html#gdk-pixbuf-version" title="gdk_pixbuf_version">gdk_pixbuf_version</a>, variable in <a class="link" href="gdk-pixbuf-Versioning.html" title="Initialization and Versions">Versioning</a> +</dt> +<dd></dd> +<a name="idxX"></a><h3 class="title">X</h3> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap">XlibRgbCmap</a>, struct in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither">XlibRgbDither</a>, enum in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-gray-image" title="xlib_draw_gray_image ()">xlib_draw_gray_image</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-indexed-image" title="xlib_draw_indexed_image ()">xlib_draw_indexed_image</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-32-image" title="xlib_draw_rgb_32_image ()">xlib_draw_rgb_32_image</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image" title="xlib_draw_rgb_image ()">xlib_draw_rgb_image</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image-dithalign" title="xlib_draw_rgb_image_dithalign ()">xlib_draw_rgb_image_dithalign</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-X-Drawables-to-Pixbufs.html#gdk-pixbuf-xlib-get-from-drawable" title="gdk_pixbuf_xlib_get_from_drawable ()">gdk_pixbuf_xlib_get_from_drawable</a>, function in <a class="link" href="gdk-pixbuf-X-Drawables-to-Pixbufs.html" title="X Drawables to Pixbufs">X Drawables to Pixbufs</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-xlib-init" title="gdk_pixbuf_xlib_init ()">gdk_pixbuf_xlib_init</a>, function in <a class="link" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html" title="gdk-pixbuf Xlib initialization">gdk-pixbuf Xlib initialization</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-xlib-init-with-depth" title="gdk_pixbuf_xlib_init_with_depth ()">gdk_pixbuf_xlib_init_with_depth</a>, function in <a class="link" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html" title="gdk-pixbuf Xlib initialization">gdk-pixbuf Xlib initialization</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-pixmap-and-mask" title="gdk_pixbuf_xlib_render_pixmap_and_mask ()">gdk_pixbuf_xlib_render_pixmap_and_mask</a>, function in <a class="link" href="gdk-pixbuf-Xlib-Rendering.html" title="Xlib Rendering">Xlib Rendering</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-threshold-alpha" title="gdk_pixbuf_xlib_render_threshold_alpha ()">gdk_pixbuf_xlib_render_threshold_alpha</a>, function in <a class="link" href="gdk-pixbuf-Xlib-Rendering.html" title="Xlib Rendering">Xlib Rendering</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable" title="gdk_pixbuf_xlib_render_to_drawable ()">gdk_pixbuf_xlib_render_to_drawable</a>, function in <a class="link" href="gdk-pixbuf-Xlib-Rendering.html" title="Xlib Rendering">Xlib Rendering</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable-alpha" title="gdk_pixbuf_xlib_render_to_drawable_alpha ()">gdk_pixbuf_xlib_render_to_drawable_alpha</a>, function in <a class="link" href="gdk-pixbuf-Xlib-Rendering.html" title="Xlib Rendering">Xlib Rendering</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-cmap-free" title="xlib_rgb_cmap_free ()">xlib_rgb_cmap_free</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-cmap-new" title="xlib_rgb_cmap_new ()">xlib_rgb_cmap_new</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-ditherable" title="xlib_rgb_ditherable ()">xlib_rgb_ditherable</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-gc-set-background" title="xlib_rgb_gc_set_background ()">xlib_rgb_gc_set_background</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-gc-set-foreground" title="xlib_rgb_gc_set_foreground ()">xlib_rgb_gc_set_foreground</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-cmap" title="xlib_rgb_get_cmap ()">xlib_rgb_get_cmap</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-depth" title="xlib_rgb_get_depth ()">xlib_rgb_get_depth</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-display" title="xlib_rgb_get_display ()">xlib_rgb_get_display</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-screen" title="xlib_rgb_get_screen ()">xlib_rgb_get_screen</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-visual" title="xlib_rgb_get_visual ()">xlib_rgb_get_visual</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-visual-info" title="xlib_rgb_get_visual_info ()">xlib_rgb_get_visual_info</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init" title="xlib_rgb_init ()">xlib_rgb_init</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init-with-depth" title="xlib_rgb_init_with_depth ()">xlib_rgb_init_with_depth</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-install" title="xlib_rgb_set_install ()">xlib_rgb_set_install</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-min-colors" title="xlib_rgb_set_min_colors ()">xlib_rgb_set_min_colors</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-verbose" title="xlib_rgb_set_verbose ()">xlib_rgb_set_verbose</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +<dt> +<a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-xpixel-from-rgb" title="xlib_rgb_xpixel_from_rgb ()">xlib_rgb_xpixel_from_rgb</a>, function in <a class="link" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB">XlibRGB</a> +</dt> +<dd></dd> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/composite.png b/docs/reference/gdk-pixbuf/html/composite.png Binary files differnew file mode 100644 index 0000000..1c9485c --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/composite.png diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Animations.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Animations.html new file mode 100644 index 0000000..f8d8da8 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Animations.html @@ -0,0 +1,696 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Animations</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-Utilities.html" title="Utilities"> +<link rel="next" href="GdkPixbufLoader.html" title="GdkPixbufLoader"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-Utilities.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="GdkPixbufLoader.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-Animations.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-Animations.description" class="shortcut">Description</a> + | + <a href="#gdk-pixbuf-Animations.object-hierarchy" class="shortcut">Object Hierarchy</a> + | + <a href="#gdk-pixbuf-Animations.properties" class="shortcut">Properties</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-Animations"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-Animations.top_of_page"></a>Animations</span></h2> +<p>Animations — Animated images.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-Animations.synopsis"></a><h2>Synopsis</h2> +<a name="GdkPixbufAnimation"></a><a name="GdkPixbufAnimationIter"></a><a name="GdkPixbufSimpleAnim"></a><pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +struct <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct" title="struct GdkPixbufAnimation">GdkPixbufAnimation</a>; +struct <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter-struct" title="struct GdkPixbufAnimationIter">GdkPixbufAnimationIter</a>; +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="returnvalue">GdkPixbufAnimation</span></a> * <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file" title="gdk_pixbuf_animation_new_from_file ()">gdk_pixbuf_animation_new_from_file</a> (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="returnvalue">GdkPixbufAnimation</span></a> * <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-ref" title="gdk_pixbuf_animation_ref ()">gdk_pixbuf_animation_ref</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-unref" title="gdk_pixbuf_animation_unref ()">gdk_pixbuf_animation_unref</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>); +<span class="returnvalue">int</span> <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-width" title="gdk_pixbuf_animation_get_width ()">gdk_pixbuf_animation_get_width</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>); +<span class="returnvalue">int</span> <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-height" title="gdk_pixbuf_animation_get_height ()">gdk_pixbuf_animation_get_height</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>); +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="returnvalue">GdkPixbufAnimationIter</span></a> * <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-iter" title="gdk_pixbuf_animation_get_iter ()">gdk_pixbuf_animation_get_iter</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *start_time</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-is-static-image" title="gdk_pixbuf_animation_is_static_image ()">gdk_pixbuf_animation_is_static_image</a> + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-static-image" title="gdk_pixbuf_animation_get_static_image ()">gdk_pixbuf_animation_get_static_image</a> + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-advance" title="gdk_pixbuf_animation_iter_advance ()">gdk_pixbuf_animation_iter_advance</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *current_time</code></em>); +<span class="returnvalue">int</span> <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-delay-time" title="gdk_pixbuf_animation_iter_get_delay_time ()">gdk_pixbuf_animation_iter_get_delay_time</a> + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-on-currently-loading-frame" title="gdk_pixbuf_animation_iter_on_currently_loading_frame ()">gdk_pixbuf_animation_iter_on_currently_loading_frame</a> + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf" title="gdk_pixbuf_animation_iter_get_pixbuf ()">gdk_pixbuf_animation_iter_get_pixbuf</a> + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>); + + <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim-struct" title="GdkPixbufSimpleAnim">GdkPixbufSimpleAnim</a>; +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="returnvalue">GdkPixbufSimpleAnim</span></a> * <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-new" title="gdk_pixbuf_simple_anim_new ()">gdk_pixbuf_simple_anim_new</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> rate</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-add-frame" title="gdk_pixbuf_simple_anim_add_frame ()">gdk_pixbuf_simple_anim_add_frame</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> *animation</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-set-loop" title="gdk_pixbuf_simple_anim_set_loop ()">gdk_pixbuf_simple_anim_set_loop</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> *animation</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> loop</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-get-loop" title="gdk_pixbuf_simple_anim_get_loop ()">gdk_pixbuf_simple_anim_get_loop</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> *animation</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Animations.object-hierarchy"></a><h2>Object Hierarchy</h2> +<pre class="synopsis"> + <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> + +----GdkPixbufAnimation + +----<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim">GdkPixbufSimpleAnim</a> +</pre> +<pre class="synopsis"> + <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> + +----GdkPixbufAnimationIter +</pre> +<pre class="synopsis"> + <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> + +----<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation">GdkPixbufAnimation</a> + +----GdkPixbufSimpleAnim +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Animations.properties"></a><h2>Properties</h2> +<pre class="synopsis"> + "<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim--loop" title='The "loop" property'>loop</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Animations.description"></a><h2>Description</h2> +<p> +The GdkPixBuf library provides a simple mechanism to load and +represent animations. An animation is conceptually a series of +frames to be displayed over time. The animation may not be +represented as a series of frames internally; for example, it may +be stored as a sprite and instructions for moving the sprite around +a background. To display an animation you don't need to understand +its representation, however; you just ask GdkPixBuf what should +be displayed at a given point in time. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Animations.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="GdkPixbufAnimation-struct"></a><h3>struct GdkPixbufAnimation</h3> +<pre class="programlisting">struct GdkPixbufAnimation;</pre> +<p> +An opaque struct representing an animation. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufAnimationIter-struct"></a><h3>struct GdkPixbufAnimationIter</h3> +<pre class="programlisting">struct GdkPixbufAnimationIter;</pre> +<p> +An opaque struct representing an iterator which points to a +certain position in an animation. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-new-from-file"></a><h3>gdk_pixbuf_animation_new_from_file ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="returnvalue">GdkPixbufAnimation</span></a> * gdk_pixbuf_animation_new_from_file (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Creates a new animation by loading it from a file. The file format is +detected automatically. If the file's format does not support multi-frame +images, then an animation with a single frame will be created. Possible errors +are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td> +<td>Name of file to load, in the GLib file name encoding</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for error</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created animation with a reference count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> +if any of several error conditions ocurred: the file could not be opened, +there was no loader for the file's format, there was not enough memory to +allocate the image buffer, or the image file contained invalid data.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-ref"></a><h3>gdk_pixbuf_animation_ref ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="returnvalue">GdkPixbufAnimation</span></a> * gdk_pixbuf_animation_ref (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre> +<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> +<h3 class="title">Warning</h3> +<p><code class="literal">gdk_pixbuf_animation_ref</code> has been deprecated since version 2.0 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>.</p> +</div> +<p> +Adds a reference to an animation. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td> +<td>An animation.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>The same as the <em class="parameter"><code>animation</code></em> argument.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-unref"></a><h3>gdk_pixbuf_animation_unref ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_animation_unref (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre> +<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> +<h3 class="title">Warning</h3> +<p><code class="literal">gdk_pixbuf_animation_unref</code> has been deprecated since version 2.0 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p> +</div> +<p> +Removes a reference from an animation. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td> +<td>An animation.</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-get-width"></a><h3>gdk_pixbuf_animation_get_width ()</h3> +<pre class="programlisting"><span class="returnvalue">int</span> gdk_pixbuf_animation_get_width (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre> +<p> +Queries the width of the bounding box of a pixbuf animation. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td> +<td>An animation.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>Width of the bounding box of the animation.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-get-height"></a><h3>gdk_pixbuf_animation_get_height ()</h3> +<pre class="programlisting"><span class="returnvalue">int</span> gdk_pixbuf_animation_get_height (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre> +<p> +Queries the height of the bounding box of a pixbuf animation. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td> +<td>An animation.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>Height of the bounding box of the animation.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-get-iter"></a><h3>gdk_pixbuf_animation_get_iter ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="returnvalue">GdkPixbufAnimationIter</span></a> * gdk_pixbuf_animation_get_iter (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *start_time</code></em>);</pre> +<p> +Get an iterator for displaying an animation. The iterator provides +the frames that should be displayed at a given time. +It should be freed after use with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. +</p> +<p> +<em class="parameter"><code>start_time</code></em> would normally come from <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#g-get-current-time"><code class="function">g_get_current_time()</code></a>, and +marks the beginning of animation playback. After creating an +iterator, you should immediately display the pixbuf returned by +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf" title="gdk_pixbuf_animation_iter_get_pixbuf ()"><code class="function">gdk_pixbuf_animation_iter_get_pixbuf()</code></a>. Then, you should install a +timeout (with <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-timeout-add"><code class="function">g_timeout_add()</code></a>) or by some other mechanism ensure +that you'll update the image after +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-delay-time" title="gdk_pixbuf_animation_iter_get_delay_time ()"><code class="function">gdk_pixbuf_animation_iter_get_delay_time()</code></a> milliseconds. Each time +the image is updated, you should reinstall the timeout with the new, +possibly-changed delay time. +</p> +<p> +As a shortcut, if <em class="parameter"><code>start_time</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the result of +<a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#g-get-current-time"><code class="function">g_get_current_time()</code></a> will be used automatically. +</p> +<p> +To update the image (i.e. possibly change the result of +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf" title="gdk_pixbuf_animation_iter_get_pixbuf ()"><code class="function">gdk_pixbuf_animation_iter_get_pixbuf()</code></a> to a new frame of the animation), +call <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-advance" title="gdk_pixbuf_animation_iter_advance ()"><code class="function">gdk_pixbuf_animation_iter_advance()</code></a>. +</p> +<p> +If you're using <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a>, in addition to updating the image +after the delay time, you should also update it whenever you +receive the area_updated signal and +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-on-currently-loading-frame" title="gdk_pixbuf_animation_iter_on_currently_loading_frame ()"><code class="function">gdk_pixbuf_animation_iter_on_currently_loading_frame()</code></a> returns +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. In this case, the frame currently being fed into the loader +has received new data, so needs to be refreshed. The delay time for +a frame may also be modified after an area_updated signal, for +example if the delay time for a frame is encoded in the data after +the frame itself. So your timeout should be reinstalled after any +area_updated signal. +</p> +<p> +A delay time of -1 is possible, indicating "infinite." +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>start_time</code></em> :</span></p></td> +<td>time when the animation starts playing. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>an iterator to move over the animation. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-is-static-image"></a><h3>gdk_pixbuf_animation_is_static_image ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_animation_is_static_image + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre> +<p> +If you load a file with <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file" title="gdk_pixbuf_animation_new_from_file ()"><code class="function">gdk_pixbuf_animation_new_from_file()</code></a> and it turns +out to be a plain, unanimated image, then this function will return +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. Use <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-static-image" title="gdk_pixbuf_animation_get_static_image ()"><code class="function">gdk_pixbuf_animation_get_static_image()</code></a> to retrieve +the image. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the "animation" was really just an image</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-get-static-image"></a><h3>gdk_pixbuf_animation_get_static_image ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_animation_get_static_image + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre> +<p> +If an animation is really just a plain image (has only one frame), +this function returns that image. If the animation is an animation, +this function returns a reasonable thing to display as a static +unanimated image, which might be the first frame, or something more +sophisticated. If an animation hasn't loaded any frames yet, this +function will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>unanimated image representing the animation. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-iter-advance"></a><h3>gdk_pixbuf_animation_iter_advance ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_animation_iter_advance (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *current_time</code></em>);</pre> +<p> +Possibly advances an animation to a new frame. Chooses the frame based +on the start time passed to <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-iter" title="gdk_pixbuf_animation_get_iter ()"><code class="function">gdk_pixbuf_animation_get_iter()</code></a>. +</p> +<p> +<em class="parameter"><code>current_time</code></em> would normally come from <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#g-get-current-time"><code class="function">g_get_current_time()</code></a>, and +must be greater than or equal to the time passed to +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-iter" title="gdk_pixbuf_animation_get_iter ()"><code class="function">gdk_pixbuf_animation_get_iter()</code></a>, and must increase or remain +unchanged each time <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf" title="gdk_pixbuf_animation_iter_get_pixbuf ()"><code class="function">gdk_pixbuf_animation_iter_get_pixbuf()</code></a> is +called. That is, you can't go backward in time; animations only +play forward. +</p> +<p> +As a shortcut, pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the current time and <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#g-get-current-time"><code class="function">g_get_current_time()</code></a> +will be invoked on your behalf. So you only need to explicitly pass +<em class="parameter"><code>current_time</code></em> if you're doing something odd like playing the animation +at double speed. +</p> +<p> +If this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, there's no need to update the animation +display, assuming the display had been rendered prior to advancing; +if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, you need to call <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf" title="gdk_pixbuf_animation_iter_get_pixbuf ()"><code class="function">gdk_pixbuf_animation_iter_get_pixbuf()</code></a> +and update the display with the new pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>current_time</code></em> :</span></p></td> +<td>current time. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the image may need updating</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-iter-get-delay-time"></a><h3>gdk_pixbuf_animation_iter_get_delay_time ()</h3> +<pre class="programlisting"><span class="returnvalue">int</span> gdk_pixbuf_animation_iter_get_delay_time + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>);</pre> +<p> +Gets the number of milliseconds the current pixbuf should be displayed, +or -1 if the current pixbuf should be displayed forever. <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-timeout-add"><code class="function">g_timeout_add()</code></a> +conveniently takes a timeout in milliseconds, so you can use a timeout +to schedule the next update. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td> +<td>an animation iterator</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>delay time in milliseconds (thousandths of a second)</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-iter-on-currently-loading-frame"></a><h3>gdk_pixbuf_animation_iter_on_currently_loading_frame ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_animation_iter_on_currently_loading_frame + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>);</pre> +<p> +Used to determine how to respond to the area_updated signal on +<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> when loading an animation. area_updated is emitted +for an area of the frame currently streaming in to the loader. So if +you're on the currently loading frame, you need to redraw the screen for +the updated area. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the frame we're on is partially loaded, or the last frame</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-animation-iter-get-pixbuf"></a><h3>gdk_pixbuf_animation_iter_get_pixbuf ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_animation_iter_get_pixbuf + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>);</pre> +<p> +Gets the current pixbuf which should be displayed; the pixbuf might not +be the same size as the animation itself +(<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-width" title="gdk_pixbuf_animation_get_width ()"><code class="function">gdk_pixbuf_animation_get_width()</code></a>, <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-height" title="gdk_pixbuf_animation_get_height ()"><code class="function">gdk_pixbuf_animation_get_height()</code></a>). +This pixbuf should be displayed for +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-delay-time" title="gdk_pixbuf_animation_iter_get_delay_time ()"><code class="function">gdk_pixbuf_animation_iter_get_delay_time()</code></a> milliseconds. The caller +of this function does not own a reference to the returned pixbuf; +the returned pixbuf will become invalid when the iterator advances +to the next frame, which may happen anytime you call +<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-advance" title="gdk_pixbuf_animation_iter_advance ()"><code class="function">gdk_pixbuf_animation_iter_advance()</code></a>. Copy the pixbuf to keep it +(don't just add a reference), as it may get recycled as you advance +the iterator. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td> +<td>an animation iterator</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the pixbuf to be displayed. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufSimpleAnim-struct"></a><h3>GdkPixbufSimpleAnim</h3> +<pre class="programlisting">typedef struct _GdkPixbufSimpleAnim GdkPixbufSimpleAnim;</pre> +<p> +An opaque struct representing a simple animation. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-simple-anim-new"></a><h3>gdk_pixbuf_simple_anim_new ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="returnvalue">GdkPixbufSimpleAnim</span></a> * gdk_pixbuf_simple_anim_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> rate</code></em>);</pre> +<p> +Creates a new, empty animation. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>the width of the animation</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>the height of the animation</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rate</code></em> :</span></p></td> +<td>the speed of the animation, in frames per second</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a newly allocated <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.8</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-simple-anim-add-frame"></a><h3>gdk_pixbuf_simple_anim_add_frame ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_simple_anim_add_frame (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> *animation</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Adds a new frame to <em class="parameter"><code>animation</code></em>. The <em class="parameter"><code>pixbuf</code></em> must +have the dimensions specified when the animation +was constructed. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>the pixbuf to add</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.8</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-simple-anim-set-loop"></a><h3>gdk_pixbuf_simple_anim_set_loop ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_simple_anim_set_loop (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> *animation</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> loop</code></em>);</pre> +<p> +Sets whether <em class="parameter"><code>animation</code></em> should loop indefinitely when it reaches the end. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td> +<td>whether to loop the animation</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.18</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-simple-anim-get-loop"></a><h3>gdk_pixbuf_simple_anim_get_loop ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_simple_anim_get_loop (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> *animation</code></em>);</pre> +<p> +Gets whether <em class="parameter"><code>animation</code></em> should loop indefinitely when it reaches the end. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the animation loops forever, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.18</p> +</div> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Animations.property-details"></a><h2>Property Details</h2> +<div class="refsect2"> +<a name="GdkPixbufSimpleAnim--loop"></a><h3>The <code class="literal">"loop"</code> property</h3> +<pre class="programlisting"> "loop" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> +<p> +Whether the animation should loop when it reaches the end. +</p> +<p>Default value: FALSE</p> +<p class="since">Since 2.18</p> +</div> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Animations.see-also"></a><h2>See Also</h2> +<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a>. +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-File-Loading.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-File-Loading.html new file mode 100644 index 0000000..9028deb --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-File-Loading.html @@ -0,0 +1,672 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>File Loading</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html" title="Reference Counting and Memory Mangement"> +<link rel="next" href="gdk-pixbuf-File-saving.html" title="File saving"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-File-saving.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-File-Loading.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-File-Loading.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-File-Loading"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-File-Loading.top_of_page"></a>File Loading</span></h2> +<p>File Loading — Loading a pixbuf from a file.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-File-Loading.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file" title="gdk_pixbuf_new_from_file ()">gdk_pixbuf_new_from_file</a> (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-size" title="gdk_pixbuf_new_from_file_at_size ()">gdk_pixbuf_new_from_file_at_size</a> (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-scale" title="gdk_pixbuf_new_from_file_at_scale ()">gdk_pixbuf_new_from_file_at_scale</a> (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-get-file-info" title="gdk_pixbuf_get_file_info ()">gdk_pixbuf_get_file_info</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *width</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *height</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-resource" title="gdk_pixbuf_new_from_resource ()">gdk_pixbuf_new_from_resource</a> (<em class="parameter"><code>const <span class="type">char</span> *resource_path</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-resource-at-scale" title="gdk_pixbuf_new_from_resource_at_scale ()">gdk_pixbuf_new_from_resource_at_scale</a> + (<em class="parameter"><code>const <span class="type">char</span> *resource_path</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream" title="gdk_pixbuf_new_from_stream ()">gdk_pixbuf_new_from_stream</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-async" title="gdk_pixbuf_new_from_stream_async ()">gdk_pixbuf_new_from_stream_async</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-finish" title="gdk_pixbuf_new_from_stream_finish ()">gdk_pixbuf_new_from_stream_finish</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *async_result</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale" title="gdk_pixbuf_new_from_stream_at_scale ()">gdk_pixbuf_new_from_stream_at_scale</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale-async" title="gdk_pixbuf_new_from_stream_at_scale_async ()">gdk_pixbuf_new_from_stream_at_scale_async</a> + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-File-Loading.description"></a><h2>Description</h2> +<p> +The GdkPixBuf library provides a simple mechanism for loading +an image from a file in synchronous fashion. This means that the +library takes control of the application while the file is being +loaded; from the user's point of view, the application will block +until the image is done loading. +</p> +<p> +This interface can be used by applications in which blocking is +acceptable while an image is being loaded. It can also be used to +load small images in general. Applications that need progressive +loading can use the <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> functionality instead. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-File-Loading.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-file"></a><h3>gdk_pixbuf_new_from_file ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_file (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Creates a new pixbuf by loading an image from a file. The file format is +detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then <em class="parameter"><code>error</code></em> will be set. +Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td> +<td>Name of file to load, in the GLib file name encoding</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>Return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf with a reference count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if +any of several error conditions occurred: the file could not be opened, +there was no loader for the file's format, there was not enough memory to +allocate the image buffer, or the image file contained invalid data.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-file-at-size"></a><h3>gdk_pixbuf_new_from_file_at_size ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_file_at_size (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Creates a new pixbuf by loading an image from a file. +The file format is detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then +<em class="parameter"><code>error</code></em> will be set. Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and +<a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains. +</p> +<p> +The image will be scaled to fit in the requested size, preserving +the image's aspect ratio. Note that the returned pixbuf may be smaller +than <em class="parameter"><code>width</code></em> x <em class="parameter"><code>height</code></em>, if the aspect ratio requires it. To load +and image at the requested size, regardless of aspect ratio, use +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-scale" title="gdk_pixbuf_new_from_file_at_scale ()"><code class="function">gdk_pixbuf_new_from_file_at_scale()</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td> +<td>Name of file to load, in the GLib file name encoding</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>The width the image should have or -1 to not constrain the width</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>The height the image should have or -1 to not constrain the height</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>Return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf with a reference count of 1, or +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error conditions occurred: the file could not +be opened, there was no loader for the file's format, there was not +enough memory to allocate the image buffer, or the image file contained +invalid data.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.4</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-file-at-scale"></a><h3>gdk_pixbuf_new_from_file_at_scale ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_file_at_scale (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Creates a new pixbuf by loading an image from a file. The file format is +detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then <em class="parameter"><code>error</code></em> will be set. +Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains. +The image will be scaled to fit in the requested size, optionally preserving +the image's aspect ratio. +</p> +<p> +When preserving the aspect ratio, a <em class="parameter"><code>width</code></em> of -1 will cause the image +to be scaled to the exact given height, and a <em class="parameter"><code>height</code></em> of -1 will cause +the image to be scaled to the exact given width. When not preserving +aspect ratio, a <em class="parameter"><code>width</code></em> or <em class="parameter"><code>height</code></em> of -1 means to not scale the image +at all in that dimension. Negative values for <em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em> are +allowed since 2.8. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td> +<td>Name of file to load, in the GLib file name encoding</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>The width the image should have or -1 to not constrain the width</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>The height the image should have or -1 to not constrain the height</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>preserve_aspect_ratio</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to preserve the image's aspect ratio</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>Return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf with a reference count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> +if any of several error conditions occurred: the file could not be opened, +there was no loader for the file's format, there was not enough memory to +allocate the image buffer, or the image file contained invalid data.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.6</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-file-info"></a><h3>gdk_pixbuf_get_file_info ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * gdk_pixbuf_get_file_info (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *width</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *height</code></em>);</pre> +<p> +Parses an image file far enough to determine its format and size. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td> +<td>The name of the file to identify.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Return location for the width of the image, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Return location for the height of the image, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> describing the image +format of the file or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the image format wasn't +recognized. The return value is owned by GdkPixbuf and should +not be freed. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.4</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-resource"></a><h3>gdk_pixbuf_new_from_resource ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_resource (<em class="parameter"><code>const <span class="type">char</span> *resource_path</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Creates a new pixbuf by loading an image from an resource. +</p> +<p> +The file format is detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then +<em class="parameter"><code>error</code></em> will be set. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>resource_path</code></em> :</span></p></td> +<td>the path of the resource file</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>Return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error +conditions occurred: the file could not be opened, the image format is +not supported, there was not enough memory to allocate the image buffer, +the stream contained invalid data, or the operation was cancelled.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.26</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-resource-at-scale"></a><h3>gdk_pixbuf_new_from_resource_at_scale ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_resource_at_scale + (<em class="parameter"><code>const <span class="type">char</span> *resource_path</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Creates a new pixbuf by loading an image from an resource. +</p> +<p> +The file format is detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then +<em class="parameter"><code>error</code></em> will be set. +</p> +<p> +The image will be scaled to fit in the requested size, optionally +preserving the image's aspect ratio. When preserving the aspect ratio, +a <em class="parameter"><code>width</code></em> of -1 will cause the image to be scaled to the exact given +height, and a <em class="parameter"><code>height</code></em> of -1 will cause the image to be scaled to the +exact given width. When not preserving aspect ratio, a <em class="parameter"><code>width</code></em> or +<em class="parameter"><code>height</code></em> of -1 means to not scale the image at all in that dimension. +</p> +<p> +The stream is not closed. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>resource_path</code></em> :</span></p></td> +<td>the path of the resource file</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>The width the image should have or -1 to not constrain the width</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>The height the image should have or -1 to not constrain the height</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>preserve_aspect_ratio</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to preserve the image's aspect ratio</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>Return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error +conditions occurred: the file could not be opened, the image format is +not supported, there was not enough memory to allocate the image buffer, +the stream contained invalid data, or the operation was cancelled.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.26</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-stream"></a><h3>gdk_pixbuf_new_from_stream ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_stream (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Creates a new pixbuf by loading an image from an input stream. +</p> +<p> +The file format is detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then +<em class="parameter"><code>error</code></em> will be set. The <em class="parameter"><code>cancellable</code></em> can be used to abort the operation +from another thread. If the operation was cancelled, the error +<a href="http://library.gnome.org/devel/gio/unstable/gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned. Other possible errors are in +the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="http://library.gnome.org/devel/gio/unstable/gio-GIOError.html#G-IO-ERROR:CAPS"><code class="literal">G_IO_ERROR</code></a> domains. +</p> +<p> +The stream is not closed. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> to load the pixbuf from</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td> +<td>optional <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>Return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error +conditions occurred: the file could not be opened, the image format is +not supported, there was not enough memory to allocate the image buffer, +the stream contained invalid data, or the operation was cancelled.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.14</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-stream-async"></a><h3>gdk_pixbuf_new_from_stream_async ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_new_from_stream_async (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<p> +Creates a new pixbuf by asynchronously loading an image from an input stream. +</p> +<p> +For more details see <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream" title="gdk_pixbuf_new_from_stream ()"><code class="function">gdk_pixbuf_new_from_stream()</code></a>, which is the synchronous +version of this function. +</p> +<p> +When the operation is finished, <em class="parameter"><code>callback</code></em> will be called in the main thread. +You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-finish" title="gdk_pixbuf_new_from_stream_finish ()"><code class="function">gdk_pixbuf_new_from_stream_finish()</code></a> to get the result of the operation. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> from which to load the pixbuf</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td> +<td>optional <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the the pixbuf is loaded</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>the data to pass to the callback function</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.24</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-stream-finish"></a><h3>gdk_pixbuf_new_from_stream_finish ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_stream_finish (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *async_result</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Finishes an asynchronous pixbuf creation operation started with +<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-async" title="gdk_pixbuf_new_from_stream_async ()"><code class="function">gdk_pixbuf_new_from_stream_async()</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>async_result</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. Free the returned +object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.24</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-stream-at-scale"></a><h3>gdk_pixbuf_new_from_stream_at_scale ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_stream_at_scale (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Creates a new pixbuf by loading an image from an input stream. +</p> +<p> +The file format is detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then +<em class="parameter"><code>error</code></em> will be set. The <em class="parameter"><code>cancellable</code></em> can be used to abort the operation +from another thread. If the operation was cancelled, the error +<a href="http://library.gnome.org/devel/gio/unstable/gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned. Other possible errors are in +the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="http://library.gnome.org/devel/gio/unstable/gio-GIOError.html#G-IO-ERROR:CAPS"><code class="literal">G_IO_ERROR</code></a> domains. +</p> +<p> +The image will be scaled to fit in the requested size, optionally +preserving the image's aspect ratio. When preserving the aspect ratio, +a <em class="parameter"><code>width</code></em> of -1 will cause the image to be scaled to the exact given +height, and a <em class="parameter"><code>height</code></em> of -1 will cause the image to be scaled to the +exact given width. When not preserving aspect ratio, a <em class="parameter"><code>width</code></em> or +<em class="parameter"><code>height</code></em> of -1 means to not scale the image at all in that dimension. +</p> +<p> +The stream is not closed. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> to load the pixbuf from</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>The width the image should have or -1 to not constrain the width</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>The height the image should have or -1 to not constrain the height</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>preserve_aspect_ratio</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to preserve the image's aspect ratio</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td> +<td>optional <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>Return location for an error</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error +conditions occurred: the file could not be opened, the image format is +not supported, there was not enough memory to allocate the image buffer, +the stream contained invalid data, or the operation was cancelled.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.14</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-stream-at-scale-async"></a><h3>gdk_pixbuf_new_from_stream_at_scale_async ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_new_from_stream_at_scale_async + (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<p> +Creates a new pixbuf by asynchronously loading an image from an input stream. +</p> +<p> +For more details see <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale" title="gdk_pixbuf_new_from_stream_at_scale ()"><code class="function">gdk_pixbuf_new_from_stream_at_scale()</code></a>, which is the synchronous +version of this function. +</p> +<p> +When the operation is finished, <em class="parameter"><code>callback</code></em> will be called in the main thread. +You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-finish" title="gdk_pixbuf_new_from_stream_finish ()"><code class="function">gdk_pixbuf_new_from_stream_finish()</code></a> to get the result of the operation. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> from which to load the pixbuf</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>the width the image should have or -1 to not constrain the width</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>the height the image should have or -1 to not constrain the height</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>preserve_aspect_ratio</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to preserve the image's aspect ratio</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td> +<td>optional <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the the pixbuf is loaded</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>the data to pass to the callback function</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.24</p> +</div> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-File-Loading.see-also"></a><h2>See Also</h2> +<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a>. +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-File-saving.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-File-saving.html new file mode 100644 index 0000000..651fabd --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-File-saving.html @@ -0,0 +1,792 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>File saving</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-File-Loading.html" title="File Loading"> +<link rel="next" href="gdk-pixbuf-Image-Data-in-Memory.html" title="Image Data in Memory"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-File-Loading.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-Image-Data-in-Memory.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-File-saving.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-File-saving.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-File-saving"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-File-saving.top_of_page"></a>File saving</span></h2> +<p>File saving — Saving a pixbuf to a file.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-File-saving.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-savev" title="gdk_pixbuf_savev ()">gdk_pixbuf_savev</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_keys</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_values</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save" title="gdk_pixbuf_save ()">gdk_pixbuf_save</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code>...</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (<a class="link" href="gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc" title="GdkPixbufSaveFunc ()">*GdkPixbufSaveFunc</a>) (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> count</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback" title="gdk_pixbuf_save_to_callback ()">gdk_pixbuf_save_to_callback</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc" title="GdkPixbufSaveFunc ()"><span class="type">GdkPixbufSaveFunc</span></a> save_func</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code>...</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callbackv" title="gdk_pixbuf_save_to_callbackv ()">gdk_pixbuf_save_to_callbackv</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc" title="GdkPixbufSaveFunc ()"><span class="type">GdkPixbufSaveFunc</span></a> save_func</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_keys</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_values</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-buffer" title="gdk_pixbuf_save_to_buffer ()">gdk_pixbuf_save_to_buffer</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **buffer</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *buffer_size</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code>...</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-bufferv" title="gdk_pixbuf_save_to_bufferv ()">gdk_pixbuf_save_to_bufferv</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **buffer</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *buffer_size</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_keys</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_values</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream" title="gdk_pixbuf_save_to_stream ()">gdk_pixbuf_save_to_stream</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GOutputStream.html"><span class="type">GOutputStream</span></a> *stream</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code>...</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream-async" title="gdk_pixbuf_save_to_stream_async ()">gdk_pixbuf_save_to_stream_async</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GOutputStream.html"><span class="type">GOutputStream</span></a> *stream</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code>...</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream-finish" title="gdk_pixbuf_save_to_stream_finish ()">gdk_pixbuf_save_to_stream_finish</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *async_result</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-File-saving.description"></a><h2>Description</h2> +<p> +These functions allow to save a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> in a number of +file formats. The formatted data can be written to a file +or to a memory buffer. GdkPixBuf can also call a user-defined +callback on the data, which allows to e.g. write the image +to a socket or store it in a database. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-File-saving.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="gdk-pixbuf-savev"></a><h3>gdk_pixbuf_savev ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_savev (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_keys</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_values</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Saves pixbuf to a file in <em class="parameter"><code>type</code></em>, which is currently "jpeg", "png", "tiff", "ico" or "bmp". +If <em class="parameter"><code>error</code></em> is set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned. +See <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save" title="gdk_pixbuf_save ()"><code class="function">gdk_pixbuf_save()</code></a> for more details. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td> +<td>name of file to save.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>name of file format.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>option_keys</code></em> :</span></p></td> +<td>name of options to set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>option_values</code></em> :</span></p></td> +<td>values for named options. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>whether an error was set</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-save"></a><h3>gdk_pixbuf_save ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_save (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *filename</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Saves pixbuf to a file in format <em class="parameter"><code>type</code></em>. By default, "jpeg", "png", "ico" +and "bmp" are possible file formats to save in, but more formats may be +installed. The list of all writable formats can be determined in the +following way: +</p> +<p> +</p> +<div class="informalexample"> + <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> + <tbody> + <tr> + <td class="listing_lines" align="right"><pre>1 +2 +3 +4 +5 +6 +7 +8 +9 +10</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="type">void</span><span class="normal"> </span><span class="function">add_if_writable</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GdkPixbufFormat</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">GSList</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">list</span><span class="symbol">)</span> +<span class="cbracket">{</span> +<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-writable">gdk_pixbuf_format_is_writable</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">))</span> +<span class="normal"> </span><span class="symbol">*</span><span class="normal">list </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-prepend">g_slist_prepend</a></span><span class="normal"> </span><span class="symbol">(*</span><span class="normal">list</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">);</span> +<span class="cbracket">}</span> + +<span class="usertype">GSList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">formats </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-get-formats">gdk_pixbuf_get_formats</a></span><span class="normal"> </span><span class="symbol">();</span> +<span class="usertype">GSList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">writable_formats </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span> +<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-foreach">g_slist_foreach</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">formats</span><span class="symbol">,</span><span class="normal"> add_if_writable</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">writable_formats</span><span class="symbol">);</span> +<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free">g_slist_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">formats</span><span class="symbol">);</span></pre></td> + </tr> + </tbody> + </table> +</div> + +<p> +</p> +<p> +If <em class="parameter"><code>error</code></em> is set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned. Possible errors include +those in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> domain and those in the <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domain. +</p> +<p> +The variable argument list should be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated; if not empty, +it should contain pairs of strings that modify the save +parameters. For example: +</p> +<div class="informalexample"> + <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> + <tbody> + <tr> + <td class="listing_lines" align="right"><pre>1 +2</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save">gdk_pixbuf_save</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">,</span><span class="normal"> handle</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"jpeg"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">error</span><span class="symbol">,</span> +<span class="normal"> </span><span class="string">"quality"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"100"</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td> + </tr> + </tbody> + </table> +</div> + +<p> +</p> +<p> +Currently only few parameters exist. JPEG images can be saved with a +"quality" parameter; its value should be in the range [0,100]. +</p> +<p> +Text chunks can be attached to PNG images by specifying parameters of +the form "tEXt::key", where key is an ASCII string of length 1-79. +The values are UTF-8 encoded strings. The PNG compression level can +be specified using the "compression" parameter; it's value is in an +integer in the range of [0,9]. +</p> +<p> +ICC color profiles can also be embedded into PNG, JPEG and TIFF images. +The "icc-profile" value should be the complete ICC profile encoded +into base64. +</p> +<p> +</p> +<div class="informalexample"> + <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> + <tbody> + <tr> + <td class="listing_lines" align="right"><pre>1 +2 +3 +4 +5 +6 +7 +8</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">contents</span><span class="symbol">;</span> +<span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">contents_encode</span><span class="symbol">;</span> +<span class="usertype">gsize</span><span class="normal"> length</span><span class="symbol">;</span> +<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#g-file-get-contents">g_file_get_contents</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"/home/hughsie/.color/icc/L225W.icm"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">contents</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">length</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span> +<span class="normal">contents_encode </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Base64-Encoding.html#g-base64-encode">g_base64_encode</a></span><span class="normal"> </span><span class="symbol">((</span><span class="keyword">const</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar">guchar</a> </span><span class="symbol">*)</span><span class="normal"> contents</span><span class="symbol">,</span><span class="normal"> length</span><span class="symbol">);</span> +<span class="function"><a href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save">gdk_pixbuf_save</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">,</span><span class="normal"> handle</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"png"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">error</span><span class="symbol">,</span> +<span class="normal"> </span><span class="string">"icc-profile"</span><span class="symbol">,</span><span class="normal"> contents_encode</span><span class="symbol">,</span> +<span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td> + </tr> + </tbody> + </table> +</div> + +<p> +</p> +<p> +TIFF images recognize a "compression" option which acceps an integer value. +Among the codecs are 1 None, 2 Huffman, 5 LZW, 7 JPEG and 8 Deflate, see +the libtiff documentation and tiff.h for all supported codec values. +</p> +<p> +ICO images can be saved in depth 16, 24, or 32, by using the "depth" +parameter. When the ICO saver is given "x_hot" and "y_hot" parameters, +it produces a CUR instead of an ICO. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td> +<td>name of file to save.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>name of file format.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>list of key-value save options, followed by <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>whether an error was set</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufSaveFunc"></a><h3>GdkPixbufSaveFunc ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> (*GdkPixbufSaveFunc) (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *buf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> count</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre> +<p> +Specifies the type of the function passed to +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback" title="gdk_pixbuf_save_to_callback ()"><code class="function">gdk_pixbuf_save_to_callback()</code></a>. It is called once for each block of +bytes that is "written" by <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback" title="gdk_pixbuf_save_to_callback ()"><code class="function">gdk_pixbuf_save_to_callback()</code></a>. If +successful it should return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. If an error occurs it should set +<em class="parameter"><code>error</code></em> and return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, in which case <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback" title="gdk_pixbuf_save_to_callback ()"><code class="function">gdk_pixbuf_save_to_callback()</code></a> +will fail with the same error. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>buf</code></em> :</span></p></td> +<td>bytes to be written. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=count][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td> +<td>number of bytes in <em class="parameter"><code>buf</code></em>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>A location to return an error. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> +<td>user data passed to <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback" title="gdk_pixbuf_save_to_callback ()"><code class="function">gdk_pixbuf_save_to_callback()</code></a>. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> (with <em class="parameter"><code>error</code></em> set) if failed.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.4</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-save-to-callback"></a><h3>gdk_pixbuf_save_to_callback ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_save_to_callback (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc" title="GdkPixbufSaveFunc ()"><span class="type">GdkPixbufSaveFunc</span></a> save_func</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Saves pixbuf in format <em class="parameter"><code>type</code></em> by feeding the produced data to a +callback. Can be used when you want to store the image to something +other than a file, such as an in-memory buffer or a socket. +If <em class="parameter"><code>error</code></em> is set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned. Possible errors +include those in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> domain and whatever the save +function generates. +</p> +<p> +See <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save" title="gdk_pixbuf_save ()"><code class="function">gdk_pixbuf_save()</code></a> for more details. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>save_func</code></em> :</span></p></td> +<td>a function that is called to save each block of data that +the save routine generates. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>user data to pass to the save function.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>name of file format.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>list of key-value save options</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>whether an error was set</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.4</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-save-to-callbackv"></a><h3>gdk_pixbuf_save_to_callbackv ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_save_to_callbackv (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc" title="GdkPixbufSaveFunc ()"><span class="type">GdkPixbufSaveFunc</span></a> save_func</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_keys</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_values</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Saves pixbuf to a callback in format <em class="parameter"><code>type</code></em>, which is currently "jpeg", +"png", "tiff", "ico" or "bmp". If <em class="parameter"><code>error</code></em> is set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned. See +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback" title="gdk_pixbuf_save_to_callback ()"><code class="function">gdk_pixbuf_save_to_callback()</code></a> for more details. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>save_func</code></em> :</span></p></td> +<td>a function that is called to save each block of data that +the save routine generates. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>user data to pass to the save function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>name of file format.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>option_keys</code></em> :</span></p></td> +<td>name of options to set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>option_values</code></em> :</span></p></td> +<td>values for named options. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>whether an error was set</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.4</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-save-to-buffer"></a><h3>gdk_pixbuf_save_to_buffer ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_save_to_buffer (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **buffer</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *buffer_size</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Saves pixbuf to a new buffer in format <em class="parameter"><code>type</code></em>, which is currently "jpeg", +"png", "tiff", "ico" or "bmp". This is a convenience function that uses +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback" title="gdk_pixbuf_save_to_callback ()"><code class="function">gdk_pixbuf_save_to_callback()</code></a> to do the real work. Note that the buffer +is not nul-terminated and may contain embedded nuls. +If <em class="parameter"><code>error</code></em> is set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned and <em class="parameter"><code>buffer</code></em> will be set to +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Possible errors include those in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> +domain. +</p> +<p> +See <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save" title="gdk_pixbuf_save ()"><code class="function">gdk_pixbuf_save()</code></a> for more details. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td> +<td>location to receive a pointer +to the new buffer. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=buffer_size]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>buffer_size</code></em> :</span></p></td> +<td>location to receive the size of the new buffer.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>name of file format.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>list of key-value save options</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>whether an error was set</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.4</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-save-to-bufferv"></a><h3>gdk_pixbuf_save_to_bufferv ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_save_to_bufferv (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **buffer</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *buffer_size</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_keys</code></em>, + <em class="parameter"><code><span class="type">char</span> **option_values</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Saves pixbuf to a new buffer in format <em class="parameter"><code>type</code></em>, which is currently "jpeg", +"tiff", "png", "ico" or "bmp". See <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-buffer" title="gdk_pixbuf_save_to_buffer ()"><code class="function">gdk_pixbuf_save_to_buffer()</code></a> +for more details. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td> +<td>location to receive a pointer to the new buffer. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=buffer_size][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>buffer_size</code></em> :</span></p></td> +<td>location to receive the size of the new buffer.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>name of file format.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>option_keys</code></em> :</span></p></td> +<td>name of options to set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>option_values</code></em> :</span></p></td> +<td>values for named options. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>whether an error was set</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.4</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-save-to-stream"></a><h3>gdk_pixbuf_save_to_stream ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_save_to_stream (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GOutputStream.html"><span class="type">GOutputStream</span></a> *stream</code></em>, + <em class="parameter"><code>const <span class="type">char</span> *type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Saves <em class="parameter"><code>pixbuf</code></em> to an output stream. +</p> +<p> +Supported file formats are currently "jpeg", "tiff", "png", "ico" or +"bmp". See <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-buffer" title="gdk_pixbuf_save_to_buffer ()"><code class="function">gdk_pixbuf_save_to_buffer()</code></a> for more details. +</p> +<p> +The <em class="parameter"><code>cancellable</code></em> can be used to abort the operation from another +thread. If the operation was cancelled, the error <a href="http://library.gnome.org/devel/gio/unstable/gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> +will be returned. Other possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> +and <a href="http://library.gnome.org/devel/gio/unstable/gio-GIOError.html#G-IO-ERROR:CAPS"><code class="literal">G_IO_ERROR</code></a> domains. +</p> +<p> +The stream is not closed. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GOutputStream.html"><span class="type">GOutputStream</span></a> to save the pixbuf to</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>name of file format</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td> +<td>optional <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>return location for error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>list of key-value save options</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the pixbuf was saved successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if an +error was set.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.14</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-save-to-stream-async"></a><h3>gdk_pixbuf_save_to_stream_async ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_save_to_stream_async (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GOutputStream.html"><span class="type">GOutputStream</span></a> *stream</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *type</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, + <em class="parameter"><code>...</code></em>);</pre> +<p> +Saves <em class="parameter"><code>pixbuf</code></em> to an output stream asynchronously. +</p> +<p> +For more details see <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream" title="gdk_pixbuf_save_to_stream ()"><code class="function">gdk_pixbuf_save_to_stream()</code></a>, which is the synchronous +version of this function. +</p> +<p> +When the operation is finished, <em class="parameter"><code>callback</code></em> will be called in the main thread. +You can then call <a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream-finish" title="gdk_pixbuf_save_to_stream_finish ()"><code class="function">gdk_pixbuf_save_to_stream_finish()</code></a> to get the result of the operation. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GOutputStream.html"><span class="type">GOutputStream</span></a> to which to save the pixbuf</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td> +<td>name of file format</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td> +<td>optional <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the the pixbuf is loaded</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>the data to pass to the callback function</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> +<td>list of key-value save options</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.24</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-save-to-stream-finish"></a><h3>gdk_pixbuf_save_to_stream_finish ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_save_to_stream_finish (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *async_result</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Finishes an asynchronous pixbuf save operation started with +<a class="link" href="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream-async" title="gdk_pixbuf_save_to_stream_async ()"><code class="function">gdk_pixbuf_save_to_stream_async()</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>async_result</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the pixbuf was saved successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if an error was set.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.24</p> +</div> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Image-Data-in-Memory.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Image-Data-in-Memory.html new file mode 100644 index 0000000..c9f21fe --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Image-Data-in-Memory.html @@ -0,0 +1,438 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Image Data in Memory</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-File-saving.html" title="File saving"> +<link rel="next" href="gdk-pixbuf-Inline-data.html" title="Inline data"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-File-saving.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-Inline-data.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-Image-Data-in-Memory.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-Image-Data-in-Memory.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-Image-Data-in-Memory"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-Image-Data-in-Memory.top_of_page"></a>Image Data in Memory</span></h2> +<p>Image Data in Memory — Creating a pixbuf from image data that is already in memory.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-Image-Data-in-Memory.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new" title="gdk_pixbuf_new ()">gdk_pixbuf_new</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace"><span class="type">GdkColorspace</span></a> colorspace</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_alpha</code></em>, + <em class="parameter"><code><span class="type">int</span> bits_per_sample</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()">gdk_pixbuf_new_from_data</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *data</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace"><span class="type">GdkColorspace</span></a> colorspace</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_alpha</code></em>, + <em class="parameter"><code><span class="type">int</span> bits_per_sample</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()"><span class="type">GdkPixbufDestroyNotify</span></a> destroy_fn</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> destroy_fn_data</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-xpm-data" title="gdk_pixbuf_new_from_xpm_data ()">gdk_pixbuf_new_from_xpm_data</a> (<em class="parameter"><code>const <span class="type">char</span> **data</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline" title="gdk_pixbuf_new_from_inline ()">gdk_pixbuf_new_from_inline</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> data_length</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *data</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> copy_pixels</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-subpixbuf" title="gdk_pixbuf_new_subpixbuf ()">gdk_pixbuf_new_subpixbuf</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src_pixbuf</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-copy" title="gdk_pixbuf_copy ()">gdk_pixbuf_copy</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Image-Data-in-Memory.description"></a><h2>Description</h2> +<p> +The most basic way to create a pixbuf is to wrap an existing pixel +buffer with a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure. You can use the +<a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a> function to do this You need to specify +the destroy notification function that will be called when the +data buffer needs to be freed; this will happen when a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +is finalized by the reference counting functions If you have a +chunk of static data compiled into your application, you can pass +in <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> as the destroy notification function so that the data +will not be freed. +</p> +<p> +The <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new" title="gdk_pixbuf_new ()"><code class="function">gdk_pixbuf_new()</code></a> function can be used as a convenience to +create a pixbuf with an empty buffer. This is equivalent to +allocating a data buffer using <code class="function"><code class="function">malloc()</code></code> and +then wrapping it with <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a>. The <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new" title="gdk_pixbuf_new ()"><code class="function">gdk_pixbuf_new()</code></a> +function will compute an optimal rowstride so that rendering can be +performed with an efficient algorithm. +</p> +<p> +As a special case, you can use the <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-xpm-data" title="gdk_pixbuf_new_from_xpm_data ()"><code class="function">gdk_pixbuf_new_from_xpm_data()</code></a> +function to create a pixbuf from inline XPM image data. +</p> +<p> +You can also copy an existing pixbuf with the <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-copy" title="gdk_pixbuf_copy ()"><code class="function">gdk_pixbuf_copy()</code></a> +function. This is not the same as just doing a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> +on the old pixbuf; the copy function will actually duplicate the +pixel data in memory and create a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure for it. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Image-Data-in-Memory.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="gdk-pixbuf-new"></a><h3>gdk_pixbuf_new ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace"><span class="type">GdkColorspace</span></a> colorspace</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_alpha</code></em>, + <em class="parameter"><code><span class="type">int</span> bits_per_sample</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>);</pre> +<p> +Creates a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure and allocates a buffer for it. The +buffer has an optimal rowstride. Note that the buffer is not cleared; +you will have to fill it completely yourself. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>colorspace</code></em> :</span></p></td> +<td>Color space for image</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>has_alpha</code></em> :</span></p></td> +<td>Whether the image should have transparency information</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>bits_per_sample</code></em> :</span></p></td> +<td>Number of bits per color sample</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of image in pixels, must be > 0</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of image in pixels, must be > 0</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> with a reference count of 1, or +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be allocated for the image buffer.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-data"></a><h3>gdk_pixbuf_new_from_data ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_data (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *data</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace"><span class="type">GdkColorspace</span></a> colorspace</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_alpha</code></em>, + <em class="parameter"><code><span class="type">int</span> bits_per_sample</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()"><span class="type">GdkPixbufDestroyNotify</span></a> destroy_fn</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> destroy_fn_data</code></em>);</pre> +<p> +Creates a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> out of in-memory image data. Currently only RGB +images with 8 bits per sample are supported. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> +<td>Image data in 8-bit/sample packed format. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>colorspace</code></em> :</span></p></td> +<td>Colorspace for the image data</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>has_alpha</code></em> :</span></p></td> +<td>Whether the data has an opacity channel</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>bits_per_sample</code></em> :</span></p></td> +<td>Number of bits per sample</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of the image in pixels, must be > 0</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of the image in pixels, must be > 0</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rowstride</code></em> :</span></p></td> +<td>Distance in bytes between row starts</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>destroy_fn</code></em> :</span></p></td> +<td>Function used to free the data when the pixbuf's reference count +drops to zero, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the data should not be freed. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>destroy_fn_data</code></em> :</span></p></td> +<td>Closure data to pass to the destroy notification function. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure with a reference count of 1. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-xpm-data"></a><h3>gdk_pixbuf_new_from_xpm_data ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_xpm_data (<em class="parameter"><code>const <span class="type">char</span> **data</code></em>);</pre> +<p> +Creates a new pixbuf by parsing XPM data in memory. This data is commonly +the result of including an XPM file into a program's C source. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> +<td>Pointer to inline XPM data. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf with a reference count of 1.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-from-inline"></a><h3>gdk_pixbuf_new_from_inline ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_inline (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> data_length</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *data</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> copy_pixels</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Create a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> from a flat representation that is suitable for +storing as inline data in a program. This is useful if you want to +ship a program with images, but don't want to depend on any +external files. +</p> +<p> +gdk-pixbuf ships with a program called <span class="command"><strong>gdk-pixbuf-csource</strong></span> +which allows for conversion of <a href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbufs</span></a> into such a inline representation. +In almost all cases, you should pass the <code class="option">--raw</code> flag to +<span class="command"><strong>gdk-pixbuf-csource</strong></span>. A sample invocation would be: +</p> +<p> +</p> +<div class="informalexample"> + <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> + <tbody> + <tr> + <td class="listing_lines" align="right"><pre>1</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="normal">gdk</span><span class="symbol">-</span><span class="normal">pixbuf</span><span class="symbol">-</span><span class="normal">csource </span><span class="symbol">--</span><span class="normal">raw </span><span class="symbol">--</span><span class="normal">name</span><span class="symbol">=</span><span class="usertype">myimage_inline</span><span class="normal"> myimage</span><span class="symbol">.</span><span class="normal">png</span></pre></td> + </tr> + </tbody> + </table> +</div> + +<p> +</p> +<p> +For the typical case where the inline pixbuf is read-only static data, +you don't need to copy the pixel data unless you intend to write to +it, so you can pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for <em class="parameter"><code>copy_pixels</code></em>. (If you pass +<code class="option">--rle</code> to <span class="command"><strong>gdk-pixbuf-csource</strong></span>, a copy +will be made even if <em class="parameter"><code>copy_pixels</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, so using this option is +generally a bad idea.) +</p> +<p> +If you create a pixbuf from const inline data compiled into your +program, it's probably safe to ignore errors and disable length checks, +since things will always succeed: +</p> +<div class="informalexample"> + <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> + <tbody> + <tr> + <td class="listing_lines" align="right"><pre>1</pre></td> + <td class="listing_code"><pre class="programlisting"><span class="normal">pixbuf </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline">gdk_pixbuf_new_from_inline</a></span><span class="normal"> </span><span class="symbol">(-</span><span class="number">1</span><span class="symbol">,</span><span class="normal"> myimage_inline</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td> + </tr> + </tbody> + </table> +</div> + +<p> +</p> +<p> +For non-const inline data, you could get out of memory. For untrusted +inline data located at runtime, you could have corrupt inline data in +addition. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>data_length</code></em> :</span></p></td> +<td>Length in bytes of the <em class="parameter"><code>data</code></em> argument or -1 to +disable length checks</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> +<td>Byte data containing a +serialized <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=data_length]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>copy_pixels</code></em> :</span></p></td> +<td>Whether to copy the pixel data, or use direct pointers +<em class="parameter"><code>data</code></em> for the resulting pixbuf</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> return location, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure with a reference, +count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-new-subpixbuf"></a><h3>gdk_pixbuf_new_subpixbuf ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_subpixbuf (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src_pixbuf</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>);</pre> +<p> +Creates a new pixbuf which represents a sub-region of +<em class="parameter"><code>src_pixbuf</code></em>. The new pixbuf shares its pixels with the +original pixbuf, so writing to one affects both. +The new pixbuf holds a reference to <em class="parameter"><code>src_pixbuf</code></em>, so +<em class="parameter"><code>src_pixbuf</code></em> will not be finalized until the new pixbuf +is finalized. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_x</code></em> :</span></p></td> +<td>X coord in <em class="parameter"><code>src_pixbuf</code></em> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_y</code></em> :</span></p></td> +<td>Y coord in <em class="parameter"><code>src_pixbuf</code></em> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>width of region in <em class="parameter"><code>src_pixbuf</code></em> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>height of region in <em class="parameter"><code>src_pixbuf</code></em> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a new pixbuf. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-copy"></a><h3>gdk_pixbuf_copy ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_copy (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Creates a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> with a copy of the information in the specified +<em class="parameter"><code>pixbuf</code></em>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf with a reference count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if +not enough memory could be allocated. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Image-Data-in-Memory.see-also"></a><h2>See Also</h2> +gdk_pixbuf_finalize(). +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Inline-data.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Inline-data.html new file mode 100644 index 0000000..03d291e --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Inline-data.html @@ -0,0 +1,523 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Inline data</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-Image-Data-in-Memory.html" title="Image Data in Memory"> +<link rel="next" href="gdk-pixbuf-Scaling.html" title="Scaling"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-Image-Data-in-Memory.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-Scaling.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-Inline-data.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-Inline-data.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-Inline-data"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-Inline-data.top_of_page"></a>Inline data</span></h2> +<p>Inline data — Functions for inlined pixbuf handling.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-Inline-data.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixdata.h> + +struct <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata">GdkPixdata</a>; +enum <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdataType" title="enum GdkPixdataType">GdkPixdataType</a>; +enum <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdataDumpType" title="enum GdkPixdataDumpType">GdkPixdataDumpType</a>; +#define <a class="link" href="gdk-pixbuf-Inline-data.html#GDK-PIXBUF-MAGIC-NUMBER:CAPS" title="GDK_PIXBUF_MAGIC_NUMBER">GDK_PIXBUF_MAGIC_NUMBER</a> +#define <a class="link" href="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-HEADER-LENGTH:CAPS" title="GDK_PIXDATA_HEADER_LENGTH">GDK_PIXDATA_HEADER_LENGTH</a> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> <a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixdata-from-pixbuf" title="gdk_pixdata_from_pixbuf ()">gdk_pixdata_from_pixbuf</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> *pixdata</code></em>, + <em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_rle</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixbuf-from-pixdata" title="gdk_pixbuf_from_pixdata ()">gdk_pixbuf_from_pixdata</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> *pixdata</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> copy_pixels</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> * <a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixdata-serialize" title="gdk_pixdata_serialize ()">gdk_pixdata_serialize</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> *pixdata</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *stream_length_p</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixdata-deserialize" title="gdk_pixdata_deserialize ()">gdk_pixdata_deserialize</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> *pixdata</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> stream_length</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *stream</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> * <a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixdata-to-csource" title="gdk_pixdata_to_csource ()">gdk_pixdata_to_csource</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> *pixdata</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdataDumpType" title="enum GdkPixdataDumpType"><span class="type">GdkPixdataDumpType</span></a> dump_type</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Inline-data.description"></a><h2>Description</h2> +<p> +Using <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a>, images can be compiled into an application, +making it unnecessary to refer to external image files at runtime. +GdkPixBuf includes a utility named gdk-pixbuf-csource, which +can be used to convert image files into <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structures suitable +for inclusion in C sources. To convert the <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structures back +into <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>s, use gdk_pixbuf_from_pixdata. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Inline-data.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="GdkPixdata"></a><h3>struct GdkPixdata</h3> +<pre class="programlisting">struct GdkPixdata { + guint32 magic; /* GDK_PIXBUF_MAGIC_NUMBER */ + gint32 length; /* <1 to disable length checks, otherwise: + * GDK_PIXDATA_HEADER_LENGTH + pixel_data length + */ + guint32 pixdata_type; /* GdkPixdataType */ + guint32 rowstride; + guint32 width; + guint32 height; + guint8 *pixel_data; +}; +</pre> +<p> +A <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> contains pixbuf information in a form suitable for +serialization and streaming. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> <em class="structfield"><code><a name="GdkPixdata.magic"></a>magic</code></em>;</span></p></td> +<td>magic number. A valid <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure must have +<a class="link" href="gdk-pixbuf-Inline-data.html#GDK-PIXBUF-MAGIC-NUMBER:CAPS" title="GDK_PIXBUF_MAGIC_NUMBER"><span class="type">GDK_PIXBUF_MAGIC_NUMBER</span></a> here.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32"><span class="type">gint32</span></a> <em class="structfield"><code><a name="GdkPixdata.length"></a>length</code></em>;</span></p></td> +<td>less than 1 to disable length checks, otherwise +<a class="link" href="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-HEADER-LENGTH:CAPS" title="GDK_PIXDATA_HEADER_LENGTH"><span class="type">GDK_PIXDATA_HEADER_LENGTH</span></a> + length of <em class="parameter"><code>pixel_data</code></em>.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> <em class="structfield"><code><a name="GdkPixdata.pixdata-type"></a>pixdata_type</code></em>;</span></p></td> +<td>information about colorspace, sample width and +encoding, in a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdataType" title="enum GdkPixdataType"><span class="type">GdkPixdataType</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> <em class="structfield"><code><a name="GdkPixdata.rowstride"></a>rowstride</code></em>;</span></p></td> +<td>Distance in bytes between rows.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> <em class="structfield"><code><a name="GdkPixdata.width"></a>width</code></em>;</span></p></td> +<td>Width of the image in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> <em class="structfield"><code><a name="GdkPixdata.height"></a>height</code></em>;</span></p></td> +<td>Height of the image in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *<em class="structfield"><code><a name="GdkPixdata.pixel-data"></a>pixel_data</code></em>;</span></p></td> +<td> +<em class="parameter"><code>width</code></em> x <em class="parameter"><code>height</code></em> pixels, encoded according to <em class="parameter"><code>pixdata_type</code></em> +and <em class="parameter"><code>rowstride</code></em>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixdataType"></a><h3>enum GdkPixdataType</h3> +<pre class="programlisting">typedef enum { + /* colorspace + alpha */ + GDK_PIXDATA_COLOR_TYPE_RGB = 0x01, + GDK_PIXDATA_COLOR_TYPE_RGBA = 0x02, + GDK_PIXDATA_COLOR_TYPE_MASK = 0xff, + /* width, support 8bits only currently */ + GDK_PIXDATA_SAMPLE_WIDTH_8 = 0x01 << 16, + GDK_PIXDATA_SAMPLE_WIDTH_MASK = 0x0f << 16, + /* encoding */ + GDK_PIXDATA_ENCODING_RAW = 0x01 << 24, + GDK_PIXDATA_ENCODING_RLE = 0x02 << 24, + GDK_PIXDATA_ENCODING_MASK = 0x0f << 24 +} GdkPixdataType; +</pre> +<p> +An enumeration containing three sets of flags for a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> struct: +one for the used colorspace, one for the width of the samples and one +for the encoding of the pixel data. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><a name="GDK-PIXDATA-COLOR-TYPE-RGB:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_COLOR_TYPE_RGB</code></span></p></td> +<td>each pixel has red, green and blue samples. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-COLOR-TYPE-RGBA:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_COLOR_TYPE_RGBA</code></span></p></td> +<td>each pixel has red, green and blue samples + and an alpha value. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-COLOR-TYPE-MASK:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_COLOR_TYPE_MASK</code></span></p></td> +<td>mask for the colortype flags of the enum. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-SAMPLE-WIDTH-8:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_SAMPLE_WIDTH_8</code></span></p></td> +<td>each sample has 8 bits. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-SAMPLE-WIDTH-MASK:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_SAMPLE_WIDTH_MASK</code></span></p></td> +<td>mask for the sample width flags of the enum. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-ENCODING-RAW:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_ENCODING_RAW</code></span></p></td> +<td>the pixel data is in raw form. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-ENCODING-RLE:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_ENCODING_RLE</code></span></p></td> +<td>the pixel data is run-length encoded. Runs may + be up to 127 bytes long; their length is stored in a single byte + preceding the pixel data for the run. If a run is constant, its length + byte has the high bit set and the pixel data consists of a single pixel + which must be repeated. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-ENCODING-MASK:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_ENCODING_MASK</code></span></p></td> +<td>mask for the encoding flags of the enum. +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixdataDumpType"></a><h3>enum GdkPixdataDumpType</h3> +<pre class="programlisting">typedef enum { + /* type of source to save */ + GDK_PIXDATA_DUMP_PIXDATA_STREAM = 0, + GDK_PIXDATA_DUMP_PIXDATA_STRUCT = 1, + GDK_PIXDATA_DUMP_MACROS = 2, + /* type of variables to use */ + GDK_PIXDATA_DUMP_GTYPES = 0, + GDK_PIXDATA_DUMP_CTYPES = 1 << 8, + GDK_PIXDATA_DUMP_STATIC = 1 << 9, + GDK_PIXDATA_DUMP_CONST = 1 << 10, + /* save RLE decoder macro? */ + GDK_PIXDATA_DUMP_RLE_DECODER = 1 << 16 +} GdkPixdataDumpType; +</pre> +<p> +An enumeration which is used by <a class="link" href="gdk-pixbuf-Inline-data.html#gdk-pixdata-to-csource" title="gdk_pixdata_to_csource ()"><code class="function">gdk_pixdata_to_csource()</code></a> to +determine the form of C source to be generated. The three values +<em class="parameter"><code>GDK_PIXDATA_DUMP_PIXDATA_STREAM</code></em>, <em class="parameter"><code>GDK_PIXDATA_DUMP_PIXDATA_STRUCT</code></em> +and <em class="parameter"><code>GDK_PIXDATA_DUMP_MACROS</code></em> are mutually exclusive, as are +<em class="parameter"><code>GDK_PIXBUF_DUMP_GTYPES</code></em> and <em class="parameter"><code>GDK_PIXBUF_DUMP_CTYPES</code></em>. The remaining +elements are optional flags that can be freely added. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><a name="GDK-PIXDATA-DUMP-PIXDATA-STREAM:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_DUMP_PIXDATA_STREAM</code></span></p></td> +<td>Generate pixbuf data stream (a single + string containing a serialized <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure in network byte + order). +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-DUMP-PIXDATA-STRUCT:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_DUMP_PIXDATA_STRUCT</code></span></p></td> +<td>Generate <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure (needs + the <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure definition from gdk-pixdata.h). +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-DUMP-MACROS:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_DUMP_MACROS</code></span></p></td> +<td>Generate <code class="function">*_ROWSTRIDE</code>, + <code class="function">*_WIDTH</code>, <code class="function">*_HEIGHT</code>, + <code class="function">*_BYTES_PER_PIXEL</code> and + <code class="function">*_RLE_PIXEL_DATA</code> or <code class="function">*_PIXEL_DATA</code> + macro definitions for the image. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-DUMP-GTYPES:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_DUMP_GTYPES</code></span></p></td> +<td>Generate GLib data types instead of + standard C data types. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-DUMP-CTYPES:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_DUMP_CTYPES</code></span></p></td> +<td>Generate standard C data types instead of + GLib data types. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-DUMP-STATIC:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_DUMP_STATIC</code></span></p></td> +<td>Generate static symbols. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-DUMP-CONST:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_DUMP_CONST</code></span></p></td> +<td>Generate const symbols. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXDATA-DUMP-RLE-DECODER:CAPS"></a><span class="term"><code class="literal">GDK_PIXDATA_DUMP_RLE_DECODER</code></span></p></td> +<td>Provide a <code class="function">*_RUN_LENGTH_DECODE(image_buf, rle_data, size, bpp)</code> + macro definition to decode run-length encoded image data. +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GDK-PIXBUF-MAGIC-NUMBER:CAPS"></a><h3>GDK_PIXBUF_MAGIC_NUMBER</h3> +<pre class="programlisting">#define GDK_PIXBUF_MAGIC_NUMBER (0x47646b50) /* 'GdkP' */ +</pre> +<p> +Magic number for <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structures. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="GDK-PIXDATA-HEADER-LENGTH:CAPS"></a><h3>GDK_PIXDATA_HEADER_LENGTH</h3> +<pre class="programlisting">#define GDK_PIXDATA_HEADER_LENGTH (4 + 4 + 4 + 4 + 4 + 4) +</pre> +<p> +The length of a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure without the <em class="parameter"><code>pixel_data</code></em> pointer. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixdata-from-pixbuf"></a><h3>gdk_pixdata_from_pixbuf ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> gdk_pixdata_from_pixbuf (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> *pixdata</code></em>, + <em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_rle</code></em>);</pre> +<p> +Converts a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> to a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a>. If <em class="parameter"><code>use_rle</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the +pixel data is run-length encoded into newly-allocated memory and a +pointer to that memory is returned. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixdata</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> to fill.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>the data to fill <em class="parameter"><code>pixdata</code></em> with.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>use_rle</code></em> :</span></p></td> +<td>whether to use run-length encoding for the pixel data.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>If <em class="parameter"><code>ure_rle</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, a pointer to the newly-allocated memory +for the run-length encoded pixel data, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-from-pixdata"></a><h3>gdk_pixbuf_from_pixdata ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_from_pixdata (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> *pixdata</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> copy_pixels</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Converts a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> to a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. If <em class="parameter"><code>copy_pixels</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> or +if the pixel data is run-length-encoded, the pixel data is copied into +newly-allocated memory; otherwise it is reused. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixdata</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> to convert into a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>copy_pixels</code></em> :</span></p></td> +<td>whether to copy raw pixel data; run-length encoded +pixel data is always copied.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td>location to store possible errors.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixdata-serialize"></a><h3>gdk_pixdata_serialize ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> * gdk_pixdata_serialize (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> *pixdata</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *stream_length_p</code></em>);</pre> +<p> +Serializes a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure into a byte stream. +The byte stream consists of a straightforward writeout of the +<a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> fields in network byte order, plus the <em class="parameter"><code>pixel_data</code></em> +bytes the structure points to. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixdata</code></em> :</span></p></td> +<td>a valid <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure to serialize.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>stream_length_p</code></em> :</span></p></td> +<td>location to store the resulting stream length in.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A +newly-allocated string containing the serialized <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> +structure. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=stream_length_p][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixdata-deserialize"></a><h3>gdk_pixdata_deserialize ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixdata_deserialize (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> *pixdata</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> stream_length</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *stream</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> +<p> +Deserializes (reconstruct) a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure from a byte stream. +The byte stream consists of a straightforward writeout of the +<a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> fields in network byte order, plus the <em class="parameter"><code>pixel_data</code></em> +bytes the structure points to. +The <em class="parameter"><code>pixdata</code></em> contents are reconstructed byte by byte and are checked +for validity. This function may fail with <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-CORRUPT-IMAGE:CAPS"><code class="literal">GDK_PIXBUF_ERROR_CORRUPT_IMAGE</code></a> +or <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-UNKNOWN-TYPE:CAPS"><code class="literal">GDK_PIXBUF_ERROR_UNKNOWN_TYPE</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixdata</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure to be filled in.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>stream_length</code></em> :</span></p></td> +<td>length of the stream used for deserialization.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td> +<td>stream of bytes containing a +serialized <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> structure. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=stream_length]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to indicate failures (maybe <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors).</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>Upon successful deserialization <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned, +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixdata-to-csource"></a><h3>gdk_pixdata_to_csource ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> * gdk_pixdata_to_csource (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> *pixdata</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdataDumpType" title="enum GdkPixdataDumpType"><span class="type">GdkPixdataDumpType</span></a> dump_type</code></em>);</pre> +<p> +Generates C source code suitable for compiling images directly +into programs. +</p> +<p> +gdk-pixbuf ships with a program called <span class="command"><strong>gdk-pixbuf-csource</strong></span> +which offers a command line interface to this function. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixdata</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdata" title="struct GdkPixdata"><span class="type">GdkPixdata</span></a> to convert to C source.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td> +<td>used for naming generated data structures or macros.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dump_type</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Inline-data.html#GdkPixdataDumpType" title="enum GdkPixdataDumpType"><span class="type">GdkPixdataDumpType</span></a> determining the kind of C +source to be generated.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a newly-allocated string containing the C source form +of <em class="parameter"><code>pixdata</code></em>.</td> +</tr> +</tbody> +</table></div> +</div> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Module-Interface.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Module-Interface.html new file mode 100644 index 0000000..9604f99 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Module-Interface.html @@ -0,0 +1,1077 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Module Interface</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="GdkPixbufLoader.html" title="GdkPixbufLoader"> +<link rel="next" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html" title="gdk-pixbuf Xlib initialization"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="GdkPixbufLoader.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-Module-Interface.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-Module-Interface.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-Module-Interface"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-Module-Interface.top_of_page"></a>Module Interface</span></h2> +<p>Module Interface — Extending GdkPixBuf</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-Module-Interface.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-set-option" title="gdk_pixbuf_set_option ()">gdk_pixbuf_set_option</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-get-formats" title="gdk_pixbuf_get_formats ()">gdk_pixbuf_get_formats</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-copy" title="gdk_pixbuf_format_copy ()">gdk_pixbuf_format_copy</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-free" title="gdk_pixbuf_format_free ()">gdk_pixbuf_format_free</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-name" title="gdk_pixbuf_format_get_name ()">gdk_pixbuf_format_get_name</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-description" title="gdk_pixbuf_format_get_description ()">gdk_pixbuf_format_get_description</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-mime-types" title="gdk_pixbuf_format_get_mime_types ()">gdk_pixbuf_format_get_mime_types</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-extensions" title="gdk_pixbuf_format_get_extensions ()">gdk_pixbuf_format_get_extensions</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-writable" title="gdk_pixbuf_format_is_writable ()">gdk_pixbuf_format_is_writable</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-scalable" title="gdk_pixbuf_format_is_scalable ()">gdk_pixbuf_format_is_scalable</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-disabled" title="gdk_pixbuf_format_is_disabled ()">gdk_pixbuf_format_is_disabled</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-set-disabled" title="gdk_pixbuf_format_set_disabled ()">gdk_pixbuf_format_set_disabled</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> disabled</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-license" title="gdk_pixbuf_format_get_license ()">gdk_pixbuf_format_get_license</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>); +struct <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat">GdkPixbufFormat</a>; +enum <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormatFlags" title="enum GdkPixbufFormatFlags">GdkPixbufFormatFlags</a>; +struct <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern" title="struct GdkPixbufModulePattern">GdkPixbufModulePattern</a>; +<span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc" title="GdkPixbufModuleFillVtableFunc ()">*GdkPixbufModuleFillVtableFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> *module</code></em>); +<span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillInfoFunc" title="GdkPixbufModuleFillInfoFunc ()">*GdkPixbufModuleFillInfoFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *info</code></em>); +<span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleSizeFunc" title="GdkPixbufModuleSizeFunc ()">*GdkPixbufModuleSizeFunc</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *width</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); +<span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePreparedFunc" title="GdkPixbufModulePreparedFunc ()">*GdkPixbufModulePreparedFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *anim</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); +<span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleUpdatedFunc" title="GdkPixbufModuleUpdatedFunc ()">*GdkPixbufModuleUpdatedFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>); +struct <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule">GdkPixbufModule</a>; + +struct <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationClass" title="struct GdkPixbufAnimationClass">GdkPixbufAnimationClass</a>; +struct <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationIterClass" title="struct GdkPixbufAnimationIterClass">GdkPixbufAnimationIterClass</a>; +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Module-Interface.description"></a><h2>Description</h2> +<p> +If GdkPixBuf has been compiled with GModule support, it can be extended by +modules which can load (and perhaps also save) new image and animation +formats. Each loadable module must export a +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillInfoFunc" title="GdkPixbufModuleFillInfoFunc ()"><span class="type">GdkPixbufModuleFillInfoFunc</span></a> function named <code class="function">fill_info</code> and +a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc" title="GdkPixbufModuleFillVtableFunc ()"><span class="type">GdkPixbufModuleFillVtableFunc</span></a> function named +<code class="function">fill_vtable</code>. +</p> +<p> +In order to make format-checking work before actually loading the modules +(which may require dlopening image libraries), modules export their +signatures (and other information) via the <code class="function">fill_info</code> +function. An external utility, <span class="command"><strong>gdk-pixbuf-query-loaders</strong></span>, +uses this to create a text file containing a list of all available loaders and +their signatures. This file is then read at runtime by GdkPixBuf to obtain +the list of available loaders and their signatures. +</p> +<p> +Modules may only implement a subset of the functionality available via +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a>. If a particular functionality is not implemented, the +<code class="function">fill_vtable</code> function will simply not set the corresponding +function pointers of the <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> structure. If a module supports +incremental loading (i.e. provides <span class="type">begin_load</span>, <span class="type">stop_load</span> and +<span class="type">load_increment</span>), it doesn't have to implement <span class="type">load</span>, since GdkPixBuf can +supply a generic <span class="type">load</span> implementation wrapping the incremental loading. +</p> +<p> +Installing a module is a two-step process: +</p> +<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> +<li class="listitem"><p>copy the module file(s) to the loader directory (normally +<code class="filename"><em class="replaceable"><code>libdir</code></em>/gtk-2.0/<em class="replaceable"><code>version</code></em>/loaders</code>, +unless overridden by the environment variable +<code class="envar">GDK_PIXBUF_MODULEDIR</code>) +</p></li> +<li class="listitem"><p>call <span class="command"><strong>gdk-pixbuf-query-loaders</strong></span> to update the +module file (normally +<code class="filename"><em class="replaceable"><code>sysconfdir</code></em>/gtk-2.0/gdk-pixbuf.loaders</code>, +unless overridden by the environment variable +<code class="envar">GDK_PIXBUF_MODULE_FILE</code>) +</p></li> +</ul></div> +<p> +</p> +<p> +The GdkPixBuf interfaces needed for implementing modules are contained in +<code class="filename">gdk-pixbuf-io.h</code> (and +<code class="filename">gdk-pixbuf-animation.h</code> if the module supports animations). +They are not covered by the same stability guarantees as the regular +GdkPixBuf API. To underline this fact, they are protected by +<code class="literal">#ifdef GDK_PIXBUF_ENABLE_BACKEND</code>. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Module-Interface.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="gdk-pixbuf-set-option"></a><h3>gdk_pixbuf_set_option ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_set_option (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre> +<p> +Attaches a key/value pair as an option to a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. If <em class="parameter"><code>key</code></em> already +exists in the list of options attached to <em class="parameter"><code>pixbuf</code></em>, the new value is +ignored and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td> +<td>a nul-terminated string.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td> +<td>a nul-terminated string.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-formats"></a><h3>gdk_pixbuf_get_formats ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * gdk_pixbuf_get_formats (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +Obtains the available information about the image formats supported +by GdkPixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A list of +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>s describing the supported +image formats. The list should be freed when it is no longer needed, +but the structures themselves are owned by <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> and should not be +freed. <span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkPixbufFormat]</span> +</td> +</tr></tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-copy"></a><h3>gdk_pixbuf_format_copy ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * gdk_pixbuf_format_copy (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre> +<p> +Creates a copy of <em class="parameter"><code>format</code></em> +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the newly allocated copy of a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>. Use +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-free" title="gdk_pixbuf_format_free ()"><code class="function">gdk_pixbuf_format_free()</code></a> to free the resources when done</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.22</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-free"></a><h3>gdk_pixbuf_format_free ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_format_free (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre> +<p> +Frees the resources allocated when copying a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +using <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-copy" title="gdk_pixbuf_format_copy ()"><code class="function">gdk_pixbuf_format_copy()</code></a> +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr></tbody> +</table></div> +<p class="since">Since 2.22</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-get-name"></a><h3>gdk_pixbuf_format_get_name ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gdk_pixbuf_format_get_name (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre> +<p> +Returns the name of the format. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the name of the format.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-get-description"></a><h3>gdk_pixbuf_format_get_description ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gdk_pixbuf_format_get_description (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre> +<p> +Returns a description of the format. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a description of the format.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-get-mime-types"></a><h3>gdk_pixbuf_format_get_mime_types ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** gdk_pixbuf_format_get_mime_types (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre> +<p> +Returns the mime types supported by the format. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of mime types which must be freed with +<a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when it is no longer needed. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-get-extensions"></a><h3>gdk_pixbuf_format_get_extensions ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** gdk_pixbuf_format_get_extensions (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre> +<p> +Returns the filename extensions typically used for files in the +given format. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of filename extensions which must be +freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when it is no longer needed. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-is-writable"></a><h3>gdk_pixbuf_format_is_writable ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_format_is_writable (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre> +<p> +Returns whether pixbufs can be saved in the given format. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>whether pixbufs can be saved in the given format.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-is-scalable"></a><h3>gdk_pixbuf_format_is_scalable ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_format_is_scalable (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre> +<p> +Returns whether this image format is scalable. If a file is in a +scalable format, it is preferable to load it at the desired size, +rather than loading it at the default size and scaling the +resulting pixbuf to the desired size. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>whether this image format is scalable.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.6</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-is-disabled"></a><h3>gdk_pixbuf_format_is_disabled ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_format_is_disabled (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre> +<p> +Returns whether this image format is disabled. See +<a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-set-disabled" title="gdk_pixbuf_format_set_disabled ()"><code class="function">gdk_pixbuf_format_set_disabled()</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>whether this image format is disabled.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.6</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-set-disabled"></a><h3>gdk_pixbuf_format_set_disabled ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_format_set_disabled (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> disabled</code></em>);</pre> +<p> +Disables or enables an image format. If a format is disabled, +gdk-pixbuf won't use the image loader for this format to load +images. Applications can use this to avoid using image loaders +with an inappropriate license, see <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-license" title="gdk_pixbuf_format_get_license ()"><code class="function">gdk_pixbuf_format_get_license()</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>disabled</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to disable the format <em class="parameter"><code>format</code></em> +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.6</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-format-get-license"></a><h3>gdk_pixbuf_format_get_license ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gdk_pixbuf_format_get_license (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre> +<p> +Returns information about the license of the image loader for the format. The +returned string should be a shorthand for a wellknown license, e.g. "LGPL", +"GPL", "QPL", "GPL/QPL", or "other" to indicate some other license. This +string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when it's no longer needed. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>a string describing the license of <em class="parameter"><code>format</code></em>.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.6</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufFormat"></a><h3>struct GdkPixbufFormat</h3> +<pre class="programlisting">struct GdkPixbufFormat { + gchar *name; + GdkPixbufModulePattern *signature; + gchar *domain; + gchar *description; + gchar **mime_types; + gchar **extensions; + guint32 flags; + gboolean disabled; + gchar *license; +}; +</pre> +<p> +A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> contains information about the image format accepted by a +module. Only modules should access the fields directly, applications should +use the <code class="function">gdk_pixbuf_format_*</code> functions. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GdkPixbufFormat.name"></a>name</code></em>;</span></p></td> +<td>the name of the image format.</td> +</tr> +<tr> +<td><p><span class="term"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern" title="struct GdkPixbufModulePattern"><span class="type">GdkPixbufModulePattern</span></a> *<em class="structfield"><code><a name="GdkPixbufFormat.signature"></a>signature</code></em>;</span></p></td> +<td>the signature of the module.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GdkPixbufFormat.domain"></a>domain</code></em>;</span></p></td> +<td>the message domain for the <em class="parameter"><code>description</code></em>.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GdkPixbufFormat.description"></a>description</code></em>;</span></p></td> +<td>a description of the image format.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **<em class="structfield"><code><a name="GdkPixbufFormat.mime-types"></a>mime_types</code></em>;</span></p></td> +<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of MIME types for the image format.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **<em class="structfield"><code><a name="GdkPixbufFormat.extensions"></a>extensions</code></em>;</span></p></td> +<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of typical filename extensions for the +image format.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> <em class="structfield"><code><a name="GdkPixbufFormat.flags"></a>flags</code></em>;</span></p></td> +<td>a combination of <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormatFlags" title="enum GdkPixbufFormatFlags"><span class="type">GdkPixbufFormatFlags</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> <em class="structfield"><code><a name="GdkPixbufFormat.disabled"></a>disabled</code></em>;</span></p></td> +<td>a boolean determining whether the loader is disabled.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GdkPixbufFormat.license"></a>license</code></em>;</span></p></td> +<td>a string containing license information, typically set to +shorthands like "GPL", "LGPL", etc.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufFormatFlags"></a><h3>enum GdkPixbufFormatFlags</h3> +<pre class="programlisting">typedef enum { + GDK_PIXBUF_FORMAT_WRITABLE = 1 << 0, + GDK_PIXBUF_FORMAT_SCALABLE = 1 << 1, + GDK_PIXBUF_FORMAT_THREADSAFE = 1 << 2 +} GdkPixbufFormatFlags; +</pre> +<p> +Flags which allow a module to specify further details about the supported +operations. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><a name="GDK-PIXBUF-FORMAT-WRITABLE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_FORMAT_WRITABLE</code></span></p></td> +<td>the module can write out images in the format. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-FORMAT-SCALABLE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_FORMAT_SCALABLE</code></span></p></td> +<td>the image format is scalable +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-FORMAT-THREADSAFE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_FORMAT_THREADSAFE</code></span></p></td> +<td>the module is threadsafe. If this flag is not + set, &gdk-pixbuf; will use a lock to prevent multiple threads from using + this module at the same time. (Since 2.6) +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufModulePattern"></a><h3>struct GdkPixbufModulePattern</h3> +<pre class="programlisting">struct GdkPixbufModulePattern { + char *prefix; + char *mask; + int relevance; +}; +</pre> +<p> +The signature of a module is a set of prefixes. Prefixes are encoded as +pairs of ordinary strings, where the second string, called the mask, if +not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, must be of the same length as the first one and may contain +' ', '!', 'x', 'z', and 'n' to indicate bytes that must be matched, +not matched, "don't-care"-bytes, zeros and non-zeros. +Each prefix has an associated integer that describes the relevance of +the prefix, with 0 meaning a mismatch and 100 a "perfect match". +</p> +<p> +Starting with &gdk-pixbuf; 2.8, the first byte of the mask may be '*', +indicating an unanchored pattern that matches not only at the beginning, +but also in the middle. Versions prior to 2.8 will interpret the '*' +like an 'x'. +</p> +<p> +The signature of a module is stored as an array of +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern" title="struct GdkPixbufModulePattern"><span class="type">GdkPixbufModulePattern</span></a>s. The array is terminated by a pattern +where the <em class="parameter"><code>prefix</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. +</p> +<p> +</p> +<div class="informalexample"> +<pre class="programlisting"> +GdkPixbufModulePattern *signature[] = { + { "abcdx", " !x z", 100 }, + { "bla", NULL, 90 }, + { NULL, NULL, 0 } +}; +</pre> +The example matches e.g. "auud\0" with relevance 100, and "blau" with +relevance 90.</div> +<p> +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><span class="type">char</span> *<em class="structfield"><code><a name="GdkPixbufModulePattern.prefix"></a>prefix</code></em>;</span></p></td> +<td>the prefix for this pattern</td> +</tr> +<tr> +<td><p><span class="term"><span class="type">char</span> *<em class="structfield"><code><a name="GdkPixbufModulePattern.mask"></a>mask</code></em>;</span></p></td> +<td>mask containing bytes which modify how the prefix is matched against +test data</td> +</tr> +<tr> +<td><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="GdkPixbufModulePattern.relevance"></a>relevance</code></em>;</span></p></td> +<td>relevance of this pattern</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufModuleFillVtableFunc"></a><h3>GdkPixbufModuleFillVtableFunc ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleFillVtableFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> *module</code></em>);</pre> +<p> +Defines the type of the function used to set the vtable of a +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> when it is loaded. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>module</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a>.</td> +</tr></tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufModuleFillInfoFunc"></a><h3>GdkPixbufModuleFillInfoFunc ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleFillInfoFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *info</code></em>);</pre> +<p> +Defines the type of the function used to fill a +<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> structure with information about a module. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>.</td> +</tr></tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufModuleSizeFunc"></a><h3>GdkPixbufModuleSizeFunc ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleSizeFunc) (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *width</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<p> +Defines the type of the function that gets called once the size +of the loaded image is known. +</p> +<p> +The function is expected to set <em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em> to the desired +size to which the image should be scaled. If a module has no efficient +way to achieve the desired scaling during the loading of the image, it may +either ignore the size request, or only approximate it -- &gdk-pixbuf; will +then perform the required scaling on the completely loaded image. +</p> +<p> +If the function sets <em class="parameter"><code>width</code></em> or <em class="parameter"><code>height</code></em> to zero, the module should interpret +this as a hint that it will be closed soon and shouldn't allocate further +resources. This convention is used to implement <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-get-file-info" title="gdk_pixbuf_get_file_info ()"><code class="function">gdk_pixbuf_get_file_info()</code></a> +efficiently. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>pointer to a location containing the current image width</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>pointer to a location containing the current image height</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>the loader.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufModulePreparedFunc"></a><h3>GdkPixbufModulePreparedFunc ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModulePreparedFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *anim</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<p> +Defines the type of the function that gets called once the initial +setup of <em class="parameter"><code>pixbuf</code></em> is done. +</p> +<p> +<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> uses a function of this type to emit the +"<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-prepared" title='The "area-prepared" signal'>area_prepared</a>" +signal. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> that is currently being loaded.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>anim</code></em> :</span></p></td> +<td>if an animation is being loaded, the <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a>, else <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>the loader.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufModuleUpdatedFunc"></a><h3>GdkPixbufModuleUpdatedFunc ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleUpdatedFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> +<p> +Defines the type of the function that gets called every time a region +of <em class="parameter"><code>pixbuf</code></em> is updated. +</p> +<p> +<a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> uses a function of this type to emit the +"<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-updated" title='The "area-updated" signal'>area_updated</a>" +signal. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> that is currently being loaded.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> +<td>the X origin of the updated area.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> +<td>the Y origin of the updated area.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>the width of the updated area.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>the height of the updated area.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> +<td>the loader.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.2</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufModule"></a><h3>struct GdkPixbufModule</h3> +<pre class="programlisting">struct GdkPixbufModule { + char *module_name; + char *module_path; + GModule *module; + GdkPixbufFormat *info; + + GdkPixbuf *(* load) (FILE *f, + GError **error); + GdkPixbuf *(* load_xpm_data) (const char **data); + + /* Incremental loading */ + + gpointer (* begin_load) (GdkPixbufModuleSizeFunc size_func, + GdkPixbufModulePreparedFunc prepare_func, + GdkPixbufModuleUpdatedFunc update_func, + gpointer user_data, + GError **error); + gboolean (* stop_load) (gpointer context, + GError **error); + gboolean (* load_increment) (gpointer context, + const guchar *buf, + guint size, + GError **error); + + /* Animation loading */ + GdkPixbufAnimation *(* load_animation) (FILE *f, + GError **error); + + /* Saving */ + gboolean (* save) (FILE *f, + GdkPixbuf *pixbuf, + gchar **param_keys, + gchar **param_values, + GError **error); + + gboolean (*save_to_callback) (GdkPixbufSaveFunc save_func, + gpointer user_data, + GdkPixbuf *pixbuf, + gchar **option_keys, + gchar **option_values, + GError **error); +}; +</pre> +<p> +A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> contains the necessary functions to load and save +images in a certain file format. +</p> +<p> +A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> can be loaded dynamically from a <a href="http://library.gnome.org/devel/glib/unstable/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a>. +Each loadable module must contain a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc" title="GdkPixbufModuleFillVtableFunc ()"><span class="type">GdkPixbufModuleFillVtableFunc</span></a> function +named <code class="function">fill_vtable</code>, which will get called when the module +is loaded and must set the function pointers of the <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><span class="type">char</span> *<em class="structfield"><code><a name="GdkPixbufModule.module-name"></a>module_name</code></em>;</span></p></td> +<td>the name of the module, usually the same as the +usual file extension for images of this type, eg. "xpm", "jpeg" or "png".</td> +</tr> +<tr> +<td><p><span class="term"><span class="type">char</span> *<em class="structfield"><code><a name="GdkPixbufModule.module-path"></a>module_path</code></em>;</span></p></td> +<td>the path from which the module is loaded.</td> +</tr> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a> *<em class="structfield"><code><a name="GdkPixbufModule.module"></a>module</code></em>;</span></p></td> +<td>the loaded <a href="http://library.gnome.org/devel/glib/unstable/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *<em class="structfield"><code><a name="GdkPixbufModule.info"></a>info</code></em>;</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> holding information about the module.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.load"></a>load</code></em> ()</span></p></td> +<td>loads an image from a file.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.load-xpm-data"></a>load_xpm_data</code></em> ()</span></p></td> +<td>loads an image from data in memory.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.begin-load"></a>begin_load</code></em> ()</span></p></td> +<td>begins an incremental load.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.stop-load"></a>stop_load</code></em> ()</span></p></td> +<td>stops an incremental load.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.load-increment"></a>load_increment</code></em> ()</span></p></td> +<td>continues an incremental load.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.load-animation"></a>load_animation</code></em> ()</span></p></td> +<td>loads an animation from a file.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.save"></a>save</code></em> ()</span></p></td> +<td>saves a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> to a file.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.save-to-callback"></a>save_to_callback</code></em> ()</span></p></td> +<td>saves a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> by calling the given <a class="link" href="gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc" title="GdkPixbufSaveFunc ()"><span class="type">GdkPixbufSaveFunc</span></a>.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufAnimationClass"></a><h3>struct GdkPixbufAnimationClass</h3> +<pre class="programlisting">struct GdkPixbufAnimationClass { + GObjectClass parent_class; + + + gboolean (*is_static_image) (GdkPixbufAnimation *anim); + + GdkPixbuf* (*get_static_image) (GdkPixbufAnimation *anim); + + void (*get_size) (GdkPixbufAnimation *anim, + int *width, + int *height); + + GdkPixbufAnimationIter* (*get_iter) (GdkPixbufAnimation *anim, + const GTimeVal *start_time); +}; +</pre> +<p> +Modules supporting animations must derive a type from +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a>, providing suitable implementations of the +virtual functions. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="GdkPixbufAnimationClass.parent-class"></a>parent_class</code></em>;</span></p></td> +<td>the parent class</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationClass.is-static-image"></a>is_static_image</code></em> ()</span></p></td> +<td>returns whether the given animation is just a static image.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationClass.get-static-image"></a>get_static_image</code></em> ()</span></p></td> +<td>returns a static image representing the given animation.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationClass.get-size"></a>get_size</code></em> ()</span></p></td> +<td>fills <em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em> with the frame size of the animation.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationClass.get-iter"></a>get_iter</code></em> ()</span></p></td> +<td>returns an iterator for the given animation.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufAnimationIterClass"></a><h3>struct GdkPixbufAnimationIterClass</h3> +<pre class="programlisting">struct GdkPixbufAnimationIterClass { + GObjectClass parent_class; + + + int (*get_delay_time) (GdkPixbufAnimationIter *iter); + + GdkPixbuf* (*get_pixbuf) (GdkPixbufAnimationIter *iter); + + gboolean (*on_currently_loading_frame) (GdkPixbufAnimationIter *iter); + + gboolean (*advance) (GdkPixbufAnimationIter *iter, + const GTimeVal *current_time); +}; +</pre> +<p> +Modules supporting animations must derive a type from +<a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a>, providing suitable implementations of the +virtual functions. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="GdkPixbufAnimationIterClass.parent-class"></a>parent_class</code></em>;</span></p></td> +<td>the parent class</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationIterClass.get-delay-time"></a>get_delay_time</code></em> ()</span></p></td> +<td>returns the time in milliseconds that the current frame +should be shown.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationIterClass.get-pixbuf"></a>get_pixbuf</code></em> ()</span></p></td> +<td>returns the current frame.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationIterClass.on-currently-loading-frame"></a>on_currently_loading_frame</code></em> ()</span></p></td> +<td>returns whether the current frame of <em class="parameter"><code>iter</code></em> is +being loaded.</td> +</tr> +<tr> +<td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationIterClass.advance"></a>advance</code></em> ()</span></p></td> +<td>advances the iterator to <em class="parameter"><code>current_time</code></em>, possibly changing the +current frame.</td> +</tr> +</tbody> +</table></div> +</div> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html new file mode 100644 index 0000000..6e1bcf0 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html @@ -0,0 +1,180 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Reference Counting and Memory Mangement</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure"> +<link rel="next" href="gdk-pixbuf-File-Loading.html" title="File Loading"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-The-GdkPixbuf-Structure.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-File-Loading.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-Reference-Counting-and-Memory-Mangement.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-Reference-Counting-and-Memory-Mangement.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.top_of_page"></a>Reference Counting and Memory Mangement</span></h2> +<p>Reference Counting and Memory Mangement — Functions for reference counting and memory management on pixbufs.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-ref" title="gdk_pixbuf_ref ()">gdk_pixbuf_ref</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref" title="gdk_pixbuf_unref ()">gdk_pixbuf_unref</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()">*GdkPixbufDestroyNotify</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *pixels</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.description"></a><h2>Description</h2> +<p> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structures are reference counted. This means that an +application can share a single pixbuf among many parts of the +code. When a piece of the program needs to keep a pointer to a +pixbuf, it should add a reference to it by calling <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>. +When it no longer needs the pixbuf, it should subtract a reference +by calling <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. The pixbuf will be destroyed when +its reference count drops to zero. Newly-created <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +structures start with a reference count of one. +</p> +<p> +</p> +<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> +<h3 class="title">Note</h3> +As <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> is derived from <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> now, <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-ref" title="gdk_pixbuf_ref ()"><code class="function">gdk_pixbuf_ref()</code></a> and +<a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref" title="gdk_pixbuf_unref ()"><code class="function">gdk_pixbuf_unref()</code></a> are deprecated in favour of <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> +and <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> resp. +</div> +<p> +</p> +<p> +<span class="emphasis"><em>Finalizing</em></span> a pixbuf means to free its pixel +data and to free the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure itself. Most of the +library functions that create <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structures create the +pixel data by themselves and define the way it should be freed; +you do not need to worry about those. The only function that lets +you specify how to free the pixel data is +<a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a>. Since you pass it a pre-allocated +pixel buffer, you must also specify a way to free that data. This +is done with a function of type <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()"><span class="type">GdkPixbufDestroyNotify</span></a>. When a +pixbuf created with <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a> is finalized, your +destroy notification function will be called, and it is its +responsibility to free the pixel array. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="gdk-pixbuf-ref"></a><h3>gdk_pixbuf_ref ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_ref (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> +<h3 class="title">Warning</h3> +<p><code class="literal">gdk_pixbuf_ref</code> has been deprecated since version 2.0 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>.</p> +</div> +<p> +Adds a reference to a pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>The same as the <em class="parameter"><code>pixbuf</code></em> argument.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-unref"></a><h3>gdk_pixbuf_unref ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_unref (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> +<h3 class="title">Warning</h3> +<p><code class="literal">gdk_pixbuf_unref</code> has been deprecated since version 2.0 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p> +</div> +<p> +Removes a reference from a pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufDestroyNotify"></a><h3>GdkPixbufDestroyNotify ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufDestroyNotify) (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *pixels</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre> +<p> +A function of this type is responsible for freeing the pixel array +of a pixbuf. The <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a> function lets you +pass in a pre-allocated pixel array so that a pixbuf can be +created from it; in this case you will need to pass in a function +of <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()"><span class="type">GdkPixbufDestroyNotify</span></a> so that the pixel data can be freed +when the pixbuf is finalized. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixels</code></em> :</span></p></td> +<td>The pixel array of the pixbuf +that is being finalized. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td> +<td>User closure data. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.see-also"></a><h2>See Also</h2> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a>. +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Scaling.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Scaling.html new file mode 100644 index 0000000..b301487 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Scaling.html @@ -0,0 +1,779 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Scaling</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-Inline-data.html" title="Inline data"> +<link rel="next" href="gdk-pixbuf-gdk-pixbuf-rendering.html" title="Rendering"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-Inline-data.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-gdk-pixbuf-rendering.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-Scaling.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-Scaling.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-Scaling"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-Scaling.top_of_page"></a>Scaling</span></h2> +<p>Scaling — Scaling pixbufs and scaling and compositing pixbufs</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-Scaling.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +enum <a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType">GdkInterpType</a>; +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()">gdk_pixbuf_scale_simple</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_width</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()">gdk_pixbuf_scale</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_width</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_height</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_x</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_y</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_x</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_y</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple" title="gdk_pixbuf_composite_color_simple ()">gdk_pixbuf_composite_color_simple</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_width</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>, + <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>, + <em class="parameter"><code><span class="type">int</span> check_size</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color1</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color2</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite" title="gdk_pixbuf_composite ()">gdk_pixbuf_composite</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_width</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_height</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_x</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_y</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_x</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_y</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>, + <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color" title="gdk_pixbuf_composite_color ()">gdk_pixbuf_composite_color</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_width</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_height</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_x</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_y</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_x</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_y</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>, + <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>, + <em class="parameter"><code><span class="type">int</span> check_x</code></em>, + <em class="parameter"><code><span class="type">int</span> check_y</code></em>, + <em class="parameter"><code><span class="type">int</span> check_size</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color1</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color2</code></em>); +enum <a class="link" href="gdk-pixbuf-Scaling.html#GdkPixbufRotation" title="enum GdkPixbufRotation">GdkPixbufRotation</a>; +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-rotate-simple" title="gdk_pixbuf_rotate_simple ()">gdk_pixbuf_rotate_simple</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkPixbufRotation" title="enum GdkPixbufRotation"><span class="type">GdkPixbufRotation</span></a> angle</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-flip" title="gdk_pixbuf_flip ()">gdk_pixbuf_flip</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> horizontal</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Scaling.description"></a><h2>Description</h2> +<p> +The GdkPixBuf contains functions to scale pixbufs, to scale +pixbufs and composite against an existing image, and to scale +pixbufs and composite against a solid color or checkerboard. +Compositing a checkerboard is a common way to show an image with +an alpha channel in image-viewing and editing software. +</p> +<p> +Since the full-featured functions (<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()"><code class="function">gdk_pixbuf_scale()</code></a>, +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite" title="gdk_pixbuf_composite ()"><code class="function">gdk_pixbuf_composite()</code></a>, and <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color" title="gdk_pixbuf_composite_color ()"><code class="function">gdk_pixbuf_composite_color()</code></a>) are +rather complex to use and have many arguments, two simple +convenience functions are provided, <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()"><code class="function">gdk_pixbuf_scale_simple()</code></a> and +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple" title="gdk_pixbuf_composite_color_simple ()"><code class="function">gdk_pixbuf_composite_color_simple()</code></a> which create a new pixbuf of a +given size, scale an original image to fit, and then return the +new pixbuf. +</p> +<p> +Scaling and compositing functions take advantage of MMX hardware +acceleration on systems where MMX is supported. If gdk-pixbuf is built +with the Sun mediaLib library, these functions are instead accelerated +using mediaLib, which provides hardware acceleration on Intel, AMD, +and Sparc chipsets. If desired, mediaLib support can be turned off by +setting the GDK_DISABLE_MEDIALIB environment variable. +</p> +<p> +The following example demonstrates handling an expose event by +rendering the appropriate area of a source image (which is scaled +to fit the widget) onto the widget's window. The source image is +rendered against a checkerboard, which provides a visual +representation of the alpha channel if the image has one. If the +image doesn't have an alpha channel, calling +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color" title="gdk_pixbuf_composite_color ()"><code class="function">gdk_pixbuf_composite_color()</code></a> function has exactly the same effect +as calling <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()"><code class="function">gdk_pixbuf_scale()</code></a>. +</p> +<p> +</p> +<div class="example"> +<a name="idp11101584"></a><p class="title"><b>Example 2. Handling an expose event.</b></p> +<div class="example-contents"> +<p> +</p> +<pre class="programlisting"> +gboolean +expose_cb (GtkWidget *widget, GdkEventExpose *event, gpointer data) +{ + GdkPixbuf *dest; + + dest = gdk_pixbuf_new (GDK_COLORSPACE_RGB, FALSE, 8, event->area.width, event->area.height); + + gdk_pixbuf_composite_color (pixbuf, dest, + 0, 0, event->area.width, event->area.height, + -event->area.x, -event->area.y, + (double) widget->allocation.width / gdk_pixbuf_get_width (pixbuf), + (double) widget->allocation.height / gdk_pixbuf_get_height (pixbuf), + GDK_INTERP_BILINEAR, 255, + event->area.x, event->area.y, 16, 0xaaaaaa, 0x555555); + + gdk_draw_pixbuf (widget->window, widget->style->fg_gc[GTK_STATE_NORMAL], dest, + 0, 0, event->area.x, event->area.y, + event->area.width, event->area.height, + GDK_RGB_DITHER_NORMAL, event->area.x, event->area.y); + + gdk_pixbuf_unref (dest); + + return TRUE; +} +</pre> +<p> +</p> +</div> +</div> +<p><br class="example-break"> +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Scaling.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="GdkInterpType"></a><h3>enum GdkInterpType</h3> +<pre class="programlisting">typedef enum { + GDK_INTERP_NEAREST, + GDK_INTERP_TILES, + GDK_INTERP_BILINEAR, + GDK_INTERP_HYPER +} GdkInterpType; +</pre> +<p> +This enumeration describes the different interpolation modes that + can be used with the scaling functions. <em class="parameter"><code>GDK_INTERP_NEAREST</code></em> is + the fastest scaling method, but has horrible quality when + scaling down. <em class="parameter"><code>GDK_INTERP_BILINEAR</code></em> is the best choice if you + aren't sure what to choose, it has a good speed/quality balance. +</p> +<p> + </p> +<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> +<h3 class="title">Note</h3> + Cubic filtering is missing from the list; hyperbolic + interpolation is just as fast and results in higher quality. + </div> +<p> +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><a name="GDK-INTERP-NEAREST:CAPS"></a><span class="term"><code class="literal">GDK_INTERP_NEAREST</code></span></p></td> +<td>Nearest neighbor sampling; this is the fastest + and lowest quality mode. Quality is normally unacceptable when scaling + down, but may be OK when scaling up. +</td> +</tr> +<tr> +<td><p><a name="GDK-INTERP-TILES:CAPS"></a><span class="term"><code class="literal">GDK_INTERP_TILES</code></span></p></td> +<td>This is an accurate simulation of the PostScript + image operator without any interpolation enabled. Each pixel is + rendered as a tiny parallelogram of solid color, the edges of which + are implemented with antialiasing. It resembles nearest neighbor for + enlargement, and bilinear for reduction. +</td> +</tr> +<tr> +<td><p><a name="GDK-INTERP-BILINEAR:CAPS"></a><span class="term"><code class="literal">GDK_INTERP_BILINEAR</code></span></p></td> +<td>Best quality/speed balance; use this mode by + default. Bilinear interpolation. For enlargement, it is + equivalent to point-sampling the ideal bilinear-interpolated image. + For reduction, it is equivalent to laying down small tiles and + integrating over the coverage area. +</td> +</tr> +<tr> +<td><p><a name="GDK-INTERP-HYPER:CAPS"></a><span class="term"><code class="literal">GDK_INTERP_HYPER</code></span></p></td> +<td>This is the slowest and highest quality + reconstruction function. It is derived from the hyperbolic filters in + Wolberg's "Digital Image Warping", and is formally defined as the + hyperbolic-filter sampling the ideal hyperbolic-filter interpolated + image (the filter is designed to be idempotent for 1:1 pixel mapping). +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-scale-simple"></a><h3>gdk_pixbuf_scale_simple ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_scale_simple (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_width</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>);</pre> +<p> +Create a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> containing a copy of <em class="parameter"><code>src</code></em> scaled to +<em class="parameter"><code>dest_width</code></em> x <em class="parameter"><code>dest_height</code></em>. Leaves <em class="parameter"><code>src</code></em> unaffected. <em class="parameter"><code>interp_type</code></em> +should be <a class="link" href="gdk-pixbuf-Scaling.html#GDK-INTERP-NEAREST:CAPS"><span class="type">GDK_INTERP_NEAREST</span></a> if you want maximum speed (but when +scaling down <a class="link" href="gdk-pixbuf-Scaling.html#GDK-INTERP-NEAREST:CAPS"><span class="type">GDK_INTERP_NEAREST</span></a> is usually unusably ugly). The +default <em class="parameter"><code>interp_type</code></em> should be <a class="link" href="gdk-pixbuf-Scaling.html#GDK-INTERP-BILINEAR:CAPS"><span class="type">GDK_INTERP_BILINEAR</span></a> which offers +reasonable quality and speed. +</p> +<p> +You can scale a sub-portion of <em class="parameter"><code>src</code></em> by creating a sub-pixbuf +pointing into <em class="parameter"><code>src</code></em>; see <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-subpixbuf" title="gdk_pixbuf_new_subpixbuf ()"><code class="function">gdk_pixbuf_new_subpixbuf()</code></a>. +</p> +<p> +For more complicated scaling/compositing see <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()"><code class="function">gdk_pixbuf_scale()</code></a> +and <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite" title="gdk_pixbuf_composite ()"><code class="function">gdk_pixbuf_composite()</code></a>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_width</code></em> :</span></p></td> +<td>the width of destination image</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_height</code></em> :</span></p></td> +<td>the height of destination image</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>interp_type</code></em> :</span></p></td> +<td>the interpolation type for the transformation.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be +allocated for it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-scale"></a><h3>gdk_pixbuf_scale ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_scale (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_width</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_height</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_x</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_y</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_x</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_y</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>);</pre> +<p> +Creates a transformation of the source image <em class="parameter"><code>src</code></em> by scaling by +<em class="parameter"><code>scale_x</code></em> and <em class="parameter"><code>scale_y</code></em> then translating by <em class="parameter"><code>offset_x</code></em> and <em class="parameter"><code>offset_y</code></em>, +then renders the rectangle (<em class="parameter"><code>dest_x</code></em>, <em class="parameter"><code>dest_y</code></em>, <em class="parameter"><code>dest_width</code></em>, +<em class="parameter"><code>dest_height</code></em>) of the resulting image onto the destination image +replacing the previous contents. +</p> +<p> +Try to use <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()"><code class="function">gdk_pixbuf_scale_simple()</code></a> first, this function is +the industrial-strength power tool you can fall back to if +<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()"><code class="function">gdk_pixbuf_scale_simple()</code></a> isn't powerful enough. +</p> +<p> +If the source rectangle overlaps the destination rectangle on the +same pixbuf, it will be overwritten during the scaling which +results in rendering artifacts. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td> +<td>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> into which to render the results</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td> +<td>the left coordinate for region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td> +<td>the top coordinate for region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_width</code></em> :</span></p></td> +<td>the width of the region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_height</code></em> :</span></p></td> +<td>the height of the region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>offset_x</code></em> :</span></p></td> +<td>the offset in the X direction (currently rounded to an integer)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>offset_y</code></em> :</span></p></td> +<td>the offset in the Y direction (currently rounded to an integer)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>scale_x</code></em> :</span></p></td> +<td>the scale factor in the X direction</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>scale_y</code></em> :</span></p></td> +<td>the scale factor in the Y direction</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>interp_type</code></em> :</span></p></td> +<td>the interpolation type for the transformation.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-composite-color-simple"></a><h3>gdk_pixbuf_composite_color_simple ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_composite_color_simple (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_width</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>, + <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>, + <em class="parameter"><code><span class="type">int</span> check_size</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color1</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color2</code></em>);</pre> +<p> +Creates a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> by scaling <em class="parameter"><code>src</code></em> to <em class="parameter"><code>dest_width</code></em> x +<em class="parameter"><code>dest_height</code></em> and compositing the result with a checkboard of colors +<em class="parameter"><code>color1</code></em> and <em class="parameter"><code>color2</code></em>. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_width</code></em> :</span></p></td> +<td>the width of destination image</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_height</code></em> :</span></p></td> +<td>the height of destination image</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>interp_type</code></em> :</span></p></td> +<td>the interpolation type for the transformation.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>overall_alpha</code></em> :</span></p></td> +<td>overall alpha for source image (0..255)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>check_size</code></em> :</span></p></td> +<td>the size of checks in the checkboard (must be a power of two)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>color1</code></em> :</span></p></td> +<td>the color of check at upper left</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>color2</code></em> :</span></p></td> +<td>the color of the other check</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be +allocated for it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-composite"></a><h3>gdk_pixbuf_composite ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_composite (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_width</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_height</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_x</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_y</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_x</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_y</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>, + <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>);</pre> +<p> +Creates a transformation of the source image <em class="parameter"><code>src</code></em> by scaling by +<em class="parameter"><code>scale_x</code></em> and <em class="parameter"><code>scale_y</code></em> then translating by <em class="parameter"><code>offset_x</code></em> and <em class="parameter"><code>offset_y</code></em>. +This gives an image in the coordinates of the destination pixbuf. +The rectangle (<em class="parameter"><code>dest_x</code></em>, <em class="parameter"><code>dest_y</code></em>, <em class="parameter"><code>dest_width</code></em>, <em class="parameter"><code>dest_height</code></em>) +is then composited onto the corresponding rectangle of the +original destination image. +</p> +<p> +When the destination rectangle contains parts not in the source +image, the data at the edges of the source image is replicated +to infinity. +</p> +<p> +</p> +<div class="figure"> +<a name="pixbuf-composite-diagram"></a><p class="title"><b>Figure 1. Compositing of pixbufs</b></p> +<div class="figure-contents"><div><img src="composite.png" alt="Compositing of pixbufs"></div></div> +</div> +<p><br class="figure-break"> +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td> +<td>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> into which to render the results</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td> +<td>the left coordinate for region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td> +<td>the top coordinate for region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_width</code></em> :</span></p></td> +<td>the width of the region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_height</code></em> :</span></p></td> +<td>the height of the region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>offset_x</code></em> :</span></p></td> +<td>the offset in the X direction (currently rounded to an integer)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>offset_y</code></em> :</span></p></td> +<td>the offset in the Y direction (currently rounded to an integer)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>scale_x</code></em> :</span></p></td> +<td>the scale factor in the X direction</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>scale_y</code></em> :</span></p></td> +<td>the scale factor in the Y direction</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>interp_type</code></em> :</span></p></td> +<td>the interpolation type for the transformation.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>overall_alpha</code></em> :</span></p></td> +<td>overall alpha for source image (0..255)</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-composite-color"></a><h3>gdk_pixbuf_composite_color ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_composite_color (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_width</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_height</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_x</code></em>, + <em class="parameter"><code><span class="type">double</span> offset_y</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_x</code></em>, + <em class="parameter"><code><span class="type">double</span> scale_y</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>, + <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>, + <em class="parameter"><code><span class="type">int</span> check_x</code></em>, + <em class="parameter"><code><span class="type">int</span> check_y</code></em>, + <em class="parameter"><code><span class="type">int</span> check_size</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color1</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color2</code></em>);</pre> +<p> +Creates a transformation of the source image <em class="parameter"><code>src</code></em> by scaling by +<em class="parameter"><code>scale_x</code></em> and <em class="parameter"><code>scale_y</code></em> then translating by <em class="parameter"><code>offset_x</code></em> and <em class="parameter"><code>offset_y</code></em>, +then composites the rectangle (<em class="parameter"><code>dest_x</code></em> ,<em class="parameter"><code>dest_y</code></em>, <em class="parameter"><code>dest_width</code></em>, +<em class="parameter"><code>dest_height</code></em>) of the resulting image with a checkboard of the +colors <em class="parameter"><code>color1</code></em> and <em class="parameter"><code>color2</code></em> and renders it onto the destination +image. +</p> +<p> +See <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple" title="gdk_pixbuf_composite_color_simple ()"><code class="function">gdk_pixbuf_composite_color_simple()</code></a> for a simpler variant of this +function suitable for many tasks. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td> +<td>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> into which to render the results</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td> +<td>the left coordinate for region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td> +<td>the top coordinate for region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_width</code></em> :</span></p></td> +<td>the width of the region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_height</code></em> :</span></p></td> +<td>the height of the region to render</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>offset_x</code></em> :</span></p></td> +<td>the offset in the X direction (currently rounded to an integer)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>offset_y</code></em> :</span></p></td> +<td>the offset in the Y direction (currently rounded to an integer)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>scale_x</code></em> :</span></p></td> +<td>the scale factor in the X direction</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>scale_y</code></em> :</span></p></td> +<td>the scale factor in the Y direction</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>interp_type</code></em> :</span></p></td> +<td>the interpolation type for the transformation.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>overall_alpha</code></em> :</span></p></td> +<td>overall alpha for source image (0..255)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>check_x</code></em> :</span></p></td> +<td>the X offset for the checkboard (origin of checkboard is at -<em class="parameter"><code>check_x</code></em>, -<em class="parameter"><code>check_y</code></em>)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>check_y</code></em> :</span></p></td> +<td>the Y offset for the checkboard</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>check_size</code></em> :</span></p></td> +<td>the size of checks in the checkboard (must be a power of two)</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>color1</code></em> :</span></p></td> +<td>the color of check at upper left</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>color2</code></em> :</span></p></td> +<td>the color of the other check</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufRotation"></a><h3>enum GdkPixbufRotation</h3> +<pre class="programlisting">typedef enum { + GDK_PIXBUF_ROTATE_NONE = 0, + GDK_PIXBUF_ROTATE_COUNTERCLOCKWISE = 90, + GDK_PIXBUF_ROTATE_UPSIDEDOWN = 180, + GDK_PIXBUF_ROTATE_CLOCKWISE = 270 +} GdkPixbufRotation; +</pre> +<p> +The possible rotations which can be passed to <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-rotate-simple" title="gdk_pixbuf_rotate_simple ()"><code class="function">gdk_pixbuf_rotate_simple()</code></a>. +To make them easier to use, their numerical values are the actual degrees. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><a name="GDK-PIXBUF-ROTATE-NONE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ROTATE_NONE</code></span></p></td> +<td>No rotation. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-ROTATE-COUNTERCLOCKWISE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ROTATE_COUNTERCLOCKWISE</code></span></p></td> +<td>Rotate by 90 degrees. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-ROTATE-UPSIDEDOWN:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ROTATE_UPSIDEDOWN</code></span></p></td> +<td>Rotate by 180 degrees. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-ROTATE-CLOCKWISE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ROTATE_CLOCKWISE</code></span></p></td> +<td>Rotate by 270 degrees. +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-rotate-simple"></a><h3>gdk_pixbuf_rotate_simple ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_rotate_simple (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkPixbufRotation" title="enum GdkPixbufRotation"><span class="type">GdkPixbufRotation</span></a> angle</code></em>);</pre> +<p> +Rotates a pixbuf by a multiple of 90 degrees, and returns the +result in a new pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>angle</code></em> :</span></p></td> +<td>the angle to rotate by</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be +allocated for it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.6</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-flip"></a><h3>gdk_pixbuf_flip ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_flip (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> horizontal</code></em>);</pre> +<p> +Flips a pixbuf horizontally or vertically and returns the +result in a new pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>horizontal</code></em> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to flip horizontally, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to flip vertically</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be +allocated for it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.6</p> +</div> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Scaling.see-also"></a><h2>See Also</h2> +GdkRGB. +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-The-GdkPixbuf-Structure.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-The-GdkPixbuf-Structure.html new file mode 100644 index 0000000..c16718f --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-The-GdkPixbuf-Structure.html @@ -0,0 +1,717 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>The GdkPixbuf Structure</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-Versioning.html" title="Initialization and Versions"> +<link rel="next" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html" title="Reference Counting and Memory Mangement"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-Versioning.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-The-GdkPixbuf-Structure.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-The-GdkPixbuf-Structure.description" class="shortcut">Description</a> + | + <a href="#gdk-pixbuf-The-GdkPixbuf-Structure.object-hierarchy" class="shortcut">Object Hierarchy</a> + | + <a href="#gdk-pixbuf-The-GdkPixbuf-Structure.implemented-interfaces" class="shortcut">Implemented Interfaces</a> + | + <a href="#gdk-pixbuf-The-GdkPixbuf-Structure.properties" class="shortcut">Properties</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-The-GdkPixbuf-Structure"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-The-GdkPixbuf-Structure.top_of_page"></a>The GdkPixbuf Structure</span></h2> +<p>The GdkPixbuf Structure — Information that describes an image.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-The-GdkPixbuf-Structure.synopsis"></a><h2>Synopsis</h2> +<a name="GdkPixbuf"></a><pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +enum <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufError" title="enum GdkPixbufError">GdkPixbufError</a>; +#define <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR">GDK_PIXBUF_ERROR</a> +enum <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace">GdkColorspace</a>; +enum <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufAlphaMode" title="enum GdkPixbufAlphaMode">GdkPixbufAlphaMode</a>; + <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct" title="GdkPixbuf">GdkPixbuf</a>; +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace"><span class="returnvalue">GdkColorspace</span></a> <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-colorspace" title="gdk_pixbuf_get_colorspace ()">gdk_pixbuf_get_colorspace</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<span class="returnvalue">int</span> <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-n-channels" title="gdk_pixbuf_get_n_channels ()">gdk_pixbuf_get_n_channels</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-has-alpha" title="gdk_pixbuf_get_has_alpha ()">gdk_pixbuf_get_has_alpha</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<span class="returnvalue">int</span> <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-bits-per-sample" title="gdk_pixbuf_get_bits_per_sample ()">gdk_pixbuf_get_bits_per_sample</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-pixels" title="gdk_pixbuf_get_pixels ()">gdk_pixbuf_get_pixels</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-pixels-with-length" title="gdk_pixbuf_get_pixels_with_length ()">gdk_pixbuf_get_pixels_with_length</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *length</code></em>); +<span class="returnvalue">int</span> <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-width" title="gdk_pixbuf_get_width ()">gdk_pixbuf_get_width</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<span class="returnvalue">int</span> <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-height" title="gdk_pixbuf_get_height ()">gdk_pixbuf_get_height</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<span class="returnvalue">int</span> <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-rowstride" title="gdk_pixbuf_get_rowstride ()">gdk_pixbuf_get_rowstride</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="returnvalue">gsize</span></a> <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-byte-length" title="gdk_pixbuf_get_byte_length ()">gdk_pixbuf_get_byte_length</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>); +const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-option" title="gdk_pixbuf_get_option ()">gdk_pixbuf_get_option</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-The-GdkPixbuf-Structure.object-hierarchy"></a><h2>Object Hierarchy</h2> +<pre class="synopsis"> + <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> + +----GdkPixbuf +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-The-GdkPixbuf-Structure.implemented-interfaces"></a><h2>Implemented Interfaces</h2> +<p> +GdkPixbuf implements + <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html">GIcon</a>.</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-The-GdkPixbuf-Structure.properties"></a><h2>Properties</h2> +<pre class="synopsis"> + "<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--bits-per-sample" title='The "bits-per-sample" property'>bits-per-sample</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only + "<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--colorspace" title='The "colorspace" property'>colorspace</a>" <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace"><span class="type">GdkColorspace</span></a> : Read / Write / Construct Only + "<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--has-alpha" title='The "has-alpha" property'>has-alpha</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct Only + "<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--height" title='The "height" property'>height</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only + "<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--n-channels" title='The "n-channels" property'>n-channels</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only + "<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--pixels" title='The "pixels" property'>pixels</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> : Read / Write / Construct Only + "<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--rowstride" title='The "rowstride" property'>rowstride</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only + "<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--width" title='The "width" property'>width</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-The-GdkPixbuf-Structure.description"></a><h2>Description</h2> +<p> +The <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure contains +information that describes an image in memory. +</p> +<p> +</p> +<div class="section"> +<div class="titlepage"><div><div><h2 class="title" style="clear: both"> +<a name="image-data"></a>Image Data</h2></div></div></div> +<p> +Image data in a pixbuf is stored in memory in uncompressed, +packed format. Rows in the image are stored top to bottom, and +in each row pixels are stored from left to right. There may be +padding at the end of a row. The "rowstride" value of a pixbuf, +as returned by <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-rowstride" title="gdk_pixbuf_get_rowstride ()"><code class="function">gdk_pixbuf_get_rowstride()</code></a>, indicates the number +of bytes between rows. +</p> +<p> +</p> +<div class="example"> +<a name="put-pixel"></a><p class="title"><b>Example 1. put_pixel() example</b></p> +<div class="example-contents"> +<p> +</p> +<p> +The following code illustrates a simple put_pixel() +function for RGB pixbufs with 8 bits per channel with an alpha +channel. It is not included in the gdk-pixbuf library for +performance reasons; rather than making several function calls +for each pixel, your own code can take shortcuts. +</p> +<p> +</p> +<pre class="programlisting"> +static void +put_pixel (GdkPixbuf *pixbuf, int x, int y, guchar red, guchar green, guchar blue, guchar alpha) +{ + int width, height, rowstride, n_channels; + guchar *pixels, *p; + + n_channels = gdk_pixbuf_get_n_channels (pixbuf); + + g_assert (gdk_pixbuf_get_colorspace (pixbuf) == GDK_COLORSPACE_RGB); + g_assert (gdk_pixbuf_get_bits_per_sample (pixbuf) == 8); + g_assert (gdk_pixbuf_get_has_alpha (pixbuf)); + g_assert (n_channels == 4); + + width = gdk_pixbuf_get_width (pixbuf); + height = gdk_pixbuf_get_height (pixbuf); + + g_assert (x >= 0 && x < width); + g_assert (y >= 0 && y < height); + + rowstride = gdk_pixbuf_get_rowstride (pixbuf); + pixels = gdk_pixbuf_get_pixels (pixbuf); + + p = pixels + y * rowstride + x * n_channels; + p[0] = red; + p[1] = green; + p[2] = blue; + p[3] = alpha; +} +</pre> +<p> +</p> +<p> +This function will not work for pixbufs with images that are +other than 8 bits per sample or channel, but it will work for +most of the pixbufs that GTK+ uses. +</p> +</div> +</div> +<p><br class="example-break"> +</p> +<p> +</p> +<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> +<h3 class="title">Note</h3> +If you are doing <code class="function">memcpy()</code> of raw pixbuf data, note that the +last row in the pixbuf may not be as wide as the full +rowstride, but rather just as wide as the pixel data needs to +be. That is, it is unsafe to do <code class="literal">memcpy (dest, +pixels, rowstride * height)</code> to copy a whole pixbuf. +Use <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-copy" title="gdk_pixbuf_copy ()"><code class="function">gdk_pixbuf_copy()</code></a> instead, or compute the width in bytes +of the last row as <code class="literal">width * ((n_channels * +bits_per_sample + 7) / 8)</code>. +</div> +<p> +</p> +</div> +<p> +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-The-GdkPixbuf-Structure.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="GdkPixbufError"></a><h3>enum GdkPixbufError</h3> +<pre class="programlisting">typedef enum { + /* image data hosed */ + GDK_PIXBUF_ERROR_CORRUPT_IMAGE, + /* no mem to load image */ + GDK_PIXBUF_ERROR_INSUFFICIENT_MEMORY, + /* bad option passed to save routine */ + GDK_PIXBUF_ERROR_BAD_OPTION, + /* unsupported image type (sort of an ENOSYS) */ + GDK_PIXBUF_ERROR_UNKNOWN_TYPE, + /* unsupported operation (load, save) for image type */ + GDK_PIXBUF_ERROR_UNSUPPORTED_OPERATION, + GDK_PIXBUF_ERROR_FAILED +} GdkPixbufError; +</pre> +<p> +An error code in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> domain. Many &gdk-pixbuf; +operations can cause errors in this domain, or in the <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> +domain. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><a name="GDK-PIXBUF-ERROR-CORRUPT-IMAGE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ERROR_CORRUPT_IMAGE</code></span></p></td> +<td>An image file was broken somehow. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-ERROR-INSUFFICIENT-MEMORY:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ERROR_INSUFFICIENT_MEMORY</code></span></p></td> +<td>Not enough memory. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-ERROR-BAD-OPTION:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ERROR_BAD_OPTION</code></span></p></td> +<td>A bad option was passed to a pixbuf save module. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-ERROR-UNKNOWN-TYPE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ERROR_UNKNOWN_TYPE</code></span></p></td> +<td>Unknown image type. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-ERROR-UNSUPPORTED-OPERATION:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ERROR_UNSUPPORTED_OPERATION</code></span></p></td> +<td>Don't know how to perform the + given operation on the type of image at hand. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-ERROR-FAILED:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ERROR_FAILED</code></span></p></td> +<td>Generic failure code, something went wrong. +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GDK-PIXBUF-ERROR:CAPS"></a><h3>GDK_PIXBUF_ERROR</h3> +<pre class="programlisting">#define GDK_PIXBUF_ERROR gdk_pixbuf_error_quark () +</pre> +<p> +Error domain used for pixbuf operations. Indicates that the error code +will be in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufError" title="enum GdkPixbufError"><span class="type">GdkPixbufError</span></a> enumeration. See <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for +information on error domains and error codes. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkColorspace"></a><h3>enum GdkColorspace</h3> +<pre class="programlisting">typedef enum { + GDK_COLORSPACE_RGB +} GdkColorspace; +</pre> +<p> +This enumeration defines the color spaces that are supported by +the &gdk-pixbuf; library. Currently only RGB is supported. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><a name="GDK-COLORSPACE-RGB:CAPS"></a><span class="term"><code class="literal">GDK_COLORSPACE_RGB</code></span></p></td> +<td>Indicates a red/green/blue additive color space. +</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbufAlphaMode"></a><h3>enum GdkPixbufAlphaMode</h3> +<pre class="programlisting">typedef enum { + GDK_PIXBUF_ALPHA_BILEVEL, + GDK_PIXBUF_ALPHA_FULL +} GdkPixbufAlphaMode; +</pre> +<p> +These values can be passed to +<code class="function">gdk_pixbuf_render_to_drawable_alpha()</code> to control how the alpha +channel of an image should be handled. This function can create a +bilevel clipping mask (black and white) and use it while painting +the image. In the future, when the X Window System gets an alpha +channel extension, it will be possible to do full alpha +compositing onto arbitrary drawables. For now both cases fall +back to a bilevel clipping mask. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><a name="GDK-PIXBUF-ALPHA-BILEVEL:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ALPHA_BILEVEL</code></span></p></td> +<td>A bilevel clipping mask (black and white) + will be created and used to draw the image. Pixels below 0.5 opacity + will be considered fully transparent, and all others will be + considered fully opaque. +</td> +</tr> +<tr> +<td><p><a name="GDK-PIXBUF-ALPHA-FULL:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ALPHA_FULL</code></span></p></td> +<td>For now falls back to <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ALPHA-BILEVEL:CAPS"><span class="type">GDK_PIXBUF_ALPHA_BILEVEL</span></a>. + In the future it will do full alpha compositing. +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbuf-struct"></a><h3>GdkPixbuf</h3> +<pre class="programlisting">typedef struct _GdkPixbuf GdkPixbuf;</pre> +<p> +This is the main structure in the &gdk-pixbuf; library. It is +used to represent images. It contains information about the +image's pixel data, its color space, bits per sample, width and +height, and the rowstride (the number of bytes between the start of +one row and the start of the next). +</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-colorspace"></a><h3>gdk_pixbuf_get_colorspace ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace"><span class="returnvalue">GdkColorspace</span></a> gdk_pixbuf_get_colorspace (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Queries the color space of a pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>Color space.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-n-channels"></a><h3>gdk_pixbuf_get_n_channels ()</h3> +<pre class="programlisting"><span class="returnvalue">int</span> gdk_pixbuf_get_n_channels (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Queries the number of channels of a pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>Number of channels.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-has-alpha"></a><h3>gdk_pixbuf_get_has_alpha ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_get_has_alpha (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Queries whether a pixbuf has an alpha channel (opacity information). +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td> +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if it has an alpha channel, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-bits-per-sample"></a><h3>gdk_pixbuf_get_bits_per_sample ()</h3> +<pre class="programlisting"><span class="returnvalue">int</span> gdk_pixbuf_get_bits_per_sample (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Queries the number of bits per color sample in a pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>Number of bits per color sample.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-pixels"></a><h3>gdk_pixbuf_get_pixels ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gdk_pixbuf_get_pixels (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Queries a pointer to the pixel data of a pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A pointer to the pixbuf's pixel data. +Please see <a class="xref" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#image-data" title="Image Data">the section called “Image Data”</a> for information about how +the pixel data is stored in memory. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-pixels-with-length"></a><h3>gdk_pixbuf_get_pixels_with_length ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gdk_pixbuf_get_pixels_with_length (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *length</code></em>);</pre> +<p> +Queries a pointer to the pixel data of a pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td> +<td>The length of the binary data. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> +</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A pointer to the pixbuf's +pixel data. Please see <a class="xref" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#image-data" title="Image Data">the section called “Image Data”</a> +for information about how the pixel data is stored in +memory. +Rename to: gdk_pixbuf_get_pixels. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span> +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.26</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-width"></a><h3>gdk_pixbuf_get_width ()</h3> +<pre class="programlisting"><span class="returnvalue">int</span> gdk_pixbuf_get_width (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Queries the width of a pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>Width in pixels.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-height"></a><h3>gdk_pixbuf_get_height ()</h3> +<pre class="programlisting"><span class="returnvalue">int</span> gdk_pixbuf_get_height (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Queries the height of a pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>Height in pixels.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-rowstride"></a><h3>gdk_pixbuf_get_rowstride ()</h3> +<pre class="programlisting"><span class="returnvalue">int</span> gdk_pixbuf_get_rowstride (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Queries the rowstride of a pixbuf, which is the number of bytes between the start of a row +and the start of the next row. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>Distance between row starts.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-byte-length"></a><h3>gdk_pixbuf_get_byte_length ()</h3> +<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="returnvalue">gsize</span></a> gdk_pixbuf_get_byte_length (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre> +<p> +Returns the length of the pixel data, in bytes. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>The length of the pixel data.</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.26</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-get-option"></a><h3>gdk_pixbuf_get_option ()</h3> +<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gdk_pixbuf_get_option (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre> +<p> +Looks up <em class="parameter"><code>key</code></em> in the list of options that may have been attached to the +<em class="parameter"><code>pixbuf</code></em> when it was loaded, or that may have been attached by another +function using <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-set-option" title="gdk_pixbuf_set_option ()"><code class="function">gdk_pixbuf_set_option()</code></a>. +</p> +<p> +For instance, the ANI loader provides "Title" and "Artist" options. +The ICO, XBM, and XPM loaders provide "x_hot" and "y_hot" hot-spot +options for cursor definitions. The PNG loader provides the tEXt ancillary +chunk key/value pairs as options. Since 2.12, the TIFF and JPEG loaders +return an "orientation" option string that corresponds to the embedded +TIFF/Exif orientation tag (if present). +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td> +<td>a nul-terminated string.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>the value associated with <em class="parameter"><code>key</code></em>. This is a nul-terminated +string that should not be freed or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>key</code></em> was not found.</td> +</tr> +</tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-The-GdkPixbuf-Structure.property-details"></a><h2>Property Details</h2> +<div class="refsect2"> +<a name="GdkPixbuf--bits-per-sample"></a><h3>The <code class="literal">"bits-per-sample"</code> property</h3> +<pre class="programlisting"> "bits-per-sample" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only</pre> +<p> +The number of bits per sample. +Currently only 8 bit per sample are supported. +</p> +<p>Allowed values: [1,16]</p> +<p>Default value: 8</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbuf--colorspace"></a><h3>The <code class="literal">"colorspace"</code> property</h3> +<pre class="programlisting"> "colorspace" <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace" title="enum GdkColorspace"><span class="type">GdkColorspace</span></a> : Read / Write / Construct Only</pre> +<p>The colorspace in which the samples are interpreted.</p> +<p>Default value: GDK_COLORSPACE_RGB</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbuf--has-alpha"></a><h3>The <code class="literal">"has-alpha"</code> property</h3> +<pre class="programlisting"> "has-alpha" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct Only</pre> +<p>Whether the pixbuf has an alpha channel.</p> +<p>Default value: FALSE</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbuf--height"></a><h3>The <code class="literal">"height"</code> property</h3> +<pre class="programlisting"> "height" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only</pre> +<p>The number of rows of the pixbuf.</p> +<p>Allowed values: >= 1</p> +<p>Default value: 1</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbuf--n-channels"></a><h3>The <code class="literal">"n-channels"</code> property</h3> +<pre class="programlisting"> "n-channels" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only</pre> +<p> +The number of samples per pixel. +Currently, only 3 or 4 samples per pixel are supported. +</p> +<p>Allowed values: >= 0</p> +<p>Default value: 3</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbuf--pixels"></a><h3>The <code class="literal">"pixels"</code> property</h3> +<pre class="programlisting"> "pixels" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> : Read / Write / Construct Only</pre> +<p>A pointer to the pixel data of the pixbuf.</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbuf--rowstride"></a><h3>The <code class="literal">"rowstride"</code> property</h3> +<pre class="programlisting"> "rowstride" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only</pre> +<p> +The number of bytes between the start of a row and +the start of the next row. This number must (obviously) +be at least as large as the width of the pixbuf. +</p> +<p>Allowed values: >= 1</p> +<p>Default value: 1</p> +</div> +<hr> +<div class="refsect2"> +<a name="GdkPixbuf--width"></a><h3>The <code class="literal">"width"</code> property</h3> +<pre class="programlisting"> "width" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only</pre> +<p>The number of columns of the pixbuf.</p> +<p>Allowed values: >= 1</p> +<p>Default value: 1</p> +</div> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Utilities.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Utilities.html new file mode 100644 index 0000000..3644b20 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Utilities.html @@ -0,0 +1,308 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Utilities</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-gdk-pixbuf-from-drawables.html" title="Drawables to Pixbufs"> +<link rel="next" href="gdk-pixbuf-Animations.html" title="Animations"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-gdk-pixbuf-from-drawables.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-Animations.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-Utilities.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-Utilities.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-Utilities"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-Utilities.top_of_page"></a>Utilities</span></h2> +<p>Utilities — Utility and miscellaneous convenience functions.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-Utilities.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-add-alpha" title="gdk_pixbuf_add_alpha ()">gdk_pixbuf_add_alpha</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> substitute_color</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> r</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> g</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> b</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-copy-area" title="gdk_pixbuf_copy_area ()">gdk_pixbuf_copy_area</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src_pixbuf</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest_pixbuf</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-saturate-and-pixelate" title="gdk_pixbuf_saturate_and_pixelate ()">gdk_pixbuf_saturate_and_pixelate</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> saturation</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> pixelate</code></em>); +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-apply-embedded-orientation" title="gdk_pixbuf_apply_embedded_orientation ()">gdk_pixbuf_apply_embedded_orientation</a> + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Utilities.html#gdk-pixbuf-fill" title="gdk_pixbuf_fill ()">gdk_pixbuf_fill</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> pixel</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Utilities.description"></a><h2>Description</h2> +<p> +These functions provide miscellaneous utilities for manipulating +pixbufs. The pixel data in pixbufs may of course be manipulated +directly by applications, but several common operations can be +performed by these functions instead. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Utilities.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="gdk-pixbuf-add-alpha"></a><h3>gdk_pixbuf_add_alpha ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_add_alpha (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> substitute_color</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> r</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> g</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> b</code></em>);</pre> +<p> +Takes an existing pixbuf and adds an alpha channel to it. +If the existing pixbuf already had an alpha channel, the channel +values are copied from the original; otherwise, the alpha channel +is initialized to 255 (full opacity). +</p> +<p> +If <em class="parameter"><code>substitute_color</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then the color specified by (<em class="parameter"><code>r</code></em>, <em class="parameter"><code>g</code></em>, <em class="parameter"><code>b</code></em>) will be +assigned zero opacity. That is, if you pass (255, 255, 255) for the +substitute color, all white pixels will become fully transparent. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>substitute_color</code></em> :</span></p></td> +<td>Whether to set a color to zero opacity. If this +is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, then the (<em class="parameter"><code>r</code></em>, <em class="parameter"><code>g</code></em>, <em class="parameter"><code>b</code></em>) arguments will be ignored.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>r</code></em> :</span></p></td> +<td>Red value to substitute.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>g</code></em> :</span></p></td> +<td>Green value to substitute.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td> +<td>Blue value to substitute.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf with a reference count of 1. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-copy-area"></a><h3>gdk_pixbuf_copy_area ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_copy_area (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src_pixbuf</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest_pixbuf</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>);</pre> +<p> +Copies a rectangular area from <em class="parameter"><code>src_pixbuf</code></em> to <em class="parameter"><code>dest_pixbuf</code></em>. Conversion of +pixbuf formats is done automatically. +</p> +<p> +If the source rectangle overlaps the destination rectangle on the +same pixbuf, it will be overwritten during the copy operation. +Therefore, you can not use this function to scroll a pixbuf. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_pixbuf</code></em> :</span></p></td> +<td>Source pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_x</code></em> :</span></p></td> +<td>Source X coordinate within <em class="parameter"><code>src_pixbuf</code></em>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_y</code></em> :</span></p></td> +<td>Source Y coordinate within <em class="parameter"><code>src_pixbuf</code></em>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of the area to copy.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of the area to copy.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_pixbuf</code></em> :</span></p></td> +<td>Destination pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td> +<td>X coordinate within <em class="parameter"><code>dest_pixbuf</code></em>.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td> +<td>Y coordinate within <em class="parameter"><code>dest_pixbuf</code></em>.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-saturate-and-pixelate"></a><h3>gdk_pixbuf_saturate_and_pixelate ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_saturate_and_pixelate (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> saturation</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> pixelate</code></em>);</pre> +<p> +Modifies saturation and optionally pixelates <em class="parameter"><code>src</code></em>, placing the result in +<em class="parameter"><code>dest</code></em>. <em class="parameter"><code>src</code></em> and <em class="parameter"><code>dest</code></em> may be the same pixbuf with no ill effects. If +<em class="parameter"><code>saturation</code></em> is 1.0 then saturation is not changed. If it's less than 1.0, +saturation is reduced (the image turns toward grayscale); if greater than +1.0, saturation is increased (the image gets more vivid colors). If <em class="parameter"><code>pixelate</code></em> +is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then pixels are faded in a checkerboard pattern to create a +pixelated image. <em class="parameter"><code>src</code></em> and <em class="parameter"><code>dest</code></em> must have the same image format, size, and +rowstride. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>source image</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td> +<td>place to write modified version of <em class="parameter"><code>src</code></em> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>saturation</code></em> :</span></p></td> +<td>saturation factor</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixelate</code></em> :</span></p></td> +<td>whether to pixelate</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-apply-embedded-orientation"></a><h3>gdk_pixbuf_apply_embedded_orientation ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_apply_embedded_orientation + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>);</pre> +<p> +Takes an existing pixbuf and checks for the presence of an +associated "orientation" option, which may be provided by the +jpeg loader (which reads the exif orientation tag) or the +tiff loader (which reads the tiff orientation tag, and +compensates it for the partial transforms performed by +libtiff). If an orientation option/tag is present, the +appropriate transform will be performed so that the pixbuf +is oriented correctly. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>A <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>A newly-created pixbuf, or a reference to the +input pixbuf (with an increased reference count). <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> +</td> +</tr> +</tbody> +</table></div> +<p class="since">Since 2.12</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-fill"></a><h3>gdk_pixbuf_fill ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_fill (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> pixel</code></em>);</pre> +<p> +Clears a pixbuf to the given RGBA value, converting the RGBA value into +the pixbuf's pixel format. The alpha will be ignored if the pixbuf +doesn't have an alpha channel. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixel</code></em> :</span></p></td> +<td>RGBA pixel to clear to +(0xffffffff is opaque white, 0x00000000 transparent black)</td> +</tr> +</tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Utilities.see-also"></a><h2>See Also</h2> +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Versioning.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Versioning.html new file mode 100644 index 0000000..73c24ef --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Versioning.html @@ -0,0 +1,166 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Initialization and Versions</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="rn01.html" title="API Reference"> +<link rel="next" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="rn01.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-The-GdkPixbuf-Structure.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-Versioning.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-Versioning.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-Versioning"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-Versioning.top_of_page"></a>Initialization and Versions</span></h2> +<p>Initialization and Versions — Library version numbers.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-Versioning.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +extern const char * <a class="link" href="gdk-pixbuf-Versioning.html#gdk-pixbuf-version" title="gdk_pixbuf_version">gdk_pixbuf_version</a>; +extern const guint <a class="link" href="gdk-pixbuf-Versioning.html#gdk-pixbuf-major-version" title="gdk_pixbuf_major_version">gdk_pixbuf_major_version</a>; +extern const guint <a class="link" href="gdk-pixbuf-Versioning.html#gdk-pixbuf-minor-version" title="gdk_pixbuf_minor_version">gdk_pixbuf_minor_version</a>; +extern const guint <a class="link" href="gdk-pixbuf-Versioning.html#gdk-pixbuf-micro-version" title="gdk_pixbuf_micro_version">gdk_pixbuf_micro_version</a>; +#define <a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-VERSION:CAPS" title="GDK_PIXBUF_VERSION">GDK_PIXBUF_VERSION</a> +#define <a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MAJOR:CAPS" title="GDK_PIXBUF_MAJOR">GDK_PIXBUF_MAJOR</a> +#define <a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MINOR:CAPS" title="GDK_PIXBUF_MINOR">GDK_PIXBUF_MINOR</a> +#define <a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MICRO:CAPS" title="GDK_PIXBUF_MICRO">GDK_PIXBUF_MICRO</a> +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Versioning.description"></a><h2>Description</h2> +<p> +These macros and variables let you check the version of &gdk-pixbuf; +you're linking against. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Versioning.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="gdk-pixbuf-version"></a><h3>gdk_pixbuf_version</h3> +<pre class="programlisting">extern const char *gdk_pixbuf_version; +</pre> +<p> +Contains the full version of the &gdk-pixbuf; library as a string. +This is the version currently in use by a running program. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-major-version"></a><h3>gdk_pixbuf_major_version</h3> +<pre class="programlisting">extern const guint gdk_pixbuf_major_version; +</pre> +<p> +The major version number of the &gdk-pixbuf; library. (e.g. in +&gdk-pixbuf; version 1.2.5 this is 1.) +</p> +<p> +This variable is in the library, so represents the +&gdk-pixbuf; library you have linked against. Contrast with the +<a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MAJOR:CAPS" title="GDK_PIXBUF_MAJOR"><span class="type">GDK_PIXBUF_MAJOR</span></a> macro, which represents the major version of the +&gdk-pixbuf; headers you have included. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-minor-version"></a><h3>gdk_pixbuf_minor_version</h3> +<pre class="programlisting">extern const guint gdk_pixbuf_minor_version; +</pre> +<p> +The minor version number of the &gdk-pixbuf; library. (e.g. in +&gdk-pixbuf; version 1.2.5 this is 2.) +</p> +<p> +This variable is in the library, so represents the +&gdk-pixbuf; library you have linked against. Contrast with the +<a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MINOR:CAPS" title="GDK_PIXBUF_MINOR"><span class="type">GDK_PIXBUF_MINOR</span></a> macro, which represents the minor version of the +&gdk-pixbuf; headers you have included. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-micro-version"></a><h3>gdk_pixbuf_micro_version</h3> +<pre class="programlisting">extern const guint gdk_pixbuf_micro_version; +</pre> +<p> +The micro version number of the &gdk-pixbuf; library. (e.g. in +&gdk-pixbuf; version 1.2.5 this is 5.) +</p> +<p> +This variable is in the library, so represents the +&gdk-pixbuf; library you have linked against. Contrast with the +<a class="link" href="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MICRO:CAPS" title="GDK_PIXBUF_MICRO"><span class="type">GDK_PIXBUF_MICRO</span></a> macro, which represents the micro version of the +&gdk-pixbuf; headers you have included. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="GDK-PIXBUF-VERSION:CAPS"></a><h3>GDK_PIXBUF_VERSION</h3> +<pre class="programlisting">#define GDK_PIXBUF_VERSION "2.26.4" +</pre> +<p> +Contains the full version of the &gdk-pixbuf; header as a string. +This is the version being compiled against; contrast with +<a class="link" href="gdk-pixbuf-Versioning.html#gdk-pixbuf-version" title="gdk_pixbuf_version"><span class="type">gdk_pixbuf_version</span></a>. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="GDK-PIXBUF-MAJOR:CAPS"></a><h3>GDK_PIXBUF_MAJOR</h3> +<pre class="programlisting">#define GDK_PIXBUF_MAJOR (2) +</pre> +<p> +Major version of &gdk-pixbuf; library, that is the first "0" in +"0.8.0" for example. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="GDK-PIXBUF-MINOR:CAPS"></a><h3>GDK_PIXBUF_MINOR</h3> +<pre class="programlisting">#define GDK_PIXBUF_MINOR (26) +</pre> +<p> +Minor version of &gdk-pixbuf; library, that is the "8" in +"0.8.0" for example. +</p> +</div> +<hr> +<div class="refsect2"> +<a name="GDK-PIXBUF-MICRO:CAPS"></a><h3>GDK_PIXBUF_MICRO</h3> +<pre class="programlisting">#define GDK_PIXBUF_MICRO (4) +</pre> +<p> +Micro version of &gdk-pixbuf; library, that is the last "0" in +"0.8.0" for example. +</p> +</div> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-X-Drawables-to-Pixbufs.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-X-Drawables-to-Pixbufs.html new file mode 100644 index 0000000..054d5c7 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-X-Drawables-to-Pixbufs.html @@ -0,0 +1,179 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>X Drawables to Pixbufs</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-Xlib-Rendering.html" title="Xlib Rendering"> +<link rel="next" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-Xlib-Rendering.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-XlibRGB.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-X-Drawables-to-Pixbufs.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-X-Drawables-to-Pixbufs.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-X-Drawables-to-Pixbufs"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-X-Drawables-to-Pixbufs.top_of_page"></a>X Drawables to Pixbufs</span></h2> +<p>X Drawables to Pixbufs — Getting parts of an X drawable's image data into a pixbuf.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-X-Drawables-to-Pixbufs.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +<a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-X-Drawables-to-Pixbufs.html#gdk-pixbuf-xlib-get-from-drawable" title="gdk_pixbuf_xlib_get_from_drawable ()">gdk_pixbuf_xlib_get_from_drawable</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>, + <em class="parameter"><code><span class="type">Drawable</span> src</code></em>, + <em class="parameter"><code><span class="type">Colormap</span> cmap</code></em>, + <em class="parameter"><code><span class="type">Visual</span> *visual</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-X-Drawables-to-Pixbufs.description"></a><h2>Description</h2> +<p> +The functions in this section allow you to take the image data +from an X drawable and dump it into a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. This can be +used for screenshots and other special effects. Note that these +operations can be expensive, since the image data has to be +transferred from the X server to the client program and converted. +</p> +<p> +These functions are analogous to those for the GDK version of +&gdk-pixbuf;. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-X-Drawables-to-Pixbufs.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="gdk-pixbuf-xlib-get-from-drawable"></a><h3>gdk_pixbuf_xlib_get_from_drawable ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_xlib_get_from_drawable (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>, + <em class="parameter"><code><span class="type">Drawable</span> src</code></em>, + <em class="parameter"><code><span class="type">Colormap</span> cmap</code></em>, + <em class="parameter"><code><span class="type">Visual</span> *visual</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>);</pre> +<p> +Transfers image data from a Gdk drawable and converts it to an RGB(A) +representation inside a GdkPixbuf. +</p> +<p> +If the drawable <em class="parameter"><code>src</code></em> is a pixmap, then a suitable colormap must be specified, +since pixmaps are just blocks of pixel data without an associated colormap. +If the drawable is a window, the <em class="parameter"><code>cmap</code></em> argument will be ignored and the +window's own colormap will be used instead. +</p> +<p> +If the specified destination pixbuf <em class="parameter"><code>dest</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, then this function will +create an RGB pixbuf with 8 bits per channel and no alpha, with the same size +specified by the <em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em> arguments. In this case, the <em class="parameter"><code>dest_x</code></em> and +<em class="parameter"><code>dest_y</code></em> arguments must be specified as 0, otherwise the function will return +<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>. If the specified destination pixbuf is not NULL and it contains alpha +information, then the filled pixels will be set to full opacity. +</p> +<p> +If the specified drawable is a pixmap, then the requested source rectangle +must be completely contained within the pixmap, otherwise the function will +return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>. +</p> +<p> +If the specified drawable is a window, then it must be viewable, i.e. all of +its ancestors up to the root window must be mapped. Also, the specified +source rectangle must be completely contained within the window and within +the screen. If regions of the window are obscured by noninferior windows, the +contents of those regions are undefined. The contents of regions obscured by +inferior windows of a different depth than that of the source window will also +be undefined. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td> +<td>Destination pixbuf, or NULL if a new pixbuf should be created.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td> +<td>Source drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>cmap</code></em> :</span></p></td> +<td>A colormap if <em class="parameter"><code>src</code></em> is a pixmap. If it is a window, this argument will +be ignored.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>visual</code></em> :</span></p></td> +<td>A visual if <em class="parameter"><code>src</code></em> is a pixmap. If it is a window, this argument will +be ignored.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_x</code></em> :</span></p></td> +<td>Source X coordinate within drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_y</code></em> :</span></p></td> +<td>Source Y coordinate within drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td> +<td>Destination X coordinate in pixbuf, or 0 if <em class="parameter"><code>dest</code></em> is NULL.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td> +<td>Destination Y coordinate in pixbuf, or 0 if <em class="parameter"><code>dest</code></em> is NULL.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width in pixels of region to get.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height in pixels of region to get.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>The same pixbuf as <em class="parameter"><code>dest</code></em> if it was non-NULL, or a newly-created +pixbuf with a reference count of 1 if no destination pixbuf was specified; in +the latter case, NULL will be returned if not enough memory could be +allocated for the pixbuf to be created.</td> +</tr> +</tbody> +</table></div> +</div> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Xlib-Rendering.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Xlib-Rendering.html new file mode 100644 index 0000000..58d36ad --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-Xlib-Rendering.html @@ -0,0 +1,396 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Xlib Rendering</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html" title="gdk-pixbuf Xlib initialization"> +<link rel="next" href="gdk-pixbuf-X-Drawables-to-Pixbufs.html" title="X Drawables to Pixbufs"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-X-Drawables-to-Pixbufs.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-Xlib-Rendering.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-Xlib-Rendering.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-Xlib-Rendering"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-Xlib-Rendering.top_of_page"></a>Xlib Rendering</span></h2> +<p>Xlib Rendering — Rendering a pixbuf to an X drawable.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-Xlib-Rendering.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-threshold-alpha" title="gdk_pixbuf_xlib_render_threshold_alpha ()">gdk_pixbuf_xlib_render_threshold_alpha</a> + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><span class="type">Pixmap</span> bitmap</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><span class="type">int</span> alpha_threshold</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable" title="gdk_pixbuf_xlib_render_to_drawable ()">gdk_pixbuf_xlib_render_to_drawable</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dither</code></em>, + <em class="parameter"><code><span class="type">int</span> x_dither</code></em>, + <em class="parameter"><code><span class="type">int</span> y_dither</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable-alpha" title="gdk_pixbuf_xlib_render_to_drawable_alpha ()">gdk_pixbuf_xlib_render_to_drawable_alpha</a> + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufAlphaMode" title="enum GdkPixbufAlphaMode"><span class="type">GdkPixbufAlphaMode</span></a> alpha_mode</code></em>, + <em class="parameter"><code><span class="type">int</span> alpha_threshold</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dither</code></em>, + <em class="parameter"><code><span class="type">int</span> x_dither</code></em>, + <em class="parameter"><code><span class="type">int</span> y_dither</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-pixmap-and-mask" title="gdk_pixbuf_xlib_render_pixmap_and_mask ()">gdk_pixbuf_xlib_render_pixmap_and_mask</a> + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><span class="type">Pixmap</span> *pixmap_return</code></em>, + <em class="parameter"><code><span class="type">Pixmap</span> *mask_return</code></em>, + <em class="parameter"><code><span class="type">int</span> alpha_threshold</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Xlib-Rendering.description"></a><h2>Description</h2> +<p> +The &gdk-pixbuf; Xlib library provides several convenience +functions to render pixbufs to X drawables. It uses XlibRGB to +render the image data. +</p> +<p> +These functions are analogous to those for the GDK version of +&gdk-pixbuf;. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-Xlib-Rendering.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="gdk-pixbuf-xlib-render-threshold-alpha"></a><h3>gdk_pixbuf_xlib_render_threshold_alpha ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_xlib_render_threshold_alpha + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><span class="type">Pixmap</span> bitmap</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><span class="type">int</span> alpha_threshold</code></em>);</pre> +<p> +Takes the opacity values in a rectangular portion of a pixbuf and thresholds +them to produce a bi-level alpha mask that can be used as a clipping mask for +a drawable. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>bitmap</code></em> :</span></p></td> +<td>Bitmap where the bilevel mask will be painted to.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_x</code></em> :</span></p></td> +<td>Source X coordinate.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_y</code></em> :</span></p></td> +<td>source Y coordinate.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td> +<td>Destination X coordinate.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td> +<td>Destination Y coordinate.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of region to threshold.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of region to threshold.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>alpha_threshold</code></em> :</span></p></td> +<td>Opacity values below this will be painted as zero; all +other values will be painted as one.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-xlib-render-to-drawable"></a><h3>gdk_pixbuf_xlib_render_to_drawable ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_xlib_render_to_drawable (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dither</code></em>, + <em class="parameter"><code><span class="type">int</span> x_dither</code></em>, + <em class="parameter"><code><span class="type">int</span> y_dither</code></em>);</pre> +<p> +Renders a rectangular portion of a pixbuf to a drawable while using the +specified GC. This is done using XlibRGB, so the specified drawable must +have the XlibRGB visual and colormap. Note that this function will ignore +the opacity information for images with an alpha channel; the GC must already +have the clipping mask set if you want transparent regions to show through. +</p> +<p> +For an explanation of dither offsets, see the XlibRGB documentation. In +brief, the dither offset is important when re-rendering partial regions of an +image to a rendered version of the full image, or for when the offsets to a +base position change, as in scrolling. The dither matrix has to be shifted +for consistent visual results. If you do not have any of these cases, the +dither offsets can be both zero. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td> +<td>Destination drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td> +<td>GC used for rendering.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_x</code></em> :</span></p></td> +<td>Source X coordinate within pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_y</code></em> :</span></p></td> +<td>Source Y coordinate within pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td> +<td>Destination X coordinate within drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td> +<td>Destination Y coordinate within drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of region to render, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of region to render, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dither</code></em> :</span></p></td> +<td>Dithering mode for XlibRGB.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>x_dither</code></em> :</span></p></td> +<td>X offset for dither.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>y_dither</code></em> :</span></p></td> +<td>Y offset for dither.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-xlib-render-to-drawable-alpha"></a><h3>gdk_pixbuf_xlib_render_to_drawable_alpha ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_xlib_render_to_drawable_alpha + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">int</span> src_x</code></em>, + <em class="parameter"><code><span class="type">int</span> src_y</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_x</code></em>, + <em class="parameter"><code><span class="type">int</span> dest_y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufAlphaMode" title="enum GdkPixbufAlphaMode"><span class="type">GdkPixbufAlphaMode</span></a> alpha_mode</code></em>, + <em class="parameter"><code><span class="type">int</span> alpha_threshold</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dither</code></em>, + <em class="parameter"><code><span class="type">int</span> x_dither</code></em>, + <em class="parameter"><code><span class="type">int</span> y_dither</code></em>);</pre> +<p> +Renders a rectangular portion of a pixbuf to a drawable. This is done using +XlibRGB, so the specified drawable must have the XlibRGB visual and colormap. +</p> +<p> +When used with <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ALPHA-BILEVEL:CAPS"><span class="type">GDK_PIXBUF_ALPHA_BILEVEL</span></a>, this function has to create a bitmap +out of the thresholded alpha channel of the image and, it has to set this +bitmap as the clipping mask for the GC used for drawing. This can be a +significant performance penalty depending on the size and the complexity of +the alpha channel of the image. If performance is crucial, consider handling +the alpha channel yourself (possibly by caching it in your application) and +using <a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable" title="gdk_pixbuf_xlib_render_to_drawable ()"><code class="function">gdk_pixbuf_xlib_render_to_drawable()</code></a> or GdkRGB directly instead. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td> +<td>Destination drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_x</code></em> :</span></p></td> +<td>Source X coordinate within pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>src_y</code></em> :</span></p></td> +<td>Source Y coordinates within pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td> +<td>Destination X coordinate within drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td> +<td>Destination Y coordinate within drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of region to render, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of region to render, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>alpha_mode</code></em> :</span></p></td> +<td>If the image does not have opacity information, this is ignored. +Otherwise, specifies how to handle transparency when rendering.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>alpha_threshold</code></em> :</span></p></td> +<td>If the image does have opacity information and <em class="parameter"><code>alpha_mode</code></em> +is GDK_PIXBUF_ALPHA_BILEVEL, specifies the threshold value for opacity +values.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dither</code></em> :</span></p></td> +<td>Dithering mode for XlibRGB.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>x_dither</code></em> :</span></p></td> +<td>X offset for dither.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>y_dither</code></em> :</span></p></td> +<td>Y offset for dither.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-xlib-render-pixmap-and-mask"></a><h3>gdk_pixbuf_xlib_render_pixmap_and_mask ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_xlib_render_pixmap_and_mask + (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>, + <em class="parameter"><code><span class="type">Pixmap</span> *pixmap_return</code></em>, + <em class="parameter"><code><span class="type">Pixmap</span> *mask_return</code></em>, + <em class="parameter"><code><span class="type">int</span> alpha_threshold</code></em>);</pre> +<p> +Creates a pixmap and a mask bitmap which are returned in the <em class="parameter"><code>pixmap_return</code></em> +and <em class="parameter"><code>mask_return</code></em> arguments, respectively, and renders a pixbuf and its +corresponding tresholded alpha mask to them. This is merely a convenience +function; applications that need to render pixbufs with dither offsets or to +given drawables should use <a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable-alpha" title="gdk_pixbuf_xlib_render_to_drawable_alpha ()"><code class="function">gdk_pixbuf_xlib_render_to_drawable_alpha()</code></a> or +<a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable" title="gdk_pixbuf_xlib_render_to_drawable ()"><code class="function">gdk_pixbuf_xlib_render_to_drawable()</code></a>, and +<a class="link" href="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-threshold-alpha" title="gdk_pixbuf_xlib_render_threshold_alpha ()"><code class="function">gdk_pixbuf_xlib_render_threshold_alpha()</code></a>. +</p> +<p> +If the pixbuf does not have an alpha channel, then *<em class="parameter"><code>mask_return</code></em> will be set +to None. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td> +<td>A pixbuf.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>pixmap_return</code></em> :</span></p></td> +<td>Return value for the created pixmap.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>mask_return</code></em> :</span></p></td> +<td>Return value for the created mask.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>alpha_threshold</code></em> :</span></p></td> +<td>Threshold value for opacity values.</td> +</tr> +</tbody> +</table></div> +</div> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-XlibRGB.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-XlibRGB.html new file mode 100644 index 0000000..2604f38 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-XlibRGB.html @@ -0,0 +1,915 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>XlibRGB</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-X-Drawables-to-Pixbufs.html" title="X Drawables to Pixbufs"> +<link rel="next" href="rn02.html" title="Tools Reference"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-X-Drawables-to-Pixbufs.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="rn02.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-XlibRGB.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-XlibRGB.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-XlibRGB"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-XlibRGB.top_of_page"></a>XlibRGB</span></h2> +<p>XlibRGB — Rendering RGB buffers to X drawables.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-XlibRGB.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +struct <a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap">XlibRgbCmap</a>; +enum <a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither">XlibRgbDither</a>; +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init" title="xlib_rgb_init ()">xlib_rgb_init</a> (<em class="parameter"><code><span class="type">Display</span> *display</code></em>, + <em class="parameter"><code><span class="type">Screen</span> *screen</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init-with-depth" title="xlib_rgb_init_with_depth ()">xlib_rgb_init_with_depth</a> (<em class="parameter"><code><span class="type">Display</span> *display</code></em>, + <em class="parameter"><code><span class="type">Screen</span> *screen</code></em>, + <em class="parameter"><code><span class="type">int</span> prefDepth</code></em>); +unsigned <span class="returnvalue">long</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-xpixel-from-rgb" title="xlib_rgb_xpixel_from_rgb ()">xlib_rgb_xpixel_from_rgb</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> rgb</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-gc-set-foreground" title="xlib_rgb_gc_set_foreground ()">xlib_rgb_gc_set_foreground</a> (<em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> rgb</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-gc-set-background" title="xlib_rgb_gc_set_background ()">xlib_rgb_gc_set_background</a> (<em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> rgb</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image" title="xlib_draw_rgb_image ()">xlib_draw_rgb_image</a> (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>, + <em class="parameter"><code>unsigned <span class="type">char</span> *rgb_buf</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image-dithalign" title="xlib_draw_rgb_image_dithalign ()">xlib_draw_rgb_image_dithalign</a> (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>, + <em class="parameter"><code>unsigned <span class="type">char</span> *rgb_buf</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>, + <em class="parameter"><code><span class="type">int</span> xdith</code></em>, + <em class="parameter"><code><span class="type">int</span> ydith</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-32-image" title="xlib_draw_rgb_32_image ()">xlib_draw_rgb_32_image</a> (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>, + <em class="parameter"><code>unsigned <span class="type">char</span> *buf</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-gray-image" title="xlib_draw_gray_image ()">xlib_draw_gray_image</a> (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>, + <em class="parameter"><code>unsigned <span class="type">char</span> *buf</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>); +<a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap"><span class="returnvalue">XlibRgbCmap</span></a> * <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-cmap-new" title="xlib_rgb_cmap_new ()">xlib_rgb_cmap_new</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *colors</code></em>, + <em class="parameter"><code><span class="type">int</span> n_colors</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-cmap-free" title="xlib_rgb_cmap_free ()">xlib_rgb_cmap_free</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap"><span class="type">XlibRgbCmap</span></a> *cmap</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-indexed-image" title="xlib_draw_indexed_image ()">xlib_draw_indexed_image</a> (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>, + <em class="parameter"><code>unsigned <span class="type">char</span> *buf</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap"><span class="type">XlibRgbCmap</span></a> *cmap</code></em>); +<span class="returnvalue">Bool</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-ditherable" title="xlib_rgb_ditherable ()">xlib_rgb_ditherable</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-verbose" title="xlib_rgb_set_verbose ()">xlib_rgb_set_verbose</a> (<em class="parameter"><code><span class="type">Bool</span> verbose</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-install" title="xlib_rgb_set_install ()">xlib_rgb_set_install</a> (<em class="parameter"><code><span class="type">Bool</span> install</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-min-colors" title="xlib_rgb_set_min_colors ()">xlib_rgb_set_min_colors</a> (<em class="parameter"><code><span class="type">int</span> min_colors</code></em>); +<span class="returnvalue">Colormap</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-cmap" title="xlib_rgb_get_cmap ()">xlib_rgb_get_cmap</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<span class="returnvalue">Visual</span> * <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-visual" title="xlib_rgb_get_visual ()">xlib_rgb_get_visual</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<span class="returnvalue">XVisualInfo</span> * <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-visual-info" title="xlib_rgb_get_visual_info ()">xlib_rgb_get_visual_info</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<span class="returnvalue">int</span> <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-depth" title="xlib_rgb_get_depth ()">xlib_rgb_get_depth</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<span class="returnvalue">Display</span> * <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-display" title="xlib_rgb_get_display ()">xlib_rgb_get_display</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +<span class="returnvalue">Screen</span> * <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-screen" title="xlib_rgb_get_screen ()">xlib_rgb_get_screen</a> (<em class="parameter"><code><span class="type">void</span></code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-XlibRGB.description"></a><h2>Description</h2> +<p> +The XlibRGB set of functions is a port of the <span class="type">GdkRGB</span> library to +use plain Xlib and X drawables. You can use these functions to +render RGB buffers into drawables very quickly with high-quality +dithering. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-XlibRGB.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="XlibRgbCmap"></a><h3>struct XlibRgbCmap</h3> +<pre class="programlisting">struct XlibRgbCmap { + unsigned int colors[256]; + unsigned char lut[256]; /* for 8-bit modes */ +}; +</pre> +<p> +FIXME: Describe this. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term">unsigned <span class="type">int</span> <em class="structfield"><code><a name="XlibRgbCmap.colors"></a>colors</code></em>[256];</span></p></td> +<td>FIXME.</td> +</tr> +<tr> +<td><p><span class="term">unsigned <span class="type">char</span> <em class="structfield"><code><a name="XlibRgbCmap.lut"></a>lut</code></em>[256];</span></p></td> +<td>FIXME.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="XlibRgbDither"></a><h3>enum XlibRgbDither</h3> +<pre class="programlisting">typedef enum { + XLIB_RGB_DITHER_NONE, + XLIB_RGB_DITHER_NORMAL, + XLIB_RGB_DITHER_MAX +} XlibRgbDither; +</pre> +<p> +These values are used to specify which dithering method should be +used. <span class="symbol">XLIB_RGB_DITHER_NONE</span> will use no dithering +and simply map the colors in an RGB buffer to the closest colors +that the display can provide. +<span class="symbol">XLIB_RGB_DITHER_NORMAL</span> will provide dithering +only on pseudocolor displays. +<span class="symbol">XLIB_RGB_DITHER_MAX</span> will provide dithering on +pseudocolor and 16-bit truecolor or “high color” +displays. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><a name="XLIB-RGB-DITHER-NONE:CAPS"></a><span class="term"><code class="literal">XLIB_RGB_DITHER_NONE</code></span></p></td> +<td>Specifies no dithering. +</td> +</tr> +<tr> +<td><p><a name="XLIB-RGB-DITHER-NORMAL:CAPS"></a><span class="term"><code class="literal">XLIB_RGB_DITHER_NORMAL</code></span></p></td> +<td>Specifies dithering only on pseudocolor + displays. +</td> +</tr> +<tr> +<td><p><a name="XLIB-RGB-DITHER-MAX:CAPS"></a><span class="term"><code class="literal">XLIB_RGB_DITHER_MAX</code></span></p></td> +<td>Specifies dithering on high color displays. +</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-init"></a><h3>xlib_rgb_init ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_rgb_init (<em class="parameter"><code><span class="type">Display</span> *display</code></em>, + <em class="parameter"><code><span class="type">Screen</span> *screen</code></em>);</pre> +<p> +Initializes the XlibRGB machinery with the default depth. If you use this +function XlibRGB will automatically pick the best visual available on your +display. This function or <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init-with-depth" title="xlib_rgb_init_with_depth ()"><code class="function">xlib_rgb_init_with_depth()</code></a> must be called before +using any of the other functions in XlibRGB. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td> +<td>X Display to use.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td> +<td>Screen to use.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-init-with-depth"></a><h3>xlib_rgb_init_with_depth ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_rgb_init_with_depth (<em class="parameter"><code><span class="type">Display</span> *display</code></em>, + <em class="parameter"><code><span class="type">Screen</span> *screen</code></em>, + <em class="parameter"><code><span class="type">int</span> prefDepth</code></em>);</pre> +<p> +Initializes the XlibRGB machinery with a particular depth you specify, +instead of automatically picking the best depth in the display. This +function or <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init" title="xlib_rgb_init ()"><code class="function">xlib_rgb_init()</code></a> must be called before using any of the other +functions in XlibRGB. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td> +<td>X display to use.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td> +<td>Screen to use.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>prefDepth</code></em> :</span></p></td> +<td>Visual depth to use for color substitution tables. This must +be one of the supported visual depths in the specified <em class="parameter"><code>display</code></em>.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-xpixel-from-rgb"></a><h3>xlib_rgb_xpixel_from_rgb ()</h3> +<pre class="programlisting">unsigned <span class="returnvalue">long</span> xlib_rgb_xpixel_from_rgb (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> rgb</code></em>);</pre> +<p> +Converts an RGB triplet into the closest color that XlibRGB visual can +handle. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>rgb</code></em> :</span></p></td> +<td>32-bit representation of an RGB value, specified as 0x00RRGGBB.</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>X pixel value that corresponds to the closest color in the +XlibRGB visual and colormap.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-gc-set-foreground"></a><h3>xlib_rgb_gc_set_foreground ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_rgb_gc_set_foreground (<em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> rgb</code></em>);</pre> +<p> +This is a convenience function to set the foreground of a GC from an RGB +triplet. It calls <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-xpixel-from-rgb" title="xlib_rgb_xpixel_from_rgb ()"><code class="function">xlib_rgb_xpixel_from_rgb()</code></a> internally and uses the +returned pixel value to set the GC's foreground. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td> +<td>A graphic context.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rgb</code></em> :</span></p></td> +<td>32-bit representation of an RGB value, specified as 0x00RRGGBB.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-gc-set-background"></a><h3>xlib_rgb_gc_set_background ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_rgb_gc_set_background (<em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> rgb</code></em>);</pre> +<p> +This is a convenience function to set the background of a GC from an RGB +triplet. It calls <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-xpixel-from-rgb" title="xlib_rgb_xpixel_from_rgb ()"><code class="function">xlib_rgb_xpixel_from_rgb()</code></a> internally and uses the +returned pixel value to set the GC's background. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td> +<td>A graphic context.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rgb</code></em> :</span></p></td> +<td>32-bit representation of an RGB value, specified as 0x00RRGGBB.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-draw-rgb-image"></a><h3>xlib_draw_rgb_image ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_draw_rgb_image (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>, + <em class="parameter"><code>unsigned <span class="type">char</span> *rgb_buf</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>);</pre> +<p> +Renders an RGB buffer to a drawable. Pixels are specified as RGB triplets +with 8 bits per channel. An image will thus look like an RGBRGBRGBRGB +sequence of 8-bit values. This function does not let you specify dither +offsets; applications that need to render partial regions of a buffer to +build the final image should use <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image-dithalign" title="xlib_draw_rgb_image_dithalign ()"><code class="function">xlib_draw_rgb_image_dithalign()</code></a> instead. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td> +<td>Destination drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td> +<td>A graphic context.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> +<td>Leftmost coordinate of the destination rectangle.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> +<td>Upper coordinate of the destination rectangle.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of the destination rectangle, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of the destination rectangle, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dith</code></em> :</span></p></td> +<td>Dithering method to use.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rgb_buf</code></em> :</span></p></td> +<td>Pointer to the pixel in the RGB buffer that corresponds to the +upper-left corner of the rectangular region to render.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rowstride</code></em> :</span></p></td> +<td>Offset between pixel rows in the RGB buffer, in bytes.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-draw-rgb-image-dithalign"></a><h3>xlib_draw_rgb_image_dithalign ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_draw_rgb_image_dithalign (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>, + <em class="parameter"><code>unsigned <span class="type">char</span> *rgb_buf</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>, + <em class="parameter"><code><span class="type">int</span> xdith</code></em>, + <em class="parameter"><code><span class="type">int</span> ydith</code></em>);</pre> +<p> +Renders an RGB buffer to a drawable. Pixels are specified as RGB triplets +with 8 bits per channel. An image will thus look like an RGBRGBRGBRGB +sequence of 8-bit values. This function lets you specify a pair of dither +offsets. It should be used when you need to render regions of an RGB buffer +separately to form the final image; the dither offsets let you align the +dither mask appropriately. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td> +<td>Destination drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td> +<td>A graphic context.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> +<td>Leftmost coordinate of the destination rectangle.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> +<td>Upper coordinate of the destination rectangle.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of the destination rectangle, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of the destination rectangle, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dith</code></em> :</span></p></td> +<td>Dithering method to use.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rgb_buf</code></em> :</span></p></td> +<td>Pointer to the pixel in the RGB buffer that corresponds to the +upper-left corner of the rectangular region to render.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rowstride</code></em> :</span></p></td> +<td>Offset between pixel rows in the RGB buffer, in bytes.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>xdith</code></em> :</span></p></td> +<td>X offset for the dither mask.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>ydith</code></em> :</span></p></td> +<td>Y offset for the dither mask.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-draw-rgb-32-image"></a><h3>xlib_draw_rgb_32_image ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_draw_rgb_32_image (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>, + <em class="parameter"><code>unsigned <span class="type">char</span> *buf</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>);</pre> +<p> +This function is analogous to <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image" title="xlib_draw_rgb_image ()"><code class="function">xlib_draw_rgb_image()</code></a>, but it lets you use +32-bit RGB buffers with pixels specified as 0xRRGGBB00. The +least-significant 8 bits are actually discarded. This function can lead to +faster results than <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image" title="xlib_draw_rgb_image ()"><code class="function">xlib_draw_rgb_image()</code></a> since the pixels are aligned on +32-bit boundaries. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td> +<td>Destination drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td> +<td>A graphic context.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> +<td>Leftmost coordinate of the destination rectangle.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> +<td>Upper coordinate of the destination rectangle.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of the destination rectangle, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of the destination rectangle, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dith</code></em> :</span></p></td> +<td>Dithering method to use.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>buf</code></em> :</span></p></td> +<td>Pointer to the pixel in the RGB buffer that corresponds to the +upper-left corner of the rectangular region to render.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rowstride</code></em> :</span></p></td> +<td>Offset between pixel rows in the RGB buffer, in bytes.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-draw-gray-image"></a><h3>xlib_draw_gray_image ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_draw_gray_image (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>, + <em class="parameter"><code>unsigned <span class="type">char</span> *buf</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>);</pre> +<p> +Renders a grayscale buffer to a drawable. Pixels are specified as 8-bit +intensity values. An image will thus look as a GGGGGG sequence of 8-bit +values. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td> +<td>Destination drawable.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td> +<td>A graphic context.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> +<td>Leftmost coordinate of the destination rectangle.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> +<td>Upper coordinate of the destination rectangle.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>Width of the destination rectangle, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>Height of thd destination rectangle, in pixels.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dith</code></em> :</span></p></td> +<td>Dithering method to use.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>buf</code></em> :</span></p></td> +<td>Pointer to the pixel in the grayscale buffer that corresponds to the +upper-left corner of the rectangular region to render.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rowstride</code></em> :</span></p></td> +<td>Offset between pixel rows in the grayscale buffer, in pixels.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-cmap-new"></a><h3>xlib_rgb_cmap_new ()</h3> +<pre class="programlisting"><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap"><span class="returnvalue">XlibRgbCmap</span></a> * xlib_rgb_cmap_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *colors</code></em>, + <em class="parameter"><code><span class="type">int</span> n_colors</code></em>);</pre> +<p> +FIXME +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>colors</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>n_colors</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>FIXME</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-cmap-free"></a><h3>xlib_rgb_cmap_free ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_rgb_cmap_free (<em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap"><span class="type">XlibRgbCmap</span></a> *cmap</code></em>);</pre> +<p> +Frees an XlibRGB colormap. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>cmap</code></em> :</span></p></td> +<td>An XlibRGB colormap.</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-draw-indexed-image"></a><h3>xlib_draw_indexed_image ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_draw_indexed_image (<em class="parameter"><code><span class="type">Drawable</span> drawable</code></em>, + <em class="parameter"><code><span class="type">GC</span> gc</code></em>, + <em class="parameter"><code><span class="type">int</span> x</code></em>, + <em class="parameter"><code><span class="type">int</span> y</code></em>, + <em class="parameter"><code><span class="type">int</span> width</code></em>, + <em class="parameter"><code><span class="type">int</span> height</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbDither" title="enum XlibRgbDither"><span class="type">XlibRgbDither</span></a> dith</code></em>, + <em class="parameter"><code>unsigned <span class="type">char</span> *buf</code></em>, + <em class="parameter"><code><span class="type">int</span> rowstride</code></em>, + <em class="parameter"><code><a class="link" href="gdk-pixbuf-XlibRGB.html#XlibRgbCmap" title="struct XlibRgbCmap"><span class="type">XlibRgbCmap</span></a> *cmap</code></em>);</pre> +<p> +FIXME +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>drawable</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>gc</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>dith</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>buf</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>rowstride</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>cmap</code></em> :</span></p></td> +<td>FIXME</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-ditherable"></a><h3>xlib_rgb_ditherable ()</h3> +<pre class="programlisting"><span class="returnvalue">Bool</span> xlib_rgb_ditherable (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +Queries whether XlibRGB supports dithering for its chosen visual. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>TRUE if dithering can be performed for the visual that XlibRGB +is using, FALSE otherwise.</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-set-verbose"></a><h3>xlib_rgb_set_verbose ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_rgb_set_verbose (<em class="parameter"><code><span class="type">Bool</span> verbose</code></em>);</pre> +<p> +Enables/disables debug spew. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>verbose</code></em> :</span></p></td> +<td>True to be verbose</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-set-install"></a><h3>xlib_rgb_set_install ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_rgb_set_install (<em class="parameter"><code><span class="type">Bool</span> install</code></em>);</pre> +<p> +Sets whether we install an RGB colormap. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>install</code></em> :</span></p></td> +<td>True to install a colormap</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-set-min-colors"></a><h3>xlib_rgb_set_min_colors ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> xlib_rgb_set_min_colors (<em class="parameter"><code><span class="type">int</span> min_colors</code></em>);</pre> +<p> +Sets the minimum number of colors in the color cube. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><em class="parameter"><code>min_colors</code></em> :</span></p></td> +<td>minimum colors to use</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-get-cmap"></a><h3>xlib_rgb_get_cmap ()</h3> +<pre class="programlisting"><span class="returnvalue">Colormap</span> xlib_rgb_get_cmap (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +Queries the X colormap that XlibRGB is using. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>An X colormap.</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-get-visual"></a><h3>xlib_rgb_get_visual ()</h3> +<pre class="programlisting"><span class="returnvalue">Visual</span> * xlib_rgb_get_visual (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +Queries the visual that XlibRGB is using. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>An X visual.</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-get-visual-info"></a><h3>xlib_rgb_get_visual_info ()</h3> +<pre class="programlisting"><span class="returnvalue">XVisualInfo</span> * xlib_rgb_get_visual_info (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +Queries the visual info structure for the visual that XlibRGB is using. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>An XVisualInfo structure.</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-get-depth"></a><h3>xlib_rgb_get_depth ()</h3> +<pre class="programlisting"><span class="returnvalue">int</span> xlib_rgb_get_depth (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +Queries the depth of the visual that XlibRGB is using. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>Bit depth.</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-get-display"></a><h3>xlib_rgb_get_display ()</h3> +<pre class="programlisting"><span class="returnvalue">Display</span> * xlib_rgb_get_display (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +Queries the X display that XlibRGB is using. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>An X display.</td> +</tr></tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="xlib-rgb-get-screen"></a><h3>xlib_rgb_get_screen ()</h3> +<pre class="programlisting"><span class="returnvalue">Screen</span> * xlib_rgb_get_screen (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> +<p> +Queries the screen that XlibRGB is using. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> +<td>An X screen.</td> +</tr></tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-XlibRGB.see-also"></a><h2>See Also</h2> +GdkRGB +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-csource.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-csource.html new file mode 100644 index 0000000..b6a0d3c --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-csource.html @@ -0,0 +1,167 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>gdk-pixbuf-csource</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn02.html" title="Tools Reference"> +<link rel="prev" href="rn02.html" title="Tools Reference"> +<link rel="next" href="gdk-pixbuf-query-loaders.html" title="gdk-pixbuf-query-loaders"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"> +<td><a accesskey="p" href="rn02.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-query-loaders.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr></table> +<div class="refentry"> +<a name="gdk-pixbuf-csource"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle">gdk-pixbuf-csource</span></h2> +<p>gdk-pixbuf-csource — C code generation utility for GdkPixbuf images</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<h2>Synopsis</h2> +<div class="cmdsynopsis"><p><code class="command">gdk-pixbuf-csource</code> [OPTION...] [IMAGE]</p></div> +<div class="cmdsynopsis"><p><code class="command">gdk-pixbuf-csource</code> [OPTION...] --build-list [ + [NAME] + [IMAGE] +...]</p></div> +</div> +<div class="refsect1"> +<a name="idp6384464"></a><h2>Description</h2> +<p> +<span class="command"><strong>gdk-pixbuf-csource</strong></span> is a small utility that generates +C code containing images, useful for compiling images directly into programs. +</p> +<p> +<span class="command"><strong>gdk-pixbuf-csource</strong></span> either takes as input one image file +name to generate code for, or, using the <code class="option">--build-list</code> option, +a list of (<em class="replaceable"><code>name</code></em>, <em class="replaceable"><code>image</code></em>) +pairs to generate code for a list of images into named variables. +</p> +</div> +<div class="refsect1"> +<a name="idp14414512"></a><h2>Options</h2> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><code class="option">--stream</code></span></p></td> +<td><p> +Generate pixbuf data stream (a single string containing a serialized +<span class="structname">GdkPixdata</span> structure in network byte order). +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">--struct</code></span></p></td> +<td><p> +Generate GdkPixdata structure (needs the <span class="structname">GdkPixdata</span> +structure definition from <code class="filename">gdk-pixdata.h</code>). +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">--macros</code></span></p></td> +<td><p> +Generate *_ROWSTRIDE, *_WIDTH, *_HEIGHT, *_BYTES_PER_PIXEL and +*_RLE_PIXEL_DATA or *_PIXEL_DATA macro definitions for the image. +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">--rle</code></span></p></td> +<td><p> +Enables run-length encoding for the generated pixel data (default). +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">--raw</code></span></p></td> +<td><p> +Disables run-length encoding for the generated pixel data. +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">--extern</code></span></p></td> +<td><p> +Generate extern symbols. +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">--static</code></span></p></td> +<td><p> +Generate static symbols (default). +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">--decoder</code></span></p></td> +<td><p> +Provide a *_RUN_LENGTH_DECODE(image_buf, rle_data, size, bpp) macro definition +to decode run-length encoded image data. +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">--name=identifier</code></span></p></td> +<td><p> +Specifies the identifier name (prefix) for the generated variables or +macros (useful only if <code class="option">--build-list</code> was not specified). +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">--build-list</code></span></p></td> +<td><p> +Enables (<em class="replaceable"><code>name</code></em>, <em class="replaceable"><code>image</code></em>) +pair parsing mode. +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">-h</code>, <code class="option">--help</code></span></p></td> +<td><p> +Print brief help and exit. +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">-v</code>, <code class="option">--version</code></span></p></td> +<td><p> +Print version and exit. +</p></td> +</tr> +<tr> +<td><p><span class="term"><code class="option">--g-fatal-warnings</code></span></p></td> +<td><p> +Make warnings fatal (causes the program to abort). +</p></td> +</tr> +</tbody> +</table></div> +</div> +<div class="refsect1"> +<a name="idp14881328"></a><h2>See also</h2> +<p> +The <span class="structname">GdkPixbuf</span> documentation, shipped with the +Gtk+ distribution, available from <a class="ulink" href="http://www.gtk.org" target="_top">www.gtk.org</a>. +</p> +</div> +<div class="refsect1"> +<a name="idp14883648"></a><h2>Bugs</h2> +<p> +The runlength encoder gets out of sync with the pixel boundaries, since +it includes the rowstride padding in the encoded stream. Furthermore, it +generates pixbufs with suboptimal rowstride in some cases. +</p> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html new file mode 100644 index 0000000..d9a1840 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html @@ -0,0 +1,131 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>gdk-pixbuf Xlib initialization</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-Module-Interface.html" title="Module Interface"> +<link rel="next" href="gdk-pixbuf-Xlib-Rendering.html" title="Xlib Rendering"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> +<tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-Module-Interface.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-Xlib-Rendering.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr> +<tr><td colspan="5" class="shortcuts"> +<a href="#gdk-pixbuf-gdk-pixbuf-Xlib-initialization.synopsis" class="shortcut">Top</a> + | + <a href="#gdk-pixbuf-gdk-pixbuf-Xlib-initialization.description" class="shortcut">Description</a> +</td></tr> +</table> +<div class="refentry"> +<a name="gdk-pixbuf-gdk-pixbuf-Xlib-initialization"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle"><a name="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.top_of_page"></a>gdk-pixbuf Xlib initialization</span></h2> +<p>gdk-pixbuf Xlib initialization — Initializing the gdk-pixbuf Xlib library.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<a name="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.synopsis"></a><h2>Synopsis</h2> +<pre class="synopsis"> +#include <gdk-pixbuf/gdk-pixbuf.h> + +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-xlib-init" title="gdk_pixbuf_xlib_init ()">gdk_pixbuf_xlib_init</a> (<em class="parameter"><code><span class="type">Display</span> *display</code></em>, + <em class="parameter"><code><span class="type">int</span> screen_num</code></em>); +<span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-xlib-init-with-depth" title="gdk_pixbuf_xlib_init_with_depth ()">gdk_pixbuf_xlib_init_with_depth</a> (<em class="parameter"><code><span class="type">Display</span> *display</code></em>, + <em class="parameter"><code><span class="type">int</span> screen_num</code></em>, + <em class="parameter"><code><span class="type">int</span> prefDepth</code></em>); +</pre> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.description"></a><h2>Description</h2> +<p> +In addition to the normal Gdk-specific functions, the &gdk-pixbuf; +package provides a small library that lets Xlib-only applications +use <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structures and render them to X drawables. The +functions in this section are used to initialize the &gdk-pixbuf; +Xlib library. This library must be initialized near the beginning +of the program or before calling any of the other &gdk-pixbuf; +Xlib functions. +</p> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.details"></a><h2>Details</h2> +<div class="refsect2"> +<a name="gdk-pixbuf-xlib-init"></a><h3>gdk_pixbuf_xlib_init ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_xlib_init (<em class="parameter"><code><span class="type">Display</span> *display</code></em>, + <em class="parameter"><code><span class="type">int</span> screen_num</code></em>);</pre> +<p> +Initializes the gdk-pixbuf Xlib machinery by calling <a class="link" href="gdk-pixbuf-XlibRGB.html#xlib-rgb-init" title="xlib_rgb_init ()"><code class="function">xlib_rgb_init()</code></a>. This +function should be called near the beginning of your program, or before using +any of the gdk-pixbuf-xlib functions. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td> +<td>X display to use.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>screen_num</code></em> :</span></p></td> +<td>Screen number.</td> +</tr> +</tbody> +</table></div> +</div> +<hr> +<div class="refsect2"> +<a name="gdk-pixbuf-xlib-init-with-depth"></a><h3>gdk_pixbuf_xlib_init_with_depth ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_xlib_init_with_depth (<em class="parameter"><code><span class="type">Display</span> *display</code></em>, + <em class="parameter"><code><span class="type">int</span> screen_num</code></em>, + <em class="parameter"><code><span class="type">int</span> prefDepth</code></em>);</pre> +<p> +Similar to <a class="link" href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-xlib-init" title="gdk_pixbuf_xlib_init ()"><code class="function">gdk_pixbuf_xlib_init()</code></a>, but also lets you specify the preferred +depth for XlibRGB if you do not want it to use the default depth it picks. +</p> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody> +<tr> +<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td> +<td>X display to use.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>screen_num</code></em> :</span></p></td> +<td>Screen number.</td> +</tr> +<tr> +<td><p><span class="term"><em class="parameter"><code>prefDepth</code></em> :</span></p></td> +<td>Preferred depth for XlibRGB.</td> +</tr> +</tbody> +</table></div> +</div> +</div> +<div class="refsect1"> +<a name="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.see-also"></a><h2>See Also</h2> +XlibRGB +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-gdk-pixbuf-from-drawables.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-gdk-pixbuf-from-drawables.html new file mode 100644 index 0000000..6c19d3b --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-gdk-pixbuf-from-drawables.html @@ -0,0 +1,45 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Drawables to Pixbufs</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-gdk-pixbuf-rendering.html" title="Rendering"> +<link rel="next" href="gdk-pixbuf-Utilities.html" title="Utilities"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-gdk-pixbuf-rendering.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-Utilities.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr></table> +<div class="refentry"> +<a name="gdk-pixbuf-gdk-pixbuf-from-drawables"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle">Drawables to Pixbufs</span></h2> +<p>Drawables to Pixbufs — Getting parts of a GDK drawable's image data into a pixbuf.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="idp5916544"></a><h2>Description</h2> +<p> + The functions to take the image data from a GDK drawable and dump it + into a pixbuf are contained in GDK, see the + Pixbufs section of the GDK + documentation. + </p> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-gdk-pixbuf-rendering.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-gdk-pixbuf-rendering.html new file mode 100644 index 0000000..47805cf --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-gdk-pixbuf-rendering.html @@ -0,0 +1,44 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Rendering</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn01.html" title="API Reference"> +<link rel="prev" href="gdk-pixbuf-Scaling.html" title="Scaling"> +<link rel="next" href="gdk-pixbuf-gdk-pixbuf-from-drawables.html" title="Drawables to Pixbufs"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-Scaling.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-gdk-pixbuf-from-drawables.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr></table> +<div class="refentry"> +<a name="gdk-pixbuf-gdk-pixbuf-rendering"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle">Rendering</span></h2> +<p>Rendering — Rendering a pixbuf to a GDK drawable.</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsect1"> +<a name="idp9159504"></a><h2>Description</h2> +<p> + The functions to render pixbufs to GDK drawables are contained in + GDK, see the Pixbufs section + of the GDK documentation. + </p> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf-query-loaders.html b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-query-loaders.html new file mode 100644 index 0000000..e63b405 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf-query-loaders.html @@ -0,0 +1,85 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>gdk-pixbuf-query-loaders</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="rn02.html" title="Tools Reference"> +<link rel="prev" href="gdk-pixbuf-csource.html" title="gdk-pixbuf-csource"> +<link rel="next" href="api-index-full.html" title="Index of all symbols"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-csource.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td><a accesskey="u" href="rn02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="api-index-full.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr></table> +<div class="refentry"> +<a name="gdk-pixbuf-query-loaders"></a><div class="titlepage"></div> +<div class="refnamediv"><table width="100%"><tr> +<td valign="top"> +<h2><span class="refentrytitle">gdk-pixbuf-query-loaders</span></h2> +<p>gdk-pixbuf-query-loaders — GdkPixbuf loader registration utility</p> +</td> +<td valign="top" align="right"></td> +</tr></table></div> +<div class="refsynopsisdiv"> +<h2>Synopsis</h2> +<div class="cmdsynopsis"><p><code class="command">gdk-pixbuf-query-loaders</code> [--update-cache] [MODULE...]</p></div> +</div> +<div class="refsect1"> +<a name="idp10297952"></a><h2>Description</h2> +<p> +<span class="command"><strong>gdk-pixbuf-query-loaders</strong></span> collects information about +loadable modules for <span class="application">gdk-pixbuf</span> and writes it to +the default cache file location, or to <code class="filename">stdout</code>. +</p> +<p> +If called without arguments, it looks for modules in the +<span class="application">gdk-pixbuf</span> loader directory. +</p> +<p> +If called with arguments, it looks for the specified modules. The arguments +may be absolute or relative paths. +</p> +<p> +Normally, the output of <span class="command"><strong>gdk-pixbuf-queryloaders</strong></span> is written +to <code class="filename"><em class="replaceable"><code>libdir</code></em>/gdk-pixbuf-2.0/2.10.0/loaders.cache</code>, where <span class="application">gdk-pixbuf</span> looks for it by default. If it is written to some other +location, the environment variable <code class="envar">GDK_PIXBUF_MODULE_FILE</code> +can be set to point <span class="application">gdk-pixbuf</span> at the file. +</p> +</div> +<div class="refsect1"> +<a name="idp13550240"></a><h2>Options</h2> +<div class="variablelist"><table border="0" class="variablelist"> +<colgroup> +<col align="left" valign="top"> +<col> +</colgroup> +<tbody><tr> +<td><p><span class="term">--update-cache</span></p></td> +<td><p>Write the output to the default cache location instead of + <code class="filename">stdout</code></p></td> +</tr></tbody> +</table></div> +</div> +<div class="refsect1"> +<a name="idp13553312"></a><h2>Environment</h2> +<p> +The environment variable <code class="envar">GDK_PIXBUF_MODULEDIR</code> can be used +to specify a different loader directory. The default +<span class="application">gdk-pixbuf</span> loader +directory is <code class="filename"><em class="replaceable"><code>libdir</code></em>/gdk-pixbuf-2.0/<em class="replaceable"><code>version</code></em>/loaders</code>. +</p> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/gdk-pixbuf.devhelp2 b/docs/reference/gdk-pixbuf/html/gdk-pixbuf.devhelp2 new file mode 100644 index 0000000..fe3301a --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/gdk-pixbuf.devhelp2 @@ -0,0 +1,258 @@ +<?xml version="1.0" encoding="utf-8" standalone="no"?> +<!DOCTYPE book PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" ""> +<book xmlns="http://www.devhelp.net/book" title="GDK-PixBuf Reference Manual" link="index.html" author="Federico Mena Quintero" name="gdk-pixbuf" version="2" language="c"> + <chapters> + <sub name="API Reference" link="rn01.html"> + <sub name="Initialization and Versions" link="gdk-pixbuf-Versioning.html"/> + <sub name="The GdkPixbuf Structure" link="gdk-pixbuf-The-GdkPixbuf-Structure.html"/> + <sub name="Reference Counting and Memory Mangement" link="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html"/> + <sub name="File Loading" link="gdk-pixbuf-File-Loading.html"/> + <sub name="File saving" link="gdk-pixbuf-File-saving.html"/> + <sub name="Image Data in Memory" link="gdk-pixbuf-Image-Data-in-Memory.html"/> + <sub name="Inline data" link="gdk-pixbuf-Inline-data.html"/> + <sub name="Scaling" link="gdk-pixbuf-Scaling.html"/> + <sub name="Rendering" link="gdk-pixbuf-gdk-pixbuf-rendering.html"/> + <sub name="Drawables to Pixbufs" link="gdk-pixbuf-gdk-pixbuf-from-drawables.html"/> + <sub name="Utilities" link="gdk-pixbuf-Utilities.html"/> + <sub name="Animations" link="gdk-pixbuf-Animations.html"/> + <sub name="GdkPixbufLoader" link="GdkPixbufLoader.html"/> + <sub name="Module Interface" link="gdk-pixbuf-Module-Interface.html"/> + <sub name="gdk-pixbuf Xlib initialization" link="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html"/> + <sub name="Xlib Rendering" link="gdk-pixbuf-Xlib-Rendering.html"/> + <sub name="X Drawables to Pixbufs" link="gdk-pixbuf-X-Drawables-to-Pixbufs.html"/> + <sub name="XlibRGB" link="gdk-pixbuf-XlibRGB.html"/> + </sub> + <sub name="Tools Reference" link="rn02.html"> + <sub name="gdk-pixbuf-csource" link="gdk-pixbuf-csource.html"/> + <sub name="gdk-pixbuf-query-loaders" link="gdk-pixbuf-query-loaders.html"/> + </sub> + <sub name="Index of all symbols" link="api-index-full.html"/> + <sub name="Index of deprecated symbols" link="api-index-deprecated.html"/> + <sub name="Index of new symbols in 2.2" link="api-index-2-2.html"/> + <sub name="Index of new symbols in 2.4" link="api-index-2-4.html"/> + <sub name="Index of new symbols in 2.6" link="api-index-2-6.html"/> + <sub name="Index of new symbols in 2.8" link="api-index-2-8.html"/> + <sub name="Index of new symbols in 2.12" link="api-index-2-12.html"/> + <sub name="Index of new symbols in 2.14" link="api-index-2-14.html"/> + <sub name="Index of new symbols in 2.26" link="api-index-2-26.html"/> + <sub name="License" link="license.html"/> + <sub name="Annotation Glossary" link="annotation-glossary.html"/> + </chapters> + <functions> + <keyword type="variable" name="gdk_pixbuf_version" link="gdk-pixbuf-Versioning.html#gdk-pixbuf-version"/> + <keyword type="variable" name="gdk_pixbuf_major_version" link="gdk-pixbuf-Versioning.html#gdk-pixbuf-major-version"/> + <keyword type="variable" name="gdk_pixbuf_minor_version" link="gdk-pixbuf-Versioning.html#gdk-pixbuf-minor-version"/> + <keyword type="variable" name="gdk_pixbuf_micro_version" link="gdk-pixbuf-Versioning.html#gdk-pixbuf-micro-version"/> + <keyword type="macro" name="GDK_PIXBUF_VERSION" link="gdk-pixbuf-Versioning.html#GDK-PIXBUF-VERSION:CAPS"/> + <keyword type="macro" name="GDK_PIXBUF_MAJOR" link="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MAJOR:CAPS"/> + <keyword type="macro" name="GDK_PIXBUF_MINOR" link="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MINOR:CAPS"/> + <keyword type="macro" name="GDK_PIXBUF_MICRO" link="gdk-pixbuf-Versioning.html#GDK-PIXBUF-MICRO:CAPS"/> + <keyword type="enum" name="enum GdkPixbufError" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufError"/> + <keyword type="macro" name="GDK_PIXBUF_ERROR" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS"/> + <keyword type="enum" name="enum GdkColorspace" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace"/> + <keyword type="enum" name="enum GdkPixbufAlphaMode" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufAlphaMode"/> + <keyword type="struct" name="GdkPixbuf" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"/> + <keyword type="function" name="gdk_pixbuf_get_colorspace ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-colorspace"/> + <keyword type="function" name="gdk_pixbuf_get_n_channels ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-n-channels"/> + <keyword type="function" name="gdk_pixbuf_get_has_alpha ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-has-alpha"/> + <keyword type="function" name="gdk_pixbuf_get_bits_per_sample ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-bits-per-sample"/> + <keyword type="function" name="gdk_pixbuf_get_pixels ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-pixels"/> + <keyword type="function" name="gdk_pixbuf_get_pixels_with_length ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-pixels-with-length" since="2.26"/> + <keyword type="function" name="gdk_pixbuf_get_width ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-width"/> + <keyword type="function" name="gdk_pixbuf_get_height ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-height"/> + <keyword type="function" name="gdk_pixbuf_get_rowstride ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-rowstride"/> + <keyword type="function" name="gdk_pixbuf_get_byte_length ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-byte-length" since="2.26"/> + <keyword type="function" name="gdk_pixbuf_get_option ()" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-option"/> + <keyword type="property" name="The "bits-per-sample" property" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--bits-per-sample"/> + <keyword type="property" name="The "colorspace" property" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--colorspace"/> + <keyword type="property" name="The "has-alpha" property" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--has-alpha"/> + <keyword type="property" name="The "height" property" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--height"/> + <keyword type="property" name="The "n-channels" property" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--n-channels"/> + <keyword type="property" name="The "pixels" property" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--pixels"/> + <keyword type="property" name="The "rowstride" property" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--rowstride"/> + <keyword type="property" name="The "width" property" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--width"/> + <keyword type="function" name="gdk_pixbuf_ref ()" link="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-ref" deprecated="2.0: Use g_object_ref()."/> + <keyword type="function" name="gdk_pixbuf_unref ()" link="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref" deprecated="2.0: Use g_object_unref()."/> + <keyword type="function" name="GdkPixbufDestroyNotify ()" link="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify"/> + <keyword type="function" name="gdk_pixbuf_new_from_file ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file"/> + <keyword type="function" name="gdk_pixbuf_new_from_file_at_size ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-size" since="2.4"/> + <keyword type="function" name="gdk_pixbuf_new_from_file_at_scale ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-scale" since="2.6"/> + <keyword type="function" name="gdk_pixbuf_get_file_info ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-get-file-info" since="2.4"/> + <keyword type="function" name="gdk_pixbuf_new_from_resource ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-resource" since="2.26"/> + <keyword type="function" name="gdk_pixbuf_new_from_resource_at_scale ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-resource-at-scale" since="2.26"/> + <keyword type="function" name="gdk_pixbuf_new_from_stream ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream" since="2.14"/> + <keyword type="function" name="gdk_pixbuf_new_from_stream_async ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-async" since="2.24"/> + <keyword type="function" name="gdk_pixbuf_new_from_stream_finish ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-finish" since="2.24"/> + <keyword type="function" name="gdk_pixbuf_new_from_stream_at_scale ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale" since="2.14"/> + <keyword type="function" name="gdk_pixbuf_new_from_stream_at_scale_async ()" link="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale-async" since="2.24"/> + <keyword type="function" name="gdk_pixbuf_savev ()" link="gdk-pixbuf-File-saving.html#gdk-pixbuf-savev"/> + <keyword type="function" name="gdk_pixbuf_save ()" link="gdk-pixbuf-File-saving.html#gdk-pixbuf-save"/> + <keyword type="function" name="GdkPixbufSaveFunc ()" link="gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc" since="2.4"/> + <keyword type="function" name="gdk_pixbuf_save_to_callback ()" link="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback" since="2.4"/> + <keyword type="function" name="gdk_pixbuf_save_to_callbackv ()" link="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callbackv" since="2.4"/> + <keyword type="function" name="gdk_pixbuf_save_to_buffer ()" link="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-buffer" since="2.4"/> + <keyword type="function" name="gdk_pixbuf_save_to_bufferv ()" link="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-bufferv" since="2.4"/> + <keyword type="function" name="gdk_pixbuf_save_to_stream ()" link="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream" since="2.14"/> + <keyword type="function" name="gdk_pixbuf_save_to_stream_async ()" link="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream-async" since="2.24"/> + <keyword type="function" name="gdk_pixbuf_save_to_stream_finish ()" link="gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream-finish" since="2.24"/> + <keyword type="function" name="gdk_pixbuf_new ()" link="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new"/> + <keyword type="function" name="gdk_pixbuf_new_from_data ()" link="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data"/> + <keyword type="function" name="gdk_pixbuf_new_from_xpm_data ()" link="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-xpm-data"/> + <keyword type="function" name="gdk_pixbuf_new_from_inline ()" link="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline"/> + <keyword type="function" name="gdk_pixbuf_new_subpixbuf ()" link="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-subpixbuf"/> + <keyword type="function" name="gdk_pixbuf_copy ()" link="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-copy"/> + <keyword type="struct" name="struct GdkPixdata" link="gdk-pixbuf-Inline-data.html#GdkPixdata"/> + <keyword type="enum" name="enum GdkPixdataType" link="gdk-pixbuf-Inline-data.html#GdkPixdataType"/> + <keyword type="enum" name="enum GdkPixdataDumpType" link="gdk-pixbuf-Inline-data.html#GdkPixdataDumpType"/> + <keyword type="macro" name="GDK_PIXBUF_MAGIC_NUMBER" link="gdk-pixbuf-Inline-data.html#GDK-PIXBUF-MAGIC-NUMBER:CAPS"/> + <keyword type="macro" name="GDK_PIXDATA_HEADER_LENGTH" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-HEADER-LENGTH:CAPS"/> + <keyword type="function" name="gdk_pixdata_from_pixbuf ()" link="gdk-pixbuf-Inline-data.html#gdk-pixdata-from-pixbuf"/> + <keyword type="function" name="gdk_pixbuf_from_pixdata ()" link="gdk-pixbuf-Inline-data.html#gdk-pixbuf-from-pixdata"/> + <keyword type="function" name="gdk_pixdata_serialize ()" link="gdk-pixbuf-Inline-data.html#gdk-pixdata-serialize"/> + <keyword type="function" name="gdk_pixdata_deserialize ()" link="gdk-pixbuf-Inline-data.html#gdk-pixdata-deserialize"/> + <keyword type="function" name="gdk_pixdata_to_csource ()" link="gdk-pixbuf-Inline-data.html#gdk-pixdata-to-csource"/> + <keyword type="enum" name="enum GdkInterpType" link="gdk-pixbuf-Scaling.html#GdkInterpType"/> + <keyword type="function" name="gdk_pixbuf_scale_simple ()" link="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple"/> + <keyword type="function" name="gdk_pixbuf_scale ()" link="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale"/> + <keyword type="function" name="gdk_pixbuf_composite_color_simple ()" link="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple"/> + <keyword type="function" name="gdk_pixbuf_composite ()" link="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite"/> + <keyword type="function" name="gdk_pixbuf_composite_color ()" link="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color"/> + <keyword type="enum" name="enum GdkPixbufRotation" link="gdk-pixbuf-Scaling.html#GdkPixbufRotation"/> + <keyword type="function" name="gdk_pixbuf_rotate_simple ()" link="gdk-pixbuf-Scaling.html#gdk-pixbuf-rotate-simple" since="2.6"/> + <keyword type="function" name="gdk_pixbuf_flip ()" link="gdk-pixbuf-Scaling.html#gdk-pixbuf-flip" since="2.6"/> + <keyword type="function" name="gdk_pixbuf_add_alpha ()" link="gdk-pixbuf-Utilities.html#gdk-pixbuf-add-alpha"/> + <keyword type="function" name="gdk_pixbuf_copy_area ()" link="gdk-pixbuf-Utilities.html#gdk-pixbuf-copy-area"/> + <keyword type="function" name="gdk_pixbuf_saturate_and_pixelate ()" link="gdk-pixbuf-Utilities.html#gdk-pixbuf-saturate-and-pixelate"/> + <keyword type="function" name="gdk_pixbuf_apply_embedded_orientation ()" link="gdk-pixbuf-Utilities.html#gdk-pixbuf-apply-embedded-orientation" since="2.12"/> + <keyword type="function" name="gdk_pixbuf_fill ()" link="gdk-pixbuf-Utilities.html#gdk-pixbuf-fill"/> + <keyword type="struct" name="struct GdkPixbufAnimation" link="gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"/> + <keyword type="struct" name="struct GdkPixbufAnimationIter" link="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter-struct"/> + <keyword type="function" name="gdk_pixbuf_animation_new_from_file ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file"/> + <keyword type="function" name="gdk_pixbuf_animation_ref ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-ref" deprecated="2.0: Use g_object_ref()."/> + <keyword type="function" name="gdk_pixbuf_animation_unref ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-unref" deprecated="2.0: Use g_object_unref()."/> + <keyword type="function" name="gdk_pixbuf_animation_get_width ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-width"/> + <keyword type="function" name="gdk_pixbuf_animation_get_height ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-height"/> + <keyword type="function" name="gdk_pixbuf_animation_get_iter ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-iter"/> + <keyword type="function" name="gdk_pixbuf_animation_is_static_image ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-is-static-image"/> + <keyword type="function" name="gdk_pixbuf_animation_get_static_image ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-static-image"/> + <keyword type="function" name="gdk_pixbuf_animation_iter_advance ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-advance"/> + <keyword type="function" name="gdk_pixbuf_animation_iter_get_delay_time ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-delay-time"/> + <keyword type="function" name="gdk_pixbuf_animation_iter_on_currently_loading_frame ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-on-currently-loading-frame"/> + <keyword type="function" name="gdk_pixbuf_animation_iter_get_pixbuf ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf"/> + <keyword type="struct" name="GdkPixbufSimpleAnim" link="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim-struct"/> + <keyword type="function" name="gdk_pixbuf_simple_anim_new ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-new" since="2.8"/> + <keyword type="function" name="gdk_pixbuf_simple_anim_add_frame ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-add-frame" since="2.8"/> + <keyword type="function" name="gdk_pixbuf_simple_anim_set_loop ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-set-loop" since="2.18"/> + <keyword type="function" name="gdk_pixbuf_simple_anim_get_loop ()" link="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-get-loop" since="2.18"/> + <keyword type="property" name="The "loop" property" link="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim--loop"/> + <keyword type="" name="Loading an animation" link="GdkPixbufLoader.html#idp5518640"/> + <keyword type="struct" name="struct GdkPixbufLoader" link="GdkPixbufLoader.html#GdkPixbufLoader-struct"/> + <keyword type="function" name="gdk_pixbuf_loader_new ()" link="GdkPixbufLoader.html#gdk-pixbuf-loader-new"/> + <keyword type="function" name="gdk_pixbuf_loader_new_with_type ()" link="GdkPixbufLoader.html#gdk-pixbuf-loader-new-with-type"/> + <keyword type="function" name="gdk_pixbuf_loader_new_with_mime_type ()" link="GdkPixbufLoader.html#gdk-pixbuf-loader-new-with-mime-type" since="2.4"/> + <keyword type="function" name="gdk_pixbuf_loader_get_format ()" link="GdkPixbufLoader.html#gdk-pixbuf-loader-get-format" since="2.2"/> + <keyword type="function" name="gdk_pixbuf_loader_write ()" link="GdkPixbufLoader.html#gdk-pixbuf-loader-write"/> + <keyword type="function" name="gdk_pixbuf_loader_set_size ()" link="GdkPixbufLoader.html#gdk-pixbuf-loader-set-size" since="2.2"/> + <keyword type="function" name="gdk_pixbuf_loader_get_pixbuf ()" link="GdkPixbufLoader.html#gdk-pixbuf-loader-get-pixbuf"/> + <keyword type="function" name="gdk_pixbuf_loader_get_animation ()" link="GdkPixbufLoader.html#gdk-pixbuf-loader-get-animation"/> + <keyword type="function" name="gdk_pixbuf_loader_close ()" link="GdkPixbufLoader.html#gdk-pixbuf-loader-close"/> + <keyword type="signal" name="The "area-prepared" signal" link="GdkPixbufLoader.html#GdkPixbufLoader-area-prepared"/> + <keyword type="signal" name="The "area-updated" signal" link="GdkPixbufLoader.html#GdkPixbufLoader-area-updated"/> + <keyword type="signal" name="The "closed" signal" link="GdkPixbufLoader.html#GdkPixbufLoader-closed"/> + <keyword type="signal" name="The "size-prepared" signal" link="GdkPixbufLoader.html#GdkPixbufLoader-size-prepared"/> + <keyword type="function" name="gdk_pixbuf_set_option ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-set-option" since="2.2"/> + <keyword type="function" name="gdk_pixbuf_get_formats ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-get-formats" since="2.2"/> + <keyword type="function" name="gdk_pixbuf_format_copy ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-copy" since="2.22"/> + <keyword type="function" name="gdk_pixbuf_format_free ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-free" since="2.22"/> + <keyword type="function" name="gdk_pixbuf_format_get_name ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-name" since="2.2"/> + <keyword type="function" name="gdk_pixbuf_format_get_description ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-description" since="2.2"/> + <keyword type="function" name="gdk_pixbuf_format_get_mime_types ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-mime-types" since="2.2"/> + <keyword type="function" name="gdk_pixbuf_format_get_extensions ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-extensions" since="2.2"/> + <keyword type="function" name="gdk_pixbuf_format_is_writable ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-writable" since="2.2"/> + <keyword type="function" name="gdk_pixbuf_format_is_scalable ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-scalable" since="2.6"/> + <keyword type="function" name="gdk_pixbuf_format_is_disabled ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-disabled" since="2.6"/> + <keyword type="function" name="gdk_pixbuf_format_set_disabled ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-set-disabled" since="2.6"/> + <keyword type="function" name="gdk_pixbuf_format_get_license ()" link="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-license" since="2.6"/> + <keyword type="struct" name="struct GdkPixbufFormat" link="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" since="2.2"/> + <keyword type="enum" name="enum GdkPixbufFormatFlags" link="gdk-pixbuf-Module-Interface.html#GdkPixbufFormatFlags" since="2.2"/> + <keyword type="struct" name="struct GdkPixbufModulePattern" link="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern" since="2.2"/> + <keyword type="function" name="GdkPixbufModuleFillVtableFunc ()" link="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc" since="2.2"/> + <keyword type="function" name="GdkPixbufModuleFillInfoFunc ()" link="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillInfoFunc" since="2.2"/> + <keyword type="function" name="GdkPixbufModuleSizeFunc ()" link="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleSizeFunc" since="2.2"/> + <keyword type="function" name="GdkPixbufModulePreparedFunc ()" link="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePreparedFunc" since="2.2"/> + <keyword type="function" name="GdkPixbufModuleUpdatedFunc ()" link="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleUpdatedFunc" since="2.2"/> + <keyword type="struct" name="struct GdkPixbufModule" link="gdk-pixbuf-Module-Interface.html#GdkPixbufModule"/> + <keyword type="struct" name="struct GdkPixbufAnimationClass" link="gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationClass"/> + <keyword type="struct" name="struct GdkPixbufAnimationIterClass" link="gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationIterClass"/> + <keyword type="function" name="gdk_pixbuf_xlib_init ()" link="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-xlib-init"/> + <keyword type="function" name="gdk_pixbuf_xlib_init_with_depth ()" link="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-xlib-init-with-depth"/> + <keyword type="function" name="gdk_pixbuf_xlib_render_threshold_alpha ()" link="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-threshold-alpha"/> + <keyword type="function" name="gdk_pixbuf_xlib_render_to_drawable ()" link="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable"/> + <keyword type="function" name="gdk_pixbuf_xlib_render_to_drawable_alpha ()" link="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable-alpha"/> + <keyword type="function" name="gdk_pixbuf_xlib_render_pixmap_and_mask ()" link="gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-pixmap-and-mask"/> + <keyword type="function" name="gdk_pixbuf_xlib_get_from_drawable ()" link="gdk-pixbuf-X-Drawables-to-Pixbufs.html#gdk-pixbuf-xlib-get-from-drawable"/> + <keyword type="struct" name="struct XlibRgbCmap" link="gdk-pixbuf-XlibRGB.html#XlibRgbCmap"/> + <keyword type="enum" name="enum XlibRgbDither" link="gdk-pixbuf-XlibRGB.html#XlibRgbDither"/> + <keyword type="function" name="xlib_rgb_init ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-init"/> + <keyword type="function" name="xlib_rgb_init_with_depth ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-init-with-depth"/> + <keyword type="function" name="xlib_rgb_xpixel_from_rgb ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-xpixel-from-rgb"/> + <keyword type="function" name="xlib_rgb_gc_set_foreground ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-gc-set-foreground"/> + <keyword type="function" name="xlib_rgb_gc_set_background ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-gc-set-background"/> + <keyword type="function" name="xlib_draw_rgb_image ()" link="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image"/> + <keyword type="function" name="xlib_draw_rgb_image_dithalign ()" link="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image-dithalign"/> + <keyword type="function" name="xlib_draw_rgb_32_image ()" link="gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-32-image"/> + <keyword type="function" name="xlib_draw_gray_image ()" link="gdk-pixbuf-XlibRGB.html#xlib-draw-gray-image"/> + <keyword type="function" name="xlib_rgb_cmap_new ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-cmap-new"/> + <keyword type="function" name="xlib_rgb_cmap_free ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-cmap-free"/> + <keyword type="function" name="xlib_draw_indexed_image ()" link="gdk-pixbuf-XlibRGB.html#xlib-draw-indexed-image"/> + <keyword type="function" name="xlib_rgb_ditherable ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-ditherable"/> + <keyword type="function" name="xlib_rgb_set_verbose ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-verbose"/> + <keyword type="function" name="xlib_rgb_set_install ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-install"/> + <keyword type="function" name="xlib_rgb_set_min_colors ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-set-min-colors"/> + <keyword type="function" name="xlib_rgb_get_cmap ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-cmap"/> + <keyword type="function" name="xlib_rgb_get_visual ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-visual"/> + <keyword type="function" name="xlib_rgb_get_visual_info ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-visual-info"/> + <keyword type="function" name="xlib_rgb_get_depth ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-depth"/> + <keyword type="function" name="xlib_rgb_get_display ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-display"/> + <keyword type="function" name="xlib_rgb_get_screen ()" link="gdk-pixbuf-XlibRGB.html#xlib-rgb-get-screen"/> + <keyword type="constant" name="GDK_PIXBUF_ERROR_CORRUPT_IMAGE" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-CORRUPT-IMAGE:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ERROR_INSUFFICIENT_MEMORY" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-INSUFFICIENT-MEMORY:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ERROR_BAD_OPTION" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-BAD-OPTION:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ERROR_UNKNOWN_TYPE" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-UNKNOWN-TYPE:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ERROR_UNSUPPORTED_OPERATION" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-UNSUPPORTED-OPERATION:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ERROR_FAILED" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-FAILED:CAPS"/> + <keyword type="constant" name="GDK_COLORSPACE_RGB" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-COLORSPACE-RGB:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ALPHA_BILEVEL" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ALPHA-BILEVEL:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ALPHA_FULL" link="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ALPHA-FULL:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_COLOR_TYPE_RGB" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-COLOR-TYPE-RGB:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_COLOR_TYPE_RGBA" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-COLOR-TYPE-RGBA:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_COLOR_TYPE_MASK" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-COLOR-TYPE-MASK:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_SAMPLE_WIDTH_8" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-SAMPLE-WIDTH-8:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_SAMPLE_WIDTH_MASK" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-SAMPLE-WIDTH-MASK:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_ENCODING_RAW" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-ENCODING-RAW:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_ENCODING_RLE" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-ENCODING-RLE:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_ENCODING_MASK" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-ENCODING-MASK:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_DUMP_PIXDATA_STREAM" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-PIXDATA-STREAM:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_DUMP_PIXDATA_STRUCT" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-PIXDATA-STRUCT:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_DUMP_MACROS" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-MACROS:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_DUMP_GTYPES" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-GTYPES:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_DUMP_CTYPES" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-CTYPES:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_DUMP_STATIC" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-STATIC:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_DUMP_CONST" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-CONST:CAPS"/> + <keyword type="constant" name="GDK_PIXDATA_DUMP_RLE_DECODER" link="gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-RLE-DECODER:CAPS"/> + <keyword type="constant" name="GDK_INTERP_NEAREST" link="gdk-pixbuf-Scaling.html#GDK-INTERP-NEAREST:CAPS"/> + <keyword type="constant" name="GDK_INTERP_TILES" link="gdk-pixbuf-Scaling.html#GDK-INTERP-TILES:CAPS"/> + <keyword type="constant" name="GDK_INTERP_BILINEAR" link="gdk-pixbuf-Scaling.html#GDK-INTERP-BILINEAR:CAPS"/> + <keyword type="constant" name="GDK_INTERP_HYPER" link="gdk-pixbuf-Scaling.html#GDK-INTERP-HYPER:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ROTATE_NONE" link="gdk-pixbuf-Scaling.html#GDK-PIXBUF-ROTATE-NONE:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ROTATE_COUNTERCLOCKWISE" link="gdk-pixbuf-Scaling.html#GDK-PIXBUF-ROTATE-COUNTERCLOCKWISE:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ROTATE_UPSIDEDOWN" link="gdk-pixbuf-Scaling.html#GDK-PIXBUF-ROTATE-UPSIDEDOWN:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_ROTATE_CLOCKWISE" link="gdk-pixbuf-Scaling.html#GDK-PIXBUF-ROTATE-CLOCKWISE:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_FORMAT_WRITABLE" link="gdk-pixbuf-Module-Interface.html#GDK-PIXBUF-FORMAT-WRITABLE:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_FORMAT_SCALABLE" link="gdk-pixbuf-Module-Interface.html#GDK-PIXBUF-FORMAT-SCALABLE:CAPS"/> + <keyword type="constant" name="GDK_PIXBUF_FORMAT_THREADSAFE" link="gdk-pixbuf-Module-Interface.html#GDK-PIXBUF-FORMAT-THREADSAFE:CAPS"/> + <keyword type="constant" name="XLIB_RGB_DITHER_NONE" link="gdk-pixbuf-XlibRGB.html#XLIB-RGB-DITHER-NONE:CAPS"/> + <keyword type="constant" name="XLIB_RGB_DITHER_NORMAL" link="gdk-pixbuf-XlibRGB.html#XLIB-RGB-DITHER-NORMAL:CAPS"/> + <keyword type="constant" name="XLIB_RGB_DITHER_MAX" link="gdk-pixbuf-XlibRGB.html#XLIB-RGB-DITHER-MAX:CAPS"/> + </functions> +</book> diff --git a/docs/reference/gdk-pixbuf/html/home.png b/docs/reference/gdk-pixbuf/html/home.png Binary files differnew file mode 100644 index 0000000..1700361 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/home.png diff --git a/docs/reference/gdk-pixbuf/html/index.html b/docs/reference/gdk-pixbuf/html/index.html new file mode 100644 index 0000000..f6b0c76 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/index.html @@ -0,0 +1,148 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>GDK-PixBuf Reference Manual</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="next" href="rn01.html" title="API Reference"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<div class="book"> +<div class="titlepage"> +<div> +<div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">GDK-PixBuf Reference Manual</p></th></tr></table></div> +<div><div class="authorgroup"><div class="author"> +<h3 class="author"> +<span class="firstname">Federico</span> <span class="surname">Mena Quintero</span> +</h3> +<div class="affiliation"><div class="address"><p><br> + <code class="email"><<a class="email" href="mailto:federico@gimp.org">federico@gimp.org</a>></code><br> + </p></div></div> +</div></div></div> +<div><p class="releaseinfo"> + Version 2.26.4 + + The latest version of this documentation can be found on-line at + <a class="ulink" href="http://library.gnome.org/devel/gdk-pixbuf/unstable/" target="_top">http://library.gnome.org/devel/gdk-pixbuf/unstable/</a>. + </p></div> +<div><p class="copyright">Copyright © 2000 The Free Software Foundation</p></div> +<div><div class="legalnotice"> +<a name="idp4072016"></a><p> + Permission is granted to copy, distribute and/or modify this + document under the terms of the <em class="citetitle">GNU Free + Documentation License</em>, Version 1.1 or any later + version published by the Free Software Foundation with no + Invariant Sections, no Front-Cover Texts, and no Back-Cover + Texts. You may obtain a copy of the <em class="citetitle">GNU Free + Documentation License</em> from the Free Software + Foundation by visiting <a class="ulink" href="http://www.fsf.org" target="_top">their Web site</a> or by writing + to: + + </p> +<div class="address"><p><br> + The Free Software Foundation, Inc.,<br> + <span class="street">59 Temple Place</span> - Suite 330,<br> + <span class="city">Boston</span>, <span class="state">MA</span> <span class="postcode">02111-1307</span>,<br> + <span class="country">USA</span><br> + </p></div> +<p> + </p> +<p> + Many of the names used by companies to distinguish their + products and services are claimed as trademarks. Where those + names appear in any GNOME documentation, and those trademarks + are made aware to the members of the GNOME Documentation + Project, the names have been printed in caps or initial caps. + </p> +</div></div> +</div> +<hr> +</div> +<div class="toc"><dl> +<dt><span class="reference"><a href="rn01.html">I. API Reference</a></span></dt> +<dd><dl> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Versioning.html">Initialization and Versions</a></span><span class="refpurpose"> — Library version numbers.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-The-GdkPixbuf-Structure.html">The GdkPixbuf Structure</a></span><span class="refpurpose"> — Information that describes an image.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html">Reference Counting and Memory Mangement</a></span><span class="refpurpose"> — Functions for reference counting and memory management on pixbufs.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-File-Loading.html">File Loading</a></span><span class="refpurpose"> — Loading a pixbuf from a file.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-File-saving.html">File saving</a></span><span class="refpurpose"> — Saving a pixbuf to a file.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Image-Data-in-Memory.html">Image Data in Memory</a></span><span class="refpurpose"> — Creating a pixbuf from image data that is already in memory.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Inline-data.html">Inline data</a></span><span class="refpurpose"> — Functions for inlined pixbuf handling.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Scaling.html">Scaling</a></span><span class="refpurpose"> — Scaling pixbufs and scaling and compositing pixbufs</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-gdk-pixbuf-rendering.html">Rendering</a></span><span class="refpurpose"> — Rendering a pixbuf to a GDK drawable.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-gdk-pixbuf-from-drawables.html">Drawables to Pixbufs</a></span><span class="refpurpose"> — Getting parts of a GDK drawable's image data into a pixbuf.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Utilities.html">Utilities</a></span><span class="refpurpose"> — Utility and miscellaneous convenience functions.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Animations.html">Animations</a></span><span class="refpurpose"> — Animated images.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="GdkPixbufLoader.html">GdkPixbufLoader</a></span><span class="refpurpose"> — Application-driven progressive image loading.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Module-Interface.html">Module Interface</a></span><span class="refpurpose"> — Extending GdkPixBuf</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html">gdk-pixbuf Xlib initialization</a></span><span class="refpurpose"> — Initializing the gdk-pixbuf Xlib library.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Xlib-Rendering.html">Xlib Rendering</a></span><span class="refpurpose"> — Rendering a pixbuf to an X drawable.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-X-Drawables-to-Pixbufs.html">X Drawables to Pixbufs</a></span><span class="refpurpose"> — Getting parts of an X drawable's image data into a pixbuf.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-XlibRGB.html">XlibRGB</a></span><span class="refpurpose"> — Rendering RGB buffers to X drawables.</span> +</dt> +</dl></dd> +<dt><span class="reference"><a href="rn02.html">II. Tools Reference</a></span></dt> +<dd><dl> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-csource.html">gdk-pixbuf-csource</a></span><span class="refpurpose"> — C code generation utility for GdkPixbuf images</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-query-loaders.html">gdk-pixbuf-query-loaders</a></span><span class="refpurpose"> — GdkPixbuf loader registration utility</span> +</dt> +</dl></dd> +<dt><span class="index"><a href="api-index-full.html">Index of all symbols</a></span></dt> +<dt><span class="index"><a href="api-index-deprecated.html">Index of deprecated symbols</a></span></dt> +<dt><span class="index"><a href="api-index-2-2.html">Index of new symbols in 2.2</a></span></dt> +<dt><span class="index"><a href="api-index-2-4.html">Index of new symbols in 2.4</a></span></dt> +<dt><span class="index"><a href="api-index-2-6.html">Index of new symbols in 2.6</a></span></dt> +<dt><span class="index"><a href="api-index-2-8.html">Index of new symbols in 2.8</a></span></dt> +<dt><span class="index"><a href="api-index-2-12.html">Index of new symbols in 2.12</a></span></dt> +<dt><span class="index"><a href="api-index-2-14.html">Index of new symbols in 2.14</a></span></dt> +<dt><span class="index"><a href="api-index-2-26.html">Index of new symbols in 2.26</a></span></dt> +<dt><span class="appendix"><a href="license.html">A. License</a></span></dt> +<dt><span class="glossary"><a href="annotation-glossary.html">Annotation Glossary</a></span></dt> +</dl></div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/index.sgml b/docs/reference/gdk-pixbuf/html/index.sgml new file mode 100644 index 0000000..a072467 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/index.sgml @@ -0,0 +1,316 @@ +<ONLINE href="http://library.gnome.org/devel/gdk-pixbuf/unstable/"> +<ANCHOR id="gdk-pixbuf-Versioning" href="gdk-pixbuf/gdk-pixbuf-Versioning.html"> +<ANCHOR id="gdk-pixbuf-Versioning.synopsis" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#gdk-pixbuf-Versioning.synopsis"> +<ANCHOR id="gdk-pixbuf-Versioning.description" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#gdk-pixbuf-Versioning.description"> +<ANCHOR id="gdk-pixbuf-Versioning.details" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#gdk-pixbuf-Versioning.details"> +<ANCHOR id="gdk-pixbuf-version" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#gdk-pixbuf-version"> +<ANCHOR id="gdk-pixbuf-major-version" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#gdk-pixbuf-major-version"> +<ANCHOR id="gdk-pixbuf-minor-version" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#gdk-pixbuf-minor-version"> +<ANCHOR id="gdk-pixbuf-micro-version" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#gdk-pixbuf-micro-version"> +<ANCHOR id="GDK-PIXBUF-VERSION:CAPS" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#GDK-PIXBUF-VERSION:CAPS"> +<ANCHOR id="GDK-PIXBUF-MAJOR:CAPS" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#GDK-PIXBUF-MAJOR:CAPS"> +<ANCHOR id="GDK-PIXBUF-MINOR:CAPS" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#GDK-PIXBUF-MINOR:CAPS"> +<ANCHOR id="GDK-PIXBUF-MICRO:CAPS" href="gdk-pixbuf/gdk-pixbuf-Versioning.html#GDK-PIXBUF-MICRO:CAPS"> +<ANCHOR id="gdk-pixbuf-The-GdkPixbuf-Structure" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html"> +<ANCHOR id="gdk-pixbuf-The-GdkPixbuf-Structure.synopsis" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-The-GdkPixbuf-Structure.synopsis"> +<ANCHOR id="GdkPixbuf" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"> +<ANCHOR id="gdk-pixbuf-The-GdkPixbuf-Structure.object-hierarchy" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-The-GdkPixbuf-Structure.object-hierarchy"> +<ANCHOR id="gdk-pixbuf-The-GdkPixbuf-Structure.implemented-interfaces" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-The-GdkPixbuf-Structure.implemented-interfaces"> +<ANCHOR id="gdk-pixbuf-The-GdkPixbuf-Structure.properties" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-The-GdkPixbuf-Structure.properties"> +<ANCHOR id="gdk-pixbuf-The-GdkPixbuf-Structure.description" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-The-GdkPixbuf-Structure.description"> +<ANCHOR id="gdk-pixbuf-The-GdkPixbuf-Structure.details" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-The-GdkPixbuf-Structure.details"> +<ANCHOR id="GdkPixbufError" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufError"> +<ANCHOR id="GDK-PIXBUF-ERROR-CORRUPT-IMAGE:CAPS" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-CORRUPT-IMAGE:CAPS"> +<ANCHOR id="GDK-PIXBUF-ERROR-INSUFFICIENT-MEMORY:CAPS" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-INSUFFICIENT-MEMORY:CAPS"> +<ANCHOR id="GDK-PIXBUF-ERROR-BAD-OPTION:CAPS" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-BAD-OPTION:CAPS"> +<ANCHOR id="GDK-PIXBUF-ERROR-UNKNOWN-TYPE:CAPS" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-UNKNOWN-TYPE:CAPS"> +<ANCHOR id="GDK-PIXBUF-ERROR-UNSUPPORTED-OPERATION:CAPS" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-UNSUPPORTED-OPERATION:CAPS"> +<ANCHOR id="GDK-PIXBUF-ERROR-FAILED:CAPS" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR-FAILED:CAPS"> +<ANCHOR id="GDK-PIXBUF-ERROR:CAPS" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS"> +<ANCHOR id="GdkColorspace" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkColorspace"> +<ANCHOR id="GDK-COLORSPACE-RGB:CAPS" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-COLORSPACE-RGB:CAPS"> +<ANCHOR id="GdkPixbufAlphaMode" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbufAlphaMode"> +<ANCHOR id="GDK-PIXBUF-ALPHA-BILEVEL:CAPS" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ALPHA-BILEVEL:CAPS"> +<ANCHOR id="GDK-PIXBUF-ALPHA-FULL:CAPS" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ALPHA-FULL:CAPS"> +<ANCHOR id="GdkPixbuf-struct" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"> +<ANCHOR id="gdk-pixbuf-get-colorspace" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-colorspace"> +<ANCHOR id="gdk-pixbuf-get-n-channels" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-n-channels"> +<ANCHOR id="gdk-pixbuf-get-has-alpha" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-has-alpha"> +<ANCHOR id="gdk-pixbuf-get-bits-per-sample" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-bits-per-sample"> +<ANCHOR id="gdk-pixbuf-get-pixels" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-pixels"> +<ANCHOR id="gdk-pixbuf-get-pixels-with-length" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-pixels-with-length"> +<ANCHOR id="gdk-pixbuf-get-width" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-width"> +<ANCHOR id="gdk-pixbuf-get-height" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-height"> +<ANCHOR id="gdk-pixbuf-get-rowstride" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-rowstride"> +<ANCHOR id="gdk-pixbuf-get-byte-length" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-byte-length"> +<ANCHOR id="gdk-pixbuf-get-option" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-option"> +<ANCHOR id="gdk-pixbuf-The-GdkPixbuf-Structure.property-details" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-The-GdkPixbuf-Structure.property-details"> +<ANCHOR id="GdkPixbuf--bits-per-sample" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--bits-per-sample"> +<ANCHOR id="GdkPixbuf--colorspace" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--colorspace"> +<ANCHOR id="GdkPixbuf--has-alpha" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--has-alpha"> +<ANCHOR id="GdkPixbuf--height" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--height"> +<ANCHOR id="GdkPixbuf--n-channels" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--n-channels"> +<ANCHOR id="GdkPixbuf--pixels" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--pixels"> +<ANCHOR id="GdkPixbuf--rowstride" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--rowstride"> +<ANCHOR id="GdkPixbuf--width" href="gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf--width"> +<ANCHOR id="gdk-pixbuf-Reference-Counting-and-Memory-Mangement" href="gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html"> +<ANCHOR id="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.synopsis" href="gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-Reference-Counting-and-Memory-Mangement.synopsis"> +<ANCHOR id="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.description" href="gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-Reference-Counting-and-Memory-Mangement.description"> +<ANCHOR id="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.details" href="gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-Reference-Counting-and-Memory-Mangement.details"> +<ANCHOR id="gdk-pixbuf-ref" href="gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-ref"> +<ANCHOR id="gdk-pixbuf-unref" href="gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref"> +<ANCHOR id="GdkPixbufDestroyNotify" href="gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify"> +<ANCHOR id="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.see-also" href="gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-Reference-Counting-and-Memory-Mangement.see-also"> +<ANCHOR id="gdk-pixbuf-File-Loading" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html"> +<ANCHOR id="gdk-pixbuf-File-Loading.synopsis" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-File-Loading.synopsis"> +<ANCHOR id="gdk-pixbuf-File-Loading.description" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-File-Loading.description"> +<ANCHOR id="gdk-pixbuf-File-Loading.details" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-File-Loading.details"> +<ANCHOR id="gdk-pixbuf-new-from-file" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file"> +<ANCHOR id="gdk-pixbuf-new-from-file-at-size" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-size"> +<ANCHOR id="gdk-pixbuf-new-from-file-at-scale" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-scale"> +<ANCHOR id="gdk-pixbuf-get-file-info" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-get-file-info"> +<ANCHOR id="gdk-pixbuf-new-from-resource" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-resource"> +<ANCHOR id="gdk-pixbuf-new-from-resource-at-scale" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-resource-at-scale"> +<ANCHOR id="gdk-pixbuf-new-from-stream" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream"> +<ANCHOR id="gdk-pixbuf-new-from-stream-async" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-async"> +<ANCHOR id="gdk-pixbuf-new-from-stream-finish" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-finish"> +<ANCHOR id="gdk-pixbuf-new-from-stream-at-scale" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale"> +<ANCHOR id="gdk-pixbuf-new-from-stream-at-scale-async" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale-async"> +<ANCHOR id="gdk-pixbuf-File-Loading.see-also" href="gdk-pixbuf/gdk-pixbuf-File-Loading.html#gdk-pixbuf-File-Loading.see-also"> +<ANCHOR id="gdk-pixbuf-File-saving" href="gdk-pixbuf/gdk-pixbuf-File-saving.html"> +<ANCHOR id="gdk-pixbuf-File-saving.synopsis" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-File-saving.synopsis"> +<ANCHOR id="gdk-pixbuf-File-saving.description" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-File-saving.description"> +<ANCHOR id="gdk-pixbuf-File-saving.details" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-File-saving.details"> +<ANCHOR id="gdk-pixbuf-savev" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-savev"> +<ANCHOR id="gdk-pixbuf-save" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-save"> +<ANCHOR id="GdkPixbufSaveFunc" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc"> +<ANCHOR id="gdk-pixbuf-save-to-callback" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callback"> +<ANCHOR id="gdk-pixbuf-save-to-callbackv" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-callbackv"> +<ANCHOR id="gdk-pixbuf-save-to-buffer" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-buffer"> +<ANCHOR id="gdk-pixbuf-save-to-bufferv" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-bufferv"> +<ANCHOR id="gdk-pixbuf-save-to-stream" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream"> +<ANCHOR id="gdk-pixbuf-save-to-stream-async" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream-async"> +<ANCHOR id="gdk-pixbuf-save-to-stream-finish" href="gdk-pixbuf/gdk-pixbuf-File-saving.html#gdk-pixbuf-save-to-stream-finish"> +<ANCHOR id="gdk-pixbuf-Image-Data-in-Memory" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html"> +<ANCHOR id="gdk-pixbuf-Image-Data-in-Memory.synopsis" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-Image-Data-in-Memory.synopsis"> +<ANCHOR id="gdk-pixbuf-Image-Data-in-Memory.description" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-Image-Data-in-Memory.description"> +<ANCHOR id="gdk-pixbuf-Image-Data-in-Memory.details" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-Image-Data-in-Memory.details"> +<ANCHOR id="gdk-pixbuf-new" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new"> +<ANCHOR id="gdk-pixbuf-new-from-data" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data"> +<ANCHOR id="gdk-pixbuf-new-from-xpm-data" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-xpm-data"> +<ANCHOR id="gdk-pixbuf-new-from-inline" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-inline"> +<ANCHOR id="gdk-pixbuf-new-subpixbuf" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-subpixbuf"> +<ANCHOR id="gdk-pixbuf-copy" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-copy"> +<ANCHOR id="gdk-pixbuf-Image-Data-in-Memory.see-also" href="gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-Image-Data-in-Memory.see-also"> +<ANCHOR id="gdk-pixbuf-Inline-data" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html"> +<ANCHOR id="gdk-pixbuf-Inline-data.synopsis" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#gdk-pixbuf-Inline-data.synopsis"> +<ANCHOR id="gdk-pixbuf-Inline-data.description" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#gdk-pixbuf-Inline-data.description"> +<ANCHOR id="gdk-pixbuf-Inline-data.details" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#gdk-pixbuf-Inline-data.details"> +<ANCHOR id="GdkPixdata" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GdkPixdata"> +<ANCHOR id="GdkPixdataType" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GdkPixdataType"> +<ANCHOR id="GDK-PIXDATA-COLOR-TYPE-RGB:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-COLOR-TYPE-RGB:CAPS"> +<ANCHOR id="GDK-PIXDATA-COLOR-TYPE-RGBA:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-COLOR-TYPE-RGBA:CAPS"> +<ANCHOR id="GDK-PIXDATA-COLOR-TYPE-MASK:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-COLOR-TYPE-MASK:CAPS"> +<ANCHOR id="GDK-PIXDATA-SAMPLE-WIDTH-8:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-SAMPLE-WIDTH-8:CAPS"> +<ANCHOR id="GDK-PIXDATA-SAMPLE-WIDTH-MASK:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-SAMPLE-WIDTH-MASK:CAPS"> +<ANCHOR id="GDK-PIXDATA-ENCODING-RAW:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-ENCODING-RAW:CAPS"> +<ANCHOR id="GDK-PIXDATA-ENCODING-RLE:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-ENCODING-RLE:CAPS"> +<ANCHOR id="GDK-PIXDATA-ENCODING-MASK:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-ENCODING-MASK:CAPS"> +<ANCHOR id="GdkPixdataDumpType" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GdkPixdataDumpType"> +<ANCHOR id="GDK-PIXDATA-DUMP-PIXDATA-STREAM:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-PIXDATA-STREAM:CAPS"> +<ANCHOR id="GDK-PIXDATA-DUMP-PIXDATA-STRUCT:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-PIXDATA-STRUCT:CAPS"> +<ANCHOR id="GDK-PIXDATA-DUMP-MACROS:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-MACROS:CAPS"> +<ANCHOR id="GDK-PIXDATA-DUMP-GTYPES:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-GTYPES:CAPS"> +<ANCHOR id="GDK-PIXDATA-DUMP-CTYPES:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-CTYPES:CAPS"> +<ANCHOR id="GDK-PIXDATA-DUMP-STATIC:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-STATIC:CAPS"> +<ANCHOR id="GDK-PIXDATA-DUMP-CONST:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-CONST:CAPS"> +<ANCHOR id="GDK-PIXDATA-DUMP-RLE-DECODER:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-DUMP-RLE-DECODER:CAPS"> +<ANCHOR id="GDK-PIXBUF-MAGIC-NUMBER:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXBUF-MAGIC-NUMBER:CAPS"> +<ANCHOR id="GDK-PIXDATA-HEADER-LENGTH:CAPS" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#GDK-PIXDATA-HEADER-LENGTH:CAPS"> +<ANCHOR id="gdk-pixdata-from-pixbuf" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#gdk-pixdata-from-pixbuf"> +<ANCHOR id="gdk-pixbuf-from-pixdata" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#gdk-pixbuf-from-pixdata"> +<ANCHOR id="gdk-pixdata-serialize" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#gdk-pixdata-serialize"> +<ANCHOR id="gdk-pixdata-deserialize" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#gdk-pixdata-deserialize"> +<ANCHOR id="gdk-pixdata-to-csource" href="gdk-pixbuf/gdk-pixbuf-Inline-data.html#gdk-pixdata-to-csource"> +<ANCHOR id="gdk-pixbuf-Scaling" href="gdk-pixbuf/gdk-pixbuf-Scaling.html"> +<ANCHOR id="gdk-pixbuf-Scaling.synopsis" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-Scaling.synopsis"> +<ANCHOR id="gdk-pixbuf-Scaling.description" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-Scaling.description"> +<ANCHOR id="gdk-pixbuf-Scaling.details" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-Scaling.details"> +<ANCHOR id="GdkInterpType" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#GdkInterpType"> +<ANCHOR id="GDK-INTERP-NEAREST:CAPS" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#GDK-INTERP-NEAREST:CAPS"> +<ANCHOR id="GDK-INTERP-TILES:CAPS" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#GDK-INTERP-TILES:CAPS"> +<ANCHOR id="GDK-INTERP-BILINEAR:CAPS" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#GDK-INTERP-BILINEAR:CAPS"> +<ANCHOR id="GDK-INTERP-HYPER:CAPS" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#GDK-INTERP-HYPER:CAPS"> +<ANCHOR id="gdk-pixbuf-scale-simple" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple"> +<ANCHOR id="gdk-pixbuf-scale" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-scale"> +<ANCHOR id="gdk-pixbuf-composite-color-simple" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple"> +<ANCHOR id="gdk-pixbuf-composite" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-composite"> +<ANCHOR id="gdk-pixbuf-composite-color" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color"> +<ANCHOR id="GdkPixbufRotation" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#GdkPixbufRotation"> +<ANCHOR id="GDK-PIXBUF-ROTATE-NONE:CAPS" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#GDK-PIXBUF-ROTATE-NONE:CAPS"> +<ANCHOR id="GDK-PIXBUF-ROTATE-COUNTERCLOCKWISE:CAPS" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#GDK-PIXBUF-ROTATE-COUNTERCLOCKWISE:CAPS"> +<ANCHOR id="GDK-PIXBUF-ROTATE-UPSIDEDOWN:CAPS" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#GDK-PIXBUF-ROTATE-UPSIDEDOWN:CAPS"> +<ANCHOR id="GDK-PIXBUF-ROTATE-CLOCKWISE:CAPS" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#GDK-PIXBUF-ROTATE-CLOCKWISE:CAPS"> +<ANCHOR id="gdk-pixbuf-rotate-simple" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-rotate-simple"> +<ANCHOR id="gdk-pixbuf-flip" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-flip"> +<ANCHOR id="gdk-pixbuf-Scaling.see-also" href="gdk-pixbuf/gdk-pixbuf-Scaling.html#gdk-pixbuf-Scaling.see-also"> +<ANCHOR id="gdk-pixbuf-gdk-pixbuf-rendering" href="gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-rendering.html"> +<ANCHOR id="gdk-pixbuf-gdk-pixbuf-from-drawables" href="gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-from-drawables.html"> +<ANCHOR id="gdk-pixbuf-Utilities" href="gdk-pixbuf/gdk-pixbuf-Utilities.html"> +<ANCHOR id="gdk-pixbuf-Utilities.synopsis" href="gdk-pixbuf/gdk-pixbuf-Utilities.html#gdk-pixbuf-Utilities.synopsis"> +<ANCHOR id="gdk-pixbuf-Utilities.description" href="gdk-pixbuf/gdk-pixbuf-Utilities.html#gdk-pixbuf-Utilities.description"> +<ANCHOR id="gdk-pixbuf-Utilities.details" href="gdk-pixbuf/gdk-pixbuf-Utilities.html#gdk-pixbuf-Utilities.details"> +<ANCHOR id="gdk-pixbuf-add-alpha" href="gdk-pixbuf/gdk-pixbuf-Utilities.html#gdk-pixbuf-add-alpha"> +<ANCHOR id="gdk-pixbuf-copy-area" href="gdk-pixbuf/gdk-pixbuf-Utilities.html#gdk-pixbuf-copy-area"> +<ANCHOR id="gdk-pixbuf-saturate-and-pixelate" href="gdk-pixbuf/gdk-pixbuf-Utilities.html#gdk-pixbuf-saturate-and-pixelate"> +<ANCHOR id="gdk-pixbuf-apply-embedded-orientation" href="gdk-pixbuf/gdk-pixbuf-Utilities.html#gdk-pixbuf-apply-embedded-orientation"> +<ANCHOR id="gdk-pixbuf-fill" href="gdk-pixbuf/gdk-pixbuf-Utilities.html#gdk-pixbuf-fill"> +<ANCHOR id="gdk-pixbuf-Utilities.see-also" href="gdk-pixbuf/gdk-pixbuf-Utilities.html#gdk-pixbuf-Utilities.see-also"> +<ANCHOR id="gdk-pixbuf-Animations" href="gdk-pixbuf/gdk-pixbuf-Animations.html"> +<ANCHOR id="gdk-pixbuf-Animations.synopsis" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-Animations.synopsis"> +<ANCHOR id="GdkPixbufAnimation" href="gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation"> +<ANCHOR id="GdkPixbufAnimationIter" href="gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"> +<ANCHOR id="GdkPixbufSimpleAnim" href="gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"> +<ANCHOR id="gdk-pixbuf-Animations.object-hierarchy" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-Animations.object-hierarchy"> +<ANCHOR id="gdk-pixbuf-Animations.properties" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-Animations.properties"> +<ANCHOR id="gdk-pixbuf-Animations.description" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-Animations.description"> +<ANCHOR id="gdk-pixbuf-Animations.details" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-Animations.details"> +<ANCHOR id="GdkPixbufAnimation-struct" href="gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimation-struct"> +<ANCHOR id="GdkPixbufAnimationIter-struct" href="gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufAnimationIter-struct"> +<ANCHOR id="gdk-pixbuf-animation-new-from-file" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file"> +<ANCHOR id="gdk-pixbuf-animation-ref" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-ref"> +<ANCHOR id="gdk-pixbuf-animation-unref" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-unref"> +<ANCHOR id="gdk-pixbuf-animation-get-width" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-width"> +<ANCHOR id="gdk-pixbuf-animation-get-height" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-height"> +<ANCHOR id="gdk-pixbuf-animation-get-iter" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-iter"> +<ANCHOR id="gdk-pixbuf-animation-is-static-image" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-is-static-image"> +<ANCHOR id="gdk-pixbuf-animation-get-static-image" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-static-image"> +<ANCHOR id="gdk-pixbuf-animation-iter-advance" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-advance"> +<ANCHOR id="gdk-pixbuf-animation-iter-get-delay-time" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-delay-time"> +<ANCHOR id="gdk-pixbuf-animation-iter-on-currently-loading-frame" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-on-currently-loading-frame"> +<ANCHOR id="gdk-pixbuf-animation-iter-get-pixbuf" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf"> +<ANCHOR id="GdkPixbufSimpleAnim-struct" href="gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim-struct"> +<ANCHOR id="gdk-pixbuf-simple-anim-new" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-new"> +<ANCHOR id="gdk-pixbuf-simple-anim-add-frame" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-add-frame"> +<ANCHOR id="gdk-pixbuf-simple-anim-set-loop" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-set-loop"> +<ANCHOR id="gdk-pixbuf-simple-anim-get-loop" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-get-loop"> +<ANCHOR id="gdk-pixbuf-Animations.property-details" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-Animations.property-details"> +<ANCHOR id="GdkPixbufSimpleAnim--loop" href="gdk-pixbuf/gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim--loop"> +<ANCHOR id="gdk-pixbuf-Animations.see-also" href="gdk-pixbuf/gdk-pixbuf-Animations.html#gdk-pixbuf-Animations.see-also"> +<ANCHOR id="GdkPixbufLoader" href="gdk-pixbuf/GdkPixbufLoader.html"> +<ANCHOR id="GdkPixbufLoader.synopsis" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader.synopsis"> +<ANCHOR id="GdkPixbufLoader.object-hierarchy" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader.object-hierarchy"> +<ANCHOR id="GdkPixbufLoader.signals" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader.signals"> +<ANCHOR id="GdkPixbufLoader.description" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader.description"> +<ANCHOR id="GdkPixbufLoader.details" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader.details"> +<ANCHOR id="GdkPixbufLoader-struct" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader-struct"> +<ANCHOR id="gdk-pixbuf-loader-new" href="gdk-pixbuf/GdkPixbufLoader.html#gdk-pixbuf-loader-new"> +<ANCHOR id="gdk-pixbuf-loader-new-with-type" href="gdk-pixbuf/GdkPixbufLoader.html#gdk-pixbuf-loader-new-with-type"> +<ANCHOR id="gdk-pixbuf-loader-new-with-mime-type" href="gdk-pixbuf/GdkPixbufLoader.html#gdk-pixbuf-loader-new-with-mime-type"> +<ANCHOR id="gdk-pixbuf-loader-get-format" href="gdk-pixbuf/GdkPixbufLoader.html#gdk-pixbuf-loader-get-format"> +<ANCHOR id="gdk-pixbuf-loader-write" href="gdk-pixbuf/GdkPixbufLoader.html#gdk-pixbuf-loader-write"> +<ANCHOR id="gdk-pixbuf-loader-set-size" href="gdk-pixbuf/GdkPixbufLoader.html#gdk-pixbuf-loader-set-size"> +<ANCHOR id="gdk-pixbuf-loader-get-pixbuf" href="gdk-pixbuf/GdkPixbufLoader.html#gdk-pixbuf-loader-get-pixbuf"> +<ANCHOR id="gdk-pixbuf-loader-get-animation" href="gdk-pixbuf/GdkPixbufLoader.html#gdk-pixbuf-loader-get-animation"> +<ANCHOR id="gdk-pixbuf-loader-close" href="gdk-pixbuf/GdkPixbufLoader.html#gdk-pixbuf-loader-close"> +<ANCHOR id="GdkPixbufLoader.signal-details" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader.signal-details"> +<ANCHOR id="GdkPixbufLoader-area-prepared" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader-area-prepared"> +<ANCHOR id="GdkPixbufLoader-area-updated" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader-area-updated"> +<ANCHOR id="GdkPixbufLoader-closed" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader-closed"> +<ANCHOR id="GdkPixbufLoader-size-prepared" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader-size-prepared"> +<ANCHOR id="GdkPixbufLoader.see-also" href="gdk-pixbuf/GdkPixbufLoader.html#GdkPixbufLoader.see-also"> +<ANCHOR id="gdk-pixbuf-Module-Interface" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html"> +<ANCHOR id="gdk-pixbuf-Module-Interface.synopsis" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-Module-Interface.synopsis"> +<ANCHOR id="gdk-pixbuf-Module-Interface.description" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-Module-Interface.description"> +<ANCHOR id="gdk-pixbuf-Module-Interface.details" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-Module-Interface.details"> +<ANCHOR id="gdk-pixbuf-set-option" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-set-option"> +<ANCHOR id="gdk-pixbuf-get-formats" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-get-formats"> +<ANCHOR id="gdk-pixbuf-format-copy" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-copy"> +<ANCHOR id="gdk-pixbuf-format-free" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-free"> +<ANCHOR id="gdk-pixbuf-format-get-name" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-name"> +<ANCHOR id="gdk-pixbuf-format-get-description" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-description"> +<ANCHOR id="gdk-pixbuf-format-get-mime-types" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-mime-types"> +<ANCHOR id="gdk-pixbuf-format-get-extensions" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-extensions"> +<ANCHOR id="gdk-pixbuf-format-is-writable" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-writable"> +<ANCHOR id="gdk-pixbuf-format-is-scalable" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-scalable"> +<ANCHOR id="gdk-pixbuf-format-is-disabled" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-disabled"> +<ANCHOR id="gdk-pixbuf-format-set-disabled" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-set-disabled"> +<ANCHOR id="gdk-pixbuf-format-get-license" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-license"> +<ANCHOR id="GdkPixbufFormat" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufFormat"> +<ANCHOR id="GdkPixbufFormatFlags" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufFormatFlags"> +<ANCHOR id="GDK-PIXBUF-FORMAT-WRITABLE:CAPS" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GDK-PIXBUF-FORMAT-WRITABLE:CAPS"> +<ANCHOR id="GDK-PIXBUF-FORMAT-SCALABLE:CAPS" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GDK-PIXBUF-FORMAT-SCALABLE:CAPS"> +<ANCHOR id="GDK-PIXBUF-FORMAT-THREADSAFE:CAPS" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GDK-PIXBUF-FORMAT-THREADSAFE:CAPS"> +<ANCHOR id="GdkPixbufModulePattern" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern"> +<ANCHOR id="GdkPixbufModuleFillVtableFunc" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc"> +<ANCHOR id="GdkPixbufModuleFillInfoFunc" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillInfoFunc"> +<ANCHOR id="GdkPixbufModuleSizeFunc" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufModuleSizeFunc"> +<ANCHOR id="GdkPixbufModulePreparedFunc" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufModulePreparedFunc"> +<ANCHOR id="GdkPixbufModuleUpdatedFunc" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufModuleUpdatedFunc"> +<ANCHOR id="GdkPixbufModule" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufModule"> +<ANCHOR id="GdkPixbufAnimationClass" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationClass"> +<ANCHOR id="GdkPixbufAnimationIterClass" href="gdk-pixbuf/gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationIterClass"> +<ANCHOR id="gdk-pixbuf-gdk-pixbuf-Xlib-initialization" href="gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html"> +<ANCHOR id="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.synopsis" href="gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-gdk-pixbuf-Xlib-initialization.synopsis"> +<ANCHOR id="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.description" href="gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-gdk-pixbuf-Xlib-initialization.description"> +<ANCHOR id="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.details" href="gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-gdk-pixbuf-Xlib-initialization.details"> +<ANCHOR id="gdk-pixbuf-xlib-init" href="gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-xlib-init"> +<ANCHOR id="gdk-pixbuf-xlib-init-with-depth" href="gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-xlib-init-with-depth"> +<ANCHOR id="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.see-also" href="gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html#gdk-pixbuf-gdk-pixbuf-Xlib-initialization.see-also"> +<ANCHOR id="gdk-pixbuf-Xlib-Rendering" href="gdk-pixbuf/gdk-pixbuf-Xlib-Rendering.html"> +<ANCHOR id="gdk-pixbuf-Xlib-Rendering.synopsis" href="gdk-pixbuf/gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-Xlib-Rendering.synopsis"> +<ANCHOR id="gdk-pixbuf-Xlib-Rendering.description" href="gdk-pixbuf/gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-Xlib-Rendering.description"> +<ANCHOR id="gdk-pixbuf-Xlib-Rendering.details" href="gdk-pixbuf/gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-Xlib-Rendering.details"> +<ANCHOR id="gdk-pixbuf-xlib-render-threshold-alpha" href="gdk-pixbuf/gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-threshold-alpha"> +<ANCHOR id="gdk-pixbuf-xlib-render-to-drawable" href="gdk-pixbuf/gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable"> +<ANCHOR id="gdk-pixbuf-xlib-render-to-drawable-alpha" href="gdk-pixbuf/gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-to-drawable-alpha"> +<ANCHOR id="gdk-pixbuf-xlib-render-pixmap-and-mask" href="gdk-pixbuf/gdk-pixbuf-Xlib-Rendering.html#gdk-pixbuf-xlib-render-pixmap-and-mask"> +<ANCHOR id="gdk-pixbuf-X-Drawables-to-Pixbufs" href="gdk-pixbuf/gdk-pixbuf-X-Drawables-to-Pixbufs.html"> +<ANCHOR id="gdk-pixbuf-X-Drawables-to-Pixbufs.synopsis" href="gdk-pixbuf/gdk-pixbuf-X-Drawables-to-Pixbufs.html#gdk-pixbuf-X-Drawables-to-Pixbufs.synopsis"> +<ANCHOR id="gdk-pixbuf-X-Drawables-to-Pixbufs.description" href="gdk-pixbuf/gdk-pixbuf-X-Drawables-to-Pixbufs.html#gdk-pixbuf-X-Drawables-to-Pixbufs.description"> +<ANCHOR id="gdk-pixbuf-X-Drawables-to-Pixbufs.details" href="gdk-pixbuf/gdk-pixbuf-X-Drawables-to-Pixbufs.html#gdk-pixbuf-X-Drawables-to-Pixbufs.details"> +<ANCHOR id="gdk-pixbuf-xlib-get-from-drawable" href="gdk-pixbuf/gdk-pixbuf-X-Drawables-to-Pixbufs.html#gdk-pixbuf-xlib-get-from-drawable"> +<ANCHOR id="gdk-pixbuf-XlibRGB" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html"> +<ANCHOR id="gdk-pixbuf-XlibRGB.synopsis" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#gdk-pixbuf-XlibRGB.synopsis"> +<ANCHOR id="gdk-pixbuf-XlibRGB.description" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#gdk-pixbuf-XlibRGB.description"> +<ANCHOR id="gdk-pixbuf-XlibRGB.details" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#gdk-pixbuf-XlibRGB.details"> +<ANCHOR id="XlibRgbCmap" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#XlibRgbCmap"> +<ANCHOR id="XlibRgbDither" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#XlibRgbDither"> +<ANCHOR id="XLIB-RGB-DITHER-NONE:CAPS" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#XLIB-RGB-DITHER-NONE:CAPS"> +<ANCHOR id="XLIB-RGB-DITHER-NORMAL:CAPS" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#XLIB-RGB-DITHER-NORMAL:CAPS"> +<ANCHOR id="XLIB-RGB-DITHER-MAX:CAPS" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#XLIB-RGB-DITHER-MAX:CAPS"> +<ANCHOR id="xlib-rgb-init" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-init"> +<ANCHOR id="xlib-rgb-init-with-depth" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-init-with-depth"> +<ANCHOR id="xlib-rgb-xpixel-from-rgb" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-xpixel-from-rgb"> +<ANCHOR id="xlib-rgb-gc-set-foreground" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-gc-set-foreground"> +<ANCHOR id="xlib-rgb-gc-set-background" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-gc-set-background"> +<ANCHOR id="xlib-draw-rgb-image" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image"> +<ANCHOR id="xlib-draw-rgb-image-dithalign" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-image-dithalign"> +<ANCHOR id="xlib-draw-rgb-32-image" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-draw-rgb-32-image"> +<ANCHOR id="xlib-draw-gray-image" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-draw-gray-image"> +<ANCHOR id="xlib-rgb-cmap-new" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-cmap-new"> +<ANCHOR id="xlib-rgb-cmap-free" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-cmap-free"> +<ANCHOR id="xlib-draw-indexed-image" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-draw-indexed-image"> +<ANCHOR id="xlib-rgb-ditherable" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-ditherable"> +<ANCHOR id="xlib-rgb-set-verbose" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-set-verbose"> +<ANCHOR id="xlib-rgb-set-install" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-set-install"> +<ANCHOR id="xlib-rgb-set-min-colors" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-set-min-colors"> +<ANCHOR id="xlib-rgb-get-cmap" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-get-cmap"> +<ANCHOR id="xlib-rgb-get-visual" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-get-visual"> +<ANCHOR id="xlib-rgb-get-visual-info" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-get-visual-info"> +<ANCHOR id="xlib-rgb-get-depth" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-get-depth"> +<ANCHOR id="xlib-rgb-get-display" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-get-display"> +<ANCHOR id="xlib-rgb-get-screen" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#xlib-rgb-get-screen"> +<ANCHOR id="gdk-pixbuf-XlibRGB.see-also" href="gdk-pixbuf/gdk-pixbuf-XlibRGB.html#gdk-pixbuf-XlibRGB.see-also"> +<ANCHOR id="gdk-pixbuf-csource" href="gdk-pixbuf/gdk-pixbuf-csource.html"> +<ANCHOR id="gdk-pixbuf-query-loaders" href="gdk-pixbuf/gdk-pixbuf-query-loaders.html"> +<ANCHOR id="annotation-glossterm-out" href="gdk-pixbuf/annotation-glossary.html#annotation-glossterm-out"> +<ANCHOR id="annotation-glossterm-scope async" href="gdk-pixbuf/annotation-glossary.html#annotation-glossterm-scope async"> +<ANCHOR id="annotation-glossterm-allow-none" href="gdk-pixbuf/annotation-glossary.html#annotation-glossterm-allow-none"> +<ANCHOR id="annotation-glossterm-closure" href="gdk-pixbuf/annotation-glossary.html#annotation-glossterm-closure"> +<ANCHOR id="annotation-glossterm-transfer none" href="gdk-pixbuf/annotation-glossary.html#annotation-glossterm-transfer none"> +<ANCHOR id="annotation-glossterm-array" href="gdk-pixbuf/annotation-glossary.html#annotation-glossterm-array"> +<ANCHOR id="annotation-glossterm-element-type" href="gdk-pixbuf/annotation-glossary.html#annotation-glossterm-element-type"> +<ANCHOR id="annotation-glossterm-transfer container" href="gdk-pixbuf/annotation-glossary.html#annotation-glossterm-transfer container"> +<ANCHOR id="annotation-glossterm-transfer full" href="gdk-pixbuf/annotation-glossary.html#annotation-glossterm-transfer full"> +<ANCHOR id="annotation-glossterm-scope call" href="gdk-pixbuf/annotation-glossary.html#annotation-glossterm-scope call"> diff --git a/docs/reference/gdk-pixbuf/html/left.png b/docs/reference/gdk-pixbuf/html/left.png Binary files differnew file mode 100644 index 0000000..2d05b3d --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/left.png diff --git a/docs/reference/gdk-pixbuf/html/license.html b/docs/reference/gdk-pixbuf/html/license.html new file mode 100644 index 0000000..a5b8ff7 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/license.html @@ -0,0 +1,59 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Appendix A. License</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="api-index-2-26.html" title="Index of new symbols in 2.26"> +<link rel="next" href="annotation-glossary.html" title="Annotation Glossary"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"> +<td><a accesskey="p" href="api-index-2-26.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="annotation-glossary.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr></table> +<div class="appendix"> +<div class="titlepage"><div><div><h1 class="title"> +<a name="license"></a>Appendix A. License</h1></div></div></div> +<p> + This library is free software; you can redistribute it and/or + modify it under the terms of the <em class="citetitle">GNU Library General + Public License</em> as published by the Free Software + Foundation; either version 2 of the License, or (at your option) + any later version. + </p> +<p> + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + <em class="citetitle">GNU Library General Public License</em> for + more details. + </p> +<p> + You may obtain a copy of the <em class="citetitle">GNU Library General + Public License</em> from the Free Software Foundation by + visiting <a class="ulink" href="http://www.fsf.org" target="_top">their Web + site</a> or by writing to: + + </p> +<div class="address"><p><br> + Free Software Foundation, Inc.<br> + <span class="street">59 Temple Place</span> - Suite 330<br> + <span class="city">Boston</span>, <span class="state">MA</span> <span class="postcode">02111-1307</span><br> + <span class="country">USA</span><br> + </p></div> +<p> + </p> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/right.png b/docs/reference/gdk-pixbuf/html/right.png Binary files differnew file mode 100644 index 0000000..92832e3 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/right.png diff --git a/docs/reference/gdk-pixbuf/html/rn01.html b/docs/reference/gdk-pixbuf/html/rn01.html new file mode 100644 index 0000000..9ad222b --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/rn01.html @@ -0,0 +1,101 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>API Reference</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="next" href="gdk-pixbuf-Versioning.html" title="Initialization and Versions"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"> +<td><a accesskey="p" href="index.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-Versioning.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr></table> +<div class="reference"> +<div class="titlepage"> +<div><div><h1 class="title"> +<a name="idp3140992"></a>API Reference</h1></div></div> +<hr> +</div> +<div class="partintro"> +<div></div> +<p> + This part presents the class and function reference for the + <span class="application">gdk-pixbuf</span> library. Classes are described together with + their methods; individual functions are grouped by functional + group. + </p> +<div class="toc"> +<p><b>Table of Contents</b></p> +<dl> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Versioning.html">Initialization and Versions</a></span><span class="refpurpose"> — Library version numbers.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-The-GdkPixbuf-Structure.html">The GdkPixbuf Structure</a></span><span class="refpurpose"> — Information that describes an image.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html">Reference Counting and Memory Mangement</a></span><span class="refpurpose"> — Functions for reference counting and memory management on pixbufs.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-File-Loading.html">File Loading</a></span><span class="refpurpose"> — Loading a pixbuf from a file.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-File-saving.html">File saving</a></span><span class="refpurpose"> — Saving a pixbuf to a file.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Image-Data-in-Memory.html">Image Data in Memory</a></span><span class="refpurpose"> — Creating a pixbuf from image data that is already in memory.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Inline-data.html">Inline data</a></span><span class="refpurpose"> — Functions for inlined pixbuf handling.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Scaling.html">Scaling</a></span><span class="refpurpose"> — Scaling pixbufs and scaling and compositing pixbufs</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-gdk-pixbuf-rendering.html">Rendering</a></span><span class="refpurpose"> — Rendering a pixbuf to a GDK drawable.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-gdk-pixbuf-from-drawables.html">Drawables to Pixbufs</a></span><span class="refpurpose"> — Getting parts of a GDK drawable's image data into a pixbuf.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Utilities.html">Utilities</a></span><span class="refpurpose"> — Utility and miscellaneous convenience functions.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Animations.html">Animations</a></span><span class="refpurpose"> — Animated images.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="GdkPixbufLoader.html">GdkPixbufLoader</a></span><span class="refpurpose"> — Application-driven progressive image loading.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Module-Interface.html">Module Interface</a></span><span class="refpurpose"> — Extending GdkPixBuf</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html">gdk-pixbuf Xlib initialization</a></span><span class="refpurpose"> — Initializing the gdk-pixbuf Xlib library.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-Xlib-Rendering.html">Xlib Rendering</a></span><span class="refpurpose"> — Rendering a pixbuf to an X drawable.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-X-Drawables-to-Pixbufs.html">X Drawables to Pixbufs</a></span><span class="refpurpose"> — Getting parts of an X drawable's image data into a pixbuf.</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-XlibRGB.html">XlibRGB</a></span><span class="refpurpose"> — Rendering RGB buffers to X drawables.</span> +</dt> +</dl> +</div> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/rn02.html b/docs/reference/gdk-pixbuf/html/rn02.html new file mode 100644 index 0000000..4e02c06 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/rn02.html @@ -0,0 +1,51 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Tools Reference</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.77.1"> +<link rel="home" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="up" href="index.html" title="GDK-PixBuf Reference Manual"> +<link rel="prev" href="gdk-pixbuf-XlibRGB.html" title="XlibRGB"> +<link rel="next" href="gdk-pixbuf-csource.html" title="gdk-pixbuf-csource"> +<meta name="generator" content="GTK-Doc V1.18 (XML mode)"> +<link rel="stylesheet" href="style.css" type="text/css"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> +<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"> +<td><a accesskey="p" href="gdk-pixbuf-XlibRGB.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> +<td> </td> +<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> +<th width="100%" align="center">GDK-PixBuf Reference Manual</th> +<td><a accesskey="n" href="gdk-pixbuf-csource.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> +</tr></table> +<div class="reference"> +<div class="titlepage"> +<div><div><h1 class="title"> +<a name="idp174272"></a>Tools Reference</h1></div></div> +<hr> +</div> +<div class="partintro"> +<div></div> +<p> + This part presents the tools which are shipped with the + <span class="application">gdk-pixbuf</span> library. + </p> +<div class="toc"> +<p><b>Table of Contents</b></p> +<dl> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-csource.html">gdk-pixbuf-csource</a></span><span class="refpurpose"> — C code generation utility for GdkPixbuf images</span> +</dt> +<dt> +<span class="refentrytitle"><a href="gdk-pixbuf-query-loaders.html">gdk-pixbuf-query-loaders</a></span><span class="refpurpose"> — GdkPixbuf loader registration utility</span> +</dt> +</dl> +</div> +</div> +</div> +<div class="footer"> +<hr> + Generated by GTK-Doc V1.18</div> +</body> +</html>
\ No newline at end of file diff --git a/docs/reference/gdk-pixbuf/html/style.css b/docs/reference/gdk-pixbuf/html/style.css new file mode 100644 index 0000000..d6f6c26 --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/style.css @@ -0,0 +1,266 @@ +.synopsis, .classsynopsis +{ + /* tango:aluminium 1/2 */ + background: #eeeeec; + border: solid 1px #d3d7cf; + padding: 0.5em; +} +.programlisting +{ + /* tango:sky blue 0/1 */ + background: #e6f3ff; + border: solid 1px #729fcf; + padding: 0.5em; +} +.variablelist +{ + padding: 4px; + margin-left: 3em; +} +.variablelist td:first-child +{ + vertical-align: top; +} + +@media screen { + sup a.footnote + { + position: relative; + top: 0em ! important; + + } + /* this is needed so that the local anchors are displayed below the naviagtion */ + div.footnote a[name], div.refnamediv a[name], div.refsect1 a[name], div.refsect2 a[name], div.index a[name], div.glossary a[name], div.sect1 a[name] + { + display: inline-block; + position: relative; + top:-5em; + } + /* this seems to be a bug in the xsl style sheets when generating indexes */ + div.index div.index + { + top: 0em; + } + /* make space for the fixed navigation bar and add space at the bottom so that + * link targets appear somewhat close to top + */ + body + { + padding-top: 3.2em; + padding-bottom: 20em; + } + /* style and size the navigation bar */ + table.navigation#top + { + position: fixed; + /* tango:scarlet red 0/1 */ + background: #ffe6e6; + border: solid 1px #ef2929; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + height: 3em; + z-index: 10; + } + .navigation a, .navigation a:visited + { + /* tango:scarlet red 3 */ + color: #a40000; + } + .navigation a:hover + { + /* tango:scarlet red 1 */ + color: #ef2929; + } + td.shortcuts + { + /* tango:scarlet red 1 */ + color: #ef2929; + font-size: 80%; + white-space: nowrap; + } +} +@media print { + table.navigation { + visibility: collapse; + display: none; + } + div.titlepage table.navigation { + visibility: visible; + display: table; + /* tango:scarlet red 0/1 */ + background: #ffe6e6; + border: solid 1px #ef2929; + margin-top: 0; + margin-bottom: 0; + top: 0; + left: 0; + height: 3em; + } +} + +.navigation .title +{ + font-size: 200%; +} + +div.gallery-float +{ + float: left; + padding: 10px; +} +div.gallery-float img +{ + border-style: none; +} +div.gallery-spacer +{ + clear: both; +} + +a, a:visited +{ + text-decoration: none; + /* tango:sky blue 2 */ + color: #3465a4; +} +a:hover +{ + text-decoration: underline; + /* tango:sky blue 1 */ + color: #729fcf; +} + +div.table table +{ + border-collapse: collapse; + border-spacing: 0px; + /* tango:aluminium 3 */ + border: solid 1px #babdb6; +} + +div.table table td, div.table table th +{ + /* tango:aluminium 3 */ + border: solid 1px #babdb6; + padding: 3px; + vertical-align: top; +} + +div.table table th +{ + /* tango:aluminium 2 */ + background-color: #d3d7cf; +} + +hr +{ + /* tango:aluminium 3 */ + color: #babdb6; + background: #babdb6; + border: none 0px; + height: 1px; + clear: both; +} + +.footer +{ + padding-top: 3.5em; + /* tango:aluminium 3 */ + color: #babdb6; + text-align: center; + font-size: 80%; +} + +.warning +{ + /* tango:orange 0/1 */ + background: #ffeed9; + border-color: #ffb04f; +} +.note +{ + /* tango:chameleon 0/0.5 */ + background: #d8ffb2; + border-color: #abf562; +} +.note, .warning +{ + padding: 0.5em; + border-width: 1px; + border-style: solid; +} +.note h3, .warning h3 +{ + margin-top: 0.0em +} +.note p, .warning p +{ + margin-bottom: 0.0em +} + +/* blob links */ +h2 .extralinks, h3 .extralinks +{ + float: right; + /* tango:aluminium 3 */ + color: #babdb6; + font-size: 80%; + font-weight: normal; +} + +.annotation +{ + /* tango:aluminium 5 */ + color: #555753; + font-size: 80%; + font-weight: normal; +} + +/* code listings */ + +.listing_code .programlisting .cbracket { color: #a40000; } /* tango: scarlet red 3 */ +.listing_code .programlisting .comment { color: #a1a39d; } /* tango: aluminium 4 */ +.listing_code .programlisting .function { color: #000000; font-weight: bold; } +.listing_code .programlisting .function a { color: #11326b; font-weight: bold; } /* tango: sky blue 4 */ +.listing_code .programlisting .keyword { color: #4e9a06; } /* tango: chameleon 3 */ +.listing_code .programlisting .linenum { color: #babdb6; } /* tango: aluminium 3 */ +.listing_code .programlisting .normal { color: #000000; } +.listing_code .programlisting .number { color: #75507b; } /* tango: plum 2 */ +.listing_code .programlisting .preproc { color: #204a87; } /* tango: sky blue 3 */ +.listing_code .programlisting .string { color: #c17d11; } /* tango: chocolate 2 */ +.listing_code .programlisting .type { color: #000000; } +.listing_code .programlisting .type a { color: #11326b; } /* tango: sky blue 4 */ +.listing_code .programlisting .symbol { color: #ce5c00; } /* tango: orange 3 */ + +.listing_frame { + /* tango:sky blue 1 */ + border: solid 1px #729fcf; + padding: 0px; +} + +.listing_lines, .listing_code { + margin-top: 0px; + margin-bottom: 0px; + padding: 0.5em; +} +.listing_lines { + /* tango:sky blue 0.5 */ + background: #a6c5e3; + /* tango:aluminium 6 */ + color: #2e3436; +} +.listing_code { + /* tango:sky blue 0 */ + background: #e6f3ff; +} +.listing_code .programlisting { + /* override from previous */ + border: none 0px; + padding: 0px; +} +.listing_lines pre, .listing_code pre { + margin: 0px; +} + diff --git a/docs/reference/gdk-pixbuf/html/up.png b/docs/reference/gdk-pixbuf/html/up.png Binary files differnew file mode 100644 index 0000000..85b3e2a --- /dev/null +++ b/docs/reference/gdk-pixbuf/html/up.png diff --git a/docs/reference/gdk-pixbuf/version.xml b/docs/reference/gdk-pixbuf/version.xml new file mode 100644 index 0000000..cc6ac9c --- /dev/null +++ b/docs/reference/gdk-pixbuf/version.xml @@ -0,0 +1 @@ +2.26.4 diff --git a/docs/reference/gdk-pixbuf/version.xml.in b/docs/reference/gdk-pixbuf/version.xml.in new file mode 100644 index 0000000..90ff08b --- /dev/null +++ b/docs/reference/gdk-pixbuf/version.xml.in @@ -0,0 +1 @@ +@GDK_PIXBUF_VERSION@ |