gecko-dev/image/ImageMetadata.h
Andrew Osmond fa360dba1b Bug 1901076 - Part 2. Expose frame count variant of metadata decoders. r=tnikkel
It is useful/necessary for WebCodecs image decoding support to be able
to calculate a frame count for the encoded image without actually
decoding every frame. It needs to be able to provide results without the
complete buffer as well.

Differential Revision: https://phabricator.services.mozilla.com/D212831
2024-06-24 22:44:30 +00:00

123 lines
3.8 KiB
C++

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_image_ImageMetadata_h
#define mozilla_image_ImageMetadata_h
#include <stdint.h>
#include <utility>
#include "FrameTimeout.h"
#include "Orientation.h"
#include "mozilla/Maybe.h"
#include "mozilla/gfx/Point.h"
#include "mozilla/gfx/Rect.h"
#include "mozilla/image/Resolution.h"
#include "nsSize.h"
#include "nsTArray.h"
namespace mozilla::image {
// The metadata about an image that decoders accumulate as they decode.
class ImageMetadata {
public:
ImageMetadata() = default;
void SetHotspot(uint16_t aHotspotX, uint16_t aHotspotY) {
mHotspot = Some(gfx::IntPoint(aHotspotX, aHotspotY));
}
gfx::IntPoint GetHotspot() const { return *mHotspot; }
bool HasHotspot() const { return mHotspot.isSome(); }
void SetLoopCount(int32_t loopcount) { mLoopCount = loopcount; }
int32_t GetLoopCount() const { return mLoopCount; }
void SetLoopLength(FrameTimeout aLength) { mLoopLength = Some(aLength); }
FrameTimeout GetLoopLength() const { return *mLoopLength; }
bool HasLoopLength() const { return mLoopLength.isSome(); }
void SetFrameCount(uint32_t aCount) { mFrameCount = Some(aCount); }
uint32_t GetFrameCount() const { return *mFrameCount; }
bool HasFrameCount() const { return mFrameCount.isSome(); }
void SetFirstFrameTimeout(FrameTimeout aTimeout) {
mFirstFrameTimeout = aTimeout;
}
FrameTimeout GetFirstFrameTimeout() const { return mFirstFrameTimeout; }
void SetFirstFrameRefreshArea(const gfx::IntRect& aRefreshArea) {
mFirstFrameRefreshArea = Some(aRefreshArea);
}
gfx::IntRect GetFirstFrameRefreshArea() const {
return *mFirstFrameRefreshArea;
}
bool HasFirstFrameRefreshArea() const {
return mFirstFrameRefreshArea.isSome();
}
void SetSize(int32_t aWidth, int32_t aHeight, Orientation aOrientation,
Resolution aResolution) {
if (!HasSize()) {
mSize.emplace(
aOrientation.ToOriented(UnorientedIntSize(aWidth, aHeight)));
mOrientation.emplace(aOrientation);
mResolution = aResolution;
}
}
OrientedIntSize GetSize() const { return *mSize; }
bool HasSize() const { return mSize.isSome(); }
void AddNativeSize(const OrientedIntSize& aSize) {
mNativeSizes.AppendElement(aSize);
}
Resolution GetResolution() const { return mResolution; }
const nsTArray<OrientedIntSize>& GetNativeSizes() const {
return mNativeSizes;
}
Orientation GetOrientation() const { return *mOrientation; }
bool HasOrientation() const { return mOrientation.isSome(); }
void SetHasAnimation() { mHasAnimation = true; }
bool HasAnimation() const { return mHasAnimation; }
private:
/// The hotspot found on cursors, if present.
Maybe<gfx::IntPoint> mHotspot;
/// The loop count for animated images, or -1 for infinite loop.
int32_t mLoopCount = -1;
/// The resolution of the image in dppx.
Resolution mResolution;
// The total length of a single loop through an animated image.
Maybe<FrameTimeout> mLoopLength;
// The total number of frames we expect from the animated image.
Maybe<uint32_t> mFrameCount;
/// The timeout of an animated image's first frame.
FrameTimeout mFirstFrameTimeout = FrameTimeout::Forever();
// The area of the image that needs to be invalidated when the animation
// loops.
Maybe<gfx::IntRect> mFirstFrameRefreshArea;
Maybe<OrientedIntSize> mSize;
Maybe<Orientation> mOrientation;
// Sizes the image can natively decode to.
CopyableTArray<OrientedIntSize> mNativeSizes;
bool mHasAnimation = false;
};
} // namespace mozilla::image
#endif // mozilla_image_ImageMetadata_h