Appearance
super-tools-lib - v1.74.0 / Modules / file
Module: file
Table of contents
Functions
- addTextToImage
- base64ToFile
- blobToDataURL
- dowDxfFile
- downBlob
- drawAndShareImage
- fileDownload
- getFileBase64
- loadImages
- watermark
Functions
addTextToImage
▸ addTextToImage(url
, text
, textStyle
, cb?
): Promise
<unknown
>
给图片添加文字
Since
1.66.0
Example
ts
import { addTextToImage } from 'super-tools-lib'
addTextToImage('https://www.baidu.com/img/bd_logo1.png', '百度一下你就知道', ({ x, y }) => {
return { x, y: y + 100 }
}).then(res => {
console.log(res)
})
Parameters
Name | Type | Description |
---|---|---|
url | any | 图片地址 |
text | any | 文字内容 |
textStyle | CanvasRenderingContext2D | 文字样式,参考https://developer.mozilla.org/zh-CN/docs/Web/API/CanvasRenderingContext2D |
cb? | (__namedParameters : { x : number ; y : number }) => { x : number ; y : number } | 回调函数,返回文字的坐标 |
Returns
Promise
<unknown
>
- 返回一个Promise对象,resolve后返回一个base64的图片地址
base64ToFile
▸ base64ToFile(urlData
, fileName
): File
base64转文件
Since
1.0.0
Example
ts
import { base64ToFile } from 'super-tools-lib'
base64ToFile('base64', 'name')
Parameters
Name | Type | Description |
---|---|---|
urlData | string | base64 |
fileName | string | 文件名 |
Returns
File
返回转换后的文件
blobToDataURL
▸ blobToDataURL(blob
, callback
): void
blob转url
Since
1.0.0
Example
ts
import { blobToDataURL } from 'super-tools-lib'
// blobToDataURL('blob', (url) => {})
Parameters
Name | Type | Description |
---|---|---|
blob | Blob | blob |
callback | (result : string | ArrayBuffer ) => void | 回调 |
Returns
void
dowDxfFile
▸ dowDxfFile(data
, fileName
): void
下载dxf文件
Since
1.0.0
Example
ts
import { dowDxfFile } from 'super-tools-lib'
// dowDxfFile('data', '1.dxf')
See
Parameters
Name | Type | Description |
---|---|---|
data | any | dxf文件内容 |
fileName | string | 下载的文件名 |
Returns
void
downBlob
▸ downBlob(data
, fileName
): void
下载二进制文件流
Since
1.0.0
Example
ts
import { downBlob } from 'super-tools-lib'
// downBlob('data', '1.xslx')
Parameters
Name | Type | Description |
---|---|---|
data | BlobPart | 文件流 |
fileName | string | 下载的文件名 |
Returns
void
drawAndShareImage
▸ drawAndShareImage(bgImgOps
, upImgOps
, ops?
): void
两张图片合并成一张图片
Since
1.0.0
Example
ts
import { drawAndShareImage } from 'super-tools-lib'
// drawAndShareImage({url: url1, width: 1000, height: 1000}, {url: url2, width: 200, height: 20}, {download: true, imgName: '1.png'})
Parameters
Name | Type | Default value | Description |
---|---|---|---|
bgImgOps | Object | undefined | 下层图片配置 |
bgImgOps.height | number | undefined | 图片高度 |
bgImgOps.url | string | undefined | url |
bgImgOps.width | number | undefined | 图片宽度 |
upImgOps | Object | undefined | 上层图片配置 |
upImgOps.height | number | undefined | 图片高度 |
upImgOps.url | string | undefined | url |
upImgOps.width | number | undefined | 图片宽度 |
upImgOps.x | number | undefined | x轴偏移量 |
upImgOps.y | number | undefined | y轴偏移量 |
ops | Object | undefined | 操作配置 |
ops.download | boolean | false | 是否下载 默认false |
ops.imgName | string | '1.png' | 下载的文件名 |
ops.success | (base64 : any ) => any | undefined | 生成成功的回调 |
Returns
void
fileDownload
▸ fileDownload(url
): boolean
根据url地址下载
Since
1.0.0
Example
ts
import { fileDownload } from 'super-tools-lib'
// fileDownload(url)
Parameters
Name | Type | Description |
---|---|---|
url | string | url地址 |
Returns
boolean
返回true
getFileBase64
▸ getFileBase64(file
, cb
): void
将文件Base64编码,
Since
1.0.0
Example
ts
import { getFileBase64 } from 'super-tools-lib'
// getFileBase64(file, (base64) => {})
Parameters
Name | Type | Description |
---|---|---|
file | File | 文件 |
cb | (base64 : string | ArrayBuffer ) => void | 文件转换成功回调 |
Returns
void
loadImages
▸ loadImages(urls
): Promise
<unknown
>
预加载图片
Since
1.66.0
Example
ts
import { loadImages } from 'super-tools-lib'
loadImages([
'https://www.baidu.com/img/bd_logo1.png',
'https://www.baidu.com/img/bd_logo2.png',
'https://www.baidu.com/img/bd_logo3.png',
'https://www.baidu.com/img/bd_logo4.png',
'https://www.baidu.com/img/bd_logo5.png',
'https://www.baidu.com/img/bd_logo6.png',
]).then((imgs) => {
console.log(imgs)
})
Parameters
Name | Type | Description |
---|---|---|
urls | string [] | 图片地址数组 |
Returns
Promise
<unknown
>
- 返回一个Promise对象
watermark
▸ watermark(img
, text
, options?
): string
图片增加水印
Since
1.63.0
Example
ts
import { watermark } from 'super-tools-lib'
watermark('imgUrl', '水印文字', {
fontSize: 20,
color: '#000',
alpha: 0.5,
x: 0,
y: 0,
}).then(res=>{
})
Parameters
Name | Type | Description |
---|---|---|
img | HTMLImageElement | 图片 |
text | string | 水印文字 |
options | any | 水印配置 |
Returns
string
返回添加水印后的图