+ vjSERtRtRR.t^t^RIt^RIt^RIHt^RIH t H t H t H t ^RI Ht^RIHt^R IHt^R IHtHt^R IHt^R IHtHtHt^R IHtHtHtHtH t ^RI!H"t"H#t#H$t$H%t%H&t&H't'^RI(H)t)^RI*H+t+H,t,^RI-H.t.]P^!R4t0^t1^t2^^]13R^^]23R^^]13R^^]23R^^]13R^^]23R^^]13R^^]23R/t3R$Rlt4Rt5Rt6Rt7!RR4t8Rt9!R R4t:!R!R]4t;]?#q)..q1  MM(9- .v&( c.a\V\4'd^VPoR\;QJd&.V3RlVP 44FNK 53#!V3RlVP 4443#\V\ 4'dRVP 43#\V\\34'd#\V4pV^8XdRV3#V^8XdRV3#M*\V\4'd\\V44#\RV,4h) DeviceCMYKc34<"TF qS,xK R#5iN).0cds& r6 "_normalizeColor..Ls"> 1Q33 s DeviceRGBzUnknown color %r) isinstancerdensitytuplecmykrrgblistlenstr_normalizeColorr ValueError)aColorlr@s& @r6rLrLIs&)$$ NNUU"> ">U>>U"> ">>>> FE " "FJJL(( FUDM * * K 6& & !V' ' FC wv// '&0 11r8cRp.pVF@p\V4wrEVeW8wd\RV: RV: 24hTpVPV4KB W3#)NzMismatch in color spaces: z and )rLrMr.)colorsspace outcolorsrNnspaceoutcolors& r6_normalizeColorsrVYs[ EI*62  eVTU U"   r8c ^RIHpHpVe%\V4\V48wd \ R4h\V4^8XdV!^V^,V^,R7#\V4^8Xd:VeV^,^8Xd(V^,^8XdV!^V^,V^,R7#Vf>\V4p\ V4Uu.uFp\ V4V^, , NK ppM\\W44pVPRR7V^,^,^8wd#VP^RV^,^,34VR ,^,^8wd"VPRVR ,^,34\\V!4wr.pV^R Uu.uFqNK p p.p V^,p VR,F@p VPV!^WR74T p V PR4V PR4KB V!WyV R R 7#uupiuupi) r&)PDFExponentialFunctionPDFStitchingFunctionz4need to have the same number of colors and positions)NC0C1cV^,#r&r=)xs&r6%_buildColorFunction..vsQqTr8)key?:NNz [0.0 1.0])Domain) r*rXrYrJrMrangefloatrIzipsortinsertr.) rQ positionsrXrYncr_ poscolors functionsposboundsencode lastcolorr0s && r6_buildColorFunctionrudsUY3v;!>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 ?"H H c a]tRt^to]!^^RR^RR7t]!0RmR7tR0t]R4t ]R4t ]R4t R t R t R tR tR tRtVtR#) ExtGStateFNormal)CAcaOPopOPMBM)r~r~c4\V4P4#r<)rKlowervs&r6_boolTransformExtGState._boolTransforms1v||~r8cV#r<r=rs&r6_identityTransformExtGState._identityTransformsr8cRV,#)/r=rs&r6_pdfNameTransformExtGState._pdfNameTransforms 1u r8c"/Vn/VnR#r<)_d_cselfs&r6__init__ExtGState.__init__sr8c VPV,p\V\4'd\V4pVPpMhW P9dMW0P V,9d)\ RV: RV: RVP V,: 24hVPpM VPpW0PPW$48wgVR8XdVPR4V8wdW0PV&W%!V43pW`P9dVPV,pM3R\\VP44,pWpPV&VPP!RV,4R#R#R#)z ExtGstate[z] = z not in allowed values r|r{gRLsz/%s gsN)defaultsrDboolr pdfNameValuesallowedrMrrrgetgetValuerrKrJ_coder.)rcanvarr@ vTransformtnames&&&& r6set ExtGState.sets MM!  a  1gA,,J $$ $ Q' a Q")**//J00J ggkk! 1d7t}}T/BA/EGGAJ*Q-AGG|wwqzc#dgg,//! JJ  ho .0F7r8cZVPPWPV,4#r<)rrr)rrs&&r6rExtGState.getValuesww{{1]]1-..r8c/pVPP4F'wr#\P!\ V344W&K) T;'d\P!V4;'gR#r<)ritemsr PDFDictionarydict)rr"rrs& r6getStateExtGState.getStatesV ggmmoFA**4:6AG&,,V))!,444r8c VP4pVPP4VnVPVnV#)z=the states must be shared across push/pop, but the values not) __class__rcopyr)rr_s& r6pushCopyExtGState.pushCopys/ NN ww||~wwr8)rrN>HuerDarkenrxScreenLightenOverlayMultiply ColorBurn Exclusion HardLight SoftLight ColorDodge Difference Luminosity Saturation)__name__ __module__ __qualname____firstlineno__rrrr staticmethodrrrrrrrr__static_attributes____classdictcell__ __classdict__s@r6rwrws HGFM/,/5 r8rwc\V\\34'dE\V4^8wd\ RV,4hRVUu.uFq'dRMRNK up,#V'dR#R#uupi)z wrong length for extend argumentz[%s %s]truefalsez [true true]z [false false])rDrIrFrJrM)extend_s& r6_gradientExtendStrrsc&$u&& v;>?&HI IfEfaFW4fEEE"=77FsA-c0a]tRt^toRRltRtRtVtR#)rNc*WnW nW0nR#r<)r0widthr2)rr0rr2s&&&&r6rShowBoundaryValue.__init__s  "r8cLVPRJ;'dVP^8#r<)r0rrs&r6__bool__ShowBoundaryValue.__bool__s!zz%77$**a-7r8)r0r2r)r&r&r&g?N)rrrrrrrrrs@r6rrs# 88r8cTa]tRt^toRtRRltRtRtRtRt RP4t ] !] !]!] 444tR tR tR tR tRR ltRtRtRtRtRtRtRtRtRtRtRtRt Rt!Rt"Rt#Rt$Rt%Rt&R t'R!t(R"t)R#t*R$t+R%t,RR&lt-RR'lt.R(t/R)t0R*t1RR,lt2RR-lt3R.t4R/t5R0t6RR1lt7R2t8RR3lt9RR4lt:RR5lt;RR6lt<]RR8lt?]?t@RR9ltARR:ltBRR;ltCRR<ltDR=tER>tFR?tGR@tHRAtIRRBltJRCtKRDtLREtMRFtNRRGltORHtPRItQRJtRRKtSRLtTRMtURNtVROtWRPtXRQtYRRtZRRSlt[RTt\RUt]RRVlt^RRWlt_RRXlt`RRYltaRRZltbRR[ltcR\tdR]teRR^ltfRR_ltgRR`lthRRaltiRRbltj]kPR^RRR+3RcltmRdtnRetoRRfltpRRgltqRRhltrRitsRjttRktuRltv.^3RmltwRntxRRoltyRRpltzRRqlt{RRrlt|Rst}RRtlt~RRultRRvltRwtRxtRytRztR{tR|tR}tRR~lt]R4tRtRtRtRtVtR#)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() Nc zVf\PpVf\PpV 'dT M\PVnV eT M^ VnV eT MVP R,VnWn\P!TYQT ;'g\PVR7Vn \V 4Vn W`nRVnWnW nRVn^VnRVnRVn/VnVP/V4^Vn.VnVP54^Vn.Vn.Vn.VnW0n\P@Vn!Wn"Wn#VVn$VVn%VPM4VPO4.Vn(VPSV4/Vn*R#)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. N333333?) compression invariantfilename pdfVersionlang)+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_namedCB)rrpagesizerpageCompressionr verbosityencrypt cropMarksrenforceColorSpaceinitialFontNameinitialFontSizeinitialLeadingcropBoxartBoxtrimBoxbleedBoxrkwdss&&&&&&&&&&&&&&&&&&&,r6rCanvas.__init__sF   (A(AX  )*=*=i3B HeHe3B3NTV1?1K~QUQfQfgjQj!&&?1:2<2Z2Z@Z@Z,0) #;;L"M$ #!!%#! 0 !!# !%'"$&!! %99   !   "    r8c V'd^RIHp\V4'dF\V4'dVP R4pVP V4pVP ^4M-\WP 4'g\RV,4hWPn R#VP= R# \dR#i;i)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. ) pdfencryptutf-8zjExpected string or instance of reportlab.lib.pdfencrypt.StandardEncryption as encrypt parameter but got %rN) reportlab.librrrrsStandardEncryptionsetAllPermissionsrD TypeErrorrrAttributeError)rrrs&& r6rCanvas.setEncryptvs  0W~~W%%%nnW5G$77@))!,)F)FGG!MPW!WXX 'II  II%!  s% B33 CCc^Vn^VnVPVnVPVn^VnVPVnRVn \Vn ^Vn ^Vn ^dVn^Vn^VnRVnRVn^Vn^VnRVn^Vn^Vn\0P2;'gR;VnVn\94VnR#)r&N)rdrcrcrdrcrcr)_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_strokeColorObjrw _extgstaters&r6rCanvas.init_graphics_states....,, 6&  73 4=4N4N4Y4YRYYT1#+r8c/pVPpVPF pW#,W&K VPPV4VPP 4VnR#r<)__dict__STATE_ATTRIBUTESrr.r6r)rstater@rs& r6push_state_stackCanvas.push_state_stacksQ MM))D'EK* &//224r8clVPPVPP44R#r<)r9updaterpoprs&r6pop_state_stackCanvas.pop_state_stacks# T--1134r8a_x _y _fontname _fontsize _textMode _leading _currentMatrix _fillMode _charSpace _wordSpace _horizScale _textRenderMode _rise _textLineMatrix _textMatrix _lineCap _lineJoin _lineDash _lineWidth _mitreLimit _fillColorObj _strokeColorObj _extgstatec$.PpVP'd V!R4M)V!R\VP^,4,4VPp\ V4pVP R8wdVPVP 4VPR8wdVPVP4V!RPW#R44W#R1\P!VP4pVP'gbVPP 'g\#VRR4'g3V!RVP$P'VP4,4RPVP(4VnR#)z1 0 0 1 0 0 cmz1 0 0 -1 0 %s cm N_drawTextAsPathFzBT %s 12 Tf 14.4 TL ETr)r.rrrrrJr4 setFillColorr5setStrokeColorjoinr getFontr  _dynamicFontfacebuiltIngetattrrgetInternalFontName__self__ _preamble)rPr(r!fonts& r6rCanvas._make_preambles II ===    6$..*;#<< = JJ F    (   d00 1   7 *    4 4 5 #((1R5/ bE!!$..1   yy   5Fu(M(M*TYY-J-J4>>-ZZ[!**-r8c\V4#r<)rrss&&r6_escapeCanvas._escapes |r8c <VPPV4R#)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&&r6rZCanvas.setAuthors F#r8c <VPPV4R#)zHaccepts a func(yyyy,mm,dd,hh,m,s) used to create embedded formatted dateN)rsetDateFormatter)r dateFormatters&&r6r^Canvas.setDateFormatters ""=1r8c TVPPPW#WR7R#)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)rtitlerblevelrbs&&&&&r6rdCanvas.addOutlineEntrys"h ))#e)Kr8c ^VPPP!V3V,!R#)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)rrcsetNames)rnametrees&*r6setOutlineNames0Canvas.setOutlineNames0s#" ""dWX%57r8c <VPPV4R#)zXwrite a title into the PDF file that won't automatically display in the document itself.N)rsetTitle)rres&&r6rnCanvas.setTitle,s 5!r8c <VPPV4R#)zZwrite a subject into the PDF file that won't automatically display in the document itself.N)r setSubject)rsubjects&&r6rqCanvas.setSubject1s W%r8c <VPPV4R#)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&&r6ruCanvas.setCreator6s W%r8c <VPPV4R#)z!change the default producer valueN)r setProducer)rproducers&&r6ryCanvas.setProducer<s h'r8c \V\\34'dRPV4pVPP V4R#)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)rDrIrFrHr setKeywords)rkeywordss&&r6r}Canvas.setKeywords@s5 hU| , ,yy*H h'r8c 2\VP4^8H#)zHInfo function - app can call it after showPage to see if it needs a save)rJrrs&r6 pageHasDataCanvas.pageHasDataGs4::!##r8c NVPPP4R#)zSpecify that Acrobat Reader should start with the outline tree visible. showFullScreen() and showOutline() conflict; the one called last wins.N)r_catalog showOutliners&r6rCanvas.showOutlineKs &&(r8c NVPPP4R#)zSpecify that Acrobat Reader should start in full screen mode. showFullScreen() and showOutline() conflict; the one called last wins.N)rrshowFullScreenrs&r6showFullScreen0Canvas.showFullScreen0Qs ))+r8c vVPPR4VPPVRV4R#)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). transparencyryNrensureMinPdfVersionr6rrrs&&r6_setStrokeAlphaCanvas._setStrokeAlphaW, %%n5 Da(r8c vVPPR4VPPVRV4R#)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). rrzNrrs&&r6 _setFillAlphaCanvas._setFillAlphabrr8c@VPPVRV4R#)r{Nr6rrs&&r6_setStrokeOverprintCanvas._setStrokeOverprintm Da(r8c@VPPVRV4R#)r|Nrrs&&r6_setFillOverprintCanvas._setFillOverprintprr8chVPPTRT;'d ^;'g^4R#)r}Nrrs&&r6_setOverprintMaskCanvas._setOverprintMaskss$ DqwwQ||!4r8c@VPPVRV4R#)r~Nrrs&&r6 setBlendModeCanvas.setBlendModevrr8cVPpV'dA\^\VR^44p\^\VR^$44pV'd W2,pV#R#)r& bleedWidth borderWidthN)rmaxrM)rcMbleedWbws& r6 _getCmShiftCanvas._getCmShiftysL __ 72l156FQwr-34B I r8c VP^,pVP^,pVPpVPpV'Ed\^\ VR^$44pV'Edj\ VR^4p\ V\^\ VR^444p\ VRR4p\ VR\ 4p ^V,V, p \V4p V'EdV 'EdVP4VPV 4VPV4VPV^WW3W,^W,V3WRV ,WR^V,,3W,W*,W,V^V,,3^WWV3W,WQ^V,,V3^W%,WrV,3W,W%,V^V,,W%,3.4VP4V'dWKRp WKR1\V4p \^\ VR^44p VP4VPW], W], 4V 'd=VP^R V ,V, ,^R V ,V, ,4WKRpWKR1WR &VP4V'dVPX 4^V,V,p^V,V,pVP!R 4\"P$!4pWnW/nVP*VnVP.VnVP3VP44VP7VP84RFWp\ VR V,R4pV'gK!\;VVP=4R ,\"P>!V44KY VP@eVP@Vn!VPDVPF.,V,VPH,pVPKV4VPMV4VPOV4VPQV4VPSV4VPUV4VPVPYV4VPZ'dVP[VP\4VP_4R#)z8Close the current page and possibly start on a new page.rmarkLast markLength markWidth? markColorNrg@:r&r&NrD_%sBoxBox)cropartbleedtrim)0rrrrrMminrrJ saveStaterG setLineWidthlines restoreState translatescalerr.r PDFPage pagewidth pageheightrRotate_currentPageHasImages hasImagessetPageTransitionrsetCompression_pageCompressionsetattr capitalizer'rDurrrPr setStream_setColorSpace _setExtGState _setXObjects_setShadingUsed_setAnnotationsraddPagerr _startPage)r pageWidth pageHeightrcoderrmlmwmcmgcx0Lrr(pageboxsizestrms& r6showPageCanvas.showPages NN1% ^^A& __zz 2Qwr-34Br"2j3C'"\""=>?R C0R E2rT"W$i2""NN$''+%%b)JJAb "a R8rM""_="jmILAbDQ2 "b1R4;:=rM:"jmIadN:=Q  %%'!J J!$iQwr,q9: ry3JJq#f*i!773v:z:Q8QRJJS !!#KKNbD9, rTJ.  C~~"$(( 33 t334 D1120C4 T2DtS^^-e3FOOD4IJ1    )))DH**dnn-==DtG`G`` t D! 4  $ T" T" $ <<<d&6&67 r8cVP'd#VPVP4RVnV;P^, unVP4VP 4.VnR#r<)r setPageSizerrrrrs&r6rCanvas._startPages[  ! ! !   T33 4%)D " A !!#   "r8c WnR#)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&&r6setPageCallBackCanvas.setPageCallBacks  r8c(VPVnR#r<)_annotationrefsAnnotsrrs&&r6rCanvas._setAnnotationss** r8c(VPVnR#r<) _colorsUsedrobjs&&r6rCanvas._setColorSpaces**r8c(VPVnR#r<) _shadingUsedrs&&r6rCanvas._setShadingUseds --r8c VPpV'd$VPPV4pW1nR#RVnR#)zKfor pages and forms, define the XObject dictionary for resources, if neededN) _formsinuserxobjDictXObjects)rthingforms xobjectsdicts&& r6rCanvas._setXObjectss0   99--e4L)N!ENr8c pVPpW!,# \P!T4;q2T&T#;i)zDget a reference to a (possibly undefined, possibly unbound) bookmark)rr Destination)rrr@results&& r6_bookmarkReferenceCanvas._bookmarkReferences<    87N 8%11$7 7FtW s5c VPV4pVPP4VPP4p VfRpVfRpVfRpVfRpVfRpVR8XdVP W4V4MVR8XdVP 4MVR8XdVP V4MVR8XdVPV4MVR8XdVPW5Wd4MeVR8XdVP4MMVR8XdVPV4M4VR 8XdVPV4M\R \V4,4hVPV 4V#) 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 thisPageRefxyzfitfithfitvfitrfitbfitbhfitbvrMasciisetPage) rrbrlefttopbottomrightzoomdestpagerefs &&&&&&&& r6 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 r8c *VPWW#^R7#)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.)rrrr)r!)rrbrrrkws&&&&&,r6bookmarkHorizontalAbsolute!Canvas.bookmarkHorizontalAbsolutePs  3 JJr8c VVPW#4wrVVP!W3RV/VBR#)z (TYY%=%=d%CCD %r8c 8VPPV4#)z*Query whether form XObj really exists yet.)rhasFormr0s&&r6r4Canvas.hasFormssyy  &&r8Fc  ^Vn^RIHp V !WW4V4p V PVVWxV V R7V PV P 3#)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. )PDFImage)preserveAspectRatioanchor anchorAtXY showBoundary extraReturn)rreportlab.pdfgen.pdfimagesr7drawInlineImagerheight) rimager_yrr?r8r9r:r;r<r7img_objs &&&&&&&&&&& r6r>Canvas.drawInlineImage|sR &'"75Af5 3\#  % w~~..r8c  ^Vn\V\4'd|VP4p VPp VR8XdV 'dV P4pM \ V4p\ V4'dVPR4p\W,4pM5V: V: 2p\ V4'dVPR4p\V4pVPPV4pVPPPVR4pV'Eg!\P!WVR7pVVnVP!V4VPP#VV4VPP%VV4\'VRR4p V 'dVPPV P4pVPPPVR4pV'g4VP!V 4VPP#V V4VnM\P*!V4VnV=\/WxW#WEVP0VP2V 4 wr#rEpVP54VP7W#4VP9WE4VP:P=RV,4VP?4V 'dVPAWW4V4VPBP=V4V 'd,V PE4Fp\G4V,V V&K VP0VP23#)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.autoutf8rN)mask_smaskr.)$rrDr getRGBData_dataArKrrsrrr/ idToObjectrr PDFImageXObjectrr ReferenceaddFormrMsmaskPDFObjectReferencerHr rr?rrrrr.r drawBoundaryrkeysvars)rr@r_rArr?rGr8r9r:r;r<rawdatarOmdatarrVregNameimgObjmRegNamemImgObjscaledks&&&&&&&&&&&& r6 drawImageCanvas.drawImages|&'" eK ( (&&(GLLEV|((*D  V,W]+D &A||HHW%QtO_aearDJ(*D %)+D &)*D &!D #%D !DN!D  "D r8c &VPVPVPVPVPVP 3pVP PV4.Vn^Vn.Vn.VnRVn/Vn/VnR#)zVwhen you enter a form, save accumulator info not related to the form for page (if any)N) rrrr_rrrr.r)rsaveds& r6_pushAccumulatorsCanvas._pushAccumulators"s~T--t/C/CT^^UYUeUegkgxgxy u% %&"!r8cDVPP4VnR#r<)r6rrwrs&&r6rCanvas._setExtGState.s002 r8c VP4VP4VP'gVP'dVP 4WW4V3VnVP P 4R#)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<rrr_rcrinForm)rrlowerxloweryupperxupperys&&&&&&r6 beginFormCanvas.beginForm1sY    " :::  " " $? r8c PVPwr#rEpVPwrxVfTpVfTp\P!W4WVR7p VPV nV P VP.VP,4VP4Fwr\WV 4K VPV 4VPV 4VPV 4VPV 4VPP!W)4VP#4VP%4R#)zaemit the current collection of graphics operations as a Form as declared previously in beginForm.N)rirjrkrl)r_rr PDFFormXObjectrr setStreamListrPrrrrrrrrrNrrA) rextra_attributesrrirjrkrlwhformr[rs &, r6endFormCanvas.endFormCs26.vv R >!6 >!6$$F&`00 DNN+djj89$**,DA D1 - D! 4  $ T" $% !!# r8c x\V4'd>R\P!VPR4RR7P 4,pM-R\P!VRR7P 4,pVP P V4pVP PPVR4pV'ge\P!VR,4pVPV4VP PWT4VP PW54V^8Xd$VPPRV,4MLV^8Xd$VP PRV,4M"VP"PRV,4VP$PV4R#)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. PSrF)usedforsecurityN r.)rhashlibmd5rs hexdigestrr/rKrr PDFPostScriptXObjectrrMrNrr.rrr)rcommandpositionrawNamerVpsObjs&&& r6addPostScriptCommandCanvas.addPostScriptCommand\s9$ W  W[[)@QVWaaccGW[[GQQSSG))**73 $$(($7//$?E   e $ II   / II  g - q=  & & - -h.@ A q[ JJ  h0 1  % % , ,X-? @ (r8cV'gVPwr4^^W43pMV'dVwrVrxVPWV4wrVPWx4wrVPWX4wrVPWv4wppWW3pWVV3p\V4\V4pp\V4\V4ppVVVV3pVP 4pV'd?V^,V,V^,V,V^,V,V^,V,3pV#r^)rr(rrr)rrectrelativersrtlxlyuxuyxllyllxuryurxulyulxlrylrxsysxminyminxmaxymaxrs&&& r6_absRectCanvas._absRects..CAa9D !NBB++B2GC++B3GC++B3GC++B3GC3#B3#BR#b'$DR#b'$DtT)D     72:d1gbjaDGBJ>D r8c xVPW64pVP\P!W1V3/VBWT4R#)z&DA is the default appearance string???N)r_addAnnotationr FreeTextAnnotation)rcontentsDARect addtopagerrr$s&&&&&&&,r6freeTextAnnotationCanvas.freeTextAnnotations3}}T+ F55dbOBOQUar8c vVPW%4pVP\P!W!3/VBWC4R#)z!Experimental, but works. N)rrr TextAnnotation)rrrrrrr$s&&&&&&,r6textAnnotationCanvas.textAnnotations2}}T+ F11$GBGYr8c VPW'4pV'g\P!V4pVP\P!W!W43/VBWe4R#)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 &&&&&&&&,r6highlightAnnotationCanvas.highlightAnnotationsI}}T,,,T2J F66tz_\^_aeqr8c \h)d)NotImplementedErrorrrtrsrr InkAnnotation)rrInkListrrrrr$s&&&&&&&,r6 inkAnnotationCanvas.inkAnnotations!!r8c <VP!WW4V3R^RVRVRV/V B#)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.rr1r0r2)linkRect) rrdestinationnamerrrr1r0r2r$s &&&&&&&&&,r6 linkAbsoluteCanvas.linkAbsolutesJ }}XMXYM#M+0M }}T+6 !:'=2I0""6#8#8#>2#>PPr8c z^RIHp Hp Hp Hp V !VR7p V !R4V R&V !R4V R&V !VP W#44V R&V !4pV !R4VR&V !V4pV !V4VR &VR 8XdWR &M#VR 8Xd WR &R VR&M\ RV,4hWR&\WWF4VPV 4R#)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.)rPDFNamer' PDFString)rAnnotTypeLinkSubtyperActionr"URIGoToRFz[ 0 /XYZ null null null ]r/zUnknown linkURI kind '%s'AN) r*rrr'rrrMr7r)rurlrrr1r0r2kindr$rrr'rannruris&&&&&&&&, r6linkURLCanvas.linkURLs YX$g&F  It}}T;<F  OH%& n# ;eH 7]cF0AcF84?@ @C3Y1 C r8cVP^,;q@nV'gR\V4,pVPPW!4V'dVP V4R#R#)reNUMBERN)rreprr addAnnotation _annotatePage)r annotationrrcounts&&&& r6rCanvas._addAnnotationsP(,(=(=a(??%(4;.T 1    t $ r8crVPPV4pVPPV4R#r<)r refAnnotationrr.)rrrefs&& r6rCanvas._annotatePage s*ii%%d+ ##C(r8c VP#)z9get the page number for the current page being generated.)rrs&r6 getPageNumberCanvas.getPageNumber sr8c \VP4'dVP4VPP VP V4R#)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)rJrrr SaveToFilerrs&r6save Canvas.saves1 tzz??DMMO T^^T2r8c \VP4'dVP4VPP V4p\ V4'dVP R4pV#)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)rJrrr GetPDFDatarrsrUs& r6 getpdfdataCanvas.getpdfdatasI tzz??DMMO II  & Q<<!Ar8c 2WnVP4R#)zHaccepts a 2-tuple in points for paper size for this and subsequent pagesN)rrrrs&&r6rCanvas.setPageSize"s r8c VP4pVPR4'dVRRpVR9d\RV,4h\VRV,V4R#)zMaccepts a 2-tuple in points for name+'Box' size for this and subsequent pagesrNzunknown box name: %rr)rrrr)rendswithrMr)rrrs&&&r6 setCropBoxCanvas.setCropBox(sPzz| ==  Sb  4 43d:; ;X_d+r8c,VPVRR7R#)rrNrrs&&r6 setTrimBoxCanvas.setTrimBox0s &)r8c,VPVRR7R#)rrNrrs&&r6 setArtBoxCanvas.setArtBox3s %(r8c,VPVRR7R#)rrNrrs&&r6 setBleedBoxCanvas.setBleedBox6s '*r8c <VR,R8XgQR4hWnR#)z7Instruct display device that this page is to be rotatedgV@rcz)Rotation must be a multiple of 90 degreesN)r)rrots&&r6setPageRotationCanvas.setPageRotation9s TzS M"MM  r8c \V4pV^8XdVPV4pVPPV4R#)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.N)rKrWrr.)rrVescapeds&&&r6 addLiteralCanvas.addLiteral>s3 F A: QA !r8c .VPwrr4rVW,W2,, pWG, pV)V, p W6,WE,, V, p W, p V)V, p WR,Wa,, V, p VPWWW4R#)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& r6resetTransformsCanvas.resetTransformsKs~6:5H5H2uUkEK')&*;,c1)&*;,c1 w7Lr8c  B\'dVPwrxrrWq,W,,W,W,,Ws,W,,W,W,,Wu,W,,V ,W,W,,V ,3VnVP'Ed6VPR,RRR8XEdVPR,P4p \ \ \ V RR44wrxrr\V 4^8;'d\V 4R,;'gRpV\Wq,W,,W,W,,Ws,W,,W,W,,Wu,W,,V ,W,W,,V ,4,VPR&R#VPPR\WW4WV4,4R#)zdadjoin a mathematical transform to the current graphics state matrix. Not recommended for beginners.Nz cmz %s cmz%s cmrgri) ENABLE_TRACKINGr$rsplitrImaprirJrHrr.)rrbr?r@er#a0b0c0d0e0f0rrVs&&&&&&& r6rCanvas.transform_sn ? $ 3 3 B"#%49bd#%49bd#%49R<bd2#?D  :::$**R.-u4 2$$&A%)#eAbH*=%> "BBBAq..T!Wh.99'ART "$rt)BDIbd24iPRPTUWUYPYZ\P\]_]abdbf]fgi]i!jjDJJrN JJ  gq1q(;; 6"""+IK r8c \P!VPR7PWW4WV4VP ^^4R#)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 Dr8c \P!VPR7PWW1, WB, 4VP WV4R#)zDraw an ellipse defined by an enclosing rectangle. Note that (x1,y1) and (x2,y2) are the corner points of the enclosing rectangle. rgN)rrhrellipserj)rrDrErFrGrprqs&&&&&&&r6rtCanvas.ellipses7   djj199""%O F)r8c  \P!VPR7p V PRW,,RW$,,4V P WW4WV4V P 4VP Wx4R#)z[Like arc, but connects to the centre of the ellipse. Most useful for pie charts and PacMan!rgrN)rrhrmoveToarcTocloserj) rrDrErFrGrkrlrprqps &&&&&&&&& r6wedge Canvas.wedgesY  $ $$** 5 beS"%[) bH,   F(r8c lW, pW,pW#, pW#,p VPWhWyWE4R#)zNdraw a cirle centered at (x_cen,y_cen) with radius r (special case of ellipse)N)rt) rx_ceny_cenrrprqrDrFrErGs &&&&&& r6circle Canvas.circles0Y Y Y Y RRV2r8c \P!VPR7PWW4V4VP Wg4R#)ztDraws a rectangle with rounded corners. The corners are approximately quadrants of a circle, with the given radius.rgN)rrhr roundRectrj)rr_rArr?radiusrprqs&&&&&&&&r6rCanvas.roundRect!s4   djj1;;A%QWX F(r8cXVPPV4pW PV&V#r<)r addShadingrrshadingrs&& r6 _addShadingCanvas._addShading(s)yy##G,"&$ r8clVPV4pVPPRV,4R#)z/%s shN)rrr.rs&& r6shade Canvas.shade-s(( (T/*r8c ^RIHp\V4wr\W4p V!WW4V V \ V4R7p VP V 4R#)r&)PDFAxialShadingFunction ColorSpaceExtendN)r*rrVrurr) rr\r[rDrErQrmrr colorSpacencolorsfcnrs &&&&&&&& r6linearGradientCanvas.linearGradient1sD<.v6 !'5!""3%.@.HJ 7r8c ^RIHp\V4wr\W4p V!WRWW:V\ V4R7 p VP V 4R#)r&)PDFRadialShadingrcrN)r*rrVrurr) rr_rArrQrmrrrrrrs &&&&&&& r6radialGradientCanvas.radialGradient:sF=.v6 !'5"1aF%.@.HJ 7r8c  \W6VPVPVR7wr9VPWVR7p VeV P V4V'dV P V4V'dV P V4V PV4V'dV P ^4V'dV P ^4VeV P ^4VPV 4R#)z*Draws a string in the current text styles.fontNamerTshaping directionN) rr r! beginTextsetTextRenderMode setCharSpace setWordSpacetextLinedrawText rr_rArQmode charSpacer wordSpacerrrs &&&&&&&&& r6 drawStringCanvas.drawStringMs$TT^^UYUcUcmtu  NN19N 5  Q006 annY/ annY/ 4 annQ' annQ'  Q003 ar8c  \W6VPVPVR7wr9V'd!V \V4^, V,, p V'd<WP R4VP R4,^, V,, p VP W, V4p VeV P V4V'dV PV4V'dV PV4V PV4V'dV P^4V'dV P^4VeV P ^4VPV 4R#)z2Draws a string right-aligned with the x coordinaterrD N rr r!rJrrrrrrrrs &&&&&&&&& r6rOCanvas.drawRightString[s$TT^^UYUcUcmtu  eD ! Y66e e 4 0G1D DQ F QQe NN19a (  Q006 annY/ annY/ 4 annQ' annQ'  Q003 ar8c  \W6VPVPVR7wr9V'd!V \V4^, V,, p V'd<WP R4VP R4,^, V,, p VP VRV ,, V4p VeV P V4V'dV PV4V'dV PV4V PV4V'dV P^4V'dV P^4VeV P ^4VPV 4R#)z_Draws a string centred on the x coordinate. We're British, dammit, and proud of our spelling!rrDrrNrrs &&&&&&&&& r6drawCentredStringCanvas.drawCentredStringjs%TT^^UYUcUcmtu  eD ! Y66e e 4 0G1D DQ F QQe NN1s5y=! ,  Q006 annY/ annY/ 4 annQ' annQ'  Q003 ar8c  VPV^4p VPW@PVP4p \ V 4^8Xd\ P V4eVR,\9dV ^,^Rp V ^,R,p V R,\9dV R,V ,p V ^Rp K)VPVRV ,, W,WVWxV R7VPVRV ,, W-WVWxV R7R#V ^,p VPVRV ,, W,WVWxV R7\ V 4^8d6WJ^,,p VPVRV ,, W-WVWxV R7R#R#)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. Nr)rrrrrrg) r stringWidthr r!rJdigitPatsearchrrOr)rr_rArQ pivotCharrrrrrpartspivWleftText rightTexts&&&&&&&&&& r6drawAlignedStringCanvas.drawAlignedString{sU8 9Q' >>4>>J u:?xt4@T"XU[E[Qx"~Ha I2,f,$RL94 #Ab>  3t8Qt'g ! O OOAc$hJ4'g  O QxH  3t8Qt'g ! O5zA~%a0 #d( At"+' Sr8c :VPP4pV#)zsReturns the list of PostScript font names available. Standard set now, but may grow in future with font embedding.)rgetAvailableFonts)r fontnamess& r6rCanvas.getAvailableFontssII//1 r8c t\\PP44pVP 4V#)z-Convenience function to list all loaded fonts)rIr widthsrRrk)rnamess& r6listLoadedFonts0Canvas.listLoadedFonts0s)Z&&++-.  r8c  WnW nVf VR,pW0n\P!VP4pVP 'gVP P'g\VRR4'gXVPPV4pVPPRV: R\V4: R\V4: R24R#R#R#) 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.NrrEFzBT rDz Tf z TL ET)r r!r#r rIrJrKrLrMrrNrr.r)r psfontnamerleadingrR pdffontnames&&&& r6setFontCanvas.setFonts $ ?SjG !!$..1   yy   5Fu(M(M"ii;;JG  !!KPTW]^eWf"gh)N!r8c ~Vf VPpVf VPpVPVPW4R#)z7Sets font size or leading without knowing the font faceN)r!r#rr )rrrs&&&r6rNCanvas.setFontSizes. < ?dmmG T^^T3r8c \P!Y;'g VPW0P3VRJ,4#)z1gets width of a string in the given font and sizeN)r rr r!)rrQrrTs&&&&r6rCanvas.stringWidths9%%d,F,F%-nn$=h$>N$OQ Qr8chWnVPPR\V4,4R#)z%s wN)r1rr.r)rrs&&r6rCanvas.setLineWidths" &6%=01r8c rVR9gQR4hWnVPPRV,4R#)z0=butt,1=round,2=squarez*Line caps allowed: 0=butt,1=round,2=squarez%d JNr&rer)r.rr.rrs&&r6 setLineCapCanvas.setLineCaps/wL LL  &4-(r8c rVR9gQR4hWnVPPRV,4R#)z0=mitre, 1=round, 2=bevelz-Line Joins allowed: 0=mitre, 1=round, 2=bevelz%d jNr)r/rr.rs&&r6 setLineJoinCanvas.setLineJoins/wO OO &4-(r8chWnVPPR\V4,4R#)z%s MN) _miterLimitrr.r)rlimits&&r6 setMiterLimitCanvas.setMiterLimits#  &6%=01r8c Rp\V\\34'dW3p^pM\V4'gRpVUu.uF*p\V\\34'd V^8gK(VNK, ppV'g$\V\\34'dV^8dRpMV'd\ V4^8:dRpV'd\ RV: RV: RV: 24hVP PR\V4: R V: R 24R #uupi) z7Two notations. pass two numbers, or an array and phasez1array 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) rDintrirsumrMrr.r)rarrayphasereasonrbads&&& r6setDashCanvas.setDashs eSK ( (NEEuHFJ%Qz!SK'@'@AEqq%J jE{33uQwCF s5z1}?Ks %D&Dc ,\P!4#)zReturns a fresh path object. Paths are used to draw complex figures. The object returned follows the protocol for a pathobject.PDFPathObject instance)rrhrs&r6 beginPathCanvas.beginPaths''))r8c Vf\VRVP4pVPP\ VP 444VP W#V4R#)z*Draw the path object in the mode indicatedNr&)rMr&rr.rKgetCoderj)raPathrprqfillModes&&&&&r6drawPathCanvas.drawPath sG  u[@H #emmo./ F1r8cvVPP\YVeTM VP3,4R#r<)rr.ror&)rrprqrs&&&&r6rjCanvas._strokeAndFills, (6X=QW[WeWe#efgr8c Vf\VRVP4pVP4p\W#V3,pV\8H;'d R;'gRpV: V: V: 2pVP P V4R#)zclip as well as drawingNr&z W* z W )rMr&rror%rr.) rrrprqrgcpathopsclipitems &&&&& r6clipPathCanvas.clipPathsk  u[@H ]]_x1G(HgM)44f==tW- $r8c \WW#R7#)zdReturns a fresh text object. Text objects are used to add large amounts of text. See PDFTextObjectr)r)rr_rArs&&&&r6rCanvas.beginText sTa==r8c jVPP\VP444R#)zDraws a text objectN)rr.rKr)r aTextObjects&&r6rCanvas.drawText%s" #k11345r8c Vf\PpWnVPP VP4R#)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&&r6rCanvas.setPageCompression)s2  "i6O6OO /   !6!67r8c WnR#)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&&r6setPageDurationCanvas.setPageDuration4s &r8c  /VnV'gR#VR9d RRV,3pM\P!R4hVR9d RRV,3pM\P!R4hVR9d RRV,3pM\P!R 4hR Wh.R V.R V.R V.R.RV./p W,p /p RT R&RT,T R&RT,T R&T F wrYT &K YnR# \d\P!RT,4hi;i)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! NDiz/%dz$ directions allowed are 0,90,180,270Dmrz$dimension values allowed are H and VMz!motion values allowed are I and OSplitBlindsrWipeDissolveGlitterzUnknown Effect Name "%s"z/Transrz%dr/r")r&Zr3i)HV)IO)rr PDFErrorKeyError)r effectnamer r dimensionmotion direction_arg dimension_arg motion_argPageTransitionEffectsargs transDictrbvalues&&&&&& r6rCanvas.setPageTransition@s5< "   &!59#45M//"HI I  "!3?3M//"HI I Y sV|,J//"EF F m0 }o J< m_  }o ! K(4D  $ & #z) # LS"cN!( K//"&3o 5B#9  U @Ar8c VP# \d>^RIHpT!T4;TPPnTnTPu#i;i)z/get form from canvas, create the form if needed)AcroForm)rTrreportlab.pdfbase.acroformrr)rrTs& r6acroFormCanvas.acroFormsJ !==  ! ;:B4. HDII   '$-==  !s AAAc f\V\\\34;'g\V\4pRpRpV'd\ VR4p V R8gpMY\V\ 4'dDV'd<\ VPR4p V R8gpV'dVPpVPpV'dSVP4VPX 4V^8dVPV4V'dVPV4VPW#WE4V'dVP4R#R#)z9draw a boundary as a rectangle (primarily for debugging).Nrg)rDrKrFrIrrrr0rr2rrGrrrr) rsbrDrErr?ssrsdar?s &&&&&& r6rQCanvas.drawBoundarys Cd+ , D D 2e0D   2AbB , - -"$AbBHH\\ NN     "!tT&&q)4<<# "% t  "2r8c"W PV&R#r<)r)rrcbs&&&r6 setNamedCBCanvas.setNamedCBs dr8c:VPPVR4#r<)rrr0s&&r6 getNamedCBCanvas.getNamedCBs}}  d++r8)?rTrrrrr'rrrrrr$rrrrr6rr4r&r r!r_rrr)rrrr#r.r0r/r1rr2rrrrrrrrrrPrrr+rr5r,r-r"r*rrr(rrrrr)NreNNr&NNNNNNNNNNNN)r&N)rNNNNN)r&r)NNFr?FFN)NNNFr?FFN)r&r&NN)rer^)NreNr&)g(\?g{Gz?gffffff?)NNreNr&)NreNr&NN)NreNrer&NN)r&r&NNr)Nre)r)reNNN)r&r)rer&)NT)Nr&NNFr<)NN)rer&N)r&r&N)Nrer&rr)NNN)rrrr__doc__rrrr<rArr:rIrhrJ STATE_RANGErrWrZr^rdrkrnrqruryr}rrrrrrrrrrrrrrrrrrr!r%r+r1r4r>r\rrcrrmrvrrrrtextAnnotation0rrinkAnnotation0rrrrrrrrrrrrrrrrrr(rrr0r8rrrHrrVr]rdrirrtr{rrrrrrrrOrr decimalSymbolrrrrrNrrrrrrrrrjrrrrr rr)r2r8r;r>rBrFrLpropertyrVrQr_rbrrrs@r6rrs%/b`D.&>55#$)57uS!1234K.*$24Ll8&" & & (($) , ) )))5)Sj++."KZ KC &'/2|-| # 3$2%)N(b Z %O=AI[gh!%r$b#NM& Q"!H%) 3 ,*)+! M(="& $ *6 2N  "  !D *)3) +&  "7@6M6MTXdequBFPU6Sp i 4 Q2) ) 2a@&* 2h > 6 8 &H)T%96-.' B!!#,!,,r8__main__zFor test scripts, look in tests)r&r&)> __version__rf__all__rrer|stringrmathrrrr reportlabr reportlab.pdfbaser r reportlab.pdfbase.ttfontsr r reportlab.pdfgenrreportlab.pdfgen.textobjectrrrreportlab.lib.colorsrrrrrreportlab.lib.utilsrrrrrrreportlab.lib.abagrreportlab.lib.rl_accelrrreportlab.lib.boxstuffr compilerr% FILL_NON_ZEROror7rLrVrurwrrrrprintr=r8r6rs>      ""$(>(VV[[ZZ#41 ::e   = !C = !C = !C = !C = !D = !C = !D = !C '&2 #OJGGR888@,_@,D8 z +,r8