ruby_pptx 0.1.0

data/lib/ruby_pptx/autoshape_spec.rb

@@ -0,0 +1,337 @@
+# frozen_string_literal: true
+
+# Generated by tools/generate_autoshape_spec.py from python-pptx. Do not edit by hand.
+
+require "ruby_pptx/enum/shapes"
+
+module Pptx
+  # Per auto-shape-type metadata: the name PowerPoint gives a new shape
+  # of that type, and the default values of its adjustment handles.
+  module AutoShapeSpec
+    SPECS = {
+      ACTION_BUTTON_BACK_OR_PREVIOUS: { basename: "Action Button: Back or Previous",
+                                        default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_BEGINNING: { basename: "Action Button: Beginning",
+                                 default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_CUSTOM: { basename: "Action Button: Custom", default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_DOCUMENT: { basename: "Action Button: Document", default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_END: { basename: "Action Button: End", default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_FORWARD_OR_NEXT: { basename: "Action Button: Forward or Next",
+                                       default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_HELP: { basename: "Action Button: Help", default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_HOME: { basename: "Action Button: Home", default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_INFORMATION: { basename: "Action Button: Information",
+                                   default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_MOVIE: { basename: "Action Button: Movie", default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_RETURN: { basename: "Action Button: Return", default_adjustments: [].freeze }.freeze,
+      ACTION_BUTTON_SOUND: { basename: "Action Button: Sound", default_adjustments: [].freeze }.freeze,
+      ARC: { basename: "Arc", default_adjustments: [["adj1", 16_200_000], ["adj2", 0]].freeze }.freeze,
+      BALLOON: { basename: "Rounded Rectangular Callout",
+                 default_adjustments: [["adj1", -20833], ["adj2", 62500], ["adj3", 16667]].freeze }.freeze,
+      BENT_ARROW: { basename: "Bent Arrow",
+                    default_adjustments: [["adj1", 25000], ["adj2", 25000], ["adj3", 25000],
+                                          ["adj4", 43750]].freeze }.freeze,
+      BENT_UP_ARROW: { basename: "Bent-Up Arrow",
+                       default_adjustments: [["adj1", 25000], ["adj2", 25000],
+                                             ["adj3", 25000]].freeze }.freeze,
+      BEVEL: { basename: "Bevel", default_adjustments: [["adj", 12500]].freeze }.freeze,
+      BLOCK_ARC: { basename: "Block Arc",
+                   default_adjustments: [["adj1", 10_800_000], ["adj2", 0], ["adj3", 25000]].freeze }.freeze,
+      CAN: { basename: "Can", default_adjustments: [["adj", 25000]].freeze }.freeze,
+      CHART_PLUS: { basename: "Chart Plus", default_adjustments: [].freeze }.freeze,
+      CHART_STAR: { basename: "Chart Star", default_adjustments: [].freeze }.freeze,
+      CHART_X: { basename: "Chart X", default_adjustments: [].freeze }.freeze,
+      CHEVRON: { basename: "Chevron", default_adjustments: [["adj", 50000]].freeze }.freeze,
+      CHORD: { basename: "Chord",
+               default_adjustments: [["adj1", 2_700_000], ["adj2", 16_200_000]].freeze }.freeze,
+      CIRCULAR_ARROW: { basename: "Circular Arrow",
+                        default_adjustments: [["adj1", 12500], ["adj2", 1_142_319], ["adj3", 20_457_681], ["adj4", 10_800_000],
+                                              ["adj5", 12500]].freeze }.freeze,
+      CLOUD: { basename: "Cloud", default_adjustments: [].freeze }.freeze,
+      CLOUD_CALLOUT: { basename: "Cloud Callout",
+                       default_adjustments: [["adj1", -20833], ["adj2", 62500]].freeze }.freeze,
+      CORNER: { basename: "Corner", default_adjustments: [["adj1", 50000], ["adj2", 50000]].freeze }.freeze,
+      CORNER_TABS: { basename: "Corner Tabs", default_adjustments: [].freeze }.freeze,
+      CROSS: { basename: "Cross", default_adjustments: [["adj", 25000]].freeze }.freeze,
+      CUBE: { basename: "Cube", default_adjustments: [["adj", 25000]].freeze }.freeze,
+      CURVED_DOWN_ARROW: { basename: "Curved Down Arrow",
+                           default_adjustments: [["adj1", 25000], ["adj2", 50000],
+                                                 ["adj3", 25000]].freeze }.freeze,
+      CURVED_DOWN_RIBBON: { basename: "Curved Down Ribbon",
+                            default_adjustments: [["adj1", 25000], ["adj2", 50000],
+                                                  ["adj3", 12500]].freeze }.freeze,
+      CURVED_LEFT_ARROW: { basename: "Curved Left Arrow",
+                           default_adjustments: [["adj1", 25000], ["adj2", 50000],
+                                                 ["adj3", 25000]].freeze }.freeze,
+      CURVED_RIGHT_ARROW: { basename: "Curved Right Arrow",
+                            default_adjustments: [["adj1", 25000], ["adj2", 50000],
+                                                  ["adj3", 25000]].freeze }.freeze,
+      CURVED_UP_ARROW: { basename: "Curved Up Arrow",
+                         default_adjustments: [["adj1", 25000], ["adj2", 50000],
+                                               ["adj3", 25000]].freeze }.freeze,
+      CURVED_UP_RIBBON: { basename: "Curved Up Ribbon",
+                          default_adjustments: [["adj1", 25000], ["adj2", 50000],
+                                                ["adj3", 12500]].freeze }.freeze,
+      DECAGON: { basename: "Decagon", default_adjustments: [["vf", 105_146]].freeze }.freeze,
+      DIAGONAL_STRIPE: { basename: "Diagonal Stripe", default_adjustments: [["adj", 50000]].freeze }.freeze,
+      DIAMOND: { basename: "Diamond", default_adjustments: [].freeze }.freeze,
+      DODECAGON: { basename: "Dodecagon", default_adjustments: [].freeze }.freeze,
+      DONUT: { basename: "Donut", default_adjustments: [["adj", 25000]].freeze }.freeze,
+      DOUBLE_BRACE: { basename: "Double Brace", default_adjustments: [["adj", 8333]].freeze }.freeze,
+      DOUBLE_BRACKET: { basename: "Double Bracket", default_adjustments: [["adj", 16667]].freeze }.freeze,
+      DOUBLE_WAVE: { basename: "Double Wave",
+                     default_adjustments: [["adj1", 6250], ["adj2", 0]].freeze }.freeze,
+      DOWN_ARROW: { basename: "Down Arrow",
+                    default_adjustments: [["adj1", 50000], ["adj2", 50000]].freeze }.freeze,
+      DOWN_ARROW_CALLOUT: { basename: "Down Arrow Callout",
+                            default_adjustments: [["adj1", 25000], ["adj2", 25000], ["adj3", 25000],
+                                                  ["adj4", 64977]].freeze }.freeze,
+      DOWN_RIBBON: { basename: "Down Ribbon",
+                     default_adjustments: [["adj1", 16667], ["adj2", 50000]].freeze }.freeze,
+      EXPLOSION1: { basename: "Explosion", default_adjustments: [].freeze }.freeze,
+      EXPLOSION2: { basename: "Explosion", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_ALTERNATE_PROCESS: { basename: "Alternate process", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_CARD: { basename: "Card", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_COLLATE: { basename: "Collate", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_CONNECTOR: { basename: "Connector", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_DATA: { basename: "Data", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_DECISION: { basename: "Decision", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_DELAY: { basename: "Delay", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_DIRECT_ACCESS_STORAGE: { basename: "Direct Access Storage",
+                                         default_adjustments: [].freeze }.freeze,
+      FLOWCHART_DISPLAY: { basename: "Display", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_DOCUMENT: { basename: "Document", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_EXTRACT: { basename: "Extract", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_INTERNAL_STORAGE: { basename: "Internal Storage", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_MAGNETIC_DISK: { basename: "Magnetic Disk", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_MANUAL_INPUT: { basename: "Manual Input", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_MANUAL_OPERATION: { basename: "Manual Operation", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_MERGE: { basename: "Merge", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_MULTIDOCUMENT: { basename: "Multidocument", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_OFFLINE_STORAGE: { basename: "Offline Storage", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_OFFPAGE_CONNECTOR: { basename: "Off-page Connector", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_OR: { basename: "Or", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_PREDEFINED_PROCESS: { basename: "Predefined Process", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_PREPARATION: { basename: "Preparation", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_PROCESS: { basename: "Process", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_PUNCHED_TAPE: { basename: "Punched Tape", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_SEQUENTIAL_ACCESS_STORAGE: { basename: "Sequential Access Storage",
+                                             default_adjustments: [].freeze }.freeze,
+      FLOWCHART_SORT: { basename: "Sort", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_STORED_DATA: { basename: "Stored Data", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_SUMMING_JUNCTION: { basename: "Summing Junction", default_adjustments: [].freeze }.freeze,
+      FLOWCHART_TERMINATOR: { basename: "Terminator", default_adjustments: [].freeze }.freeze,
+      FOLDED_CORNER: { basename: "Folded Corner", default_adjustments: [].freeze }.freeze,
+      FRAME: { basename: "Frame", default_adjustments: [["adj1", 12500]].freeze }.freeze,
+      FUNNEL: { basename: "Funnel", default_adjustments: [].freeze }.freeze,
+      GEAR_6: { basename: "Gear 6", default_adjustments: [["adj1", 15000], ["adj2", 3526]].freeze }.freeze,
+      GEAR_9: { basename: "Gear 9", default_adjustments: [["adj1", 10000], ["adj2", 1763]].freeze }.freeze,
+      HALF_FRAME: { basename: "Half Frame",
+                    default_adjustments: [["adj1", 33333], ["adj2", 33333]].freeze }.freeze,
+      HEART: { basename: "Heart", default_adjustments: [].freeze }.freeze,
+      HEPTAGON: { basename: "Heptagon",
+                  default_adjustments: [["hf", 102_572], ["vf", 105_210]].freeze }.freeze,
+      HEXAGON: { basename: "Hexagon", default_adjustments: [["adj", 25000], ["vf", 115_470]].freeze }.freeze,
+      HORIZONTAL_SCROLL: { basename: "Horizontal Scroll",
+                           default_adjustments: [["adj", 12500]].freeze }.freeze,
+      ISOSCELES_TRIANGLE: { basename: "Isosceles Triangle",
+                            default_adjustments: [["adj", 50000]].freeze }.freeze,
+      LEFT_ARROW: { basename: "Left Arrow",
+                    default_adjustments: [["adj1", 50000], ["adj2", 50000]].freeze }.freeze,
+      LEFT_ARROW_CALLOUT: { basename: "Left Arrow Callout",
+                            default_adjustments: [["adj1", 25000], ["adj2", 25000], ["adj3", 25000],
+                                                  ["adj4", 64977]].freeze }.freeze,
+      LEFT_BRACE: { basename: "Left Brace",
+                    default_adjustments: [["adj1", 8333], ["adj2", 50000]].freeze }.freeze,
+      LEFT_BRACKET: { basename: "Left Bracket", default_adjustments: [["adj", 8333]].freeze }.freeze,
+      LEFT_CIRCULAR_ARROW: { basename: "Left Circular Arrow",
+                             default_adjustments: [["adj1", 12500], ["adj2", -1_142_319], ["adj3", 1_142_319], ["adj4", 10_800_000],
+                                                   ["adj5", 12500]].freeze }.freeze,
+      LEFT_RIGHT_ARROW: { basename: "Left-Right Arrow",
+                          default_adjustments: [["adj1", 50000], ["adj2", 50000]].freeze }.freeze,
+      LEFT_RIGHT_ARROW_CALLOUT: { basename: "Left-Right Arrow Callout",
+                                  default_adjustments: [["adj1", 25000], ["adj2", 25000], ["adj3", 25000],
+                                                        ["adj4", 48123]].freeze }.freeze,
+      LEFT_RIGHT_CIRCULAR_ARROW: { basename: "Left Right Circular Arrow",
+                                   default_adjustments: [["adj1", 12500], ["adj2", 1_142_319], ["adj3", 20_457_681], ["adj4", 11_942_319],
+                                                         ["adj5", 12500]].freeze }.freeze,
+      LEFT_RIGHT_RIBBON: { basename: "Left Right Ribbon",
+                           default_adjustments: [["adj1", 50000], ["adj2", 50000],
+                                                 ["adj3", 16667]].freeze }.freeze,
+      LEFT_RIGHT_UP_ARROW: { basename: "Left-Right-Up Arrow",
+                             default_adjustments: [["adj1", 25000], ["adj2", 25000],
+                                                   ["adj3", 25000]].freeze }.freeze,
+      LEFT_UP_ARROW: { basename: "Left-Up Arrow",
+                       default_adjustments: [["adj1", 25000], ["adj2", 25000],
+                                             ["adj3", 25000]].freeze }.freeze,
+      LIGHTNING_BOLT: { basename: "Lightning Bolt", default_adjustments: [].freeze }.freeze,
+      LINE_CALLOUT_1: { basename: "Line Callout 1",
+                        default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 112_500],
+                                              ["adj4", -38333]].freeze }.freeze,
+      LINE_CALLOUT_1_ACCENT_BAR: { basename: "Line Callout 1 (Accent Bar)",
+                                   default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 112_500],
+                                                         ["adj4", -38333]].freeze }.freeze,
+      LINE_CALLOUT_1_BORDER_AND_ACCENT_BAR: { basename: "Line Callout 1 (Border and Accent Bar)",
+                                              default_adjustments: [["adj1", 18750], ["adj2", -8333],
+                                                                    ["adj3", 112_500], ["adj4", -38333]].freeze }.freeze,
+      LINE_CALLOUT_1_NO_BORDER: { basename: "Line Callout 1 (No Border)",
+                                  default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 112_500],
+                                                        ["adj4", -38333]].freeze }.freeze,
+      LINE_CALLOUT_2: { basename: "Line Callout 2",
+                        default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 112_500],
+                                              ["adj6", -46667]].freeze }.freeze,
+      LINE_CALLOUT_2_ACCENT_BAR: { basename: "Line Callout 2 (Accent Bar)",
+                                   default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 112_500],
+                                                         ["adj6", -46667]].freeze }.freeze,
+      LINE_CALLOUT_2_BORDER_AND_ACCENT_BAR: { basename: "Line Callout 2 (Border and Accent Bar)",
+                                              default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 112_500],
+                                                                    ["adj6", -46667]].freeze }.freeze,
+      LINE_CALLOUT_2_NO_BORDER: { basename: "Line Callout 2 (No Border)",
+                                  default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 112_500],
+                                                        ["adj6", -46667]].freeze }.freeze,
+      LINE_CALLOUT_3: { basename: "Line Callout 3",
+                        default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 100_000],
+                                              ["adj6", -16667], ["adj7", 112_963], ["adj8", -8333]].freeze }.freeze,
+      LINE_CALLOUT_3_ACCENT_BAR: { basename: "Line Callout 3 (Accent Bar)",
+                                   default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 100_000],
+                                                         ["adj6", -16667], ["adj7", 112_963], ["adj8", -8333]].freeze }.freeze,
+      LINE_CALLOUT_3_BORDER_AND_ACCENT_BAR: { basename: "Line Callout 3 (Border and Accent Bar)",
+                                              default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 100_000],
+                                                                    ["adj6", -16667], ["adj7", 112_963], ["adj8", -8333]].freeze }.freeze,
+      LINE_CALLOUT_3_NO_BORDER: { basename: "Line Callout 3 (No Border)",
+                                  default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 100_000],
+                                                        ["adj6", -16667], ["adj7", 112_963], ["adj8", -8333]].freeze }.freeze,
+      LINE_CALLOUT_4: { basename: "Line Callout 3",
+                        default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 100_000],
+                                              ["adj6", -16667], ["adj7", 112_963], ["adj8", -8333]].freeze }.freeze,
+      LINE_CALLOUT_4_ACCENT_BAR: { basename: "Line Callout 3 (Accent Bar)",
+                                   default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 100_000],
+                                                         ["adj6", -16667], ["adj7", 112_963], ["adj8", -8333]].freeze }.freeze,
+      LINE_CALLOUT_4_BORDER_AND_ACCENT_BAR: { basename: "Line Callout 3 (Border and Accent Bar)",
+                                              default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 100_000],
+                                                                    ["adj6", -16667], ["adj7", 112_963], ["adj8", -8333]].freeze }.freeze,
+      LINE_CALLOUT_4_NO_BORDER: { basename: "Line Callout 3 (No Border)",
+                                  default_adjustments: [["adj1", 18750], ["adj2", -8333], ["adj3", 18750], ["adj4", -16667], ["adj5", 100_000],
+                                                        ["adj6", -16667], ["adj7", 112_963], ["adj8", -8333]].freeze }.freeze,
+      LINE_INVERSE: { basename: "Straight Connector", default_adjustments: [].freeze }.freeze,
+      MATH_DIVIDE: { basename: "Division",
+                     default_adjustments: [["adj1", 23520], ["adj2", 5880], ["adj3", 11760]].freeze }.freeze,
+      MATH_EQUAL: { basename: "Equal",
+                    default_adjustments: [["adj1", 23520], ["adj2", 11760]].freeze }.freeze,
+      MATH_MINUS: { basename: "Minus", default_adjustments: [["adj1", 23520]].freeze }.freeze,
+      MATH_MULTIPLY: { basename: "Multiply", default_adjustments: [["adj1", 23520]].freeze }.freeze,
+      MATH_NOT_EQUAL: { basename: "Not Equal",
+                        default_adjustments: [["adj1", 23520], ["adj2", 6_600_000],
+                                              ["adj3", 11760]].freeze }.freeze,
+      MATH_PLUS: { basename: "Plus", default_adjustments: [["adj1", 23520]].freeze }.freeze,
+      MOON: { basename: "Moon", default_adjustments: [["adj", 50000]].freeze }.freeze,
+      NON_ISOSCELES_TRAPEZOID: { basename: "Non-isosceles Trapezoid",
+                                 default_adjustments: [["adj1", 25000], ["adj2", 25000]].freeze }.freeze,
+      NOTCHED_RIGHT_ARROW: { basename: "Notched Right Arrow",
+                             default_adjustments: [["adj1", 50000], ["adj2", 50000]].freeze }.freeze,
+      NO_SYMBOL: { basename: "\"No\" Symbol", default_adjustments: [["adj", 18750]].freeze }.freeze,
+      OCTAGON: { basename: "Octagon", default_adjustments: [["adj", 29289]].freeze }.freeze,
+      OVAL: { basename: "Oval", default_adjustments: [].freeze }.freeze,
+      OVAL_CALLOUT: { basename: "Oval Callout",
+                      default_adjustments: [["adj1", -20833], ["adj2", 62500]].freeze }.freeze,
+      PARALLELOGRAM: { basename: "Parallelogram", default_adjustments: [["adj", 25000]].freeze }.freeze,
+      PENTAGON: { basename: "Pentagon", default_adjustments: [["adj", 50000]].freeze }.freeze,
+      PIE: { basename: "Pie", default_adjustments: [["adj1", 0], ["adj2", 16_200_000]].freeze }.freeze,
+      PIE_WEDGE: { basename: "Pie", default_adjustments: [].freeze }.freeze,
+      PLAQUE: { basename: "Plaque", default_adjustments: [["adj", 16667]].freeze }.freeze,
+      PLAQUE_TABS: { basename: "Plaque Tabs", default_adjustments: [].freeze }.freeze,
+      QUAD_ARROW: { basename: "Quad Arrow",
+                    default_adjustments: [["adj1", 22500], ["adj2", 22500], ["adj3", 22500]].freeze }.freeze,
+      QUAD_ARROW_CALLOUT: { basename: "Quad Arrow Callout",
+                            default_adjustments: [["adj1", 18515], ["adj2", 18515], ["adj3", 18515],
+                                                  ["adj4", 48123]].freeze }.freeze,
+      RECTANGLE: { basename: "Rectangle", default_adjustments: [].freeze }.freeze,
+      RECTANGULAR_CALLOUT: { basename: "Rectangular Callout",
+                             default_adjustments: [["adj1", -20833], ["adj2", 62500]].freeze }.freeze,
+      REGULAR_PENTAGON: { basename: "Regular Pentagon",
+                          default_adjustments: [["hf", 105_146], ["vf", 110_557]].freeze }.freeze,
+      RIGHT_ARROW: { basename: "Right Arrow",
+                     default_adjustments: [["adj1", 50000], ["adj2", 50000]].freeze }.freeze,
+      RIGHT_ARROW_CALLOUT: { basename: "Right Arrow Callout",
+                             default_adjustments: [["adj1", 25000], ["adj2", 25000], ["adj3", 25000],
+                                                   ["adj4", 64977]].freeze }.freeze,
+      RIGHT_BRACE: { basename: "Right Brace",
+                     default_adjustments: [["adj1", 8333], ["adj2", 50000]].freeze }.freeze,
+      RIGHT_BRACKET: { basename: "Right Bracket", default_adjustments: [["adj", 8333]].freeze }.freeze,
+      RIGHT_TRIANGLE: { basename: "Right Triangle", default_adjustments: [].freeze }.freeze,
+      ROUNDED_RECTANGLE: { basename: "Rounded Rectangle",
+                           default_adjustments: [["adj", 16667]].freeze }.freeze,
+      ROUNDED_RECTANGULAR_CALLOUT: { basename: "Rounded Rectangular Callout",
+                                     default_adjustments: [["adj1", -20833], ["adj2", 62500],
+                                                           ["adj3", 16667]].freeze }.freeze,
+      ROUND_1_RECTANGLE: { basename: "Round Single Corner Rectangle",
+                           default_adjustments: [["adj", 16667]].freeze }.freeze,
+      ROUND_2_DIAG_RECTANGLE: { basename: "Round Diagonal Corner Rectangle",
+                                default_adjustments: [["adj1", 16667], ["adj2", 0]].freeze }.freeze,
+      ROUND_2_SAME_RECTANGLE: { basename: "Round Same Side Corner Rectangle",
+                                default_adjustments: [["adj1", 16667], ["adj2", 0]].freeze }.freeze,
+      SMILEY_FACE: { basename: "Smiley Face", default_adjustments: [["adj", 4653]].freeze }.freeze,
+      SNIP_1_RECTANGLE: { basename: "Snip Single Corner Rectangle",
+                          default_adjustments: [["adj", 16667]].freeze }.freeze,
+      SNIP_2_DIAG_RECTANGLE: { basename: "Snip Diagonal Corner Rectangle",
+                               default_adjustments: [["adj1", 0], ["adj2", 16667]].freeze }.freeze,
+      SNIP_2_SAME_RECTANGLE: { basename: "Snip Same Side Corner Rectangle",
+                               default_adjustments: [["adj1", 16667], ["adj2", 0]].freeze }.freeze,
+      SNIP_ROUND_RECTANGLE: { basename: "Snip and Round Single Corner Rectangle",
+                              default_adjustments: [["adj1", 16667], ["adj2", 16667]].freeze }.freeze,
+      SQUARE_TABS: { basename: "Square Tabs", default_adjustments: [].freeze }.freeze,
+      STAR_10_POINT: { basename: "10-Point Star",
+                       default_adjustments: [["adj", 42533], ["hf", 105_146]].freeze }.freeze,
+      STAR_12_POINT: { basename: "12-Point Star", default_adjustments: [["adj", 37500]].freeze }.freeze,
+      STAR_16_POINT: { basename: "16-Point Star", default_adjustments: [["adj", 37500]].freeze }.freeze,
+      STAR_24_POINT: { basename: "24-Point Star", default_adjustments: [["adj", 37500]].freeze }.freeze,
+      STAR_32_POINT: { basename: "32-Point Star", default_adjustments: [["adj", 37500]].freeze }.freeze,
+      STAR_4_POINT: { basename: "4-Point Star", default_adjustments: [["adj", 12500]].freeze }.freeze,
+      STAR_5_POINT: { basename: "5-Point Star",
+                      default_adjustments: [["adj", 19098], ["hf", 105_146], ["vf", 110_557]].freeze }.freeze,
+      STAR_6_POINT: { basename: "6-Point Star",
+                      default_adjustments: [["adj", 28868], ["hf", 115_470]].freeze }.freeze,
+      STAR_7_POINT: { basename: "7-Point Star",
+                      default_adjustments: [["adj", 34601], ["hf", 102_572], ["vf", 105_210]].freeze }.freeze,
+      STAR_8_POINT: { basename: "8-Point Star", default_adjustments: [["adj", 37500]].freeze }.freeze,
+      STRIPED_RIGHT_ARROW: { basename: "Striped Right Arrow",
+                             default_adjustments: [["adj1", 50000], ["adj2", 50000]].freeze }.freeze,
+      SUN: { basename: "Sun", default_adjustments: [["adj", 25000]].freeze }.freeze,
+      SWOOSH_ARROW: { basename: "Swoosh Arrow",
+                      default_adjustments: [["adj1", 25000], ["adj2", 16667]].freeze }.freeze,
+      TEAR: { basename: "Teardrop", default_adjustments: [["adj", 100_000]].freeze }.freeze,
+      TRAPEZOID: { basename: "Trapezoid", default_adjustments: [["adj", 25000]].freeze }.freeze,
+      UP_ARROW: { basename: "Up Arrow",
+                  default_adjustments: [["adj1", 50000], ["adj2", 50000]].freeze }.freeze,
+      UP_ARROW_CALLOUT: { basename: "Up Arrow Callout",
+                          default_adjustments: [["adj1", 25000], ["adj2", 25000], ["adj3", 25000],
+                                                ["adj4", 64977]].freeze }.freeze,
+      UP_DOWN_ARROW: { basename: "Up-Down Arrow",
+                       default_adjustments: [["adj1", 50000], ["adj1", 50000], ["adj2", 50000],
+                                             ["adj2", 50000]].freeze }.freeze,
+      UP_DOWN_ARROW_CALLOUT: { basename: "Up-Down Arrow Callout",
+                               default_adjustments: [["adj1", 25000], ["adj2", 25000], ["adj3", 25000],
+                                                     ["adj4", 48123]].freeze }.freeze,
+      UP_RIBBON: { basename: "Up Ribbon",
+                   default_adjustments: [["adj1", 16667], ["adj2", 50000]].freeze }.freeze,
+      U_TURN_ARROW: { basename: "U-Turn Arrow",
+                      default_adjustments: [["adj1", 25000], ["adj2", 25000], ["adj3", 25000], ["adj4", 43750],
+                                            ["adj5", 75000]].freeze }.freeze,
+      VERTICAL_SCROLL: { basename: "Vertical Scroll", default_adjustments: [["adj", 12500]].freeze }.freeze,
+      WAVE: { basename: "Wave", default_adjustments: [["adj1", 12500], ["adj2", 0]].freeze }.freeze
+    }.freeze
+
+    module_function
+
+    # @param shape_type [Pptx::Enum::MSO_SHAPE]
+    def for(shape_type)
+      SPECS.fetch(Enum::MSO_SHAPE.fetch(shape_type).name) do
+        raise ArgumentError, "no auto-shape spec for #{shape_type.inspect}"
+      end
+    end
+
+    def basename(shape_type) = self.for(shape_type)[:basename]
+
+    def default_adjustments(shape_type) = self.for(shape_type)[:default_adjustments]
+  end
+end

data/lib/ruby_pptx/builder.rb

@@ -0,0 +1,228 @@
+# frozen_string_literal: true
+
+module Pptx
+  # Build a presentation declaratively.
+  #
+  # This is a thin layer over the ordinary API — every method here is a call
+  # the imperative API can make directly — but it keeps position and size out
+  # of positional arguments and lets a whole deck read top to bottom:
+  #
+  #   deck = Pptx.build do |d|
+  #     d.slide("Title Slide") do |s|
+  #       s.title = "Annual Report"
+  #       s.subtitle = "Prepared in Ruby"
+  #     end
+  #
+  #     d.section("Detail") do
+  #       d.slide("Blank") do |s|
+  #         s.shape :ROUNDED_RECTANGLE, at: [Pptx.inches(1), Pptx.inches(1)],
+  #                                     size: [Pptx.inches(3), Pptx.inches(1)],
+  #                                     fill: "1F497D", text: "Next steps"
+  #       end
+  #     end
+  #   end
+  #
+  #   deck.save("out.pptx")
+  #
+  # @param template [String, IO, nil] a deck to start from; the built-in
+  #   default template when omitted
+  # @return [Presentation]
+  def self.build(template = nil)
+    presentation = template ? Presentation.open(template) : Presentation.new_default
+    yield DeckBuilder.new(presentation) if block_given?
+    presentation
+  end
+
+  # The object yielded by {Pptx.build}.
+  class DeckBuilder
+    attr_reader :presentation
+
+    def initialize(presentation)
+      @presentation = presentation
+      @current_section = nil
+    end
+
+    # Add a slide based on +layout+, which may be a layout name, an index, or
+    # a {SlideLayout}.
+    #
+    # @return [Slide]
+    def slide(layout = "Title and Content")
+      slide_layout = resolve_layout(layout)
+      slide = @presentation.slides.add(slide_layout)
+      @current_section << slide if @current_section
+      yield SlideBuilder.new(slide) if block_given?
+      slide
+    end
+
+    # Group the slides added inside the block into a named section.
+    #
+    # @return [Section]
+    def section(name)
+      previous = @current_section
+      @current_section = @presentation.sections.add(name)
+      begin
+        yield if block_given?
+        @current_section
+      ensure
+        @current_section = previous
+      end
+    end
+
+    # Set the slide size, e.g. `deck.slide_size = :widescreen`.
+    #
+    # Accepts `:widescreen` (13.333 x 7.5in), `:standard` (10 x 7.5in), or an
+    # explicit [width, height] pair.
+    def slide_size=(value)
+      width, height =
+        case value
+        when :widescreen then [Pptx.inches(13.333), Pptx.inches(7.5)]
+        when :standard then [Pptx.inches(10), Pptx.inches(7.5)]
+        else value
+        end
+      @presentation.slide_width = width
+      @presentation.slide_height = height
+    end
+
+    private
+
+    def resolve_layout(layout)
+      return layout if layout.is_a?(SlideLayout)
+
+      @presentation.slide_layouts[layout] ||
+        raise(NotFoundError, "no slide layout #{layout.inspect}")
+    end
+  end
+
+  # The object yielded by {DeckBuilder#slide}.
+  class SlideBuilder
+    attr_reader :slide
+
+    def initialize(slide)
+      @slide = slide
+    end
+
+    # The title placeholder's text.
+    def title=(text)
+      placeholder = @slide.shapes.title or
+        raise NotFoundError, "this slide's layout has no title placeholder"
+
+      placeholder.text = text
+    end
+
+    # The text of the placeholder with `idx` 1, which is the body on a content
+    # layout and the subtitle on a title layout.
+    def body=(text)
+      self[1] = text
+    end
+    alias subtitle= body=
+
+    # Set the text of the placeholder with the given `idx`.
+    def []=(idx, text)
+      placeholder = @slide.placeholders[idx] or
+        raise NotFoundError, "this slide has no placeholder with idx #{idx}"
+
+      placeholder.text = text
+    end
+
+    # Add a text box.
+    #
+    # @return [Shape]
+    def text(content, at:, size: nil, font_size: nil, bold: nil, italic: nil,
+             color: nil, font: nil, align: nil)
+      box = @slide.shapes.add_textbox(at: at, size: size || [Pptx.inches(4), Pptx.inches(1)])
+      box.text_frame.text = content
+      style_text(box.text_frame, font_size: font_size, bold: bold, italic: italic,
+                                 color: color, font: font, align: align)
+      box
+    end
+
+    # Add an auto shape.
+    #
+    # @return [Shape]
+    def shape(shape_type, at:, size:, fill: nil, line: nil, text: nil, **text_options)
+      auto_shape = @slide.shapes.add_shape(shape_type, at: at, size: size)
+      apply_fill(auto_shape, fill)
+      apply_line(auto_shape, line)
+      if text
+        auto_shape.text_frame.text = text
+        style_text(auto_shape.text_frame, **text_options)
+      end
+      auto_shape
+    end
+
+    # Add a picture. Omit +size+ for the image's native size, or give one
+    # dimension to scale the other with it.
+    #
+    # @return [Picture]
+    def picture(image, at:, width: nil, height: nil)
+      @slide.shapes.add_picture(image, at: at, width: width, height: height)
+    end
+
+    # Add a table filled from +rows+, an array of arrays.
+    #
+    # @return [Table]
+    def table(rows, at:, size:, header: true)
+      rows = rows.to_a
+      raise ArgumentError, "table needs at least one row" if rows.empty?
+
+      columns = rows.map(&:size).max
+      frame = @slide.shapes.add_table(rows.size, columns, at: at, size: size)
+      table = frame.table
+      table.first_row = header
+      rows.each_with_index do |row, row_index|
+        row.each_with_index { |value, col| table.cell(row_index, col).text = value.to_s }
+      end
+      table
+    end
+
+    # Add a chart.
+    #
+    #   s.chart :COLUMN_CLUSTERED, categories: %w[East West],
+    #                              series: { "Q1" => [1, 2] },
+    #                              at: [x, y], size: [w, h]
+    #
+    # @return [Chart]
+    def chart(chart_type, categories:, series:, at:, size:)
+      data = ChartData.new
+      data.categories = categories
+      series.each { |name, values| data.add_series(name, values) }
+      @slide.shapes.add_chart(chart_type, data, at: at, size: size).chart
+    end
+
+    private
+
+    def style_text(text_frame, font_size: nil, bold: nil, italic: nil,
+                   color: nil, font: nil, align: nil)
+      paragraph = text_frame.paragraphs.first
+      paragraph.alignment = align if align
+      # Apply to every run so a multi-run value styles consistently.
+      runs = text_frame.paragraphs.flat_map(&:runs)
+      runs.each do |run|
+        run.font.size = font_size if font_size
+        run.font.bold = bold unless bold.nil?
+        run.font.italic = italic unless italic.nil?
+        run.font.name = font if font
+        run.font.color.rgb = rgb(color) if color
+      end
+    end
+
+    def apply_fill(shape, fill)
+      return if fill.nil?
+      return shape.fill.background if fill == :none
+
+      shape.fill.solid
+      shape.fill.fore_color.rgb = rgb(fill)
+    end
+
+    def apply_line(shape, line)
+      return if line.nil?
+
+      color, width = line.is_a?(Hash) ? [line[:color], line[:width]] : [line, nil]
+      shape.line.color.rgb = rgb(color) if color
+      shape.line.width = width if width
+    end
+
+    # A colour may be given as an RGBColor or as a hex string.
+    def rgb(value) = value.is_a?(RGBColor) ? value : RGBColor.from_string(value)
+  end
+end