Font

constructor

• new Font(
      source?: Readonly<
          Pick<
              Font,
              | typeof graphicsNative
              | "isSmooth"
              | typeof fontRevision
              | "getInfo"
              | "getGlyph"
              | "getGlyphById"
              | "hasGlyph"
              | "getKerning"
              | "getAscent"
              | "getDescent"
              | "getLineSpacing"
              | "getUnderlinePosition"
              | "getUnderlineThickness"
              | "getTexture",
          >,
      >,
  ): Font

  创建空字体，或从现有字体创建副本。

  参数

  source可选

  Readonly<
      Pick<
          Font,
          | typeof graphicsNative
          | "isSmooth"
          | typeof fontRevision
          | "getInfo"
          | "getGlyph"
          | "getGlyphById"
          | "hasGlyph"
          | "getKerning"
          | "getAscent"
          | "getDescent"
          | "getLineSpacing"
          | "getUnderlinePosition"
          | "getUnderlineThickness"
          | "getTexture",
      >,
  >

  返回值

  Font

  源码与继承

getAscent

• getAscent(size: number): number

  返回指定像素字号的上升度量，单位为像素。

  参数

  size

  number

  返回值

  number

  源码与继承

getDescent

• getDescent(size: number): number

  返回指定像素字号的下降度量，单位为像素。

  参数

  size

  number

  返回值

  number

  源码与继承

getGlyph

• getGlyph(
      codePoint: number,
      characterSize: number,
      bold: boolean,
      outlineThickness?: number,
  ): ReadonlyValue<Glyph>

  获取 Unicode 码点对应的缓存字形；字号和轮廓厚度以像素计，bold 控制加粗。

  参数

  codePoint

  number

  characterSize

  number

  bold

  boolean

  outlineThickness

  number = 0

  返回值

  ReadonlyValue<Glyph>

  源码与继承

getGlyphById

• getGlyphById(
      id: number,
      characterSize: number,
      bold: boolean,
      outlineThickness?: number,
  ): ReadonlyValue<Glyph>

  按字体内部字形编号取得字形；字号和轮廓厚度以像素计。

  参数

  id

  number

  characterSize

  number

  bold

  boolean

  outlineThickness

  number = 0

  返回值

  ReadonlyValue<Glyph>

  源码与继承

getInfo

• getInfo(): FontInfo

  返回当前字体信息的只读视图。

  返回值

  FontInfo

  源码与继承

getKerning

• getKerning(
      first: number,
      second: number,
      characterSize: number,
      bold?: boolean,
  ): number

  返回两个 Unicode 码点之间的字距调整量，单位为像素。

  参数

  first

  number

  second

  number

  characterSize

  number

  bold

  boolean = false

  返回值

  number

  源码与继承

getLineSpacing

• getLineSpacing(size: number): number

  返回指定像素字号的推荐基线间距。

  参数

  size

  number

  返回值

  number

  源码与继承

getTexture

• getTexture(characterSize: number): Readonly

  返回指定像素字号的字形图集只读纹理引用，后续加载字形可能更新其内容。

  参数

  characterSize

  number

  返回值

  Readonly

  源码与继承

getUnderlinePosition

• getUnderlinePosition(size: number): number

  返回下划线相对基线的位置，单位为像素。

  参数

  size

  number

  返回值

  number

  源码与继承

getUnderlineThickness

• getUnderlineThickness(size: number): number

  返回下划线厚度，单位为像素。

  参数

  size

  number

  返回值

  number

  源码与继承

hasGlyph

• hasGlyph(codePoint: number): boolean

  返回字体是否包含指定 Unicode 码点的字形。

  参数

  codePoint

  number

  返回值

  boolean

  源码与继承

isSmooth

• isSmooth(): boolean

  返回字体纹理是否启用平滑过滤。

  返回值

  boolean

  源码与继承

openFromFile

• openFromFile(filename: string): Promise<boolean>

  异步打开字体文件，成功后替换字体并清空度量缓存，返回是否成功。

  参数

  filename

  string

  返回值

  Promise<boolean>

  源码与继承

openFromMemory

• openFromMemory(data: Uint8Array): Promise<boolean>

  从编码字体字节异步打开字体，返回是否成功。

  参数

  data

  Uint8Array

  返回值

  Promise<boolean>

  源码与继承

openFromStream

• openFromStream(stream: InputStream): Promise<boolean>

  从流起点读取全部字体字节并异步打开；返回是否成功，流异常会拒绝 Promise。

  参数

  stream

  InputStream

  返回值

  Promise<boolean>

  源码与继承

setSmooth

• setSmooth(smooth: boolean): void

  设置字体纹理是否使用平滑过滤。

  参数

  smooth

  boolean

  返回值

  void

  源码与继承

[fontRevision]

只读[graphicsNative]