Merge branch 'PyFPDF-master'

.all-contributorsrc

@@ -374,7 +374,16 @@
       "avatar_url": "https://avatars.githubusercontent.com/u/24730417?v=4",
       "profile": "https://github.com/Mridulbirla13",
       "contributions": [
-        "doc"
+        "translation"
+      ]
+    },
+    {
+      "login": "digidigital",
+      "name": "digidigital",
+      "avatar_url": "https://avatars.githubusercontent.com/u/28964886?v=4",
+      "profile": "https://github.com/digidigital",
+      "contributions": [
+        "translation"
       ]
     }
   ],

CHANGELOG.md

@@ -19,16 +19,22 @@ and [PEP 440](https://www.python.org/dev/peps/pep-0440/).
 
     5. [Creating Tables](https://pyfpdf.github.io/fpdf2/Tutorial.html#tuto-5-creating-tables)
     6. [Creating links and mixing text styles](https://pyfpdf.github.io/fpdf2/Tutorial.html#tuto-6-creating-links-and-mixing-text-styles)
-- New translation of the tutorial in Hindi, thanks to @Mridulbirla13: [हिंदी संस्करण](https://pyfpdf.github.io/fpdf2/Tutorial-हिंदी.html)
+- New translation of the tutorial in Hindi, thanks to @Mridulbirla13: [हिंदी संस्करण](https://pyfpdf.github.io/fpdf2/Tutorial-हिंदी.html); and [Deutsche](https://pyfpdf.github.io/fpdf2/Tutorial-de.html), thanks to @digidigital
 - While images transparency is still handled by default through the use of `SMask`,
   this can be disabled by setting `pdf.allow_images_transparency = False`
   in order to allow compliance with [PDF/A-1](https://en.wikipedia.org/wiki/PDF/A#Description)
+- [`FPDF.arc`](https://pyfpdf.github.io/fpdf2/fpdf/fpdf.html#fpdf.fpdf.FPDF.arc): new method added. 
+  It enables to draw arcs in a PDF document.
+- [`FPDF.solid_arc`](https://pyfpdf.github.io/fpdf2/fpdf/fpdf.html#fpdf.fpdf.FPDF.solid_arc): new method added.
+  It enables to draw solid arcs in a PDF document. A solid arc combines an arc and a triangle to form a pie slice.
 ### Fixed
 - The exception making the "x2" template field optional for barcode elements did not work correctly, fixed by @gmischler
 ### Changed
 - All template elements now have a transparent default background instead of white, thanks to @gmischler
 - To reduce the size of generated PDFs, no `SMask` entry is inserted for images that are fully opaque
   (= with an alpha channel containing only 0xff characters)
+- The `rect`, `ellipse` & `circle` all have a `style` parameter in common.
+  They now all properly accept a value of `"D"` and raise a `ValueError` for invalid values.
 ### Deprecated
 - `dashed_line()` is now deprecated in favor of `set_dash_pattern()`
 
@@ -71,7 +77,7 @@ and [PEP 440](https://www.python.org/dev/peps/pep-0440/).
 - `Template` `background` property is now properly supported - [#203](https://github.com/PyFPDF/fpdf2/pull/203)
   ⚠️ Beware that its default value changed from `0` to `0xffffff`, as a value of **zero would render the background as black**.
 - `Template.parse_csv`: preserving numeric values when using CSV based templates - [#205](https://github.com/PyFPDF/fpdf2/pull/205)
-- the code snippet to generate Code 39 barcodes in the documentation was missing the start & end `*` characters.
+- the code snippet to generate Code 39 barcodes in the documentation was missing the start & end `*` characters.
 This has been fixed, and a warning is now triggered by the [`FPDF.code39`](https://pyfpdf.github.io/fpdf2/fpdf/fpdf.html#fpdf.fpdf.FPDF.code39) method when those characters are missing.
 ### Fixed
 - Detect missing `uni=True` when loading cached fonts (page numbering was missing digits)

README.md

@@ -81,7 +81,7 @@ Documentation:
 --------------
 
 - [Documentation Home](https://pyfpdf.github.io/fpdf2/)
-- Tutorial in several languages: [English](https://pyfpdf.github.io/fpdf2/Tutorial.html) - [Spanish](https://pyfpdf.github.io/fpdf2/Tutorial-es.html) - [हिंदी](https://pyfpdf.github.io/fpdf2/Tutorial-हिंदी.html)
+- Tutorial in several languages: [English](https://pyfpdf.github.io/fpdf2/Tutorial.html) - [Deutsche](https://pyfpdf.github.io/fpdf2/Tutorial-de.html) - [Spanish](https://pyfpdf.github.io/fpdf2/Tutorial-es.html) - [हिंदी](https://pyfpdf.github.io/fpdf2/Tutorial-हिंदी.html)
 - Release notes: [CHANGELOG.md](https://github.com/PyFPDF/fpdf2/blob/master/CHANGELOG.md)
 
 You can also have a look at the `tests/`, they're great usage examples!
@@ -146,7 +146,8 @@ This library could only exist thanks to the dedication of many volunteers around
   </tr>
   <tr>
     <td align="center"><a href="https://github.com/tabarnhack"><img src="https://avatars.githubusercontent.com/u/34366899?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tabarnhack</b></sub></a><br /><a href="https://github.com/PyFPDF/fpdf2/commits?author=tabarnhack" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/Mridulbirla13"><img src="https://avatars.githubusercontent.com/u/24730417?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Mridul Birla</b></sub></a><br /><a href="https://github.com/PyFPDF/fpdf2/commits?author=Mridulbirla13" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/Mridulbirla13"><img src="https://avatars.githubusercontent.com/u/24730417?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Mridul Birla</b></sub></a><br /><a href="https://github.com/PyFPDF/fpdf2/commits?author=Mridulbirla13" title="Translation">🌍</a></td>
+    <td align="center"><a href="https://github.com/digidigital"><img src="https://avatars.githubusercontent.com/u/28964886?v=4?s=100" width="100px;" alt=""/><br /><sub><b>digidigital</b></sub></a><br /><a href="https://github.com/PyFPDF/fpdf2/commits?author=digidigital" title="Translation">🌍</a></td>
   </tr>
 </table>
 

docs/Shapes.md

@@ -71,3 +71,29 @@ coords = ((100, 0), (5, 69), (41, 181), (159, 181), (195, 69))
 pdf.polygon(coords, fill=True)
 pdf.output("polygon.pdf")
 ```
+
+## Arc ##
+
+```python
+from fpdf import FPDF
+
+pdf = FPDF()
+pdf.add_page()
+pdf.set_line_width(2)
+pdf.set_fill_color(r=255, g=0, b=0)
+pdf.arc(x=75, y=75, a=25, b=25, start_angle=30, end_angle=130, style="FD")
+pdf.output("arc.pdf")
+```
+
+## Solid arc ##
+
+```python
+from fpdf import FPDF
+
+pdf = FPDF()
+pdf.add_page()
+pdf.set_line_width(2)
+pdf.set_fill_color(r=255, g=0, b=0)
+pdf.solid_arc(x=75, y=75, a=25, b=25, start_angle=30, end_angle=130, style="FD")
+pdf.output("solid_arc.pdf")
+```