Creates an image descriptor for encoded or decoded image data, describing the width, height, and bytes per pixel for that image. This class will hold a reference on the underlying image data, and in the case of compressed data, an ImageGenerator for the data. The Codec initialization actually happens in initEncoded, making initstantiateCodec a lightweight operation. More...

#include <image_descriptor.h>

Inheritance diagram for flutter::ImageDescriptor:

Classes
struct	ImageInfo

Public Types
enum	PixelFormat { kUnknown , kRGBA8888 , kBGRA8888 , kRGBAFloat32 , kR32Float , kGray8 }

Public Types inherited from tonic::DartWrappable
enum	DartNativeFields { kPeerIndex , kNumberOfNativeFields }

Public Member Functions
	~ImageDescriptor () override=default

void	instantiateCodec (Dart_Handle codec, int32_t target_width, int32_t target_height, int32_t destination_format)
	Associates a flutter::Codec object with the dart.ui Codec handle.

int	width () const
	The width of this image, EXIF oriented if applicable.

int	height () const
	The height of this image. EXIF oriented if applicable.

int	bytesPerPixel () const
	The bytes per pixel of the image.

int	row_bytes () const
	The byte length of the first row of the image. Defaults to width() * 4.

bool	should_resize (int target_width, int target_height) const
	Whether the given `target_width` or `target_height` differ from `width()` and `height()` respectively.

sk_sp< SkData >	data () const
	The underlying buffer for this image.

sk_sp< SkImage >	image () const

bool	is_compressed () const
	Whether this descriptor represents compressed (encoded) data or not.

const ImageInfo &	image_info () const
	The orientation corrected image info for this image.

SkISize	get_scaled_dimensions (float scale)
	Gets the scaled dimensions of this image, if backed by an `ImageGenerator` that can perform efficient subpixel scaling.

bool	get_pixels (const SkPixmap &pixmap) const
	Gets pixels for this image transformed based on the EXIF orientation tag, if applicable.

void	dispose ()

Public Member Functions inherited from flutter::RefCountedDartWrappable< ImageDescriptor >
virtual void	RetainDartWrappableReference () const override

virtual void	ReleaseDartWrappableReference () const override

Public Member Functions inherited from fml::RefCountedThreadSafe< T >
void	Release () const

Public Member Functions inherited from fml::internal::RefCountedThreadSafeBase
void	AddRef () const

bool	HasOneRef () const

void	AssertHasOneRef () const

Public Member Functions inherited from tonic::DartWrappable
	DartWrappable ()

virtual const DartWrapperInfo &	GetDartWrapperInfo () const =0

Dart_Handle	CreateDartWrapper (DartState *dart_state)

void	AssociateWithDartWrapper (Dart_Handle wrappable)

void	ClearDartWrapper ()

Dart_WeakPersistentHandle	dart_wrapper () const

Static Public Member Functions
static Dart_Handle	initEncoded (Dart_Handle descriptor_handle, ImmutableBuffer *immutable_buffer, Dart_Handle callback_handle)
	Asynchronously initializes an ImageDescriptor for an encoded image, as long as the format is recognized by an encoder installed in the `ImageGeneratorRegistry`. Calling this method will create an `ImageGenerator` and read EXIF corrected dimensions from the image data.

static void	initRaw (Dart_Handle descriptor_handle, const fml::RefPtr< ImmutableBuffer > &data, int width, int height, int row_bytes, int pixel_format)
	Synchronously initializes an `ImageDescriptor` for decompressed image data as specified by the `PixelFormat`.

static ImageInfo	CreateImageInfo (const SkImageInfo &sk_image_info)

static SkImageInfo	ToSkImageInfo (const ImageInfo &image_info)

Friends
class	ImageDecoderFixtureTest

Additional Inherited Members
Protected Member Functions inherited from fml::RefCountedThreadSafe< T >
	RefCountedThreadSafe ()

	~RefCountedThreadSafe ()

Protected Member Functions inherited from fml::internal::RefCountedThreadSafeBase
	RefCountedThreadSafeBase ()

	~RefCountedThreadSafeBase ()

bool	Release () const

void	Adopt ()

Protected Member Functions inherited from tonic::DartWrappable
virtual	~DartWrappable ()

Static Protected Member Functions inherited from tonic::DartWrappable
static Dart_PersistentHandle	GetTypeForWrapper (tonic::DartState *dart_state, const tonic::DartWrapperInfo &wrapper_info)

Detailed Description

Creates an image descriptor for encoded or decoded image data, describing the width, height, and bytes per pixel for that image. This class will hold a reference on the underlying image data, and in the case of compressed data, an ImageGenerator for the data. The Codec initialization actually happens in initEncoded, making initstantiateCodec a lightweight operation.

See also: ImageGenerator

