| OLD | NEW |
| 1 /* | 1 /* |
| 2 * Copyright (c) 2006,2007,2008, Google Inc. All rights reserved. | 2 * Copyright (c) 2006,2007,2008, Google Inc. All rights reserved. |
| 3 * | 3 * |
| 4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
| 5 * modification, are permitted provided that the following conditions are | 5 * modification, are permitted provided that the following conditions are |
| 6 * met: | 6 * met: |
| 7 * | 7 * |
| 8 * * Redistributions of source code must retain the above copyright | 8 * * Redistributions of source code must retain the above copyright |
| 9 * notice, this list of conditions and the following disclaimer. | 9 * notice, this list of conditions and the following disclaimer. |
| 10 * * Redistributions in binary form must reproduce the above | 10 * * Redistributions in binary form must reproduce the above |
| (...skipping 20 matching lines...) Expand all Loading... |
| 31 // All of the functions in this file should move to new homes and this file shou
ld be deleted. | 31 // All of the functions in this file should move to new homes and this file shou
ld be deleted. |
| 32 | 32 |
| 33 #ifndef SkiaUtils_h | 33 #ifndef SkiaUtils_h |
| 34 #define SkiaUtils_h | 34 #define SkiaUtils_h |
| 35 | 35 |
| 36 #include "platform/PlatformExport.h" | 36 #include "platform/PlatformExport.h" |
| 37 #include "platform/graphics/GraphicsTypes.h" | 37 #include "platform/graphics/GraphicsTypes.h" |
| 38 #include "platform/graphics/Image.h" | 38 #include "platform/graphics/Image.h" |
| 39 #include "platform/transforms/AffineTransform.h" | 39 #include "platform/transforms/AffineTransform.h" |
| 40 #include "third_party/skia/include/core/SkCanvas.h" | 40 #include "third_party/skia/include/core/SkCanvas.h" |
| 41 #include "third_party/skia/include/core/SkRefCnt.h" | |
| 42 #include "wtf/MathExtras.h" | 41 #include "wtf/MathExtras.h" |
| 43 | 42 |
| 44 namespace blink { | 43 namespace blink { |
| 45 | 44 |
| 46 class GraphicsContext; | 45 class GraphicsContext; |
| 47 | 46 |
| 48 SkXfermode::Mode PLATFORM_EXPORT WebCoreCompositeToSkiaComposite(CompositeOperat
or, WebBlendMode = WebBlendModeNormal); | 47 SkXfermode::Mode PLATFORM_EXPORT WebCoreCompositeToSkiaComposite(CompositeOperat
or, WebBlendMode = WebBlendModeNormal); |
| 49 CompositeOperator PLATFORM_EXPORT compositeOperatorFromSkia(SkXfermode::Mode); | 48 CompositeOperator PLATFORM_EXPORT compositeOperatorFromSkia(SkXfermode::Mode); |
| 50 WebBlendMode PLATFORM_EXPORT blendModeFromSkia(SkXfermode::Mode); | 49 WebBlendMode PLATFORM_EXPORT blendModeFromSkia(SkXfermode::Mode); |
| 51 | 50 |
| (...skipping 68 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 120 void drawPlatformFocusRing(const PrimitiveType&, SkCanvas*, SkColor, int width); | 119 void drawPlatformFocusRing(const PrimitiveType&, SkCanvas*, SkColor, int width); |
| 121 | 120 |
| 122 // TODO(fmalita): remove in favor of direct SrcRectConstraint use. | 121 // TODO(fmalita): remove in favor of direct SrcRectConstraint use. |
| 123 inline SkCanvas::SrcRectConstraint WebCoreClampingModeToSkiaRectConstraint(Image
::ImageClampingMode clampMode) | 122 inline SkCanvas::SrcRectConstraint WebCoreClampingModeToSkiaRectConstraint(Image
::ImageClampingMode clampMode) |
| 124 { | 123 { |
| 125 return clampMode == Image::ClampImageToSourceRect | 124 return clampMode == Image::ClampImageToSourceRect |
| 126 ? SkCanvas::kStrict_SrcRectConstraint | 125 ? SkCanvas::kStrict_SrcRectConstraint |
| 127 : SkCanvas::kFast_SrcRectConstraint; | 126 : SkCanvas::kFast_SrcRectConstraint; |
| 128 } | 127 } |
| 129 | 128 |
| 130 | |
| 131 // Skia's smart pointer APIs are preferable over their legacy raw pointer counte
rparts. | |
| 132 // The following helpers ensure interoperability between Skia's SkRefCnt wrapper
sk_sp<T> and | |
| 133 // Blink's RefPtr<T>/PassRefPtr<T>. | |
| 134 // | |
| 135 // - adoptRef(sk_sp<T>): adopts an sk_sp rvalue into a PassRefPtr (to be
used when | |
| 136 // transferring ownership from Skia to Blink). | |
| 137 // - adoptSkSp(PassRefPtr<T>): adopts a PassRefPtr rvalue into a sk_sp (to be
used when | |
| 138 // transferring ownership from Blink to Skia). | |
| 139 // | |
| 140 // General guidelines | |
| 141 // | |
| 142 // When receiving ref counted objects from Skia: | |
| 143 // | |
| 144 // 1) use sk_sp-based Skia factories if available (e.g. SkShader::MakeFoo() in
stead of | |
| 145 // SkShader::CreateFoo()) | |
| 146 // | |
| 147 // 2) use sk_sp<T> locals for temporary objects (to be immediately transferred
back to Skia) | |
| 148 // | |
| 149 // 3) use RefPtr<T>/PassRefPtr<T> for objects to be retained in Blink, use | |
| 150 // adoptRef(sk_sp<T>) to convert | |
| 151 // | |
| 152 // When passing ref counted objects to Skia: | |
| 153 // | |
| 154 // 1) use sk_sk-based Skia APIs when available (e.g. SkPaint::setShader(sk_sp<
SkShader>) | |
| 155 // instead of SkPaint::setShader(SkShader*)) | |
| 156 // | |
| 157 // 2) if the object ownership is being passed to Skia, use std::move(sk_sp<T>)
or | |
| 158 // adoptSkSp(PassRefPtr<T>) to transfer without refcount churn | |
| 159 // | |
| 160 // 3) if the object ownership is shared with Skia (Blink retains a reference),
use | |
| 161 // sk_ref_sp(RefPtr<T>::get()) | |
| 162 // | |
| 163 // Example (creating a SkShader and setting it on SkPaint): | |
| 164 // | |
| 165 // a) legacy/old style | |
| 166 // | |
| 167 // RefPtr<SkShader> shader = adoptRef(SkShader::CreateFoo(...)); | |
| 168 // paint.setShader(shader.get()); | |
| 169 // | |
| 170 // (Note: the legacy approach introduces refcount churn as Skia grabs a ref whi
le Blink is | |
| 171 // temporarily holding on to its own) | |
| 172 // | |
| 173 // b) new style, ownership transferred | |
| 174 // | |
| 175 // // using Skia smart pointer locals | |
| 176 // sk_sp<SkShader> shader = SkShader::MakeFoo(...); | |
| 177 // paint.setShader(std::move(shader)); | |
| 178 // | |
| 179 // // using Blink smart pointer locals | |
| 180 // RefPtr<SkShader> shader = adoptRef(SkShader::MakeFoo(...)); | |
| 181 // paint.setShader(adoptSkSp(shader.release()); | |
| 182 // | |
| 183 // // using no locals | |
| 184 // paint.setShader(SkShader::MakeFoo(...)); | |
| 185 // | |
| 186 // c) new style, shared ownership | |
| 187 // | |
| 188 // RefPtr<SkShader> m_shader = adoptRef(SkShader::MakeFoo(...)); | |
| 189 // paint.setShader(adoptSkSp<SkShader>(m_shader)); | |
| 190 // | |
| 191 template <typename T> PassRefPtr<T> adoptRef(sk_sp<T> sp) | |
| 192 { | |
| 193 return adoptRef(sp.release()); | |
| 194 } | |
| 195 | |
| 196 template <typename T> sk_sp<T> adoptSkSp(PassRefPtr<T> ref) | |
| 197 { | |
| 198 return sk_sp<T>(ref.leakRef()); | |
| 199 } | |
| 200 | |
| 201 } // namespace blink | 129 } // namespace blink |
| 202 | 130 |
| 203 #endif // SkiaUtils_h | 131 #endif // SkiaUtils_h |
| OLD | NEW |