Class Buffer

constructor

• new Buffer(): Buffer

  Returns Buffer

• new Buffer(existingPtr: number): Buffer
  Internal

  Wrap an existing buffer pointer.

  Parameters

  • existingPtr: number

  Returns Buffer

Readonlyptr

addCodePoints

• addCodePoints(
      codePoints: number[],
      itemOffset?: number,
      itemLength?: number | null,
  ): void

  Add code points to the buffer.

  Parameters

  • codePoints: number[]

    Array of code points to be added to the buffer.

  • itemOffset: number = 0

    The offset of the first code point to add to the buffer.

  • itemLength: number | null = null

    The number of code points to add to the buffer, or null for the end of the array.

  Returns void

addText

• addText(text: string, itemOffset?: number, itemLength?: number | null): void

  Add text to the buffer.

  Parameters

  • text: string

    Text to be added to the buffer.

  • itemOffset: number = 0

    The offset of the first character to add to the buffer.

  • itemLength: number | null = null

    The number of characters to add to the buffer, or null for the end of text.

  Returns void

clearContents

• clearContents(): void

  Similar to reset(), but does not clear the Unicode functions and the replacement code point.

  Returns void

getContentType

• getContentType(): BufferContentType

  Return the buffer content type.

  Returns BufferContentType

  The buffer content type as a BufferContentType value.

getGlyphInfos

• getGlyphInfos(): GlyphInfo[]

  Get the glyph information from the buffer.

  Returns GlyphInfo[]

  An array of GlyphInfo objects.

getGlyphInfosAndPositions

• getGlyphInfosAndPositions(): (GlyphInfo & Partial<GlyphPosition>)[]

  Get the glyph information and positions from the buffer.

  Returns (GlyphInfo & Partial<GlyphPosition>)[]

  The glyph information and positions.

  The glyph information is returned as an array of objects with the properties from getGlyphInfos and getGlyphPositions combined.

getGlyphPositions

• getGlyphPositions(): GlyphPosition[]

  Get the glyph positions from the buffer.

  Returns GlyphPosition[]

  An array of GlyphPosition objects.

getLength

• getLength(): number

  Get the the number of items in the buffer.

  Returns number

  The buffer length.

guessSegmentProperties

• guessSegmentProperties(): void

  Set buffer script, language and direction.

  This needs to be done before shaping.

  Returns void

json

• json(): JsonGlyph[]

  Return the buffer contents as a JSON object.

  Returns JsonGlyph[]

  An array of JsonGlyph objects.

reset

• reset(): void

  Reset the buffer to its initial status.

  Returns void

serialize

• serialize(
      font?: Font | null,
      start?: number,
      end?: number | null,
      format?: BufferSerializeFormat,
      flags?: number,
  ): string

  Serialize the buffer contents to a string.

  Parameters

  • Optionalfont: Font | null

    The font to use for serialization.

  • start: number = 0

    The starting index of the glyphs to serialize.

  • Optionalend: number | null

    The ending index of the glyphs to serialize.

  • format: BufferSerializeFormat = BufferSerializeFormat.TEXT

    The BufferSerializeFormat to serialize the buffer contents to.

  • flags: number = 0

    A combination of BufferSerializeFlag values (OR them together).

  Returns string

  The serialized buffer contents.

setClusterLevel

• setClusterLevel(level: number): void

  Set the HarfBuzz clustering level.

  Affects the cluster values returned from shaping.

  Parameters

  • level: number

    Clustering level. See the HarfBuzz manual chapter on Clusters.

  Returns void

setDirection

• setDirection(dir: Direction): void

  Set buffer direction explicitly.

  Parameters

  • dir: Direction

    A Direction value.

  Returns void

setFlags

• setFlags(flags: number): void

  Set buffer flags explicitly.

  Parameters

  • flags: number

    A combination of BufferFlag values (OR them together).

  Returns void

setLanguage

• setLanguage(language: string): void

  Set buffer language explicitly.

  Parameters

  • language: string

    The buffer language

  Returns void

setMessageFunc

• setMessageFunc(
      func: (buffer: Buffer, font: Font, message: string) => boolean,
  ): void

  Set message func.

  Parameters

  • func: (buffer: Buffer, font: Font, message: string) => boolean

    The function to set. It receives the buffer, font, and message string as arguments. Returning false will skip this shaping step and move to the next one.

  Returns void

setScript

• setScript(script: string): void

  Set buffer script explicitly.

  Parameters

  • script: string

    The buffer script

  Returns void

updateGlyphPositions

• updateGlyphPositions(positions: GlyphPosition[]): void

  Update the glyph positions in the buffer. WARNING: Do not use unless you know what you are doing.

  Parameters

  • positions: GlyphPosition[]

  Returns void