File: identity.rst

package info (click to toggle)
pymupdf 1.17.4%2Bds1-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 5,956 kB
  • sloc: python: 3,967; sh: 38; makefile: 7
file content (16 lines) | stat: -rw-r--r-- 757 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
.. _Identity:

============
Identity
============

Identity is a :ref:`Matrix` that performs no action -- to be used whenever the syntax requires a matrix, but no actual transformation should take place. It has the form *fitz.Matrix(1, 0, 0, 1, 0, 0)*.

Identity is a constant, an "immutable" object. So, all of its matrix properties are read-only and its methods are disabled.

If you need a **mutable** identity matrix as a starting point, use one of the following statements::

    >>> m = fitz.Matrix(1, 0, 0, 1, 0, 0)  # specify the values
    >>> m = fitz.Matrix(1, 1)              # use scaling by factor 1
    >>> m = fitz.Matrix(0)                 # use rotation by zero degrees
    >>> m = fitz.Matrix(fitz.Identity)     # make a copy of Identity