/* * Copyright (C) 2014 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef RENDERNODEPROPERTIES_H #define RENDERNODEPROPERTIES_H #include #include #include #include #include #include #include #include #include #include "Animator.h" #include "Rect.h" #include "RevealClip.h" #include "Outline.h" #include "utils/MathUtils.h" class SkBitmap; class SkColorFilter; class SkPaint; namespace android { namespace uirenderer { class Matrix4; class RenderNode; class RenderProperties; // The __VA_ARGS__ will be executed if a & b are not equal #define RP_SET(a, b, ...) (a != b ? (a = b, ##__VA_ARGS__, true) : false) #define RP_SET_AND_DIRTY(a, b) RP_SET(a, b, mPrimitiveFields.mMatrixOrPivotDirty = true) // Keep in sync with View.java:LAYER_TYPE_* enum LayerType { kLayerTypeNone = 0, // Although we cannot build the software layer directly (must be done at // record time), this information is used when applying alpha. kLayerTypeSoftware = 1, kLayerTypeRenderLayer = 2, // TODO: LayerTypeSurfaceTexture? Maybe? }; class ANDROID_API LayerProperties { public: bool setType(LayerType type) { if (RP_SET(mType, type)) { reset(); return true; } return false; } LayerType type() const { return mType; } bool setOpaque(bool opaque) { return RP_SET(mOpaque, opaque); } bool opaque() const { return mOpaque; } bool setAlpha(uint8_t alpha) { return RP_SET(mAlpha, alpha); } uint8_t alpha() const { return mAlpha; } bool setXferMode(SkXfermode::Mode mode) { return RP_SET(mMode, mode); } SkXfermode::Mode xferMode() const { return mMode; } bool setColorFilter(SkColorFilter* filter); SkColorFilter* colorFilter() const { return mColorFilter; } // Sets alpha, xfermode, and colorfilter from an SkPaint // paint may be NULL, in which case defaults will be set bool setFromPaint(const SkPaint* paint); bool needsBlending() const { return !opaque() || alpha() < 255; } LayerProperties& operator=(const LayerProperties& other); private: LayerProperties(); ~LayerProperties(); void reset(); friend class RenderProperties; LayerType mType; // Whether or not that Layer's content is opaque, doesn't include alpha bool mOpaque; uint8_t mAlpha; SkXfermode::Mode mMode; SkColorFilter* mColorFilter; }; /* * Data structure that holds the properties for a RenderNode */ class ANDROID_API RenderProperties { public: RenderProperties(); virtual ~RenderProperties(); RenderProperties& operator=(const RenderProperties& other); bool setClipToBounds(bool clipToBounds) { return RP_SET(mPrimitiveFields.mClipToBounds, clipToBounds); } bool setProjectBackwards(bool shouldProject) { return RP_SET(mPrimitiveFields.mProjectBackwards, shouldProject); } bool setProjectionReceiver(bool shouldRecieve) { return RP_SET(mPrimitiveFields.mProjectionReceiver, shouldRecieve); } bool isProjectionReceiver() const { return mPrimitiveFields.mProjectionReceiver; } bool setStaticMatrix(const SkMatrix* matrix) { delete mStaticMatrix; if (matrix) { mStaticMatrix = new SkMatrix(*matrix); } else { mStaticMatrix = NULL; } return true; } // Can return NULL const SkMatrix* getStaticMatrix() const { return mStaticMatrix; } bool setAnimationMatrix(const SkMatrix* matrix) { delete mAnimationMatrix; if (matrix) { mAnimationMatrix = new SkMatrix(*matrix); } else { mAnimationMatrix = NULL; } return true; } bool setAlpha(float alpha) { alpha = fminf(1.0f, fmaxf(0.0f, alpha)); return RP_SET(mPrimitiveFields.mAlpha, alpha); } float getAlpha() const { return mPrimitiveFields.mAlpha; } bool setHasOverlappingRendering(bool hasOverlappingRendering) { return RP_SET(mPrimitiveFields.mHasOverlappingRendering, hasOverlappingRendering); } bool hasOverlappingRendering() const { return mPrimitiveFields.mHasOverlappingRendering; } bool setElevation(float elevation) { return RP_SET(mPrimitiveFields.mElevation, elevation); // Don't dirty matrix/pivot, since they don't respect Z } float getElevation() const { return mPrimitiveFields.mElevation; } bool setTranslationX(float translationX) { return RP_SET_AND_DIRTY(mPrimitiveFields.mTranslationX, translationX); } float getTranslationX() const { return mPrimitiveFields.mTranslationX; } bool setTranslationY(float translationY) { return RP_SET_AND_DIRTY(mPrimitiveFields.mTranslationY, translationY); } float getTranslationY() const { return mPrimitiveFields.mTranslationY; } bool setTranslationZ(float translationZ) { return RP_SET(mPrimitiveFields.mTranslationZ, translationZ); // mMatrixOrPivotDirty not set, since matrix doesn't respect Z } float getTranslationZ() const { return mPrimitiveFields.mTranslationZ; } // Animation helper bool setX(float value) { return setTranslationX(value - getLeft()); } // Animation helper float getX() const { return getLeft() + getTranslationX(); } // Animation helper bool setY(float value) { return setTranslationY(value - getTop()); } // Animation helper float getY() const { return getTop() + getTranslationY(); } // Animation helper bool setZ(float value) { return setTranslationZ(value - getElevation()); } float getZ() const { return getElevation() + getTranslationZ(); } bool setRotation(float rotation) { return RP_SET_AND_DIRTY(mPrimitiveFields.mRotation, rotation); } float getRotation() const { return mPrimitiveFields.mRotation; } bool setRotationX(float rotationX) { return RP_SET_AND_DIRTY(mPrimitiveFields.mRotationX, rotationX); } float getRotationX() const { return mPrimitiveFields.mRotationX; } bool setRotationY(float rotationY) { return RP_SET_AND_DIRTY(mPrimitiveFields.mRotationY, rotationY); } float getRotationY() const { return mPrimitiveFields.mRotationY; } bool setScaleX(float scaleX) { LOG_ALWAYS_FATAL_IF(scaleX > 1000000, "invalid scaleX %e", scaleX); return RP_SET_AND_DIRTY(mPrimitiveFields.mScaleX, scaleX); } float getScaleX() const { return mPrimitiveFields.mScaleX; } bool setScaleY(float scaleY) { LOG_ALWAYS_FATAL_IF(scaleY > 1000000, "invalid scaleY %e", scaleY); return RP_SET_AND_DIRTY(mPrimitiveFields.mScaleY, scaleY); } float getScaleY() const { return mPrimitiveFields.mScaleY; } bool setPivotX(float pivotX) { if (RP_SET(mPrimitiveFields.mPivotX, pivotX) || !mPrimitiveFields.mPivotExplicitlySet) { mPrimitiveFields.mMatrixOrPivotDirty = true; mPrimitiveFields.mPivotExplicitlySet = true; return true; } return false; } /* Note that getPivotX and getPivotY are adjusted by updateMatrix(), * so the value returned may be stale if the RenderProperties has been * modified since the last call to updateMatrix() */ float getPivotX() const { return mPrimitiveFields.mPivotX; } bool setPivotY(float pivotY) { if (RP_SET(mPrimitiveFields.mPivotY, pivotY) || !mPrimitiveFields.mPivotExplicitlySet) { mPrimitiveFields.mMatrixOrPivotDirty = true; mPrimitiveFields.mPivotExplicitlySet = true; return true; } return false; } float getPivotY() const { return mPrimitiveFields.mPivotY; } bool isPivotExplicitlySet() const { return mPrimitiveFields.mPivotExplicitlySet; } bool setCameraDistance(float distance) { if (distance != getCameraDistance()) { mPrimitiveFields.mMatrixOrPivotDirty = true; mComputedFields.mTransformCamera.setCameraLocation(0, 0, distance); return true; } return false; } float getCameraDistance() const { // TODO: update getCameraLocationZ() to be const return const_cast(&mComputedFields.mTransformCamera)->getCameraLocationZ(); } bool setLeft(int left) { if (RP_SET(mPrimitiveFields.mLeft, left)) { mPrimitiveFields.mWidth = mPrimitiveFields.mRight - mPrimitiveFields.mLeft; if (!mPrimitiveFields.mPivotExplicitlySet) { mPrimitiveFields.mMatrixOrPivotDirty = true; } return true; } return false; } float getLeft() const { return mPrimitiveFields.mLeft; } bool setTop(int top) { if (RP_SET(mPrimitiveFields.mTop, top)) { mPrimitiveFields.mHeight = mPrimitiveFields.mBottom - mPrimitiveFields.mTop; if (!mPrimitiveFields.mPivotExplicitlySet) { mPrimitiveFields.mMatrixOrPivotDirty = true; } return true; } return false; } float getTop() const { return mPrimitiveFields.mTop; } bool setRight(int right) { if (RP_SET(mPrimitiveFields.mRight, right)) { mPrimitiveFields.mWidth = mPrimitiveFields.mRight - mPrimitiveFields.mLeft; if (!mPrimitiveFields.mPivotExplicitlySet) { mPrimitiveFields.mMatrixOrPivotDirty = true; } return true; } return false; } float getRight() const { return mPrimitiveFields.mRight; } bool setBottom(int bottom) { if (RP_SET(mPrimitiveFields.mBottom, bottom)) { mPrimitiveFields.mHeight = mPrimitiveFields.mBottom - mPrimitiveFields.mTop; if (!mPrimitiveFields.mPivotExplicitlySet) { mPrimitiveFields.mMatrixOrPivotDirty = true; } return true; } return false; } float getBottom() const { return mPrimitiveFields.mBottom; } bool setLeftTop(int left, int top) { bool leftResult = setLeft(left); bool topResult = setTop(top); return leftResult || topResult; } bool setLeftTopRightBottom(int left, int top, int right, int bottom) { if (left != mPrimitiveFields.mLeft || top != mPrimitiveFields.mTop || right != mPrimitiveFields.mRight || bottom != mPrimitiveFields.mBottom) { mPrimitiveFields.mLeft = left; mPrimitiveFields.mTop = top; mPrimitiveFields.mRight = right; mPrimitiveFields.mBottom = bottom; mPrimitiveFields.mWidth = mPrimitiveFields.mRight - mPrimitiveFields.mLeft; mPrimitiveFields.mHeight = mPrimitiveFields.mBottom - mPrimitiveFields.mTop; if (!mPrimitiveFields.mPivotExplicitlySet) { mPrimitiveFields.mMatrixOrPivotDirty = true; } return true; } return false; } bool offsetLeftRight(float offset) { if (offset != 0) { mPrimitiveFields.mLeft += offset; mPrimitiveFields.mRight += offset; return true; } return false; } bool offsetTopBottom(float offset) { if (offset != 0) { mPrimitiveFields.mTop += offset; mPrimitiveFields.mBottom += offset; return true; } return false; } int getWidth() const { return mPrimitiveFields.mWidth; } int getHeight() const { return mPrimitiveFields.mHeight; } const SkMatrix* getAnimationMatrix() const { return mAnimationMatrix; } bool hasTransformMatrix() const { return getTransformMatrix() && !getTransformMatrix()->isIdentity(); } // May only call this if hasTransformMatrix() is true bool isTransformTranslateOnly() const { return getTransformMatrix()->getType() == SkMatrix::kTranslate_Mask; } const SkMatrix* getTransformMatrix() const { LOG_ALWAYS_FATAL_IF(mPrimitiveFields.mMatrixOrPivotDirty, "Cannot get a dirty matrix!"); return mComputedFields.mTransformMatrix; } bool getClipToBounds() const { return mPrimitiveFields.mClipToBounds; } bool getHasOverlappingRendering() const { return mPrimitiveFields.mHasOverlappingRendering; } const Outline& getOutline() const { return mPrimitiveFields.mOutline; } const RevealClip& getRevealClip() const { return mPrimitiveFields.mRevealClip; } bool getProjectBackwards() const { return mPrimitiveFields.mProjectBackwards; } void debugOutputProperties(const int level) const; void updateMatrix(); bool hasClippingPath() const { return mPrimitiveFields.mRevealClip.willClip(); } const SkPath* getClippingPath() const { return mPrimitiveFields.mRevealClip.getPath(); } SkRegion::Op getClippingPathOp() const { return mPrimitiveFields.mRevealClip.isInverseClip() ? SkRegion::kDifference_Op : SkRegion::kIntersect_Op; } Outline& mutableOutline() { return mPrimitiveFields.mOutline; } RevealClip& mutableRevealClip() { return mPrimitiveFields.mRevealClip; } const LayerProperties& layerProperties() const { return mLayerProperties; } LayerProperties& mutateLayerProperties() { return mLayerProperties; } // Returns true if damage calculations should be clipped to bounds // TODO: Figure out something better for getZ(), as children should still be // clipped to this RP's bounds. But as we will damage -INT_MAX to INT_MAX // for this RP's getZ() anyway, this can be optimized when we have a // Z damage estimate instead of INT_MAX bool getClipDamageToBounds() const { return getClipToBounds() && (getZ() <= 0 || getOutline().isEmpty()); } private: // Rendering properties struct PrimitiveFields { PrimitiveFields(); Outline mOutline; RevealClip mRevealClip; bool mClipToBounds; bool mProjectBackwards; bool mProjectionReceiver; float mAlpha; bool mHasOverlappingRendering; float mElevation; float mTranslationX, mTranslationY, mTranslationZ; float mRotation, mRotationX, mRotationY; float mScaleX, mScaleY; float mPivotX, mPivotY; int mLeft, mTop, mRight, mBottom; int mWidth, mHeight; bool mPivotExplicitlySet; bool mMatrixOrPivotDirty; } mPrimitiveFields; SkMatrix* mStaticMatrix; SkMatrix* mAnimationMatrix; LayerProperties mLayerProperties; /** * These fields are all generated from other properties and are not set directly. */ struct ComputedFields { ComputedFields(); ~ComputedFields(); /** * Stores the total transformation of the DisplayList based upon its scalar * translate/rotate/scale properties. * * In the common translation-only case, the matrix isn't necessarily allocated, * and the mTranslation properties are used directly. */ SkMatrix* mTransformMatrix; Sk3DView mTransformCamera; } mComputedFields; }; } /* namespace uirenderer */ } /* namespace android */ #endif /* RENDERNODEPROPERTIES_H */