class GrDirectContext; class GrRecordingContext; class SkBitmap; class SkColorSpace; class SkData; class SkImage; class SkImageFilter; class SkImageGenerator; class SkMatrix; class SkMipmap; class SkPaint; class SkPicture; class SkPixmap; class SkShader; class SkSurfaceProps; enum SkColorType : int; enumclass SkTextureCompressionType; enumclass SkTileMode;
struct SkIPoint; struct SkSamplingOptions;
namespace skgpu::graphite { class Recorder; }
namespace SkImages {
/** Caller data passed to RasterReleaseProc; may be nullptr. */ using ReleaseContext = void*; /** Function called when SkImage no longer shares pixels. ReleaseContext is provided by caller when SkImage is created, and may be nullptr.
*/ using RasterReleaseProc = void(constvoid* pixels, ReleaseContext);
/** Creates a CPU-backed SkImage from bitmap, sharing or copying bitmap pixels. If the bitmap is marked immutable, and its pixel memory is shareable, it may be shared instead of copied.
SkImage is returned if bitmap is valid. Valid SkBitmap parameters include: dimensions are greater than zero; each dimension fits in 29 bits; SkColorType and SkAlphaType are valid, and SkColorType is not kUnknown_SkColorType; row bytes are large enough to hold one row of pixels; pixel address is not nullptr.
@param bitmap SkImageInfo, row bytes, and pixels @return created SkImage, or nullptr
*/
SK_API sk_sp<SkImage> RasterFromBitmap(const SkBitmap& bitmap);
/** Creates a CPU-backed SkImage from compressed data.
This method will decompress the compressed data and create an image wrapping it. Any mipmap levels present in the compressed data are discarded.
@param data compressed data to store in SkImage @param width width of full SkImage @param height height of full SkImage @param type type of compression used @return created SkImage, or nullptr
*/
SK_API sk_sp<SkImage> RasterFromCompressedTextureData(sk_sp<SkData> data, int width, int height,
SkTextureCompressionType type);
/** * Return a SkImage using the encoded data, but attempts to defer decoding until the * image is actually used/drawn. This deferral allows the system to cache the result, either on the * CPU or on the GPU, depending on where the image is drawn. If memory is low, the cache may * be purged, causing the next draw of the image to have to re-decode. * * If alphaType is nullopt, the image's alpha type will be chosen automatically based on the * image format. Transparent images will default to kPremul_SkAlphaType. If alphaType contains * kPremul_SkAlphaType or kUnpremul_SkAlphaType, that alpha type will be used. Forcing opaque * (passing kOpaque_SkAlphaType) is not allowed, and will return nullptr. * * If the encoded format is not supported, nullptr is returned. * * If possible, clients should use SkCodecs::DeferredImage instead. * * @param encoded the encoded data * @return created SkImage, or nullptr
/** Creates SkImage from data returned by imageGenerator. The image data will not be created (on either the CPU or GPU) until the image is actually drawn. Generated data is owned by SkImage and may not be shared or accessed.
SkImage is returned if generator data is valid. Valid data parameters vary by type of data and platform.
imageGenerator may wrap SkPicture data, codec data, or custom data.
@param imageGenerator stock or custom routines to retrieve SkImage @return created SkImage, or nullptr
*/
SK_API sk_sp<SkImage> DeferredFromGenerator(std::unique_ptr<SkImageGenerator> imageGenerator);
enumclass BitDepth {
kU8, //!< uses 8-bit unsigned int per color component
kF16, //!< uses 16-bit float per color component
};
/** Creates SkImage from picture. Returned SkImage width and height are set by dimensions. SkImage draws picture with matrix and paint, set to bitDepth and colorSpace.
The Picture data is not turned into an image (CPU or GPU) until it is drawn.
If matrix is nullptr, draws with identity SkMatrix. If paint is nullptr, draws with default SkPaint. colorSpace may be nullptr.
@param picture stream of drawing commands @param dimensions width and height @param matrix SkMatrix to rotate, scale, translate, and so on; may be nullptr @param paint SkPaint to apply transparency, filtering, and so on; may be nullptr @param bitDepth 8-bit integer or 16-bit float: per component @param colorSpace range of colors; may be nullptr @param props props to use when rasterizing the picture @return created SkImage, or nullptr
*/
SK_API sk_sp<SkImage> DeferredFromPicture(sk_sp<SkPicture> picture, const SkISize& dimensions, const SkMatrix* matrix, const SkPaint* paint,
BitDepth bitDepth,
sk_sp<SkColorSpace> colorSpace,
SkSurfaceProps props);
SK_API sk_sp<SkImage> DeferredFromPicture(sk_sp<SkPicture> picture, const SkISize& dimensions, const SkMatrix* matrix, const SkPaint* paint,
BitDepth bitDepth,
sk_sp<SkColorSpace> colorSpace);
/** Creates a CPU-backed SkImage from pixmap, copying the pixel data. As a result, pixmap pixels may be modified or deleted without affecting SkImage.
SkImage is returned if SkPixmap is valid. Valid SkPixmap parameters include: dimensions are greater than zero; each dimension fits in 29 bits; SkColorType and SkAlphaType are valid, and SkColorType is not kUnknown_SkColorType; row bytes are large enough to hold one row of pixels; pixel address is not nullptr.
@param pixmap SkImageInfo, pixel address, and row bytes @return copy of SkPixmap pixels, or nullptr
/** Creates CPU-backed SkImage from pixmap, sharing SkPixmap pixels. Pixels must remain valid and unchanged until rasterReleaseProc is called. rasterReleaseProc is passed releaseContext when SkImage is deleted or no longer refers to pixmap pixels.
Pass nullptr for rasterReleaseProc to share SkPixmap without requiring a callback when SkImage is released. Pass nullptr for releaseContext if rasterReleaseProc does not require state.
SkImage is returned if pixmap is valid. Valid SkPixmap parameters include: dimensions are greater than zero; each dimension fits in 29 bits; SkColorType and SkAlphaType are valid, and SkColorType is not kUnknown_SkColorType; row bytes are large enough to hold one row of pixels; pixel address is not nullptr.
@param pixmap SkImageInfo, pixel address, and row bytes @param rasterReleaseProc function called when pixels can be released; or nullptr @param releaseContext state passed to rasterReleaseProc; or nullptr @return SkImage sharing pixmap
*/
SK_API sk_sp<SkImage> RasterFromPixmap(const SkPixmap& pixmap,
RasterReleaseProc rasterReleaseProc,
ReleaseContext releaseContext);
/** Creates CPU-backed SkImage from pixel data described by info. The pixels data will *not* be copied.
SkImage is returned if SkImageInfo is valid. Valid SkImageInfo parameters include: dimensions are greater than zero; each dimension fits in 29 bits; SkColorType and SkAlphaType are valid, and SkColorType is not kUnknown_SkColorType; rowBytes are large enough to hold one row of pixels; pixels is not nullptr, and contains enough data for SkImage.
@param info contains width, height, SkAlphaType, SkColorType, SkColorSpace @param pixels address or pixel storage @param rowBytes size of pixel row or larger @return SkImage sharing pixels, or nullptr
*/
SK_API sk_sp<SkImage> RasterFromData(const SkImageInfo& info,
sk_sp<SkData> pixels,
size_t rowBytes);
/** Creates a filtered SkImage on the CPU. filter processes the src image, potentially changing the color, position, and size. subset is the bounds of src that are processed by filter. clipBounds is the expected bounds of the filtered SkImage. outSubset is required storage for the actual bounds of the filtered SkImage. offset is required storage for translation of returned SkImage.
Returns nullptr a filtered result could not be created. If nullptr is returned, outSubset and offset are undefined.
Useful for animation of SkImageFilter that varies size from frame to frame. outSubset describes the valid bounds of returned image. offset translates the returned SkImage to keep subsequent animation frames aligned with respect to each other.
@param src the image to be filtered @param filter the image filter to be applied @param subset bounds of SkImage processed by filter @param clipBounds expected bounds of filtered SkImage @param outSubset storage for returned SkImage bounds @param offset storage for returned SkImage translation @return filtered SkImage, or nullptr
*/
SK_API sk_sp<SkImage> MakeWithFilter(sk_sp<SkImage> src, const SkImageFilter* filter, const SkIRect& subset, const SkIRect& clipBounds,
SkIRect* outSubset,
SkIPoint* offset);
} // namespace SkImages
/** \class SkImage SkImage describes a two dimensional array of pixels to draw. The pixels may be decoded in a raster bitmap, encoded in a SkPicture or compressed data stream, or located in GPU memory as a GPU texture.
SkImage cannot be modified after it is created. SkImage may allocate additional storage as needed; for instance, an encoded SkImage may decode when drawn.
SkImage width and height are greater than zero. Creating an SkImage with zero width or height returns SkImage equal to nullptr.
SkImage may be created from SkBitmap, SkPixmap, SkSurface, SkPicture, encoded streams, GPU texture, YUV_ColorSpace data, or hardware buffer. Encoded streams supported include BMP, GIF, HEIF, ICO, JPEG, PNG, WBMP, WebP. Supported encoding details vary with platform.
See SkImages namespace for the static factory methods to make SkImages.
Clients should *not* subclass SkImage as there is a lot of internal machinery that is not publicly accessible.
*/ class SK_API SkImage : public SkRefCnt { public: /** Returns a SkImageInfo describing the width, height, color type, alpha type, and color space of the SkImage.
@return image info of SkImage.
*/ const SkImageInfo& imageInfo() const { return fInfo; }
/** Returns pixel count in each row.
@return pixel width in SkImage
*/ int width() const { return fInfo.width(); }
/** Returns pixel row count.
@return pixel height in SkImage
*/ int height() const { return fInfo.height(); }
/** Returns SkISize { width(), height() }.
@return integral size of width() and height()
*/
SkISize dimensions() const { return SkISize::Make(fInfo.width(), fInfo.height()); }
/** Returns SkIRect { 0, 0, width(), height() }.
@return integral rectangle from origin to width() and height()
*/
SkIRect bounds() const { return SkIRect::MakeWH(fInfo.width(), fInfo.height()); }
/** Returns value unique to image. SkImage contents cannot change after SkImage is created. Any operation to create a new SkImage will receive generate a new unique number.
/** Returns SkColorSpace, the range of colors, associated with SkImage. The reference count of SkColorSpace is unchanged. The returned SkColorSpace is immutable.
SkColorSpace returned was passed to an SkImage constructor, or was parsed from encoded data. SkColorSpace returned may be ignored when SkImage is drawn, depending on the capabilities of the SkSurface receiving the drawing.
/** Returns a smart pointer to SkColorSpace, the range of colors, associated with SkImage. The smart pointer tracks the number of objects sharing this SkColorSpace reference so the memory is released when the owners destruct.
The returned SkColorSpace is immutable.
SkColorSpace returned was passed to an SkImage constructor, or was parsed from encoded data. SkColorSpace returned may be ignored when SkImage is drawn, depending on the capabilities of the SkSurface receiving the drawing.
@return SkColorSpace in SkImage, or nullptr, wrapped in a smart pointer
/** Returns true if pixels ignore their alpha value and are treated as fully opaque.
@return true if SkAlphaType is kOpaque_SkAlphaType
*/ bool isOpaque() const { return SkAlphaTypeIsOpaque(this->alphaType()); }
/** * Make a shader with the specified tiling and mipmap sampling.
*/
sk_sp<SkShader> makeShader(SkTileMode tmx, SkTileMode tmy, const SkSamplingOptions&, const SkMatrix* localMatrix = nullptr) const;
sk_sp<SkShader> makeShader(SkTileMode tmx, SkTileMode tmy, const SkSamplingOptions& sampling, const SkMatrix& lm) const; /** Defaults to clamp in both X and Y. */
sk_sp<SkShader> makeShader(const SkSamplingOptions& sampling, const SkMatrix& lm) const;
sk_sp<SkShader> makeShader(const SkSamplingOptions& sampling, const SkMatrix* lm = nullptr) const;
/** * makeRawShader functions like makeShader, but for images that contain non-color data. * This includes images encoding things like normals, material properties (eg, roughness), * heightmaps, or any other purely mathematical data that happens to be stored in an image. * These types of images are useful with some programmable shaders (see: SkRuntimeEffect). * * Raw image shaders work like regular image shaders (including filtering and tiling), with * a few major differences: * - No color space transformation is ever applied (the color space of the image is ignored). * - Images with an alpha type of kUnpremul are *not* automatically premultiplied. * - Bicubic filtering is not supported. If SkSamplingOptions::useCubic is true, these * factories will return nullptr.
*/
sk_sp<SkShader> makeRawShader(SkTileMode tmx, SkTileMode tmy, const SkSamplingOptions&, const SkMatrix* localMatrix = nullptr) const;
sk_sp<SkShader> makeRawShader(SkTileMode tmx, SkTileMode tmy, const SkSamplingOptions& sampling, const SkMatrix& lm) const; /** Defaults to clamp in both X and Y. */
sk_sp<SkShader> makeRawShader(const SkSamplingOptions& sampling, const SkMatrix& ;lm) const;
sk_sp<SkShader> makeRawShader(const SkSamplingOptions& sampling, const SkMatrix* lm = nullptr) const;
/** Copies SkImage pixel address, row bytes, and SkImageInfo to pixmap, if address is available, and returns true. If pixel address is not available, return false and leave pixmap unchanged.
@param pixmap storage for pixel state if pixels are readable; otherwise, ignored @return true if SkImage has direct access to pixels
/** Returns an approximation of the amount of texture memory used by the image. Returns zero if the image is not texture backed or if the texture has an external format.
*/ virtual size_t textureSize() const = 0;
/** Returns true if SkImage can be drawn on either raster surface or GPU surface. If context is nullptr, tests if SkImage draws on raster surface; otherwise, tests if SkImage draws on GPU surface associated with context.
SkImage backed by GPU texture may become invalid if associated context is invalid. lazy image may be invalid and may not draw to raster surface or GPU surface or both.
@param context GPU context @return true if SkImage can be drawn
/** \enum SkImage::CachingHint CachingHint selects whether Skia may internally cache SkBitmap generated by decoding SkImage, or by copying SkImage from GPU to CPU. The default behavior allows caching SkBitmap.
Choose kDisallow_CachingHint if SkImage pixels are to be used only once, or if SkImage pixels reside in a cache outside of Skia, or to reduce memory pressure.
Choosing kAllow_CachingHint does not ensure that pixels will be cached. SkImage pixels may not be cached if memory requirements are too large or pixels are not accessible.
*/ enum CachingHint {
kAllow_CachingHint, //!< allows internally caching decoded and copied pixels
kDisallow_CachingHint, //!< disallows internally caching decoded and copied pixels
};
/** Copies SkRect of pixels from SkImage to dstPixels. Copy starts at offset (srcX, srcY), and does not exceed SkImage (width(), height()).
Graphite has deprecated this API in favor of the equivalent asynchronous API on skgpu::graphite::Context (with an optional explicit synchonization).
dstInfo specifies width, height, SkColorType, SkAlphaType, and SkColorSpace of destination. dstRowBytes specifies the gap from one destination row to the next. Returns true if pixels are copied. Returns false if: - dstInfo.addr() equals nullptr - dstRowBytes is less than dstInfo.minRowBytes() - SkPixelRef is nullptr
Pixels are copied only if pixel conversion is possible. If SkImage SkColorType is kGray_8_SkColorType, or kAlpha_8_SkColorType; dstInfo.colorType() must match. If SkImage SkColorType is kGray_8_SkColorType, dstInfo.colorSpace() must match. If SkImage SkAlphaType is kOpaque_SkAlphaType, dstInfo.alphaType() must match. If SkImage SkColorSpace is nullptr, dstInfo.colorSpace() must match. Returns false if pixel conversion is not possible.
srcX and srcY may be negative to copy only top or left of source. Returns false if width() or height() is zero or negative. Returns false if abs(srcX) >= Image width(), or if abs(srcY) >= Image height().
If cachingHint is kAllow_CachingHint, pixels may be retained locally. If cachingHint is kDisallow_CachingHint, pixels are not added to the local cache.
@param context the GrDirectContext in play, if it exists @param dstInfo destination width, height, SkColorType, SkAlphaType, SkColorSpace @param dstPixels destination pixel storage @param dstRowBytes destination row length @param srcX column index whose absolute value is less than width() @param srcY row index whose absolute value is less than height() @param cachingHint whether the pixels should be cached locally @return true if pixels are copied to dstPixels
*/ bool readPixels(GrDirectContext* context, const SkImageInfo& dstInfo, void* dstPixels,
size_t dstRowBytes, int srcX, int srcY,
CachingHint cachingHint = kAllow_CachingHint) const;
/** Copies a SkRect of pixels from SkImage to dst. Copy starts at (srcX, srcY), and does not exceed SkImage (width(), height()).
Graphite has deprecated this API in favor of the equivalent asynchronous API on skgpu::graphite::Context (with an optional explicit synchonization).
dst specifies width, height, SkColorType, SkAlphaType, SkColorSpace, pixel storage, and row bytes of destination. dst.rowBytes() specifics the gap from one destination row to the next. Returns true if pixels are copied. Returns false if: - dst pixel storage equals nullptr - dst.rowBytes is less than SkImageInfo::minRowBytes - SkPixelRef is nullptr
Pixels are copied only if pixel conversion is possible. If SkImage SkColorType is kGray_8_SkColorType, or kAlpha_8_SkColorType; dst.colorType() must match. If SkImage SkColorType is kGray_8_SkColorType, dst.colorSpace() must match. If SkImage SkAlphaType is kOpaque_SkAlphaType, dst.alphaType() must match. If SkImage SkColorSpace is nullptr, dst.colorSpace() must match. Returns false if pixel conversion is not possible.
srcX and srcY may be negative to copy only top or left of source. Returns false if width() or height() is zero or negative. Returns false if abs(srcX) >= Image width(), or if abs(srcY) >= Image height().
If cachingHint is kAllow_CachingHint, pixels may be retained locally. If cachingHint is kDisallow_CachingHint, pixels are not added to the local cache.
@param context the GrDirectContext in play, if it exists @param dst destination SkPixmap: SkImageInfo, pixels, row bytes @param srcX column index whose absolute value is less than width() @param srcY row index whose absolute value is less than height() @param cachingHint whether the pixels should be cached locallyZ @return true if pixels are copied to dst
*/ bool readPixels(GrDirectContext* context, const SkPixmap& dst, int srcX, int srcY,
CachingHint cachingHint = kAllow_CachingHint) const;
#ifndef SK_IMAGE_READ_PIXELS_DISABLE_LEGACY_API /** Deprecated. Use the variants that accept a GrDirectContext. */ bool readPixels(const SkImageInfo& dstInfo, void* dstPixels, size_t dstRowBytes, int srcX, int srcY, CachingHint cachingHint = kAllow_CachingHint) const; bool readPixels(const SkPixmap& dst, int srcX, int srcY,
CachingHint cachingHint = kAllow_CachingHint) const; #endif
/** The result from asyncRescaleAndReadPixels() or asyncRescaleAndReadPixelsYUV420(). */ class AsyncReadResult { public:
AsyncReadResult(const AsyncReadResult&) = delete;
AsyncReadResult(AsyncReadResult&&) = delete;
AsyncReadResult& operator=(const AsyncReadResult&) = delete;
AsyncReadResult& operator=(AsyncReadResult&&) = delete;
virtual ~AsyncReadResult() = default; /** Returns how many planes of data are in the result. e.g. 3 for YUV data. */ virtualint count() const = 0; /** Returns the raw pixel data for a given plane. * * It will be organized as per the dst SkImageInfo passed in to the async read call. * * Clients may wish to create an SkPixmap with this data using the dst SkImageInfo * and rowBytes(i).
*/ virtualconstvoid* data(int i) const = 0; /** Returns how many bytes correspond to a single row of image data */ virtual size_t rowBytes(int i) const = 0;
protected:
AsyncReadResult() = default;
};
/** Client-provided context that is passed to client-provided ReadPixelsContext. */ using ReadPixelsContext = void*;
/** Client-provided callback to asyncRescaleAndReadPixels() or asyncRescaleAndReadPixelsYUV420() that is called when read result is ready or on failure.
*/ using ReadPixelsCallback = void(ReadPixelsContext, std::unique_ptr<const AsyncReadResult>);
/** Makes image pixel data available to caller, possibly asynchronously. It can also rescale the image pixels.
Currently asynchronous reads are only supported in the Ganesh GPU backend and only when the underlying 3D API supports transfer buffers and CPU/GPU synchronization primitives. In all other cases this operates synchronously.
For the Graphite backend this API has been deprecated in favor of the equivalent API on skgpu::graphite::Context.
Data is read from the source sub-rectangle, is optionally converted to a linear gamma, is rescaled to the size indicated by 'info', is then converted to the color space, color type, and alpha type of 'info'. A 'srcRect' that is not contained by the bounds of the image causes failure.
When the pixel data is ready the caller's ReadPixelsCallback is called with a AsyncReadResult containing pixel data in the requested color type, alpha type, and color space. The AsyncReadResult will have count() == 1. Upon failure the callback is called with nullptr for AsyncReadResult. For a GPU image this flushes work but a submit must occur to guarantee a finite time before the callback is called.
The data is valid for the lifetime of AsyncReadResult with the exception that if the SkImage is GPU-backed the data is immediately invalidated if the context is abandoned or destroyed.
@param info info of the requested pixels @param srcRect subrectangle of image to read @param rescaleGamma controls whether rescaling is done in the image's gamma or whether the source data is transformed to a linear gamma before rescaling. @param rescaleMode controls the technique (and cost) of the rescaling @param callback function to call with result of the read @param context passed to callback
*/ void asyncRescaleAndReadPixels(const SkImageInfo& info, const SkIRect& srcRect,
RescaleGamma rescaleGamma,
RescaleMode rescaleMode,
ReadPixelsCallback callback,
ReadPixelsContext context) const;
/** Similar to asyncRescaleAndReadPixels but performs an additional conversion to YUV. The RGB->YUV conversion is controlled by 'yuvColorSpace'. The YUV data is returned as three planes ordered y, u, v. The u and v planes are half the width and height of the resized rectangle. The y, u, and v values are single bytes. Currently this fails if 'dstSize' width and height are not even. A 'srcRect' that is not contained by the bounds of the image causes failure.
When the pixel data is ready the caller's ReadPixelsCallback is called with a AsyncReadResult containing the planar data. The AsyncReadResult will have count() == 3. Upon failure the callback is called with nullptr for AsyncReadResult. For a GPU image this flushes work but a submit must occur to guarantee a finite time before the callback is called.
The data is valid for the lifetime of AsyncReadResult with the exception that if the SkImage is GPU-backed the data is immediately invalidated if the context is abandoned or destroyed.
@param yuvColorSpace The transformation from RGB to YUV. Applied to the resized image after it is converted to dstColorSpace. @param dstColorSpace The color space to convert the resized image to, after rescaling. @param srcRect The portion of the image to rescale and convert to YUV planes. @param dstSize The size to rescale srcRect to @param rescaleGamma controls whether rescaling is done in the image's gamma or whether the source data is transformed to a linear gamma before rescaling. @param rescaleMode controls the technique (and cost) of the rescaling @param callback function to call with the planar read result @param context passed to callback
*/ void asyncRescaleAndReadPixelsYUV420(SkYUVColorSpace yuvColorSpace,
sk_sp<SkColorSpace> dstColorSpace, const SkIRect& srcRect, const SkISize& dstSize,
RescaleGamma rescaleGamma,
RescaleMode rescaleMode,
ReadPixelsCallback callback,
ReadPixelsContext context) const;
/** * Identical to asyncRescaleAndReadPixelsYUV420 but a fourth plane is returned in the * AsyncReadResult passed to 'callback'. The fourth plane contains the alpha chanel at the * same full resolution as the Y plane.
*/ void asyncRescaleAndReadPixelsYUVA420(SkYUVColorSpace yuvColorSpace,
sk_sp<SkColorSpace> dstColorSpace, const SkIRect& srcRect, const SkISize& dstSize,
RescaleGamma rescaleGamma,
RescaleMode rescaleMode,
ReadPixelsCallback callback,
ReadPixelsContext context) const;
/** Copies SkImage to dst, scaling pixels to fit dst.width() and dst.height(), and converting pixels to match dst.colorType() and dst.alphaType(). Returns true if pixels are copied. Returns false if dst.addr() is nullptr, or dst.rowBytes() is less than dst SkImageInfo::minRowBytes.
Pixels are copied only if pixel conversion is possible. If SkImage SkColorType is kGray_8_SkColorType, or kAlpha_8_SkColorType; dst.colorType() must match. If SkImage SkColorType is kGray_8_SkColorType, dst.colorSpace() must match. If SkImage SkAlphaType is kOpaque_SkAlphaType, dst.alphaType() must match. If SkImage SkColorSpace is nullptr, dst.colorSpace() must match. Returns false if pixel conversion is not possible.
If cachingHint is kAllow_CachingHint, pixels may be retained locally. If cachingHint is kDisallow_CachingHint, pixels are not added to the local cache.
@param dst destination SkPixmap: SkImageInfo, pixels, row bytes @return true if pixels are scaled to fit dst
*/ bool scalePixels(const SkPixmap& dst, const SkSamplingOptions&,
CachingHint cachingHint = kAllow_CachingHint) const;
/** * Create a new image by copying this image and scaling to fit the ImageInfo's dimensions * and converting the pixels into the ImageInfo's ColorInfo. * This is done retaining the domain (backend) of the image (e.g. gpu, raster) * * The Recorder parameter is required if the original image was created on a graphite Recorder, * but must be nullptr if it was create in some other way (e.g. GrContext, raster, deferred). * * return nullptr if the requested ColorInfo is not supported, its dimesions are out of range, * or if the recorder is null on a graphite Image.
*/
sk_sp<SkImage> makeScaled(skgpu::graphite::Recorder*, const SkImageInfo&, const SkSamplingOptions&) const;
/** Returns encoded SkImage pixels as SkData, if SkImage was created from supported encoded stream format. Platform support for formats vary and may require building with one or more of: SK_ENCODE_JPEG, SK_ENCODE_PNG, SK_ENCODE_WEBP.
Returns nullptr if SkImage contents are not encoded.
Returns nullptr if any of the following are true: - Subset is empty - Subset is not contained inside the image's bounds - Pixels in the source image could not be read or copied - This image is texture-backed and the provided context is null or does not match the source image's context.
If the source image was texture-backed, the resulting image will be texture-backed also. Otherwise, the returned image will be raster-backed.
@param direct the GrDirectContext of the source image (nullptr is ok if the source image is not texture-backed). @param subset bounds of returned SkImage @return the subsetted image, or nullptr
Returns nullptr if any of the following are true: - Subset is empty - Subset is not contained inside the image's bounds - Pixels in the image could not be read or copied - This image is texture-backed and the provided context is null or does not match the source image's context.
If the source image was texture-backed, the resulting image will be texture-backed also. Otherwise, the returned image will be raster-backed.
@param recorder the recorder of the source image (nullptr is ok if the source image was texture-backed). @param subset bounds of returned SkImage @param RequiredProperties properties the returned SkImage must possess (e.g. mipmaps) @return the subsetted image, or nullptr
*/ virtual sk_sp<SkImage> makeSubset(skgpu::graphite::Recorder*, const SkIRect& subset,
RequiredProperties) const = 0;
/** * Returns true if the image has mipmap levels.
*/ bool hasMipmaps() const;
/** * Returns true if the image holds protected content.
*/ bool isProtected() const;
/** * Returns an image with the same "base" pixels as the this image, but with mipmap levels * automatically generated and attached.
*/
sk_sp<SkImage> withDefaultMipmaps() const;
/** Returns raster image or lazy image. Copies SkImage backed by GPU texture into CPU memory if needed. Returns original SkImage if decoded in raster bitmap, or if encoded in a stream.
Returns nullptr if backed by GPU texture and copy fails.
/** Returns raster image. Copies SkImage backed by GPU texture into CPU memory, or decodes SkImage from lazy image. Returns original SkImage if decoded in raster bitmap.
Returns nullptr if copy, decode, or pixel read fails.
If cachingHint is kAllow_CachingHint, pixels may be retained locally. If cachingHint is kDisallow_CachingHint, pixels are not added to the local cache.
/** Deprecated.
*/ enum LegacyBitmapMode {
kRO_LegacyBitmapMode, //!< returned bitmap is read-only and immutable
};
/** Deprecated. Creates raster SkBitmap with same pixels as SkImage. If legacyBitmapMode is kRO_LegacyBitmapMode, returned bitmap is read-only and immutable. Returns true if SkBitmap is stored in bitmap. Returns false and resets bitmap if SkBitmap write did not succeed.
@param bitmap storage for legacy SkBitmap @param legacyBitmapMode bitmap is read-only and immutable @return true if SkBitmap was created
*/ bool asLegacyBitmap(SkBitmap* bitmap,
LegacyBitmapMode legacyBitmapMode = kRO_LegacyBitmapMode) const;
/** Returns true if SkImage is backed by an image-generator or other service that creates and caches its pixels or texture on-demand.
/** Creates SkImage in target SkColorSpace. Returns nullptr if SkImage could not be created.
Returns original SkImage if it is in target SkColorSpace. Otherwise, converts pixels from SkImage SkColorSpace to target SkColorSpace. If SkImage colorSpace() returns nullptr, SkImage SkColorSpace is assumed to be sRGB.
If this image is texture-backed, the context parameter is required and must match the context of the source image.
@param direct The GrDirectContext in play, if it exists @param target SkColorSpace describing color range of returned SkImage @return created SkImage in target SkColorSpace
/** Creates SkImage in target SkColorSpace. Returns nullptr if SkImage could not be created.
Returns original SkImage if it is in target SkColorSpace. Otherwise, converts pixels from SkImage SkColorSpace to target SkColorSpace. If SkImage colorSpace() returns nullptr, SkImage SkColorSpace is assumed to be sRGB.
If this image is graphite-backed, the recorder parameter is required.
@param targetColorSpace SkColorSpace describing color range of returned SkImage @param recorder The Recorder in which to create the new image @param RequiredProperties properties the returned SkImage must possess (e.g. mipmaps) @return created SkImage in target SkColorSpace
*/ virtual sk_sp<SkImage> makeColorSpace(skgpu::graphite::Recorder*,
sk_sp<SkColorSpace> targetColorSpace,
RequiredProperties) const = 0;
/** Experimental. Creates SkImage in target SkColorType and SkColorSpace. Returns nullptr if SkImage could not be created.
Returns original SkImage if it is in target SkColorType and SkColorSpace.
If this image is texture-backed, the context parameter is required and must match the context of the source image.
@param direct The GrDirectContext in play, if it exists @param targetColorType SkColorType of returned SkImage @param targetColorSpace SkColorSpace of returned SkImage @return created SkImage in target SkColorType and SkColorSpace
*/ virtual sk_sp<SkImage> makeColorTypeAndColorSpace(GrDirectContext* direct,
SkColorType targetColorType,
sk_sp<SkColorSpace> targetCS) const = 0;
/** Experimental. Creates SkImage in target SkColorType and SkColorSpace. Returns nullptr if SkImage could not be created.
Returns original SkImage if it is in target SkColorType and SkColorSpace.
If this image is graphite-backed, the recorder parameter is required.
@param targetColorType SkColorType of returned SkImage @param targetColorSpace SkColorSpace of returned SkImage @param recorder The Recorder in which to create the new image @param RequiredProperties properties the returned SkImage must possess (e.g. mipmaps) @return created SkImage in target SkColorType and SkColorSpace
*/ virtual sk_sp<SkImage> makeColorTypeAndColorSpace(skgpu::graphite::Recorder*,
SkColorType targetColorType,
sk_sp<SkColorSpace> targetColorSpace,
RequiredProperties) const = 0;
/** Creates a new SkImage identical to this one, but with a different SkColorSpace. This does not convert the underlying pixel data, so the resulting image will draw differently.
*/
sk_sp<SkImage> reinterpretColorSpace(sk_sp<SkColorSpace> newColorSpace) const;
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.
