IT. Expert System.

public abstract class DisplayList
extends Object

• Field Summary

  Fields

  Modifier and Type	Field and Description
  static int	FLAG_CLIP_CHILDREN Flag used when calling HardwareCanvas.drawDisplayList(DisplayList, android.graphics.Rect, int) When this flag is set, draw operations lying outside of the bounds of the display list will be culled early.
  static int	STATUS_DONE Indicates that the display list is done drawing.
  static int	STATUS_DRAW Indicates that the display list needs another drawing pass.
  static int	STATUS_DREW Indicates that the display list performed GL drawing operations.
  static int	STATUS_INVOKE Indicates that the display list needs to re-execute its GL functors.

• Constructor Summary

  Constructors

  Constructor and Description
  DisplayList()

• Method Summary

  Methods

  Modifier and Type	Method and Description
  abstract void	clear() Clears additional resources held onto by this display list.
  abstract void	end() Ends the recording for this display list.
  abstract int	getSize() Return the amount of memory used by this display list.
  abstract void	invalidate() Invalidates the display list, indicating that it should be repopulated with new drawing commands prior to being used again.
  abstract boolean	isValid() Returns whether the display list is currently usable.
  abstract void	offsetLeftRight(int offset) Offsets the left and right values for the DisplayList
  abstract void	offsetTopBottom(int offset) Offsets the top and bottom values for the DisplayList
  abstract void	reset() Reset native resources.
  abstract void	setAlpha(float alpha) Sets the alpha value for the DisplayList
  abstract void	setAnimationMatrix(Matrix matrix) Set the Animation matrix on the DisplayList.
  abstract void	setBottom(int bottom) Sets the bottom value for the DisplayList
  abstract void	setCaching(boolean caching) Set the caching property on the DisplayList, which indicates whether the DisplayList holds a layer.
  abstract void	setCameraDistance(float distance) Sets the camera distance for the DisplayList
  abstract void	setClipChildren(boolean clipChildren) Set whether the DisplayList should clip itself to its bounds.
  abstract void	setHasOverlappingRendering(boolean hasOverlappingRendering) Sets whether the DisplayList renders content which overlaps.
  abstract void	setLeft(int left) Sets the left value for the DisplayList
  abstract void	setLeftTop(int left, int top) Sets the left and top values for the DisplayList
  abstract void	setLeftTopRightBottom(int left, int top, int right, int bottom) Sets the left and top values for the DisplayList
  abstract void	setPivotX(float pivotX) Sets the pivotX value for the DisplayList
  abstract void	setPivotY(float pivotY) Sets the pivotY value for the DisplayList
  abstract void	setRight(int right) Sets the right value for the DisplayList
  abstract void	setRotation(float rotation) Sets the rotation value for the DisplayList
  abstract void	setRotationX(float rotationX) Sets the rotationX value for the DisplayList
  abstract void	setRotationY(float rotationY) Sets the rotationY value for the DisplayList
  abstract void	setScaleX(float scaleX) Sets the scaleX value for the DisplayList
  abstract void	setScaleY(float scaleY) Sets the scaleY value for the DisplayList
  abstract void	setStaticMatrix(Matrix matrix) Set the static matrix on the DisplayList.
  abstract void	setTop(int top) Sets the top value for the DisplayList
  abstract void	setTransformationInfo(float alpha, float translationX, float translationY, float rotation, float rotationX, float rotationY, float scaleX, float scaleY) Sets all of the transform-related values of the View onto the DisplayList
  abstract void	setTranslationX(float translationX) Sets the translationX value for the DisplayList
  abstract void	setTranslationY(float translationY) Sets the translationY value for the DisplayList
  abstract HardwareCanvas	start() Starts recording the display list.

  • Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

