马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。
您需要 登录 才可以下载或查看,没有账号?站点注册
×
本帖最后由 pbai 于 2026-11-18 06:06 编辑
PBIDEA:用 uo_svg 把 SVG 转成图片全解(画布、背景色、字体图标与特性矩阵,PB10 基准 · PB12.5 实测)
阅读说明
1. 适用版本:基准 PB10,兼容 PB 12.5(PBIDEA 组件 uo_svg 来自 PbIdea.dll,版本源 2026-10-10 导出)
2. 支持数据库:不涉及数据库(纯内存渲染,不连库、不建表)
3. 操作系统与环境要求:Windows 7 及以上;需安装 PBIDEA 运行库(PbIdea.dll 与 Pbidea_cs.dll),并把 websuite.pbl 挂进库列表;渲染依赖系统字体,字体图标用内置图标字体无需外部 ttf
4. 难度系数:★★★☆☆(接口只有 15 个,但「画布」这一层不显式就永远拿到空图)
5. 其它阅读说明:示例为可运行的非可视对象与 pbtest 断言;建议先看过 uo_blob 篇(本文用它的 hex/ReadByte 做图片取证)与 uo_image 篇(位图处理的分工边界)
一、先看它到底解决什么问题
PowerBuilder 画界面用不着 SVG:直接放个图片控件就行。真正需要 uo_svg 的场合是这三类。
第一类,图标要清晰。客户把 logo 给你 SVG,你的报表页眉、按钮图标、PDF 封面都要用它。PB 原生没有矢量渲染能力,把 SVG 丢给图片控件它不认。uo_svg 把它光栅化成 PNG/BMP/JPG,剩下的交给原来的图片控件、DataWindow 图片列、uo_pdfwriter。
第二类,报告与文档要插图。uo_pdfwriter 只吃位图,uo_chart 出的是矢量绘制但嵌不进 Word/Excel 导出件。统一转成 PNG 再插,尺寸由你定,一套代码管所有出口。
第三类,图标字体当图标库用。图标字体(iconfont、FontAwesome 那一类)本质是「码点 → 字形」。uo_svg 的 FromTTF 能把任意码点直接变成 SVG,再转成任意尺寸的 PNG,不需要切图、不需要多套分辨率,颜色和大小都是运行时参数。
要提醒一句边界:uo_svg 是渲染器,不是编辑器。它不做路径布尔运算、不做图像滤镜、不做图层合成;要裁剪、缩放、加水印,那是 uo_image 的活。两者分工很干脆:矢量进、位图出,用 uo_svg;位图进、位图出,用 uo_image。
二、API 全貌
uo_svg 一共 15 个可调用方法(含重载),全部来自 PbIdea.dll 的 svg* 导出函数。
| 方法 | 签名要点 | 说明 | | open | boolean open(string svg) | 吃SVG 文本或 .svg 文件路径,成功 true | | close | subroutine close() | 释放内部句柄,尺寸归零 | | SetAttr | string SetAttr(name, value) | 改属性,返回改后的整段 SVG 文本 | | SetAttr | string SetAttr(svg, name, value) | 对传入的文本改,不动实例 | | svg2image | blob svg2image(imageType) | 用当前画布渲染,画布 0×0 时返回空 | | svg2image | blob svg2image(imageType, clrBack) | 同上,指定背景色 | | svg2image | blob svg2image(width, height, imageType) | 显式尺寸,同时写回画布 | | svg2image | blob svg2image(width, height, imageType, clrBack) | 显式尺寸加背景色 | | Render | boolean Render(width, height) | 只设画布,不改 SVG 固有尺寸 | | Render | boolean Render(hdc, width, height) | 直接画到设备上下文 | | Render | boolean Render(hdc, x, y, width, height) | 画到 HDC 的指定位置 | | width / height | int width() / int height() | SVG 的固有宽高,不是画布 | | FromTTF | boolean FromTTF(ttf, charCode) | 字体文件 + 码点 → SVG;ttf 传空串用内置图标字体 | | FromTTF | boolean FromTTF(ttf, charCode, size) | 指定字号 | | FromTTF | boolean FromTTF(ttf, charCode, size, color, alpha) | 再指定颜色与透明度 |
一句话记住三者的分工:width/height 是「图有多大」,Render 与显式尺寸是「画布多大」,svg2image 是「把画布上的东西吐成字节」。这三层混在一起,就是本文所有坑的源头。
三、最短可用链路
下面这段是能直接跑的最小闭环:给一段 SVG,读出固有尺寸,按指定尺寸转 PNG,落盘。
- //of_quick_png:给一段 SVG 与输出路径,按 2 倍固有尺寸转 PNG 存盘
- //as_svg : SVG 文本(也可传 .svg 文件路径)
- //as_file: 输出文件全路径
- //返回 true 表示文件真的写出来了
- public function boolean of_quick_png (string as_svg, string as_file);
- string ls_svg //入参转存,便于逐段替换测试
- string ls_file //输出文件名
- long ll_size //PNG 字节数,用于判定是否真的出图
- uo_svg sv //渲染器实例
- uo_blob lb //存盘用(uo_blob.SaveFile 支持二进制落盘)
- blob lb_png //渲染结果
- integer li_w //目标宽 = 固有宽 × 2
- integer li_h //目标高 = 固有高 × 2
- boolean lb_ok //存盘结果
- ls_svg = as_svg
- ls_file = as_file
- lb_ok = false
- sv = create uo_svg
- if not sv.open(ls_svg) then
- sv.close()
- destroy sv
- MessageBox('uo_svg', 'open 失败:' + ls_svg)
- return false
- end if
- li_w = sv.width() * 2
- li_h = sv.height() * 2
- lb_png = sv.svg2image(li_w, li_h, 'png')
- ll_size = Len(lb_png)
- sv.close()
- destroy sv
- if ll_size > 0 then
- lb = create uo_blob
- lb.set(lb_png)
- lb_ok = lb.SaveFile(ls_file)
- destroy lb
- end if
- MessageBox('uo_svg', 'PNG 字节数=' + string(ll_size) + ',存盘=' + string(lb_ok) + ',路径=' + ls_file)
- return lb_ok
- end function
复制代码
实机读数(PB12.5 与 PB10 两台都跑过,逐字一致):size=120x60、显式 240×120 得到 2355 字节 PNG,文件头 IHDR 解析出来是 240×120,md5 bf1b302d6e41;两版产出的 PNG md5 完全相同——渲染是确定性的,同一输入同一输出,这一点在做文件比对、缓存、去重时很有用。
四、第一个坑:画布不是尺寸,默认 0×0
这是 uo_svg 唯一的「必踩坑」,也是它最容易让人误判成「这个对象坏了」的地方。
svg2image('png') 这个单参重载,渲染用的不是 SVG 的固有尺寸,而是当前画布。画布的初值是 0×0,所以 open 完直接调单参重载,你拿到的是一个长度为 0 的空 blob,不报错、不抛异常、悄无声息。
| 步骤 | 画布 | 单参 svg2image 返回 | | open 一个 200×100 的 SVG | 0×0 | 0 字节 | | Render(200, 100) | 200×100 | PNG 200×100 | | svg2image(300, 150, 'png') | 300×150 | PNG 300×150 | | 再调 svg2image('png') | 仍 300×150 | PNG 300×150 |
注意最后两行:显式尺寸的重载会把尺寸写回画布,所以后面再调单参重载也是 300×150。而 sv.width() 自始至终都是 200×100,一点没变——画布和固有尺寸是两套数。
实用结论只有一句:要图就直接用 svg2image(宽, 高, 'png'),别用单参重载。单参重载是留给「先 Render 定画布、再反复出图」的场景,比如你要在同一个画布上批量截取多次。
五、svg2image 的四种重载与背景色
imageType 实测支持 png、bmp、jpg,大小写不敏感('JPG' 与 'jpg' 都出 826 字节)。不支持的类型(实测 tiff)与空串,返回的都是空 blob,同样不报错。
第四参 clrBack 是背景色,只对带透明区域的图有意义。它的格式不是 RGB 也不是 #RRGGBB 字符串,而是 Windows COLORREF(0x00BBGGRR),也就是 PB 里 RGB() 函数的返回值格式。像素级取证如下(BMP 不压缩,左下角像素的 B 三个字节可以直接读):
| 传入 clrBack | 期望颜色 | 实测像素(B/G/R) | | 255 | 红 | 0 / 0 / 255 | | 65280 | 绿 | 0 / 255 / 0 | | 16711680 | 蓝 | 255 / 0 / 0 | | 0 | 黑 | 0 / 0 / 0 |
所以写 svg2image(600, 400, 'jpg', RGB(255, 255, 255)) 就是「白底 JPG」,这是导出报告插图最常用的一句。JPG 没有 alpha 通道,不指定背景色时透明区会被填充成黑或白,视渲染器内部默认而定,导出 JPG 一定要显式给背景色。
PNG 也能传 clrBack(实测 50×50 出图 520 字节),但 PNG 自己有 alpha,透明区本来就能保留,除非你就是要压掉透明,否则不必传。
六、Render 的三种用法
Render(宽, 高) 只改画布,不动 SVG 固有尺寸,返回 boolean。实测有三点值得记住:
- Render(200, 100) 后 width() 仍是 200、height() 仍是 100,画的却是 200×100 画布;
- Render(0, 0) 返回 true,但画布回到「SVG 固有尺寸」——之后单参 svg2image 拿到的是 200×100、340 字节。也就是说 0×0 是「复位」而不是「清空」;
- 复位之后再 Render(160, 80) 照样生效,出图 160×80。
带 HDC 的两个重载是给「直接画到窗口或打印机」用的:Render(hdc, 宽, 高) 与 Render(hdc, x, y, 宽, 高)。它们返回的仍是 boolean,成功与否看返回值,不产生 blob。要注意的是这两个重载依赖真实设备上下文,本次实测环境只有 PBVM 非可视进程,HDC 渲染这一路未实测、仅按声明核对;窗口内实测时注意先 GetDC 再 ReleaseDC,别把 DC 泄漏了。
七、SetAttr:返回的是整段文本
SetAttr(名字, 值) 的行为和一般 setter 完全不同,它有两个反直觉的点。
第一,返回值是改完之后的整段 SVG 文本,不是错误码、不是 boolean。想判断有没有改成功,看返回文本里的属性值。
第二,它把文档里所有同名属性统统替换掉,不是只改根节点。实测:一个根上写 width='200'、内部 rect 也写 width='200' 的 SVG,执行 SetAttr('width', '320') 之后返回文本里 width="320" 出现、而 width="200" 一处都不剩;同理 SetAttr('height', '160') 之后 height="100" 也消失了。顺带还有一个细节:返回文本里的属性值用的是双引号,你原稿里写的是单引号——比对字符串时要按双引号比。
第三,非法值会被写进文本,但不生效。SetAttr('width', 'abc') 返回文本里确实出现 width="abc",可 width() 仍然是 320,没有变成 0 也没有报错。所以校验责任在你:改完必须回读 width(),别拿返回文本当成功判据。
三参重载 SetAttr(svg, 名字, 值) 是对传入的临时文本做替换,不改实例状态,适合「同一套样式批量套到多段 SVG」的场景。
八、字体图标:FromTTF 三步
FromTTF 把「字体文件 + 码点」变成一段 SVG,之后照常转图。三个重载分别对应「只要字形」「要字号」「要字号+颜色+透明度」。
- FromTTF('', 61441):ttf 传空串表示用内置图标字体,实测返回 true,画布给到 128×128;
- FromTTF('C:\Windows\Fonts\arial.ttf', 65, 64):码点 65 是字母 A,画布 64×64;
- FromTTF(..., 66, 48, 255, 128):加颜色与 alpha,画布 48×48;
- 字体文件不存在时返回 false(不是 NULL,实测 IsNull 为 false)——这一条很重要,说明你可以直接 if not sv.FromTTF(...) 判失败。
注意 FromTTF 之后同样受画布规则约束:紧接着要 svg2image(64, 64, 'png') 显式给尺寸,用单参重载照样是空图。
内置图标字体的码点表不在本文范围(它跟着 PbIdea.dll 的版本走),但取码点的办法很简单:拿一段 Uncover/字体查看工具读出码点,或者干脆从 61441 起小范围试,能出图就是有字形。
九、特性支持矩阵
把常见 SVG 特性逐个渲染成 100×100 PNG,非空即说明这一版没把渲染搞崩。实测字节数如下(数字越小说明色块越简单、压缩率越高,不代表质量)。
| 特性 | 字节 | 结论 | | rect / circle / ellipse | 222 / 2247 / 1585 | 支持 | | line / polyline / polygon | 343 / 723 / 726 | 支持 | | path(二次与三次曲线) | 2101 / 1516 | 支持 | | text(含 font-size) | 524 | 支持,字形被真正光栅化 | | linearGradient / radialGradient | 331 / 5596 | 支持 | | transform(translate + rotate) | 1268 | 支持 | | style 属性内联样式 | 329 | 支持 | | opacity | 313 | 支持 | | stroke-dasharray | 141 | 支持 | | clipPath | 315 | 支持 | | use + xlink:href | 0(未声明命名空间时)/ 185(声明后) | 支持,但必须声明 xmlns:xlink |
最后一行是个真坑:<use> 引用 <defs> 里的图形,如果根节点只写了 xmlns 而没写 xmlns:xlink,渲染直接返回空 blob,不报错。补上 xmlns:xlink='http://www.w3.org/1999/xlink' 就有图了(185 字节)。而把 xlink:href 写成 SVG2 的纯 href,实测也是空 blob——这一版只认 xlink 写法。
文本是否真的画上去了,别靠肉眼看小图,用字节比对最硬:同尺寸 120×40 的 BMP,空图、ASCII 文本、中文文本、带 font-family 的文本,四张字节长度都是 14454(BMP 定长),但两两比对全不相同(uo_blob 的 compare 返回非 0)。这说明 text 元素确实参与了光栅化,而且中文(用 Char(20013) + Char(25991) 拼出「中文」两个字)与 font-family 都会改变输出。
十、文件模式与编码
open() 除了吃文本,还能吃 .svg 文件路径。实测:把 UTF-8 编码的 svg 文本写盘,open('xxx.svg') 返回 true,读出的尺寸 160×80 与内联方式一致,渲染出的 BMP 像素 0/128/255 也和内联完全一致。中文路径(文件名里带「中文」两个字)同样返回 true。
写盘时用 Blob(ls_svg, EncodingUTF8!) 存成 UTF-8,不要存 GBK——SVG 的标准编码声明是 UTF-8,存 GBK 后里面若有中文文本节点,渲染结果会乱。这一点和本站早前那篇字符串编码篇的结论一致:跨系统交换一律 UTF-8。
十一、生命周期与边界
| 场景 | 实测结果 | | 未 open 直接转图(含显式尺寸) | 0 字节,不崩 | | close 之后再转图 | 0 字节,不崩 | | close 之后读 width/height | 0 / 0 | | 第二次 open | 覆盖前一个,尺寸变成新的(450×450) | | open 之后画布 | 被重置为 0×0(再单参转图得空) | | 宽或高为 0 | 0 字节 | | 宽或高为负数(-50, -20) | 0 字节 | | 1×1 | 正常出 PNG 1×1(70 字节) | | 2000×1000 | 正常,PNG 10062 字节 | | 3000×3000 BMP | 正常,27,000,054 字节(=3000×3000×3+54) |
两个结论。第一,失败一律是「空 blob」,不是异常,所以每次转图后必须 Len() 判一下——这是本文所有断言的基础写法。第二,画布会随 open 重置,别指望「上一张的尺寸留着」,每次 open 之后要重新给尺寸。
还有个内存账要算:BMP 是未压缩的,3000×3000 就是 27MB 一个 blob。批量出图时优先 PNG(同样的 2000×1000 只要 10KB),出完立刻把 blob 引用释放,别堆在数组里。
十二、一个完整的可运行对象
把上面所有要点收进一个非可视对象,三个方法覆盖「转图存盘」「字体图标」「读取与对比」。这是本文实测用的原对象,双轨四绿编译与运行都过。
- //nvo_svg_demo:SVG 转图的最小完整封装(无数据库依赖)
- //思路:open 判失败 -> 显式尺寸转 blob -> Len 判空 -> uo_blob 存盘
- //三个方法都可单独调用,of_report 用于验证画布机制
- public function boolean of_save_png (string as_svg, integer ai_w, integer ai_h, string as_file);
- //把一段 SVG 文本按指定宽高转成 PNG 并存盘
- //as_svg : SVG 文本(也可传 .svg 文件路径)
- //ai_w/ai_h: 目标像素宽高,必须 > 0,否则得到空图
- //as_file : 输出文件全路径
- uo_svg sv
- uo_blob lb
- blob lb_img
- boolean lb_ok
- sv = create uo_svg
- if not sv.open(as_svg) then
- sv.close()
- destroy sv
- return false
- end if
- lb_img = sv.svg2image(ai_w, ai_h, 'png')
- sv.close()
- destroy sv
- if Len(lb_img) <= 0 then return false
- lb = create uo_blob
- lb.set(lb_img)
- lb_ok = lb.SaveFile(as_file)
- destroy lb
- return lb_ok
- end function
- public function boolean of_icon_png (long al_charcode, integer ai_size, string as_file);
- //用内置图标字体把一个码点画成 PNG 图标
- //al_charcode: 图标码点,例如 61441
- //ai_size : 正方形边长(像素)
- //as_file : 输出文件全路径
- uo_svg sv
- uo_blob lb
- blob lb_img
- boolean lb_ok
- sv = create uo_svg
- if not sv.FromTTF('', al_charcode, ai_size) then
- destroy sv
- return false
- end if
- lb_img = sv.svg2image(ai_size, ai_size, 'png')
- sv.close()
- destroy sv
- if Len(lb_img) <= 0 then return false
- lb = create uo_blob
- lb.set(lb_img)
- lb_ok = lb.SaveFile(as_file)
- destroy lb
- return lb_ok
- end function
- public function string of_report (string as_svg);
- //读一段 SVG 的固有尺寸,并把「画布前后」的两次转图结果对比出来
- //as_svg: SVG 文本
- uo_svg sv
- string ls
- sv = create uo_svg
- if not sv.open(as_svg) then
- destroy sv
- return 'open=false'
- end if
- ls = 'size=' + string(sv.width()) + 'x' + string(sv.height())
- ls = ls + '|one_arg_before_render=' + string(Len(sv.svg2image('png')))
- sv.Render(sv.width(), sv.height())
- ls = ls + '|one_arg_after_render=' + string(Len(sv.svg2image('png')))
- ls = ls + '|fixed_64=' + string(Len(sv.svg2image(64, 64, 'png')))
- sv.close()
- destroy sv
- return ls
- end function
复制代码
调用与结果输出:
- //of_demo_all:一次跑通三条分支(转图 / 图标 / 坏输入),最后 MessageBox 汇总
- //依赖同库中的 nvo_svg_demo 与本节 of_quick_png
- subroutine of_demo_all ();
- string ls_svg //一段 120×60 的蓝底黄圆 SVG
- string ls_dir //当前目录,输出文件都放这里
- string ls_report //画布机制读数
- boolean lb_png //转图分支
- boolean lb_icon //字体图标分支
- boolean lb_bad //坏输入分支
- nvo_svg_demo lo //演示对象实例
- ls_svg = "<svg xmlns='http://www.w3.org/2000/svg' width='120' height='60'>" + &
- "<rect width='120' height='60' fill='#336699'/>" + &
- "<circle cx='60' cy='30' r='20' fill='#ffcc00'/></svg>"
- ls_dir = GetCurrentDirectory() + Char(92) //用 Char(92) 拼反斜杠,避免被渲染吃掉
- lo = create nvo_svg_demo
- ls_report = lo.of_report(ls_svg)
- lb_png = lo.of_save_png(ls_svg, 240, 120, ls_dir + "a.png")
- lb_icon = lo.of_icon_png(61441, 48, ls_dir + "b.png")
- lb_bad = lo.of_save_png('no_such_101.svg', 10, 10, ls_dir + "c.png")
- destroy lo
- MessageBox('uo_svg 结果', ls_report + "~r~n转图=" + string(lb_png) + &
- ",图标=" + string(lb_icon) + ",坏输入=" + string(lb_bad))
- end subroutine
复制代码
实机读数:size=120x60|one_arg_before_render=0|one_arg_after_render=1189|fixed_64=969,转图 true、图标 true、坏输入 false。三个布尔值与画布读数讲完了本文的全部机制:单参在 Render 前是 0,Render 后就有了内容;坏输入走 false 而不是异常。
十三、坑清单
- 单参 svg2image 用画布,画布初值 0×0,不 Render 就永远拿到空 blob。
- 显式尺寸的 svg2image 会写回画布,后面单参重载跟着变。
- width()/height() 是固有尺寸,和画布是两套数,别混用。
- open() 会把画布重置成 0×0,每次 open 后都要重新给尺寸。
- open() 失败有三种形态:非法文本、空串、不存在的文件,全部返回 false,尺寸归 0。
- 没有 width/height 的 SVG 不会失败,而是给 450×450 的默认尺寸——想按原图尺寸渲染,源文件里就必须写 width/height 或 viewBox 换算好。
- clrBack 是 COLORREF(0x00BBGGRR),直接用 RGB();写 #FFFFFF 字符串无效。
- 导出 JPG 必须显式给背景色,JPG 没有 alpha。
- imageType 大小写不敏感,但不支持的类型(如 tiff)与空串都是静默空 blob。
- SetAttr 返回整段 SVG 文本,不是错误码;属性值在返回文本里是双引号。
- SetAttr 是全文档同名属性替换,内部图元会被一起改掉,做局部改色别指望它。
- SetAttr 写非法值不报错也不生效,必须回读 width() 验证。
- FromTTF 用内置图标字体时 ttf 传空串;字体文件不存在返回 false,可以 if 判。
- <use> 必须声明 xmlns:xlink 且用 xlink:href,纯 href 与缺命名空间都是空 blob。
- Render(0, 0) 返回 true 但语义是「复位到固有尺寸」,不是「清空」。
- 所有失败都是空 blob,每次转图后必须 Len() 判空,别靠 try-catch。
- 3000×3000 的 BMP 单张就 27MB,批量出图优先 PNG。
十四、PB12.5 差异
与 PB10 行为一致。本文 12 组主探针(15 个方法)与 5 个独立崩溃探针,在 PB10 轨与 PB12.5 轨上读数逐字相同:P1 到 P12 全部字段一字不差,崩溃探针的 no_open / closed / tiff / empty / upper / xlink / href 六项也一字不差。更强的一条证据是产出物:同一段 SVG 在两版渲染出的 PNG md5 完全相同(bf1b302d6e41),说明底层渲染器是同一份实现,不存在版本行为漂移。
唯一的环境差异不在 uo_svg 本身,而在库列表:PB10 轨要挂 UPDATE\10\websuite.pbl,PB12.5 轨要挂 UPDATE\125\websuite.pbl(注意没有 UPDATE\100 目录,PB10 的库就在 UPDATE\10)。挂错版本会在编译期就报类型找不到,而不是运行期。
十五、实测环境与复验方式
- 版本源:PBIDEA 安装目录下的 UPDATE\10\PbIdea.dll,18,318,336 字节,导出函数 2,611 个,md5 前 12 位 25ac290414ab;组件源码导出目录 export_20261010(575 个文件)。版本号会随补丁漂移,判断版本请看 PE 导出表,别只看文件大小或 md5。
- 双轨四绿:导入 0 错 ×2、全量编译 0 错 ×2(PB10 轨与 PB12.5 轨各一次)、断言用例双轨全 PASS 且读数逐字一致、静态检查 0 错 0 提醒 + 编码检查 bad=0。
- 复验手法:本文所有「字节数」类读数都用 uo_blob.hex() 与 ReadByte() 从图片文件头直接解析(PNG 的 IHDR、BMP 的 BITMAPINFOHEADER),不依赖任何第三方库;像素取证读的是 BMP 未压缩数据区的左下角像素。
- 一个实测细节:文中示例以 MessageBox 输出结果,而 PBVM 的非可视进程里 MessageBox 会把进程挂住(实测等到 60 秒超时),所以做机器验证时我把它换成一个同签名的写文件桩函数,其余代码逐字未改——你照抄到窗口里跑是没问题的,别在服务端无人值守脚本里用 MessageBox。
- 未实测项:Render(hdc, ...) 的两个 HDC 重载(需要真实设备上下文,PBVM 非可视进程无法覆盖),已在第六节如实标注。
|