| 1 | # DrawingML preset geometry data provenance |
| 2 | |
| 3 | ## Apache POI notice |
| 4 | |
| 5 | Apache POI |
| 6 | |
| 7 | Copyright 2003-2025 The Apache Software Foundation |
| 8 | |
| 9 | This product includes software developed at |
| 10 | |
| 11 | The Apache Software Foundation (<https://www.apache.org/>). |
| 12 | |
| 13 | ## Vendored data |
| 14 | |
| 15 | `presetShapeDefinitions.xml` is vendored from Apache POI 5.4.1: |
| 16 | |
| 17 | - Release tag: `REL_5_4_1` |
| 18 | - Source commit: `4554f204cbbf00ecbcaed134fe57e43a1779a612` |
| 19 | - Source path: `poi/src/main/resources/org/apache/poi/sl/draw/geom/presetShapeDefinitions.xml` |
| 20 | - Source revision: <https://github.com/apache/poi/tree/4554f204cbbf00ecbcaed134fe57e43a1779a612> |
| 21 | - Original release-file SHA-256: |
| 22 | `a7dad593d27bd70536b41da9b761fa16409536cc0c25ef2b6c7a61c5d9b3e738` |
| 23 | - Vendored SHA-256: `4a762444d8d85876881c02a5b1dedf6f73006fcd8acb7b4e393435615b37c780` |
| 24 | - Modification: line endings normalized from the release JAR's mixed CRLF/LF to LF; XML content is otherwise unchanged. |
| 25 | - License: Apache License 2.0; see `LICENSE-APACHE-2.0.txt`. |
| 26 | |
| 27 | The independent completeness list in `shape_type_values.txt` is derived from |
| 28 | the Open XML SDK schema metadata for `a:ST_ShapeType` / `ShapeTypeValues`: |
| 29 | |
| 30 | - Repository: `dotnet/Open-XML-SDK` |
| 31 | - Source commit: `00967dc871f06776ae969762c6703d062308a6c9` |
| 32 | - Source path: `data/schemas/schemas_openxmlformats_org_drawingml_2006_main.json` |
| 33 | - Source revision: |
| 34 | <https://github.com/dotnet/Open-XML-SDK/tree/00967dc871f06776ae969762c6703d062308a6c9> |
| 35 | - Source-file SHA-256: |
| 36 | `e760b534c96ee02745d2a8084f1be362826da4470a85d0b0102a67c3b1678ab7` |
| 37 | - Vendored enum-list SHA-256: |
| 38 | `f2c3bdcda8569b358ce3196cfeb183849e33bfc7955fac961dc85fceb6b3b587` |
| 39 | - License: MIT (`dotnet/Open-XML-SDK`); see |
| 40 | `LICENSE-OPEN-XML-SDK-MIT.txt`. |
| 41 | |
| 42 | At the locked revisions, both sources contain exactly 187 unique preset names, |
| 43 | and their sets are identical. |
| 44 | |
| 45 | ## Evaluator compatibility notes |
| 46 | |
| 47 | - The circular-arrow, left-circular-arrow, and left-right-circular-arrow |
| 48 | definitions each contain `+- xH 0 dxB 0`. Apache POI evaluates the first |
| 49 | three operands and ignores the inert final zero. The PPT Master evaluator |
| 50 | accepts only this trailing-zero compatibility form; other arity mismatches |
| 51 | remain errors. |
| 52 | - A small number of definitions rebind an intermediate guide name later in |
| 53 | the ordered `gdLst`. Evaluation therefore preserves document order and the |
| 54 | later value replaces the earlier value, matching Apache POI behavior. |
| 55 |