Prepare a polished conference showcase kit with editable and raster handoffs

This commit is contained in:
Dandaedre 2026-11-17 18:56:17 +01:00
parent 9bbb19c9e3
commit b20e88e917
Signed by: Dandaedre
GPG Key ID: 440C6592E8A26D99
8 changed files with 508 additions and 2 deletions

1
.gitignore vendored
View File

@ -12,3 +12,4 @@ __pycache__/
# Local showcase recordings, profiles and generated exchange files.
/showcase-videos/
/showcase-conference-kit/

2
Cargo.lock generated
View File

@ -548,7 +548,7 @@ dependencies = [
[[package]]
name = "canvas-pilot"
version = "0.9.43"
version = "0.9.44"
dependencies = [
"base64",
"craft-dwg",

View File

@ -4,7 +4,7 @@ default-members = ["crates/canvas-pilot"]
resolver = "3"
[workspace.package]
version = "0.9.43"
version = "0.9.44"
edition = "2024"
license = "MIT"
repository = "https://proxy.dandaedre.com/gitea/idle-org/canvas-pilot"

View File

@ -4,6 +4,14 @@
## Unreleased
### v0.9.44
- Added a separate, reproducible Lumen Forum showcase kit: polished PIP infodecor,
synthetic speaker media, an editable three-slide deck, raster-only/editable
handoffs, three layouts in five exchange formats, projects and silent demo loops.
Generated assets stay local and Git-ignored. Verified native geometry imports,
LibreOffice rendering and video dimensions/durations; no device activity.
### v0.9.43
- Added a standalone Ravenswatch palette with midnight-blue surfaces, aged ivory

View File

@ -41,6 +41,49 @@ The SVG demonstrations exercise interchange without pretending to record Illustr
Figma or draw.io. Actual captures from those applications, live input capture, other
file codecs and physical device output require separate application/device sessions.
## Conference handoff kit
A separate local `showcase-conference-kit/` directory supplies a fictional **Lumen
Forum** event for recording the raster-only versus editable-client workflow.
It leaves the existing `showcase-videos/` recordings intact. Start with its
`index.html` preview and `START-HERE.txt` recording guide.
The kit includes a clean 1920 × 1080 background, empty PIP infodecor, a placement
guide and a complete speaker/slide composite; three editable presentation slides;
a synthetic portrait; and silent speaker-motion, presentation and background MP4s.
The speaker loop is a pan/zoom of a generated still, not a real recorded talk.
All names, event content and slide data are fictional.
`delivery-jpg-only/` contains flattened PNG/JPGs and a deliberately degraded
960 × 540 JPEG. Raster files are reference artwork, not editable geometry.
`delivery-editable/` contains native PPTX text/shapes, vector SVG slides and a
composition whose speaker/slide pictures move independently in PPTX/draw.io/SVG.
Three layout folders each contain a project plus SVG, draw.io, PPTX, JSON and CSV
geometry. The main speaker box is `(72,260,432,576)`; the slide box is
`(552,260,1296,729)`. Coordinates are top-left screen pixels. The other layouts
show a large slide and a side-by-side pair. Projects have no device links.
Rebuild into a **new** directory with the supplied 3:4 speaker PNG:
```sh
python3 scripts/prepare-conference-showcase.py \
--speaker showcase-conference-kit/media/speaker/alex-morgan-synthetic.png \
--output /tmp/lumen-forum-rebuilt
```
The recipe uses Python's standard library, `rsvg-convert`, FFmpeg and ffprobe,
and refuses to replace an existing output folder. DejaVu Sans is the design font.
The portrait was made with the built-in image-generation tool using
[the saved prompt](../../scripts/showcase-speaker-prompt.txt); rebuilds reuse the
image rather than make new network calls. Generated assets remain local and ignored
by Git. The recipe, prompt and checks are versioned.
Prepared-kit validation includes exact geometry imports through Canvas Pilot,
project loading, LibreOffice PDF renders of the native decks, and ffprobe checks
of dimensions and durations. PowerPoint itself and the draw.io GUI were not used;
draw.io geometry was checked by the application importer. `verification/` holds
the local evidence. This is offline artwork evidence, not device acceptance.
## Recording environment
Use a dedicated X11 display, not the working desktop. The script sends real mouse

View File

@ -0,0 +1,375 @@
#!/usr/bin/env python3
"""Build an offline Lumen Forum recording kit; requires rsvg-convert and ffmpeg.
The speaker is a supplied synthetic PNG; no network, device, or image-generation
calls are made by this recipe. Native PPTX packages reuse the repository's starter
master/theme and contain editable shapes/text or independently movable pictures.
"""
import argparse
import base64
import copy
import csv
import html
import json
from pathlib import Path
import shutil
import struct
import subprocess
import xml.etree.ElementTree as ET
import zipfile
ROOT = Path(__file__).resolve().parents[1]
W, H = 1920, 1080
NAVY, PANEL, TEAL, GOLD, WHITE, MUTED = '#071b2b', '#102e40', '#56d9ca', '#edbd73', '#f5f1e8', '#a5b9c4'
P, A, R = ('http://schemas.openxmlformats.org/' + x for x in (
'presentationml/2006/main', 'drawingml/2006/main', 'officeDocument/2006/relationships'))
REL = 'http://schemas.openxmlformats.org/package/2006/relationships'
CT = 'http://schemas.openxmlformats.org/package/2006/content-types'
LAYOUTS = {
'01-speaker-and-slides': [('Speaker', 72, 260, 432, 576), ('Presentation', 552, 260, 1296, 729)],
'02-slide-focus': [('Presentation', 96, 54, 1728, 972)],
'03-side-by-side': [('Speaker', 72, 288, 864, 486), ('Presentation', 984, 288, 864, 486)],
}
def run(args):
subprocess.run([str(a) for a in args], check=True, stdout=subprocess.DEVNULL,
stderr=subprocess.PIPE, timeout=180)
def save(path, data):
path.parent.mkdir(parents=True, exist_ok=True)
path.write_bytes(data) if isinstance(data, bytes) else path.write_text(data, encoding='utf-8')
def png_dimensions(path):
with path.open('rb') as source:
header = source.read(24)
if len(header) != 24 or header[:8] != b'\x89PNG\r\n\x1a\n':
raise ValueError('Speaker must be a PNG')
width, height = struct.unpack('>II', header[16:24])
if not width or not height or width * 4 != height * 3:
raise ValueError('Speaker must have a 3:4 aspect ratio to avoid stretching')
return width, height
def rect(x, y, w, h, fill, name='Decor', stroke=None, kind='rect', role='background'):
return dict(kind=kind, x=x, y=y, w=w, h=h, fill=fill, name=name, stroke=stroke, role=role)
def text(x, y, value, size=28, color=WHITE, bold=False, width=1700):
return dict(kind='text', x=x, y=y, w=width, h=size*1.35, text=value, size=size,
fill=color, bold=bold, name=value, role='background')
def picture(x, y, w, h, path, name, role='layer'):
return dict(kind='image', x=x, y=y, w=w, h=h, path=path, name=name, role=role)
def svg(scene, marked=False):
parts = [f'<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="{W}" height="{H}" viewBox="0 0 {W} {H}"' + (' data-midra-layout-geometry="2"' if marked else '') + '>']
for i, e in enumerate(scene):
x,y,w,h = [e[k] for k in ('x','y','w','h')]
attrs = f'id="shape-{i}" data-midra-role="{e["role"]}"'
title = f'<title>{html.escape(e["name"])}</title>'
if e['kind'] == 'image':
data = base64.b64encode(e['path'].read_bytes()).decode()
parts.append(f'<image {attrs} x="{x}" y="{y}" width="{w}" height="{h}" preserveAspectRatio="xMidYMid slice" xlink:href="data:image/png;base64,{data}">{title}</image>')
elif e['kind'] == 'text':
parts.append(f'<text x="{x}" y="{y+e["size"]}" font-family="DejaVu Sans" font-size="{e["size"]}" font-weight="{700 if e["bold"] else 400}" fill="{e["fill"]}">{html.escape(e["text"])}</text>')
else:
style = f'fill="{e["fill"] or "none"}" stroke="{e["stroke"] or "none"}" stroke-width="2"'
if e['kind'] == 'ellipse':
parts.append(f'<ellipse cx="{x+w/2}" cy="{y+h/2}" rx="{w/2}" ry="{h/2}" {style}>{title}</ellipse>')
else:
parts.append(f'<rect {attrs} x="{x}" y="{y}" width="{w}" height="{h}" {style}>{title}</rect>')
return '\n'.join(parts+['</svg>'])
def render(scene, stem, jpeg=True):
save(stem.with_suffix('.svg'), svg(scene))
run(['rsvg-convert', '-o', stem.with_suffix('.png'), stem.with_suffix('.svg')])
if jpeg:
run(['ffmpeg','-v','error','-y','-i',stem.with_suffix('.png'),'-frames:v','1','-q:v','2',stem.with_suffix('.jpg')])
def drawio(scene, path):
root = ET.Element('mxfile', host='Canvas Pilot showcase', compressed='false')
diagram = ET.SubElement(root,'diagram',id='lumen',name='Lumen Forum')
model = ET.SubElement(diagram,'mxGraphModel',page='1',pageScale='1',pageWidth=str(W),pageHeight=str(H),grid='0',adaptiveColors='none', **{'data-midra-layout-geometry':'1'})
cells = ET.SubElement(model,'root')
ET.SubElement(cells,'mxCell',id='0'); ET.SubElement(cells,'mxCell',id='1',parent='0')
for i,e in enumerate(scene):
style = 'rounded=0;whiteSpace=wrap;html=0;strokeColor=none;'
if e['kind'] == 'image':
style += 'shape=image;imageAspect=0;image=data:image/png,' + base64.b64encode(e['path'].read_bytes()).decode() + ';'
else:
style += f'fillColor={e["fill"]};fontColor=#ffffff;'
cell = ET.SubElement(cells,'mxCell',id=f'layer-{i+1}',value=e['name'] if e['role']=='layer' else '',vertex='1',parent='1',style=style, **{'data-midra-role':e['role']})
ET.SubElement(cell,'mxGeometry',x=str(e['x']),y=str(e['y']),width=str(e['w']),height=str(e['h']), **{'as':'geometry'})
save(path,ET.tostring(root,encoding='utf-8',xml_declaration=True))
def pptx(scenes, path):
"""Native text, rectangles and pictures, in 96-pixel/inch slide coordinates."""
for prefix, uri in [('p', P), ('a', A), ('r', R)]:
ET.register_namespace(prefix, uri)
with zipfile.ZipFile(ROOT/'docs/templates/canvas-pilot/canvas-pilot-1080p-2-layers.pptx') as z:
package = {n:z.read(n) for n in z.namelist()}
pres = ET.fromstring(package['ppt/presentation.xml'])
ids = pres.find(f'{{{P}}}sldIdLst'); ids.clear()
rels = ET.fromstring(package['ppt/_rels/presentation.xml.rels'])
for rel in list(rels):
if rel.attrib['Type'].endswith('/slide'): rels.remove(rel)
types = ET.fromstring(package['[Content_Types].xml'])
for entry in list(types):
if entry.attrib.get('PartName','').startswith('/ppt/slides/'): types.remove(entry)
ET.SubElement(types,f'{{{CT}}}Default',Extension='png',ContentType='image/png')
for number,scene in enumerate(scenes,1):
ET.SubElement(ids,f'{{{P}}}sldId',id=str(255+number), **{f'{{{R}}}id':f'showcase{number}'})
ET.SubElement(rels,f'{{{REL}}}Relationship',Id=f'showcase{number}',Type=R+'/slide',Target=f'slides/slide{number}.xml')
ET.SubElement(types,f'{{{CT}}}Override',PartName=f'/ppt/slides/slide{number}.xml',ContentType='application/vnd.openxmlformats-officedocument.presentationml.slide+xml')
shapes=[]; image_rels=[]
for i,e in enumerate(scene,2):
x,y,w,h=[round(e[k]*9525) for k in ('x','y','w','h')]
transform=f'<a:xfrm><a:off x="{x}" y="{y}"/><a:ext cx="{w}" cy="{h}"/></a:xfrm>'
name=html.escape('midra-background' if e['kind']=='image' and e['role']=='background' else e['name'],quote=True)
if e['kind']=='image':
media=f'showcase-{number}-{i}.png'; package['ppt/media/'+media]=e['path'].read_bytes()
image_rels.append(f'<Relationship Id="img{i}" Type="{R}/image" Target="../media/{media}"/>')
shapes.append(f'<p:pic><p:nvPicPr><p:cNvPr id="{i}" name="{name}"/><p:cNvPicPr/><p:nvPr/></p:nvPicPr><p:blipFill><a:blip r:embed="img{i}"/><a:stretch><a:fillRect/></a:stretch></p:blipFill><p:spPr>{transform}<a:prstGeom prst="rect"><a:avLst/></a:prstGeom></p:spPr></p:pic>')
continue
color=(e['fill'] or '#000000').lstrip('#')
fill=f'<a:solidFill><a:srgbClr val="{color}"/></a:solidFill>' if e['fill'] and e['kind']!='text' else '<a:noFill/>'
stroke=f'<a:ln w="19050"><a:solidFill><a:srgbClr val="{e["stroke"].lstrip("#")}"/></a:solidFill></a:ln>' if e.get('stroke') else '<a:ln><a:noFill/></a:ln>'
geom='ellipse' if e['kind']=='ellipse' else 'rect'
body=''
if e['kind']=='text':
size=round(e['size']*75)
body=f'<p:txBody><a:bodyPr wrap="none" lIns="0" rIns="0" tIns="0" bIns="0" anchor="t"/><a:lstStyle/><a:p><a:pPr><a:lnSpc><a:spcPct val="100000"/></a:lnSpc></a:pPr><a:r><a:rPr lang="en-US" sz="{size}" b="{int(e["bold"])}"><a:solidFill><a:srgbClr val="{color}"/></a:solidFill><a:latin typeface="DejaVu Sans"/></a:rPr><a:t>{html.escape(e["text"])}</a:t></a:r><a:endParaRPr sz="{size}"/></a:p></p:txBody>'
shapes.append(f'<p:sp><p:nvSpPr><p:cNvPr id="{i}" name="{name}"/><p:cNvSpPr txBox="{int(e["kind"]=="text")}"/><p:nvPr/></p:nvSpPr><p:spPr>{transform}<a:prstGeom prst="{geom}"><a:avLst/></a:prstGeom>{fill}{stroke}</p:spPr>{body}</p:sp>')
content=f'<p:sld xmlns:p="{P}" xmlns:a="{A}" xmlns:r="{R}" showMasterSp="0"><p:cSld name="Lumen {number}"><p:spTree><p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr><p:grpSpPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/><a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/></a:xfrm></p:grpSpPr>{"".join(shapes)}</p:spTree></p:cSld><p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr></p:sld>'
package[f'ppt/slides/slide{number}.xml']=content.encode()
package[f'ppt/slides/_rels/slide{number}.xml.rels']=(f'<Relationships xmlns="{REL}"><Relationship Id="rId1" Type="{R}/slideLayout" Target="../slideLayouts/slideLayout1.xml"/>{"".join(image_rels)}</Relationships>').encode()
for n,root in [('ppt/presentation.xml',pres),('ppt/_rels/presentation.xml.rels',rels),('[Content_Types].xml',types)]:
if n.endswith('.rels'): ET.register_namespace('', REL)
if n == '[Content_Types].xml': ET.register_namespace('', CT)
package[n]=ET.tostring(root,encoding='utf-8',xml_declaration=True)
with zipfile.ZipFile(path,'w',zipfile.ZIP_DEFLATED) as z:
for n,data in package.items():
info=zipfile.ZipInfo(n,(2026,1,1,0,0,0));info.compress_type=zipfile.ZIP_DEFLATED
z.writestr(info,data)
def background():
return [rect(0,0,W,H,NAVY),rect(1450,0,470,H,'#0b2637'),
rect(1530,100,650,650,None,stroke='#194456',kind='ellipse'),
rect(1620,190,470,470,None,stroke='#194456',kind='ellipse'),
rect(72,64,14,34,TEAL),text(104,62,'LUMEN / FORUM',28,bold=True),
text(72,115,'Ideas into impact.',66,bold=True),
text(75,202,'PEOPLE / DESIGN / POSITIVE CHANGE',22,MUTED),
text(1550,64,'THE NEXT CHAPTER',18,GOLD,width=300),
text(1550,96,'STUDIO 01 • 2026',20,width=300),
rect(72,1014,1776,2,'#31515e'),text(72,1034,'LUMEN FORUM',17,GOLD),
text(660,1034,'MAKE SPACE FOR WHAT COMES NEXT.',17,MUTED),
text(1610,1034,'FICTIONAL DEMO',17,MUTED,width=240)]
def frame_scene():
scene=background()
scene += [text(72,228,'01 / ON STAGE',18,TEAL),text(552,228,'02 / THE BIG PICTURE',18,TEAL)]
for name,x,y,w,h in LAYOUTS['01-speaker-and-slides']:
scene += [rect(x-3,y-3,w+6,h+6,'#315566'),rect(x,y,w,h,PANEL)]
scene += [rect(72,861,42,4,GOLD),text(72,882,'Alex Morgan',32,bold=True,width=460),
text(72,928,'Design researcher',22,MUTED,width=460),text(72,962,'A fictional keynote',18,MUTED,width=460)]
return scene
def slides():
def base(n,section):
return [rect(0,0,W,H,'#f5f1e8'),rect(0,0,24,H,TEAL),text(96,70,'LUMEN / FORUM',24,NAVY,True),
text(1340,70,section,22,'#536d72',width=500),rect(96,964,1728,2,'#ced6ce'),
text(96,994,'ILLUSTRATIVE DEMO DATA · FICTIONAL EVENT',18,'#536d72'),text(1740,992,f'0{n}',24,NAVY,True,width=80)]
one=base(1,'01 / FROM SIGNAL TO ACTION')
one += [text(96,210,'From signals',82,NAVY,True),text(96,310,'to useful change.',82,NAVY,True),
text(100,464,'Start with people.',34,'#476168'),text(100,518,'Test something small.',34,'#476168'),
text(100,572,'Build on what works.',34,'#476168'),rect(96,720,690,132,NAVY),
text(128,745,'Progress is a practice.',36,WHITE,True,width=640),text(128,800,'Not a single big reveal.',24,TEAL,width=640)]
for x,h,value,label,c in [(1010,240,'42','SIGNALS','#96b8b4'),(1280,390,'68','TRIALS','#329f99'),(1550,540,'86','ADOPTION',NAVY)]:
one += [rect(x,840-h,180,h,c),text(x,770-h,value,48,NAVY,True,width=190),text(x,870,label,20,'#476168',True,width=230)]
two=base(2,'02 / A SIMPLE WORKING MODEL')
two += [text(96,180,'Three moves. One direction.',72,NAVY,True)]
for x,num,title,lines in [(96,'01','Listen',['Find the friction.','Ask better questions.']),(684,'02','Prototype',['Make the idea visible.','Keep the first test small.']),(1272,'03','Learn',['Share the evidence.','Choose the next step.'])]:
two += [rect(x,374,552,466,'#e5e9df'),rect(x,374,552,8,TEAL),text(x+36,416,num,64,'#299d96',True,width=480),text(x+36,548,title,44,NAVY,True,width=480),text(x+36,644,lines[0],27,'#476168',width=480),text(x+36,692,lines[1],27,'#476168',width=480)]
three=base(3,'03 / KEEP THE MOMENTUM')
three += [text(96,184,'Small pilots. Lasting impact.',72,NAVY,True),
rect(96,362,810,392,NAVY),text(140,402,'72%',140,TEAL,True,width=700),text(144,600,'would try the next pilot',34,WHITE,width=700),
rect(954,362,870,392,'#e5e9df'),text(1000,402,'3 weeks',112,NAVY,True,width=780),text(1004,600,'from question to first learning',32,'#476168',width=790),
text(100,818,'What is the smallest useful thing we can test next?',40,NAVY,True)]
return [one,two,three]
def geometry_files(out, name, boxes):
directory=out/'layouts'/name;directory.mkdir(parents=True)
scene=[rect(x,y,w,h,'#24546a',label,role='layer') for label,x,y,w,h in boxes]
save(directory/'layout.svg',svg(scene,marked=True));drawio(scene,directory/'layout.drawio');pptx([scene],directory/'layout.pptx')
layers=[dict(id=f'layer-{i+1}',name=label,role='layer',x=x,y=y,width=w,height=h) for i,(label,x,y,w,h) in enumerate(boxes)]
save(directory/'layout.json',json.dumps(dict(format='beffroi.midra-geometry',version=1,units='px',canvas=dict(width=W,height=H),layers=layers),indent=2)+'\n')
with (directory/'layout.csv').open('w',newline='') as f:
writer=csv.writer(f);writer.writerow(['midra_geometry_version','canvas_width','canvas_height','id','name','role','x','y','width','height'])
writer.writerows((1,W,H,f'layer-{i+1}',label,'layer',x,y,w,h) for i,(label,x,y,w,h) in enumerate(boxes))
project=json.loads((ROOT/'docs/interfaces/canvas-pilot-v18.example.json').read_text())
speaker_size=png_dimensions(out/'media/speaker/alex-morgan-synthetic.png')
template=copy.deepcopy(project['layers'][0]);project['layers']=[];project['inputs']=[]
for i,(label,x,y,w,h) in enumerate(boxes,1):
layer=copy.deepcopy(template);layer.update(id=i,source_id=i,bounds=dict(x=x,y=y,width=w,height=h),name=label,folder='',device_link=None,layer_fit='centered' if label=='Speaker' else 'fullscreen',visible=True,locked=False)
layer['advanced_crop']=dict.fromkeys(['left','right','top','bottom'],0.0)
layer['mask']=dict(origin='layer',left=0.0,right=0.0,top=0.0,bottom=0.0)
project['layers'].append(layer)
project['inputs'].append(dict(id=i,source_format='custom',native_resolution=dict(width=speaker_size[0] if label=='Speaker' else W,height=speaker_size[1] if label=='Speaker' else H),input_crop=dict.fromkeys(['left','right','top','bottom'],0.0)))
project.update(next_layer_id=len(boxes)+1,folders=[],input_proposals=[])
project['editor'].update(backdrop_title='Lumen Forum',selected_layer_ids=[1],position_point='top_left',position_layer_point=None,viewport_zoom=1,viewport_pan=[0,0],outline_layers=True,show_source_pattern=False)
project['workspace'].update(previews=[],collapsed_folders=[])
project['workspace']['snapping'].update(show_grid=False,enabled=True)
reference=out/'delivery-jpg-only'/'program-example.png'
project['references']=[dict(name=reference.name,image_base64=base64.b64encode(reference.read_bytes()).decode(),visible=name=='01-speaker-and-slides',opacity=1.0,preserve_ratio=True,native_size=True,offset=[0.0,0.0])]
save(directory/'ready-to-align.pilot.json',json.dumps(project,indent=2)+'\n')
def main():
parser=argparse.ArgumentParser(description=__doc__)
parser.add_argument('--speaker',type=Path,required=True)
parser.add_argument('--output',type=Path,default=ROOT/'showcase-conference-kit')
args=parser.parse_args();out=args.output.resolve()
if out.exists(): raise SystemExit(f'Refusing to replace existing kit: {out}')
if not args.speaker.is_file(): raise SystemExit('Speaker PNG does not exist')
png_dimensions(args.speaker)
for tool in ['rsvg-convert','ffmpeg','ffprobe']:
if not shutil.which(tool): raise SystemExit(f'Required rendering tool missing: {tool}')
for folder in ['media/speaker','media/slides','media/backgrounds','media/video','delivery-jpg-only','delivery-editable','layouts','sources','verification']:
(out/folder).mkdir(parents=True,exist_ok=True)
speaker=out/'media/speaker/alex-morgan-synthetic.png';shutil.copyfile(args.speaker,speaker)
prompt=ROOT/'scripts/showcase-speaker-prompt.txt'
shutil.copyfile(prompt,out/'sources/speaker-generation-prompt.txt')
save(out/'sources/provenance.json',json.dumps(dict(event='Lumen Forum — fictional demo',speaker='Alex Morgan — fictional AI-generated person',method='Built-in image_gen tool',prompt='speaker-generation-prompt.txt',data='All slide metrics are invented demonstration data',artwork='Original code-native layout, text, shapes and charts',video='Silent synthetic demo loops; speaker animation is a still-image pan/zoom, not a recording of a live talk'),indent=2)+'\n')
render(background(),out/'media/backgrounds/background-only')
render(frame_scene(),out/'media/backgrounds/infodecor-empty')
guide=frame_scene()+[text(112,460,'SPEAKER',40,TEAL,True,width=360),text(112,528,'432 × 576 / 3:4',24,width=360),text(112,570,'X 72 Y 260',22,MUTED,width=360),text(780,530,'PRESENTATION',64,TEAL,True,width=1000),text(780,630,'1296 × 729 / 16:9',36,width=1000),text(780,690,'X 552 Y 260',28,MUTED,width=1000)]
render(guide,out/'media/backgrounds/infodecor-placement-guide')
pptx([background(),frame_scene()],out/'delivery-editable/background-and-infodecor.pptx')
deck=slides()
for i,scene in enumerate(deck,1): render(scene,out/f'media/slides/slide-{i:02d}')
pptx(deck,out/'delivery-editable/presentation.pptx')
# A native editable rectangle/text rendition of the slides is supplied as SVG.
for i in range(1,4): shutil.copyfile(out/f'media/slides/slide-{i:02d}.svg',out/f'delivery-editable/slide-{i:02d}.svg')
shutil.copyfile(out/'media/backgrounds/background-only.svg',out/'delivery-editable/background-only.svg')
shutil.copyfile(out/'media/backgrounds/infodecor-empty.svg',out/'delivery-editable/infodecor-empty.svg')
# Pictures have exact source/destination ratios; no hidden stretching/cropping.
composite=[picture(0,0,W,H,out/'media/backgrounds/infodecor-empty.png','Infodecor','background'),picture(72,260,432,576,speaker,'Speaker'),picture(552,260,1296,729,out/'media/slides/slide-01.png','Presentation')]
render(composite,out/'delivery-jpg-only/program-example')
drawio(composite,out/'delivery-editable/composition.drawio');pptx([composite],out/'delivery-editable/composition.pptx')
save(out/'delivery-editable/composition.svg',svg(composite,marked=True))
for name in ['background-only','infodecor-empty']:
for ext in ['png','jpg']: shutil.copyfile(out/f'media/backgrounds/{name}.{ext}',out/f'delivery-jpg-only/{name}.{ext}')
for ext in ['png','jpg']: shutil.copyfile(out/f'media/slides/slide-01.{ext}',out/f'delivery-jpg-only/presentation-slide.{ext}')
for name,boxes in LAYOUTS.items(): geometry_files(out,name,boxes)
save(out/'sources/geometry-truth.json',json.dumps(dict(canvas=[W,H],units='pixels; origin top-left',layouts=LAYOUTS),indent=2)+'\n')
# Static raster PDFs are deliberately labeled as proof documents, not editable geometry.
for stem in ['program-example']:
run(['rsvg-convert','-f','pdf','-o',out/f'delivery-jpg-only/{stem}.pdf',out/f'delivery-jpg-only/{stem}.svg'])
run(['ffmpeg','-v','error','-y','-i',out/'delivery-jpg-only/program-example.png','-vf','scale=960:540','-frames:v','1','-q:v','7',out/'delivery-jpg-only/client-email-960.jpg'])
(out/'delivery-jpg-only/program-example.svg').unlink() # genuinely raster-only handoff
run(['ffmpeg','-v','error','-y','-loop','1','-i',speaker,'-vf',"scale=810:1080,zoompan=z='min(zoom+0.0002,1.04)':x='iw/2-iw/zoom/2':y='ih/2-ih/zoom/2':d=250:s=810x1080:fps=25",'-t','10','-an','-c:v','libx264','-pix_fmt','yuv420p','-crf','22',out/'media/video/speaker-synthetic-still-motion.mp4'])
sequence=out/'sources/slides.ffconcat'
save(sequence,'ffconcat version 1.0\n'+''.join(f"file '../media/slides/slide-{i:02d}.png'\nduration 5\n" for i in range(1,4))+"file '../media/slides/slide-03.png'\n")
run(['ffmpeg','-v','error','-y','-safe','0','-f','concat','-i',sequence,'-r','25','-t','15','-an','-c:v','libx264','-pix_fmt','yuv420p','-crf','21',out/'media/video/presentation-loop.mp4'])
run(['ffmpeg','-v','error','-y','-loop','1','-i',out/'media/backgrounds/background-only.png','-t','10','-r','25','-an','-c:v','libx264','-pix_fmt','yuv420p','-crf','22',out/'media/video/background-hold.mp4'])
run(['ffmpeg','-v','error','-y','-loop','1','-i',out/'media/backgrounds/infodecor-empty.png','-stream_loop','-1','-i',out/'media/video/speaker-synthetic-still-motion.mp4','-i',out/'media/video/presentation-loop.mp4','-filter_complex','[1:v]scale=432:576,setsar=1[sp];[2:v]scale=1296:729,setsar=1[sl];[0:v][sp]overlay=72:260[tmp];[tmp][sl]overlay=552:260,format=yuv420p[v]','-map','[v]','-t','15','-r','25','-an','-c:v','libx264','-crf','21',out/'media/video/program-example.mp4'])
video_checks = {}
for name, width, height, seconds in [('speaker-synthetic-still-motion',810,1080,10),('presentation-loop',1920,1080,15),('background-hold',1920,1080,10),('program-example',1920,1080,15)]:
result = subprocess.check_output(['ffprobe','-v','error','-show_streams','-show_format','-of','json',str(out/f'media/video/{name}.mp4')], timeout=30)
metadata = json.loads(result); stream = metadata['streams'][0]
if (stream['width'],stream['height']) != (width,height) or abs(float(metadata['format']['duration'])-seconds)>0.1:
raise ValueError(f'Unexpected encoded video dimensions/duration: {name}')
video_checks[name] = metadata
save(out/'verification/video-metadata.json',json.dumps(video_checks,indent=2)+'\n')
# The source text is intentionally plain text, not a second documentation system.
save(out/'START-HERE.txt',START_HERE)
preview=out/'delivery-jpg-only/program-example.jpg'
save(out/'index.html',f'''<!doctype html><meta charset="utf-8"><title>Lumen Forum showcase kit</title><style>body{{margin:3em auto;max-width:1100px;background:{NAVY};color:{WHITE};font:18px/1.6 sans-serif}}a{{color:{TEAL}}}img{{width:100%;border:1px solid #315566}}small{{color:{MUTED}}}</style><h1>Lumen Forum / showcase kit</h1><p>A fictional conference. One design, two client handoffs.</p><img src="{preview.relative_to(out)}" alt="Speaker and presentation on a dark teal conference infodecor"><p><a href="START-HERE.txt">Recording guide &amp; file map</a> · <a href="delivery-jpg-only/">Raster-only delivery</a> · <a href="delivery-editable/">Editable delivery</a> · <a href="layouts/">Importable layouts</a> · <a href="media/video/program-example.mp4">Program preview video</a> · <a href="media/video/">Demo loops</a></p><small>Speaker is AI-generated. Names, event and metrics are fictional.</small>''')
print(out)
START_HERE = '''LUMEN FORUM / CANVAS PILOT RECORDING KIT
1920 × 1080 output; all names, metrics and event content are fictional.
OPEN index.html for the visual overview. No server is needed.
01 — THE RASTER-ONLY CLIENT (WORST CASE)
Pretend the client sends only delivery-jpg-only/program-example.jpg or .png.
For a deliberately degraded delivery, use client-email-960.jpg (960 × 540).
Use Import → Reference image. Raster artwork has no editable layer geometry:
add/position rectangles manually against the image. Try lower-quality JPG vs PNG.
Reveal sources/geometry-truth.json only after the manual alignment demonstration.
The infodecor-placement-guide in media/backgrounds labels the exact pixel boxes.
background-only is the clean full background; infodecor-empty adds framed windows
and speaker labels. presentation-slide is the separate flattened presentation input.
The program PDF is a visual proof, not a supported geometry exchange format.
02 — THE EDITABLE CLIENT (BEST CASE)
Import layouts/01-speaker-and-slides/layout.drawio, .pptx, .svg, .json or .csv via
Import → Geometry file. Each contains ONLY the two named rectangles. Review and
map Speaker and Presentation. They agree to exact screen-pixel coordinates.
delivery-editable/composition.drawio, .pptx and .svg include the same two pictures
as independently movable objects plus the full-page infodecor image. Review the
background separately; do not map it as another live video layer.
The layout-only files are the least ambiguous geometry handoff.
03 — EDIT THE ACTUAL ARTWORK / PRESENTATION
presentation.pptx has three slides with editable text, shapes and chart bars.
slide-01/02/03.svg are matching editable vector slides. These are presentation
CONTENT: importing them as layout geometry will detect decorative shapes, not the
speaker/video layout. background-and-infodecor.pptx has editable title text and
shapes on two slides. composition.pptx deliberately uses a picture of slide 1;
edit the slide deck itself to change its text or chart.
04 — TWO MORE LAYOUTS
02-slide-focus: one 1728 × 972 presentation at (96,54).
03-side-by-side: two 864 × 486 windows at (72,288) and (984,288).
The ready-made project uses Centered (fit inside) for the portrait speaker.
Try intentional cropping in the 16:9 side-by-side window; do not stretch it. These are additional geometry examples,
not alternate full decorated composites.
Each layout folder includes ready-to-align.pilot.json, with no device links.
The first project embeds the composite reference with transparent layer fills.
The other projects retain the same reference hidden, ready for comparison.
05 — FAKE MEDIA FOR YOUR SWITCHER / VIDEO EDITOR
media/speaker: synthetic fictional speaker PNG (3:4).
media/slides: 3 matching 16:9 SVG/PNG/JPG slides.
media/video: 10-second silent speaker pan/zoom, 15-second silent slide loop,
a 10-second static background hold, and a 15-second combined program preview.
Speaker motion is simulated from a still;
it is not an animated talking person. Canvas Pilot itself uses still references;
play MP4 files in your switcher/media software or recording editor.
MAIN GEOMETRY (TOP-LEFT ORIGIN, PIXELS)
Speaker: X 72, Y 260, W 432, H 576 (3:4)
Presentation: X 552, Y 260, W 1296, H 729 (16:9)
SUGGESTED RECORDING: show final composite → start with JPG-only handoff → manually
align two boxes → undo/reset → import native layout → compare exact coordinates →
open PPTX and change a title → show slide-focus and side-by-side → crop portrait.
Do not connect or send to a device unless separately authorized.
PROVENANCE / REBUILD
sources/provenance.json and speaker-generation-prompt.txt describe generated media.
The original layout, typography and charts are code-native. No artwork from the
reference screenshot is reused. scripts/prepare-conference-showcase.py in the repo
rebuilds the kit from the speaker PNG; it refuses to overwrite an existing folder.
Fonts: DejaVu Sans. verification/video-metadata.json records encoded video checks.
The prepared kit also includes independently rendered LibreOffice PDFs and import
checks under verification; these additional checks are not run by the generator.
'''
if __name__=='__main__':
main()

View File

@ -0,0 +1 @@
Create a photorealistic fictional conference speaker source image for a presentation-switcher demo. Portrait composition 3:4. A fictional woman around 40 with short dark curly hair, natural expression, dark navy unbranded blazer over a cream shirt, wearing a small headset microphone, speaking thoughtfully with one hand raised at chest height. Frame head through mid torso, full hair and hand in frame with generous margin so the portrait crops cleanly into a 3:4 video window. She stands on an elegant deep midnight-blue conference stage with subtle out-of-focus teal lights, professional flattering warm key light, restrained documentary event photography, natural skin texture. No text, no logos, no watermark, no slides, no frame, no collage. This is synthetic demo media, not a real public figure. High-quality realistic photograph.

View File

@ -0,0 +1,78 @@
"""Portable native documents and safe generation for the offline conference kit."""
import csv
import importlib.util
import json
from pathlib import Path
import struct
import subprocess
import sys
import tempfile
import unittest
import xml.etree.ElementTree as ET
import zipfile
import zlib
ROOT = Path(__file__).resolve().parents[1]
SCRIPT = ROOT / 'scripts/prepare-conference-showcase.py'
spec = importlib.util.spec_from_file_location('conference_showcase', SCRIPT)
kit = importlib.util.module_from_spec(spec)
spec.loader.exec_module(kit)
def portrait_png():
def chunk(kind, data):
return struct.pack('>I', len(data)) + kind + data + struct.pack('>I', zlib.crc32(kind + data))
return (b'\x89PNG\r\n\x1a\n' + chunk(b'IHDR', struct.pack('>IIBBBBB', 3, 4, 8, 2, 0, 0, 0))
+ chunk(b'IDAT', zlib.compress((b'\x00' + b'\xff' * 9) * 4)) + chunk(b'IEND', b''))
class ConferenceShowcaseTests(unittest.TestCase):
def test_native_slide_deck_has_editable_text_and_portable_relationships(self):
with tempfile.TemporaryDirectory() as directory:
path = Path(directory) / 'slides.pptx'
kit.pptx(kit.slides(), path)
with zipfile.ZipFile(path) as archive:
self.assertIsNone(archive.testzip())
# LibreOffice rejected prefixed OPC roots although the app importer accepted them.
for name, tag in [('[Content_Types].xml', 'Types'), ('ppt/_rels/presentation.xml.rels', 'Relationships')]:
self.assertIn(f'<{tag} xmlns='.encode(), archive.read(name))
for number in range(1, 4):
slide = ET.fromstring(archive.read(f'ppt/slides/slide{number}.xml'))
texts = slide.findall(f'.//{{{kit.A}}}t')
self.assertGreaterEqual(len(texts), 10)
self.assertFalse(slide.findall(f'.//{{{kit.P}}}pic'))
self.assertIn(b'From signals', archive.read('ppt/slides/slide1.xml'))
def test_geometry_csv_contract_and_projects_have_no_device_targets(self):
with tempfile.TemporaryDirectory() as directory:
out = Path(directory)
kit.save(out/'media/speaker/alex-morgan-synthetic.png', portrait_png())
kit.save(out/'delivery-jpg-only/program-example.png', portrait_png())
for name, boxes in kit.LAYOUTS.items():
kit.geometry_files(out, name, boxes)
folder = out/'layouts'/name
with (folder/'layout.csv').open(newline='') as source:
rows = list(csv.DictReader(source))
self.assertEqual(len(rows), len(boxes))
self.assertTrue(all(row['midra_geometry_version'] == '1' and row['canvas_width'] == '1920' for row in rows))
self.assertEqual([row['name'] for row in rows], [box[0] for box in boxes])
project = json.loads((folder/'ready-to-align.pilot.json').read_text())
self.assertFalse(project['input_proposals'])
self.assertTrue(all(layer['device_link'] is None for layer in project['layers']))
self.assertTrue(all(source['source_format'] == 'custom' for source in project['inputs']))
for layer in project['layers']:
if layer['name'] == 'Speaker':
self.assertEqual(layer['layer_fit'], 'centered')
def test_existing_output_is_preserved_and_non_portrait_input_rejected(self):
with tempfile.TemporaryDirectory() as directory:
out = Path(directory)
marker = out/'keep.txt'; marker.write_text('original')
result = subprocess.run([sys.executable, str(SCRIPT), '--speaker', str(out/'missing.png'), '--output', str(out)], capture_output=True, text=True)
self.assertNotEqual(result.returncode, 0)
self.assertIn('Refusing to replace', result.stderr)
self.assertEqual(marker.read_text(), 'original')
bad = out/'square.png'
bad.write_bytes(b'\x89PNG\r\n\x1a\n' + b'\x00'*8 + struct.pack('>II', 4, 4))
with self.assertRaisesRegex(ValueError, '3:4'):
kit.png_dimensions(bad)