xl-public-utils 1.0.4 → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.d.ts CHANGED
@@ -1,24 +1,8 @@
1
+ import vtkInteractorStyleManipulator from "@kitware/vtk.js/Interaction/Style/InteractorStyleManipulator";
2
+ import { vec3, mat4, mat3 } from "gl-matrix";
1
3
  import vtkRenderer from "@kitware/vtk.js/Rendering/Core/Renderer";
2
-
3
- /**
4
- * @typedef {Object} QrCodeOptions
5
- * @property {string} [bcid='qrcode'] - 二维码类型,具体支持请查看文档
6
- * @property {number} [width=1056] - 最终图片宽度
7
- * @property {number} [height=342] - 最终图片高度
8
- * @property {number} [qrcodeW=300] - 二维码宽度
9
- * @property {number} [qrcodeH=300] - 二维码高度
10
- * @property {boolean} [addText=true] - 是否在右侧添加文字
11
- * @property {number} [top=10] - 顶部距离
12
- * @property {number} [left=10] - 左侧距离
13
- * @property {number} [lineHeight=1] - 文字行高,换行后下一行文字的y位置计算为fontSize * lineHeight
14
- * @property {number} [fontSize=60] - 文字大小
15
- * @property {string} [fontFamily='黑体'] - 字体类型
16
- * @property {string} [bgColor='#fff'] - 背景颜色
17
- * @property {number} [textLeftMargin=20] - 文字距离二维码间隔
18
- * @property {boolean} [fontWeight=700] - 字体加粗
19
- * @property {string} [textColor='#000'] - 字体颜色
20
- * @property {string} [textContent] - 右侧文字内容
21
- */
4
+ import vtkRenderWindowInteractor from "@kitware/vtk.js/Rendering/Core/RenderWindowInteractor";
5
+ import vtkPolyData from "@kitware/vtk.js/Common/DataModel/PolyData";
22
6
  declare module "xl-public-utils" {
23
7
  export interface QrCodeOptions {
24
8
  /** 二维码类型,具体支持请查看文档 */
@@ -70,7 +54,7 @@ declare module "xl-public-utils" {
70
54
  textContent?: string;
71
55
  }
72
56
 
73
- export namespace vtk {
57
+ export namespace vtkUtils {
74
58
  /**
75
59
  * 计算屏幕坐标到三维坐标
76
60
  * @param {vtkRenderer} renderer vtkRenderer
@@ -85,7 +69,6 @@ declare module "xl-public-utils" {
85
69
  y: number,
86
70
  z: number
87
71
  ): [number, number, number];
88
-
89
72
  /**
90
73
  * 计算三维坐标到屏幕坐标
91
74
  * @param {vtkRenderer} renderer vtkRenderer
@@ -100,15 +83,547 @@ declare module "xl-public-utils" {
100
83
  y: number,
101
84
  z: number
102
85
  ): [number, number, number];
86
+ /**
87
+ * 计算 w2l(word 2 local, word to local) 的变换矩阵
88
+ * @param {vec3} center 中心点
89
+ * @param {vec3} xaxis x轴
90
+ * @param {vec3} yaxis y轴
91
+ * @param {vec3} zaxis z轴
92
+ * @returns { mat4 } 变换矩阵
93
+ */
94
+ export function getW2LMatrix(
95
+ center: vec3,
96
+ xaxis: vec3,
97
+ yaxis: vec3,
98
+ zaxis: vec3
99
+ ): mat4;
100
+ /**
101
+ * 计算 l2w(local 2 word, local to word) 的变换矩阵
102
+ * @param {vec3} center 中心点
103
+ * @param {vec3} xaxis x轴
104
+ * @param {vec3} yaxis y轴
105
+ * @param {vec3} zaxis z轴
106
+ * @returns { mat4 } 变换矩阵
107
+ */
108
+ export function getL2WMatrix(
109
+ center: vec3,
110
+ xaxis: vec3,
111
+ yaxis: vec3,
112
+ zaxis: vec3
113
+ ): mat4;
114
+ /**
115
+ * 返回交互的interactorStyle
116
+ * @returns {vtkInteractorStyleManipulator} 交互的interactorStyle
117
+ */
118
+ export function make3DInteractorStyle(): vtkInteractorStyleManipulator;
119
+ /**
120
+ * 移除并返回当前renderWindow的所有鼠标交互设定
121
+ * @param {vtkRenderWindowInteractor} interactor vtkRenderWindowInteractor
122
+ * @returns {any[]} 当前鼠标的所有交互Manipulators
123
+ */
124
+ export function removeMouseInteraction(
125
+ interactor: vtkRenderWindowInteractor
126
+ ): any[];
127
+ /**
128
+ * 给当前窗口设置交互Maintainers
129
+ * @param {vtkRenderWindowInteractor} interactor vtkRenderWindowInteractor
130
+ * @param {any[]} mm 所有的交互Maintainers
131
+ * @returns {void}
132
+ */
133
+ export function resetAllMouseMaintainers(
134
+ interactor: vtkRenderWindowInteractor,
135
+ mm: any[]
136
+ ): void;
137
+ /**
138
+ * 将点投影到平面上
139
+ * @param {vec3} point 需要投影的点
140
+ * @param {vec3} origin 平面中心点
141
+ * @param {vec3} normal 平面法向量
142
+ * @returns {vec3} 投影到平面之后的点
143
+ */
144
+ export function projectPointToPlane(
145
+ point: vec3,
146
+ origin: vec3,
147
+ normal: vec3
148
+ ): vec3;
149
+ /**
150
+ * 将向量投影到面上
151
+ *
152
+ * @param {vec3} vec - The vector to project.
153
+ * @param {vec3} norm - The normal vector of the plane (assumed to be normalized).
154
+ * @returns {vec3} - The projected vector on the plane.
155
+ */
156
+ export function projectVecToPlane(vec: vec3, norm: vec3): vec3;
157
+ /**
158
+ * 将直线外一点投影到直线(两个点)上
159
+ * @param {vec3} point 直线外一点
160
+ * @param {vec3} begin 直线开始点
161
+ * @param {vec3} end 直线结束点
162
+ * @returns {vec3} 投影后的点
163
+ */
164
+ export function projectPointOnPoints(
165
+ point: vec3,
166
+ begin: vec3,
167
+ end: vec3
168
+ ): vec3;
169
+ /**
170
+ * 将点投影到直线(point+dir)上
171
+ * @param {vec3} point 直线外的点
172
+ * @param {vec3} linePoint 直线任意一点
173
+ * @param {vec3} lineDir 直线方向
174
+ * @returns {vec3} 投影到直线上后的点
175
+ */
176
+ export function projectPointToLine(
177
+ point: vec3,
178
+ linePoint: vec3,
179
+ lineDir: vec3
180
+ ): vec3;
181
+ /**
182
+ * 获取曲线外一点到曲线最近点的索引
183
+ * @param {vec3} point 曲线外一点
184
+ * @param {vec3[]} points 曲线
185
+ * @returns {number} 返回离点最近的曲线点索引
186
+ */
187
+ export function getPointToPointsMinIndex(
188
+ point: vec3,
189
+ points: vec3[]
190
+ ): number;
191
+ /**
192
+ * 获取点到曲线的最近距离
193
+ * @param {vec3} point 曲线外一点
194
+ * @param {vec3[]} points 曲线
195
+ * @returns {number} 返回点到曲线的最近距离
196
+ */
197
+ export function getPointToPointsMinDist(
198
+ point: vec3,
199
+ points: vec3[]
200
+ ): number;
201
+ /**
202
+ * 获取点到曲线的最近点
203
+ * @param {vec3} point 曲线外一点
204
+ * @param {vec3[]} points 曲线
205
+ * @returns {vec3} 返回点到曲线的最近点
206
+ */
207
+ export function getPointToPointsMinPoint(point: vec3, points: vec3[]): vec3;
208
+ /**
209
+ * 获取直线外一点到直线的距离
210
+ * @param {vec3} point 直线外一点
211
+ * @param {vec3} begin 直线开始点
212
+ * @param {vec3} end 直线结束点
213
+ * @returns {number} 点到直线的距离
214
+ */
215
+ export function getPointToLineDist(
216
+ point: vec3,
217
+ begin: vec3,
218
+ end: vec3
219
+ ): number;
220
+ /**
221
+ * 计算点到平面的距离
222
+ * @param {vec3} point 任意一点
223
+ * @param {vec3} origin 平面上一点
224
+ * @param {vec3} normal 平面法向量,要求单位化
225
+ * @returns {number}
226
+ */
227
+ export function getPointToPlaneDist(
228
+ point: vec3,
229
+ origin: vec3,
230
+ normal: vec3
231
+ ): number;
232
+ /**
233
+ * 对一个polydata应用矩阵变化,直接改变点位置
234
+ * @param {mat4} mt4 变换矩阵
235
+ * @param {vtkPolyData} data 需要应用变换的polydata
236
+ */
237
+ export function pointsApplyMat4(mt4: mat4, data: vtkPolyData): void;
238
+ /**
239
+ * 将点应用矩阵变换
240
+ * @param {vec3} point 三维点
241
+ * @param {mat4} matrix 变换矩阵
242
+ * @returns {vec3} 应用矩阵变换之后的点
243
+ */
244
+ export function pointTransformByMat4(point: vec3, matrix: mat4): vec3;
245
+ /**
246
+ * 将向量应用矩阵变换
247
+ * @param {vec3} vec 向量
248
+ * @param {mat4} matrix 变换矩阵
249
+ * @returns {vec3} 应用矩阵变换之后的向量
250
+ */
251
+ export function vecTransfromByMat4(vec: vec3, matrix: mat4): vec3;
252
+ /**
253
+ * 获取mesh的ply文件Blob
254
+ * @param {vtkPolyData} mesh 网格polydata
255
+ * @param {'ascii' | 'binary'} [format='ascii'] format 导出文件格式
256
+ * @returns {Blob} 网格的ply文件Blob
257
+ */
258
+ export function createPlyBlob(
259
+ mesh: vtkPolyData,
260
+ format?: "ascii" | "binary"
261
+ ): Blob;
262
+ /**
263
+ * 获取mesh的stl文件Blob,由于STL文件过大,只使用Binary格式
264
+ * @param {vtkPolyData} mesh 网格polydata
265
+ * @returns {Blob} 网格的BinarySTL文件Blob
266
+ */
267
+ export function createStlBlob(mesh: vtkPolyData): Blob;
268
+ /**
269
+ * 将网格压缩为drc文件,导出drc需要先加载draco_encode.js,并调用initDrcCoder初始化
270
+ * @param {vtkPolyData} mesh 网格文件
271
+ * @returns {Blob} drc文件
272
+ */
273
+ export function createDrcBlob(mesh: vtkPolyData): Blob;
274
+ /**
275
+ * 将网格输出为对应类型的Blob,均采用默认参数,导出drc需要先加载draco_encode.js,并调用initDrcCoder初始化
276
+ * @param {vtkPolyData} mesh 网格文件
277
+ * @param {'ply' | 'stl' | 'drc' } type 输出类型
278
+ * @returns {Blob} 对应类型的Blob
279
+ */
280
+ export function createMeshTypeBlob(
281
+ mesh: vtkPolyData,
282
+ type: "ply" | "stl" | "drc"
283
+ ): Blob;
284
+ /**
285
+ * 计算一组三维点的中心点
286
+ * @param {vec3[]} points 三维点数组
287
+ * @returns {vec3} 中心点
288
+ */
289
+ export function getPointsCenter(points: vec3[]): vec3;
290
+ /**
291
+ * @typedef Position
292
+ * @property {number} x 对应vtk坐标系的x值
293
+ * @property {number} y 对应vtk坐标系的y值
294
+ * @property {number} z 0
295
+ */
296
+ /**
297
+ * 计算js事件对应vtk事件的position
298
+ * @param {HTMLElement} el vtkViewDom
299
+ * @param {MouseEvent} event 二维鼠标事件
300
+ * @returns {Position} 对应vtk坐标系的xyz值
301
+ */
302
+ export function getScreenEventPositionFor(
303
+ el: HTMLElement,
304
+ event: MouseEvent
305
+ ): Position;
306
+ /**
307
+ * 将数值数组转换为vec3数组
308
+ * @param {number[] | Float32Array} dataList
309
+ * @returns {vec3[]} 格式化之后的数组
310
+ */
311
+ export function formatNumberArrayToVec3Array(
312
+ dataList: number[] | Float32Array
313
+ ): vec3[];
314
+ /**
315
+ * 简单的数值平均插值
316
+ * @param {number} from 开始数值
317
+ * @param {number} to 结束数值
318
+ * @param {number} step 步长
319
+ * @returns {number[]} 插值的数值
320
+ */
321
+ export function calculateSimpleLerp(
322
+ from: number,
323
+ to: number,
324
+ step: number
325
+ ): number[];
326
+ /**
327
+ * 将 mat3 解析为 3 个自由度的 欧拉角(Eular)(弧度)
328
+ * @param {mat3} rmat 3 * 3的矩阵
329
+ * @param {[number, number, number]} eular 输出的欧拉角度数(弧度)
330
+ * @returns {[number, number, number]} 3个自由度的欧拉角
331
+ * @example
332
+ * const mt4: mat4;
333
+ * const mt3 = mat3.fromMat4(mt3, mt4);
334
+ * mat3.transpose(mt3, mt3);
335
+ * let eular = [0, 0, 0];
336
+ * convMatrix2EularZYX(mt3, eular);
337
+ */
338
+ export function convMatrix2EularZYX(
339
+ rmat: mat3,
340
+ eular: [number, number, number]
341
+ ): [number, number, number];
342
+ /**
343
+ * 将欧拉角(Eular)转换为mat3
344
+ * @param {mat3} rmat 变换矩阵
345
+ * @param {number} xangle 对应欧拉角x 弧度
346
+ * @param {number} yangle 对应欧拉角y 弧度
347
+ * @param {number} zangle 对应欧拉加z 弧度
348
+ * @returns {mat3} 对应变换矩阵
349
+ * @example
350
+ * const rotateX = 0.5;
351
+ * const rotateY = 0.5;
352
+ * const rotateZ = 0.5;
353
+ * const mt3 = mat3.create();
354
+ * convEular2matrixZYX(mt3, [rotateX, rotateY, rotateZ])
355
+ */
356
+ export function convEular2matrixZYX(
357
+ rmat: mat3,
358
+ xangle: number,
359
+ yangle: number,
360
+ zangle: number
361
+ ): mat3;
362
+ /**
363
+ * 将drc
364
+ * @param {vtkPolyData} mesh 网格polyData
365
+ * @param {mat4} [matrix] 变换矩阵
366
+ * @returns {string} drc压缩之后的网格base64
367
+ */
368
+ export function enCodeMeshToBase64(
369
+ mesh: vtkPolyData,
370
+ matrix?: mat4
371
+ ): string;
372
+ /**
373
+ * 将一圈有序点按指定size进行平滑
374
+ * @param {vec3[]} points 一圈有序点
375
+ * @param {number} smaSize=3 平滑点的数量通常值为奇数
376
+ * @returns {vec3[]} 平滑之后的点
377
+ */
378
+ export function smaPoint(points: vec3[], smaSize?: number): vec3[];
379
+ /**
380
+ * 将一段有序点按指定size进行平滑
381
+ * @param {vec3[]} points 一段有序点
382
+ * @param {number} smaSize=3 平滑点的数量通常值为奇数
383
+ * @returns {vec3[]} 平滑之后的点
384
+ */
385
+ export function smaPointNotRound(points: vec3[], smaSize?: number): vec3[];
386
+ /**
387
+ * 表示一个包含三个轴向的对象
388
+ * @typedef {Object} AxisObject
389
+ * @property {vec3} x - x轴
390
+ * @property {vec3} y - y轴
391
+ * @property {vec3} z - z轴
392
+ */
393
+ /**
394
+ * 获取一个矩阵的三个轴向
395
+ * @param {mat4} matrix 4 * 4 的矩阵
396
+ * @returns {AxisObject} 三个轴向
397
+ */
398
+ export function getAxisFormMat4(matrix: mat4): AxisObject;
399
+ /**
400
+ * 计算 w2l(word 2 local, word to local) 的变换矩阵
401
+ * @param {vec3} center 中心点
402
+ * @param {vec3} xaxis x轴
403
+ * @param {vec3} yaxis y轴
404
+ * @param {vec3} zaxis z轴
405
+ * @returns { mat4 } 变换矩阵
406
+ */
407
+ export function getmatw2l(
408
+ center: vec3,
409
+ xaxis: vec3,
410
+ yaxis: vec3,
411
+ zaxis: vec3
412
+ ): mat4;
413
+ /**
414
+ * 计算 l2w(local 2 word, local to word) 的变换矩阵
415
+ * @param {vec3} center 中心点
416
+ * @param {vec3} xaxis x轴
417
+ * @param {vec3} yaxis y轴
418
+ * @param {vec3} zaxis z轴
419
+ * @returns { mat4 } 变换矩阵
420
+ */
421
+ export function getmatofl2w(
422
+ center: vec3,
423
+ xaxis: vec3,
424
+ yaxis: vec3,
425
+ zaxis: vec3
426
+ ): mat4;
427
+ export function deduplicatePolyData(data: vtkPolyData): vtkPolyData;
428
+ export type Position = {
429
+ /**
430
+ * 对应vtk坐标系的x值
431
+ */
432
+ x: number;
433
+ /**
434
+ * 对应vtk坐标系的y值
435
+ */
436
+ y: number;
437
+ /**
438
+ * 0
439
+ */
440
+ z: number;
441
+ };
442
+ /**
443
+ * 表示一个包含三个轴向的对象
444
+ */
445
+ export type AxisObject = {
446
+ /**
447
+ * - x轴
448
+ */
449
+ x: vec3;
450
+ /**
451
+ * - y轴
452
+ */
453
+ y: vec3;
454
+ /**
455
+ * - z轴
456
+ */
457
+ z: vec3;
458
+ };
459
+ }
460
+ export namespace drcUtils {
461
+
462
+ export type AttrOption = {
463
+ /**
464
+ * 颜色数组
465
+ */
466
+ colors?: number[];
467
+ /**
468
+ * 属性数组
469
+ */
470
+ generics?: number[];
471
+ /**
472
+ * 法向量数组
473
+ */
474
+ normals?: number[];
475
+ };
476
+ export type DrcMeshData = {
477
+ /**
478
+ * 网格面数组
479
+ */
480
+ faces: Uint32Array;
481
+ /**
482
+ * 网格点数组
483
+ */
484
+ vertices: Float32Array;
485
+ /**
486
+ * 颜色数组
487
+ */
488
+ colors?: Float32Array;
489
+ /**
490
+ * 属性数组
491
+ */
492
+ generics?: Float32Array;
493
+ /**
494
+ * 法向量数组
495
+ */
496
+ normals?: Float32Array;
497
+ };
498
+ export type Decoder = any;
499
+ export type Mesh = {
500
+ /**
501
+ * 点信息
502
+ */
503
+ vertices: number[][];
504
+ /**
505
+ * 面信息
506
+ */
507
+ faces: number[][];
508
+ };
509
+ /**
510
+ * @typedef {Object} AttrOption
511
+ * @property {number[]} [colors] 颜色数组
512
+ * @property {number[]} [generics] 属性数组
513
+ * @property {number[]} [normals] 法向量数组
514
+ */
515
+ /**
516
+ * 将数据进行压缩
517
+ * @param {number[]} vertices 网格点
518
+ * @param {number[]} faces 网格面,必须是三角化之后的面,每连续的三个点索引标识一个面
519
+ * @param {number} byteLength=14 byteLength 压缩率
520
+ * @param {AttrOption} [attr] 其他需要压缩的属性
521
+ * @returns {Int8Array} 压缩之后的DRC数据
522
+ */
523
+ export function enCodeMeshByVF(
524
+ vertices: number[],
525
+ faces: number[],
526
+ byteLength?: number,
527
+ attr?: AttrOption
528
+ ): Int8Array;
529
+ /**
530
+ * 使用drc压缩点
531
+ * @param {vec3[] | number[]} points 点数组
532
+ * @returns {Int8Array} 压缩之后的drc data
533
+ */
534
+ export function enCodePointCloud(points: vec3[] | number[]): Int8Array;
535
+ /**
536
+ * 解压drc格式的点云数据
537
+ * @param {ArrayBuffer} byteArray drc点数据
538
+ * @returns {Float32Array} 点数组
539
+ */
540
+ export function decodePointCloud(byteArray: ArrayBuffer): Float32Array;
541
+ /**
542
+ * @typedef {Object} DrcMeshData
543
+ * @property {Uint32Array} faces 网格面数组
544
+ * @property {Float32Array} vertices 网格点数组
545
+ * @property {Float32Array} [colors] 颜色数组
546
+ * @property {Float32Array} [generics] 属性数组
547
+ * @property {Float32Array} [normals] 法向量数组
548
+ */
549
+ /**
550
+ * 解压drc格式的网格数据
551
+ * @param {ArrayBuffer} byteArray drc网格数据
552
+ * @returns {DrcMeshData} 网格数据
553
+ */
554
+ export function decodeDrcBufferArray(byteArray: ArrayBuffer): DrcMeshData;
555
+ /**
556
+ * @typedef {Object} Decoder
557
+ */
558
+ /**
559
+ * 输入一个Drc数据,反会对应的解压器
560
+ * @param {ArrayBuffer} arrayBuffer 输入的数据
561
+ * @returns {Decoder} drc解压类
562
+ */
563
+ export function decodeBuffer(arrayBuffer: ArrayBuffer): Decoder;
564
+ /**
565
+ * 获取decoder中的属性
566
+ * @param {Decoder} dracoGeometry DRC Decoder
567
+ * @param {number} attributeId 需要获取的属性id
568
+ * @returns {Float32Array} 对应decoder中的属性
569
+ */
570
+ export function getDracoAttributeAsFloat32Array(
571
+ dracoGeometry: Decoder,
572
+ attributeId: number
573
+ ): Float32Array;
574
+ /**
575
+ * 将点数据使用drc压缩处理为 base64 string
576
+ * @param {vec3[] | number[]} points 点数据
577
+ * @returns {string} drc压缩之后的base64数据
578
+ */
579
+ export function enCloudPointTobase64(points: vec3[] | number[]): string;
580
+ /**
581
+ * @typedef {Object} Mesh
582
+ * @property {number[][]} vertices 点信息
583
+ * @property {number[][]} faces 面信息
584
+ */
585
+ /**
586
+ * 使用drc压缩网格信息
587
+ * @param {Mesh | vtkPolyData} mesh
588
+ * @param {number} byteLength=14 压缩率
589
+ * @param {AttrOption} [attr] 其他需要压缩的属性
590
+ * @returns {Int8Array} 压缩之后的DRC数据
591
+ */
592
+ export function enCodeMesh(
593
+ mesh: Mesh | vtkPolyData,
594
+ byteLength?: number,
595
+ attr?: AttrOption
596
+ ): Int8Array;
597
+ /**
598
+ * 初始化Draco文件
599
+ */
600
+ export function initDrcCoder(): void;
103
601
  }
104
602
 
105
- export namespace public {
603
+ export namespace utils {
106
604
  /**
107
605
  * 获取当前屏幕分辨率(百分制,默认100)
108
606
  * @returns {number} 当前屏幕分辨率
109
607
  */
110
608
  export function getRatio(): number;
111
-
609
+ /**
610
+ * 将Base64转换为ArrayBuffer
611
+ * @param {string} base64String
612
+ * @returns {ArrayBuffer} base64的ArrayBuffer
613
+ */
614
+ export function base64ToArrayBuffer(base64String: string): ArrayBuffer;
615
+ /**
616
+ * 将Int8Array转换为Base64格式的字符串
617
+ * @param {Int8Array} int8
618
+ * @returns {string} base64格式的字符串
619
+ */
620
+ export function int8ArrayToBase64(int8: Int8Array): string;
621
+ /**
622
+ * 将ArrayBuffer转换为Base64格式的字符串
623
+ * @param {ArrayBuffer} outputBuffer
624
+ * @returns {string} base64格式的字符串
625
+ */
626
+ export function arrayBufferToBase64(outputBuffer: ArrayBuffer): string;
112
627
  /**
113
628
  * 获取当前屏幕分辨率(百分制,默认100)
114
629
  * @returns {number} 当前屏幕分辨率
@@ -217,87 +732,170 @@ declare module "xl-public-utils" {
217
732
  setopts?(options: RenderOptions): void;
218
733
  scale(sx: number, sy: number): [number, number] | null;
219
734
  measure(
220
- str: string,
221
- font: string,
222
- fwidth: number,
223
- fheight: number,
735
+ str: string,
736
+ font: string,
737
+ fwidth: number,
738
+ fheight: number
224
739
  ): { width: number; ascent: number; descent: number };
225
740
  init(width: number, height: number): void;
226
- line(x0: number, y0: number, x1: number, y1: number, lw: number, rgb: string): void;
741
+ line(
742
+ x0: number,
743
+ y0: number,
744
+ x1: number,
745
+ y1: number,
746
+ lw: number,
747
+ rgb: string
748
+ ): void;
227
749
  polygon(pts: Array<[number, number]>): void;
228
- hexagon(pts: [[number, number], [number, number], [number, number], [number, number], [number, number]]): void;
750
+ hexagon(
751
+ pts: [
752
+ [number, number],
753
+ [number, number],
754
+ [number, number],
755
+ [number, number],
756
+ [number, number]
757
+ ]
758
+ ): void;
229
759
  ellipse(x: number, y: number, rx: number, ry: number, ccw: boolean): void;
230
760
  fill(rgb: string): void;
231
- text(x: number, y: number, str: string, rgb: string, font: { name: string; width: number; height: number; dx: number },): void;
761
+ text(
762
+ x: number,
763
+ y: number,
764
+ str: string,
765
+ rgb: string,
766
+ font: { name: string; width: number; height: number; dx: number }
767
+ ): void;
232
768
  end(): T;
233
769
  }
234
-
235
- export function render<T>(params: RenderOptions, drawing: DrawingContext<T>): T;
770
+
771
+ export function toSVG(opts: RenderOptions): string;
772
+ export function drawingSVG(): DrawingContext<string>;
773
+
774
+ // platform-specific exports
775
+ export function toCanvas(
776
+ canvas: string | HTMLCanvasElement,
777
+ opts: RenderOptions
778
+ ): HTMLCanvasElement;
779
+ export function drawingCanvas(
780
+ canvas: string | HTMLCanvasElement
781
+ ): DrawingContext<HTMLCanvasElement>;
782
+
783
+ export function datamatrix(
784
+ canvas: string | HTMLCanvasElement,
785
+ opts: RenderOptions
786
+ ): HTMLCanvasElement;
787
+ export function datamatrix<T>(
788
+ opts: RenderOptions,
789
+ drawing: DrawingContext<Promise<T>>
790
+ ): Promise<T>;
791
+ export function datamatrix<T>(
792
+ opts: RenderOptions,
793
+ drawing: DrawingContext<T>
794
+ ): T;
795
+
796
+ export function qrcode(
797
+ canvas: string | HTMLCanvasElement,
798
+ opts: RenderOptions
799
+ ): HTMLCanvasElement;
800
+ export function qrcode<T>(
801
+ opts: RenderOptions,
802
+ drawing: DrawingContext<Promise<T>>
803
+ ): Promise<T>;
804
+ export function qrcode<T>(
805
+ opts: RenderOptions,
806
+ drawing: DrawingContext<T>
807
+ ): T;
808
+ export function render<T>(
809
+ params: RenderOptions,
810
+ drawing: DrawingContext<T>
811
+ ): T;
236
812
  export function raw(
237
813
  bcid: string,
238
814
  text: string,
239
- opts?: BwippOptions,
815
+ opts?: BwippOptions
240
816
  ):
241
817
  | Array<{ bbs: number[]; bhs: number[]; sbs: number[] }>
242
- | Array<{ pixs: number[]; pixx: number; pixy: number; height: number; width: number }>;
243
- }
818
+ | Array<{
819
+ pixs: number[];
820
+ pixx: number;
821
+ pixy: number;
822
+ height: number;
823
+ width: number;
824
+ }>;
244
825
  export const BWIPP_VERSION: string;
245
826
  export const BWIPJS_VERSION: string;
246
827
 
247
828
  // wrapper around FontLib.loadFont()
248
829
  export function loadFont(name: string, data: string | Uint8Array): void;
249
- export function loadFont(name: string, mult: number, data: string | Uint8Array): void;
250
- export function loadFont(name: string, multy: number, multx: number, data: string | Uint8Array): void;
830
+ export function loadFont(
831
+ name: string,
832
+ mult: number,
833
+ data: string | Uint8Array
834
+ ): void;
835
+ export function loadFont(
836
+ name: string,
837
+ multy: number,
838
+ multx: number,
839
+ data: string | Uint8Array
840
+ ): void;
251
841
 
252
842
  export namespace FontLib {
253
843
  export interface PathData
254
- extends Array<
255
- | { type: 'M'; x: number; y: number }
256
- | { type: 'L'; x: number; y: number }
257
- | { type: 'Q'; x: number; y: number; cx: number; cy: number }
258
- | { type: 'C'; x: number; y: number; cx1: number; cy1: number; cx2: number; cy2: number }
259
- > {
260
- ascent: number;
261
- descent: number;
262
- advance: number;
844
+ extends Array<
845
+ | { type: "M"; x: number; y: number }
846
+ | { type: "L"; x: number; y: number }
847
+ | { type: "Q"; x: number; y: number; cx: number; cy: number }
848
+ | {
849
+ type: "C";
850
+ x: number;
851
+ y: number;
852
+ cx1: number;
853
+ cy1: number;
854
+ cx2: number;
855
+ cy2: number;
856
+ }
857
+ > {
858
+ ascent: number;
859
+ descent: number;
860
+ advance: number;
263
861
  }
264
862
  export function lookup(font: string): number;
265
863
  export function monochrome(mono: boolean): void;
266
864
  export function getglyph(
267
- fontid: number,
268
- charcode: number,
269
- width: number,
270
- height: number,
865
+ fontid: number,
866
+ charcode: number,
867
+ width: number,
868
+ height: number
271
869
  ): {
272
- glyph: number;
273
- top: number;
274
- left: number;
275
- width: number;
276
- height: number;
277
- advance: number;
278
- pixels: Uint8Array;
279
- bytes: Uint8Array;
280
- cachekey: string;
281
- offset: number;
870
+ glyph: number;
871
+ top: number;
872
+ left: number;
873
+ width: number;
874
+ height: number;
875
+ advance: number;
876
+ pixels: Uint8Array;
877
+ bytes: Uint8Array;
878
+ cachekey: string;
879
+ offset: number;
282
880
  };
283
- export function getpaths(fontid: number, charcode: number, width: number, height: number): PathData;
881
+ export function getpaths(
882
+ fontid: number,
883
+ charcode: number,
884
+ width: number,
885
+ height: number
886
+ ): PathData;
284
887
  export function loadFont(name: string, data: string | Uint8Array): void;
285
- export function loadFont(name: string, mult: number, data: string | Uint8Array): void;
286
- export function loadFont(name: string, multy: number, multx: number, data: string | Uint8Array): void;
888
+ export function loadFont(
889
+ name: string,
890
+ mult: number,
891
+ data: string | Uint8Array
892
+ ): void;
893
+ export function loadFont(
894
+ name: string,
895
+ multy: number,
896
+ multx: number,
897
+ data: string | Uint8Array
898
+ ): void;
287
899
  }
288
- export function toSVG(opts: RenderOptions): string;
289
- export function drawingSVG(): DrawingContext<string>;
290
-
291
- // platform-specific exports
292
- export function toCanvas(canvas: string | HTMLCanvasElement, opts: RenderOptions): HTMLCanvasElement;
293
- export function drawingCanvas(canvas: string | HTMLCanvasElement): DrawingContext<HTMLCanvasElement>;
294
-
295
- export function datamatrix(canvas: string | HTMLCanvasElement, opts: RenderOptions): HTMLCanvasElement;
296
- export function datamatrix<T>(opts: RenderOptions, drawing: DrawingContext<Promise<T>>): Promise<T>;
297
- export function datamatrix<T>(opts: RenderOptions, drawing: DrawingContext<T>): T;
298
-
299
-
300
- export function qrcode(canvas: string | HTMLCanvasElement, opts: RenderOptions): HTMLCanvasElement;
301
- export function qrcode<T>(opts: RenderOptions, drawing: DrawingContext<Promise<T>>): Promise<T>;
302
- export function qrcode<T>(opts: RenderOptions, drawing: DrawingContext<T>): T;
900
+ }
303
901
  }