; 0sDc@sidZdZdZdkZdkZdkZdklZlZl Z l Z l Z l Z l Z dkZdkTdklZlZlZlZlZdkZdklZdklZd klZd klZd klZlZl Z d k!l"Z"d k!l#Z#ei$dZ%e"Z&e'e(fZ)dZ*dZ+hdde*fd<dde+fd<dde*fd<dde+fd<dde*fd<dde+fd<dde*fd<dde+fd@ss(sjoinsmapsmd5sssdigest(ss((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys _digester?scCsdkl}|o&||i|i|ig|dd:Z?d;Z@d<ZAd=ZBd>ZCd?ZDd@ZEdAZFdBZGdCZHddDdEZIdddFZJdddGZKdddHZLdddIZMdddJZNdKZOdLZPdMZQdNdOZRdPZSdQZTdRZUdSZVedTZWeedUZXdVZYdWZZdXZ[dYZ\dZZ]gdd[Z^d\Z_ddd]Z`ddd^Zaddd_Zbd`ZcddaZdedbZeedddcdddeZfdfZgRS(gsNThis 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. 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() iicCs |tjo ti}n|tjo ti}n||_ti d|d|d||_ ||_ t|_||_d|_t|_t|_h|_|i|d|_g|_|id|_g|_g|_g|_||_ti|_|i|i g|_!dS(sCreate a canvas of a given size. etc. You may pass a file-like object to filename as an alternative to a string. Most of the attributes are private - we will use set/get methods as the preferred interface. Default page size is A4.s compressions invariantsfilenameiiN("spagesizesNones rl_configsdefaultPageSizes invariantsfilenamesselfs _filenamespdfdocs PDFDocumentspageCompressions_docs verbositys _verbositys_onPages _pagesizes _pageRotations_pageTransitions _pageDurations _destinationsssetPageCompressions _pageNumbers _codeStacks_restartAccumulatorss_annotationCounts _outliness_psCommandsBeforePages_psCommandsAfterPagesbottomupsdefaultImageCachings imageCachings_make_preamblesinit_graphics_states state_stack(sselfsfilenamespagesizesbottomupspageCompressions invariants verbosity((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys__init__|s8                        cCsd|_d|_d|_d|_d|_d|_d|_ddddddf|_d|_ d|_ d|_ d|_ d|_ d|_ddddddf|_ddddddf|_d|_d|_t|_d|_d|_dddf|_dddf|_dS(Nis Times-Romani f14.4f1.0f0.0id(sselfs_xs_ys _fontnames _fontsizes _dynamicFonts _textModes_leadings_currentMatrixs _fillModes _charSpaces _wordSpaces _horizScales_textRenderModes_rises_textLineMatrixs _textMatrixs_lineCaps _lineJoinsNones _lineDashs _lineWidths _mitreLimits _fillColorRGBs_strokeColorRGB(sself((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysinit_graphics_states.                  cCsEh}|i}x|iD]}|||||i}y ||SWnti|}||scCs |iSdS(s9get the page number for the current page being generated.N(sselfs _pageNumber(sself((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys getPageNumberBscCs8t|io|in|ii|i|dS(sSaves 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(slensselfs_codesshowPages_docs SaveToFiles _filename(sself((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pyssaveFscCs2t|io|in|ii|SdS(sReturns 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.N(slensselfs_codesshowPages_docs GetPDFData(sself((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys getpdfdataMscCs||_|idS(sPaccepts a 2-tuple in points for paper size for this and subsequent pagesN(ssizesselfs _pagesizes_make_preamble(sselfssize((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys setPageSizeTs cCs(|ddjp td||_dS(s7Instruct display device that this page is to be rotatedf90.0f0.0s)Rotation must be a multiple of 90 degreesN(srotsAssertionErrorsselfs _pageRotation(sselfsrot((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pyssetPageRotationZscCs@t|}|djo|i|}n|ii|dS(sintroduce the literal text of PDF operations s into the current stream. Only use this if you are an expert in the PDF file format.iN(sstrsssescapedsselfs_escapes_codesappend(sselfsssescaped((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys addLiteral_s   cCs|i\}}}}}}||||} || } | | }||||| } || } | | } ||||| }|i| | || | |dS(sJI 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(sselfs_currentMatrixsselfasselfbsselfcsselfdsselfesselffsdetsresultasresultcsresultesresultdsresultbsresultfs transform(sselfsselffsselfesselfdsselfcsselfbsselfasresultcsresultfsdetsresultdsresultesresultbsresulta((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysresetTransformsls    c Csto|i\} }} } } }| || |||| || || |||| || || || ||| ||f|_n|io|idddjot|id} tt| dd!\} }} } } }t| djot| dpd}|t| || |||| || || |||| || || || ||| |||id\}}}}|iidt||t||fqW|iiddS(sLike line(), permits many lines to be drawn in one call. for example for the figure | -- -- | crosshairs = [(20,0,20,10), (20,30,20,40), (0,20,10,20), (30,20,40,20)] canvas.lines(crosshairs) sns %s m %s lsSN( sselfs_codesappendslinelistsx1sy1sx2sy2sfp_str(sselfslinelistsy2sx2sy1sx1((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysliness 0c Cst|djp tdt|djp tdg}|d|df\}}|d|df\}} x'|D]}|i ||||fq{Wx'|D]}|i ||| |fqW|i|dS(sPLays out a grid in current line style. Supply list of x an y positions.is$x coordinate list must have 2+ itemss$y coordinate list must have 2+ itemsiiN( slensxlistsAssertionErrorsylistslinessy0sy1sx0sx1sxsappendsysself( sselfsxlistsylistslinessysxsy1sy0sx0sx1((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysgridsc Cs<|iidt||t||||||fdS(s/Bezier curve with the four given control pointss n %s m %s c SN( sselfs_codesappendsfp_strsx1sy1sx2sy2sx3sy3sx4sy4( sselfsx1sy1sx2sy2sx3sy3sx4sy4((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysbezier siZc Csti||||||}|i i dt |dd x,|D]$}|i i dt |dqGW|i i ddS(sCDraw 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.sn %s miis%s csSN(spdfgeoms bezierArcsx1sy1sx2sy2sstartAngsextents pointListsselfs_codesappendsfp_strscurve( sselfsx1sy1sx2sy2sstartAngsextentscurves pointList((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysarcs ""cCs;|iidt||||t|||i fdS(sPdraws a rectangle with lower left corner at (x,y) and width and height as given.sn %s re N( sselfs_codesappendsfp_strsxsyswidthsheightsPATH_OPSsstrokesfills _fillMode(sselfsxsyswidthsheightsstrokesfill((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysrect%sc Csti||||dd}|ii dt |dd x,|D]$}|ii dt |dqGW|ii t |||ifdS(sDraw an ellipse defined by an enclosing rectangle. Note that (x1,y1) and (x2,y2) are the corner points of the enclosing rectangle. Uses bezierArc, which conveniently handles 360 degrees. Special thanks to Robert Kern.iihsn %s mis%s cN(spdfgeoms bezierArcsx1sy1sx2sy2s pointListsselfs_codesappendsfp_strscurvesPATH_OPSsstrokesfills _fillMode( sselfsx1sy1sx2sy2sstrokesfills pointListscurve((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysellipse*s""c Cs||d} ||d} ti||||||} |i i dt| | |i i dt| dd x,| D]$} |i i dt| dqW|i i dt| | |i i t|||ifdS( scLike arc, but connects to the centre of the ellipse. Most useful for pie charts and PacMan!f2.0sn %s ms%s liis%s cs%s l N(sx1sx2sx_censy1sy2sy_censpdfgeoms bezierArcsstartAngsextents pointListsselfs_codesappendsfp_strscurvesPATH_OPSsstrokesfills _fillMode( sselfsx1sy1sx2sy2sstartAngsextentsstrokesfills pointListscurvesx_censy_cen((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pyswedge;s""c CsH||} ||}||}||}|i| |||||dS(sNdraw a cirle centered at (x_cen,y_cen) with radius r (special case of ellipse)N( sx_censrsx1sx2sy_censy1sy2sselfsellipsesstrokesfill( sselfsx_censy_censrsstrokesfillsy2sy1sx2sx1((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pyscircleMs     c Csd|}|}||}||}|||}|||}||}|} | |}| |} | ||} | ||} | |} |iidt|| |iidt|| |iidt|| |||| |iidt|| |iidt|| || || |iidt|| |iidt|| || || |iidt|| |iidt|||| || |iid|iit|||ifdS(s|Draws a rectangle with rounded corners. The corners are approximately quadrants of a circle, with the given radius.f0.44719999999999999sn %s ms%s ls%s cshN(sradiusstsxsx0sx1sx2swidthsx3sx4sx5sysy0sy1sy2sheightsy3sy4sy5sselfs_codesappendsfp_strsPATH_OPSsstrokesfills _fillMode(sselfsxsyswidthsheightsradiussstrokesfillsy1sy0sy3sy2sy5sy4sx2sx3sx0sx1sx4sx5st((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys roundRectVs2       ))))cCs0|i||}|i||i|dS(s*Draws a string in the current text styles.N(sselfs beginTextsxsyststextLinestextsdrawText(sselfsxsystextst((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys drawStrings cCsO|i||i|i}|i|||}|i ||i |dS(s2Draws a string right-aligned with the x coordinateN( sselfs stringWidthstexts _fontnames _fontsizeswidths beginTextsxsyststextLinesdrawText(sselfsxsystextswidthst((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysdrawRightStrings  cCsS|i||i|i}|i|d||}|i ||i |dS(s+Draws a string centred on the x coordinate.f0.5N( sselfs stringWidthstexts _fontnames _fontsizeswidths beginTextsxsyststextLinesdrawText(sselfsxsystextswidthst((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysdrawCentredStrings  s.c Cs]|i|d}|i||i|i}t |djo$t i |t j o|dt jo|ddd!}|dd}x1|dt jo|d|}|dd!}qW|i|d||||i|d|||nf|d}|i|d|||t |djo-||d}|i|d|||ndS(sDraws 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. iiif0.5N(stextssplits pivotCharspartssselfs stringWidths _fontnames _fontsizespivWslensdigitPatssearchsNonesdigitssleftTexts rightTextsdrawRightStringsxsys drawString( sselfsxsystexts pivotCharspivWspartssleftTexts rightText((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysdrawAlignedStrings": cCs!|ii}|i|SdS(s{Returns the list of PostScript font names available. Standard set now, but may grow in future with font embedding.N(sselfs_docsgetAvailableFontss fontnamesssort(sselfs fontnames((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysgetAvailableFontss cCs|ii|dS(s"add a new font for subsequent use.N(sselfs_docsaddFontsfontObj(sselfsfontObj((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysaddFontscCs,x%tiD]}|iti|q WdS(snEnsures the standard 14 fonts are available in the system encoding. Called by canvas on initializationN(s pdfmetricss standardFontssfontNamesselfsaddFonts fontsByName(sselfsfontName((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys_addStandardFontss cCs!tii}|i|SdS(s-Convenience function to list all loaded fontsN(s pdfmetricsswidthsskeyssnamesssort(sselfsnames((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pyslistLoadedFonts0s cCs||_||_|tjo|d}n||_ti |i}t |dd|_ |i o?|i i|}|iid|t|t|fndS(sSets 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.f1.2s _dynamicFontisBT %s %s Tf %s TL ETN(s psfontnamesselfs _fontnamessizes _fontsizesleadingsNones_leadings pdfmetricssgetFontsfontsgetattrs _dynamicFonts_docsgetInternalFontNames pdffontnames_codesappendsfp_str(sselfs psfontnamessizesleadings pdffontnamesfont((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pyssetFonts     cCsN|tjo |i}n|tjo |i}n|i|i||dS(s7Sets font size or leading without knowing the font faceN(ssizesNonesselfs _fontsizesleadings_leadingssetFonts _fontname(sselfssizesleading((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys setFontSizes   cCsti|||SdS(s1gets width of a string in the given font and sizeN(s pdfmetricss stringWidthstextsfontNamesfontSize(sselfstextsfontNamesfontSize((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys stringWidthscCs'||_|iidt|dS(Ns%s w(swidthsselfs _lineWidths_codesappendsfp_str(sselfswidth((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys setLineWidths cCsA|dddfjp td||_|iid|dS(s0=butt,1=round,2=squareiiis*Line caps allowed: 0=butt,1=round,2=squares%d JN(smodesAssertionErrorsselfs_lineCaps_codesappend(sselfsmode((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys setLineCap s  cCsA|dddfjp td||_|iid|dS(s0=mitre, 1=round, 2=beveliiis-Line Joins allowed: 0=mitre, 1=round, 2=bevels%d jN(smodesAssertionErrorsselfs _lineJoins_codesappend(sselfsmode((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys setLineJoins  cCs'||_|iidt|dS(Ns%s M(slimitsselfs _miterLimits_codesappendsfp_str(sselfslimit((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys setMiterLimits cCst|tjpt|tjo|iid||fntt|tjpt|t joM|djp t ddi t t |}|iid||fndS(s7Two notations. pass two numbers, or an array and phases [%s %s] 0 disphase is a length in user spaces s [%s] %s dN(stypesarraysIntTypes FloatTypesselfs_codesappendsphasesListTypes TupleTypesAssertionErrorsjoinsmapsstrs textarray(sselfsarraysphases textarray((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pyssetDashs&&cCstiSdS(sReturns a fresh path object. Paths are used to draw complex figures. The object returned follows the protocol for a pathobject.PDFPathObject instanceN(s pathobjects PDFPathObject(sself((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys beginPath&scCsF|i}t|||if}d||f}|i i |dS(s*Draw the path object in the mode indicateds%s %sN( saPathsgetCodesgcsPATH_OPSsstrokesfillsselfs _fillModespathopssitems_codesappend(sselfsaPathsstrokesfillsitemsgcspathops((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysdrawPath,s"cCsf|i}t|||if}|it jodpd}d|||f}|i i |dS(sclip as well as drawings W* s W s%s%s%sN(saPathsgetCodesgcsPATH_OPSsstrokesfillsselfs _fillModespathopss FILL_EVEN_ODDsclipsitems_codesappend(sselfsaPathsstrokesfillsclipsitemsgcspathops((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysclipPath3s "cCsti|||SdS(szReturns a fresh text object. Text objects are used to add large amounts of text. See textobject.PDFTextObjectN(s textobjects PDFTextObjectsselfsxsy(sselfsxsy((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pys beginText=scCs |iit|idS(sDraws a text objectN(sselfs_codesappendsstrs aTextObjectsgetCode(sselfs aTextObject((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pysdrawTextBscCsV|tjo ti}n|ot o d|_n ||_|ii|idS(s>Possible 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.iN(spageCompressionsNones rl_configszlibsselfs_pageCompressions_docssetCompression(sselfspageCompression((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pyssetPageCompressionFs   cCs ||_dS(sAllows 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(sdurationsselfs _pageDuration(sselfsduration((sA/home/packages/reportlab/reportlab_2_0/reportlab/pdfgen/canvas.pyssetPageDurationTssHsIcCsh|_| odSn|ddddgjodd|f}n dd |d d gjod d |f} n dd|ddgjodd |f} n ddhd|| g<d| g<d| g<d|g<dg<d|g<} y| |}Wn t j odd|nXh} d| d