| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228 |
- #!/usr/bin/env python3
- """Create a .pptx presentation from a JSON deck spec.
- Spec format (all positions/sizes in inches, colors as RRGGBB hex):
- {
- "slide_size": "16:9", // or "4:3" (default "16:9")
- "slides": [
- {"layout": "title", "title": "My Deck", "subtitle": "Q3 review"},
- {"layout": "title_content", "title": "Agenda",
- "bullets": ["Top item",
- {"text": "Sub item", "level": 1, "bold": true,
- "size": 18, "color": "CC0000", "font": "Arial",
- "italic": false,
- "link": "https://example.com/agenda"}],
- "background": "1F2937", // solid slide background (hex)
- "footer": "Confidential", // footer placeholder text
- "slide_number": true, // enable slide-number placeholder
- "notes": "Speaker notes for this slide"},
- {"layout": "blank", "title": "Widgets",
- "images": [{"path": "logo.png", "left": 1, "top": 1, "width": 3}],
- "tables": [{"left": 1, "top": 2, "width": 6, "height": 2,
- "rows": [["H1", "H2"], ["a", "b"]]}],
- "shapes": [{"type": "rounded_rectangle", "left": 8, "top": 1,
- "width": 3, "height": 1, "fill": "4472C4",
- "text": "Callout", "text_color": "FFFFFF"}],
- "charts": [{"type": "bar", "left": 1, "top": 3, "width": 6,
- "height": 3.5, "title": "Sales",
- "categories": ["Q1", "Q2"],
- "series": {"North": [10, 20], "South": [7, 13]}}]}
- ]
- }
- Layouts: title, title_content, section, two_content, title_only, blank
- Chart types: bar, bar_h, line, pie Shape types: rectangle,
- rounded_rectangle, oval, diamond, right_arrow, chevron
- """
- import argparse
- import copy
- import json
- import sys
- from pptx import Presentation
- from pptx.chart.data import CategoryChartData
- from pptx.dml.color import RGBColor
- from pptx.enum.chart import XL_CHART_TYPE
- from pptx.enum.shapes import MSO_SHAPE
- from pptx.util import Inches, Pt
- LAYOUTS = {"title": 0, "title_content": 1, "section": 2,
- "two_content": 3, "title_only": 5, "blank": 6}
- CHART_TYPES = {"bar": XL_CHART_TYPE.COLUMN_CLUSTERED,
- "bar_h": XL_CHART_TYPE.BAR_CLUSTERED,
- "line": XL_CHART_TYPE.LINE_MARKERS,
- "pie": XL_CHART_TYPE.PIE}
- SHAPE_TYPES = {"rectangle": MSO_SHAPE.RECTANGLE,
- "rounded_rectangle": MSO_SHAPE.ROUNDED_RECTANGLE,
- "oval": MSO_SHAPE.OVAL, "diamond": MSO_SHAPE.DIAMOND,
- "right_arrow": MSO_SHAPE.RIGHT_ARROW,
- "chevron": MSO_SHAPE.CHEVRON}
- def style_run(run, spec):
- """Apply font styling from a bullet/text spec dict to a run."""
- font = run.font
- if spec.get("size"):
- font.size = Pt(spec["size"])
- if spec.get("bold") is not None:
- font.bold = spec["bold"]
- if spec.get("italic") is not None:
- font.italic = spec["italic"]
- if spec.get("font"):
- font.name = spec["font"]
- if spec.get("color"):
- font.color.rgb = RGBColor.from_string(spec["color"])
- if spec.get("link"):
- run.hyperlink.address = spec["link"]
- def add_bullets(text_frame, bullets):
- text_frame.clear()
- for i, item in enumerate(bullets):
- if isinstance(item, str):
- item = {"text": item}
- para = text_frame.paragraphs[0] if i == 0 else text_frame.add_paragraph()
- para.level = int(item.get("level", 0))
- run = para.add_run()
- run.text = item.get("text", "")
- style_run(run, item)
- def copy_layout_placeholder(slide, ph_idx):
- """Copy a layout placeholder (footer=11, slide number=12) onto the
- slide so it actually renders; returns the shape or None if the layout
- does not provide it."""
- for ph in slide.slide_layout.placeholders:
- if ph.placeholder_format.idx == ph_idx:
- slide.shapes._spTree.append(copy.deepcopy(ph._element))
- for shape in slide.placeholders:
- if shape.placeholder_format.idx == ph_idx:
- return shape
- return None
- def set_slide_title(slide, text, slide_width):
- """Set a layout title or add a conventional title box as fallback."""
- if slide.shapes.title is not None:
- slide.shapes.title.text = text
- return slide.shapes.title
- shape = slide.shapes.add_textbox(
- Inches(0.5), Inches(0.3), slide_width - Inches(1), Inches(0.8))
- run = shape.text_frame.paragraphs[0].add_run()
- run.text = text
- run.font.size = Pt(28)
- run.font.bold = True
- return shape
- def build_slide(prs, spec):
- layout_idx = LAYOUTS.get(spec.get("layout", "title_content"), 1)
- slide = prs.slides.add_slide(prs.slide_layouts[layout_idx])
- if spec.get("background"):
- fill = slide.background.fill
- fill.solid()
- fill.fore_color.rgb = RGBColor.from_string(spec["background"])
- if spec.get("slide_number"):
- copy_layout_placeholder(slide, 12)
- if spec.get("footer"):
- shape = copy_layout_placeholder(slide, 11)
- if shape is not None:
- shape.text_frame.text = spec["footer"]
- if spec.get("title") is not None:
- set_slide_title(slide, spec["title"], prs.slide_width)
- if spec.get("subtitle") is not None:
- for ph in slide.placeholders:
- if ph.placeholder_format.idx == 1:
- ph.text = spec["subtitle"]
- break
- if spec.get("bullets"):
- body = next((ph for ph in slide.placeholders
- if ph.placeholder_format.idx != 0), None)
- if body is None:
- body = slide.shapes.add_textbox(Inches(0.5), Inches(1.5),
- Inches(9), Inches(5))
- add_bullets(body.text_frame, spec["bullets"])
- for img in spec.get("images", []):
- kwargs = {}
- if img.get("width"):
- kwargs["width"] = Inches(img["width"])
- if img.get("height"):
- kwargs["height"] = Inches(img["height"])
- slide.shapes.add_picture(img["path"], Inches(img.get("left", 1)),
- Inches(img.get("top", 1)), **kwargs)
- for tbl in spec.get("tables", []):
- rows = tbl["rows"]
- shape = slide.shapes.add_table(
- len(rows), len(rows[0]), Inches(tbl.get("left", 1)),
- Inches(tbl.get("top", 2)), Inches(tbl.get("width", 6)),
- Inches(tbl.get("height", 2)))
- for r, row in enumerate(rows):
- for c, val in enumerate(row):
- shape.table.cell(r, c).text = str(val)
- for shp in spec.get("shapes", []):
- shape = slide.shapes.add_shape(
- SHAPE_TYPES.get(shp.get("type", "rectangle"), MSO_SHAPE.RECTANGLE),
- Inches(shp.get("left", 1)), Inches(shp.get("top", 1)),
- Inches(shp.get("width", 2)), Inches(shp.get("height", 1)))
- if shp.get("fill"):
- shape.fill.solid()
- shape.fill.fore_color.rgb = RGBColor.from_string(shp["fill"])
- if shp.get("text"):
- shape.text_frame.text = shp["text"]
- if shp.get("text_color"):
- run = shape.text_frame.paragraphs[0].runs[0]
- run.font.color.rgb = RGBColor.from_string(shp["text_color"])
- for cht in spec.get("charts", []):
- data = CategoryChartData()
- data.categories = cht["categories"]
- for name, values in cht["series"].items():
- data.add_series(name, values)
- frame = slide.shapes.add_chart(
- CHART_TYPES.get(cht.get("type", "bar"),
- XL_CHART_TYPE.COLUMN_CLUSTERED),
- Inches(cht.get("left", 1)), Inches(cht.get("top", 2)),
- Inches(cht.get("width", 6)), Inches(cht.get("height", 4)), data)
- if cht.get("title"):
- frame.chart.has_title = True
- frame.chart.chart_title.text_frame.text = cht["title"]
- if spec.get("notes"):
- slide.notes_slide.notes_text_frame.text = spec["notes"]
- return slide
- def main(argv=None):
- if hasattr(sys.stdout, "reconfigure"):
- sys.stdout.reconfigure(encoding="utf-8", errors="replace")
- parser = argparse.ArgumentParser(
- description="Create a .pptx deck from a JSON spec.",
- epilog=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
- parser.add_argument("spec", help="path to JSON deck spec")
- parser.add_argument("output", help="output .pptx path")
- args = parser.parse_args(argv)
- with open(args.spec, encoding="utf-8") as fh:
- spec = json.load(fh)
- prs = Presentation()
- if spec.get("slide_size", "16:9") == "16:9":
- prs.slide_width, prs.slide_height = Inches(13.333), Inches(7.5)
- else:
- prs.slide_width, prs.slide_height = Inches(10), Inches(7.5)
- for slide_spec in spec.get("slides", []):
- build_slide(prs, slide_spec)
- prs.save(args.output)
- print(json.dumps({"ok": True, "output": args.output,
- "slides": len(prs.slides._sldIdLst)}))
- return 0
- if __name__ == "__main__":
- sys.exit(main())
|