flutter::BuiltinSkiaCodecImageGenerator Class Reference

#include <image_generator.h>

Inheritance diagram for flutter::BuiltinSkiaCodecImageGenerator:

Public Member Functions
	~BuiltinSkiaCodecImageGenerator ()
	BuiltinSkiaCodecImageGenerator (std::unique_ptr< SkCodec > codec)
	BuiltinSkiaCodecImageGenerator (sk_sp< SkData > buffer)
const SkImageInfo &	GetInfo () override
	Returns basic information about the contents of the encoded image. This information can almost always be collected by just interpreting the header of a decoded image. More...
unsigned int	GetFrameCount () const override
	Get the number of frames that the encoded image stores. This method is always expected to be called before GetFrameInfo, as the underlying image decoder may interpret frame information that is then used when calling GetFrameInfo. More...
unsigned int	GetPlayCount () const override
	The number of times an animated image should play through before playback stops. More...
const ImageGenerator::FrameInfo	GetFrameInfo (unsigned int frame_index) override
	Get information about a single frame in the context of a multi-frame image, useful for animation and frame blending. This method should only ever be called after GetFrameCount has been called. This information is nonsensical for single-frame images. More...
SkISize	GetScaledDimensions (float desired_scale) override
	Given a scale value, find the closest image size that can be used for efficiently decoding the image. If subpixel image decoding is not supported by the decoder, this method should just return the original image size. More...
bool	GetPixels (const SkImageInfo &info, void *pixels, size_t row_bytes, unsigned int frame_index=0, std::optional< unsigned int > prior_frame=std::nullopt) override
	Decode the image into a given buffer. This method is currently always used for sub-pixel image decoding. For full-sized still images, GetImage is always attempted first. More...
Public Member Functions inherited from flutter::ImageGenerator
virtual	~ImageGenerator ()
virtual const SkImageInfo &	GetInfo ()=0
	Returns basic information about the contents of the encoded image. This information can almost always be collected by just interpreting the header of a decoded image. More...
virtual unsigned int	GetFrameCount () const =0
	Get the number of frames that the encoded image stores. This method is always expected to be called before GetFrameInfo, as the underlying image decoder may interpret frame information that is then used when calling GetFrameInfo. More...
virtual unsigned int	GetPlayCount () const =0
	The number of times an animated image should play through before playback stops. More...
virtual const FrameInfo	GetFrameInfo (unsigned int frame_index)=0
	Get information about a single frame in the context of a multi-frame image, useful for animation and frame blending. This method should only ever be called after GetFrameCount has been called. This information is nonsensical for single-frame images. More...
virtual SkISize	GetScaledDimensions (float scale)=0
	Given a scale value, find the closest image size that can be used for efficiently decoding the image. If subpixel image decoding is not supported by the decoder, this method should just return the original image size. More...
virtual bool	GetPixels (const SkImageInfo &info, void *pixels, size_t row_bytes, unsigned int frame_index=0, std::optional< unsigned int > prior_frame=std::nullopt)=0
	Decode the image into a given buffer. This method is currently always used for sub-pixel image decoding. For full-sized still images, GetImage is always attempted first. More...
sk_sp< SkImage >	GetImage ()
	Creates an SkImage based on the current ImageInfo of this ImageGenerator. More...

Static Public Member Functions
static std::unique_ptr< ImageGenerator >	MakeFromData (sk_sp< SkData > data)

Additional Inherited Members
Static Public Attributes inherited from flutter::ImageGenerator
static const unsigned int	kInfinitePlayCount
	Frame count value to denote infinite looping. More...

Detailed Description

Definition at line 183 of file image_generator.h.

Constructor & Destructor Documentation

~BuiltinSkiaCodecImageGenerator()

flutter::BuiltinSkiaCodecImageGenerator::~BuiltinSkiaCodecImageGenerator ( )

default

BuiltinSkiaCodecImageGenerator() [1/2]

