【jpeg_Class 类】使用说明

时间:2022-11-21 00:43:33

jpeg_Class类是针对图片操作类,可以获取图片属性、等比例缩略图片、裁切图片、图片上打印文字及打印水印等功能。

目录

原型 参数 返回 说明
Sub load(byVal path) path [必需 String] 图片路径 - 加载一个本地图片,用于初始化类
Sub loadURL(byVal url) url [必需 String] 远程图片网址 - 加载一个远程图片网址,用于初始化类
Get width() - [Number] 获取图片的宽度
[Obj].width = [Number] [Number] 图片新的宽度值 - 设置图片的宽度
Get height() - - 获取图片的高度
[Obj].height = [Number] [Number] 图片新的高度值 - 设置图片的高度
Get binary() - [Byte()] 获取图片的流数据
Get resolution() -

[Array(1)]

Array(0) X轴分辨率,值0表示未知值

Array(1) Y轴分辨率,值0表示未知值

获取图片分辨率
[Obj].resolution = [Array]

[Array] 图片新的分辨率值

Array(0) X轴分辨率

Array(1) Y轴分辨率

 -  设置图片分辨率
 Sub border(byVal size, byVal color)

 size [必需 Number] 边框宽度值

color [必需 String] 边框颜色,比如: #000000

 -  设置图片边框
 Get getInfo(byVal item)  item [必需 String] 媒体项目名称,详见:http://www.aspjpeg.com/manual_07.html  [String | Empty]  获取图片包含的媒体信息, 详见:http://www.aspjpeg.com/manual_07.html
 Sub sendBinary()  -   发送图片流(可以直接显示图片) 
 Sub thumb(byVal thumbConfig)

 thumbConfig [必需 JSON] 缩略配置详情:

{
  quality : [可选 Number] 压缩图片质量,取值0-100,默认值100
  width : [可选 Number] 图片最大宽度
  height : [可选 Number] 图片最大高度
}'

 -  保持图片比例缩略,使图片在设置的最大宽度或最大高度之间
 Sub crop(byVal cropConfig)

 cropConfig [必需 JSON] 裁切配置详情:

{
  x0 : [必需 Number] 左上角X坐标值,值可以为负值,表示向左扩展画布
  y0 : [必需 Number] 左上角Y坐标值,值可以为负值,表示向上扩展画布
  x1 : [必需 Number] 右下角X坐标值,值可以大于图片宽度,表示向右扩展画布
  y1 : [必需 Number] 右下角Y坐标值,值可以大于图片高度,表示向下扩展画布
  bgColor : [可选 String] 扩展画布时的背景色,格式:#CCCCCC,默认为黑色: #000000
}

 -  裁切图片
 Sub printFont(byVal json_fontConfig)

 json_fontConfig [必需 JSON]打印水印文字配置详情:

{
 text : [必需 String] 打印文字内容
 size : [可选 Number] 打印文字大小,默认值16px
 color : [可选 String] 打印文字颜色,默认值 #000000
 rotation : [可选 Number] 打印文字旋转角度,默认值0,可取值0-360整形数
 shadowColor : [可选 String] 打印文字加阴影,格式:#DDDDDD, 默认值无阴影
 shadowOffsetX : [可选 Number] 打印文字阴影X轴偏移值
 shadowOffsetY : [可选 Number] 打印文字阴影Y轴偏移值
 shadowOpacity : [可选 Number] 阴影透明度,默认是不透明
 bold : [可选 Boolean] 打印文字是否是粗体,默认值:false
 family : [可选 String] 打印文字的字体样式,默认值:微软雅黑。字体要在/Resource/Public/Fonts里定义。
 width : [可选 Number] 文字打印区域的宽度,默认一行显示,不限制宽度
 lineHeight : [可选 Number] 文字行高
 opacity : [可选 Number] 文字透明度,默值不透明
 textAlign : [可选 String] 文本对齐方式,可选值:[left | right | center | justify],默认值left
 align : [可选 String] 文字区域位于画板的对齐方式,可选值:[left | right | center | leftTop | leftCenter | leftBottom | rightTop | rightCenter | rightBottom],默认值leftTop
 left : [可选 Number] 指定文字区域左上角的左侧位置,left会覆盖align设置
 top : [可选 Number] 指定文字区域左上角的顶部位置,top会覆盖align设置
 offsetX : [可选 Number] 指定位置处X轴偏移,正值是往右,负值是往左
 offsetY : [可选 Number] 指定位置处Y轴偏移,正值是往下,负值是往上
}

 -

 在图片上打印文字(支持多次调用此函数,打印多个文字)

注意:

 1. 文字大小为固定的,不能与图片大小等比例显示。

2. 文字换行用 Chr(13) & Chr(10)。

3. 空格支持不是很好,尽量不要加入空格(空格有时会造成换行现象)。

 Sub waterMark(byVal json_config)

 json_config [必需 JSON] 打印水印配置

{
 path : [必需 String] 水印图片路径
 rotate : [可选 Number] 水印图片旋转角度,默认值0
 opacity : [可选 Number] 水印透明度设置,值0-1之间。(对PNG图片无效,PNG图片需要在制作图片时自行设置透明度)
 align : [必需 String] 对齐方式,可选值:[left | right | center | leftTop | leftCenter | leftBottom | rightTop | rightCenter | rightBottom],默认值rightBottom
 offsetX : [可选 Number] 指定位置处X轴偏移,正值是往右,负值是往左,默认值0
 offsetY : [可选 Number] 指定位置处Y轴偏移,正值是往下,负值是往上,默认值0
}

 -

 在图片上打水印

 

 Sub waterMarkCover(byVal json_config)

  json_config [必需 JSON] 打印水印配置

{
 path : [必需 String] 水印图片路径
 rotate : [可选 Number] 水印图片旋转角度,默认值0
 opacity : [可选 Number] 水印透明度设置,值0-1之间。(对PNG图片无效,PNG图片需要在制作图片时自行设置透明度)
 marginLeft : [可选 Number] 指定水印间左侧间距,默认值0
 marginRight : [可选 Number] 指定水印间右侧间距,默认值0
 marginTop : [可选 Number] 指定水印间顶部间距,默认值0
 marginBottom : [可选 Number] 指定水印间底侧间距,默认值0
}

 -  在图片上重复打水印并铺满画布