Kwgo@dZdZdgZdZddlZddlZddlmZddlm Z m Z m Z m Z ddl mZdd lmZdd lmZdd lmZdd lmZmZdd lmZmZmZmZmZddlmZmZm Z m!Z!m"Z"m#Z#ddl$m%Z%m&Z&ddl'm(Z(ejRdZ*dZ+dZ,dde+fddde,fddde+fddde,fddde+fddde,fddde+fddde,fdiZ-d"dZ.dZ/dZ0dZ1GddZ2dZ3GddeZ4e5d k(r e6d!yy)#z3.3.0zz The Canvas object is the primary interface for creating PDF files. See doc/reportlab-userguide.pdf for copious examples. CanvasN)digits)sincostanpi) rl_config)pdfdoc) pdfmetrics) pathobject) PDFTextObject_PDFColorSetter)black_chooseEnforceColorSpaceColor CMYKColortoColor) ImageReaderisSeqisStr isUnicode _digester asUnicode)fp_str escapePDF)aspectRatioFixz\dnSzf*fzB*Bcddlm}|r0d|vr,||j|j|jg|d<d|vr.|||xsdg}|r|j |||||d<yy)Nr)PDFArrayCBorder)reportlab.pdfbase.pdfdocr#redgreenblueappend)Dcolor thickness dashArrayhradiusvradiusr#borders N/var/www/horilla/myenv/lib/python3.12/site-packages/reportlab/pdfgen/canvas.py _annFormatr31sn1 A599ekk5::>?#q').q1  MM(9- .v&( ct|tr0|jdtfd|j DfSt|t rd|j fSt|ttfrt|}|dk(rd|fS|dk(r(d|fSt|trtt|Std|z)N DeviceCMYKc3(K|] }|z ywN).0cds r2 z"_normalizeColor..Gs">11Q3">s DeviceRGBzUnknown color %r) isinstancerdensitytuplecmykrrgblistlenstr_normalizeColorr ValueError)aColorlr<s @r2rIrIDs&)$ NNU"> ">>>> FE "FJJL(( FUDM * K 6& & !V' ' FC wv// '&0 11r4cd}g}|D];}t|\}}|||k7rtd|d||}|j|=||fS)NzMismatch in color spaces: z and )rIrJr*)colorsspace outcolorsrKnspaceoutcolors r2_normalizeColorsrSTsf EI#*62  &eVTU U" # ) r4c`ddlm}m}|"t|t|k7r t dt|dk(r|d|d|dSt|dk(r#||ddk(r|ddk(r|d|d|dS|3t|}t |Dcgc]}t ||dz z }}ntt||}|jd|dddk7r|jdd |ddf|d ddk7r|jd |d dftt|\}}g}|dd Dcgc]}|} }g} |d} |ddD]@} |j|d| | | } | jd | jd B||| | d Scc}wcc}w)Nr)PDFExponentialFunctionPDFStitchingFunctionz4need to have the same number of colors and positionsr)NC0C1c |dS)Nrr9)xs r2z%_buildColorFunction..qs QqTr4)key?z [0.0 1.0])Domain) r&rUrVrGrJrangefloatrFzipsortinsertr*) rN positionsrUrVncr\ poscolors functionsposboundsencode lastcolorr,s r2_buildColorFunctionrp_sUY3v;!>OPP 6{a%fQiF1IFF 6{a  1!2y|q7H)A&)q J J [.3Bi8U1Xr!t_8 8Y/0 >* Q<?a    Qil1o 6 7 R= q   c9R=#34 5 i1 6I&q_ -cc -F - Fq I/! eLM  c c  66+ NN+9.s F& F+ceZdZeddddddZehdZdhZed Zed Z ed Z d Z d Z dZ dZdZy) ExtGStaterFrNormal)CAcaOPopOPMBM>HuerDarkenrsScreenLightenOverlayMultiply ColorBurn Exclusion HardLight SoftLight ColorDodge Difference Luminosity Saturation)ryryc4t|jSr8)rHlowervs r2_boolTransformzExtGState._boolTransforms1v||~r4c|Sr8r9rs r2_identityTransformzExtGState._identityTransformsr4c d|zS)N/r9rs r2_pdfNameTransformzExtGState._pdfNameTransforms 1u r4c i|_i|_yr8)_d_cselfs r2__init__zExtGState.__init__sr4c |j|}t|trt|}|j}nY||jvr?||j |vr!t d|d|d|j ||j}n |j}||jj||k7s|dk(r|jd|k7r||j|<|||f}||jvr|j|}n0dtt|jz}||j|<|jj!d|zyyy)Nz ExtGstate[z] = z not in allowed values rwrvgRLsz/%s gs)defaultsrAboolr pdfNameValuesallowedrJrrrgetgetValuerrHrG_coder*)rcanvarr< vTransformtnames r2setz ExtGState.sets$ MM!  a 1gA,,J $$$ $ Q' a Q")**//J00J dggkk!A 1d7t}}T/BA/EDGGAJ*Q-ADGG|wwqzc#dgg,//! JJ  ho .0F7r4cT|jj||j|Sr8)rrr)rrs r2rzExtGState.getValues ww{{1T]]1-..r4ci}|jjD]'\}}tjt |f||<)|xrtj|xsdSr8)ritemsr PDFDictionarydict)rrrrs r2getStatezExtGState.getStatesY ggmmo 7FAd**4:6AdG 7,V))!,44r4c|j}|jj|_|j|_|S)z=the states must be shared across push/pop, but the values not) __class__rcopyr)rr\s r2pushCopyzExtGState.pushCopys/ NN ww||~wwr4N)__name__ __module__ __qualname__rrrr staticmethodrrrrrrrrr9r4r2rrrrs HGFM/,/5 r4rrct|ttfr3t|dk7rt d|zd|Dcgc]}|rdnd c}zS|rdSdScc}w)NrZz wrong length for extend argumentz[%s %s]truefalsez [true true]z [false false])rArFrCrGrJ)extend_s r2_gradientExtendStrrs\&$u& v;>?&HI IfEaFW4EEE"=77Fs Ac*eZdZdZ ddZdZdZdZd Zd jZ e e e e Zd Zd Zd ZdZddZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!dZ"dZ#d Z$d!Z%d"Z&d#Z'd$Z(d%Z)d&Z*d'Z+ dd(Z,dd)Z-d*Z.d+Z/d,Z0 dd-Z1 dd.Z2d/Z3d0Z4d1Z5dd2Z6d3Z7dd4Z8dd5Z9dd6Z:dd7Z;e;Ze>Z? dd;Z@ dd<ZAdd=ZBdd>ZCd?ZDd@ZEdAZFdBZGdCZHddDZIdEZJdFZKdGZLdHZMddIZNdJZOdKZPdLZQdMZRdNZSdOZTdPZUdQZVdRZWdSZXdTZYddUZZdVZ[dWZ\ddXZ]ddYZ^ddZZ_dd[Z`dd\Zadd]Zbd^Zcd_Zddd`ZeddaZfddbZgddcZhdddZiejjddddfdeZldfZmdgZnddhZoddiZpddjZqdkZrdlZsdmZtdnZugdfdoZvdpZwddqZxddrZyddsZzddtZ{duZ|ddvZ}ddwZ~ ddxZdyZdzZd{Zd|Zd}Zd~ZdZddZedZedZy)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() NrrcH|tj}|tj}| r| ntj|_| | nd|_| | n|j dz|_||_tj|||| xstj||_ t| |_ ||_d|_||_||_d|_d|_d|_d|_i|_|j/|d|_g|_|j5d|_g|_g|_g|_||_tj@|_!||_"||_#||_$||_%|jM|jOg|_(|jS|y)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 cropMarksrenforceColorSpaceinitialFontNameinitialFontSizeinitialLeadingcropBoxartBoxtrimBoxbleedBoxrs r2rzCanvas.__init__sD   (A(AX  )*=*=i3B HeHe3B3NTV1?1K~QUQfQfgjQj!&&?1:X2<2Z@Z@Z,0) #;;L"M$ #!!%#! 0 !!# !%'"$&!! %99   !   "   r4cL|rddlm}t|r?t|r|j d}|j |}|j dn$t||j std|z||j_ y |j` y#t$rYywxYw)ah 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.librrrrnStandardEncryptionsetAllPermissionsrA TypeErrorrrAttributeError)rrrs r2rzCanvas.setEncryptfs  0W~W%%nnW5G$77@))!,)F)FG!MPW!WXX 'DII  II%!  s B B#"B#cd|_d|_|j|_|j|_d|_|j|_d|_ t|_ d|_ d|_ d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_t0j2xsdx|_|_t9|_y)Nr)rar_r_rar_r_drrrr)_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_strokeColorObjrr _extgstaters r2rzCanvas.init_graphics_state}s....,, 6&  73 4=4N4N4YRYYT1#+r4ci}|j}|jD] }||||< |jj||jj |_yr8)__dict__STATE_ATTRIBUTESrr*rr)rstater<rs r2push_state_stackzCanvas.push_state_stacksZ MM)) "DD'E$K " &//224r4cj|jj|jjyr8)rupdaterpoprs r2pop_state_stackzCanvas.pop_state_stacks# T--1134r4a_x _y _fontname _fontsize _textMode _leading _currentMatrix _fillMode _charSpace _wordSpace _horizScale _textRenderMode _rise _textLineMatrix _textMatrix _lineCap _lineJoin _lineDash _lineWidth _mitreLimit _fillColorObj _strokeColorObj _extgstatecgj}|jr |dn!|dt|jdz|j}t |}|j dk7r|j|j |jdk7r|j|j|dj||d||d=tj|j}|jsQ|jj s t#|dds.|d|j$j'|jzdj|j(|_y) Nz1 0 0 1 0 0 cmz1 0 0 -1 0 %s cmrr _drawTextAsPathFzBT %s 12 Tf 14.4 TL ET)r*rrrrrGr setFillColorrsetStrokeColorjoinr getFontr _dynamicFontfacebuiltIngetattrrgetInternalFontName__self__ _preamble)rPr$rfonts r2rzCanvas._make_preambles II ==    6$..*;#<< = JJ F    (   d00 1   7 *    4 4 5 #((1QR5/ abE!!$..1  yy  5Fu(M*TYY-J-J4>>-ZZ[!**-r4ct|Sr8)rrss r2_escapezCanvas._escapes |r4c:|jj|y)aidentify 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 r2r9zCanvas.setAuthors F#r4c:|jj|y)zHaccepts a func(yyyy,mm,dd,hh,m,s) used to create embedded formatted dateN)rsetDateFormatter)r dateFormatters r2r<zCanvas.setDateFormatters ""=1r4cV|jjj||||y)aAdds 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)rtitler^levelr?s r2rAzCanvas.addOutlineEntrys&h ))#ueF)Kr4cR|jjj|f|zy)aFnametree 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)rr@setNames)rnametrees r2setOutlineNames0zCanvas.setOutlineNames0 s%" # ""dWX%57r4c:|jj|y)zcwrite a title into the PDF file that won't automatically display in the document itself.N)rsetTitle)rrBs r2rIzCanvas.setTitles 5!r4c:|jj|y)zewrite a subject into the PDF file that won't automatically display in the document itself.N)r setSubject)rsubjects r2rKzCanvas.setSubject!s W%r4c:|jj|y)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 r2rNzCanvas.setCreator&s W%r4c:|jj|y)z!change the default producer valueN)r setProducer)rproducers r2rQzCanvas.setProducer,s h'r4ct|ttfrdj|}|jj |y)zwrite a list of keywords into the PDF file which shows in document properties. Either submit a single string or a list/tuplez, N)rArFrCr)r setKeywords)rkeywordss r2rTzCanvas.setKeywords0s2 hU| ,yy*H h'r4c2t|jdk(S)zHInfo function - app can call it after showPage to see if it needs a saver)rGrrs r2 pageHasDatazCanvas.pageHasData7s4::!##r4cL|jjjy)zSpecify that Acrobat Reader should start with the outline tree visible. showFullScreen() and showOutline() conflict; the one called last wins.N)r_catalog showOutliners r2rZzCanvas.showOutline;s &&(r4cL|jjjy)zSpecify that Acrobat Reader should start in full screen mode. showFullScreen() and showOutline() conflict; the one called last wins.N)rrYshowFullScreenrs r2showFullScreen0zCanvas.showFullScreen0As ))+r4ct|jjd|jj|d|y)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). transparencyrtNrensureMinPdfVersionrrrrs r2_setStrokeAlphazCanvas._setStrokeAlphaG, %%n5 Da(r4ct|jjd|jj|d|y)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). r_ruNr`rbs r2 _setFillAlphazCanvas._setFillAlphaRrdr4c>|jj|d|y)Nrvrrrbs r2_setStrokeOverprintzCanvas._setStrokeOverprint] Da(r4c>|jj|d|y)Nrwrhrbs r2_setFillOverprintzCanvas._setFillOverprint`rjr4cN|jj|d|xrdxsdy)Nrxrrrhrbs r2_setOverprintMaskzCanvas._setOverprintMaskcs  DqwQ|!4r4c>|jj|d|y)Nryrhrbs r2 setBlendModezCanvas.setBlendModefrjr4c|j}|r7tdt|dd}tdt|dd}|r||z}|Sy)Nr bleedWidth borderWidth$)rmaxr.)rcMbleedWbws r2 _getCmShiftzCanvas._getCmShiftisN __ 72l156FQwr-34Bf I r4c|jd}|jd}|j}|j}|rtdt |dd}|rt |dd}t |tdt |dd}t |dd }t |d t } d |z|z } t|} |r| r|j|j| |j||j|d||f||zd||z|f||| z||d |zzf||z|| z||z|d |zzfd|||f|| z||d |zz|fd||z|||zf|| z||z|d |zz||zfg|j|r|| d } || d =t|} tdt |d d} |j|j|| z || z | r$|jdd| z|z zdd| z|z z|| d }|| d =||dd|j|r|j d |z|z}d |z|z}|j!dt#j$}||_||_|j*|_|j.|_|j3|j4|j7|j8dD]F}t |d|zd }|st;||j=dzt#j>|H|j@|j@|_!|jD|jFgz|z|jHz}|jK||jM||jO||jQ||jS||jU||jVjY||jZr|j[|j\|j_y )z8Close the current page and possibly start on a new page.rrrsrtmarkLast markLength markWidth? markColorrZNrrg@r%)cropartbleedtrim_%sBoxBox)0rrrrur.minrrG saveStater( setLineWidthlines restoreState translatescalerr*r PDFPage pagewidth pageheightrRotate_currentPageHasImages hasImagessetPageTransitionrsetCompression_pageCompressionsetattr capitalizer#rDurrr1r setStream_setColorSpace _setExtGState _setXObjects_setShadingUsed_setAnnotationsraddPagerr _startPage)r pageWidth pageHeightrvcoderxr{mlmwmcmgcx0Lrwr$pageboxsizestrms r2showPagezCanvas.showPagers NN1% ^^A& __zz Qwr-34B"2j3C'"\""=>?R C0R E2rT"W$i"NN$''+%%b)JJAb "2a " R8JrM"Z"_="2jmIbLAbDQ2b "2b1R4;:b=JrM:"2jmIadN:b=Q  %%'!J J!$iQwr,q9: r&yF3JJq#f*i!773v:z:Q8QRJJQq !!#KKNbD9, rTJ.  C~~"$(( 33 t334 D1120 KC4 T2DS^^-e3FOOD4IJ K    )))DH**dnn-==DtG`G`` t D! 4  $ T" T" $ <<d&6&67 r4c|jr"|j|jd|_|xjdz c_|j|j g|_yNr)r setPageSizerrrrrs r2rzCanvas._startPagesX  ! !   T33 4%)D " A !!#   "r4c||_y)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 r2setPageCallBackzCanvas.setPageCallBacks  r4c&|j|_yr8)_annotationrefsAnnotsrrs r2rzCanvas._setAnnotationss** r4c&|j|_yr8) _colorsUsedrobjs r2rzCanvas._setColorSpaces**r4c&|j|_yr8) _shadingUsedrs r2rzCanvas._setShadingUseds --r4ct|j}|r#|jj|}||_yd|_y)zKfor pages and forms, define the XObject dictionary for resources, if neededN) _formsinuserxobjDictXObjects)rthingforms xobjectsdicts r2rzCanvas._setXObjectss2   99--e4L)EN!ENr4cj|j} ||S#tj|x}||<Y|SxYw)zDget a reference to a (possibly undefined, possibly unbound) bookmark)rr Destination)rrr<results r2_bookmarkReferencezCanvas._bookmarkReferences@    8T7N 8%11$7 7FQtW s2c~|j|}|jj|jj} |d}|d}|d}|d}|d}|dk(r|j |||n|dk(r|j n|dk(r|j |n|dk(r|j|nu|dk(r|j||||n[|dk(r|jnE|dk(r|j|n.|d k(r|j|ntd t|z|j| |S) 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 thisPageRefxyzfitfithfitvfitrfitbfitbhfitbvrJasciisetPage) rr^rlefttopbottomrightzoomdestpagerefs r2 bookmarkPagezCanvas.bookmarkPages*L&&s+ ))'') <D ;C >F =E <D %< HHT#d # E\ HHJ F] IIcN F] IIdO F] IId6% , F] IIK G^ JJsO G^ JJt 2U3Z?@ @ W r4c .|j||||dS)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)rrrr)r)rr^rrrkws r2bookmarkHorizontalAbsolutez!Canvas.bookmarkHorizontalAbsolute@s   #3T JJr4c Z|j||\}}|j||fd|i|y)z (TYY%=%=d%CCD %r4c8|jj|S)z*Query whether form XObj really exists yet.)rhasFormrs r2rzCanvas.hasFormcsyy  &&r4c d|_ddlm} | |||||} | j||||| | | j| j fS)aSee 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.pdfimagesrdrawInlineImagewidthheight) rimager\yrrrrrrrrimg_objs r2rzCanvas.drawInlineImagelsX &'"75!Auf5 3Z\#  % w~~..r4c  d|_t|trj|j} |j} |dk(r| r| j}n t |}t |r|jd}t| |z}n-||}t |r|jd}t|}|jj|}|jjj|d}|stj|||}||_|j!||jj#|||jj%||t'|dd} | r|jj| j}|jjj|d}|s3|j!| |jj#| ||_ntj*||_|`t/|||||||j0|j2| \}}}}}|j5|j7|||j9|||j:j=d|z|j?| r|jA| |||||jBj=|| r%| jED]}tG|| |<|j0|j2fS) aX 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_smaskr)$rrAr getRGBData_dataArHrrnrrr idToObjectrr PDFImageXObjectrr ReferenceaddFormr.smaskPDFObjectReferencer rrrrrrrr*r drawBoundaryrkeysvars)rrr\rrrr rrrrrrawdatarmdatarr6regNameimgObjmRegNamemImgObjscaledks r2 drawImagezCanvas.drawImages|&'" eK (&&(GLLEV|((*D  V,WU]+D &A|HHW%QtO_aearDJ(*D %)+D &)*D &!D #%D !DN!D  "D r4c$|j|j|j|j|j|j f}|j j|g|_d|_g|_g|_d|_i|_i|_y)zVwhen you enter a form, save accumulator info not related to the form for page (if any)rN) rrrr rrrr*r)rsaveds r2_pushAccumulatorszCanvas._pushAccumulatorss~T--t/C/CT^^UYUeUegkgxgxy u% %&"!r4cB|jj|_yr8)rrrrrs r2rzCanvas._setExtGStates002 r4c|j|j|js |jr|j |||||f|_|j j y)a}declare 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)rrrr r#rinForm)rrlowerxloweryupperxupperys r2 beginFormzCanvas.beginForm!sY    " ::  " " $? r4c H|j\}}}}} |j\}}||}||}tj||||} |j| _| j |jg|jz|jD]\} } t| | | |j| |j| |j| |j| |jj!|| |j#|j%y)zlemit the current collection of graphics operations as a Form as declared previously in beginForm.N)r'r(r)r*)r rr PDFFormXObjectrr setStreamListr1rrrrrrrrrrr#) rextra_attributesrr'r(r)r*whformrrs r2endFormzCanvas.endForm3s 26.vvvv R1 >!6 >!6$$F6&Y_`00 DNN+djj89$**, DAq D1   D! 4  $ T" $% !!# r4ct|r6dtj|jdj z}n&dtj|j z}|j j |}|j jj|d}|satj|dz}|j||j j|||j j|||dk(r|jjd|znB|dk(r|j jd|zn|j"jd|z|j$j|y)aEmbed 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 rrr)rhashlibmd5rn hexdigestrrr rr PDFPostScriptXObjectrrrrr*rrr)rcommandpositionrawNamerpsObjs r2addPostScriptCommandzCanvas.addPostScriptCommandLs5$ W W[[)@AKKMMGW[[1;;==G))**73 $$(($7//$?E   e $ II  w / II  gu - q=  & & - -h.@ A q[ JJ  h0 1  % % , ,X-? @ (r4c|s|j\}}dd||f}n|r|\}}}}|j||\} } |j||\} } |j||\} }|j||\}}| | | |f}| | ||f}t|t|}}t|t|}}||||f}|j }|r|d|z|d|z|d|z|d|zf}|S)NrrrZr?)rrrrury)rrectrelativer0r1lxlyuxuyxllyllxuryurxulyulxlrylrxsysxminyminxmaxymaxrxs r2_absRectzCanvas._absRectss..CAaa!9D !NBB++Br2GC++B3GC++B3GC++B3GCc3#Bc3#BR#b'$DR#b'$DtT)D     72:d1gbjaDGBJ>D r4c z|j||}|jtj|||fi|||y)z&DA is the default appearance string???N)rU_addAnnotationr FreeTextAnnotation)rcontentsDARect addtopagerrBrs r2freeTextAnnotationzCanvas.freeTextAnnotations:}}T(+ F55dHbOBOQUW`ar4c x|j||}|jtj||fi|||y)z!Experimental, but works. N)rUrWr TextAnnotation)rrYr[r\rrBrs r2textAnnotationzCanvas.textAnnotations8}}T(+ F11$GBGyYr4)g(\?g{Gz?gffffff?c |j||}|stj|}|jtj||||fi|||y)a1 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)rUr rect_to_quadrWHighlightAnnotation) rrYr[ QuadPointsrr\rrBrs r2highlightAnnotationzCanvas.highlightAnnotationsS}}T8,,,T2J F66tXzSX_\^_aegpqr4c tr8)NotImplementedErrorrUr1r0rWr InkAnnotation)rrYInkListr[r\rrBrs r2 inkAnnotationzCanvas.inkAnnotations!!r4c  :|j|||||fd|||d| S)a9rectangular 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)rBr-r,r.)linkRect) rrYdestinationnamer[r\rr-r,r.rs r2 linkAbsolutezCanvas.linkAbsolutes< t}}XiMXY#5IMIKM Mr4c  |j|} |j||}|| d<|| d<| | d<t| ||| |jt j di| ||S)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 r[Contentsrr9)rrUr3rWr LinkAnnotation) rrYrmr[r\rrBr-r,r.r destinations r2rlzCanvas.linkRectsq --o> }}T(+6 !:'=2eIi0""6#8#8#>2#>iPPr4c tddlm} m} m} m} | |} | d| d<| d| d<| |j ||| d<| }| d |d<| |}| ||d <|d k(r||d <n|d k(r ||d <d|d<nt d|z|| d<t| ||||j| y)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)rAnnotTypeLinkSubtyper[ActionrURIGoToRFz[ 0 /XYZ null null null ]r+zUnknown linkURI kind '%s'AN) r&rrtr#rurUrJr3rW)rurlrArBr-r,r.kindrrrtr#ruannr~uris r2linkURLzCanvas.linkURLs YX$g&F  It}}T(;<F  OH%& n# ;AeH 7]AcF0AcF84?@ @C3uYy1 C r4c|jdzx}|_|sdt|z}|jj|||r|j |yy)NrNUMBER)rreprr addAnnotation _annotatePage)r annotationrr\counts r2rWzCanvas._addAnnotationsT(,(=(=a(??%(4;.T j1    t $ r4cp|jj|}|jj|yr8)r refAnnotationrr*)rrrefs r2rzCanvas._annotatePages*ii%%d+ ##C(r4c|jS)z9get the page number for the current page being generated.)rrs r2 getPageNumberzCanvas.getPageNumbersr4ct|jr|j|jj |j |y)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)rGrrr SaveToFilerrs r2savez Canvas.saves/ tzz?DMMO T^^T2r4ct|jr|j|jj |}t |r|j d}|S)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)rGrrr GetPDFDatarrnr5s r2 getpdfdatazCanvas.getpdfdatasE tzz?DMMO II  & Q<!Ar4c2||_|jy)zPaccepts a 2-tuple in points for paper size for this and subsequent pagesN)rrrrs r2rzCanvas.setPageSizes r4c|j}|jdr|dd}|dvrtd|zt|d|z|y)zMaccepts a 2-tuple in points for name+'Box' size for this and subsequent pagesrN)rrrrzunknown box name: %rr)rendswithrJr)rrrs r2 setCropBoxzCanvas.setCropBoxsMzz| == Sb  4 43d:; ;X_d+r4c*|j|dy)Nrrrrs r2 setTrimBoxzCanvas.setTrimBox s &)r4c*|j|dy)Nrrrrs r2 setArtBoxzCanvas.setArtBox#s %(r4c*|j|dy)Nrrrrs r2 setBleedBoxzCanvas.setBleedBox&s '*r4c0|dzdk(sJd||_y)z7Instruct display device that this page is to be rotatedgV@r_z)Rotation must be a multiple of 90 degreesN)r)rrots r2setPageRotationzCanvas.setPageRotation)s"TzS M"MM  r4c|t|}|dk(r|j|}|jj|y)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)rHr7rr*)rr6escapeds r2 addLiteralzCanvas.addLiteral.s3 F A: QA !r4c|j\}}}}}}||z||zz }||z }| |z } ||z||zz |z } ||z } | |z } ||z||zz |z } |j|| | | | | y)aXI 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 r2resetTransformszCanvas.resetTransforms;s6:5H5H2ueUEEkE%K')&*;u,c1)&*;u,c1 w'7GLr4c tr\|j\}}} } } } ||z| |zz||z| |zz||z| |zz||z| |zz||z| |zz| z||z| |zz| zf|_|jr|jddddk(r|jdj} t t t | dd\}}} } } } t| dkDxrt| dzxsd}|t||z| |zz||z| |zz||z| |zz||z| |zz||z| |zz| z||z| |zz| zz|jd<y|jjdt||||||zy) zoadjoin a mathematical transform to the current graphics state matrix. Not recommended for beginners.r`rNz cmiz %s cmz%s cm) ENABLE_TRACKINGrrsplitrFmaprdrGr)rr*)rrbr;r<er a0b0c0d0e0f0rr6s r2rzCanvas.transformOs  $ 3 3 Br"R2#%a419Abd#%a419Abd#%a419R<Abd2#?D  ::$**R.-u4 2$$&A%)#eAbH*=%> "BBBAq.T!Wh.9'A1RT "Q$r!t)BqDAIbd2a4iPRSTPTUWXYUYPYZ\P\]_`a]abdefbf]fgi]i!jjDJJrN JJ  gq1Qq(;; urzC'(trzC'( q(GQ15r4cZ|j|jjdy)aiSave the current graphics state to be restored later by restoreState. For example: canvas.setFont("Helvetica", 20) canvas.saveState() ... canvas.setFont("Courier", 9) ... canvas.restoreState() # if the save/restore pairs match then font is Helvetica 20 again. qN)rrr*rs r2rzCanvas.saveStates"  #r4cZ|jjd|jy)zGrestore the graphics state to the matching saved state (see saveState).QN)rr*r#rs r2rzCanvas.restoreStates  # r4c p|jjdt||dt||dy)zdraw a line segment from (x1,y1) to (x2,y2) (with color, thickness and other attributes determined by the current graphics state).n  m z l SNrr*r)rx1y1x2y2s r2linez Canvas.lines' VB^VB^LMr4c |jjd|D]<\}}}}|jjt||dt||d>|jjdy)a&Like 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) rrz lrNr)rlinelistrrrrs r2rz Canvas.linessd #% NMR2b JJ  VB^VB^L M N #r4c |dz}|dz}|||z |||z f|||z|||zf||z |||z |f||z|||z|fg} |j|r$|j||r|j||r|j||j | |r)||j ||j ||z |||jy)Nr)rr(r'rr setFontSizedrawRightStringr) rr\rrgaptext strokeColor strokeWidthfontSize crosshairss r2crossz Canvas.crosss   s 4!C%(!AcE!AdF);afQquQ=OQRSVQVWXYZ[_Y_`aPbc       ,!!+.    k * : #T%5%5h%?  4D 1 r4ct|dkDsJdt|dkDsJdg}|d|d}}|d|d}}|D]}|j||||f|D]} |j|| || f|j|y)zPLays out a grid in current line style. Supply list of x an y positions.rz$x coordinate list must have 2+ itemsz$y coordinate list must have 2+ itemsrr`N)rGr*r) rxlistylistry0rx0rr\rs r2gridz Canvas.grids5zA~EEE~5zA~EEE~q59Bq59B &A LL!Bq % & &A LL"Qr! % & 5r4c x|jjdt||dt||||||dy)z/Bezier curve with the four given control pointsrrz c SNr) rrrrrx3y3x4y4s r2bezierz Canvas.beziers4 !"b>6"b"b"b+IK r4ctj|jj|||||||j ddy)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 Dr4ctj|jj||||z ||z |j ||y)zDraw an ellipse defined by an enclosing rectangle. Note that (x1,y1) and (x2,y2) are the corner points of the enclosing rectangle. rN)r rrellipser)rrrrrrrs r2r zCanvas.ellipses?   djj199"b"R%BO FD)r4c tj|j} | jd||zzd||zz| j ||||||| j |j ||y)zcLike arc, but connects to the centre of the ellipse. Most useful for pie charts and PacMan!rrN)r rrmoveToarcTocloser) rrrrrrrrrps r2wedgez Canvas.wedgese  $ $$** 5 beS"R%[) 2bHV,   F4(r4cX||z }||z}||z }||z} |j|||| ||y)zNdraw a cirle centered at (x_cen,y_cen) with radius r (special case of ellipse)N)r ) rx_ceny_cenrrrrrrrs r2circlez Canvas.circles>QY QY QY QY RRVT2r4ctj|jj||||||j ||y)z|Draws a rectangle with rounded corners. The corners are approximately quadrants of a circle, with the given radius.rN)r rr roundRectr)rr\rrrradiusrrs r2rzCanvas.roundRects:   djj1;;Aq%QWX F4(r4cZ|jj|}||j|<|Sr8)r addShadingrrshadingrs r2 _addShadingzCanvas._addShadings+yy##G,"&$ r4cb|j|}|jjd|zy)Nz/%s sh)rrr*rs r2shadez Canvas.shades(( (T/*r4c ddlm}t|\} } t| |} |||||| | t |} |j | y)Nr)PDFAxialShadingFunction ColorSpaceExtend)r&r!rSrprr) rrrrrrNrhrr! colorSpacencolorsfcnrs r2linearGradientzCanvas.linearGradient!sL<.v6 G!'95!"b"b3%.@.HJ 7r4c ddlm}t|\}} t| |} |||d|||| |t | } |j | y)Nr)PDFRadialShadingr_r")r&r+rSrprr) rr\rrrNrhrr+r&r'r(rs r2radialGradientzCanvas.radialGradient*sP=.v6 G!'95"1aaFS%.@.HJ 7r4cjt|}|j|||}||j||r|j||r|j ||j ||r|jd|r|j d||jd|j |y)z*Draws a string in the current text styles. directionNr)r beginTextsetTextRenderMode setCharSpace setWordSpacetextLinedrawText) rr\rrmode charSpacer/ wordSpacers r2 drawStringzCanvas.drawString=s NN1a9N 5  Q006 annY/ annY/ 4 annQ' annQ'  Q003 ar4crt|ts|jd}|j||j|j }|r|t |dz |zz }|r,||jd|jdzdz |zz }|j||z ||} || j||r| j||r| j|| j||r| jd|r| jd|| jd|j| y)z2Draws a string right-aligned with the x coordinaterrr% r.NrrArHdecode stringWidthrrrGrr0r1r2r3r4r5 rr\rrr6r7r/r8rrs r2rzCanvas.drawRightStringKs $$;;w'D  t~~t~~F eD ! Y66e e 4 0G1D DQ F QQe NN1u9a9N =  Q006 annY/ annY/ 4 annQ' annQ'  Q003 ar4cxt|ts|jd}|j||j|j }|r|t |dz |zz }|r,||jd|jdzdz |zz }|j|d|zz ||} || j||r| j||r| j|| j||r| jd|r| jd|| jd|j| y) zoDraws a string centred on the x coordinate. We're British, dammit, and proud of our spelling!rrr%r;rr.Nrr<r?s r2drawCentredStringzCanvas.drawCentredString\s$$;;w'D  t~~t~~F eD ! Y66e e 4 0G1D DQ F QQe NN1s5y=!yN A  Q006 annY/ annY/ 4 annQ' annQ'  Q003 ar4c d|j|d} |j||j|j} t | dk(rt j |||dtvrq| ddd} | dd} | dtvr| d| z} | dd} | dtvr|j|d| zz || |||||j|d| zz || ||||y| d} |j|d| zz || ||||t | dkDr'|| dz} |j|d| zz || ||||yy)aDraws 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. rNr`rr)r6r7r/r8) rr>rrrGdigitPatsearchrrr9) rr\rr pivotCharr6r7r/r8partspivWleftText rightTexts r2drawAlignedStringzCanvas.drawAlignedStringosv8 9Q' 4>>4>>J u:?xt4@T"XU[E[Qx"~Ha I2,f,$RL94 #Ab>2,f,  3t8Qty'9 ! > OOAc$hJ949'9  > QxH  3t8Qty'9 ! >5zA~%a0 #d( Ayty"+y Br4c:|jj}|S)z{Returns the list of PostScript font names available. Standard set now, but may grow in future with font embedding.)rgetAvailableFonts)r fontnamess r2rLzCanvas.getAvailableFontssII//1 r4ctttjj}|j |S)z-Convenience function to list all loaded fonts)rFr widthsrrf)rnamess r2listLoadedFonts0zCanvas.listLoadedFonts0s)Z&&++-.  r4c ||_||_||dz}||_tj|j}|j sw|j js t|ddsS|jj|}|jjd|dt|dt|dyyy) 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.Nrr&FzBT r%z Tf z TL ET)rrrr r*r+r,r-r.rr/rr*r)r psfontnamerleadingr3 pdffontnames r2setFontzCanvas.setFonts $ ?SjG !!$..1  yy  5Fu(M"ii;;JG  !!KPTW]^eWf"gh)N!r4cv| |j}| |j}|j|j||y)z7Sets font size or leading without knowing the font faceN)rrrVr)rrrTs r2rzCanvas.setFontSizes0 < ?dmmG T^^T73r4cntj||xs |j||jf|duS)z1gets width of a string in the given font and sizeN)r r>rr)rrfontNamers r2r>zCanvas.stringWidths:%%dH,F%-dnn$=h$>N$OQ Qr4c`||_|jjdt|zy)Nz%s w)rrr*r)rrs r2rzCanvas.setLineWidths$ &6%=01r4cd|dvsJd||_|jjd|zy)z0=butt,1=round,2=squarerrrZz*Line caps allowed: 0=butt,1=round,2=squarez%d JN)rrr*rr6s r2 setLineCapzCanvas.setLineCaps1wL LL  &4-(r4cd|dvsJd||_|jjd|zy)z0=mitre, 1=round, 2=bevelr\z-Line Joins allowed: 0=mitre, 1=round, 2=bevelz%d jN)rrr*r]s r2 setLineJoinzCanvas.setLineJoins1wO OO &4-(r4c`||_|jjdt|zy)Nz%s M) _miterLimitrr*r)rlimits r2 setMiterLimitzCanvas.setMiterLimits%  &6%=01r4cd}t|ttfr||f}d}n t|sd}|Dcgc] }t|ttfr|dks|"}}|st|ttfr|dkrd}n|rt |dkrd}|rt d|d|d||j jd t|d |d y cc}w) 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=r6[z] z dN) rAintrdrsumrJrr*r)rarrayphasereasonrbads r2setDashzCanvas.setDashs eSK (ENEEuHFJQz!SK'@AEqJJ jE{3uQwCF s5z1}?Ks C C c*tjS)zReturns a fresh path object. Paths are used to draw complex figures. The object returned follows the protocol for a pathobject.PDFPathObject instance)r rrs r2 beginPathzCanvas.beginPaths''))r4c|t|d|j}|jjt |j |j |||y)z*Draw the path object in the mode indicatedNr )r.r rr*rHgetCoder)raPathrrfillModes r2drawPathzCanvas.drawPathsI  u[@H #emmo./ F41r4cj|jjt||||n |jfyr8)rr*rr )rrrrts r2rzCanvas._strokeAndFills. (64X=QW[WeWe#efgr4c|t|d|j}|j}t|||f}|tk(xrdxsd}|||}|j j |y)zclip as well as drawingNr z W* z W )r.r rrrr rr*) rrsrrrtgcpathopsclipitems r2clipPathzCanvas.clipPathsg  u[@H ]]_x1G(HgM)4f=tW- $r4c t||||S)zoReturns a fresh text object. Text objects are used to add large amounts of text. See PDFTextObjectr.)r)rr\rr/s r2r0zCanvas.beginTextsT1a9==r4ch|jjt|jy)zDraws a text objectN)rr*rHrr)r aTextObjects r2r5zCanvas.drawTexts" #k11345r4c|tj}||_|jj |jy)a>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.N)r rrrr)rrs r2rzCanvas.setPageCompressions4  "i6O6OO /   !6!67r4c||_y)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 r2setPageDurationzCanvas.setPageDuration(s &r4ci|_|sy|dvrdd|zf}ntjd|dvrdd|zf}ntjd |d vrd d|zf}ntjd ||g|g|g|gg|gd } | |} i} d| d<d|z| d<d|z| d<| D] \} } | | | < | |_y#t$rtjd|zwxYw)asPDF 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)rZriDiz/%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/Transrwz%dr+r)rr PDFErrorKeyError)r effectnamerr/ dimensionmotion direction_arg dimension_arg motion_argPageTransitionEffectsargs transDictr^values r2rzCanvas.setPageTransition4s8< "   &!59#45M//"HI I  "!3?3M//"HI I Y sV|,J//"EF F$Z0$o<#_$o ! K(4D  $ & #z) #  #LS%"IcN #( K//"B11"Cc8dj|jS)zReturn uncompressed contents of current page buffer. This is useful in creating test cases and assertions of what got drawn, without necessarily saving pages to diskr6)r)rrs r2getCurrentPageContentzCanvas.getCurrentPageContent~s yy$$r4c|jj}t|dd}|ddlm}|x}|_|||<y)zCset one of the allowed enbtries in the documents viewer preferencesViewerPreferencesNr)ViewerPreferencesPDFDictionary)rCatalogr.r&rr)rprefrcatalogVPrs r2setViewerPreferencezCanvas.setViewerPreferencesA))## W0 6 : O-K-M MB*4r4cH|jjj|S).you'll get an error here if none have been setrrrrrs r2getViewerPreferencezCanvas.getViewerPreferencesyy  22488r4cF|jjj|=y)rNrrs r2delViewerPreferencezCanvas.delViewerPreferences II   / / 5r4cddlm}m}m}t |r ||}n7t |t tfr ||}nt |tr||}t|jj||y)Nr)rr#ru) r&rr#rurrArFrCrrrr)rr^rrr#rus r2setCatalogEntryzCanvas.setCatalogEntrysZOO <e$E tEl +UOE d #!%(E !!#e,r4cBt|jj|Sr8)r.rrrr^s r2getCatalogEntryzCanvas.getCatalogEntrystyy((--r4cDt|jj|y)z-you'll get an error here if it's not been setN)delattrrrrs r2delCatalogEntryzCanvas.delCatalogEntrys !!#&r4c|jj}t|dd}|ddlm}|x}|_ddlm}|j|||||y)zadd a PDFPageLabel for pageNum PageLabelsNr) PDFPageLabels) PDFPageLabel)rrr.r&rrr addPageLabel) rpageNumstylestartprefixrPLrrs r2rzCanvas.addPageLabelsP))## W\$ / : >&3o 5B#9  U5 @Ar4c |jS#t$r=ddlm}||x|jj_|_|jcYSwxYw)z/get form from canvas, create the form if neededr)AcroForm)rrreportlab.pdfbase.acroformrrY)rrs r2acroFormzCanvas.acroFormsJ !==  ! ;:B4. HDII   '$-==  !s AAAcXtdsddlmfd_jS)N _drawBoundaryr)Framec0j|||||Sr8)r)sbr\rr0r1rrs r2r]z%Canvas.drawBoundary..s E4G4GRPQRSTUVW4Xr4)hasattrreportlab.platypusrr)rrs`@r2rzCanvas.drawBoundarys$tO, 0!XD !!!r4)NrNNrNNNNNNNNNNNN)rN)rNNNNN)rr)NNFr;FFN)NNNFr;FFN)rrNN)r)r)NrNr)NNrNr)NrNrNN)NrNrrNN)rrNNr{r)r)rNNNr?)rr)rr)NT)NrNNr8)NN)rrN)rrN)Nrrrr)NNN)rrr__doc__rrrrr#rrrFrcrG STATE_RANGErr7r9r<rArGrIrKrNrQrTrWrZr]rcrfrirlrnrpryrrrrrrrrrrrrrrrrr#rr+r3r?rUr]r`textAnnotation0rerjinkAnnotation0rnrlrrWrrrrrrrrrrrrrrrrrrrrrrrrrrrAr rrrrrr)r,r9rrAr decimalSymbolrJrLrQrVrr>rr^r`rdrnrprurr|r0r5rrrrrrrrrrrpropertyrrr9r4r2rrs/d!%! #'!%!% $#^!@.&>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@6M6MTXdequBF6Bp i 4 Q2) ) 2a@&* 2h > 6 8 &;<9<H)T%96-.' B!!""r4__main__zFor test scripts, look in tests)rr)7 __version__r__all__rrer7stringrmathrrrr reportlabr reportlab.pdfbaser r reportlab.pdfgenr reportlab.pdfgen.textobjectrrreportlab.lib.colorsrrrrrreportlab.lib.utilsrrrrrrreportlab.lib.rl_accelrrreportlab.lib.boxstuffrcompilerCr  FILL_NON_ZEROrr3rIrSrprrrrrprintr9r4r2rs%    * ""$((F[[ZZ41 2::e   = !C = !C = !C = !C = !D = !C = !D = !C '&2 #OJGGR8m"_m"^7 z +,r4