File: //home/arjun/projects/env/lib/python3.10/site-packages/cairocffi/__pycache__/fonts.cpython-310.pyc
o
*we(L � @ s� d Z ddlmZmZmZmZmZ ddlmZ dd� Z G dd� de
�Z G dd � d e �Z ej
e iZG d
d � d e
�ZG d d
� d
e
�ZdS )z�
cairocffi.fonts
~~~~~~~~~~~~~~~
Bindings for font-related objects.
:copyright: Copyright 2013-2019 by Simon Sapin
:license: BSD, see LICENSE for details.
� )�
_check_status�_keepref�cairo� constants�ffi)�Matrixc C s t | t�s
| �d�} t�d| �S )z2Return a byte string, encoding Unicode with UTF-8.�utf8zchar[])�
isinstance�bytes�encoder �new)�string� r �H/home/arjun/projects/env/lib/python3.10/site-packages/cairocffi/fonts.py�_encode_string s
r c @ s, e Zd ZdZdd� Zdd� Zedd� �ZdS ) �FontFacez�The 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.
c C �" t �|tttj��| _| �� d S �N)r �gcr r �cairo_font_face_destroy�_pointerr ��self�pointerr r r �__init__ � � zFontFace.__init__c C � t t�| j�� d S r )r r �cairo_font_face_statusr �r r r r r $ � zFontFace._check_statusc C sH | t jkr td��|rt�| � t�t�t� | �t
��}t
� || � |S )uG Wrap an existing ``cairo_font_face_t *`` cdata pointer.
:type incref: bool
:param incref:
Whether increase the :ref:`reference count <refcounting>` now.
:return:
A new instance of :class:`FontFace` or one of its sub-classes,
depending on the face’s type.
� Null pointer) r �NULL�
ValueErrorr �cairo_font_face_reference�object�__new__�FONT_TYPE_TO_CLASS�get�cairo_font_face_get_typer r �r �increfr r r r �
_from_pointer' s
� zFontFace._from_pointerN)�__name__�
__module__� __qualname__�__doc__r r � staticmethodr+ r r r r r s r c @ s< e Zd ZdZdejejfdd�Zdd� Zdd� Z d d
� Z
d S ) � ToyFontFaceu� Creates 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.
� c C s t �| t�t|�||�� d S r )r r r �cairo_toy_font_face_creater )r �family�slant�weightr r r r M s
�zToyFontFace.__init__c C s t �t�| j���dd�S )u& Return this font face’s family name.r �replace)r r
r � cairo_toy_font_face_get_familyr �decoder r r r �
get_familyR s
��zToyFontFace.get_familyc C � t �| j�S )u3 Return this font face’s :ref:`FONT_SLANT` string.)r � cairo_toy_font_face_get_slantr r r r r � get_slantW � zToyFontFace.get_slantc C r; )u4 Return this font face’s :ref:`FONT_WEIGHT` string.)r � cairo_toy_font_face_get_weightr r r r r �
get_weight[ r> zToyFontFace.get_weightN) r, r- r. r/ r �FONT_SLANT_NORMAL�FONT_WEIGHT_NORMALr r: r= r@ r r r r r1 = s
� r1 c @ s~ e Zd ZdZd dd�Zdd� Zdd� Zed d
� �Zd d � Z d
d� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd � ZdS ) �
ScaledFonta� Creates 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.
Nc C sV |d u r t � }|�d� |d u rt � }|d u rt� }| �t�|j|j|j|j�� d S )N�
)r �scale� FontOptions�
_init_pointerr �cairo_scaled_font_creater )r � font_face� font_matrix�ctm�optionsr r r r ~ s
�zScaledFont.__init__c C r r )r r r r �cairo_scaled_font_destroyr r r r r r rG � r zScaledFont._init_pointerc C r r )r r �cairo_scaled_font_statusr r r r r r � r zScaledFont._check_statusc C s: | t jkr td��|rt�| � t�t�}t�|| � |S )z�Wrap an existing ``cairo_scaled_font_t *`` cdata pointer.
:type incref: bool
:param incref:
Whether increase the :ref:`reference count <refcounting>` now.
:return: A new :class:`ScaledFont` instance.
r ) r r! r" r �cairo_scaled_font_referencer$ r% rC rG r) r r r r+ � s
zScaledFont._from_pointerc C s t jt�| j�dd�S )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* )r r+ r � cairo_scaled_font_get_font_facer r r r r �
get_font_face� s �zScaledFont.get_font_facec C s t � }t�| j|j� |S )uc Copies the scaled font’s options.
:returns: A new :class:`FontOptions` object.
)rF r �"cairo_scaled_font_get_font_optionsr )r � font_optionsr r r �get_font_options� s
�zScaledFont.get_font_optionsc C �" t � }t�| j|j� | �� |S )ub Copies the scaled font’s font matrix.
:returns: A new :class:`Matrix` object.
)r r �!cairo_scaled_font_get_font_matrixr r �r �matrixr r r �get_font_matrix� s zScaledFont.get_font_matrixc C rU )u1 Copies 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.
)r r �cairo_scaled_font_get_ctmr r rW r r r �get_ctm� s
zScaledFont.get_ctmc C rU )u Copies 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.
)r r �"cairo_scaled_font_get_scale_matrixr r rW r r r �get_scale_matrix� s
�zScaledFont.get_scale_matrixc C s8 t �d�}t�| j|� | �� |j|j|j|j |j
fS )u� Return 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 *) r r r �cairo_scaled_font_extentsr r �ascent�descent�height�
max_x_advance�
max_y_advance)r �extentsr r r rd � s
�zScaledFont.extentsc C sB t �d�}t�| jt|�|� | �� |j|j|j |j
|j |j fS )a� Returns 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:`Context.show_text`).
Additionally, the ``x_advance`` and ``y_advance`` values
indicate the amount by which the current point would be advanced
by :meth:`Context.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.
�cairo_text_extents_t *)
r r r � cairo_scaled_font_text_extentsr r r � x_bearing� y_bearing�widthra � x_advance� y_advance)r �textrd r r r � text_extents� s
��zScaledFont.text_extentsc C sP t �d|�}t �d�}t�| j|t|�|� | �� |j|j|j |j
|j |j fS )a Returns 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:`Context.show_glyphs`).
Additionally, the ``x_advance`` and ``y_advance`` values
indicate the amount by which the current point would be advanced
by :meth:`Context.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[]re )
r r r � cairo_scaled_font_glyph_extentsr �lenr rg rh ri ra rj rk )r �glyphsrd r r r �
glyph_extents s
��zScaledFont.glyph_extentsc s� t �dt j��t �d�}|r t �dt j�� t �d�}t �d�}n t j� t j}t j}t�| j||t|�d�|� ||�
}t ��d tttj ���|rTt �� d tttj
��� t |� �fdd�t |d �D ��|r{� fd d�t |d �D �� �� |d fS �S )
aZ 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 ``with_clusters`` is true, otherwise just ``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 **z cairo_text_cluster_flags_t *���� c s$ g | ]}� | }|j |j|jf�qS r )�index�x�y)�.0�i�glyph)rp r r �
<listcomp>c s
��z-ScaledFont.text_to_glyphs.<locals>.<listcomp>c s g | ] }� | }|j |jf�qS r )� num_bytes�
num_glyphs)rw rx �cluster)�clustersr r rz h s
��)
r r r! r � cairo_scaled_font_text_to_glyphsr r r r �cairo_glyph_free�cairo_text_cluster_freer �range) r ru rv rl �
with_clustersr| � num_clusters�
cluster_flags�statusr )r~ rp r �text_to_glyphs- s8 #
��
�
�zScaledFont.text_to_glyphs)NNN)r, r- r. r/ r rG r r0 r+ rQ rT rY r[ r] rd rm rq r� r r r r rC e s
rC c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z e
Z e Z
dd� Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&S )'rF aT 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 ``set_FEATURE_NAME`` and ``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 ``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
c K s6 | � t�� � |�� D ]
\}}t| d| �|� q d S )N�set_)rG r �cairo_font_options_create�items�getattr)r �values�name�valuer r r r � s �zFontOptions.__init__c C r r )r r r r �cairo_font_options_destroyr r r r r r rG � r zFontOptions._init_pointerc C r r )r r �cairo_font_options_statusr r r r r r � r zFontOptions._check_statusc C s* t | �}t�|�}|�|t�| j�� |S )z7Return a new :class:`FontOptions` with the same values.)�typer$ r% rG r �cairo_font_options_copyr )r �cls�otherr r r �copy� s
zFontOptions.copyc C s$ t �| j|j� tt �| j�� dS )z�Merges non-default options from ``other``,
replacing existing values.
This operation can be thought of as somewhat similar
to compositing other onto options
with the operation of :obj:`OVER <OPERATOR_OVER>`.
N)r �cairo_font_options_merger r r� �r r� r r r �merge� s zFontOptions.mergec C r; r )r �cairo_font_options_hashr r r r r �__hash__� s zFontOptions.__hash__c C s t �| j|j�S r )r �cairo_font_options_equalr r� r r r �__eq__� s zFontOptions.__eq__c C s
| |k S r r r� r r r �__ne__� s
zFontOptions.__ne__c C � t �| j|� | �� dS )z�Changes the :ref:`ANTIALIAS` for the font options object.
This specifies the type of antialiasing to do when rendering text.
N)r � cairo_font_options_set_antialiasr r )r � antialiasr r r �
set_antialias� s zFontOptions.set_antialiasc C r; )z?Return the :ref:`ANTIALIAS` string for the font options object.)r � cairo_font_options_get_antialiasr r r r r �
get_antialias� r> zFontOptions.get_antialiasc C r� )a Changes 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 <ANTIALIAS_SUBPIXEL>`.
N)r �%cairo_font_options_set_subpixel_orderr r )r �subpixel_orderr r r �set_subpixel_order� s � z FontOptions.set_subpixel_orderc C r; )zVReturn the :ref:`SUBPIXEL_ORDER` string
for the font options object.
)r �%cairo_font_options_get_subpixel_orderr r r r r �get_subpixel_order� � z FontOptions.get_subpixel_orderc C r� )z�Changes 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)r �!cairo_font_options_set_hint_styler r )r �
hint_styler r r �set_hint_style� � zFontOptions.set_hint_stylec C r; )z@Return the :ref:`HINT_STYLE` string for the font options object.)r �!cairo_font_options_get_hint_styler r r r r �get_hint_style� r> zFontOptions.get_hint_stylec C r� )z�Changes the :ref:`HINT_METRICS` for the font options object.
This controls whether metrics are quantized
to integer values in device units.
N)r �#cairo_font_options_set_hint_metricsr r )r � hint_metricsr r r �set_hint_metrics� r� z FontOptions.set_hint_metricsc C r; )zTReturn the :ref:`HINT_METRICS` string
for the font options object.
)r �#cairo_font_options_get_hint_metricsr r r r r �get_hint_metrics� r� z FontOptions.get_hint_metricsc C s2 |du rt j}nt|�}t�| j|� | �� dS )a Sets the OpenType font variations for the font options object.
Font variations are specified as a string with a format that is similar
to the CSS font-variation-settings. The string contains a
comma-separated list of axis assignments, which each assignment
consists of a 4-character axis name and a value, separated by
whitespace and optional equals sign.
:param variations: the new font variations, or ``None``.
*New in cairo 1.16.*
*New in cairocffi 0.9.*
N)r r! r r �!cairo_font_options_set_variationsr r �r �
variationsr r r �set_variations� s
zFontOptions.set_variationsc C s, t �| j�}|tjkrt�|��dd�S dS )a Gets the OpenType font variations for the font options object.
See :meth:`set_variations` for details about the
string format.
:return: the font variations for the font options object. The
returned string belongs to the ``options`` and must not be modified.
It is valid until either the font options object is destroyed or the
font variations in this object is modified with
:meth:`set_variations`.
*New in cairo 1.16.*
*New in cairocffi 0.9.*
r r7 N)r �!cairo_font_options_get_variationsr r r! r
r9 r� r r r �get_variations s
�zFontOptions.get_variationsN)r, r- r. r/ r rG r r� r� r� r� r� �equal�hashr� r� r� r� r� r� r� r� r� r� r r r r rF q s, rF N)r/ r2 r r r r r rX r r r$ r r1 �
FONT_TYPE_TOYr& rC rF r r r r �<module> s &$