image/DecoderFlags.h
author Andrew Osmond <aosmond@mozilla.com>
Mon, 17 Sep 2018 15:06:28 -0400
changeset 495294 e72e07baca921e697a6d79aa8488e2a0aecb1364
parent 495285 b2ac47c5ebf333b38629a2ef590628b3a69c4a24
child 508163 6f3709b3878117466168c40affa7bca0b60cf75b
permissions -rw-r--r--
Bug 1337111 - Part 2. Add an image decoder flag to request complete frames. r=tnikkel DecoderFlags::BLEND_ANIMATION will cause the decoder to inject the BlendAnimationFilter from the previous patch into the SurfacePipe filter chain. All frames produced by this decoder will be complete, and should be equivalent to the result outputted by FrameAnimator.

/* -*- 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_DecoderFlags_h
#define mozilla_image_DecoderFlags_h

#include "mozilla/TypedEnumBits.h"

namespace mozilla {
namespace image {

/**
 * Flags that influence decoder behavior. Note that these flags *don't*
 * influence the logical content of the surfaces that the decoder generates, so
 * they're not in a factor in SurfaceCache lookups and the like. These flags
 * instead either influence which surfaces are generated at all or the tune the
 * decoder's behavior for a particular scenario.
 */
enum class DecoderFlags : uint8_t
{
  FIRST_FRAME_ONLY               = 1 << 0,
  IS_REDECODE                    = 1 << 1,
  IMAGE_IS_TRANSIENT             = 1 << 2,
  ASYNC_NOTIFY                   = 1 << 3,

  /**
   * By default, a surface is considered substitutable. That means callers are
   * willing to accept a less than ideal match to display. If a caller requires
   * a specific size and won't accept alternatives, then this flag should be
   * set.
   */
  CANNOT_SUBSTITUTE              = 1 << 4,

  /**
   * By default, an animation decoder will produce partial frames that need to
   * be combined with the previously displayed/composited frame by FrameAnimator
   * to produce a complete frame. If this flag is set, the decoder will perform
   * this blending at decode time, and the frames produced are complete.
   */
  BLEND_ANIMATION                = 1 << 5
};
MOZ_MAKE_ENUM_CLASS_BITWISE_OPERATORS(DecoderFlags)

/**
 * @return the default set of decode flags.
 */
inline DecoderFlags
DefaultDecoderFlags()
{
  return DecoderFlags();
}

} // namespace image
} // namespace mozilla

#endif // mozilla_image_DecoderFlags_h