• Field Detail

  • FLAG_CLIP_CHILDREN

    public static final int FLAG_CLIP_CHILDREN

    Flag used when calling HardwareCanvas.drawDisplayList(DisplayList, android.graphics.Rect, int) When this flag is set, draw operations lying outside of the bounds of the display list will be culled early. It is recommeneded to always set this flag.

    See Also:

    Constant Field Values

  • STATUS_DONE

    public static final int STATUS_DONE

    Indicates that the display list is done drawing.

    See Also:

    HardwareCanvas.drawDisplayList(DisplayList, android.graphics.Rect, int), Constant Field Values

  • STATUS_DRAW

    public static final int STATUS_DRAW

    Indicates that the display list needs another drawing pass.

    See Also:

    HardwareCanvas.drawDisplayList(DisplayList, android.graphics.Rect, int), Constant Field Values

  • STATUS_INVOKE

    public static final int STATUS_INVOKE

    Indicates that the display list needs to re-execute its GL functors.

    See Also:

    HardwareCanvas.drawDisplayList(DisplayList, android.graphics.Rect, int), HardwareCanvas.callDrawGLFunction(int), Constant Field Values

  • STATUS_DREW

    public static final int STATUS_DREW

    Indicates that the display list performed GL drawing operations.

    See Also:

    HardwareCanvas.drawDisplayList(DisplayList, android.graphics.Rect, int), Constant Field Values

• Constructor Detail

  • DisplayList

    public DisplayList()

