Publish v1.13.5: extended PDF form fields support

Author: JorjMcKie

.travis.yml

@@ -39,6 +39,7 @@ install:
 - "$PIP install cibuildwheel==0.8.0"
 - mkdir mupdf && wget -q $MUPDF -O - | tar zx -C mupdf --strip-components=1
 - cp fitz/_mupdf_config.h mupdf/include/mupdf/fitz/config.h
+- cp fitz/_pdf-op-filter.c mupdf/source/pdf/pdf-op-filter.c
 script:
 - export CIBW_ENVIRONMENT='CFLAGS="-fPIC -std=gnu99"'
 - export CIBW_SKIP="cp33-* *i686"

README.md

@@ -1,4 +1,4 @@
-# PyMuPDF 1.13.4 [![Build Status](https://travis-ci.org/rk700/PyMuPDF.svg?branch=master)](https://travis-ci.org/rk700/PyMuPDF)
+# PyMuPDF 1.13.5 [![Build Status](https://travis-ci.org/rk700/PyMuPDF.svg?branch=master)](https://travis-ci.org/rk700/PyMuPDF)
 
 ![logo](https://github.com/rk700/PyMuPDF/blob/master/demo/pymupdf.jpg)
 
@@ -10,7 +10,7 @@ Release date: May 11, 2018
 
 # Introduction
 
-This is **version 1.13.4 of PyMuPDF (formerly python-fitz)**, a Python binding with support for [MuPDF 1.13.0](http://mupdf.com/) - "a lightweight PDF and XPS viewer".
+This is **version 1.13.5 of PyMuPDF (formerly python-fitz)**, a Python binding with support for [MuPDF 1.13.0](http://mupdf.com/) - "a lightweight PDF and XPS viewer".
 
 MuPDF can access files in PDF, XPS, OpenXPS, CBZ, EPUB and FB2 (e-books) formats, and it is known for its top performance and high rendering quality.
 

demo/README.md

@@ -2,30 +2,30 @@
 
 Program | Purpose
 ------- | -------
-[caustic.py](https://github.com/rk700/pymupdf/blob/master/demo/caustic.py) | demo producing a PDF with a caustic image
-[check-fields.py](https://github.com/rk700/pymupdf/blob/master/demo/check-fields.py) | prints field information for a Form PDF
-[demo.py](https://github.com/rk700/pymupdf/blob/master/demo/demo.py) | demonstrates a broad range of PyMuPDF high-level functions
-[demo-lowlevel.py](https://github.com/rk700/pymupdf/blob/master/demo/demo-lowlevel.py) | demonstrates PyMuPDF low-level functions
-[draw-sines.py](https://github.com/rk700/pymupdf/blob/master/demo/draw-sines.py) | draw sine / cosine functions
-[extract-img1.py](https://github.com/rk700/pymupdf/blob/master/demo/extract_img1.py) | PDF only: extracts all **page-referenced** images as PNG files
-[extract-img2.py](https://github.com/rk700/pymupdf/blob/master/demo/extract_img2.py) | PDF only: extracts **all** (valid) images as PNG files
-[extract-img3.py](https://github.com/rk700/pymupdf/blob/master/demo/extract_img3.py) | PDF only: extracts page images using raw image buffers (variable extensions)
-[extract-img4.py](https://github.com/rk700/pymupdf/blob/master/demo/extract_img4.py) | Any Document type: extracts page images (with variable extensions) using the v1.13.1 getText("dict") method
-[fitz2PIL.py](https://github.com/rk700/pymupdf/blob/master/demo/fitz2PIL.py) | save a pixmap as a PIL / Pillow supported file
-[PIL2fitz.py](https://github.com/rk700/pymupdf/blob/master/demo/PIL2fitz.py) | create a pixmap from any PIL / Pillow supported file
-[numpy2fitz.py](https://github.com/rk700/pymupdf/blob/master/demo/numpy2fitz.py) | how to create pixmaps from NumPy arrays
-[PDFdisplay.py](https://github.com/rk700/pymupdf/blob/master/demo/PDFdisplay.py) | display a document using wxPython
-[pdfviewer(wx).py](https://github.com/rk700/pymupdf/blob/master/demo/pdfviewer(wx).py) | alternative wxPython viewer
-[pencil.py](https://github.com/rk700/pymupdf/blob/master/demo/pencil.py) | create the pencil of the ReportLab User Guide with PyMuPDF
-[piechart1.py](https://github.com/rk700/pymupdf/blob/master/demo/piechart1.py) | create a circular pie chart
-[piechart2.py](https://github.com/rk700/pymupdf/blob/master/demo/piechart2.py) | create a semi-circular pie chart
-[pixmap-tiles.py](https://github.com/rk700/pymupdf/blob/master/demo/pixmap.py) | use pixmap to create tiled copies of an image file
-[decrypt.py](https://github.com/rk700/pymupdf/blob/master/demo/removePass.py) | create a decrypted copy of a PDF file
-[sierpinski.py](https://github.com/rk700/pymupdf/blob/master/demo/sierpinski.py) | create a Sierpinski carpet (fractal) fast with pixmaps
-[splitter.py](https://github.com/rk700/pymupdf/blob/master/demo/splitter.py) | split a PDF into its pages (1 PDF per page)
-[fitz-logo.py](https://github.com/rk700/pymupdf/blob/master/demo/svg-logo.py) | put any document as logo an each PDF page.
-[svg-logo.py](https://github.com/rk700/pymupdf/blob/master/demo/svg-logo.py) | put an SVG as logo an each PDF page.
-[spumoni.py](https://github.com/rk700/pymupdf/blob/master/demo/spumoni.py) | create the ReportLab drawing on page 26 with PyMuPDF
-[text2pdf.py](https://github.com/rk700/pymupdf/blob/master/demo/text2pdf.py) | convert a text file to PDF
-[wavy-polygon.py](https://github.com/rk700/pymupdf/blob/master/demo/wavy-polygon.py) | draw a regular polygon with curly borders
-[xps-converter.py](https://github.com/rk700/pymupdf/blob/master/demo/xps-converter.py) | convert arbitrary documents to PDF (XPS, EPUB, etc.)
+caustic.py | demo producing a PDF with the catacaustic
+list-fields.py | prints field information for a Form PDF
+demo.py | demonstrates a broad range of PyMuPDF high-level functions
+demo-lowlevel.py | demonstrates PyMuPDF low-level functions
+draw-sines.py | draw sine / cosine functions
+extract-img1.py | PDF only: extracts all **page-referenced** images as PNG files
+extract-img2.py | PDF only: extracts **all** (valid) images as PNG files
+extract-img3.py | PDF only: extracts page images using raw image buffers (variable extensions)
+extract-img4.py | Any Document type: extracts page images (with variable extensions) using the v1.13.1 getText("dict") method
+fitz2PIL.py | save a pixmap as a PIL / Pillow supported file
+PIL2fitz.py | create a pixmap from any PIL / Pillow supported file
+numpy2fitz.py | how to create pixmaps from NumPy arrays
+PDFdisplay.py | display a document using wxPython
+pdfviewer(wx).py | alternative wxPython viewer
+pencil.py | create the pencil of the ReportLab User Guide with PyMuPDF
+piechart1.py | create a circular pie chart
+piechart2.py | create a semi-circular pie chart
+pixmap-tiles.py | use pixmap to create tiled copies of an image file
+decrypt.py | create a decrypted copy of a PDF file
+sierpinski.py | create a Sierpinski carpet (fractal) fast with pixmaps
+splitter.py | split a PDF into its pages (1 PDF per page)
+fitz-logo.py | put any document as logo an each PDF page.
+svg-logo.py | put an SVG as logo an each PDF page.
+spumoni.py | create the ReportLab drawing on page 26 with PyMuPDF
+text2pdf.py | convert a text file to PDF
+wavy-polygon.py | draw a regular polygon with curly borders
+xps-converter.py | convert arbitrary documents to PDF (XPS, EPUB, CBZ, etc.)

demo/check-fields.py

@@ -0,0 +1,71 @@
+"""
+A demo showing all PDF form fields of a document.
+"""
+import sys
+import fitz
+doc = fitz.open(sys.argv[1])
+if not doc.isFormPDF:
+    raise SystemExit("PDF has no form fields.")
+for page in doc:
+    a = page.firstAnnot
+    header_shown = False
+
+    while a:
+        if a.type[0] != fitz.ANNOT_WIDGET:
+            a = a.next
+            continue
+        if not header_shown:
+            print("\nShowing the form fields of page", page.number)
+            print("".ljust(80, "-"))
+            header_shown = True
+        print("\nField type '%s', name '%s', value '%s'" % (a.widget_type[1],
+        a.widget_name, a.widget_value))
+        if a.widget_type[0] in (4, 5):      # listbox / combobox
+            print("... from possible values:", a.widget_choices, "\n")
+        a = a.next
+
+"""
+Above script may produce the following output:
+
+Showing the form fields of page 0
+--------------------------------------------------------------------------------
+
+Field type 'Text', name 'Given Name Text Box', value 'Jorj X.'
+
+Field type 'Text', name 'Family Name Text Box', value 'McKie'
+
+Field type 'Text', name 'Address 1 Text Box', value 'House near the Beach'
+
+Field type 'Text', name 'House nr Text Box', value '4711'
+
+Field type 'Text', name 'Address 2 Text Box', value 'A Secret Place'
+
+Field type 'Text', name 'Postcode Text Box', value '314159'
+
+Field type 'Text', name 'City Text Box', value 'Valetta'
+
+Field type 'ComboBox', name 'Country Combo Box', value 'Malta'
+... from possible values: ['Austria', 'Belgium', 'Britain', 'Bulgaria', 'Croatia', 'Cyprus', 'Czech-Republic', 'Denmark', 'Estonia', 'Finland', 'France', 'Germany', 'Greece', 'Hungary', 'Ireland', 'Italy', 'Latvia', 'Lithuania', 'Luxembourg', 'Malta', 'Netherlands', 'Poland', 'Portugal', 'Romania', 'Slovakia', 'Slovenia', 'Spain', 'Sweden']
+
+
+Field type 'ComboBox', name 'Gender List Box', value 'Man'
+... from possible values: ['Man', 'Woman']
+
+
+Field type 'Text', name 'Height Formatted Field', value '180'
+
+Field type 'CheckBox', name 'Driving License Check Box', value 'True'
+
+Field type 'CheckBox', name 'Language 1 Check Box', value 'True'
+
+Field type 'CheckBox', name 'Language 2 Check Box', value 'True'
+
+Field type 'CheckBox', name 'Language 3 Check Box', value 'False'
+
+Field type 'CheckBox', name 'Language 4 Check Box', value 'False'
+
+Field type 'CheckBox', name 'Language 5 Check Box', value 'False'
+
+Field type 'ComboBox', name 'Favourite Colour List Box', value 'Blue'
+... from possible values: ['Black', 'Brown', 'Red', 'Orange', 'Yellow', 'Green', 'Blue', 'Violet', 'Grey', 'White']
+"""