michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: #ifndef MOZILLA_GFX_SCALE_H_
michael@0: #define MOZILLA_GFX_SCALE_H_
michael@0: 
michael@0: #include "Types.h"
michael@0: 
michael@0: namespace mozilla {
michael@0: namespace gfx {
michael@0: 
michael@0: /**
michael@0:  * Scale an image using a high-quality filter.
michael@0:  *
michael@0:  * Synchronously scales an image and writes the output to the destination in
michael@0:  * 32-bit format. The destination must be pre-allocated by the caller.
michael@0:  *
michael@0:  * Returns true if scaling was successful, and false otherwise. Currently, this
michael@0:  * function is implemented using Skia. If Skia is not enabled when building,
michael@0:  * calling this function will always return false.
michael@0:  *
michael@0:  * IMPLEMTATION NOTES:
michael@0:  * This API is not currently easily hardware acceleratable. A better API might
michael@0:  * take a SourceSurface and return a SourceSurface; the Direct2D backend, for
michael@0:  * example, could simply set a status bit on a copy of the image, and use
michael@0:  * Direct2D's high-quality scaler at draw time.
michael@0:  */
michael@0: GFX2D_API bool Scale(uint8_t* srcData, int32_t srcWidth, int32_t srcHeight, int32_t srcStride,
michael@0:                      uint8_t* dstData, int32_t dstWidth, int32_t dstHeight, int32_t dstStride,
michael@0:                      SurfaceFormat format);
michael@0: 
michael@0: }
michael@0: }
michael@0: 
michael@0: #endif /* MOZILLA_GFX_BLUR_H_ */