Bug 1225934. Better describe the effect of the flag FLAG_HIGH_QUALITY_SCALING. Comment only change.
authorTimothy Nikkel <tnikkel@gmail.com>
Mon, 21 Mar 2016 16:15:20 -0500
changeset 327582 55ba885e2a854ee8c7404a29aa8e0c4cbab4d841
parent 327581 bc854d1c6ab72ffa8ce770a2171e002dfe7231c6
child 327583 d1baa3d6f78b0032cea1c0025f411d00369272e1
push id6048
push userkmoir@mozilla.com
push dateMon, 06 Jun 2016 19:02:08 +0000
treeherdermozilla-beta@46d72a56c57d [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
bugs1225934
milestone48.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
Bug 1225934. Better describe the effect of the flag FLAG_HIGH_QUALITY_SCALING. Comment only change.
image/imgIContainer.idl
--- a/image/imgIContainer.idl
+++ b/image/imgIContainer.idl
@@ -165,17 +165,21 @@ interface imgIContainer : nsISupports
    * ignore any embedded profiles, and don't convert to any particular
    * destination space.
    *
    * FLAG_CLAMP: Extend the image to the fill area by clamping image sample
    * coordinates instead of by tiling. This only affects 'draw'.
    *
    * FLAG_HIGH_QUALITY_SCALING: A hint as to whether this image should be
    * scaled using the high quality scaler. Do not set this if not drawing to
-   * a window or not listening to invalidations.
+   * a window or not listening to invalidations. Passing this flag will do two
+   * things: 1) request a decode of the image at the size asked for by the
+   * caller if one isn't already started or complete, and 2) allows a decoded
+   * frame of any size (it could be neither the requested size, nor the
+   * intrinsic size) to be substituted.
    *
    * FLAG_WANT_DATA_SURFACE: Can be passed to GetFrame when the caller wants a
    * DataSourceSurface instead of a hardware accelerated surface. This can be
    * important for performance (by avoiding an upload to/readback from the GPU)
    * when the caller knows they want a SourceSurface of type DATA.
    *
    * FLAG_BYPASS_SURFACE_CACHE: Forces drawing to happen rather than taking
    * cached rendering from the surface cache. This is used when we are printing,