• Method Detail

  • start

    public abstract HardwareCanvas start()

    Starts recording the display list. All operations performed on the returned canvas are recorded and stored in this display list.

    Returns:

    A canvas to record drawing operations.

  • end

    public abstract void end()

    Ends the recording for this display list. A display list cannot be replayed if recording is not finished.

  • invalidate

    public abstract void invalidate()

    Invalidates the display list, indicating that it should be repopulated with new drawing commands prior to being used again. Calling this method causes calls to isValid() to return false.

  • clear

    public abstract void clear()

    Clears additional resources held onto by this display list. You should only invoke this method after invalidate().

  • isValid

    public abstract boolean isValid()

    Returns whether the display list is currently usable. If this returns false, the display list should be re-recorded prior to replaying it.

    Returns:

    boolean true if the display list is able to be replayed, false otherwise.

  • getSize

    public abstract int getSize()

    Return the amount of memory used by this display list.

    Returns:

    The size of this display list in bytes

  • setCaching

    public abstract void setCaching(boolean caching)

    Set the caching property on the DisplayList, which indicates whether the DisplayList holds a layer. Layer DisplayLists should avoid creating an alpha layer, since alpha is handled in the drawLayer operation directly (and more efficiently).

    Parameters:

    caching - true if the DisplayList represents a hardware layer, false otherwise.

  • setClipChildren

    public abstract void setClipChildren(boolean clipChildren)

    Set whether the DisplayList should clip itself to its bounds. This property is controlled by the view's parent.

    Parameters:

    clipChildren - true if the DisplayList should clip to its bounds

  • setStaticMatrix

    public abstract void setStaticMatrix(Matrix matrix)

    Set the static matrix on the DisplayList. This matrix exists if a custom ViewGroup overrides ViewGroup.getChildStaticTransformation(View, android.view.animation.Transformation) and also has ViewGroup.setStaticTransformationsEnabled(boolean) set to true. This matrix will be concatenated with any other matrices in the DisplayList to position the view appropriately.

    Parameters:

    matrix - The matrix

  • setAnimationMatrix

    public abstract void setAnimationMatrix(Matrix matrix)

    Set the Animation matrix on the DisplayList. This matrix exists if an Animation is currently playing on a View, and is set on the DisplayList during at draw() time. When the Animation finishes, the matrix should be cleared by sending null for the matrix parameter.

    Parameters:

    matrix - The matrix, null indicates that the matrix should be cleared.

  • setAlpha

    public abstract void setAlpha(float alpha)

    Sets the alpha value for the DisplayList

    Parameters:

    alpha - The translucency of the DisplayList

    See Also:

    View.setAlpha(float)

  • setHasOverlappingRendering

    public abstract void setHasOverlappingRendering(boolean hasOverlappingRendering)

    Sets whether the DisplayList renders content which overlaps. Non-overlapping rendering can use a fast path for alpha that avoids rendering to an offscreen buffer.

    Parameters:

    hasOverlappingRendering -

    See Also:

    View.hasOverlappingRendering()

  • setTranslationX

    public abstract void setTranslationX(float translationX)

    Sets the translationX value for the DisplayList

    Parameters:

    translationX - The translationX value of the DisplayList

    See Also:

    View.setTranslationX(float)

  • setTranslationY

    public abstract void setTranslationY(float translationY)

    Sets the translationY value for the DisplayList

    Parameters:

    translationY - The translationY value of the DisplayList

    See Also:

    View.setTranslationY(float)

  • setRotation

    public abstract void setRotation(float rotation)

    Sets the rotation value for the DisplayList

    Parameters:

    rotation - The rotation value of the DisplayList

    See Also:

    View.setRotation(float)

  • setRotationX

    public abstract void setRotationX(float rotationX)

    Sets the rotationX value for the DisplayList

    Parameters:

    rotationX - The rotationX value of the DisplayList

    See Also:

    View.setRotationX(float)

  • setRotationY

    public abstract void setRotationY(float rotationY)

    Sets the rotationY value for the DisplayList

    Parameters:

    rotationY - The rotationY value of the DisplayList

    See Also:

    View.setRotationY(float)

  • setScaleX

    public abstract void setScaleX(float scaleX)

    Sets the scaleX value for the DisplayList

    Parameters:

    scaleX - The scaleX value of the DisplayList

    See Also:

    View.setScaleX(float)

  • setScaleY

    public abstract void setScaleY(float scaleY)

    Sets the scaleY value for the DisplayList

    Parameters:

    scaleY - The scaleY value of the DisplayList

    See Also:

    View.setScaleY(float)

  • setTransformationInfo

    public abstract void setTransformationInfo(float alpha,
                             float translationX,
                             float translationY,
                             float rotation,
                             float rotationX,
                             float rotationY,
                             float scaleX,
                             float scaleY)

    Sets all of the transform-related values of the View onto the DisplayList

    Parameters:

    alpha - The alpha value of the DisplayList

    translationX - The translationX value of the DisplayList

    translationY - The translationY value of the DisplayList

    rotation - The rotation value of the DisplayList

    rotationX - The rotationX value of the DisplayList

    rotationY - The rotationY value of the DisplayList

    scaleX - The scaleX value of the DisplayList

    scaleY - The scaleY value of the DisplayList

  • setPivotX

    public abstract void setPivotX(float pivotX)

    Sets the pivotX value for the DisplayList

    Parameters:

    pivotX - The pivotX value of the DisplayList

    See Also:

    View.setPivotX(float)

  • setPivotY

    public abstract void setPivotY(float pivotY)

    Sets the pivotY value for the DisplayList

    Parameters:

    pivotY - The pivotY value of the DisplayList

    See Also:

    View.setPivotY(float)

  • setCameraDistance

    public abstract void setCameraDistance(float distance)

    Sets the camera distance for the DisplayList

    Parameters:

    distance - The distance in z of the camera of the DisplayList

    See Also:

    View.setCameraDistance(float)

  • setLeft

    public abstract void setLeft(int left)

    Sets the left value for the DisplayList

    Parameters:

    left - The left value of the DisplayList

    See Also:

    View.setLeft(int)

  • setTop

    public abstract void setTop(int top)

    Sets the top value for the DisplayList

    Parameters:

    top - The top value of the DisplayList

    See Also:

    View.setTop(int)

  • setRight

    public abstract void setRight(int right)

    Sets the right value for the DisplayList

    Parameters:

    right - The right value of the DisplayList

    See Also:

    View.setRight(int)

  • setBottom

    public abstract void setBottom(int bottom)

    Sets the bottom value for the DisplayList

    Parameters:

    bottom - The bottom value of the DisplayList

    See Also:

    View.setBottom(int)

  • setLeftTop

    public abstract void setLeftTop(int left,
                  int top)

    Sets the left and top values for the DisplayList

    Parameters:

    left - The left value of the DisplayList

    top - The top value of the DisplayList

    See Also:

    View.setLeft(int), View.setTop(int)

  • setLeftTopRightBottom

    public abstract void setLeftTopRightBottom(int left,
                             int top,
                             int right,
                             int bottom)

    Sets the left and top values for the DisplayList

    Parameters:

    left - The left value of the DisplayList

    top - The top value of the DisplayList

    See Also:

    View.setLeft(int), View.setTop(int)

  • offsetLeftRight

    public abstract void offsetLeftRight(int offset)

    Offsets the left and right values for the DisplayList

    Parameters:

    offset - The amount that the left and right values of the DisplayList are offset

    See Also:

    View.offsetLeftAndRight(int)

  • offsetTopBottom

    public abstract void offsetTopBottom(int offset)

    Offsets the top and bottom values for the DisplayList

    Parameters:

    offset - The amount that the top and bottom values of the DisplayList are offset

    See Also:

    View.offsetTopAndBottom(int)

  • reset

    public abstract void reset()

    Reset native resources. This is called when cleaning up the state of DisplayLists during destruction of hardware resources, to ensure that we do not hold onto obsolete resources after related resources are gone.