3 |ўQE@sdZddlmZmZmZmZddlmZddlm Z ddZ Gddde Z Gd d d e Z eje iZGd d d e ZGd dde ZdS)z cairocffi.fonts ~~~~~~~~~~~~~~~ Bindings for font-related objects. :copyright: Copyright 2013 by Simon Sapin :license: BSD, see LICENSE for details. )fficairo _check_status constants)Matrix)xrangecCs t|ts|jd}tjd|S)z2Return a byte string, encoding Unicode with UTF-8.utf8zchar[]) isinstancebytesencodernew)stringrO/var/www/html/enquirykeeper_venv/lib/python3.6/site-packages/cairocffi/fonts.py_encode_strings  rc@s,eZdZdZddZddZeddZdS) FontFacezThe base class for all font face types. Should not be instantiated directly, but see :doc:`cffi_api`. An instance may be returned for cairo font face types that are not (yet) defined in cairocffi. cCstj|tj|_|jdS)N)rgcrZcairo_font_face_destroy_pointerr)selfpointerrrr__init__!szFontFace.__init__cCsttj|jdS)N)rrZcairo_font_face_statusr)rrrrr%szFontFace._check_statuscCsH|tjkrtd|r tj|tjtjtj |t }t j |||S)uMWrap an existing :c:type:`cairo_font_face_t *` cdata pointer. :type incref: bool :param incref: Whether increase the :ref:`reference count ` now. :return: A new instance of :class:`FontFace` or one of its sub-classes, depending on the face’s type. z Null pointer) rNULL ValueErrorrZcairo_font_face_referenceobject__new__FONT_TYPE_TO_CLASSgetZcairo_font_face_get_typerr)rincrefrrrr _from_pointer(s   zFontFace._from_pointerN)__name__ __module__ __qualname____doc__rr staticmethodrrrrrrsrc@s<eZdZdZdejejfddZddZddZ d d Z d S) ToyFontFaceuCreates a font face from a triplet of family, slant, and weight. These font faces are used in implementation of cairo’s "toy" font API. If family is the zero-length string ``""``, the platform-specific default family is assumed. The default family then can be queried using :meth:`get_family`. The :meth:`Context.select_font_face` method uses this to create font faces. See that method for limitations and other details of toy font faces. :param family: a font family name, as an Unicode or UTF-8 string. :param slant: The :ref:`FONT_SLANT` string for the font face. :param weight: The :ref:`FONT_WEIGHT` string for the font face. cCstj|tjt|||dS)N)rrrZcairo_toy_font_face_creater)rfamilyZslantZweightrrrrNs zToyFontFace.__init__cCstjtj|jjddS)u&Return this font face’s family name.rreplace)rr rZcairo_toy_font_face_get_familyrdecode)rrrr get_familySszToyFontFace.get_familycCs tj|jS)u3Return this font face’s :ref:`FONT_SLANT` string.)rZcairo_toy_font_face_get_slantr)rrrr get_slantXszToyFontFace.get_slantcCs tj|jS)u4Return this font face’s :ref:`FONT_WEIGHT` string.)rZcairo_toy_font_face_get_weightr)rrrr get_weight\szToyFontFace.get_weightN) rr r!r"rFONT_SLANT_NORMALFONT_WEIGHT_NORMALrr)r*r+rrrrr$>s r$c@s~eZdZdZdddZddZddZed d Zd d Z d dZ ddZ ddZ ddZ ddZddZddZddZdS) ScaledFontaCreates a :class:`ScaledFont` object from a font face and matrices that describe the size of the font and the environment in which it will be used. :param font_face: A :class:`FontFace` object. :type font_matrix: Matrix :param font_matrix: Font space to user space transformation matrix for the font. In the simplest case of a N point font, this matrix is just a scale by N, but it can also be used to shear the font or stretch it unequally along the two axes. If omitted, a scale by 10 matrix is assumed (ie. a 10 point font size). See :class:`Context.set_font_matrix`. :type ctm: Matrix :param ctm: User to device transformation matrix with which the font will be used. If omitted, an identity matrix is assumed. :param options: The :class:`FontOptions` object to use when getting metrics for the font and rendering with it. If omitted, the default options are assumed. NcCsV|dkrt}|jd|dkr&t}|dkr4t}|jtj|j|j|j|jdS)N )rZscale FontOptions _init_pointerrZcairo_scaled_font_creater)rZ font_faceZ font_matrixZctmoptionsrrrrs zScaledFont.__init__cCstj|tj|_|jdS)N)rrrZcairo_scaled_font_destroyrr)rrrrrr1szScaledFont._init_pointercCsttj|jdS)N)rrZcairo_scaled_font_statusr)rrrrrszScaledFont._check_statuscCs:|tjkrtd|r tj|tjt}tj|||S)zWrap an existing :c:type:`cairo_scaled_font_t *` cdata pointer. :type incref: bool :param incref: Whether increase the :ref:`reference count ` now. :return: A new :class:`ScaledFont` instance. z Null pointer) rrrrZcairo_scaled_font_referencerrr.r1)rrrrrrrs    zScaledFont._from_pointercCstjtj|jddS)a&Return the font face that this scaled font uses. :returns: A new instance of :class:`FontFace` (or one of its sub-classes). Might wrap be the same font face passed to :class:`ScaledFont`, but this does not hold true for all possible cases. T)r)rrrZcairo_scaled_font_get_font_facer)rrrr get_font_faces zScaledFont.get_font_facecCst}tj|j|j|S)ucCopies the scaled font’s options. :returns: A new :class:`FontOptions` object. )r0rZ"cairo_scaled_font_get_font_optionsr)rZ font_optionsrrrget_font_optionss zScaledFont.get_font_optionscCs"t}tj|j|j|j|S)ubCopies the scaled font’s font matrix. :returns: A new :class:`Matrix` object. )rrZ!cairo_scaled_font_get_font_matrixrr)rmatrixrrrget_font_matrixszScaledFont.get_font_matrixcCs"t}tj|j|j|j|S)u1Copies the scaled font’s font current transform matrix. Note that the translation offsets ``(x0, y0)`` of the CTM are ignored by :class:`ScaledFont`. So, the matrix this method returns always has 0 as ``x0`` and ``y0``. :returns: A new :class:`Matrix` object. )rrZcairo_scaled_font_get_ctmrr)rr5rrrget_ctms zScaledFont.get_ctmcCs"t}tj|j|j|j|S)uCopies the scaled font’s scaled matrix. The scale matrix is product of the font matrix and the ctm associated with the scaled font, and hence is the matrix mapping from font space to device space. :returns: A new :class:`Matrix` object. )rrZ"cairo_scaled_font_get_scale_matrixrr)rr5rrrget_scale_matrixs  zScaledFont.get_scale_matrixcCs8tjd}tj|j||j|j|j|j|j |j fS)uReturn the scaled font’s extents. See :meth:`Context.font_extents`. :returns: A ``(ascent, descent, height, max_x_advance, max_y_advance)`` tuple of floats. zcairo_font_extents_t *) rr rZcairo_scaled_font_extentsrrZascentZdescentheightZ max_x_advanceZ max_y_advance)rextentsrrrr:s  zScaledFont.extentscCsBtjd}tj|jt|||j|j|j|j |j |j |j fS)aReturns the extents for a string of text. The extents describe a user-space rectangle that encloses the "inked" portion of the text, (as it would be drawn by :meth:`show_text`). Additionally, the :obj:`x_advance` and :obj:`y_advance` values indicate the amount by which the current point would be advanced by :meth:`show_text`. :param text: The text to measure, as an Unicode or UTF-8 string. :returns: A ``(x_bearing, y_bearing, width, height, x_advance, y_advance)`` tuple of floats. See :meth:`Context.text_extents` for details. zcairo_text_extents_t *) rr rZcairo_scaled_font_text_extentsrrr x_bearing y_bearingwidthr9 x_advance y_advance)rtextr:rrr text_extentss zScaledFont.text_extentscCsPtjd|}tjd}tj|j|t|||j|j|j|j |j |j |j fS)aReturns the extents for a list of glyphs. The extents describe a user-space rectangle that encloses the "inked" portion of the glyphs, (as it would be drawn by :meth:`show_glyphs`). Additionally, the :obj:`x_advance` and :obj:`y_advance` values indicate the amount by which the current point would be advanced by :meth:`show_glyphs`. :param glyphs: A list of glyphs, as returned by :meth:`text_to_glyphs`. Each glyph is a ``(glyph_id, x, y)`` tuple of an integer and two floats. :returns: A ``(x_bearing, y_bearing, width, height, x_advance, y_advance)`` tuple of floats. See :meth:`Context.text_extents` for details. zcairo_glyph_t[]zcairo_text_extents_t *) rr rZcairo_scaled_font_glyph_extentsrlenrr;r<r=r9r>r?)rglyphsr:rrr glyph_extentss  zScaledFont.glyph_extentsc stjdtjtjd}|r@tjdtjtjd}tjd}ntjtj}tj}tj|j||t|d ||| }tjdtj|rtjdtj t |fddt |dD|rfd dt |dD|dfSSd S) a`Converts a string of text to a list of glyphs, optionally with cluster mapping, that can be used to render later using this scaled font. The output values can be readily passed to :meth:`Context.show_text_glyphs`, :meth:`Context.show_glyphs` or related methods, assuming that the exact same :class:`ScaledFont` is used for the operation. :type x: float :type y: float :type with_clusters: bool :param x: X position to place first glyph. :param y: Y position to place first glyph. :param text: The text to convert, as an Unicode or UTF-8 string. :param with_clusters: Whether to compute the cluster mapping. :returns: A ``(glyphs, clusters, clusters_flags)`` tuple if :obj:`with_clusters` is true, otherwise just :obj:`glyphs`. See :meth:`Context.show_text_glyphs` for the data structure. .. note:: This method is part of what the cairo designers call the "toy" text API. It is convenient for short demos and simple programs, but it is not expected to be adequate for serious text-using applications. See :ref:`fonts` for details and :meth:`Context.show_glyphs` for the "real" text display API in cairo. zcairo_glyph_t **zint *zcairo_text_cluster_t **zcairo_text_cluster_flags_t *rcs,g|]$}|gD]}|j|j|jfqqSr)indexxy).0iZglyph)rCrr csz-ScaledFont.text_to_glyphs..cs(g|] }|gD]}|j|jfqqSr)Z num_bytes num_glyphs)rIrJZcluster)clustersrrrKhsN) rr rrZ cairo_scaled_font_text_to_glyphsrrrZcairo_glyph_freeZcairo_text_cluster_freerr) rrGrHr@Z with_clustersrLZ num_clustersZ cluster_flagsstatusr)rMrCrtext_to_glyphs-s.#     zScaledFont.text_to_glyphs)NNN)rr r!r"rr1rr#rr3r4r6r7r8r:rArDrPrrrrr.fs     r.c@seZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ e Z e Z ddZddZddZddZddZddZddZd d!Zd"S)#r0a`An opaque object holding all options that are used when rendering fonts. Individual features of a :class:`FontOptions` can be set or accessed using method named :meth:`set_FEATURE_NAME` and :meth:`get_FEATURE_NAME`, like :meth:`set_antialias` and :meth:`get_antialias`. New features may be added to :class:`FontOptions` in the future. For this reason, ``==``, :meth:`copy`, :meth:`merge`, and :func:`hash` should be used to check for equality copy,, merge, or compute a hash value of :class:`FontOptions` objects. :param values: Call the corresponding :meth:`set_FEATURE_NAME` methods after creating a new :class:`FontOptions`:: options = FontOptions() options.set_antialias(cairocffi.ANTIALIAS_BEST) assert FontOptions(antialias=cairocffi.ANTIALIAS_BEST) == options cKs:|jtjx&|jD]\}}t|d||qWdS)Nset_)r1rZcairo_font_options_createitemsgetattr)rvaluesnamevaluerrrrszFontOptions.__init__cCstj|tj|_|jdS)N)rrrZcairo_font_options_destroyrr)rrrrrr1szFontOptions._init_pointercCsttj|jdS)N)rrcairo_font_options_statusr)rrrrrszFontOptions._check_statuscCs*t|}tj|}|j|tj|j|S)z7Return a new :class:`FontOptions` with the same values.)typerrr1rZcairo_font_options_copyr)rclsotherrrrcopys zFontOptions.copycCs$tj|j|jttj|jdS)zMerges non-default options from :obj:`other`, replacing existing values. This operation can be thought of as somewhat similar to compositing other onto options with the operation of :obj:`OVER `. N)rZcairo_font_options_mergerrrW)rrZrrrmergeszFontOptions.mergecCs tj|jS)N)rZcairo_font_options_hashr)rrrr__hash__szFontOptions.__hash__cCstj|j|jS)N)rZcairo_font_options_equalr)rrZrrr__eq__szFontOptions.__eq__cCs ||k S)Nr)rrZrrr__ne__szFontOptions.__ne__cCstj|j||jdS)zChanges the :ref:`ANTIALIAS` for the font options object. This specifies the type of antialiasing to do when rendering text. N)rZ cairo_font_options_set_antialiasrr)rZ antialiasrrr set_antialiasszFontOptions.set_antialiascCs tj|jS)z?Return the :ref:`ANTIALIAS` string for the font options object.)rZ cairo_font_options_get_antialiasr)rrrr get_antialiasszFontOptions.get_antialiascCstj|j||jdS)aChanges the :ref:`SUBPIXEL_ORDER` for the font options object. The subpixel order specifies the order of color elements within each pixel on the display device when rendering with an antialiasing mode of :obj:`SUBPIXEL `. N)rZ%cairo_font_options_set_subpixel_orderrr)rZsubpixel_orderrrrset_subpixel_orders zFontOptions.set_subpixel_ordercCs tj|jS)zVReturn the :ref:`SUBPIXEL_ORDER` string for the font options object. )rZ%cairo_font_options_get_subpixel_orderr)rrrrget_subpixel_orderszFontOptions.get_subpixel_ordercCstj|j||jdS)zChanges the :ref:`HINT_STYLE` for the font options object. This controls whether to fit font outlines to the pixel grid, and if so, whether to optimize for fidelity or contrast. N)rZ!cairo_font_options_set_hint_stylerr)rZ hint_stylerrrset_hint_styleszFontOptions.set_hint_stylecCs tj|jS)z@Return the :ref:`HINT_STYLE` string for the font options object.)rZ!cairo_font_options_get_hint_styler)rrrrget_hint_styleszFontOptions.get_hint_stylecCstj|j||jdS)zChanges the :ref:`HINT_METRICS` for the font options object. This controls whether metrics are quantized to integer values in device units. N)rZ#cairo_font_options_set_hint_metricsrr)rZ hint_metricsrrrset_hint_metricsszFontOptions.set_hint_metricscCs tj|jS)zTReturn the :ref:`HINT_METRICS` string for the font options object. )rZ#cairo_font_options_get_hint_metricsr)rrrrget_hint_metricsszFontOptions.get_hint_metricsN)rr r!r"rr1rr[r\r]r^r_equalhashr`rarbrcrdrerfrgrrrrr0ps&    r0N)r"r%rrrrr5rcompatrrrrr$ FONT_TYPE_TOYrr.r0rrrr s  %$