/* * Copyright (C) 2008 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. */ package android.graphics.drawable; import com.android.internal.R; import org.xmlpull.v1.XmlPullParser; import org.xmlpull.v1.XmlPullParserException; import android.annotation.NonNull; import android.content.res.Resources; import android.content.res.Resources.Theme; import android.content.res.TypedArray; import android.graphics.Insets; import android.graphics.Outline; import android.graphics.PixelFormat; import android.graphics.Rect; import android.util.AttributeSet; import java.io.IOException; /** * A Drawable that insets another Drawable by a specified distance. * This is used when a View needs a background that is smaller than * the View's actual bounds. * *

It can be defined in an XML file with the <inset> element. For more * information, see the guide to Drawable Resources.

* * @attr ref android.R.styleable#InsetDrawable_visible * @attr ref android.R.styleable#InsetDrawable_drawable * @attr ref android.R.styleable#InsetDrawable_insetLeft * @attr ref android.R.styleable#InsetDrawable_insetRight * @attr ref android.R.styleable#InsetDrawable_insetTop * @attr ref android.R.styleable#InsetDrawable_insetBottom */ public class InsetDrawable extends DrawableWrapper { private final Rect mTmpRect = new Rect(); private InsetState mState; /** * No-arg constructor used by drawable inflation. */ InsetDrawable() { this(new InsetState(null), null); } /** * Creates a new inset drawable with the specified inset. * * @param drawable The drawable to inset. * @param inset Inset in pixels around the drawable. */ public InsetDrawable(Drawable drawable, int inset) { this(drawable, inset, inset, inset, inset); } /** * Creates a new inset drawable with the specified insets. * * @param drawable The drawable to inset. * @param insetLeft Left inset in pixels. * @param insetTop Top inset in pixels. * @param insetRight Right inset in pixels. * @param insetBottom Bottom inset in pixels. */ public InsetDrawable(Drawable drawable, int insetLeft, int insetTop,int insetRight, int insetBottom) { this(new InsetState(null), null); mState.mInsetLeft = insetLeft; mState.mInsetTop = insetTop; mState.mInsetRight = insetRight; mState.mInsetBottom = insetBottom; setDrawable(drawable); } @Override public void inflate(Resources r, XmlPullParser parser, AttributeSet attrs, Theme theme) throws XmlPullParserException, IOException { super.inflate(r, parser, attrs, theme); final TypedArray a = obtainAttributes(r, theme, attrs, R.styleable.InsetDrawable); updateStateFromTypedArray(a); inflateChildDrawable(r, parser, attrs, theme); verifyRequiredAttributes(a); a.recycle(); } private void verifyRequiredAttributes(TypedArray a) throws XmlPullParserException { // If we're not waiting on a theme, verify required attributes. if (getDrawable() == null && (mState.mThemeAttrs == null || mState.mThemeAttrs[R.styleable.InsetDrawable_drawable] == 0)) { throw new XmlPullParserException(a.getPositionDescription() + ": tag requires a 'drawable' attribute or " + "child tag defining a drawable"); } } @Override void updateStateFromTypedArray(TypedArray a) { super.updateStateFromTypedArray(a); final InsetState state = mState; final int N = a.getIndexCount(); for (int i = 0; i < N; i++) { final int attr = a.getIndex(i); switch (attr) { case R.styleable.InsetDrawable_drawable: final Drawable dr = a.getDrawable(attr); if (dr != null) { setDrawable(dr); } break; case R.styleable.InsetDrawable_inset: final int inset = a.getDimensionPixelOffset(attr, Integer.MIN_VALUE); if (inset != Integer.MIN_VALUE) { state.mInsetLeft = inset; state.mInsetTop = inset; state.mInsetRight = inset; state.mInsetBottom = inset; } break; case R.styleable.InsetDrawable_insetLeft: state.mInsetLeft = a.getDimensionPixelOffset(attr, state.mInsetLeft); break; case R.styleable.InsetDrawable_insetTop: state.mInsetTop = a.getDimensionPixelOffset(attr, state.mInsetTop); break; case R.styleable.InsetDrawable_insetRight: state.mInsetRight = a.getDimensionPixelOffset(attr, state.mInsetRight); break; case R.styleable.InsetDrawable_insetBottom: state.mInsetBottom = a.getDimensionPixelOffset(attr, state.mInsetBottom); break; } } } @Override public void applyTheme(Theme t) { final InsetState state = mState; if (state == null) { return; } if (state.mThemeAttrs != null) { final TypedArray a = t.resolveAttributes(state.mThemeAttrs, R.styleable.InsetDrawable); try { updateStateFromTypedArray(a); verifyRequiredAttributes(a); } catch (XmlPullParserException e) { throw new RuntimeException(e); } finally { a.recycle(); } } // The drawable may have changed as a result of applying the theme, so // apply the theme to the wrapped drawable last. super.applyTheme(t); } @Override public boolean getPadding(Rect padding) { final boolean pad = super.getPadding(padding); padding.left += mState.mInsetLeft; padding.right += mState.mInsetRight; padding.top += mState.mInsetTop; padding.bottom += mState.mInsetBottom; return pad || (mState.mInsetLeft | mState.mInsetRight | mState.mInsetTop | mState.mInsetBottom) != 0; } /** @hide */ @Override public Insets getOpticalInsets() { final Insets contentInsets = super.getOpticalInsets(); return Insets.of(contentInsets.left + mState.mInsetLeft, contentInsets.top + mState.mInsetTop, contentInsets.right + mState.mInsetRight, contentInsets.bottom + mState.mInsetBottom); } @Override public int getOpacity() { final InsetState state = mState; final int opacity = getDrawable().getOpacity(); if (opacity == PixelFormat.OPAQUE && (state.mInsetLeft > 0 || state.mInsetTop > 0 || state.mInsetRight > 0 || state.mInsetBottom > 0)) { return PixelFormat.TRANSLUCENT; } return opacity; } @Override protected void onBoundsChange(Rect bounds) { final Rect r = mTmpRect; r.set(bounds); r.left += mState.mInsetLeft; r.top += mState.mInsetTop; r.right -= mState.mInsetRight; r.bottom -= mState.mInsetBottom; // Apply inset bounds to the wrapped drawable. super.onBoundsChange(r); } @Override public int getIntrinsicWidth() { return getDrawable().getIntrinsicWidth() + mState.mInsetLeft + mState.mInsetRight; } @Override public int getIntrinsicHeight() { return getDrawable().getIntrinsicHeight() + mState.mInsetTop + mState.mInsetBottom; } @Override public void getOutline(@NonNull Outline outline) { getDrawable().getOutline(outline); } @Override DrawableWrapperState mutateConstantState() { mState = new InsetState(mState); return mState; } static final class InsetState extends DrawableWrapper.DrawableWrapperState { int mInsetLeft = 0; int mInsetTop = 0; int mInsetRight = 0; int mInsetBottom = 0; InsetState(InsetState orig) { super(orig); if (orig != null) { mInsetLeft = orig.mInsetLeft; mInsetTop = orig.mInsetTop; mInsetRight = orig.mInsetRight; mInsetBottom = orig.mInsetBottom; } } @Override public Drawable newDrawable(Resources res) { return new InsetDrawable(this, res); } } /** * The one constructor to rule them all. This is called by all public * constructors to set the state and initialize local properties. */ private InsetDrawable(InsetState state, Resources res) { super(state, res); mState = state; } }