ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

OfficeCLI 带状过渡动画全指南:blinds / checker / comb / bars / strips / split 参数矩阵与别名规范化

OfficeCLI 带状过渡动画全指南:blinds / checker / comb / bars / strips / split 参数矩阵与别名规范化 CLIAI 应用MCP 服务【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址https://gitcode.com/GitHub_Trending/of/OfficeCLI点击查看免费下载本篇技术指南以仓库内 transitions-bands.md 为骨架系统讲解 OfficeCLI 中带状/条纹系幻灯片过渡动画Band/Strip Transitions的完整用法。你会掌握blinds、checker、comb、bars、strips、split六类过渡 token 的方向/进出修饰符写法、别名alias输入与规范化回读规则以及通过 CLI 脚本与 Python SDK 两种方式生成 21 页演示文档的完整流程并能在源码层面理解其 OOXML 读写与规范化canonicalize机制。三件套文件与文档定位该演示由三个文件协同工作存放于 examples/ppt/transitions/ 目录transitions-bands.sh— Shell 脚本生成一张 21 页幻灯片覆盖全部带状/条纹方向orientation与进出in/out组合并演示别名写法transitions-bands.pptx— 脚本生成的 21 页演示文稿transitions-bands.md— 本文档对应的说明文件记录方向、角落方向、以及 split 的 orient × in/out 矩阵。整个带状家族共覆盖 20 种正式 token 组合另有 4 个别名 token 用于演示全部围绕幻灯片以平行带、棋盘格或斜向条纹方式揭示新页面这一视觉机制展开。重新生成演示文档进入示例目录并执行脚本即可重新生成生成物为transitions-bands.pptxcd examples/ppt/transitions bash transitions-bands.sh # → transitions-bands.pptx脚本内部流程见 transitions-bands.sh先用officecli create创建文件、officecli open打开写入会话随后通过add_demo_slide函数批量追加幻灯片与形状最后officecli close落盘并officecli validate校验。注意脚本刻意不启用set -e与 SDK 版的doc.batch一样它会容忍向前兼容的UNSUPPORTED props警告officecli 退出码 2继续把整份文档构建完成而不是中途失败。Slide 1 — 封面无过渡封面用深蓝底1F3864铺满全屏加上居中的白色大标题officecli add transitions-bands.pptx / --type slide officecli add transitions-bands.pptx /slide[1] --type shape \ --prop x0 --prop y0 --prop width33.87cm --prop height19.05cm \ --prop fill1F3864 officecli add transitions-bands.pptx /slide[1] --type shape \ --prop textBand Transitions --prop size40 --prop boldtrue \ --prop colorFFFFFF --prop aligncenter \ --prop x2cm --prop y7cm --prop width29.87cm --prop height4cm这里展示了 OfficeCLI 添加幻灯片与形状的两个核心动作add file / --type slide在文档根追加一张幻灯片add file /slide[1] --type shape --prop ...向指定幻灯片追加形状背景矩形与文本框均由 shape 承担坐标单位支持cm后缀。Slides 2–9 — 方向修饰符-horizontal/-vertical这 8 页依次演示blinds、checker、comb、bars四个 token 在水平与垂直两种方向下的效果for combo in blinds-horizontal blinds-vertical \ checker-horizontal checker-vertical \ comb-horizontal comb-vertical \ bars-horizontal bars-vertical; do officecli add transitions-bands.pptx / --type slide officecli add transitions-bands.pptx /slide[N] --type shape \ --prop x0 --prop y0 --prop width33.87cm --prop height19.05cm \ --prop fill2E5C8A officecli add transitions-bands.pptx /slide[N] --type shape \ --prop text$combo --prop size40 --prop boldtrue \ --prop colorFFFFFF --prop aligncenter \ --prop x2cm --prop y7cm --prop width29.87cm --prop height4cm officecli set transitions-bands.pptx /slide[N] --prop transition$combo done关键语义默认方向是horizontal而当你显式写出-horizontal时回读会保留显式形式即transitionblinds-horizontal读回仍是blinds-horizontal不会塌缩成裸blinds。对应可写 token 完整清单transitionblinds-horizontal、blinds-verticaltransitionchecker-horizontal、checker-verticaltransitioncomb-horizontal、comb-verticaltransitionbars-horizontal、bars-verticalSlides 10–13 — 条纹的角落方向-leftup / -rightup / -leftdown / -rightdownstrips系列通过指定角落实现斜向条纹揭示效果for d in leftup rightup leftdown rightdown; do officecli set transitions-bands.pptx /slide[N] --prop transitionstrips-$d done对应可写 tokenstrips-leftup、strips-rightup、strips-leftdown、strips-rightdown。需要留意源码层面的默认值从 PowerPointHandler.Animations.cs 可以看到strips的解析器ParseCornerDir(direction ?? rd)将缺省方向定为rdrightdown因此在 ReadTransitionDirection 的回读逻辑中strips-rightdown被视为默认形态并塌缩为裸strips而leftup / rightup / leftdown则原样保留后缀。Slides 14–17 — Split 的 orient × in/out 矩阵split要求同时指定方向与进出两个修饰符缺一不可构成 2×2 矩阵for orient in horizontal vertical; do for io in in out; do officecli set transitions-bands.pptx /slide[N] --prop transitionsplit-$orient-$io done done对应 tokensplit-horizontal-in、split-horizontal-out、split-vertical-in、split-vertical-out。split的缺省与回读规则最特殊文档原文与本仓库源码均给出明确说明split-vertical只给了方向、没给 in/out会默认dirin回读结果为split-vertical-in裸split回读仍是裸split。这一行为在源码中有细致注释PowerPointHandler.Animations.cs裸transitionsplit会写出p:split orienthorz/无dir属性与split-horizontal-in的p:split orienthorz dirin/形成不同的 XML 签名以便回读时区分两者。在 ReadTransitionDirection 中只有当 XML 同时携带 orient 与 dir 两个属性时才拼出orient-in/out形式只有 orient无 dir则回读为裸split。因此显式写出完整形式才能原样回读是split家族的硬性规则。Slides 18–21 — 别名Alias演示这 4 页证明别名 token 与对应的规范 token 生成完全相同的 OOXML区别只在输入拼写officecli set transitions-bands.pptx /slide[18] --prop transitionvenetian-vertical # → canonical readback: blinds-vertical officecli set transitions-bands.pptx /slide[19] --prop transitioncheckerboard-vertical # → canonical readback: checker-vertical officecli set transitions-bands.pptx /slide[20] --prop transitionrandombar-vertical # → canonical readback: bars-vertical officecli set transitions-bands.pptx /slide[21] --prop transitiondiagonal-leftdown # → canonical readback: strips-leftdown别名映射关系输入别名规范回读venetianblindscheckerboardcheckerrandombarbarsdiagonalstrips源码证实了这一输入别名、回读规范化alias in, canonicalize on readback的设计在写入侧解析时PowerPointHandler.Animations.csblinds or venetian、checker or checkerboard、bars or randombar、strips or diagonal均被映射到同一个强类型过渡对象BlindsTransition、CheckerTransition、RandomBarTransition、StripsTransition因此产物 XML 完全一致在回读侧OOXML 中实际写入的是p:blinds、p:checker、p:randombar、p:strips等规范元素名ReadSlideTransition 中randombar bars等映射进一步保证回读 token 落在规范形式上。此外transition.json 的枚举值清单同时收录了别名与规范名blinds、venetian、checker、checkerboard、comb、bars、randombar、strips、diagonal说明两者均为合法输入。完整功能覆盖矩阵Token 家族方向/进出修饰符合计blinds、checker、comb、bars-horizontal/-vertical8strips-leftup、-rightup、-leftdown、-rightdown4split-horizontal-in/out、-vertical-in/out4别名venetian、checkerboard、randombar、diagonal4 个演示进阶transition 值的组合式速记语法transition属性本身接受TYPE[-DIR][-SPEED|DUR]的组合式速记见 transition.json例如push-right-1500方向 1500ms 时长、fade-slow速度修饰。方向 token 的识别是封闭集合PowerPointHandler.Animations.cs覆盖horizontal/vertical含h/v、horiz/vert缩写、四个角落方向含upleft、upright等变体、in/out等不在集合内的修饰符会直接报错而非被静默丢弃避免用户写错后缀却收到成功提示的误导。同时circle、diamond、plus、wedge等无方向过渡类型如果被附上方向后缀解析器也会显式拒绝PowerPointHandler.Animations.cs提示改用裸 token。速度与时长属于只读属性transitionSpeed、transitionDuration只能通过上述组合速记间接写入。用 Python SDK 生成等价文档除 Shell 脚本外仓库还提供 SDK 双胞胎 transitions-bands.py它驱动officecli Python SDKpip install officecli-sdk需 PATH 上同时存在officecli二进制只启动一个常驻进程将每一页幻灯片、形状与过渡统一放进一次doc.batch(...)往返中经由命名管道投递。每个条目都是与officecli batch列表相同的{command, parent/path, type, props}字典with officecli.create(FILE, --force) as doc: doc.batch(items) # items 内含 add slide / add shape / set transition 三类指令add_demo_slide辅助函数把背景矩形 居中标题 过渡封装为一次调用生成顺序与 Shell 版完全一致封面 → 8 个方向组合 → 4 个角落条纹 → 4 个 split 组合 → 4 个别名页最终输出等效的transitions-bands.pptx。检查生成结果用 OfficeCLI 的查询/读取命令即可验证每一页的过渡设置officecli query transitions-bands.pptx slide officecli get transitions-bands.pptx /slide[2] officecli get transitions-bands.pptx /slide[14] officecli get transitions-bands.pptx /slide[18]/slide[2]应回读transitionblinds-horizontal/slide[14]应回读transitionsplit-horizontal-in矩阵第一项/slide[18]应回读transitionblinds-verticalvenetian-vertical的规范化结果。这也正是显式形式原样回读、别名塌缩到规范形式两条规则的直接验证入口。相关文档transitions-shapes.md — circle/diamond/wheel 等非带状几何族过渡含无方向 token 拒绝后缀、wheel 辐条数等规则transitions-directional.md — push/cover/wipe 等卡片方向过渡transition.json — 过渡属性的完整 schema枚举值、读写属性、速记语法说明赞分享CLIAI 应用MCP 服务【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址https://gitcode.com/GitHub_Trending/of/OfficeCLI点击查看免费下载相关推荐OfficeCLI 带形过渡Band Transitions实战指南blinds / checker / comb / bars / strips / split 全矩阵解析OfficeCLI 带形过渡Band Transitions实战指南blinds / checker / comb / bars / strips / s人工智能AI 应用AI 技能CLIMCP 服务OfficeCLI 方向性 PPT 过渡完整实战push / wipe / cover / uncover 家族与方向矩阵详解OfficeCLI 方向性 PPT 过渡完整实战push / wipe / cover / uncover 家族与方向矩阵详解 本篇技术指南围绕 Office人工智能AI 应用AI 技能CLIMCP 服务终极Primer CSS过渡动画指南打造流畅页面切换与状态变化效果终极Primer CSS过渡动画指南打造流畅页面切换与状态变化效果 Primer CSS是GitHub的设计系统提供了丰富的CSS实现方案其中过渡动画模块前端设计系统UI组件上一篇深度解析LangChain4j中Milvus查询精度丢失的5大元凶与解决方案下一篇django CMS多语言开发完整指南如何轻松搭建10种语言站点创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表