ó X–Tc@sXdZddlZddlmZmZdefd„ƒYZdefd„ƒYZdS(sH This module defines Font objects, used for rendering text into Images. iÿÿÿÿN(tImagetVec2Dt _FontImagecBseZdZd„ZRS(s A wrapper for Images that came from rendering a font. This is necessary since the rendering returns a surface, which the Image API is built to hide. :param surf: The pygame Surface that will be stored in this _FontImage. :type surf: :class:`pygame.Surface` cCs||_d|_d|_dS(Ni(t_surftNonet_namet_version(tselftsurf((s//usr/lib/python2.7/site-packages/spyral/font.pyt__init__s  (t__name__t __module__t__doc__R (((s//usr/lib/python2.7/site-packages/spyral/font.pyRstFontcBs•eZdZd d„Zd eeed„Zd„ZeeƒZ d„Z ee ƒZ d„Z ee ƒZ d„ZeeƒZd„Zd „ZRS( si Font objects are how you get text onto the screen. They are loaded from TrueType Font files (\*.ttf); system fonts are not supported for asthetic reasons. If you need direction on what the different size-related properties of a Font object, check out the Font example. :param str font_path: The location of the \*.ttf file. :param int size: The size of the font; font sizes refer to the height of the font in pixels. :param color: A three-tuple of RGB values ranging from 0-255. Defaults to black ``(0, 0, 0)``. :type color: A three-tuple. icCs4t|ƒ|_tjj||ƒ|_||_dS(N(tinttsizetpygametfontR t default_color(Rt font_pathRR((s//usr/lib/python2.7/site-packages/spyral/font.pyR #scCs¡|dkr|j}n|jj|ƒ|jj|ƒ|jj|ƒ|jj|t|ƒjƒ}t j |j ƒt j ƒ}|j |dƒt|jƒƒS(sò Renders the given *text*. Italicizing and bolding are artificially added, and may not look good for many fonts. It is preferable to load a bold or italic font where possible instead of using these options. :param str text: The text to render. Some characters might not be able to be rendered (e.g., "\\n"). :param color: A three-tuple of RGB values ranging from 0-255. Defaults to the default Font color. :type color: A three-tuple. :param bool underline: Whether to underline this text. Note that the line will always be 1 pixel wide, no matter the font size. :param bool italic: Whether to artificially italicize this font by angling it. :param bool bold: Whether to artificially embolden this font by stretching it. :rtype: :class:`Image ` iN(ii(RRRt set_underlinetset_boldt set_italictrendertTruet convert_alphaRtSurfacetget_sizetSRCALPHAtblitR(Rttexttcolort underlinetitalictboldt text_surfacetbackground_surface((s//usr/lib/python2.7/site-packages/spyral/font.pyR(s  cCs |jjƒS(N(Rt get_height(R((s//usr/lib/python2.7/site-packages/spyral/font.pyt _get_heightHscCs |jjƒS(N(Rt get_ascent(R((s//usr/lib/python2.7/site-packages/spyral/font.pyt _get_ascentMscCs |jjƒS(N(Rt get_descent(R((s//usr/lib/python2.7/site-packages/spyral/font.pyt _get_descentSscCs |jjƒS(N(Rt get_linesize(R((s//usr/lib/python2.7/site-packages/spyral/font.pyt _get_linesizeYscCs|jj|ƒS(s¾ Returns a list containing the font metrics for each character in the text. The metrics is a tuple containing the minimum x offset, maximum x offset, minimum y offset, maximum y offset, and the advance offset of the character. ``[(minx, maxx, miny, maxy, advance), (minx, maxx, miny, maxy, advance), ...]`` :param str text: The text to gather metrics on. :rtype: `list` of tuples. (Rt get_metrics(RR((s//usr/lib/python2.7/site-packages/spyral/font.pyR-_s cCst|jj|ƒƒS(sˆ Returns the size needed to render the text without actually rendering the text. Useful for word-wrapping. Remember to keep in mind font kerning may be used. :param str text: The text to get the size of. :returns: The size (width and height) of the text as it would be rendered. :rtype: :class:`Vec2D ` (RRR(RR((s//usr/lib/python2.7/site-packages/spyral/font.pyRls (iiiN(R R R R RtFalseRR&tpropertytheightR(tascentR*tdescentR,tlinesizeR-R(((s//usr/lib/python2.7/site-packages/spyral/font.pyR s           (R RtspyralRRRtobjectR (((s//usr/lib/python2.7/site-packages/spyral/font.pyts