| OLD | NEW |
| (Empty) |
| 1 /* | |
| 2 * Copyright 2015 Google Inc. | |
| 3 * | |
| 4 * Use of this source code is governed by a BSD-style license that can be | |
| 5 * found in the LICENSE file. | |
| 6 */ | |
| 7 | |
| 8 #ifndef SkCodec_DEFINED | |
| 9 #define SkCodec_DEFINED | |
| 10 | |
| 11 #include "SkImageGenerator.h" | |
| 12 #include "SkImageInfo.h" | |
| 13 #include "SkSize.h" | |
| 14 #include "SkTemplates.h" | |
| 15 #include "SkTypes.h" | |
| 16 | |
| 17 class SkData; | |
| 18 class SkStream; | |
| 19 | |
| 20 /** | |
| 21 * Abstraction layer directly on top of an image codec. | |
| 22 */ | |
| 23 class SkCodec : public SkImageGenerator { | |
| 24 public: | |
| 25 /** | |
| 26 * If this stream represents an encoded image that we know how to decode, | |
| 27 * return an SkCodec that can decode it. Otherwise return NULL. | |
| 28 * | |
| 29 * If NULL is returned, the stream is deleted immediately. Otherwise, the | |
| 30 * SkCodec takes ownership of it, and will delete it when done with it. | |
| 31 */ | |
| 32 static SkCodec* NewFromStream(SkStream*); | |
| 33 | |
| 34 /** | |
| 35 * If this data represents an encoded image that we know how to decode, | |
| 36 * return an SkCodec that can decode it. Otherwise return NULL. | |
| 37 * | |
| 38 * Will take a ref if it returns a codec, else will not affect the data. | |
| 39 */ | |
| 40 static SkCodec* NewFromData(SkData*); | |
| 41 | |
| 42 /** | |
| 43 * Return a size that approximately supports the desired scale factor. | |
| 44 * The codec may not be able to scale efficiently to the exact scale | |
| 45 * factor requested, so return a size that approximates that scale. | |
| 46 * | |
| 47 * FIXME: Move to SkImageGenerator? | |
| 48 */ | |
| 49 SkISize getScaledDimensions(float desiredScale) const; | |
| 50 | |
| 51 protected: | |
| 52 SkCodec(const SkImageInfo&, SkStream*); | |
| 53 | |
| 54 /** | |
| 55 * The SkAlphaType is a conservative answer. i.e. it is possible that it | |
| 56 * initially returns a non-opaque answer, but completing the decode | |
| 57 * reveals that the image is actually opaque. | |
| 58 */ | |
| 59 bool onGetInfo(SkImageInfo* info) SK_OVERRIDE { | |
| 60 *info = fInfo; | |
| 61 return true; | |
| 62 } | |
| 63 | |
| 64 // Helper for subclasses. | |
| 65 const SkImageInfo& getOriginalInfo() { return fInfo; } | |
| 66 | |
| 67 virtual SkISize onGetScaledDimensions(float /* desiredScale */) const { | |
| 68 // By default, scaling is not supported. | |
| 69 return fInfo.dimensions(); | |
| 70 } | |
| 71 | |
| 72 /** | |
| 73 * If the stream was previously read, attempt to rewind. | |
| 74 * @returns: | |
| 75 * true | |
| 76 * - if the stream needed to be rewound, and the rewind | |
| 77 * succeeded. | |
| 78 * - if the stream did not need to be rewound. | |
| 79 * false | |
| 80 * - if the stream needed to be rewound, and rewind failed. | |
| 81 * Subclasses MUST call this function before reading the stream (e.g. in | |
| 82 * onGetPixels). If it returns false, onGetPixels should return | |
| 83 * kCouldNotRewind. | |
| 84 */ | |
| 85 bool SK_WARN_UNUSED_RESULT rewindIfNeeded(); | |
| 86 | |
| 87 private: | |
| 88 const SkImageInfo fInfo; | |
| 89 SkAutoTDelete<SkStream> fStream; | |
| 90 bool fNeedsRewind; | |
| 91 }; | |
| 92 #endif // SkCodec_DEFINED | |
| OLD | NEW |