flutter::BuiltinSkiaCodecImageGenerator::BuiltinSkiaCodecImageGenerator ( std::unique_ptr< SkCodec >  codec )

explicit

Definition at line 98 of file image_generator.cc.

    : codec_(std::move(codec)) {
  image_info_ = getInfoIncludingExif(codec_.get());
}

BuiltinSkiaCodecImageGenerator() [2/2]

flutter::BuiltinSkiaCodecImageGenerator::BuiltinSkiaCodecImageGenerator ( sk_sp< SkData >  buffer )

explicit

Definition at line 104 of file image_generator.cc.

    : codec_(SkCodec::MakeFromData(std::move(buffer)).release()) {
  image_info_ = getInfoIncludingExif(codec_.get());
}

Member Function Documentation

GetFrameCount()

unsigned int flutter::BuiltinSkiaCodecImageGenerator::GetFrameCount ( ) const

overridevirtual

Get the number of frames that the encoded image stores. This method is always expected to be called before GetFrameInfo, as the underlying image decoder may interpret frame information that is then used when calling GetFrameInfo.

Returns

The number of frames that the encoded image stores. This will always be 1 for single-frame images.

Implements flutter::ImageGenerator.

Definition at line 114 of file image_generator.cc.

                                                                 {
  return codec_->getFrameCount();
}

GetFrameInfo()

const ImageGenerator::FrameInfo flutter::BuiltinSkiaCodecImageGenerator::GetFrameInfo ( unsigned int  frame_index )

overridevirtual

Get information about a single frame in the context of a multi-frame image, useful for animation and frame blending. This method should only ever be called after GetFrameCount has been called. This information is nonsensical for single-frame images.

Parameters

[in]

frame_index

The index of the frame to get information about.

Returns

Information about the given frame. If the image is single-frame, a default result is returned.

See also

GetFrameCount

Implements flutter::ImageGenerator.

Definition at line 123 of file image_generator.cc.

                              {
  SkCodec::FrameInfo info = {};
  codec_->getFrameInfo(frame_index, &info);
  return {
      .required_frame = info.fRequiredFrame == SkCodec::kNoFrame
                            ? std::nullopt
                            : std::optional<unsigned int>(info.fRequiredFrame),
      .duration = static_cast<unsigned int>(info.fDuration),
      .disposal_method = info.fDisposalMethod};
}

GetInfo()

const SkImageInfo & flutter::BuiltinSkiaCodecImageGenerator::GetInfo ( )

overridevirtual

Returns basic information about the contents of the encoded image. This information can almost always be collected by just interpreting the header of a decoded image.

Returns

Size and color information describing the image.

Note

This method is executed on the UI thread and used for layout purposes by the framework, and so this method should not perform long synchronous tasks.

Implements flutter::ImageGenerator.

Definition at line 110 of file image_generator.cc.

                                                           {
  return image_info_;
}

GetPixels()

bool flutter::BuiltinSkiaCodecImageGenerator::GetPixels ( const SkImageInfo &  info, void *  pixels, size_t  row_bytes, unsigned int  frame_index = 0, std::optional< unsigned int >  prior_frame = std::nullopt  )

overridevirtual

Decode the image into a given buffer. This method is currently always used for sub-pixel image decoding. For full-sized still images, GetImage is always attempted first.

Parameters

[in]	info	The desired size and color info of the decoded image to be returned. The implementation of GetScaledDimensions determines which sizes are supported by the image decoder.
[in]	pixels	The location where the raw decoded image data should be written.
[in]	row_bytes	The total number of bytes that should make up a single row of decoded image data (i.e. width * bytes_per_pixel).
[in]	frame_index	Which frame to decode. This is only useful for multi-frame images.
[in]	prior_frame	Optional frame index parameter for multi-frame images which specifies the previous frame that should be use for blending. This hints to the decoder that it should use a previously cached frame instead of decoding dependency frame(s). If an empty value is supplied, the decoder should decode any necessary frames first.

Returns

True if the image was successfully decoded.