Definition at line 33 of file image_descriptor.h.

Member Enumeration Documentation

◆ PixelFormat

enum flutter::ImageDescriptor::PixelFormat

Enumerator
kUnknown
kRGBA8888
kBGRA8888
kRGBAFloat32
kR32Float
kGray8

Definition at line 38 of file image_descriptor.h.

                   {
    // Error pixel format for Skia compatibility.
    kUnknown,
    kRGBA8888,
    kBGRA8888,
    kRGBAFloat32,
    kR32Float,
    kGray8,
  };

Constructor & Destructor Documentation

◆ ~ImageDescriptor()

flutter::ImageDescriptor::~ImageDescriptor ( )

overridedefault

Member Function Documentation

◆ bytesPerPixel()

int flutter::ImageDescriptor::bytesPerPixel ( ) const

The bytes per pixel of the image.

Definition at line 221 of file image_descriptor.cc.

                                         {
  switch (image_info_.format) {
    case kUnknown:
      return 0;
    case kGray8:
      return 1;
    case kRGBA8888:
    case kBGRA8888:
    case kR32Float:
      return 4;
    case kRGBAFloat32:
      return 16;
  }
}

References flutter::ImageDescriptor::ImageInfo::format, kBGRA8888, kGray8, kR32Float, kRGBA8888, kRGBAFloat32, and kUnknown.

Referenced by row_bytes().

◆ CreateImageInfo()

ImageDescriptor::ImageInfo flutter::ImageDescriptor::CreateImageInfo ( const SkImageInfo & sk_image_info )

static

Definition at line 20 of file image_descriptor.cc.

                                      {
  PixelFormat format;
  switch (sk_image_info.colorType()) {
    case kUnknown_SkColorType:
      format = kUnknown;
      break;
    case kRGBA_8888_SkColorType:
      format = kRGBA8888;
      break;
    case kBGRA_8888_SkColorType:
      format = kBGRA8888;
      break;
    case kRGBA_F32_SkColorType:
      format = kRGBAFloat32;
      break;
    case kGray_8_SkColorType:
      format = kGray8;
      break;
    default:
      FML_DCHECK(false) << "Unsupported pixel format: "
                        << sk_image_info.colorType();
      format = kRGBA8888;
  }
  return ImageInfo{
      .width = static_cast<uint32_t>(sk_image_info.width()),
      .height = static_cast<uint32_t>(sk_image_info.height()),
      .format = format,
      .alpha_type = sk_image_info.alphaType(),
      .color_space = sk_image_info.refColorSpace(),
  };
}

References alpha_type, FML_DCHECK, format, height(), kBGRA8888, kGray8, kRGBA8888, kRGBAFloat32, kUnknown, and flutter::ImageDescriptor::ImageInfo::width.

Referenced by flutter::testing::TEST_F(), and flutter::testing::TEST_F().

◆ data()

sk_sp< SkData > flutter::ImageDescriptor::data ( ) const

inline

The underlying buffer for this image.

Definition at line 104 of file image_descriptor.h.

104{ return buffer_; }

Referenced by flutter::ImageDecoderImpeller::DecompressTexture(), flutter::ImageFromDecompressedData(), and initRaw().

◆ dispose()

void flutter::ImageDescriptor::dispose ( )

inline

Definition at line 129 of file image_descriptor.h.

                 {
    buffer_.reset();
    generator_.reset();
    ClearDartWrapper();
  }

References tonic::DartWrappable::ClearDartWrapper().

◆ get_pixels()

bool flutter::ImageDescriptor::get_pixels ( const SkPixmap & pixmap ) const

Gets pixels for this image transformed based on the EXIF orientation tag, if applicable.

Definition at line 215 of file image_descriptor.cc.

                                                             {
  FML_DCHECK(generator_);
  return generator_->GetPixels(pixmap.info(), pixmap.writable_addr(),
                               pixmap.rowBytes());
}

References FML_DCHECK.

Referenced by flutter::ImageDecoderSkia::ImageFromCompressedData().

◆ get_scaled_dimensions()

SkISize flutter::ImageDescriptor::get_scaled_dimensions ( float scale )

inline

Gets the scaled dimensions of this image, if backed by an ImageGenerator that can perform efficient subpixel scaling.

See also: ImageGenerator::GetScaledDimensions

Definition at line 118 of file image_descriptor.h.

                                             {
    if (generator_) {
      return generator_->GetScaledDimensions(scale);
    }
    return SkISize::Make(image_info_.width, image_info_.height);
  }

References flutter::ImageDescriptor::ImageInfo::height, and flutter::ImageDescriptor::ImageInfo::width.

Referenced by flutter::ImageDecoderImpeller::DecompressTexture(), and flutter::ImageDecoderSkia::ImageFromCompressedData().

◆ height()

int flutter::ImageDescriptor::height ( ) const

