wehub-resource-sync
8cb1f9f479
Publish SDK (PyPI) / publish (push) Has been cancelled
Publish SDK (npm) / publish (@aionui/officecli-sdk) (push) Has been cancelled
SDK smoke / smoke (windows-latest) (push) Has been cancelled
Publish SDK (npm) / publish (@officecli/officecli-sdk) (push) Has been cancelled
Publish SDK (npm) / publish (@officecli/sdk) (push) Has been cancelled
Publish SDK (npm) / publish (officecli-sdk) (push) Has been cancelled
SDK smoke / smoke (macos-latest) (push) Has been cancelled
SDK smoke / smoke (ubuntu-latest) (push) Has been cancelled
Skill parity / diff (push) Has been cancelled
264 lines
14 KiB
Python
264 lines
14 KiB
Python
#!/usr/bin/env python3
|
|
"""
|
|
Basic PowerPoint shapes — generates shapes-basic.pptx exercising the pptx
|
|
`shape` element: geometry presets, solid/gradient/pattern/image fills, line
|
|
styling (color/width/dash/caps/joins/align/arrowheads), rotation, opacity, and
|
|
shadow/glow/reflection effects.
|
|
|
|
SDK twin of shapes-basic.sh (officecli CLI). Both produce an equivalent
|
|
shapes-basic.pptx. This one drives the **officecli Python SDK**
|
|
(`pip install officecli-sdk`): one resident is started and every slide and
|
|
shape is shipped over the named pipe in a single `doc.batch(...)` round-trip.
|
|
Each item is the same `{"command","parent","type","props"}` dict you'd put in
|
|
an `officecli batch` list.
|
|
|
|
Usage:
|
|
pip install officecli-sdk # plus the `officecli` binary on PATH
|
|
python3 shapes-basic.py
|
|
"""
|
|
|
|
import os
|
|
import sys
|
|
|
|
# --- locate the SDK: prefer an installed `officecli-sdk`, else the in-repo copy
|
|
try:
|
|
import officecli # pip install officecli-sdk
|
|
except ImportError:
|
|
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)),
|
|
"..", "..", "..", "sdk", "python"))
|
|
import officecli
|
|
|
|
FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "shapes-basic.pptx")
|
|
|
|
|
|
def slide(**props):
|
|
"""One `add slide` item in batch-shape."""
|
|
return {"command": "add", "parent": "/", "type": "slide", "props": props}
|
|
|
|
|
|
def shape(slide_idx, **props):
|
|
"""One `add shape` item onto /slide[slide_idx] in batch-shape."""
|
|
return {"command": "add", "parent": f"/slide[{slide_idx}]", "type": "shape",
|
|
"props": props}
|
|
|
|
|
|
print(f"Building {FILE} ...")
|
|
|
|
with officecli.create(FILE, "--force") as doc:
|
|
items = []
|
|
|
|
# ─────────────────────────────────────────────────────────────────────────
|
|
# Slide 1 — Geometry preset gallery
|
|
# ─────────────────────────────────────────────────────────────────────────
|
|
items.append(slide())
|
|
items.append(shape(1, text="Geometry Presets", size="28", bold="true",
|
|
x="0.5in", y="0.3in", width="12in", height="0.6in"))
|
|
|
|
# Row of 8 shapes, one per supported preset.
|
|
# Schema-declared presets: rect, roundRect, ellipse, triangle, diamond,
|
|
# parallelogram, rightArrow, star5
|
|
presets = ["rect", "roundRect", "ellipse", "triangle", "diamond",
|
|
"parallelogram", "rightArrow", "star5"]
|
|
for col, preset in enumerate(presets):
|
|
x = 0.5 + col * 1.55
|
|
items.append(shape(1, geometry=preset,
|
|
x=f"{x}in", y="1.5in", width="1.3in", height="1.3in",
|
|
fill="4472C4", color="FFFFFF",
|
|
text=preset, size="11", bold="true"))
|
|
|
|
# ─────────────────────────────────────────────────────────────────────────
|
|
# Slide 2 — Fill variations on the same geometry
|
|
# ─────────────────────────────────────────────────────────────────────────
|
|
items.append(slide())
|
|
items.append(shape(2, text="Fill Variations", size="28", bold="true",
|
|
x="0.5in", y="0.3in", width="12in", height="0.6in"))
|
|
|
|
# Solid hex
|
|
items.append(shape(2, geometry="roundRect",
|
|
x="0.5in", y="1.3in", width="2.5in", height="1.5in",
|
|
fill="E63946", color="FFFFFF", bold="true",
|
|
text="fill=E63946"))
|
|
# Theme color (follows deck theme)
|
|
items.append(shape(2, geometry="roundRect",
|
|
x="3.3in", y="1.3in", width="2.5in", height="1.5in",
|
|
fill="accent2", color="FFFFFF", bold="true",
|
|
text="fill=accent2"))
|
|
# Linear gradient (color1-color2-angle)
|
|
items.append(shape(2, geometry="roundRect",
|
|
x="6.1in", y="1.3in", width="2.5in", height="1.5in",
|
|
gradient="FF6B6B-4ECDC4-45", color="FFFFFF", bold="true",
|
|
text="gradient linear 45°"))
|
|
# Radial gradient
|
|
items.append(shape(2, geometry="roundRect",
|
|
x="8.9in", y="1.3in", width="2.5in", height="1.5in",
|
|
gradient="radial:FFE66D-FF6B35-center", color="000000",
|
|
bold="true", text="gradient radial"))
|
|
# Pattern (preset:fg:bg)
|
|
items.append(shape(2, geometry="roundRect",
|
|
x="0.5in", y="3.1in", width="2.5in", height="1.5in",
|
|
pattern="diagBrick:1D3557:F1FAEE", color="FFFFFF",
|
|
bold="true", text="pattern diagBrick"))
|
|
# Opacity (requires a fill to attach to)
|
|
items.append(shape(2, geometry="roundRect",
|
|
x="3.3in", y="3.1in", width="2.5in", height="1.5in",
|
|
fill="2A9D8F", opacity="0.4", color="000000", bold="true",
|
|
text="fill + opacity=0.4"))
|
|
# No fill (outline only)
|
|
items.append(shape(2, geometry="roundRect",
|
|
x="6.1in", y="3.1in", width="2.5in", height="1.5in",
|
|
fill="none", line="264653:2.5:solid", color="264653",
|
|
bold="true", text="fill=none + outline"))
|
|
# Per-stop gradient positions
|
|
items.append(shape(2, geometry="roundRect",
|
|
x="8.9in", y="3.1in", width="2.5in", height="1.5in",
|
|
gradient="FF0000@0-FFD700@40-0000FF@100", color="FFFFFF",
|
|
bold="true", text="gradient per-stop"))
|
|
|
|
# ─────────────────────────────────────────────────────────────────────────
|
|
# Slide 3 — Outline styling (line color / width / dash / caps / arrowheads)
|
|
# ─────────────────────────────────────────────────────────────────────────
|
|
items.append(slide())
|
|
items.append(shape(3, text="Outline Styling", size="28", bold="true",
|
|
x="0.5in", y="0.3in", width="12in", height="0.6in"))
|
|
|
|
# Compound line form: color:width:dash
|
|
items.append(shape(3, geometry="rect",
|
|
x="0.5in", y="1.3in", width="3in", height="1.2in",
|
|
fill="none", line="E63946:3:solid",
|
|
text='line="E63946:3:solid"', size="12"))
|
|
items.append(shape(3, geometry="rect",
|
|
x="4in", y="1.3in", width="3in", height="1.2in",
|
|
fill="none", line="1D3557:2:dash",
|
|
text='line="1D3557:2:dash"', size="12"))
|
|
items.append(shape(3, geometry="rect",
|
|
x="7.5in", y="1.3in", width="3in", height="1.2in",
|
|
fill="none", line="2A9D8F:2.5:dashDot",
|
|
text='line="2A9D8F:2.5:dashDot"', size="12"))
|
|
|
|
# Per-attribute form: lineColor + lineWidth + lineDash
|
|
items.append(shape(3, geometry="ellipse",
|
|
x="0.5in", y="2.9in", width="3in", height="1.4in",
|
|
fill="FFE66D", lineColor="E63946", lineWidth="4pt",
|
|
lineDash="solid",
|
|
text="separate lineColor/lineWidth/lineDash", size="11"))
|
|
# Compound stroke (cmpd=dbl → double line)
|
|
items.append(shape(3, geometry="ellipse",
|
|
x="4in", y="2.9in", width="3in", height="1.4in",
|
|
fill="A8DADC", lineColor="1D3557", lineWidth="6pt",
|
|
cmpd="dbl", text="cmpd=dbl (double stroke)", size="11"))
|
|
# Triple stroke
|
|
items.append(shape(3, geometry="ellipse",
|
|
x="7.5in", y="2.9in", width="3in", height="1.4in",
|
|
fill="A8DADC", lineColor="1D3557", lineWidth="8pt",
|
|
cmpd="tri", text="cmpd=tri (triple stroke)", size="11"))
|
|
|
|
# Arrowheads on shape outlines (demo headEnd/tailEnd here)
|
|
items.append(shape(3,
|
|
text="headEnd / tailEnd work on any outline (not just connectors):",
|
|
size="12",
|
|
x="0.5in", y="4.7in", width="12in", height="0.4in"))
|
|
items.append(shape(3, geometry="rect",
|
|
x="0.5in", y="5.2in", width="4in", height="0.05in",
|
|
fill="none", lineColor="000000", lineWidth="2pt",
|
|
headEnd="triangle", tailEnd="arrow"))
|
|
items.append(shape(3, geometry="rect",
|
|
x="5in", y="5.2in", width="4in", height="0.05in",
|
|
fill="none", lineColor="000000", lineWidth="2pt",
|
|
headEnd="diamond", tailEnd="oval"))
|
|
|
|
# ─────────────────────────────────────────────────────────────────────────
|
|
# Slide 4 — Rotation, shadow effect, z-order via add order
|
|
# ─────────────────────────────────────────────────────────────────────────
|
|
items.append(slide())
|
|
items.append(shape(4, text="Rotation + Effects", size="28", bold="true",
|
|
x="0.5in", y="0.3in", width="12in", height="0.6in"))
|
|
|
|
# Rotation in degrees (0..360)
|
|
for col, r in enumerate([0, 30, 60, 90, 135, 180, 225, 270]):
|
|
x = 0.5 + col * 1.55
|
|
items.append(shape(4, geometry="rightArrow",
|
|
x=f"{x}in", y="1.3in", width="1.4in", height="0.8in",
|
|
fill="4472C4", color="FFFFFF", bold="true",
|
|
rotation=str(r), text=f"{r}°", size="11"))
|
|
|
|
# Shadow effect: shadow=color:blur:offset:direction (compound effect)
|
|
items.append(shape(4, geometry="roundRect",
|
|
x="1in", y="3in", width="3.5in", height="1.8in",
|
|
fill="E63946", color="FFFFFF", bold="true", size="14",
|
|
text="shadow=000000", shadow="000000"))
|
|
items.append(shape(4, geometry="roundRect",
|
|
x="5.5in", y="3in", width="3.5in", height="1.8in",
|
|
fill="2A9D8F", color="FFFFFF", bold="true", size="14",
|
|
text="glow=FFD700", glow="FFD700"))
|
|
items.append(shape(4, geometry="roundRect",
|
|
x="10in", y="3in", width="3in", height="1.8in",
|
|
fill="F4A261", color="000000", bold="true", size="14",
|
|
text="reflection=tight", reflection="tight"))
|
|
|
|
# ─────────────────────────────────────────────────────────────────────────
|
|
# Slide 5 — Stroke geometry details (lineCap / lineJoin / lineAlign)
|
|
# ─────────────────────────────────────────────────────────────────────────
|
|
items.append(slide())
|
|
items.append(shape(5,
|
|
text="Stroke Geometry — lineCap / lineJoin / lineAlign",
|
|
size="28", bold="true",
|
|
x="0.5in", y="0.3in", width="12in", height="0.6in"))
|
|
|
|
# lineCap — how the stroke terminates at endpoints / dash gaps.
|
|
# Most visible with a thick dashed stroke.
|
|
x = 0.5
|
|
for cap in ["flat", "round", "square"]:
|
|
items.append(shape(5, geometry="rect",
|
|
x=f"{x}in", y="1.5in", width="4in", height="0.05in",
|
|
fill="none", lineColor="1D3557", lineWidth="10pt",
|
|
lineDash="dash", lineCap=cap))
|
|
items.append(shape(5, text=f"lineCap={cap}", size="12",
|
|
x=f"{x}in", y="1.8in", width="4in", height="0.4in",
|
|
fill="none", line="000000:0:solid"))
|
|
x += 4.3
|
|
|
|
# lineJoin — corner style on a stroked shape.
|
|
# Most visible on a triangle outline with thick lines.
|
|
x = 0.5
|
|
for join in ["round", "bevel", "miter"]:
|
|
items.append(shape(5, geometry="triangle",
|
|
x=f"{x}in", y="2.8in", width="2.5in", height="2in",
|
|
fill="A8DADC", lineColor="E63946", lineWidth="12pt",
|
|
lineJoin=join))
|
|
items.append(shape(5, text=f"lineJoin={join}", size="12",
|
|
x=f"{x}in", y="4.9in", width="2.5in", height="0.4in",
|
|
fill="none", line="000000:0:solid"))
|
|
x += 3
|
|
|
|
# miterLimit — caps how far a miter join's spike extends before clipping.
|
|
# Expressed in 1/1000ths of a percent; 800000 = 800%. Supplied as the
|
|
# compound lineJoin=miter:<lim> form which sets both join + limit at once.
|
|
items.append(shape(5, geometry="triangle",
|
|
x="0.5in", y="5.1in", width="2.5in", height="1.6in",
|
|
fill="A8DADC", lineColor="E63946", lineWidth="8pt",
|
|
lineJoin="miter:800000"))
|
|
items.append(shape(5, text='lineJoin="miter:800000" (limit 800%)', size="12",
|
|
x="0.5in", y="6.9in", width="4in", height="0.4in",
|
|
fill="none", line="000000:0:solid"))
|
|
|
|
# lineAlign — stroke alignment relative to the path: ctr (centered) vs in.
|
|
# Same shape, same border width, only the alignment of the stroke differs.
|
|
x = 8.9
|
|
for algn in ["ctr", "in"]:
|
|
items.append(shape(5, geometry="rect",
|
|
x=f"{x}in", y="2.8in", width="1.9in", height="2in",
|
|
fill="F4A261", lineColor="1D3557", lineWidth="12pt",
|
|
lineAlign=algn))
|
|
items.append(shape(5, text=f"lineAlign={algn}", size="12",
|
|
x=f"{x}in", y="4.9in", width="2in", height="0.4in",
|
|
fill="none", line="000000:0:solid"))
|
|
x += 2.1
|
|
|
|
doc.batch(items)
|
|
print(f" added {len(items)} slides/shapes")
|
|
|
|
doc.send({"command": "save"})
|
|
# context exit closes the resident, flushing the deck to disk.
|
|
|
|
print(f"Generated: {FILE}")
|