deck-shader 0.1.0__py3-none-any.whl

deck_shader/cli.py

@@ -0,0 +1,283 @@
+#!/usr/bin/env python3
+"""deck-shader: deck.json -> WebGL 背景 -> 原生 pptx（每个元素都可编辑）。
+
+画布 1280×720，绝对坐标，1 px = 0.75 pt，1 in = 96 px。
+元素模型照抄「代码精准控制」那一套：text / rect / image，全部写死坐标。
+
+用法:
+  python3 render.py deck.json --out out/deck.pptx
+  python3 render.py deck.json --png-only
+  python3 render.py deck.json --pages 2,3        # 只渲某几页
+  python3 render.py deck.json --preset cinematic
+"""
+import argparse
+import json
+import os
+import shutil
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+CHROME = os.environ.get("CHROME") or next((p for p in [
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    "/Applications/Chromium.app/Contents/MacOS/Chromium",
+    "/usr/bin/google-chrome", "/usr/bin/chromium", "/usr/bin/chromium-browser",
+] if os.path.exists(p)), None)
+
+CW, CH = 1280, 720          # 设计画布
+SW, SH = 1920, 1080         # shader 渲染尺寸 = 画布 ×1.5
+SCALE = SW / CW
+DPI = 96                    # 1 in = 96 px -> 1 px = 0.75 pt
+SLIDE_W_IN, SLIDE_H_IN = 13.333, 7.5
+
+
+def px_in(v):  return v / DPI
+def px_pt(v):  return v * 72.0 / DPI
+
+
+# ---------------------------------------------------------------- 背景渲染
+
+def render_bg(cfg, out_png):
+    """cfg = {preset, time}；只画 shader，不带任何文字。"""
+    if not CHROME:
+        sys.exit("找不到 Chrome，请设置 CHROME=/path/to/chrome")
+    tpl = (Path(__file__).parent / "template.html").read_text(encoding="utf-8")
+    cfg = dict(cfg)
+    # template 里的坐标是 1920×1080 舞台系；把画布坐标 ×1.5 传进去
+    for k in ("kickerTop", "titleTop", "subTop", "bodyTop"):
+        if k in cfg:
+            cfg[k] = cfg[k] * SCALE
+    html = tpl.replace("__CFG__", json.dumps(cfg, ensure_ascii=False))
+    tmpdir = Path(tempfile.mkdtemp())
+    tmp = tmpdir / "s.html"
+    tmp.write_text(html, encoding="utf-8")
+    try:
+        subprocess.run([CHROME, "--headless=new", "--disable-gpu", "--use-gl=angle",
+                        "--use-angle=swiftshader", f"--screenshot={out_png}",
+                        f"--window-size={SW},{SH}", "--virtual-time-budget=2500",
+                        f"file://{tmp}"], check=True,
+                       stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    finally:
+        shutil.rmtree(tmpdir, ignore_errors=True)
+    return out_png
+
+
+# ---------------------------------------------------------------- 元素绘制
+
+def _set_font(run, name):
+    """python-pptx 的 font.name 只写 latin；中文要补 a:ea。"""
+    from pptx.oxml.ns import qn
+    run.font.name = name
+    rPr = run.font._rPr
+    for tag in ("a:ea", "a:cs"):
+        el = rPr.find(qn(tag))
+        if el is None:
+            el = rPr.makeelement(qn(tag), {})
+            rPr.append(el)
+        el.set("typeface", name)
+
+
+def _style_run(run, spec):
+    from pptx.util import Pt
+    from pptx.dml.color import RGBColor
+    f = run.font
+    f.size = Pt(px_pt(spec["sizePt"]))
+    f.bold = spec.get("bold", False)
+    f.italic = spec.get("italic", False)
+    if spec.get("color"):
+        f.color.rgb = RGBColor.from_string(spec["color"].lstrip("#").upper())
+    _set_font(run, spec.get("font", "PingFang SC"))
+    if spec.get("spc"):
+        run.font._rPr.set("spc", str(int(spec["spc"] * 100)))
+
+
+def _add_text(slide, el):
+    from pptx.util import Inches, Pt
+    from pptx.enum.text import MSO_ANCHOR, PP_ALIGN
+
+    tb = slide.shapes.add_textbox(Inches(px_in(el["x"])), Inches(px_in(el["y"])),
+                                  Inches(px_in(el["w"])), Inches(px_in(el.get("h", 20))))
+    tf = tb.text_frame
+    tf.word_wrap = el.get("wrap", True)
+    tf.margin_left = tf.margin_right = tf.margin_top = tf.margin_bottom = 0
+    tf.vertical_anchor = {"top": MSO_ANCHOR.TOP, "middle": MSO_ANCHOR.MIDDLE,
+                          "bottom": MSO_ANCHOR.BOTTOM}.get(el.get("valign", "top"), MSO_ANCHOR.TOP)
+
+    paras = el.get("paragraphs")
+    if paras is None:  # 简写：单段单 run
+        paras = [{"align": el.get("align", "left"),
+                  "runs": [{"text": el.get("text", ""),
+                            "sizePt": el.get("sizePt", 20),
+                            "color": el.get("color", "#142B40"),
+                            "font": el.get("font", "PingFang SC"),
+                            "bold": el.get("bold", False)}]}]
+
+    amap = {"left": PP_ALIGN.LEFT, "right": PP_ALIGN.RIGHT,
+            "center": PP_ALIGN.CENTER, "justify": PP_ALIGN.JUSTIFY}
+    for i, p in enumerate(paras):
+        para = tf.paragraphs[0] if i == 0 else tf.add_paragraph()
+        para.alignment = amap.get(p.get("align", "left"), PP_ALIGN.LEFT)
+        if p.get("lineSpacingPct"):
+            para.line_spacing = p["lineSpacingPct"] / 100.0
+        if p.get("spaceBeforePt"):
+            para.space_before = Pt(p["spaceBeforePt"])
+        for rs in p.get("runs", []):
+            run = para.add_run()
+            run.text = rs.get("text", "")
+            _style_run(run, rs)
+
+
+def _add_rect(slide, el):
+    from pptx.util import Inches, Pt
+    from pptx.enum.shapes import MSO_SHAPE
+    from pptx.dml.color import RGBColor
+    from pptx.oxml.ns import qn
+
+    sh = slide.shapes.add_shape(MSO_SHAPE.RECTANGLE, Inches(px_in(el["x"])),
+                                Inches(px_in(el["y"])), Inches(px_in(el["w"])),
+                                Inches(px_in(el.get("h", 1))))
+    sh.shadow.inherit = False
+    # 去掉主题自带的 <p:style>：它会在 LibreOffice / Keynote 里带出投影和圆角
+    style = sh._element.find(qn("p:style"))
+    if style is not None:
+        sh._element.remove(style)
+    if el.get("fill"):
+        sh.fill.solid()
+        sh.fill.fore_color.rgb = RGBColor.from_string(el["fill"].lstrip("#").upper())
+    else:
+        sh.fill.background()
+    st = el.get("stroke")
+    if st:
+        sh.line.color.rgb = RGBColor.from_string(st.get("color", "#D8DEE4").lstrip("#").upper())
+        sh.line.width = Pt(st.get("widthPt", 1))
+    else:
+        sh.line.fill.background()
+    return sh
+
+
+def _add_image(slide, el, base):
+    from pptx.util import Inches
+    src = Path(el["src"])
+    if not src.is_absolute():
+        src = Path(base) / src
+    slide.shapes.add_picture(str(src), Inches(px_in(el["x"])), Inches(px_in(el["y"])),
+                             Inches(px_in(el["w"])), Inches(px_in(el["h"])))
+
+
+# ---------------------------------------------------------------- 组装
+
+def _legacy(slide):
+    """老的 title/titleTop 写法 -> elements。"""
+    out = []
+    if slide.get("kicker"):
+        out.append({"type": "text", "x": 72, "y": 44, "w": 700, "text": slide["kicker"],
+                    "sizePt": 10, "color": "#8FA3B8", "font": "Menlo", "spc": 0.42})
+    if slide.get("title"):
+        out.append({"type": "text", "x": 72, "y": slide.get("titleTop", 300),
+                    "w": 1136, "text": slide["title"], "sizePt": 66,
+                    "color": "#FFFFFF", "font": "Songti SC", "bold": True})
+    if slide.get("sub"):
+        out.append({"type": "text", "x": 74, "y": slide.get("subTop", (slide.get("titleTop", 300)) + 110),
+                    "w": 1136, "text": slide["sub"], "sizePt": 19,
+                    "color": "#E8C9A8", "font": "PingFang SC"})
+    if slide.get("body"):
+        out.append({"type": "text", "x": 72, "y": slide.get("bodyTop", 520),
+                    "w": 640, "text": slide["body"], "sizePt": 20,
+                    "color": "#EDE3D6", "font": "PingFang SC"})
+    return out
+
+
+def build_pptx(deck, out, only=None):
+    from pptx import Presentation
+    from pptx.util import Inches
+
+    prs = Presentation()
+    prs.slide_width = Inches(SLIDE_W_IN)
+    prs.slide_height = Inches(SLIDE_H_IN)
+    blank = prs.slide_layouts[6]
+    base = deck.get("_base", ".")
+    pngs = []
+
+    for i, s in enumerate(deck["slides"]):
+        if only and (i + 1) not in only:
+            continue
+        png = str(Path(out).with_suffix("")) + f"_bg{i}.png"
+        if not s.get("background"):
+            cfg = {"preset": s.get("preset") or deck.get("preset"),
+                   "time": s.get("time", i * 1.7)}
+            render_bg(cfg, png)
+            pngs.append(png)
+
+        slide = prs.slides.add_slide(blank)
+        bg = s.get("background")
+        if bg and bg.startswith("#"):
+            from pptx.dml.color import RGBColor
+            fill = slide.background.fill
+            fill.solid()
+            fill.fore_color.rgb = RGBColor.from_string(bg.lstrip("#").upper())
+        elif bg:
+            p = Path(bg)
+            if not p.is_absolute():
+                p = Path(base) / p
+            slide.shapes.add_picture(str(p), 0, 0,
+                                     width=prs.slide_width, height=prs.slide_height)
+        else:
+            slide.shapes.add_picture(png, 0, 0,
+                                     width=prs.slide_width, height=prs.slide_height)
+
+        for el in (s.get("elements") or _legacy(s)):
+            kind = el.get("type")
+            if kind == "text":
+                _add_text(slide, el)
+            elif kind == "rect":
+                _add_rect(slide, el)
+            elif kind == "image":
+                _add_image(slide, el, base)
+            else:
+                print(f"  ! 第 {i+1} 页未知元素类型 {kind}", file=sys.stderr)
+
+        if s.get("notes"):
+            slide.notes_slide.notes_text_frame.text = s["notes"]
+
+    prs.save(out)
+    return pngs
+
+
+def main():
+    ap = argparse.ArgumentParser(description="deck.json -> 光影背景 -> 可编辑 pptx")
+    ap.add_argument("deck")
+    ap.add_argument("--out", default="out/deck.pptx")
+    ap.add_argument("--preset", default=None, help="cinematic / editorial / signal")
+    ap.add_argument("--png-only", action="store_true")
+    ap.add_argument("--pages", default="", help="只渲某几页，如 2,3")
+    args = ap.parse_args()
+
+    path = Path(args.deck).resolve()
+    deck = json.loads(path.read_text(encoding="utf-8"))
+    deck["_base"] = str(path.parent)
+
+    if args.preset:
+        pj = Path(__file__).parent / "presets" / f"{args.preset}.json"
+        if not pj.exists():
+            sys.exit(f"没有 preset: {args.preset}")
+        deck["preset"] = json.loads(pj.read_text(encoding="utf-8"))
+
+    only = {int(x) for x in args.pages.split(",") if x.strip()} or None
+    Path(args.out).parent.mkdir(parents=True, exist_ok=True)
+
+    if args.png_only:
+        pngs = [render_bg({"preset": s.get("preset") or deck.get("preset"),
+                           "time": s.get("time", i * 1.7)},
+                          str(Path(args.out).with_suffix("")) + f"_bg{i}.png")
+                for i, s in enumerate(deck["slides"])
+                if not only or (i + 1) in only]
+        print("done:", len(pngs), "张背景")
+        return
+
+    pngs = build_pptx(deck, args.out, only)
+    print(f"done: {args.out} | {len(pngs)} 页")
+
+
+if __name__ == "__main__":
+    main()

deck_shader/presets/cinematic.json

@@ -0,0 +1 @@
+{"light": "#ffc98a", "origin": [0.55, 0.85], "dir": [-0.42, -1.0], "intensity": 1.0}

deck_shader/presets/editorial.json

@@ -0,0 +1 @@
+{"light": "#e8e2d6", "origin": [-0.60, 0.90], "dir": [0.38, -1.0], "intensity": 0.75}

deck_shader/presets/signal.json

@@ -0,0 +1 @@
+{"light": "#7fd1ff", "origin": [0.30, 0.95], "dir": [-0.18, -1.0], "intensity": 1.15}

deck_shader/template.html

@@ -0,0 +1,102 @@
+<!doctype html><html><head><meta charset="utf-8"><style>
+html,body{margin:0;background:#05070d;overflow:hidden;width:1920px;height:1080px}
+canvas{position:absolute;inset:0;width:1920px;height:1080px}
+.layer{position:absolute;inset:0;color:#fff;font-family:"Songti SC","Noto Serif SC",serif}
+.kicker{position:absolute;left:120px;font-family:"Helvetica Neue",sans-serif;font-size:15px;letter-spacing:.42em;color:rgba(255,225,190,.55)}
+.rule{position:absolute;left:120px;width:70px;height:2px;background:linear-gradient(90deg,rgba(255,196,130,.95),rgba(255,196,130,0));box-shadow:0 0 20px rgba(255,170,90,.85)}
+.title{position:absolute;left:120px;font-size:88px;line-height:1.16;margin:0;font-weight:600;letter-spacing:.01em;text-shadow:0 0 70px rgba(255,180,110,.20)}
+.sub{position:absolute;left:124px;font-size:25px;letter-spacing:.18em;color:rgba(255,236,214,.55)}
+.body{position:absolute;left:120px;width:780px;font-size:27px;line-height:1.9;color:rgba(255,244,232,.80)}
+.foot{position:absolute;left:120px;bottom:66px;font-family:"Helvetica Neue",sans-serif;font-size:14px;letter-spacing:.3em;color:rgba(255,220,190,.32)}
+.num{position:absolute;right:120px;bottom:58px;font-family:"Helvetica Neue",sans-serif;font-size:15px;letter-spacing:.2em;color:rgba(255,220,190,.42)}
+</style></head><body>
+<canvas id="c" width="1920" height="1080"></canvas>
+<div class="layer" id="layer"></div>
+<script>
+const CFG = __CFG__;
+const c=document.getElementById('c'),gl=c.getContext('webgl',{preserveDrawingBuffer:true});
+const VS="attribute vec2 p;void main(){gl_Position=vec4(p,0.,1.);}";
+const FS=`
+precision highp float;
+uniform vec2 R; uniform float T;
+uniform vec3 LIGHT; uniform vec2 ORIGIN; uniform vec2 DIR; uniform float INT;
+float h(vec2 p){return fract(sin(dot(p,vec2(127.1,311.7)))*43758.5453);}
+float n(vec2 p){vec2 i=floor(p),f=fract(p);f=f*f*(3.-2.*f);
+ return mix(mix(h(i),h(i+vec2(1,0)),f.x),mix(h(i+vec2(0,1)),h(i+vec2(1,1)),f.x),f.y);}
+float fbm(vec2 p){float v=0.,a=.5;for(int i=0;i<5;i++){v+=a*n(p);p*=2.03;a*=.5;}return v;}
+vec3 beamAt(vec2 st,float T,float bloom){
+  vec2 dir=normalize(DIR); vec2 nor=vec2(-dir.y,dir.x);
+  float along=dot(st-ORIGIN,dir);
+  float d=dot(st-ORIGIN,nor);
+  d+=0.010*sin(along*3.1+T*0.4)+0.006*sin(along*7.7-T*0.23);
+  float core=exp(-(d*70.0)*(d*70.0));
+  float body=exp(-(d*10.0)*(d*10.0));
+  float halo=exp(-(d*2.5)*(d*2.5));
+  float taper=smoothstep(-0.45,0.70,along)*smoothstep(1.85,0.95,along);
+  float stri=0.55+0.65*fbm(vec2(d*22.0,along*3.4-T*0.05));
+  stri*=0.72+0.42*fbm(vec2(d*6.0+3.0,along*1.1-T*0.02));
+  return vec3(core*1.9+body*0.95+halo*0.24*bloom)*stri*taper;
+}
+void main(){
+  vec2 st=(gl_FragCoord.xy-0.5*R)/R.y;
+  vec3 air=beamAt(st,T,1.0);
+  vec3 airCol=vec3(0.018,0.025,0.042)+LIGHT*air*INT+vec3(0.25,0.40,0.75)*air*0.08;
+
+  float horizon=-0.17;
+  float k=max(horizon-st.y,0.0);
+  vec2 mir=vec2(st.x,horizon+k);
+  float rip=fbm(vec2(st.x*3.0,k*9.0-T*0.25));
+  mir.x+=(rip-0.5)*0.10*smoothstep(0.0,0.5,k);
+  vec3 refl=beamAt(mir,T*0.5,0.7)*0.55;
+  float cau=fbm(vec2(st.x*4.0,k*14.0+T*0.06)); cau=cau*cau*cau;
+  vec3 floorCol=vec3(0.012,0.016,0.027)
+      +LIGHT*refl*0.95
+      +LIGHT*cau*0.22
+      +vec3(0.030,0.026,0.022)*exp(-k*3.0);
+
+  float m=smoothstep(horizon+0.035,horizon-0.035,st.y);
+  vec3 col=mix(airCol,floorCol,m);
+
+  float dust=0.0;
+  for(int i=0;i<4;i++){
+    float fi=float(i);
+    vec2 g=st*vec2(16.0+fi*7.0,16.0+fi*7.0)+vec2(fi*13.0,fi*7.0)+vec2(0.,-T*0.035*(1.+fi*0.4));
+    vec2 id=floor(g); vec2 f=fract(g)-0.5;
+    float rnd=h(id);
+    if(rnd>0.955){
+      float rad=0.10+0.16*fract(rnd*37.0);
+      dust+=smoothstep(rad,0.0,length(f))*smoothstep(0.955,1.0,rnd)*(0.55+0.45*sin(T*1.3+rnd*30.0));
+    }
+  }
+  col+=vec3(1.0,0.90,0.74)*dust*0.36*smoothstep(1.1,-0.1,length(st-ORIGIN));
+  col+=vec3(0.12,0.09,0.06)*exp(-((st.y-horizon)*14.0)*((st.y-horizon)*14.0))*0.35;
+  col*=1.0-0.60*smoothstep(0.12,-0.62,st.y);
+  col*=1.0-0.60*length(st*vec2(0.50,0.78));
+  col+=(h(gl_FragCoord.xy+T*11.0)-0.5)*0.010;
+  gl_FragColor=vec4(pow(max(col,0.0),vec3(0.92)),1.0);
+}`;
+function sh(t,s){const o=gl.createShader(t);gl.shaderSource(o,s);gl.compileShader(o);if(!gl.getShaderParameter(o,gl.COMPILE_STATUS))document.title='ERR '+gl.getShaderInfoLog(o);return o;}
+const pr=gl.createProgram();gl.attachShader(pr,sh(gl.VERTEX_SHADER,VS));gl.attachShader(pr,sh(gl.FRAGMENT_SHADER,FS));gl.linkProgram(pr);gl.useProgram(pr);
+const b=gl.createBuffer();gl.bindBuffer(gl.ARRAY_BUFFER,b);gl.bufferData(gl.ARRAY_BUFFER,new Float32Array([-1,-1,1,-1,-1,1,1,1]),gl.STATIC_DRAW);
+const loc=gl.getAttribLocation(pr,'p');gl.enableVertexAttribArray(loc);gl.vertexAttribPointer(loc,2,gl.FLOAT,false,0,0);
+const P=CFG.preset||{};
+const rgb=x=>{const m=x.replace('#','');return [parseInt(m.slice(0,2),16)/255,parseInt(m.slice(2,4),16)/255,parseInt(m.slice(4,6),16)/255];};
+gl.uniform2f(gl.getUniformLocation(pr,'R'),1920,1080);
+gl.uniform1f(gl.getUniformLocation(pr,'T'),CFG.time||0);
+gl.uniform3fv(gl.getUniformLocation(pr,'LIGHT'),rgb(P.light||'#ffc98a'));
+gl.uniform2fv(gl.getUniformLocation(pr,'ORIGIN'),new Float32Array(P.origin||[0.55,0.85]));
+gl.uniform2fv(gl.getUniformLocation(pr,'DIR'),new Float32Array(P.dir||[-0.42,-1.0]));
+gl.uniform1f(gl.getUniformLocation(pr,'INT'),P.intensity==null?1:P.intensity);
+gl.drawArrays(gl.TRIANGLE_STRIP,0,4);
+const el=document.getElementById('layer');
+const esc=s=>String(s).replace(/[&<>]/g,m=>({'&':'&amp;','<':'&lt;','>':'&gt;'}[m]));
+let html='';
+if(CFG.kicker)html+=`<div class="kicker" style="top:${CFG.kickerTop||96}px">${esc(CFG.kicker)}</div>`;
+if(CFG.title)html+=`<div class="rule" style="top:${CFG.titleTop-38}px"></div><h1 class="title" style="top:${CFG.titleTop}px">${esc(CFG.title).replace(/\n/g,'<br>')}</h1>`;
+if(CFG.sub)html+=`<div class="sub" style="top:${CFG.subTop}px">${esc(CFG.sub)}</div>`;
+if(CFG.body)html+=`<div class="body" style="top:${CFG.bodyTop}px">${CFG.body.split('\n').map(l=>`<div>${esc(l)}</div>`).join('')}</div>`;
+if(CFG.foot)html+=`<div class="foot">${esc(CFG.foot)}</div>`;
+if(CFG.num)html+=`<div class="num">${esc(CFG.num)}</div>`;
+el.innerHTML=html;
+document.title='READY';
+</script></body></html>

deck_shader-0.1.0.dist-info/METADATA

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: deck-shader
+Version: 0.1.0
+Summary: Decks whose light is computed, not painted — WebGL shader backgrounds exported to editable .pptx
+Author: anzy-renlab-ai
+License: MIT
+Project-URL: Homepage, https://github.com/anzy-renlab-ai/deck-shader
+Project-URL: Repository, https://github.com/anzy-renlab-ai/deck-shader
+Project-URL: Demo, https://anzy-renlab-ai.github.io/deck-shader/
+Keywords: pptx,webgl,shader,slides,presentation,python-pptx
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-pptx>=0.6.21
+Dynamic: license-file
+
+<div align="center">
+
+<img src="docs/loop.gif" width="880" alt="deck-shader: a volumetric light beam rendered by a fragment shader, under editable slide text">
+
+# deck-shader
+
+**Decks whose light is computed, not painted.**
+
+Write a JSON file. A shader renders the light — volumetric beams, caustics, drifting dust — and you get a `.pptx` where the text is still editable.
+
+`python3 scripts/render.py examples/hello/deck.json`
+
+<a href="https://anzy-renlab-ai.github.io/deck-shader/"><b>▶ Try it live in the browser — no install</b></a>
+
+<sub>A 6-second render from `examples/hello`. The text is native PowerPoint text; only the light is baked.</sub>
+
+</div>
+
+---
+
+## The problem
+
+Every slide background you have ever made is one of three things: a flat gradient, a stock photo, or a blurred blob someone spent twenty minutes on.
+
+None of them have light. They have *the suggestion of* light — a Photoshop drop shadow, a radial gradient, an overlay at 12% opacity.
+
+Light is a physical process. It scatters through dust, bends at a surface, casts caustics on a floor. That is a few lines of math, and your GPU has been able to do it in real time since 2010.
+
+So: describe the slide in JSON, render the light with a fragment shader, and lay native PowerPoint text on top.
+
+```
+deck.json  ──►  WebGL shader  ──►  background.png  ──►  .pptx (editable text)
+```
+
+## Why not just generate the background with a model
+
+Because you can't point at it.
+
+Ask a text-to-image model for "a warm beam of light cutting through a dark room" and you get something plausible. Ask it again and you get a different room. Change the color and the composition moves with it. There is no *"no, that beam, move it 40px left"* — there is only re-rolling and hoping.
+
+A shader is the same picture, but every property is a named number you can edit.
+
+| | text-to-image | this |
+|---|---|---|
+| change the light's position | re-roll, keep your fingers crossed | `"origin": [0.55, 0.85]` → `[0.42, 0.85]` |
+| run it twice | two different pictures | byte-identical |
+| brand color | drifts between generations | one hex, in one place |
+| the deck's 10 slides look related | if you're lucky | because they share a preset |
+| review a change | look at pixels | `git diff` |
+| who can fix it in six months | someone with the same model | anyone who can read JSON |
+| an agent can check its own work | no | re-render, assert the number |
+
+<img src="docs/aigc-vs-shader.png" width="880" alt="Top row: three text-to-image renders from one prompt — three different rooms. Bottom row: three shader renders with only origin.x changed — the same room, the beam moved">
+
+Top row: one prompt, three runs, three different rooms. Bottom row: one shader, one number changed, everything else identical. Nothing in the bottom row was re-rolled.
+
+The honest tradeoff: a shader cannot give you a photograph. It gives you light, atmosphere, and texture — procedural things. For a person, a product, a street, use a photo. This is the layer that decides whether the photo sits in a scene or on a slide.
+
+## Built for the one thing models are actually good at
+
+Ask a model to "design a beautiful slide" and you get an opinion. Ask it to make a number 8% bigger, or move a rule 40px left, or swap the light from `#ffc98a` to `#7fd1ff` — and it is flawless.
+
+Layout is a coordinate problem. Typography is a set of numbers. Light is math. All of it is expressible, all of it is checkable, none of it is a matter of taste once you've decided what the page says.
+
+So the deck is a file with pixel coordinates and a shader, and the model works the way it works best: edit → render → look → edit. Every change compiles into something you can see and `git diff`.
+
+```
+you:   把第 3 页的光往左挪一点，标题再小一号
+agent: [edits origin, sizePt] [renders] [opens the png]
+       origin x 0.55 → 0.42; title 40 → 36. beam now clears the text.
+```
+
+This is the part most "AI makes your slides" tools skip. They put the model in the role of *designer* — judgment, taste, one shot, no way to check. It is far better as a *craftsman*: exact, iterative, verifiable.
+
+The deck is a file. The renderer is a script. Nothing in the loop is un-inspectable.
+
+It ships with a `SKILL.md`, so Claude Code, WorkBuddy, or any host that reads skills can pick it up as-is.
+
+## What you get
+
+| | |
+|---|---|
+| `.pptx` | 13.33 × 7.5 in, background is a rendered image, **all text is native and editable** |
+| `.png` | 1920 × 1080 background plates, if you want to compose in Figma or Keynote |
+| `notes` | per-slide speaker notes, written straight into the pptx |
+
+## Quickstart
+
+```bash
+pip install git+https://github.com/anzy-renlab-ai/deck-shader
+deck-shader deck.json --out out/deck.pptx
+```
+
+Or from a checkout:
+
+```bash
+git clone https://github.com/anzy-renlab-ai/deck-shader && cd deck-shader
+pip install python-pptx
+python3 scripts/render.py examples/hello/deck.json --out out/hello.pptx
+```
+
+Requires Chrome (headless, for the WebGL pass). macOS path is auto-detected; override with `CHROME=/path/to/chrome`.
+
+## A slide is a list of elements at exact coordinates
+
+<img src="docs/precision-02.png" width="880" alt="A paper-white slide: kicker, title, two columns split by a 1px rule at x=656, one red sentence">
+
+Content slides are not "title + bullets + a theme". Every element is placed by
+hand — a text box at `x: 704`, a 1px rule at `x: 656`, a 96px number that is
+allowed to be bigger than the title because on this page it is the subject.
+
+```json
+{ "type": "rect", "x": 656, "y": 208, "w": 1, "h": 116, "fill": "#D8DEE4" },
+{ "type": "text", "x": 704, "y": 238, "w": 504, "h": 120, "paragraphs": [
+    { "align": "left", "lineSpacingPct": 170, "runs": [
+      { "text": "每一页只描述它自己要说的那件事。", "sizePt": 17,
+        "color": "#142B40", "font": "PingFang SC" } ] } ] }
+```
+
+Three element types: `text` (paragraphs → runs, each with its own font, size,
+color, letter-spacing), `rect` (hairlines, fills, dividers), `image`.
+
+Canvas is **1280 × 720**. 1 px = 0.75 pt, 1 in = 96 px — the numbers are the
+same ones you'd read off a Figma inspect panel, so you can measure once and
+type it in.
+
+<img src="docs/precision-03.png" width="880" alt="Three large numbers — 72, 1, 1 — each with a label and a two-line explanation">
+
+The full example is `examples/precision/`.
+
+### Why coordinates and not a layout engine
+
+A layout engine chooses where things go. That is exactly the thing you cannot
+delegate when the deck has to say something: the sentence that matters gets the
+same weight as the sentence that doesn't, and all ten slides come out looking
+like the same slide.
+
+Templates are *selected*. Coordinates are *written*. The difference shows up as
+whether a page can be louder than the page before it.
+
+## A deck is a JSON file
+
+```json
+{
+  "preset": { "light": "#ffc98a", "origin": [0.55, 0.85], "dir": [-0.42, -1.0], "intensity": 1.0 },
+  "style":  { "font": "Songti SC", "titleColor": "FFFFFF" },
+  "slides": [
+    {
+      "kicker": "DECK · SHADER",
+      "title": "光线是可以计算的",
+      "titleTop": 330,
+      "sub": "把 PPT 的背景交给 WebGL",
+      "subTop": 470,
+      "notes": "开场：先让他们注意到光，再注意到字。"
+    }
+  ]
+}
+```
+
+| field | meaning |
+|---|---|
+| `preset.light` | light color |
+| `preset.origin` | where the beam enters, in normalized stage coords |
+| `preset.dir` | beam direction |
+| `preset.intensity` | how hard it hits |
+| `time` | shader time; change it and the dust moves, the beam breathes |
+
+## Why this exists
+
+Two observations.
+
+**One.** A deck is read in three seconds, and the first thing anyone perceives is not your words — it is the light in the room. Slides with real light read as *staged*; slides with gradients read as *slides*.
+
+**Two.** Agent skills that "generate decks" all stop at layout. They arrange boxes. None of them render anything. The moment you want a背景 that looks photographed, you are back in Photoshop.
+
+This is the missing layer: a renderer, not a template.
+
+## Roadmap
+
+- [x] volumetric beam + floor caustics + dust, parameterized
+- [x] JSON → PNG → editable `.pptx`
+- [x] absolute element model: `text` / `rect` / `image` at 1280×720, 1px = 0.75pt
+- [ ] presets: `editorial`, `glass`, `dawn`, `signal`
+- [ ] video export (15s loop, for social covers)
+- [x] HTML runtime (same shader, live in a browser)
+- [ ] paper mode: arXiv PDF → deck outline → rendered deck
+
+## Works as an agent skill
+
+`SKILL.md` is included. Drop the folder into `~/.claude/skills/` (Claude Code), `~/.workbuddy/skills/` (WorkBuddy), or any host that reads `SKILL.md`, and the agent can render decks directly.
+
+## License
+
+MIT.

deck_shader-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+deck_shader/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+deck_shader/cli.py,sha256=mE1xG_Y2INIt8IAKAliHvbOXcrycTXNrTlCp-TzI44Y,10932
+deck_shader/template.html,sha256=bXjsNmzBZoCBfapOab9vn2bgBqHiph7DZkjZC-fO_Aw,6132
+deck_shader/presets/cinematic.json,sha256=b85aOKsvx5_ckB02Fz3sFK7ubJfHSyX4Q6wW5TnODro,85
+deck_shader/presets/editorial.json,sha256=j_ODOVGhRMmDGlXFxdN9s86KsbhiAvTXoxlFFcE3O9A,86
+deck_shader/presets/signal.json,sha256=ziXp-FU_e7BGuobDUZYYEQ8A8q1HcH7vCqHSQcV0QUI,86
+deck_shader-0.1.0.dist-info/licenses/LICENSE,sha256=CTEtBIs1e2IO2SQcAcGUsW0Pt_jfixUfqkh8olTMpDU,1071
+deck_shader-0.1.0.dist-info/METADATA,sha256=k_R6jBQ2wVL1_9dROXKCJlAYcBd-4-v9U67ZZQiNt50,9365
+deck_shader-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+deck_shader-0.1.0.dist-info/entry_points.txt,sha256=ngQzlzZMpJpM8W60tVPSuMdvRW4bNfmeAgzVUw72sWM,53
+deck_shader-0.1.0.dist-info/top_level.txt,sha256=RnPmygPMkL0YA1TIKkpUGSPMmDU4bdnHYcVxmgihap8,12
+deck_shader-0.1.0.dist-info/RECORD,,

deck_shader-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

deck_shader-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+deck-shader = deck_shader.cli:main

deck_shader-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 anzy-renlab-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

deck_shader-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+deck_shader