inline

The height of this image. EXIF oriented if applicable.

Definition at line 85 of file image_descriptor.h.

85{ return image_info_.height; }

References flutter::ImageDescriptor::ImageInfo::height.

Referenced by CreateImageInfo(), initRaw(), and should_resize().

◆ image()

sk_sp< SkImage > flutter::ImageDescriptor::image ( ) const

Definition at line 211 of file image_descriptor.cc.

                                            {
  return generator_->GetImage();
}

Referenced by flutter::ImageDecoderSkia::ImageFromCompressedData().

◆ image_info()

const ImageInfo & flutter::ImageDescriptor::image_info ( ) const

inline

The orientation corrected image info for this image.

Definition at line 113 of file image_descriptor.h.

113{ return image_info_; }

Referenced by flutter::ImageDecoderImpeller::DecompressTexture(), flutter::ImageDecoderSkia::ImageFromCompressedData(), flutter::ImageFromDecompressedData(), initRaw(), and ToSkImageInfo().

◆ initEncoded()

Dart_Handle flutter::ImageDescriptor::initEncoded	(	Dart_Handle	descriptor_handle,
		ImmutableBuffer *	immutable_buffer,
		Dart_Handle	callback_handle
	)

static

Asynchronously initializes an ImageDescriptor for an encoded image, as long as the format is recognized by an encoder installed in the ImageGeneratorRegistry. Calling this method will create an ImageGenerator and read EXIF corrected dimensions from the image data.

See also: ImageGeneratorRegistry

Definition at line 94 of file image_descriptor.cc.

                                                                      {
  if (!Dart_IsClosure(callback_handle)) {
    return tonic::ToDart("Callback must be a function");
  }
 
  if (!immutable_buffer) {
    return tonic::ToDart("Buffer parameter must not be null");
  }
 
  // This has to be valid because this method is called from Dart.
  auto dart_state = UIDartState::Current();
  auto registry = dart_state->GetImageGeneratorRegistry();
 
  if (!registry) {
    return tonic::ToDart(
        "Failed to access the internal image decoder "
        "registry on this isolate. Please file a bug on "
        "https://github.com/flutter/flutter/issues.");
  }
 
  auto generator =
      registry->CreateCompatibleGenerator(immutable_buffer->data());
 
  if (!generator) {
    // No compatible image decoder was found.
    return tonic::ToDart("Invalid image data");
  }
 
  auto descriptor = fml::MakeRefCounted<ImageDescriptor>(
      immutable_buffer->data(), std::move(generator));
 
  FML_DCHECK(descriptor);
 
  descriptor->AssociateWithDartWrapper(descriptor_handle);
  tonic::DartInvoke(callback_handle, {Dart_TypeVoid()});
 
  return Dart_Null();
}

References flutter::UIDartState::Current(), tonic::DartInvoke(), flutter::ImmutableBuffer::data(), FML_DCHECK, and tonic::ToDart().

◆ initRaw()

void flutter::ImageDescriptor::initRaw	(	Dart_Handle	descriptor_handle,
		const fml::RefPtr< ImmutableBuffer > &	data,
		int	width,
		int	height,
		int	row_bytes,
		int	pixel_format
	)

static

Synchronously initializes an ImageDescriptor for decompressed image data as specified by the PixelFormat.

Definition at line 154 of file image_descriptor.cc.

                                                {
  ImageDescriptor::PixelFormat image_descriptor_pixel_format =
      toImageDescriptorPixelFormat(pixel_format);
  const ImageInfo image_info = {
      .width = static_cast<uint32_t>(width),
      .height = static_cast<uint32_t>(height),
      .format = image_descriptor_pixel_format,
      .alpha_type = image_descriptor_pixel_format == PixelFormat::kRGBAFloat32
                        ? kUnpremul_SkAlphaType
                        : kPremul_SkAlphaType,
      .color_space = SkColorSpace::MakeSRGB(),
  };
 
  auto descriptor = fml::MakeRefCounted<ImageDescriptor>(
      data->data(), image_info,
      row_bytes == -1 ? std::nullopt : std::optional<size_t>(row_bytes));
  descriptor->AssociateWithDartWrapper(descriptor_handle);
}

References data(), height(), image_info(), kRGBAFloat32, row_bytes(), flutter::ImageDescriptor::ImageInfo::width, and width().

◆ instantiateCodec()

void flutter::ImageDescriptor::instantiateCodec	(	Dart_Handle	codec,
		int32_t	target_width,
		int32_t	target_height,
		int32_t	destination_format
	)

Associates a flutter::Codec object with the dart.ui Codec handle.

