3 |ўQ@s,dZddlmZmZmZGdddeZdS)z cairocffi.matrix ~~~~~~~~~~~~~~~~ Transformation matrices. :copyright: Copyright 2013 by Simon Sapin :license: BSD, see LICENSE for details. )fficairo _check_statusc@seZdZdZd/ddZeddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZeZddZd0ddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zed)Zed*Zed+Zed,Zed-Zed.Z[dS)1MatrixaA 2D transformation matrix. Matrices are used throughout cairo to convert between different coordinate spaces. A :class:`Matrix` holds an affine transformation, such as a scale, rotation, shear, or a combination of these. The transformation of a point (x,y) is given by:: x_new = xx * x + xy * y + x0 y_new = yx * x + yy * y + y0 The current transformation matrix of a :class:`Context`, represented as a :class:`Matrix`, defines the transformation from user-space coordinates to device-space coordinates. See :meth:`Context.get_matrix` and :meth:`Context.set_matrix`. The default values produce an identity matrix. Matrices can be compared with ``m1 == m2`` and ``m2 != m2`` as well as multiplied with ``m3 = m1 * m2``. rcCs(tjd|_tj|j||||||dS)Nzcairo_matrix_t *)rnew_pointerrZcairo_matrix_init)selfxxyxxyyyx0y0rP/var/www/html/enquirykeeper_venv/lib/python3.6/site-packages/cairocffi/matrix.py__init__(s zMatrix.__init__cCs|}tj|j||S)aReturn a new :class:`Matrix` for a transformation that rotates by :obj:`radians`. :type radians: float :param radians: Angle of rotation, in radians. The direction of rotation is defined such that positive angles rotate in the direction from the positive X axis toward the positive Y axis. With the default axis orientation of cairo, positive angles rotate in a clockwise direction. )rZcairo_matrix_init_rotater)clsradiansresultrrr init_rotate,szMatrix.init_rotatecCs"|j}|j|j|j|j|j|jfS)uuReturn all of the matrix’s components. :returns: A ``(xx, yx, xy, yy, x0, y0)`` tuple of floats. )rr r r r rr)r ptrrrras_tuple?szMatrix.as_tuplecCst||jS)z!Return a new copy of this matrix.)typer)r rrrcopyHsz Matrix.copycCst|jd|S)Nr r r r rr)r r r r rr)getattrr)r indexrrr __getitem__LszMatrix.__getitem__cCs t|jS)N)iterr)r rrr__iter__PszMatrix.__iter__cCs|j|jkS)N)r)r otherrrr__eq__Ssz Matrix.__eq__cCs|j|jkS)N)r)r r rrr__ne__Vsz Matrix.__ne__cCst|}d|jf|jS)Nz%s(%g, %g, %g, %g, %g, %g))r__name__r)r class_rrr__repr__YszMatrix.__repr__cCst}tj|j|j|j|S)zMultiply with another matrix and return the result as a new :class:`Matrix` object. Same as ``self * other``. )rrZcairo_matrix_multiplyr)r r resrrrmultiply^szMatrix.multiplycCstj|j||dS)aApplies a translation by :obj:`tx`, :obj:`ty` to the transformation in this matrix. The effect of the new transformation is to first translate the coordinates by :obj:`tx` and :obj:`ty`, then apply the original transformation to the coordinates. .. note:: This changes the matrix in-place. :param tx: Amount to translate in the X direction. :param ty: Amount to translate in the Y direction. :type tx: float :type ty: float N)rZcairo_matrix_translater)r Ztxtyrrr translatekszMatrix.translateNcCs |dkr |}tj|j||dS)a_Applies scaling by :obj:`sx`, :obj:`sy` to the transformation in this matrix. The effect of the new transformation is to first scale the coordinates by :obj:`sx` and :obj:`sy`, then apply the original transformation to the coordinates. If :obj:`sy` is omitted, it is the same as :obj:`sx` so that scaling preserves aspect ratios. .. note:: This changes the matrix in-place. :param sx: Scale factor in the X direction. :param sy: Scale factor in the Y direction. :type sx: float :type sy: float N)rZcairo_matrix_scaler)r ZsxZsyrrrscale~sz Matrix.scalecCstj|j|dS)aApplies a rotation by :obj:`radians` to the transformation in this matrix. The effect of the new transformation is to first rotate the coordinates by :obj:`radians`, then apply the original transformation to the coordinates. .. note:: This changes the matrix in-place. :type radians: float :param radians: Angle of rotation, in radians. The direction of rotation is defined such that positive angles rotate in the direction from the positive X axis toward the positive Y axis. With the default axis orientation of cairo, positive angles rotate in a clockwise direction. N)rZcairo_matrix_rotater)r rrrrrotatesz Matrix.rotatecCsttj|jdS)auChanges matrix to be the inverse of its original value. Not all transformation matrices have inverses; if the matrix collapses points together (it is degenerate), then it has no inverse and this function will fail. .. note:: This changes the matrix in-place. :raises: :exc:`CairoError` on degenerate matrices. N)rrZcairo_matrix_invertr)r rrrinverts z Matrix.invertcCs|j}|j|S)zReturn the inverse of this matrix. See :meth:`invert`. :raises: :exc:`CairoError` on degenerate matrices. :returns: A new :class:`Matrix` object. )rr,)r ZmatrixrrrinvertedszMatrix.invertedcCs0tjd||g}tj|j|d|dt|S)zTransforms the point ``(x, y)`` by this matrix. :param x: X position. :param y: Y position. :type x: float :type y: float :returns: A ``(new_x, new_y)`` tuple of floats. z double[2]rr)rrrZcairo_matrix_transform_pointrtuple)r xyr rrrtransform_points zMatrix.transform_pointcCs0tjd||g}tj|j|d|dt|S)a]Transforms the distance vector ``(dx, dy)`` by this matrix. This is similar to :meth:`transform_point` except that the translation components of the transformation are ignored. The calculation of the returned vector is as follows:: dx2 = dx1 * xx + dy1 * xy dy2 = dx1 * yx + dy1 * yy Affine transformations are position invariant, so the same vector always transforms to the same vector. If ``(x1, y1)`` transforms to ``(x2, y2)`` then ``(x1 + dx1, y1 + dy1)`` will transform to ``(x1 + dx2, y1 + dy2)`` for all values of ``x1`` and ``x2``. :param dx: X component of a distance vector. :param dy: Y component of a distance vector. :type dx: float :type dy: float :returns: A ``(new_dx, new_dy)`` tuple of floats. z double[2]rr)rrrZcairo_matrix_transform_distancerr.)r ZdxZdyr rrrtransform_distanceszMatrix.transform_distancecstfddfddddS)Ncs t|jS)N)rr)r )namerrsz,Matrix._component_property..cst|j|S)N)setattrr)r value)r3rrr4sz8Read-write attribute access to a single float component.)doc)property)r3r)r3r_component_propertys  zMatrix._component_propertyr r r r rr)rrrrrr)N)r# __module__ __qualname____doc__r classmethodrrrrrr!r"r%r'__mul__r)r*r+r,r-r1r2r9r r r r rrrrrrrs6      rN)r<rrrobjectrrrrr s