Q ?hhDSrSrSS/rSrSSKrSSKrSSKJr SSKJ r J r J r J r SS K Jr SS KJr SS KJr SS KJrJr SS KJr SSKJrJrJr SSKJrJrJrJrJ r SSK!J"r"J#r#J$r$J%r%J&r&J'r' SSK(J)r) SSK*J+r+J,r, SSK-J.r. \R^"S5r0Sr1Sr2SS\14SSS\24SSS\14SSS\24SSS\14SSS\24SSS\14SSS\24S0r3S&Sjr4Sr5Sr6Sr7"SS 5r8S!r9"S"S5r:"S#S\5r;\?#q).q1  MM(9- .v&( c^[U[5(a1URmS[U4SjUR 5554$[U[ 5(aSUR 54$[U[[45(a [U5nUS:XaSU4$US:XaSU4$O)[U[5(a[[U55$[SU-5e)N DeviceCMYKc3,># UH oT-v M g7fN).0cds r7 "_normalizeColor..Ls"> 1Q3 s DeviceRGBzUnknown color %r) isinstancerdensitytuplecmykrrgblistlenstr_normalizeColorr ValueError)aColorlrAs @r7rOrOIs&)$$ NNU"> ">>>> FE " "FJJL(( FUDM * * K 6& & !V' ' FC wv// '&0 11r9cSn/nUH>n[U5upEUbX:wa[SU<SU<35eUnURU5 M@ X4$)NzMismatch in color spaces: z and )rOrPr/)colorsspace outcolorsrQnspaceoutcolors r7_normalizeColorsrYYs[ EI*62  eVTU U"   r9c \SSKJnJn Ub#[U5[U5:wa [ S5e[U5S:XaU"SUSUSS9$[U5S:Xa#UbUSS:XaUSS:XaU"SUSUSS9$Uc6[U5n[ U5Vs/sHn[ U5US- - PM nnO[[X55nURSS9 USSS:waURSS USS45 US SS:waURS US S45 [[U65up/nUSS Vs/sHoPM n n/n USn USSH=n URU"SXS95 U n U RS 5 U RS 5 M? U"XyU S S 9$s snfs snf)Nr)PDFExponentialFunctionPDFStitchingFunctionz4need to have the same number of colors and positionsr)NC0C1c US$Nrr>)xs r7%_buildColorFunction..vsQqTr9)key?z [0.0 1.0])Domain) r+r[r\rMrPrangefloatrLzipsortinsertr/) rT positionsr[r\ncrc poscolors functionsposboundsencode lastcolorr1s r7_buildColorFunctionrxdsUY3v;!>OPP 6{a%fQiF1IFF 6{a  1!2y|q7H)A&)q J J [.3Bi8iU1Xr!t_i 8 Y/0 >* Q<?a    Qil1o 6 7 R= q   c9R=#34 5 i1 I&q_ -_cc_F - Fq I/! LM  c c  6+ NN+9.s F$ F)c \rSrSr\"SSSSSSS9r\"1SkS9rS 1r\S 5r \S 5r \S 5r S r Sr SrSrSrSrg) ExtGStaterFrNormal)CAcaOPopOPMBM>HuerDarkenr|ScreenLightenOverlayMultiply ColorBurn Exclusion HardLight SoftLight ColorDodge Difference Luminosity Saturation)rrc4[U5R5$r=)rNlowervs r7_boolTransformExtGState._boolTransforms1v||~r9cU$r=r>rs r7_identityTransformExtGState._identityTransformsr9c SU-$)N/r>rs r7_pdfNameTransformExtGState._pdfNameTransforms 1u r9c 0Ul0Ulgr=)_d_cselfs r7__init__ExtGState.__init__sr9c URUn[U[5(a[U5nURnO^X R;aCX0R U;a$[ SU<SU<SUR U<35eURnO URnX0RRX$5:wdUS:XaURS5U:waX0RU'X%"U54nX`R;aURUnO/S[[UR55-nXpRU'URR!SU-5 ggg)Nz ExtGstate[z] = z not in allowed values rrgRLsz/%s gs)defaultsrGboolr pdfNameValuesallowedrPrrrgetgetValuerrNrM_coder/)rcanvarrA vTransformtnames r7set ExtGState.sets MM!  a  1gA,,J $$ $ Q' a Q")**//J00J ggkk! 1d7t}}T/BA/EGGAJ*Q-AGG|wwqzc#dgg,//! JJ  ho .0F7r9cRURRXRU5$r=)rrr)rrs r7rExtGState.getValuesww{{1]]1-..r9c0nURR5H'up#[R"[ U455X'M) U=(a [R"U5=(d S$r=)ritemsr PDFDictionarydict)rr$rrs r7getStateExtGState.getStatesP ggmmoFA**4:6AG&,V))!,44r9cUR5nURR5UlURUlU$)z=the states must be shared across push/pop, but the values not) __class__rcopyr)rrcs r7pushCopyExtGState.pushCopys/ NN ww||~wwr9)rrN)__name__ __module__ __qualname____firstlineno__rrrr staticmethodrrrrrrrr__static_attributes__r>r9r7rzrzs HGFM/,/5 r9rzc[U[[45(a;[U5S:wa[ SU-5eSUVs/sH o(aSOSPM sn-$U(aS$S$s snf)Nr`z wrong length for extend argumentz[%s %s]truefalsez [true true]z [false false])rGrLrIrMrP)extend_s r7_gradientExtendStrrsc&$u&& v;>?&HI IfEfaFW4fEEE"=77FsA"c$\rSrSrSSjrSrSrg)rNc(XlX lX0lgr=)r1widthr3)rr1rr3s r7rShowBoundaryValue.__init__s  "r9cJURSL=(a URS:$rb)r1rrs r7__bool__ShowBoundaryValue.__bool__szz%7$**a-7r9)r1r3r)rrrg?N)rrrrrrrr>r9r7rrs # 8r9c\rSrSrSrSSjrSrSrS rS r S R5r \ "\ "\"\ 555rS rS rSrSrSSjrSrSrSrSrSrSrSrSrSrSrSrSr Sr!Sr"Sr#S r$S!r%S"r&S#r'S$r(S%r)S&r*S'r+S(r,SS)jr-SS*jr.S+r/S,r0S-r1SS/jr2SS0jr3S1r4S2r5S3r6SS4jr7S5r8SS6jr9SS7jr:SS8jr;SS9jr<\SS<jr?\?r@SS=jrASS>jrBSS?jrCSS@jrDSArESBrFSCrGSDrHSErISSFjrJSGrKSHrLSIrMSJrNSSKjrOSLrPSMrQSNrRSOrSSPrTSQrUSRrVSSrWSTrXSUrYSVrZSSWjr[SXr\SYr]SSZjr^SS[jr_SS\jr`SS]jraSS^jrbSS_jrcS`rdSareSSbjrfSScjrgSSdjrhSSejriSSfjrj\kRSSSSS.4SgjrmShrnSiroSSjjrpSSkjrqSSljrrSmrsSnrtSoruSprv/S4SqjrwSrrxSSsjrySStjrzSSujr{SSvjr|Swr}SSxjr~SSyjrSSzjrS{rS|rS}rS~rSrSrSrSSjr\S5rSrSrg)raThis class is the programmer's interface to the PDF file format. Methods are (or will be) provided here to do just about everything PDF can do. The underlying model to the canvas concept is that of a graphics state machine that at any given point in time has a current font, fill color (for figure interiors), stroke color (for figure borders), line width and geometric transform, among many other characteristics. Canvas methods generally either draw something (like canvas.line) using the current state of the canvas or change some component of the canvas state (like canvas.setFont). The current state can be saved and restored using the saveState/restoreState methods. Objects are "painted" in the order they are drawn so if, for example two rectangles overlap the last draw will appear "on top". PDF form objects (supported here) are used to draw complex drawings only once, for possible repeated use. There are other features of canvas which are not visible when printed, such as outlines and bookmarks which are used for navigating a document in a viewer. Here is a very silly example usage which generates a Hello World pdf document. Example:: from reportlab.pdfgen import canvas c = canvas.Canvas("hello.pdf") from reportlab.lib.units import inch # move the origin up and to the left c.translate(inch,inch) # define a large font c.setFont("Helvetica", 80) # choose some colors c.setStrokeColorRGB(0.2,0.5,0.3) c.setFillColorRGB(1,0,1) # draw a rectangle c.rect(inch,inch,6*inch,9*inch, fill=1) # make text go straight up c.rotate(90) # change color c.setFillColorRGB(0,0,0.77) # say hello (note after rotate the y coord needs to be negative!) c.drawString(3*inch, -3*inch, "Hello World") c.showPage() c.save() Nrrc PUc[RnUc[RnU (aU O[RUlU bU OSUlU bU OUR S-UlXl[R"UXQU =(d [RUS9Ul [U 5Ul X`lSUlXlX lSUlSUlSUlSUl0UlUR/U5 SUl/UlUR55 SUl/Ul/Ul/UlX0l[R@Ul!Xl"Xl#UUl$UUl%URM5 URO5 /Ul(URSU5 g)aCreate a canvas of a given size. etc. You may pass a file-like object to filename as an alternative to a string. For more information about the encrypt parameter refer to the setEncrypt method. Most of the attributes are private - we will use set/get methods as the preferred interface. Default page size is A4. cropMarks may be True/False or an object with parameters borderWidth, markColor, markWidth and markLength if enforceColorSpace is in ('cmyk', 'rgb', 'sep','sep_black','sep_cmyk') then one of the standard _PDFColorSetter callables will be used to enforce appropriate color settings. If it is a callable then that will be used. N 333333?) compression invariantfilename pdfVersionlangrr)*r defaultPageSizercanvas_basefontname_initialFontName_initialFontSize_initialLeading _filenamer PDFDocumentPDF_VERSION_DEFAULT_docr_enforceColorSpace _verbosity_onPage _cropMarks _pagesize_hanging_pagesize _pageRotation_pageTransition _pageDuration _destinationssetPageCompression _pageNumber _codeStack_restartAccumulators_annotationCount _outlines_psCommandsBeforePage_psCommandsAfterPagebottomupdefaultImageCaching imageCaching_cropBox_artBox_trimBox _bleedBoxinit_graphics_state_make_preamble state_stack setEncrypt)rrpagesizerpageCompressionr verbosityencrypt cropMarksrenforceColorSpaceinitialFontNameinitialFontSizeinitialLeadingcropBoxartBoxtrimBoxbleedBoxrkwdss r7rCanvas.__init__sF   (A(AX  )*=*=i3B HeHe3B3NTV1?1K~QUQfQfgjQj!&&?1:2<2Z@Z@Z,0) #;;L"M$ #!!%#! 0 !!# !%'"$&!! %99   !   "   r9crU(aSSKJn [U5(aD[U5(aUR S5nUR U5nUR S5 O([XR 5(d[SU-5eXRl gUR? g![a gf=f)a@ Set the encryption used for the pdf generated by this canvas. If encrypt is a string object, it is used as the user password for the pdf. If encrypt is an instance of reportlab.lib.pdfencrypt.StandardEncryption, this object is used to encrypt the pdf. This allows more finegrained control over the encryption settings. r) pdfencryptutf-8rzjExpected string or instance of reportlab.lib.pdfencrypt.StandardEncryption as encrypt parameter but got %rN) reportlab.librrrrvStandardEncryptionsetAllPermissionsrG TypeErrorrr AttributeError)rr rs r7rCanvas.setEncryptus  0W~~W%%%nnW5G$77@))!,)F)FGG!MPW!WXX 'II  II%!  s B)) B65B6cSUlSUlURUlURUlSUlURUlSUl [Ul SUl SUl SUlSUlSUlSUlSUlSUlSUlSUlSUlSUl[0R2=(d S=UlUllg)Nr)rirgrgrirgrgdrr)_x_yr _fontnamer _fontsize _textModer_leading_currentMatrix FILL_EVEN_ODD _fillMode _charSpace _wordSpace _horizScale_textRenderMode_rise_textLineMatrix _textMatrix_lineCap _lineJoin _lineDash _lineWidth _mitreLimitr canvas_baseColor _fillColorObj_strokeColorObjrz _extgstaters r7rCanvas.init_graphics_states....,, 6&  73 4=4N4N4YRYYT1#+r9c0nURnURH nX#X'M URRU5 URR 5Ulgr=)__dict__STATE_ATTRIBUTESrr/r9r)rstaterArs r7push_state_stackCanvas.push_state_stacksQ MM))D'EK* &//224r9cjURRURR55 gr=)r<updaterpoprs r7pop_state_stackCanvas.pop_state_stacks# T--1134r9a_x _y _fontname _fontsize _textMode _leading _currentMatrix _fillMode _charSpace _wordSpace _horizScale _textRenderMode _rise _textLineMatrix _textMatrix _lineCap _lineJoin _lineDash _lineWidth _mitreLimit _fillColorObj _strokeColorObj _extgstatec/RnUR(a U"S5 O!U"S[URS5-5 URn[ U5nUR S:waURUR 5 URS:waURUR5 U"SRX#S55 X#S2 [R"UR5nUR(d[URR (d[#USS5(d.U"SUR$R'UR5-5 SRUR(5Ulg) Nz1 0 0 1 0 0 cmz1 0 0 -1 0 %s cmrr _drawTextAsPathFzBT %s 12 Tf 14.4 TL ET)r/rr rrrMr7 setFillColorr8setStrokeColorjoinr getFontr# _dynamicFontfacebuiltIngetattrrgetInternalFontName__self__ _preamble)rPr)r#fonts r7rCanvas._make_preambles II ==    6$..*;#<< = JJ F    (   d00 1   7 *    4 4 5 #((1R5/ bE!!$..1  yy  5Fu(M(M*TYY-J-J4>>-ZZ[!**-r9c[U5$r=)r!rss r7_escapeCanvas._escapes |r9c:URRU5 g)zidentify the author for invisible embedding inside the PDF document. the author annotation will appear in the the text of the file but will not automatically be seen when the document is viewed, but is visible in document properties etc etc.N)r setAuthor)rauthors r7r]Canvas.setAuthors F#r9c:URRU5 g)zHaccepts a func(yyyy,mm,dd,hh,m,s) used to create embedded formatted dateN)rsetDateFormatter)r dateFormatters r7raCanvas.setDateFormatters ""=1r9cLURRRX#XS9 g)a2Adds a new entry to the outline at given level. If LEVEL not specified, entry goes at the top level. If level specified, it must be no more than 1 greater than the outline level in the last call. The key must be the (unique) name of a bookmark. the title is the (non-unique) name to be displayed for the entry. If closed is set then the entry should show no subsections by default when displayed. Example:: c.addOutlineEntry("first section", "section1") c.addOutlineEntry("introduction", "s1s1", 1, closed=1) c.addOutlineEntry("body", "s1s2", 1) c.addOutlineEntry("detail1", "s1s2s1", 2) c.addOutlineEntry("detail2", "s1s2s2", 2) c.addOutlineEntry("conclusion", "s1s3", 1) c.addOutlineEntry("further reading", "s1s3s1", 2) c.addOutlineEntry("second section", "section1") c.addOutlineEntry("introduction", "s2s1", 1) c.addOutlineEntry("body", "s2s2", 1, closed=1) c.addOutlineEntry("detail1", "s2s2s1", 2) c.addOutlineEntry("detail2", "s2s2s2", 2) c.addOutlineEntry("conclusion", "s2s3", 1) c.addOutlineEntry("further reading", "s2s3s1", 2) generated outline looks like:: - first section |- introduction |- body | |- detail1 | |- detail2 |- conclusion | |- further reading - second section |- introduction |+ body |- conclusion | |- further reading Note that the second "body" is closed. Note that you can jump from level 5 to level 3 but not from 3 to 5: instead you need to provide all intervening levels going down (4 in this case). Note that titles can collide but keys cannot. )closedN)routlineaddOutlineEntry)rtitlerflevelres r7rgCanvas.addOutlineEntrys"h ))#e)Kr9cRURRR"U4U-6 g)anametree should can be a recursive tree like so:: c.setOutlineNames( "chapter1dest", ("chapter2dest", ["chapter2section1dest", "chapter2section2dest", "chapter2conclusiondest"] ), # end of chapter2 description "chapter3dest", ("chapter4dest", ["c4s1", "c4s2"]) ) each of the string names inside must be bound to a bookmark before the document is generated. N)rrfsetNames)rnametrees r7setOutlineNames0Canvas.setOutlineNames0s#" ""dWX%57r9c:URRU5 g)zXwrite a title into the PDF file that won't automatically display in the document itself.N)rsetTitle)rrhs r7rqCanvas.setTitle+s 5!r9c:URRU5 g)zZwrite a subject into the PDF file that won't automatically display in the document itself.N)r setSubject)rsubjects r7rtCanvas.setSubject0s W%r9c:URRU5 g)zwrite a creator into the PDF file that won't automatically display in the document itself. This should be used to name the original app which is passing data into ReportLab, if you wish to name it.N)r setCreator)rcreators r7rxCanvas.setCreator5s W%r9c:URRU5 g)z!change the default producer valueN)r setProducer)rproducers r7r|Canvas.setProducer;s h'r9c[U[[45(aSRU5nURR U5 g)z|write a list of keywords into the PDF file which shows in document properties. Either submit a single string or a list/tuplez, N)rGrLrIrKr setKeywords)rkeywordss r7rCanvas.setKeywords?s5 hU| , ,yy*H h'r9c2[UR5S:H$)zHInfo function - app can call it after showPage to see if it needs a saver)rMrrs r7 pageHasDataCanvas.pageHasDataFs4::!##r9cLURRR5 g)zSpecify that Acrobat Reader should start with the outline tree visible. showFullScreen() and showOutline() conflict; the one called last wins.N)r_catalog showOutliners r7rCanvas.showOutlineJs &&(r9cLURRR5 g)zSpecify that Acrobat Reader should start in full screen mode. showFullScreen() and showOutline() conflict; the one called last wins.N)rrshowFullScreenrs r7showFullScreen0Canvas.showFullScreen0Ps ))+r9ctURRS5 URRUSU5 g)z Define the transparency/opacity of strokes. 0 is fully transparent, 1 is fully opaque. Note that calling this function will cause a version 1.4 PDF to be generated (rather than 1.3). transparencyr}NrensureMinPdfVersionr9rrrs r7_setStrokeAlphaCanvas._setStrokeAlphaV, %%n5 Da(r9ctURRS5 URRUSU5 g)z Define the transparency/opacity of non-strokes. 0 is fully transparent, 1 is fully opaque. Note that calling this function will cause a version 1.4 PDF to be generated (rather than 1.3). rr~Nrrs r7 _setFillAlphaCanvas._setFillAlphaarr9c>URRUSU5 g)Nrr9rrs r7_setStrokeOverprintCanvas._setStrokeOverprintl Da(r9c>URRUSU5 g)Nrrrs r7_setFillOverprintCanvas._setFillOverprintorr9cbURRUSU=(a S=(d S5 g)Nrrrrrs r7_setOverprintMaskCanvas._setOverprintMaskrs  DqwQ|!4r9c>URRUSU5 g)Nrrrs r7 setBlendModeCanvas.setBlendModeurr9cURnU(a;[S[USS55n[S[USS55nU(aX2-nU$g)Nr bleedWidth borderWidth$)rmaxrP)rcMbleedWbws r7 _getCmShiftCanvas._getCmShiftxsL __ 72l156FQwr-34B I r9c8URSnURSnURnURnU(Ga[S[ USS55nU(Ga[ USS5n[ U[S[ USS555n[ USS 5n[ US [ 5n S U-U- n [U5n U(aU (aUR5 URU 5 URU5 URUSXW4X-SX-U4XRU -XRS U--4X-X*-X-US U--4SXWU4X-XQS U--U4SX%-XrU-4X-X%-US U--X%-4/5 UR5 U(aXKS n XKS 2 [U5n [S[ US S55n UR5 URX]- X]- 5 U (a$URSSU -U- -SSU -U- -5 XKS nXKS 2 XSS&UR5 U(aURW 5 S U-U-nS U-U-nUR!S5 ["R$"5nXlX/lUR*UlUR.UlUR3UR45 UR7UR85 SHNn[ USU-S 5nU(dM[;UUR=5S-["R>"U55 MP UR@bUR@Ul!URDURF/-U-URH-nURKU5 URMU5 UROU5 URQU5 URSU5 URUU5 URVRYU5 URZ(aUR[UR\5 UR_5 g )z8Close the current page and possibly start on a new page.rrrrmarkLast markLength markWidth? markColorr`Nrg@rG)cropartbleedtrim_%sBoxBox)0rrrrrPminrrM saveStaterJ setLineWidthlines restoreState translatescalerr/r PDFPage pagewidth pageheightrRotate_currentPageHasImages hasImagessetPageTransitionrsetCompression_pageCompressionsetattr capitalizer(rDurrrSr setStream_setColorSpace _setExtGState _setXObjects_setShadingUsed_setAnnotationsraddPagerr _startPage)r pageWidth pageHeightrcoderrmlmwmcmgcx0Lrr)pageboxsizestrms r7showPageCanvas.showPages NN1% ^^A& __zz Qwr-34B"2j3C'"\""=>?R C0R E2rT"W$i"NN$''+%%b)JJAb "a R8rM""_="jmILAbDQ2 "b1R4;:=rM:"jmIadN:=Q  %%'!J J!$iQwr,q9: ry3JJq#f*i!773v:z:Q8QRJJQq !!#KKNbD9, rTJ.  C~~"$(( 33 t334 D1120C4 T2DtS^^-e3FOOD4IJ1    )))DH**dnn-==DtG`G`` t D! 4  $ T" T" $ <<d&6&67 r9cUR(a"URUR5 SUlU=RS- slUR5 UR 5 /UlgNr)r setPageSizerrrrrs r7rCanvas._startPagesX  ! !   T33 4%)D " A !!#   "r9cXlg)zfunc(pageNum) will be called on each page end. This is mainly a hook for progress monitoring. Call setPageCallback(None) to clear a callback.N)r)rfuncs r7setPageCallBackCanvas.setPageCallBacks  r9c&URUlgr=)_annotationrefsAnnotsrrs r7rCanvas._setAnnotationss** r9c&URUlgr=) _colorsUsedrobjs r7rCanvas._setColorSpaces**r9c&URUlgr=) _shadingUsedrs r7rCanvas._setShadingUseds --r9c|URnU(a"URRU5nX1lgSUlg)zKfor pages and forms, define the XObject dictionary for resources, if neededN) _formsinuserxobjDictXObjects)rthingforms xobjectsdicts r7rCanvas._setXObjectss0   99--e4L)N!ENr9chURnX!$! [R"U5=o2U'U$=f)zDget a reference to a (possibly undefined, possibly unbound) bookmark)rr Destination)rrrAresults r7_bookmarkReferenceCanvas._bookmarkReferences<    87N 8%11$7 7FtW s1cURU5nURR5 URR5n UcSnUcSnUcSnUcSnUcSnUS:XaUR X4U5 OUS:XaUR 5 OUS:XaUR U5 OUS:XaURU5 OwUS:XaURX5Xd5 O^US:XaUR5 OGUS:XaURU5 O/US :XaURU5 O[S [U5-5eURU 5 U$) a This creates a bookmark to the current page which can be referred to with the given key elsewhere. PDF offers very fine grained control over how Acrobat reader is zoomed when people link to this. The default is to keep the user's current zoom settings. the last arguments may or may not be needed depending on the choice of 'fitType'. Fit types and the other arguments they use are: - XYZ left top zoom - fine grained control. null or zero for any of the parameters means 'leave as is', so "0,0,0" will keep the reader's settings. NB. Adobe Reader appears to prefer "null" to 0's. - Fit - entire page fits in window - FitH top - top coord at top of window, width scaled to fit. - FitV left - left coord at left of window, height scaled to fit - FitR left bottom right top - scale window to fit the specified rectangle (question: do we support /FitB, FitBH and /FitBV which are hangovers from version 1.1 / Acrobat 3.0?)nullXYZFitFitHFitVFitRFitBFitBHFitBVzUnknown Fit type %s)rrinPage thisPageRefxyzfitfithfitvfitrfitbfitbhfitbvrPasciisetPage) rrfrlefttopbottomrightzoomdestpagerefs r7 bookmarkPageCanvas.bookmarkPages$L&&s+ ))'') <D ;C >F =E <D %< HHTd # E\ HHJ F] IIcN F] IIdO F] IId% , F] IIK G^ JJsO G^ JJt 2U3Z?@ @ W r9c $URXX#SS9$)aBind a bookmark (destination) to the current page at a horizontal position. Note that the yhorizontal of the book mark is with respect to the default user space (where the origin is at the lower left corner of the page) and completely ignores any transform (translation, scale, skew, rotation, etcetera) in effect for the current graphics state. The programmer is responsible for making sure the bookmark matches an appropriate item on the page.r)rr!r r$)r')rrfr!r rkws r7bookmarkHorizontalAbsolute!Canvas.bookmarkHorizontalAbsoluteOs  3 JJr9c TURX#5upVUR"X4SU0UD6 g)z (TYY%=%=d%CCD %r9c8URRU5$)z*Query whether form XObj really exists yet.)rhasFormr6s r7r:Canvas.hasFormrsyy  &&r9Fc SUlSSKJn U "XX4U5n U RUUXxU U S9 U RU R 4$)a,See drawImage, which should normally be used instead... drawInlineImage behaves like drawImage, but stores the image content within the graphics stream for the page. This means that the mask parameter for transparency is not available. It also means that there is no saving in file size or time if the same image is reused. In theory it allows images to be displayed slightly faster; however, we doubt if the difference is noticeable to any human user these days. Only use this if you have studied the PDF specification and know the implications. rr)PDFImage)preserveAspectRatioanchor anchorAtXY showBoundary extraReturn)rreportlab.pdfgen.pdfimagesr=drawInlineImagerheight) rimagercyrrEr>r?r@rArBr=img_objs r7rDCanvas.drawInlineImage{sR &'"75Af5 3\#  % w~~..r9c XSUl[U[5(atUR5n URn US:XaU (aU R5nO [ U5n[ U5(aURS5n[X-5nO4U<U<3n[ U5(aURS5n[U5nURRU5nURRRUS5nU(Gd[R"XUS9nUUlUR!U5 URR#UU5 URR%UU5 ['USS5n U (aURRU R5nURRRUS5nU(d3UR!U 5 URR#U U5UlO[R*"U5UlU?[/XxX#XEUR0UR2U 5 up#pEnUR55 UR7X#5 UR9XE5 UR:R=SU-5 UR?5 U (aURAXX4U5 URBR=U5 U (a'U RE5Hn[G5UU U'M UR0UR24$) a Draws the image (ImageReader object or filename) as specified. "image" may be an image filename or an ImageReader object. x and y define the lower left corner of the image you wish to draw (or of its bounding box, if using preserveAspectRation below). If width and height are not given, the width and height of the image in pixels is used at a scale of 1 point to 1 pixel. If width and height are given, the image will be stretched to fill the given rectangle bounded by (x, y, x+width, y-height). If you supply negative widths and/or heights, it inverts them and adjusts x and y accordingly. The method returns the width and height of the underlying image, since this is often useful for layout algorithms and saves you work if you have not specified them yourself. The mask parameter supports transparent backgrounds. It takes 6 numbers and defines the range of RGB values which will be masked out or treated as transparent. For example with [0,2,40,42,136,139], it will mask out any pixels with a Red value from 0-2, Green from 40-42 and Blue from 136-139 (on a scale of 0-255). New post version 2.0: drawImage can center an image in a box you provide, while preserving its aspect ratio. For example, you might have a fixed square box in your design, and a collection of photos which might be landscape or portrait that you want to appear within the box. If preserveAspectRatio is true, your image will appear within the box specified. If preserveAspectRatio is True, the anchor property can be used to specify how images should fit into the given box. It should be set to one of the following values, taken from the points of the compass (plus 'c' for 'centre'): nw n ne w c e sw s se The default value is 'c' for 'centre'. Thus, if you want your bitmaps to always be centred and appear at the top of the given box, set anchor='n'. There are good examples of this in the output of test_pdfgen_general.py Unlike drawInlineImage, this creates 'external images' which are only stored once in the PDF file but can be drawn many times. If you give it the same filename twice, even at different locations and sizes, it will reuse the first occurrence, resulting in a saving in file size and generation time. If you use ImageReader objects, it tests whether the image content has changed before deciding whether to reuse it. In general you should use drawImage in preference to drawInlineImage unless you have read the PDF Spec and understand the tradeoffs.rautoutf8rN)mask_smaskr4)$rrGr getRGBData_dataArNrrvrrr5 idToObjectrr PDFImageXObjectrr ReferenceaddFormrPsmaskPDFObjectReferencerNr"rrErrrrr/r drawBoundaryrkeysvars)rrFrcrGrrErMr>r?r@rArBrawdatarUmdatarrYregNameimgObjmRegNamemImgObjscaledks r7 drawImageCanvas.drawImages|&'" eK ( (&&(GLLEV|((*D  V,W]+D &A||HHW%QtO_aearDJ(*D %)+D &)*D &!D #%D !DN!D  "D r9c$URURURURURUR 4nUR RU5 /UlSUl/Ul/UlSUl0Ul0Ulg)zVwhen you enter a form, save accumulator info not related to the form for page (if any)rN) rrrrerrrr/r)rsaveds r7_pushAccumulatorsCanvas._pushAccumulators!s~T--t/C/CT^^UYUeUegkgxgxy u% %&"!r9cBURR5Ulgr=)r9rrzrs r7rCanvas._setExtGState-s002 r9cUR5 UR5 UR(dUR(aUR 5 XX4U4UlUR R 5 g)aFdeclare the current graphics stream to be a named form. A graphics stream can either be a page or a form, not both. Some operations (like bookmarking) are permitted for pages but not forms. The form will not automatically be shown in the document but must be explicitly referenced using doForm in pages that require the form.N)r?rrreririnForm)rrlowerxloweryupperxupperys r7 beginFormCanvas.beginForm0sU    " ::  " " $? r9c <URup#pEnURupxUcUnUcUn[R"X4XVS9n URU lU R UR/UR-5 UR5Hup[XU 5 M URU 5 URU 5 URU 5 URU 5 URR!X)5 UR#5 UR%5 g)zaemit the current collection of graphics operations as a Form as declared previously in beginForm.N)rorprqrr)rerr PDFFormXObjectrr setStreamListrSrrrrrrrrrTrrD) rextra_attributesrrorprqrrwhformrars r7endFormCanvas.endFormBs26.vv R >!6 >!6$$F&`00 DNN+djj89$**,DA D1 - D! 4  $ T" $% !!# r9c6[U5(a7S[R"URS55R 5-nO'S[R"U5R 5-nUR R U5nUR RRUS5nU(d`[R"US-5nURU5 UR RXT5 UR RX55 US:XaURRSU-5 OCUS:XaUR RSU-5 OUR"RSU-5 UR$RU5 g)a'Embed literal Postscript in the document. With position=0, it goes at very beginning of page stream; with position=1, at current point; and with position=2, at very end of page stream. What that does to the resulting Postscript depends on Adobe's header :-) Use with extreme caution, but sometimes needed for printer tray commands. Acrobat 4.0 will export Postscript to a printer or file containing the given commands. Adobe Reader 6.0 no longer does as this feature is deprecated. 5.0, I don't know about (please let us know!). This was funded by Bob Marshall of Vector.co.uk and tested on a Lexmark 750. See test_pdfbase_postscript.py for 2 test cases - one will work on any Postscript device, the other uses a 'setpapertray' command which will error in Distiller but work on printers supporting it. PSrN rr4r)rhashlibmd5rv hexdigestrr5rQrr PDFPostScriptXObjectrrSrTrr/rrr)rcommandpositionrawNamer\psObjs r7addPostScriptCommandCanvas.addPostScriptCommand[s4$ W  W[[)@AKKMMGW[[1;;==G))**73 $$(($7//$?E   e $ II   / II  g - q=  & & - -h.@ A q[ JJ  h0 1  % % , ,X-? @ (r9cU(dURup4SSX44nOU(aUupVpxURXV5upURXx5upURXX5upURXv5unnXX4nXUU4n[U5[U5nn[U5[U5nnUUUU4nUR 5nU(aUSU-USU-USU-USU-4nU$)Nrrr`rE)rr.rrr)rrectrelativeryrzlxlyuxuyxllyllxuryurxulyulxlrylrxsysxminyminxmaxymaxrs r7_absRectCanvas._absRects..CAa9D !NBB++B2GC++B3GC++B3GC++B3GC3#B3#BR#b'$DR#b'$DtT)D     72:d1gbjaDGBJ>D r9c vURX65nUR[R"X1U40UD6XT5 g)z&DA is the default appearance string???N)r_addAnnotationr FreeTextAnnotation)rcontentsDARect addtopagerrr*s r7freeTextAnnotationCanvas.freeTextAnnotations3}}T+ F55dbOBOQUar9c tURX%5nUR[R"X!40UD6XC5 g)z!Experimental, but works. N)rrr TextAnnotation)rrrrrrr*s r7textAnnotationCanvas.textAnnotations2}}T+ F11$GBGYr9)g(\?g{Gz?gffffff?c URX'5nU(d[R"U5nUR[R"X!X440UD6Xe5 g)a Allows adding of a highlighted annotation. Rect: Mouseover area to show contents of annotation QuadPoints: List of four x/y points [TOP-LEFT, TOP-RIGHT, BOTTOM-LEFT, BOTTOM-RIGHT] These points outline the areas to highlight. You can have multiple groups of four to allow multiple highlighted areas. Is in the format [x1, y1, x2, y2, x3, y3, x4, y4, x1, y1, x2, y2, x3, y3, x4, y4] etc QuadPoints defaults to be area inside of passed in Rect Color: The color of the highlighting. N)rr rect_to_quadrHighlightAnnotation) rrr QuadPointsrrrrr*s r7highlightAnnotationCanvas.highlightAnnotationsI}}T,,,T2J F66tz_\^_aeqr9c [er=)NotImplementedErrorrrzryrr InkAnnotation)rrInkListrrrrr*s r7 inkAnnotationCanvas.inkAnnotations!!r9c  4UR"XX4U4SXgUS.U D6$)arectangular link annotation positioned wrt the default user space. The identified rectangle on the page becomes a "hot link" which when clicked will send the viewer to the page and position identified by the destination. Rect identifies (lowerx, lowery, upperx, uppery) for lower left and upperright points of the rectangle. Translations and other transforms are IGNORED (the rectangular position is given with respect to the default user space. destinationname should be the name of a bookmark (which may be defined later but must be defined before the document is generated). You may want to use the keyword argument Border='[0 0 0]' to suppress the visible rectangle around the during viewing link.r)rr2r1r3)linkRect) rrdestinationnamerrrr2r1r3r*s r7 linkAbsoluteCanvas.linkAbsolutes4 }}XMXY#IMIKM Mr9c  URU5n URX65nX:S'XS'XS'[XXy5 UR[R "S0U D6XT5$)zrectangular link annotation w.r.t the current user transform. if the transform is skewed/rotated the absolute rectangle will use the max/min x/y rContentsrr>)rrr8rr LinkAnnotation) rrrrrrrr2r1r3r* destinations r7rCanvas.linkRectsc --o> }}T+6 !:'=2I0""6#8#8#>2#>PPr9c fSSKJn Jn Jn Jn U "US9n U "S5U S'U "S5U S'U "UR X#55U S'U "5nU "S 5US'U "U5nU "U5US 'US :XaXS 'OUS :Xa XS 'SUS'O[ SU-5eXS'[XXF5 URU 5 g)aCreate a rectangular URL 'hotspot' in the given rectangle. if relative=1, this is in the current coord system, otherwise in absolute page space. The remaining options affect the border appearance; the border is drawn by Acrobat, not us. Set thickness to zero to hide it. Any border drawn this way is NOT part of the page stream and will not show when printed to a Postscript printer or distilled; it is safest to draw your own.r)rPDFNamer( PDFString)rAnnotTypeLinkSubtyperActionr$URIGoToRFz[ 0 /XYZ null null null ]r0zUnknown linkURI kind '%s'AN) r+rrr(rrrPr8r)rurlrrr2r1r3kindr*rrr(rannruris r7linkURLCanvas.linkURLs YX$g&F  It}}T;<F  OH%& n# ;eH 7]cF0AcF84?@ @C3Y1 C r9cURS-=o@lU(dS[U5-nURRX!5 U(aUR U5 gg)NrNUMBER)rreprr addAnnotation _annotatePage)r annotationrrcounts r7rCanvas._addAnnotationsP(,(=(=a(??%(4;.T 1    t $ r9cpURRU5nURRU5 gr=)r refAnnotationrr/)rrrefs r7rCanvas._annotatePages*ii%%d+ ##C(r9cUR$)z9get the page number for the current page being generated.)rrs r7 getPageNumberCanvas.getPageNumber sr9c[UR5(aUR5 URR UR U5 g)zSaves and close the PDF document in the file. If there is current data a ShowPage is executed automatically. After this operation the canvas must not be used further.N)rMrrr SaveToFilerrs r7save Canvas.saves1 tzz??DMMO T^^T2r9c[UR5(aUR5 URR U5n[ U5(aUR S5nU$)zReturns the PDF data that would normally be written to a file. If there is current data a ShowPage is executed automatically. After this operation the canvas must not be used further.r)rMrrr GetPDFDatarrvrXs r7 getpdfdataCanvas.getpdfdatasI tzz??DMMO II  & Q<<!Ar9c0XlUR5 g)zHaccepts a 2-tuple in points for paper size for this and subsequent pagesN)rrrrs r7rCanvas.setPageSize!s r9cUR5nURS5(aUSSnUS;a[SU-5e[USU-U5 g)zMaccepts a 2-tuple in points for name+'Box' size for this and subsequent pagesrN)rrrrzunknown box name: %rr)rendswithrPr)rrrs r7 setCropBoxCanvas.setCropBox'sPzz| ==  Sb  4 43d:; ;X_d+r9c$URUSS9 g)Nrrrrs r7 setTrimBoxCanvas.setTrimBox/s &)r9c$URUSS9 g)Nrrrrs r7 setArtBoxCanvas.setArtBox2s %(r9c$URUSS9 g)Nrrrrs r7 setBleedBoxCanvas.setBleedBox5s '*r9c0US-S:XdS5eXlg)z7Instruct display device that this page is to be rotatedgV@rgz)Rotation must be a multiple of 90 degreesN)r)rrots r7setPageRotationCanvas.setPageRotation8s TzS M"MM  r9c~[U5nUS:XaURU5nURRU5 g)zintroduce the literal text of PDF operations s into the current stream. Only use this if you are an expert in the PDF file format.rN)rNrZrr/)rrYescapeds r7 addLiteralCanvas.addLiteral=s3 F A: QA !r9cURupp4pVX-X2-- nXG- nU*U- n X6-XE-- U- n X- n U*U- n XR-Xa-- U- n URXXX5 g)aI want to draw something (eg, string underlines) w.r.t. the default user space. Reset the matrix! This should be used usually as follows:: canv.saveState() canv.resetTransforms() #...draw some stuff in default space coords... canv.restoreState() # go back! N)r' transform)rselfaselfbselfcselfdselfeselffdetresultaresultcresulteresultdresultbresultfs r7resetTransformsCanvas.resetTransformsJs~6:5H5H2uUkEK')&*;,c1)&*;,c1 w7Lr9c [(aMURupxppXq-X--X-X--Xs-X--X-X--Xu-X--U -X-X--U -4UlUR(aURSSSS:XaURSR5n [ [ [ U SS55upxpp[U 5S:=(a [U 5S-=(d SnU[Xq-X--X-X--Xs-X--X-X--Xu-X--U -X-X--U -5-URS'gURRS[XX4XV5-5 g) zdadjoin a mathematical transform to the current graphics state matrix. Not recommended for beginners.rhrNz cmiz %s cmz%s cm) ENABLE_TRACKINGr'rsplitrLmaprlrMrKr r/)rrbr@rAer%a0b0c0d0e0f0rrYs r7r Canvas.transform^sf ? $ 3 3 B"#%49bd#%49bd#%49R<bd2#?D  ::$**R.-u4 2$$&A%)#eAbH*=%> "BBBAq.T!Wh.9'ART "$rt)BDIbd24iPRPTUWUYPYZ\P\]_]abdbf]fgi]i!jjDJJrN JJ  gq1q(;; 6"""+IK r9c[R"URS9RXX4XV5 UR SS5 g)zDraw a partial ellipse inscribed within the rectangle x1,y1,x2,y2, starting at startAng degrees and covering extent degrees. Angles start with 0 to the right (+x) and increase counter-clockwise. These should have x1>%ABC Dr9c[R"URS9RXX1- XB- 5 UR XV5 g)zDraw an ellipse defined by an enclosing rectangle. Note that (x1,y1) and (x2,y2) are the corner points of the enclosing rectangle. rlN)rrmrellipsero)rrIrJrKrLrurvs r7ryCanvas.ellipses7   djj199""%O F)r9c [R"URS9n U RSX--SX$--5 U R XX4XV5 U R 5 UR Xx5 g)z[Like arc, but connects to the centre of the ellipse. Most useful for pie charts and PacMan!rlrN)rrmrmoveToarcToclosero) rrIrJrKrLrprqrurvps r7wedge Canvas.wedgesY  $ $$** 5 beS"%[) bH,   F(r9cJX- nX-nX#- nX#-n URXhXyXE5 g)zNdraw a cirle centered at (x_cen,y_cen) with radius r (special case of ellipse)N)ry) rx_ceny_cenrrurvrIrKrJrLs r7circle Canvas.circles0Y Y Y Y RRV2r9c[R"URS9RXX4U5 UR Xg5 g)ztDraws a rectangle with rounded corners. The corners are approximately quadrants of a circle, with the given radius.rlN)rrmr roundRectro)rrcrGrrEradiusrurvs r7rCanvas.roundRect s4   djj1;;A%QWX F(r9cXURRU5nX RU'U$r=)r addShadingrrshadingrs r7 _addShadingCanvas._addShading's)yy##G,"&$ r9cbURU5nURRSU-5 g)Nz/%s sh)rrr/rs r7shade Canvas.shade,s(( (T/*r9c SSKJn [U5up[X5n U"XX4U U [ U5S9n UR U 5 g)Nr)PDFAxialShadingFunction ColorSpaceExtend)r+rrYrxrr) rrar`rIrJrTrprr colorSpacencolorsfcnrs r7linearGradientCanvas.linearGradient0sD<.v6 !'5!""3%.@.HJ 7r9c SSKJn [U5up[X5n U"XSXX:U[ U5S9 n UR U 5 g)Nr)PDFRadialShadingrgr)r+rrYrxrr) rrcrGrrTrprrrrrrs r7radialGradientCanvas.radialGradient9sF=.v6 !'5"1aF%.@.HJ 7r9c [X6URURUS9up9URXUS9n UbU R U5 U(aU R U5 U(aU R U5 U RU5 U(aU R S5 U(aU R S5 UbU R S5 URU 5 g)z*Draws a string in the current text styles.fontNamerYshaping directionNr) rr#r$ beginTextsetTextRenderMode setCharSpace setWordSpacetextLinedrawText rrcrGrVmode charSpacer wordSpacerrrs r7 drawStringCanvas.drawStringLs$TT^^UYUcUcmtu  NN19N 5  Q006 annY/ annY/ 4 annQ' annQ'  Q003 ar9c ^[X6URURUS9up9U(aU [U5S- U-- n U(a+XR S5UR S5-S- U-- n UR X- U5n UbU R U5 U(aU RU5 U(aU RU5 U RU5 U(aU RS5 U(aU RS5 UbU R S5 URU 5 g)z2Draws a string right-aligned with the x coordinaterrrG Nr rr#r$rMrrrrrrrrs r7rTCanvas.drawRightStringZs$TT^^UYUcUcmtu  eD ! Y66e e 4 0G1D DQ F QQe NN19a (  Q006 annY/ annY/ 4 annQ' annQ'  Q003 ar9c f[X6URURUS9up9U(aU [U5S- U-- n U(a+XR S5UR S5-S- U-- n UR USU -- U5n UbU R U5 U(aU RU5 U(aU RU5 U RU5 U(aU RS5 U(aU RS5 UbU R S5 URU 5 g)z_Draws a string centred on the x coordinate. We're British, dammit, and proud of our spelling!rrrGrrNrrrs r7drawCentredStringCanvas.drawCentredStringis%TT^^UYUcUcmtu  eD ! Y66e e 4 0G1D DQ F QQe NN1s5y=! ,  Q006 annY/ annY/ 4 annQ' annQ'  Q003 ar9c LURUS5n URX@RUR5n [ U 5S:Xa[ R U5byUS[;alU SSSn U SSn U S[;aU SU -n U SSn U S[;aMURUSU -- X,XVXxU S9 URUSU -- X-XVXxU S9 gU Sn URUSU -- X,XVXxU S9 [ U 5S:a!XJS-n URUSU -- X-XVXxU S9 gg)aTDraws a string aligned on the first '.' (or other pivot character). The centre position of the pivot character will be used as x. So, you could draw a straight line down through all the decimals in a column of numbers, and anything without a decimal should be optically aligned with those that have. There is one special rule to help with accounting formatting. Here's how normal numbers should be aligned on the 'dot'. Look at the LAST two:: 12,345,67 987.15 42 -1,234.56 (456.78) (456) 27 inches 13cm Since the last three do not contain a dot, a crude dot-finding rule would place them wrong. So we test for the special case where no pivot is found, digits are present, but the last character is not a digit. We then work back from the end of the string This case is a tad slower but hopefully rare. rNrhrr)rrrrr) r stringWidthr#r$rMdigitPatsearchrrTr)rrcrGrV pivotCharrrrrrpartspivWleftText rightTexts r7drawAlignedStringCanvas.drawAlignedStringzse8 9Q' >>4>>J u:?xt4@T"XU[E[Qx"~Ha I2,f,$RL94 #Ab>2,f,  3t8Qt'g ! O OOAc$hJ4'g  O QxH  3t8Qt'g ! O5zA~%a0 #d( At"+' Sr9c:URR5nU$)zsReturns the list of PostScript font names available. Standard set now, but may grow in future with font embedding.)rgetAvailableFonts)r fontnamess r7rCanvas.getAvailableFontssII//1 r9ct[[RR55nUR 5 U$)z-Convenience function to list all loaded fonts)rLr widthsrXrn)rnamess r7listLoadedFonts0Canvas.listLoadedFonts0s)Z&&++-.  r9c XlX lUcUS-nX0l[R"UR5nUR (dUR R(d[USS5(dVURRU5nURRSU<S[U5<S[U5<S35 ggg) zSets the font. If leading not specified, defaults to 1.2 x font size. Raises a readable exception if an illegal font is supplied. Font names are case-sensitive! Keeps track of font name and size for metrics.NrrHFzBT rGz Tf z TL ET)r#r$r&r rLrMrNrOrPrrQrr/r )r psfontnamerleadingrU pdffontnames r7setFontCanvas.setFonts $ ?SjG !!$..1  yy  5Fu(M(M"ii;;JG  !!KPTW]^eWf"gh)N!r9cxUc URnUc URnURURX5 g)z7Sets font size or leading without knowing the font faceN)r$r&rr#)rrrs r7rSCanvas.setFontSizes. < ?dmmG T^^T3r9cv[R"X=(d URX0R4USL5$)z1gets width of a string in the given font and sizeN)r rr#r$)rrVrrYs r7rCanvas.stringWidths6%%d,F%-nn$=h$>N$OQ Qr9c^XlURRS[U5-5 g)Nz%s w)r4rr/r )rrs r7rCanvas.setLineWidths" &6%=01r9cfUS;dS5eXlURRSU-5 g)z0=butt,1=round,2=squarerrr`z*Line caps allowed: 0=butt,1=round,2=squarez%d JN)r1rr/rrs r7 setLineCapCanvas.setLineCaps/wL LL  &4-(r9cfUS;dS5eXlURRSU-5 g)z0=mitre, 1=round, 2=bevelrz-Line Joins allowed: 0=mitre, 1=round, 2=bevelz%d jN)r2rr/rs r7 setLineJoinCanvas.setLineJoins/wO OO &4-(r9c^XlURRS[U5-5 g)Nz%s M) _miterLimitrr/r )rlimits r7 setMiterLimitCanvas.setMiterLimits#  &6%=01r9cSn[U[[45(aX4nSnO[U5(dSnUVs/sH(n[U[[45(aUS:dM&UPM* nnU(d![U[[45(aUS:aSnOU(a[ U5S::aSnU(a[ SU<SU<SU<35eUR RS [U5<S U<S 35 g s snf) z7Two notations. pass two numbers, or an array and phaserz1array should be a sequence of numbers or a numberz,array & phase should be non-negative numbersz%dash cycle should be larger than zerozsetDash: array=z phase=r[z] z dN) rGintrlrsumrPrr/r )rarrayphasereasonrbads r7setDashCanvas.setDashs eSK ( (NEEuHFJ%Qz!SK'@'@AEq%J jE{33uQwCF s5z1}?Ks %C:#C:c,[R"5$)zReturns a fresh path object. Paths are used to draw complex figures. The object returned follows the protocol for a pathobject.PDFPathObject instance)rrmrs r7 beginPathCanvas.beginPaths''))r9cUc[USUR5nURR[ UR 555 UR X#U5 g)z*Draw the path object in the mode indicatedNr))rPr)rr/rNgetCodero)raPathrurvfillModes r7drawPathCanvas.drawPath sG  u[@H #emmo./ F1r9cjURR[XUbUO UR45 gr=)rr/rtr))rrurvrs r7roCanvas._strokeAndFills, (6X=QW[WeWe#efgr9cUc[USUR5nUR5n[X#U4nU[:H=(a S=(d SnU<U<U<3nUR R U5 g)zclip as well as drawingNr)z W* z W )rPr)rrtr(rr/) rrrurvrgcpathopsclipitems r7clipPathCanvas.clipPathse  u[@H ]]_x1G(HgM)4f=tW- $r9c[XX#S9$)zdReturns a fresh text object. Text objects are used to add large amounts of text. See PDFTextObjectr)r)rrcrGrs r7rCanvas.beginTextsTa==r9chURR[UR555 g)zDraws a text objectN)rr/rNr)r aTextObjects r7rCanvas.drawText$s" #k11345r9cUc[RnXlURR UR5 g)aPossible values None, 1 or 0 If None the value from rl_config will be used. If on, the page data will be compressed, leading to much smaller files, but takes a little longer to create the files. This applies to all subsequent pages, or until setPageCompression() is next called.N)r rrrr)rrs r7rCanvas.setPageCompression(s2  "i6O6OO /   !6!67r9cXlg)aAllows hands-off animation of presentations :-) If this is set to a number, in full screen mode, Acrobat Reader will advance to the next page after this many seconds. The duration of the transition itself (fade/flicker etc.) is controlled by the 'duration' argument to setPageTransition; this controls the time spent looking at the page. This is effective for all subsequent pages.N)r)rdurations r7setPageDurationCanvas.setPageDuration3s &r9c0UlU(dgUS;aSSU-4nO[R"S5eUS;aSSU-4nO[R"S 5eUS ;aS SU-4nO[R"S 5eXh/U/U/U//U/S .n Xn 0n SU S'SU-U S'SU-U S'U H upXU 'M Xlg![a [R"SU-5ef=f)aPDF allows page transition effects for use when giving presentations. There are six possible effects. You can just guive the effect name, or supply more advanced options to refine the way it works. There are three types of extra argument permitted, and here are the allowed values:: direction_arg = [0,90,180,270] dimension_arg = ['H', 'V'] motion_arg = ['I','O'] (start at inside or outside) This table says which ones take which arguments:: PageTransitionEffects = { 'Split': [direction_arg, motion_arg], 'Blinds': [dimension_arg], 'Box': [motion_arg], 'Wipe' : [direction_arg], 'Dissolve' : [], 'Glitter':[direction_arg] } Have fun! N)rZr4iDiz/%dz$ directions allowed are 0,90,180,270)HVDmrz$dimension values allowed are H and V)IOMz!motion values allowed are I and O)SplitBlindsrWipeDissolveGlitterzUnknown Effect Name "%s"z/Transrz%dr0r$)rr PDFErrorKeyError)r effectnamerr dimensionmotion direction_arg dimension_arg motion_argPageTransitionEffectsargs transDictrfvalues r7rCanvas.setPageTransition?s)< "   &!59#45M//"HI I  "!3?3M//"HI I Y sV|,J//"EF F$0$o<#_$o ! K(4D  $ & #z) # LS"cN!( K//"&3o 5B#9  U @Ar9cUR$![a= SSKJn U"U5=URRlUlURs$f=f)z/get form from canvas, create the form if neededr)AcroForm)rYrreportlab.pdfbase.acroformrr)rrYs r7acroFormCanvas.acroFormsJ !==  ! ;:B4. HDII   '$-==  !s AAAcP[U[[[45=(d [U[5nSnSnU(a[ US5n U S:gnOV[U[ 5(aAU(a:[ URS5n U S:gnU(aURnURnU(aPUR5 URW 5 US:aURU5 U(aURU5 URX#XE5 U(aUR5 gg)z9draw a boundary as a rectangle (primarily for debugging).rhNr)rGrNrIrLrrrr1rr3rrJrrrr) rsbrIrJrrEssrydar@s r7rWCanvas.drawBoundarys Cd+ , D 2e0D   2AbB , - -"$AbBHH\\ NN     "!tT&&q)4<<# "% t  "2r9)>rYrrrrr*rrrrrr'rrrrr9rr7r)r#r$rerrr,rrrr&r1r3r2r4rr5rrrrrrrrrSrrr.rr8r/r0r%r-rrr+r!r"rrr)NrNNrNNNNNNNNNNNN)rN)r NNNNN)rr )NNFr@FFN)NNNFr@FFN)rrNN)r)r)NrNr)NNrNr)NrNrNN)NrNrrNN)rrNNrr)r)rNNNrE)rr)rr)NT)NrNNFr=)NN)rrN)rrN)Nrrrr)NNN)rrrr__doc__rrrr?rDrr=rLrkrM STATE_RANGErrZr]rargrnrqrtrxr|rrrrrrrrrrrrrrrrrrrr'r+r1r7r:rDrbrrirrsr|rrrrtextAnnotation0rrinkAnnotation0rrrrrrrrrrrrrrrrr r.rrr6r=rrrMrr[rbrirnrryrrrrrrrrrTrr decimalSymbolrrrrrSrrrrrrrrrorrrrrrr.r7r=r@rCrGrKrQpropertyr[rWrr>r9r7rrs/d!%! #'!%!% $#_!B.&>55#$)57uS!1234K.*$24Ll8&" & & (($) , ) )))5)Sj++." !  KZ KC &'=AQV/2DHRW|-| # 3$2%)N(b Z %O=AI[gh!%r$b#NSW/3M&_`/3 Q"!H%) 3 ,*)+! M(="& $ *6 2N  "  !D *)3) +&  "7@6M6MTXdequBFPU6Sp i 4 Q2) ) 2a@&* 2h > 6 8 &;<9<H)T%96-.' B!!#r9__main__zFor test scripts, look in tests)rr)> __version__rc__all__rrerstringrmathrrr r reportlabr reportlab.pdfbaser r reportlab.pdfbase.ttfontsrrreportlab.pdfgenrreportlab.pdfgen.textobjectrrrreportlab.lib.colorsrrrrrreportlab.lib.utilsrrrrrrreportlab.lib.abagrreportlab.lib.rl_accelr r!reportlab.lib.boxstuffr"compilerr( FILL_NON_ZEROrtr8rOrYrxrzrrrrprintr>r9r7r|s>      ""$(>(VV[[ZZ#41 ::e   = !C = !C = !C = !C = !D = !C = !D = !C '&2 #OJGGR888y#_y#v7 z +,r9