Definition at line 194 of file image_descriptor.cc.

                                                                   {
  fml::RefPtr<Codec> ui_codec;
  if (!generator_ || generator_->GetFrameCount() == 1) {
    ui_codec = fml::MakeRefCounted<SingleFrameCodec>(
        static_cast<fml::RefPtr<ImageDescriptor>>(this),  //
        target_width,                                     //
        target_height,                                    //
        ToImageDecoderTargetPixelFormat(destination_format));
  } else {
    ui_codec = fml::MakeRefCounted<MultiFrameCodec>(generator_);
  }
  ui_codec->AssociateWithDartWrapper(codec_handle);
}

References flutter::ToImageDecoderTargetPixelFormat().

◆ is_compressed()

bool flutter::ImageDescriptor::is_compressed ( ) const

inline

Whether this descriptor represents compressed (encoded) data or not.

Definition at line 110 of file image_descriptor.h.

110{ return !!generator_; }

Referenced by flutter::ImageDecoderImpeller::DecompressTexture().

◆ row_bytes()

int flutter::ImageDescriptor::row_bytes ( ) const

inline

The byte length of the first row of the image. Defaults to width() * 4.

Definition at line 92 of file image_descriptor.h.

                        {
    return row_bytes_.value_or(
        static_cast<size_t>(image_info_.width * bytesPerPixel()));
  }

References bytesPerPixel(), and flutter::ImageDescriptor::ImageInfo::width.

Referenced by flutter::ImageFromDecompressedData(), and initRaw().

◆ should_resize()

bool flutter::ImageDescriptor::should_resize	(	int	target_width,
		int	target_height
	)		const

inline

Whether the given target_width or target_height differ from width() and height() respectively.

Definition at line 99 of file image_descriptor.h.

                                                                {
    return target_width != width() || target_height != height();
  }

References height(), and width().

Referenced by flutter::ImageDecoderSkia::ImageFromCompressedData().

◆ ToSkImageInfo()

SkImageInfo flutter::ImageDescriptor::ToSkImageInfo ( const ImageInfo & image_info )

static

Definition at line 53 of file image_descriptor.cc.

                                                                      {
  SkColorType color_type = kUnknown_SkColorType;
  switch (image_info.format) {
    case PixelFormat::kUnknown:
      color_type = kUnknown_SkColorType;
      break;
    case PixelFormat::kRGBA8888:
      color_type = kRGBA_8888_SkColorType;
      break;
    case PixelFormat::kBGRA8888:
      color_type = kBGRA_8888_SkColorType;
      break;
    case PixelFormat::kRGBAFloat32:
      color_type = kRGBA_F32_SkColorType;
      break;
    case PixelFormat::kGray8:
      color_type = kGray_8_SkColorType;
      break;
    case PixelFormat::kR32Float:
      FML_DCHECK(false) << "not a supported skia format";
      break;
  }
  return SkImageInfo::Make(image_info.width, image_info.height, color_type,
                           image_info.alpha_type, image_info.color_space);
}

References flutter::ImageDescriptor::ImageInfo::alpha_type, flutter::ImageDescriptor::ImageInfo::color_space, color_type, FML_DCHECK, flutter::ImageDescriptor::ImageInfo::format, flutter::ImageDescriptor::ImageInfo::height, image_info(), kBGRA8888, kGray8, kR32Float, kRGBA8888, kRGBAFloat32, kUnknown, and flutter::ImageDescriptor::ImageInfo::width.

Referenced by flutter::ImageDecoderImpeller::DecompressTexture(), flutter::ImageDecoderSkia::ImageFromCompressedData(), and flutter::ImageFromDecompressedData().

◆ width()

int flutter::ImageDescriptor::width ( ) const

inline

The width of this image, EXIF oriented if applicable.

Definition at line 82 of file image_descriptor.h.

82{ return image_info_.width; }

References flutter::ImageDescriptor::ImageInfo::width.

Referenced by initRaw(), and should_resize().

Friends And Related Symbol Documentation

◆ ImageDecoderFixtureTest

friend class ImageDecoderFixtureTest

friend

Definition at line 154 of file image_descriptor.h.

The documentation for this class was generated from the following files:

lib/ui/painting/image_descriptor.h
lib/ui/painting/image_descriptor.cc

Classes

Public Types

Public Member Functions

Static Public Member Functions

Friends

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ PixelFormat

Constructor & Destructor Documentation

◆ ~ImageDescriptor()

Member Function Documentation

◆ bytesPerPixel()

◆ CreateImageInfo()

◆ data()

◆ dispose()

◆ get_pixels()

◆ get_scaled_dimensions()

◆ height()

◆ image()

◆ image_info()

◆ initEncoded()

◆ initRaw()

◆ instantiateCodec()

◆ is_compressed()

◆ row_bytes()

◆ should_resize()

◆ ToSkImageInfo()

◆ width()

Friends And Related Symbol Documentation

◆ ImageDecoderFixtureTest