Spec-Zone.ru › TensorFlow 2.9

tf.io.decode_image

Просмотреть исходный код на GitHub

Функция для decode_bmp, decode_gif, decode_jpeg, и decode_png.

Просмотр псевдонимов

Основные псевдонимы

tf.image.decode_image

Псевдонимы для миграции

См. Руководство по миграции для получения дополнительных сведений.

tf.compat.v1.image.decode_image, tf.compat.v1.io.decode_image

tf.io.decode_image(
    contents,
    channels=None,
    dtype=tf.dtypes.uint8,
    name=None,
    expand_animations=True
)

Определяет, является ли изображение BMP, GIF, JPEG или PNG, и выполняет соответствующую операцию для преобразования входных байтов string в Tensor типа dtype.

Примечание: decode_gif возвращает 4-мерный массив [num_frames, height, width, 3], в отличие от decode_bmp, decode_jpeg и decode_png, которые возвращают 3-мерные массивы [height, width, num_channels]. Убедитесь, что вы учитываете это при построении графа, если вы смешиваете файлы GIF с BMP, JPEG и/или PNG. В качестве альтернативы, установите аргумент expand_animations этой функции в значение False, в этом случае операция вернёт 3-мерные тензоры и обрезает анимированные файлы GIF до первого кадра.
Примечание: Если первый кадр анимированного GIF-изображения не занимает весь холст (максимальная ширина кадра × максимальная высота кадра), то незанятые области (в первом кадре) заполняются нулями (чёрным цветом). Для кадров после первого кадра, которые не занимают весь холст, используется предыдущий кадр для заполнения незанятых областей.
Аргументы
contents Tensor типа string. 0-мерное. Байты закодированного изображения.
channels Необязательный int. По умолчанию 0. Количество цветовых каналов для декодированного изображения.
dtype Требуемый тип данных возвращаемого Tensor .
name Имя операции (необязательно).
expand_animations Необязательный bool. По умолчанию True. Управляет формой выходного значения результата операции. Если True, возвращаемая операция создаст 3-мерный тензор для файлов PNG, JPEG и BMP; и 4-мерный тензор для всех GIF, анимированных или нет. Если False, возвращаемая операция создаст 3-мерный тензор для всех типов файлов и обрезает анимированные GIF до первого кадра.
Возвращаемые значения
Tensor типа dtype и 3- или 4-мерной формой, в зависимости от типа файла и значения параметра expand_animations .
Исключения
ValueError При неверном количестве каналов.

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.9/api_docs/python/tf/io/decode_image

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API