Class WebCadCoreService

constructor

• new WebCadCoreService(): WebCadCoreService

  Returns WebCadCoreService

worker

workerProxy

workerUrl

isInitialized

initPromise

version

init

• init(): Promise<boolean>

  初始化服务

  Returns Promise<boolean>

  初始化是否成功

getInfo

• getInfo(): Promise<any>

  获取服务信息

  Returns Promise<any>

  服务信息

cleanup

• cleanup(): void

  清理资源

  Returns void

isAvailable

• isAvailable(): boolean

  检查服务是否可用

  Returns boolean

  服务是否可用

getVersion

• getVersion(): string

  获取版本信息

  Returns string

  版本号

initWasm

• initWasm(): Promise<boolean>

  初始化同步 WASM 模块（用于主线程直接调用）

  Returns Promise<boolean>

  初始化是否成功

generateHatchSync

• generateHatchSync(patContent: string, options?: HatchOptions): HatchResult

  同步生成填充图案（主线程调用）

  Parameters

  • patContent: string

    PAT 文件内容

  • options: HatchOptions = {}

    渲染选项

  Returns HatchResult

  填充图案线段数组

isWasmInitialized

• isWasmInitialized(): boolean

  检查同步 WASM 模块是否已初始化

  Returns boolean

  是否已初始化

renderSingleLineTextV2

• renderSingleLineTextV2(input: SingleLineTextInput): TextRenderResult

  渲染单行文本 V2（高效版本，使用二进制格式）

  Parameters

  • input: SingleLineTextInput

    单行文本渲染参数

  Returns TextRenderResult

  渲染结果（多边形数组）

renderMultiLineText

• renderMultiLineText(input: MultiLineTextInput): MultiTextRenderResult

  渲染多行文本

  Parameters

  • input: MultiLineTextInput

    多行文本渲染参数

  Returns MultiTextRenderResult

  渲染结果（带颜色的多边形组数组）

renderMultiLineTextV2

• renderMultiLineTextV2(input: MultiLineTextInput): MultiTextRenderResult

  渲染多行文本 V2（高效版本，使用二进制格式）

  Parameters

  • input: MultiLineTextInput

    多行文本渲染参数

  Returns MultiTextRenderResult

  渲染结果（带颜色的多边形组数组）

loadFont

• loadFont(
      fontPath: string,
      fontName?: string,
      fontKind?: "ttf" | "woff" | "otf" | "shx",
  ): Promise<FontInfo>

  加载字体文件到 WASM

  Parameters

  • fontPath: string

    字体文件路径

  • OptionalfontName: string

    字体名称（可选，用于标识）

  • OptionalfontKind: "ttf" | "woff" | "otf" | "shx"

    字体类型（可选，自动检测）

  Returns Promise<FontInfo>

  字体信息，失败返回 null

loadFonts

• loadFonts(
      fonts: {
          path: string;
          name?: string;
          kind?: "ttf" | "woff" | "otf" | "shx";
      }[],
  ): Promise<FontInfo[]>

  批量加载字体

  Parameters

  • fonts: { path: string; name?: string; kind?: "ttf" | "woff" | "otf" | "shx" }[]

    字体配置数组

  Returns Promise<FontInfo[]>

  加载结果数组

getFont

• getFont(pathOrName: string): FontInfo

  根据路径或名称获取字体信息

  Parameters

  • pathOrName: string

    字体路径或名称

  Returns FontInfo

  字体信息，未找到返回 null

getAllFonts

• getAllFonts(): FontInfo[]

  获取所有已加载的字体

  Returns FontInfo[]

  字体信息数组

getDefaultShxFont

• getDefaultShxFont(): FontInfo

  Returns FontInfo

getDefaultTrueTypeFont

• getDefaultTrueTypeFont(): FontInfo

  Returns FontInfo

resolveFontForName

• resolveFontForName(fontNameOrFile?: string): FontInfo

  根据字体文件名或逻辑名称解析字体信息，并提供类型化的默认回退。

  • 当传入 SHX 字体名但未找到对应字体时，使用第一个已加载的 SHX 字体。
  • 当传入 TrueType/WOFF/OTF 名称但未找到时，使用第一个已加载的非 SHX 字体。
  • 当未传入名称时，优先返回 TrueType 默认字体（若不存在则返回任意字体）。

  Parameters

  • OptionalfontNameOrFile: string

  Returns FontInfo

isCompressedData

• isCompressedData(data: Uint8Array): boolean

  检查数据是否为 gzip/zlib 压缩格式

  Parameters

  • data: Uint8Array

    数据

  Returns boolean

  是否为压缩数据

decompressData

• decompressData(compressedData: Uint8Array): Uint8Array<ArrayBufferLike>

  解压 gzip/zlib 压缩数据

  Parameters

  • compressedData: Uint8Array

    压缩数据

  Returns Uint8Array<ArrayBufferLike>

  解压后的数据，失败返回 null

compressData

• compressData(data: Uint8Array, level?: number): Uint8Array<ArrayBufferLike>

  压缩数据为 gzip 格式

  Parameters

  • data: Uint8Array

    原始数据

  • level: number = 6

    压缩级别 1-9，默认 6

  Returns Uint8Array<ArrayBufferLike>

  压缩后的数据，失败返回 null

decompressVcadToWebcad

