ó X–Tc@sndZddlZddlZddlZd„Zddd„Zd„Zd„Zd efd „ƒYZ dS( sOA module for manipulating Images, which are specially wrapped Pygame surfaces. iÿÿÿÿNcCs6tjt|dƒt|dƒftjdƒjƒS(sM Internal method for creating a new Spyral-compliant Pygame surface. iii (tpygametSurfacetinttSRCALPHAt convert_alpha(tsize((s0/usr/lib/python2.7/site-packages/spyral/image.pyt_new_spyral_surface strightic Cs½|dkr·ttjtjt|ƒƒƒƒ}d}xzt|ƒD]m\}}||dkrxd}||7}d}n||j7}t||jƒ}| j |||ffƒqCWnü|dkrØt j ddƒ} nt j ddƒ} |dkrt |ƒnt |ƒtttfkr4|gt|ƒ}nt|ƒ}|j dƒt j ddƒ} g} xKt||ƒD]:\}}| j || fƒ| | |j||f} quWt| ƒS( sß A function that returns a new Image from a list of images by placing them next to each other. :param images: A list of images to lay out. :type images: List of :class:`Image ` :param str orientation: Either 'left', 'right', 'above', 'below', or 'square' (square images will be placed in a grid shape, like a chess board). :param padding: The padding between each image. Can be specified as a scalar number (for constant padding between all images) or a list (for different paddings between each image). :type padding: int or a list of ints. :returns: A new :class:`Image ` tsquareitleftRitabove(sleftsright(sleftR (Rtmathtceiltsqrttlent enumeratetwidthtmaxtheighttappendtspyraltVec2DtreversedttypetfloattlongtlisttzipRtfrom_conglomerate( timagest orientationtpaddingtlengtht max_heighttindextimagetxtytsequencetselectortbase((s0/usr/lib/python2.7/site-packages/spyral/image.pyt from_sequences4 $         cCs¡d\}}xF|D]>\}\}}t|||jƒ}t|||jƒ}qWtd||fƒ}x0|D](\}\}}|j|||fƒqqW|S(s A function that generates a new image from a sequence of (image, position) pairs. These images will be placed onto a singe image large enough to hold all of them. More explicit and less convenient than :func:`from_seqeuence `. :param sequence: A list of (image, position) pairs, where the positions are :class:`Vec2D ` s. :type sequence: List of image, position pairs. :returns: A new :class:`Image ` iR(ii(RRRtImaget draw_image(R&RRR#R$R%tnew((s0/usr/lib/python2.7/site-packages/spyral/image.pyRBs cCsEtj|ƒ}|d}|d}|jd}t|dƒ}t|dƒ}|j}tjd|dƒ}|j} |jtjd|ƒƒ} |jtjd|f|ƒƒ} |jtjdd|f|ƒƒ} |jtj|df|ƒƒ} |jtj||f|ƒƒ}|jtj|d|f|ƒƒ}|jtjd|df|ƒƒ}|jtjd||f|ƒƒ}|jtjd|d|f|ƒƒ}| j | dƒ| j |||dfƒ| j | d||fƒ| j |||ƒxRt |||||ƒD]6}| j | d|fƒ| j ||||fƒq&W| j | d|||fƒ| j ||||||fƒxRt |||||ƒD]6}| j | |dfƒ| j ||||fƒq»W| j | |||dfƒ| j ||||||fƒx]t |||||ƒD]A}x8t |||||ƒD]}| j |||fƒqqWqPWx@t |||||ƒD]$}| j |||||fƒq°Wx@t |||||ƒD]$}| j |||||fƒqóW| j |||||||fƒ|S( sß Creates a new image by dividing the given image into a 3x3 grid, and stretching the sides and center while leaving the corners the same size. This is ideal for buttons and other rectangular shapes. :param image: The image to stretch. :type image: :class:`Image ` :param size: The new (width, height) of this image. :type size: :class:`Vec2D ` :returns: A new :class:`Image ` similar to the old one. iiiRi(ii(ii(ii( RRRRt_surfR*t subsurfaceRtRecttblittrange(R#RtbstbwtbhtpstpwtphtsurftsttopleftR t bottomleftttoptmidtbottomttoprightRt bottomrightR%R$((s0/usr/lib/python2.7/site-packages/spyral/image.pytrender_nine_sliceWsR      !%!!%%%)!"!"!!!"!"&R*cBseZdZddd„Zd„ZeeƒZd„ZeeƒZ d„Z ee ƒZ d„Z dddd„Z d ed „Zddd „Zdddd „Zdd „Zdddd„Zddd„Zd„Zd„Zeed„Zd„Zdd„Zdd„ZRS(sü The image is the basic drawable item in spyral. They can be created either by loading from common file formats, or by creating a new image and using some of the draw methods. Images are not drawn on their own, they are placed as the *image* attribute on Sprites to be drawn. Almost all of the methods of an Image instance return the Image itself, enabling commands to be chained in a `fluent interface `_. :param size: If size is passed, creates a new blank image of that size to draw on. If you do not specify a size, you *must* pass in a filename. :type size: :class:`Vec2D ` :param str filename: If filename is set, the file with that name is loaded. The appendix has a list of the :ref:`valid image formats`. If you do not specify a filename, you *must* pass in a size. cCs¦|dk r'|dk r'tdƒ‚n|dkrN|dkrNtdƒ‚n|dk rut|ƒ|_d|_n$tjj|ƒjƒ|_||_d|_ dS(NssMust specify exactly one of size and filename. See http://platipy.org/en/latest/spyral_docs.html#spyral.image.Imagei( tNonet ValueErrorRR-t_nameRR#tloadRt_version(tselftfilenameR((s0/usr/lib/python2.7/site-packages/spyral/image.pyt__init__¯s   cCs |jjƒS(N(R-t get_width(RG((s0/usr/lib/python2.7/site-packages/spyral/image.pyt _get_width½scCs |jjƒS(N(R-t get_height(RG((s0/usr/lib/python2.7/site-packages/spyral/image.pyt _get_heightÃscCstj|jjƒƒS(N(RRR-tget_size(RG((s0/usr/lib/python2.7/site-packages/spyral/image.pyt _get_sizeÉscCs9|jj|ƒ|jd7_tjjj|jƒ|S(s  Fills the entire image with the specified color. :param color: a three-tuple of RGB values ranging from 0-255. Example: (255, 128, 0) is orange. :type color: a three-tuple of ints. :returns: This image. i(R-tfillRFRtutilt scale_surfacetclear(RGtcolor((s0/usr/lib/python2.7/site-packages/spyral/image.pyRPÐs iR:cCsš|dkrtj|ƒ}ntj||ƒ}|j||jƒ}tjj|j||j ||jf|ƒ|j d7_ tj j j |jƒ|S(sÝ Draws a rectangle on this image. :param color: a three-tuple of RGB values ranging from 0-255. Example: (255, 128, 0) is orange. :type color: a three-tuple of ints. :param position: The starting position of the rect (top-left corner). If position is a Rect, then size should be `None`. :type position: :class:`Vec2D ` or :class:`Rect ` :param size: The size of the rectangle; should not be given if position is a rect. :type size: :class:`Vec2D ` :param int border_width: The width of the border to draw. If it is 0, the rectangle is filled with the color specified. :param str anchor: The anchor parameter is an :ref:`anchor position `. :returns: This image. iN(RBRR/t_calculate_offsetRRtdrawtrectR-tposRFRQRRRS(RGRTtpositionRt border_widthtanchorRWtoffset((s0/usr/lib/python2.7/site-packages/spyral/image.pyt draw_rectÞs icCss|dkr+tjj|j|||ƒntjj|j||||ƒ|jd7_tjjj |jƒ|S(s Draws a series of connected lines on a image, with the vertices specified by points. This does not draw any sort of end caps on lines. :param color: a three-tuple of RGB values ranging from 0-255. Example: (255, 128, 0) is orange. :type color: a three-tuple of ints. :param points: A list of points that will be connected, one to another. :type points: A list of :class:`Vec2D ` s. :param int width: The width of the lines. :param bool closed: If closed is True, the first and last point will be connected. If closed is True and width is 0, the shape will be filled. :returns: This image. i( RRVtaalinesR-tlinesRFRRQRRRS(RGRTtpointsRtclosed((s0/usr/lib/python2.7/site-packages/spyral/image.pyt draw_linesÿs  cCsa|j|ƒ}tjj|j|||jƒ||ƒ|jd7_tjj j |jƒ|S(s• Draws a circle on this image. :param color: a three-tuple of RGB values ranging from 0-255. Example: (255, 128, 0) is orange. :type color: a three-tuple of ints. :param position: The center of this circle :type position: :class:`Vec2D ` :param int radius: The radius of this circle :param int width: The width of the circle. If it is 0, the circle is filled with the color specified. :param str anchor: The anchor parameter is an :ref:`anchor position `. :returns: This image. i( RURRVtcircleR-tfloorRFRRQRRRS(RGRTRYtradiusRR[R\((s0/usr/lib/python2.7/site-packages/spyral/image.pyt draw_circles  cCsš|dkrtj|ƒ}ntj||ƒ}|j||jƒ}tjj|j||j ||jf|ƒ|j d7_ tj j j |jƒ|S(s¬ Draws an ellipse on this image. :param color: a three-tuple of RGB values ranging from 0-255. Example: (255, 128, 0) is orange. :type color: a three-tuple of ints. :param position: The starting position of the ellipse (top-left corner). If position is a Rect, then size should be `None`. :type position: :class:`Vec2D ` or :class:`Rect ` :param size: The size of the ellipse; should not be given if position is a rect. :type size: :class:`Vec2D ` :param int border_width: The width of the ellipse. If it is 0, the ellipse is filled with the color specified. :param str anchor: The anchor parameter is an :ref:`anchor position `. :returns: This image. iN(RBRR/RURRRVtellipseR-RXRFRQRRRS(RGRTRYRRZR[RWR\((s0/usr/lib/python2.7/site-packages/spyral/image.pyt draw_ellipse/s cCsO|j|ƒ}|jj|||ƒ|jd7_tjjj|jƒ|S(sÙ Draws a point on this image. :param color: a three-tuple of RGB values ranging from 0-255. Example: (255, 128, 0) is orange. :type color: a three-tuple of ints. :param position: The position of this point. :type position: :class:`Vec2D ` :param str anchor: The anchor parameter is an :ref:`anchor position `. :returns: This image. i(RUR-tset_atRFRRQRRRS(RGRTRYR[R\((s0/usr/lib/python2.7/site-packages/spyral/image.pyt draw_pointOs c Cs |dkrtj|ƒ}ntj||ƒ}|j||jƒ} tjj|j||j | |jf|||ƒ|j d7_ tj j j |jƒ|S(sK Draws an elliptical arc on this image. :param color: a three-tuple of RGB values ranging from 0-255. Example: (255, 128, 0) is orange. :type color: a three-tuple of ints. :param float start_angle: The starting angle, in radians, of the arc. :param float end_angle: The ending angle, in radians, of the arc. :param position: The starting position of the ellipse (top-left corner). If position is a Rect, then size should be `None`. :type position: :class:`Vec2D ` or :class:`Rect ` :param size: The size of the ellipse; should not be given if position is a rect. :type size: :class:`Vec2D ` :param int border_width: The width of the ellipse. If it is 0, the ellipse is filled with the color specified. :param str anchor: The anchor parameter is an :ref:`anchor position `. :returns: This image. iN(RBRR/RURRRVtarcR-RXRFRQRRRS( RGRTt start_anglet end_angleRYRRZR[RWR\((s0/usr/lib/python2.7/site-packages/spyral/image.pytdraw_arcbs % cCs^|j||jjƒƒ}|jj|j||ƒ|jd7_tjjj|jƒ|S(s§ Draws another image over this one. :param image: The image to overlay on top of this one. :type image: :class:`Image ` :param position: The position of this image. :type position: :class:`Vec2D ` :param str anchor: The anchor parameter is an :ref:`anchor position `. :returns: This image. i( RUR-RNR0RFRRQRRRS(RGR#RYR[R\((s0/usr/lib/python2.7/site-packages/spyral/image.pyR+„s cCs4tjj|j|ƒjƒ|_|jd7_|S(si Rotates the image by angle degrees clockwise. This may change the image dimensions if the angle is not a multiple of 90. Successive rotations degrate image quality. Save a copy of the original if you plan to do many rotations. :param float angle: The number of degrees to rotate. :returns: This image. i(Rt transformtrotateR-RRF(RGtangle((s0/usr/lib/python2.7/site-packages/spyral/image.pyRp–s !cCs4tjj|j|ƒjƒ|_|jd7_|S(s¼ Scales the image to the destination size. :param size: The new size of the image. :type size: :class:`Vec2D ` :returns: This image. i(RRot smoothscaleR-RRF(RGR((s0/usr/lib/python2.7/site-packages/spyral/image.pytscale¥scCs7|jd7_tjj|j||ƒjƒ|_|S(sÕ Flips the image horizontally, vertically, or both. :param bool flip_x: whether to flip horizontally. :param bool flip_y: whether to flip vertically. :returns: This image. i(RFRRotflipR-R(RGtflip_xtflip_y((s0/usr/lib/python2.7/site-packages/spyral/image.pyRt²scCs%tj|ƒ}|jjƒ|_|S(s‰ Returns a copy of this image that can be changed while preserving the original. :returns: A new image. (tcopyR-(RGR,((s0/usr/lib/python2.7/site-packages/spyral/image.pyRw¿scCsz|dkrtj|ƒ}ntj||ƒ}t|ƒ}|j|jd|j|jfƒ||_|jd7_|S(sQ Removes the edges of an image, keeping the internal rectangle specified by position and size. :param position: The upperleft corner of the internal rectangle that will be preserved. :type position: a :class:`Vec2D ` or a :class:`Rect `. :param size: The size of the internal rectangle to preserve. If a Rect was passed in for position, this should be None. :type size: :class:`Vec2D ` or None. :returns: This image. iiN(ii( RBRR/RR0R-RXRRF(RGRYRRWR,((s0/usr/lib/python2.7/site-packages/spyral/image.pytcropÊs  " cCs†|jjƒ\}}|\}}|dkr=tjddƒS|dkr]tj||dƒS|dkrtj||ddƒS|dkr¡tjd||ƒS|dkrÅtj||||ƒS|dkrítj||d||ƒS|d krtjd||dƒS|d kr9tj||||dƒS|d kretj||d||dƒStj|ƒtj||ƒSd S( sô Internal method for calculating the offset associated with an anchor type. :param anchor_type: A string indicating the position of the anchor, taken from :ref:`anchor position `. A numerical offset can also be specified. :type anchor_type: str or a :class:`Vec2D `. :param size: The size of the region to offset in. :type size: :class:`Vec2D `. R:iR?tmidtopg@R;R@t midbottomtmidlefttmidrighttcenterN(R-RNRR(RGt anchor_typeRtwthtw2th2((s0/usr/lib/python2.7/site-packages/spyral/image.pyRUâs*            N(ii(ii(t__name__t __module__t__doc__RBRIRKtpropertyRRMRRORRPR]tFalseRbRfRhRjRnR+RpRstTrueRtRwRxRU(((s0/usr/lib/python2.7/site-packages/spyral/image.pyR*˜s0         !   ( R…RRRwRR)RRAtobjectR*(((s0/usr/lib/python2.7/site-packages/spyral/image.pyts    1  A