utils/image

用於影像處理的輔助模組。

這些函式和類僅供內部使用，這意味著終端使用者無需訪問此處。

• utils/image
  • 靜態
    • .RawImage
      • 新 RawImage(data, width, height, channels)
      • 例項
        • .size ⇒ *
        • .grayscale() ⇒ RawImage
        • .rgb() ⇒ RawImage
        • .rgba() ⇒ RawImage
        • .putAlpha(mask) ⇒ RawImage
        • .resize(width, height, options) ⇒ Promise.<RawImage>
        • .split() ⇒ Array.<RawImage>
        • .clone() ⇒ RawImage
        • .convert(numChannels) ⇒ RawImage
        • .save(path)
      • 靜態
        • .read(input) ⇒ *
        • .fromCanvas(canvas) ⇒ RawImage
        • .fromURL(url) ⇒ Promise.<RawImage>
        • .fromBlob(blob) ⇒ Promise.<RawImage>
        • .fromTensor(tensor)
    • .load_image
  • 內部
    • ~CONTENT_TYPE_MAP

utils/image.RawImage

型別：utils/image 的靜態類

• .RawImage
  • 新 RawImage(data, width, height, channels)
  • 例項
    • .size ⇒ *
    • .grayscale() ⇒ RawImage
    • .rgb() ⇒ RawImage
    • .rgba() ⇒ RawImage
    • .putAlpha(mask) ⇒ RawImage
    • .resize(width, height, options) ⇒ Promise.<RawImage>
    • .split() ⇒ Array.<RawImage>
    • .clone() ⇒ RawImage
    • .convert(numChannels) ⇒ RawImage
    • .save(path)
  • 靜態
    • .read(input) ⇒ *
    • .fromCanvas(canvas) ⇒ RawImage
    • .fromURL(url) ⇒ Promise.<RawImage>
    • .fromBlob(blob) ⇒ Promise.<RawImage>
    • .fromTensor(tensor)

新 RawImage(data, width, height, channels)

建立一個新的 RawImage 物件。

rawImage.size ⇒ <code> * </code>

返回影像的尺寸（寬度，高度）。

型別：RawImage 的例項屬性
返回：* - 影像的尺寸（寬度，高度）。

rawImage.grayscale() ⇒ <code> RawImage </code>

將影像轉換為灰度格式。

型別：RawImage 的例項方法
返回：RawImage - this 以支援鏈式呼叫。

rawImage.rgb() ⇒ <code> RawImage </code>

將影像轉換為 RGB 格式。

型別：RawImage 的例項方法
返回：RawImage - this 以支援鏈式呼叫。

rawImage.rgba() ⇒ <code> RawImage </code>

將影像轉換為 RGBA 格式。

型別：RawImage 的例項方法
返回：RawImage - this 以支援鏈式呼叫。

rawImage.putAlpha(mask) ⇒ <code> RawImage </code>

將 alpha 蒙版應用於影像。原地操作。

型別：RawImage 的例項方法
返回：RawImage - 被遮罩的影像。
丟擲:

• 如果蒙版與影像大小不同，則會丟擲 Error。
• 如果影像不包含 4 個通道，則會丟擲 Error。
• 如果蒙版不是單通道，則會丟擲 Error。

rawImage.resize(width, height, options) ⇒ <code> Promise. < RawImage > </code>

將影像調整為給定尺寸。此方法使用 canvas API 執行調整大小。

型別：RawImage 的例項方法
返回：Promise.<RawImage> - this 以支援鏈式呼叫。

rawImage.split() ⇒ <code> Array. < RawImage > </code>

將此影像分割為單個波段。此方法從影像返回單個影像波段的陣列。例如，分割“RGB”影像將建立三個新影像，每個影像包含原始波段之一（紅色、綠色、藍色）的副本。

靈感來自 PIL 的 Image.split() 函式。

型別：RawImage 的例項方法
返回：Array.<RawImage> - 包含波段的陣列。

rawImage.clone() ⇒ <code> RawImage </code>

克隆影像

型別：RawImage 的例項方法
返回：RawImage - 克隆的影像

rawImage.convert(numChannels) ⇒ <code> RawImage </code>

將影像轉換為指定通道數的輔助方法

型別：RawImage 的例項方法
返回：RawImage - this 以支援鏈式呼叫。

rawImage.save(path)

將影像儲存到給定路徑。

型別：RawImage 的例項方法

RawImage.read(input) ⇒ <code> * </code>

用於從各種輸入型別讀取影像的輔助方法。

型別：RawImage 的靜態方法
返回：* - 影像物件。

示例： 從 URL 讀取影像。

let image = await RawImage.read('https://huggingface.co/datasets/Xenova/transformers.js-docs/resolve/main/football-match.jpg');
// RawImage 

RawImage.fromCanvas(canvas) ⇒ <code> RawImage </code>

從畫布讀取影像。

型別：RawImage 的靜態方法
返回：RawImage - 影像物件。

RawImage.fromURL(url) ⇒ <code> Promise. < RawImage > </code>

從 URL 或檔案路徑讀取影像。

型別：RawImage 的靜態方法
返回：Promise.<RawImage> - 影像物件。

RawImage.fromBlob(blob) ⇒ <code> Promise. < RawImage > </code>

從 Blob 建立新影像的輔助方法。

型別：RawImage 的靜態方法
返回：Promise.<RawImage> - 影像物件。

RawImage.fromTensor(tensor)

從張量建立新影像的輔助方法

型別：RawImage 的靜態方法

utils/image.load_image

從 URL、路徑等載入影像的輔助函式。

型別：utils/image 的靜態常量

utils/image~CONTENT_TYPE_MAP

副檔名到 MIME 型別的對映。

型別：utils/image 的內部常量