Note

This method performs potentially long synchronous work, and so it should never be executed on the UI thread. Image decoders do not require GPU acceleration, and so threads without a GPU context may also be used.

See also

GetScaledDimensions

Implements flutter::ImageGenerator.

Definition at line 144 of file image_generator.cc.

                                           {
  SkCodec::Options options;
  options.fFrameIndex = frame_index;
  if (prior_frame.has_value()) {
    options.fPriorFrame = prior_frame.value();
  }
  SkEncodedOrigin origin = codec_->getOrigin();
 
  SkPixmap output_pixmap(info, pixels, row_bytes);
  SkPixmap temp_pixmap;
  SkBitmap temp_bitmap;
  if (origin == kTopLeft_SkEncodedOrigin) {
    // We can decode directly into the output buffer.
    temp_pixmap = output_pixmap;
  } else {
    // We need to decode into a different buffer so we can re-orient
    // the pixels later.
    SkImageInfo temp_info = output_pixmap.info();
    if (SkEncodedOriginSwapsWidthHeight(origin)) {
      // We'll be decoding into a buffer that has height and width swapped.
      temp_info = SkPixmapUtils::SwapWidthHeight(temp_info);
    }
    if (!temp_bitmap.tryAllocPixels(temp_info)) {
      FML_DLOG(ERROR) << "Failed to allocate memory for bitmap of size "
                      << temp_info.computeMinByteSize() << "B";
      return false;
    }
    temp_pixmap = temp_bitmap.pixmap();
  }
 
  SkCodec::Result result = codec_->getPixels(temp_pixmap, &options);
  if (result != SkCodec::kSuccess) {
    FML_DLOG(WARNING) << "codec could not get pixels. "
                      << SkCodec::ResultToString(result);
    return false;
  }
  if (origin == kTopLeft_SkEncodedOrigin) {
    return true;
  }
  return SkPixmapUtils::Orient(output_pixmap, temp_pixmap, origin);
}

GetPlayCount()

unsigned int flutter::BuiltinSkiaCodecImageGenerator::GetPlayCount ( ) const

overridevirtual

The number of times an animated image should play through before playback stops.

Returns

If this image is animated, the number of times the animation should play through is returned, otherwise it'll just return 1. If the animation should loop forever, kInfinitePlayCount is returned.

Implements flutter::ImageGenerator.

Definition at line 118 of file image_generator.cc.

                                                                {
  auto repetition_count = codec_->getRepetitionCount();
  return repetition_count < 0 ? kInfinitePlayCount : repetition_count + 1;
}

GetScaledDimensions()

SkISize flutter::BuiltinSkiaCodecImageGenerator::GetScaledDimensions ( float  scale )

overridevirtual

Given a scale value, find the closest image size that can be used for efficiently decoding the image. If subpixel image decoding is not supported by the decoder, this method should just return the original image size.

Parameters

[in]

scale

The desired scale factor of the image for decoding.

Returns

The closest image size that can be used for efficiently decoding the image.

Note

This method is called prior to GetPixels in order to query for supported sizes.

See also

GetPixels

Implements flutter::ImageGenerator.

Definition at line 135 of file image_generator.cc.

                         {
  SkISize size = codec_->getScaledDimensions(desired_scale);
  if (SkEncodedOriginSwapsWidthHeight(codec_->getOrigin())) {
    std::swap(size.fWidth, size.fHeight);
  }
  return size;
}

MakeFromData()

std::unique_ptr< ImageGenerator > flutter::BuiltinSkiaCodecImageGenerator::MakeFromData ( sk_sp< SkData >  data )

static

Definition at line 191 of file image_generator.cc.

                        {
  auto codec = SkCodec::MakeFromData(std::move(data));
  if (!codec) {
    return nullptr;
  }
  return std::make_unique<BuiltinSkiaCodecImageGenerator>(std::move(codec));
}

---

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

• lib/ui/painting/image_generator.h
• lib/ui/painting/image_generator.cc