nginstack

Class: ImageInfo

@nginstack/engine/lib/image/ImageInfo~ ImageInfo

new ImageInfo()

Esta classe agrupa métodos estáticos que permitem obter informações e metadados de uma imagem a partir do caminho de um arquivo ou diretamente dos bytes da imagem.

ImageInfo.fromFile via de regra consome menos memória, pois há um tratamento para que apenas a quantidade suficiente de bytes seja lida para obter as informações. Já no caso de ImageInfo.fromBytes, normalmente a imagem inteira está carregada em memória, e qualquer otimização visando reduzir a quantidade de bytes carregados não garante o funcionamento correto da função.

Methods

<static> fromBytes(bytes)

Obtém informações de uma imagem diretamente de um bloco de bytes em memória.

Esta função trata as strings como se fossem uma sequência de bytes no formato conhecido por "Binary String", onde cada caractere da string representa um byte do conteúdo binário.

Parameters:
Name Type Description
bytes Uint8Array | ArrayBuffer | string

Dados binários da imagem.
Returns:

Objeto com as informações da imagem.

Type
ImageInfoResult
Example
const ImageInfo = require('@nginstack/engine/lib/image/ImageInfo.js');
// Supondo que "imageBytes" seja um buffer com os dados da imagem
const info = ImageInfo.fromBytes(imageBytes);
// Exemplo de retorno:
// {
//   "height": 720,
//   "orientation": "rotate90",
//   "width": 1280,
//   "exif": {
//     "gps": {
//       "gpsLatitude": "3 deg 46 min 38.35841426 sec S",
//       "gpsLongitudeRef": "W",
//       "gpsLatitudeRef": "S",
//       "gpsLongitude": "38 deg 28 min 55.0070629 sec W"
//     },
//     "tiff": {
//       "orientation": "row 0 at right and column 0 at top",
//       "compression": "JPEG",
//       "jpegInterchangeFormatLength": 2690,
//       "jpegInterchangeFormat": 12684,
//     },
//     "dateTimeOriginal": "2025-10-20 06:50:12",
//   },
//   "mimeType": "image/jpeg",
//   "hasAnimation": false,
//   "colorType": "rgb8"
// }

<static> fromFile(path)

Obtém informações de uma imagem a partir do seu caminho em disco.

Parameters:
Name Type Description
path string

Caminho do arquivo de imagem.
Returns:

Objeto com as informações da imagem.

Type
ImageInfoResult
Example
const ImageInfo = require('@nginstack/engine/lib/image/ImageInfo.js');
const info = ImageInfo.fromFile('caminho/para/animated.png');
// Exemplo de retorno:
// {
//   "height": 400,
//   "width": 480,
//   "orientation": "noTransforms",
//   "exif": null,
//   "mimeType": "image/png",
//   "hasAnimation": true,
//   "colorType": "rgba8"
// }