.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Gtk2::Gdk::Pixbuf::Draw::Cache 3pm"
.TH Gtk2::Gdk::Pixbuf::Draw::Cache 3pm "2014-08-15" "perl v5.20.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Gtk2::Gdk::Pixbuf::Draw::Cache \-  Cache for drawing scaled pixbufs
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Gtk2::Gdk::Pixbuf::Draw::Cache provides a cache that should be used by the
Gtk2::ImageView::Tool when redrawing the Gtk2::ImageView.
.SH "HIERARCHY"
.IX Header "HIERARCHY"
.Vb 2
\&  Glib::Boxed
\&  +\-\-\-\-Gtk2::Gdk::Pixbuf::Draw::Cache
.Ve
.SH "METHODS"
.IX Header "METHODS"
.SS "cache = Gtk2::Gdk::Pixbuf::Draw::Cache\->\fBnew\fP"
.IX Subsection "cache = Gtk2::Gdk::Pixbuf::Draw::Cache->new"
Returns a new pixbuf draw cache.
.ie n .SS "$cache\->\fBdraw\fP ($opts, $drawable)"
.el .SS "\f(CW$cache\fP\->\fBdraw\fP ($opts, \f(CW$drawable\fP)"
.IX Subsection "$cache->draw ($opts, $drawable)"
.IP "\(bu" 4
\&\f(CW$opts\fR (Gtk2::Gdk::Pixbuf::Draw::Opts)
.IP "\(bu" 4
\&\f(CW$drawable\fR (Gtk2::Gdk::Drawable)
.PP
Redraws the area specified in the pixbuf draw options in an efficient way by
using caching.
.IP "cache : a GdkPixbufDrawCache" 4
.IX Item "cache : a GdkPixbufDrawCache"
.PD 0
.IP "opts : the Gtk2::Gdk::Pixbuf::Draw::Opts to use in this draw" 4
.IX Item "opts : the Gtk2::Gdk::Pixbuf::Draw::Opts to use in this draw"
.IP "drawable : a GdkDrawable to draw on" 4
.IX Item "drawable : a GdkDrawable to draw on"
.PD
.ie n .SS "$cache\->\fBfree\fP"
.el .SS "\f(CW$cache\fP\->\fBfree\fP"
.IX Subsection "$cache->free"
Deallocates a pixbuf draw cache and all its data.
.ie n .SS "$cache\->\fBinvalidate\fP"
.el .SS "\f(CW$cache\fP\->\fBinvalidate\fP"
.IX Subsection "$cache->invalidate"
Force the pixbuf draw cache to scale the pixbuf at the next draw.
.PP
Gtk2::Gdk::Pixbuf::Draw::Cache tries to minimize the number of scale operations
needed by caching the last drawn pixbuf. It would be inefficient to check the
individual pixels inside the pixbuf so it assumes that if the memory address of
the pixbuf has not changed, then the cache is good to use.
.PP
However, when the image data is modified, this assumtion breaks, which is why
this method must be used to tell draw cache about it.
.ie n .SS "method = Gtk2::Gdk::Pixbuf::Draw::Cache\->\fBget_method\fP ($old, $new)"
.el .SS "method = Gtk2::Gdk::Pixbuf::Draw::Cache\->\fBget_method\fP ($old, \f(CW$new\fP)"
.IX Subsection "method = Gtk2::Gdk::Pixbuf::Draw::Cache->get_method ($old, $new)"
.IP "\(bu" 4
\&\f(CW$old\fR (Gtk2::Gdk::Pixbuf::Draw::Opts)
.IP "\(bu" 4
\&\f(CW$new\fR (Gtk2::Gdk::Pixbuf::Draw::Opts)
.PP
Gets the fastest method to draw the specified draw options. old is assumed to be
the last PixbufDrawOpts used and new is the one to use this time.
.SH "ENUMS AND FLAGS"
.IX Header "ENUMS AND FLAGS"
.SS "enum Gtk2::Gdk::Pixbuf::Draw::Method"
.IX Subsection "enum Gtk2::Gdk::Pixbuf::Draw::Method"
.IP "\(bu" 4
\&'scale' / '\s-1GDK_PIXBUF_DRAW_METHOD_SCALE\s0'
.IP "\(bu" 4
\&'contains' / '\s-1GDK_PIXBUF_DRAW_METHOD_CONTAINS\s0'
.IP "\(bu" 4
\&'scroll' / '\s-1GDK_PIXBUF_DRAW_METHOD_SCROLL\s0'
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Gtk2::ImageView, Glib::Boxed
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2007 by Jeffrey Ratcliffe.
.PP
This software is licensed under the \s-1GPL\-3\s0; see Gtk2::ImageView for a full notice.