• decompressVcadToWebcad(vcadData: Uint8Array): string

  解压 .vcad 文件内容为 .webcad JSON 字符串

  Parameters

  • vcadData: Uint8Array

    .vcad 文件的二进制数据

  Returns string

  解压后的 JSON 字符串，失败返回 null

compressWebcadToVcad

• compressWebcadToVcad(
      webcadJson: string,
      level?: number,
  ): Uint8Array<ArrayBufferLike>

  将 .webcad JSON 内容压缩为 .vcad 格式

  Parameters

  • webcadJson: string

    .webcad JSON 字符串

  • level: number = 6

    压缩级别 1-9，默认 6

  Returns Uint8Array<ArrayBufferLike>

  压缩后的数据，失败返回 null

createJsonDiff

• createJsonDiff(
      oldJson: string,
      newJson: string,
      excludeEntityIds?: Set<number>,
  ): string

  创建 JSON 合并补丁 (merge patch) 比较两个 JSON 字符串，生成从 oldJson 到 newJson 的差异补丁

  Parameters

  • oldJson: string

    原始 JSON 字符串

  • newJson: string

    新 JSON 字符串

  • OptionalexcludeEntityIds: Set<number>

    要排除的实体 ID 集合（只读实体），这些实体不参与 diff 比较

  Returns string

  差异补丁 JSON 字符串，失败返回 null

applyJsonPatch

• applyJsonPatch(targetJson: string, patch: string): string

  应用 JSON 合并补丁 (merge patch) 将补丁应用到目标 JSON，生成更新后的 JSON

  Parameters

  • targetJson: string

    目标 JSON 字符串

  • patch: string

    补丁 JSON 字符串

  Returns string

  更新后的 JSON 字符串，失败返回 null

createWebcadDiff

• createWebcadDiff(
      oldWebcad: string,
      newWebcad: string,
      excludeEntityIds?: Set<number>,
  ): string

  创建 WebCAD 文档的差异补丁 用于比较编辑前后的文档，生成可以保存到服务器的补丁

  Parameters

  • oldWebcad: string

    原始 .webcad JSON 字符串

  • newWebcad: string

    编辑后的 .webcad JSON 字符串

  • OptionalexcludeEntityIds: Set<number>

    要排除的实体 ID 集合（只读实体），这些实体不参与 diff 比较

  Returns string

  差异补丁 JSON 字符串，失败返回 null

applyWebcadPatch

• applyWebcadPatch(webcadJson: string, patch: string): string

  应用 WebCAD 补丁 将服务器返回的补丁应用到本地文档

  Parameters

  • webcadJson: string

    当前 .webcad JSON 字符串

  • patch: string

    补丁 JSON 字符串

  Returns string

  更新后的 .webcad JSON 字符串，失败返回 null

getFontMetricsCache

• getFontMetricsCache(): string

  Get font metrics cache data for glyph rendering

  Returns string

  Cached metrics data string, or null if not available

updateFontMetricsIndex

• updateFontMetricsIndex(metricsData: string): boolean

  Update font metrics index from external data source

  Parameters

  • metricsData: string

    Encoded metrics data string

  Returns boolean

  true if update successful

getFontGlyphAdvance

• getFontGlyphAdvance(): number

  Get default glyph advance value for font metrics

  Returns number

  Glyph advance value (-1 if not cached)

getFontAscentValue

• getFontAscentValue(): number

  Get font ascent baseline value

  Returns number

  Ascent value (-1 if not cached)

getFontDescentValue

• getFontDescentValue(): number

  Get font descent baseline value

  Returns number

  Descent value (-1 if not cached)

getFontLineGap

• getFontLineGap(): number

  Get font line gap spacing value

  Returns number

  Line gap value (0 if not set)

freeFontMetricsCache

• freeFontMetricsCache(): void

  Release font metrics cache memory

  Returns void

detectBoundarySync

• detectBoundarySync(input: BoundaryDetectionInput): BoundaryDetectionOutput

  同步检测边界（主线程调用）

  Parameters

  • input: BoundaryDetectionInput

    边界检测输入参数

  Returns BoundaryDetectionOutput

  边界检测结果

parseSvgToWebcad

• parseSvgToWebcad(
      svgContent: string,
      whiteColorProcessing?: number,
      blackColorProcessing?: number,
      enableFill?: number,
      displayLineWeight?: number,
      lineWeightScale?: number,
  ): Promise<string>

  解析SVG内容并转换为WebCAD JSON格式

  Parameters

  • svgContent: string

    SVG内容字符串

  • whiteColorProcessing: number = 0

    白色处理模式: 0=保留, 1=反色, 2=过滤

  • blackColorProcessing: number = 0

    黑色处理模式: 0=保留, 1=反色, 2=过滤

  • enableFill: number = 1

    是否启用填充 (1=是, 0=否)

  • displayLineWeight: number = 1

    是否显示线宽 (1=是, 0=否)

  • lineWeightScale: number = 1.0

    线宽缩放比例

  Returns Promise<string>

  WebCAD JSON字符串，失败返回null

extractTableSync

• extractTableSync(input: TableExtractInput): TableExtractResult

  同步提取表格数据（主线程调用）

  Parameters

  • input: TableExtractInput

    表格提取输入数据

  Returns TableExtractResult

  表格提取结果