Most visited

Recently visited

Results for

Added in API level 3

GLSurfaceView

public class GLSurfaceView
extends SurfaceView implements SurfaceHolder.Callback2

java.lang.Object
↳	android.view.View
	↳	android.view.SurfaceView
		↳	android.opengl.GLSurfaceView

An implementation of SurfaceView that uses the dedicated surface for displaying OpenGL rendering.

A GLSurfaceView provides the following features:

Manages a surface, which is a special piece of memory that can be composited into the Android view system.
Manages an EGL display, which enables OpenGL to render into a surface.
Accepts a user-provided Renderer object that does the actual rendering.
Renders on a dedicated thread to decouple rendering performance from the UI thread.
Supports both on-demand and continuous rendering.
Optionally wraps, traces, and/or error-checks the renderer's OpenGL calls.

Developer Guides

For more information about how to use OpenGL, read the OpenGL developer guide.

Using GLSurfaceView

Typically you use GLSurfaceView by subclassing it and overriding one or more of the View system input event methods. If your application does not need to override event methods then GLSurfaceView can be used as-is. For the most part GLSurfaceView behavior is customized by calling "set" methods rather than by subclassing. For example, unlike a regular View, drawing is delegated to a separate Renderer object which is registered with the GLSurfaceView using the setRenderer(Renderer) call.

Initializing GLSurfaceView

All you have to do to initialize a GLSurfaceView is call setRenderer(Renderer). However, if desired, you can modify the default behavior of GLSurfaceView by calling one or more of these methods before calling setRenderer:

Specifying the android.view.Surface

By default GLSurfaceView will create a PixelFormat.RGB_888 format surface. If a translucent surface is required, call getHolder().setFormat(PixelFormat.TRANSLUCENT). The exact format of a TRANSLUCENT surface is device dependent, but it will be a 32-bit-per-pixel surface with 8 bits per component.

Choosing an EGL Configuration

A given Android device may support multiple EGLConfig rendering configurations. The available configurations may differ in how may channels of data are present, as well as how many bits are allocated to each channel. Therefore, the first thing GLSurfaceView has to do when starting to render is choose what EGLConfig to use.

By default GLSurfaceView chooses a EGLConfig that has an RGB_888 pixel format, with at least a 16-bit depth buffer and no stencil.

If you would prefer a different EGLConfig you can override the default behavior by calling one of the setEGLConfigChooser methods.

Debug Behavior

You can optionally modify the behavior of GLSurfaceView by calling one or more of the debugging methods setDebugFlags(int), and setGLWrapper(GLSurfaceView.GLWrapper). These methods may be called before and/or after setRenderer, but typically they are called before setRenderer so that they take effect immediately.

Setting a Renderer

Finally, you must call setRenderer(GLSurfaceView.Renderer) to register a GLSurfaceView.Renderer. The renderer is responsible for doing the actual OpenGL rendering.

Rendering Mode

Once the renderer is set, you can control whether the renderer draws continuously or on-demand by calling setRenderMode(int). The default is continuous rendering.

Activity Life-cycle

A GLSurfaceView must be notified when the activity is paused and resumed. GLSurfaceView clients are required to call onPause() when the activity pauses and onResume() when the activity resumes. These calls allow GLSurfaceView to pause and resume the rendering thread, and also allow GLSurfaceView to release and recreate the OpenGL display.

Handling events

To handle an event you will typically subclass GLSurfaceView and override the appropriate method, just as you would with any other View. However, when handling the event, you may need to communicate with the Renderer object that's running in the rendering thread. You can do this using any standard Java cross-thread communication mechanism. In addition, one relatively easy way to communicate with your renderer is to call queueEvent(Runnable). For example:

 class MyGLSurfaceView extends GLSurfaceView {

     private MyRenderer mMyRenderer;

     public void start() {
         mMyRenderer = ...;
         setRenderer(mMyRenderer);
     }

     public boolean onKeyDown(int keyCode, KeyEvent event) {
         if (keyCode == KeyEvent.KEYCODE_DPAD_CENTER) {
             queueEvent(new Runnable() {
                 // This method will be called on the rendering
                 // thread:
                 public void run() {
                     mMyRenderer.handleDpadCenter();
                 }});
             return true;
         }
         return super.onKeyDown(keyCode, event);
     }
 }

Summary

Nested classes
`interface`	`GLSurfaceView.EGLConfigChooser` An interface for choosing an EGLConfig configuration from a list of potential configurations.
`interface`	`GLSurfaceView.EGLContextFactory` An interface for customizing the eglCreateContext and eglDestroyContext calls.
`interface`	`GLSurfaceView.EGLWindowSurfaceFactory` An interface for customizing the eglCreateWindowSurface and eglDestroySurface calls.
`interface`	`GLSurfaceView.GLWrapper` An interface used to wrap a GL interface.
`interface`	`GLSurfaceView.Renderer` A generic renderer interface.

Inherited XML attributes

From class


  android.view.View

Constants
`int`	`DEBUG_CHECK_GL_ERROR` Check glError() after every GL call and throw an exception if glError indicates that an error has occurred.
`int`	`DEBUG_LOG_GL_CALLS` Log GL calls to the system log at "verbose" level with tag "GLSurfaceView".
`int`	`RENDERMODE_CONTINUOUSLY` The renderer is called continuously to re-render the scene.
`int`	`RENDERMODE_WHEN_DIRTY` The renderer only renders when the surface is created, or when `requestRender()` is called.

Inherited constants

From class


    android.view.View

Inherited fields

From class


    android.view.View

Public constructors
`GLSurfaceView(Context context)` Standard View constructor.
`GLSurfaceView(Context context, AttributeSet attrs)` Standard View constructor.

Public methods
`int`	`getDebugFlags()` Get the current value of the debug flags.
`boolean`	`getPreserveEGLContextOnPause()`
`int`	`getRenderMode()` Get the current rendering mode.
`void`	`onPause()` Inform the view that the activity is paused.
`void`	`onResume()` Inform the view that the activity is resumed.
`void`	`queueEvent(Runnable r)` Queue a runnable to be run on the GL rendering thread.
`void`	`requestRender()` Request that the renderer render a frame.
`void`	`setDebugFlags(int debugFlags)` Set the debug flags to a new value.
`void`	`setEGLConfigChooser(boolean needDepth)` Install a config chooser which will choose a config as close to 16-bit RGB as possible, with or without an optional depth buffer as close to 16-bits as possible.
`void`	`setEGLConfigChooser(GLSurfaceView.EGLConfigChooser configChooser)` Install a custom EGLConfigChooser.
`void`	`setEGLConfigChooser(int redSize, int greenSize, int blueSize, int alphaSize, int depthSize, int stencilSize)` Install a config chooser which will choose a config with at least the specified depthSize and stencilSize, and exactly the specified redSize, greenSize, blueSize and alphaSize.
`void`	`setEGLContextClientVersion(int version)` Inform the default EGLContextFactory and default EGLConfigChooser which EGLContext client version to pick.
`void`	`setEGLContextFactory(GLSurfaceView.EGLContextFactory factory)` Install a custom EGLContextFactory.
`void`	`setEGLWindowSurfaceFactory(GLSurfaceView.EGLWindowSurfaceFactory factory)` Install a custom EGLWindowSurfaceFactory.
`void`	`setGLWrapper(GLSurfaceView.GLWrapper glWrapper)` Set the glWrapper.
`void`	`setPreserveEGLContextOnPause(boolean preserveOnPause)` Control whether the EGL context is preserved when the GLSurfaceView is paused and resumed.
`void`	`setRenderMode(int renderMode)` Set the rendering mode.
`void`	`setRenderer(GLSurfaceView.Renderer renderer)` Set the renderer associated with this view.
`void`	`surfaceChanged(SurfaceHolder holder, int format, int w, int h)` This method is part of the SurfaceHolder.Callback interface, and is not normally called or subclassed by clients of GLSurfaceView.
`void`	`surfaceCreated(SurfaceHolder holder)` This method is part of the SurfaceHolder.Callback interface, and is not normally called or subclassed by clients of GLSurfaceView.
`void`	`surfaceDestroyed(SurfaceHolder holder)` This method is part of the SurfaceHolder.Callback interface, and is not normally called or subclassed by clients of GLSurfaceView.
`void`	`surfaceRedrawNeeded(SurfaceHolder holder)` This method is part of the SurfaceHolder.Callback interface, and is not normally called or subclassed by clients of GLSurfaceView.

Protected methods
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`void`	`onAttachedToWindow()` This method is used as part of the View class and is not normally called or subclassed by clients of GLSurfaceView.
`void`	`onDetachedFromWindow()` This is called when the view is detached from a window.

Inherited methods

From class


  
    android.view.SurfaceView

`void`	`dispatchDraw(Canvas canvas)` Called by draw to draw the child views.
`void`	`draw(Canvas canvas)` Manually render this view (and all of its children) to the given Canvas.
`boolean`	`gatherTransparentRegion(Region region)` This is used by the RootView to perform an optimization when the view hierarchy contains one or several SurfaceView.
`SurfaceHolder`	`getHolder()` Return the SurfaceHolder providing access and control over this SurfaceView's underlying surface.
`void`	`onAttachedToWindow()` This is called when the view is attached to a window.
`void`	`onDetachedFromWindow()` This is called when the view is detached from a window.
`void`	`onMeasure(int widthMeasureSpec, int heightMeasureSpec)` Measure the view and its content to determine the measured width and the measured height.
`void`	`onWindowVisibilityChanged(int visibility)` Called when the window containing has change its visibility (between `GONE`, `INVISIBLE`, and `VISIBLE`).
`void`	`setSecure(boolean isSecure)` Control whether the surface view's content should be treated as secure, preventing it from appearing in screenshots or from being viewed on non-secure displays.
`void`	`setVisibility(int visibility)` Set the enabled state of this view.
`void`	`setZOrderMediaOverlay(boolean isMediaOverlay)` Control whether the surface view's surface is placed on top of another regular surface view in the window (but still behind the window itself).
`void`	`setZOrderOnTop(boolean onTop)` Control whether the surface view's surface is placed on top of its window.

From class


  
    android.view.View

`void`	`addChildrenForAccessibility(ArrayList<View> outChildren)` Adds the children of this View relevant for accessibility to the given list as output.
`void`	`addFocusables(ArrayList<View> views, int direction)` Add any focusable views that are descendants of this view (possibly including this view if it is focusable itself) to views.
`void`	`addFocusables(ArrayList<View> views, int direction, int focusableMode)` Adds any focusable views that are descendants of this view (possibly including this view if it is focusable itself) to views.
`void`	`addOnAttachStateChangeListener(View.OnAttachStateChangeListener listener)` Add a listener for attach state changes.
`void`	`addOnLayoutChangeListener(View.OnLayoutChangeListener listener)` Add a listener that will be called when the bounds of the view change due to layout processing.
`void`	`addTouchables(ArrayList<View> views)` Add any touchable views that are descendants of this view (possibly including this view if it is touchable itself) to views.
`ViewPropertyAnimator`	`animate()` This method returns a ViewPropertyAnimator object, which can be used to animate specific properties on this View.
`void`	`announceForAccessibility(CharSequence text)` Convenience method for sending a `TYPE_ANNOUNCEMENT` `AccessibilityEvent` to make an announcement which is related to some sort of a context change for which none of the events representing UI transitions is a good fit.
`boolean`	`awakenScrollBars(int startDelay, boolean invalidate)` Trigger the scrollbars to draw.
`boolean`	`awakenScrollBars(int startDelay)` Trigger the scrollbars to draw.
`boolean`	`awakenScrollBars()` Trigger the scrollbars to draw.
`void`	`bringToFront()` Change the view's z order in the tree, so it's on top of other sibling views.
`void`	`buildDrawingCache(boolean autoScale)` Forces the drawing cache to be built if the drawing cache is invalid.
`void`	`buildDrawingCache()` Calling this method is equivalent to calling `buildDrawingCache(false)`.
`void`	`buildLayer()` Forces this view's layer to be created and this view to be rendered into its layer.
`boolean`	`callOnClick()` Directly call any attached OnClickListener.
`boolean`	`canResolveLayoutDirection()` Check if layout direction resolution can be done.
`boolean`	`canResolveTextAlignment()` Check if text alignment resolution can be done.
`boolean`	`canResolveTextDirection()` Check if text direction resolution can be done.
`boolean`	`canScrollHorizontally(int direction)` Check if this view can be scrolled horizontally in a certain direction.
`boolean`	`canScrollVertically(int direction)` Check if this view can be scrolled vertically in a certain direction.
`final void`	`cancelDragAndDrop()` Cancels an ongoing drag and drop operation.
`void`	`cancelLongPress()` Cancels a pending long press.
`final void`	`cancelPendingInputEvents()` Cancel any deferred high-level input events that were previously posted to the event queue.
`boolean`	`checkInputConnectionProxy(View view)` Called by the `InputMethodManager` when a view who is not the current input connection target is trying to make a call on the manager.
`void`	`clearAnimation()` Cancels any animations for this view.
`void`	`clearFocus()` Called when this view wants to give up focus.
`static int`	`combineMeasuredStates(int curState, int newState)` Merge two states as returned by `getMeasuredState()`.
`int`	`computeHorizontalScrollExtent()` Compute the horizontal extent of the horizontal scrollbar's thumb within the horizontal range.
`int`	`computeHorizontalScrollOffset()` Compute the horizontal offset of the horizontal scrollbar's thumb within the horizontal range.
`int`	`computeHorizontalScrollRange()` Compute the horizontal range that the horizontal scrollbar represents.
`void`	`computeScroll()` Called by a parent to request that a child update its values for mScrollX and mScrollY if necessary.
`WindowInsets`	`computeSystemWindowInsets(WindowInsets in, Rect outLocalInsets)` Compute insets that should be consumed by this view and the ones that should propagate to those under it.
`int`	`computeVerticalScrollExtent()` Compute the vertical extent of the vertical scrollbar's thumb within the vertical range.
`int`	`computeVerticalScrollOffset()` Compute the vertical offset of the vertical scrollbar's thumb within the horizontal range.
`int`	`computeVerticalScrollRange()` Compute the vertical range that the vertical scrollbar represents.
`AccessibilityNodeInfo`	`createAccessibilityNodeInfo()` Returns an `AccessibilityNodeInfo` representing this view from the point of view of an `AccessibilityService`.
`void`	`createContextMenu(ContextMenu menu)` Show the context menu for this view.
`void`	`destroyDrawingCache()` Frees the resources used by the drawing cache.
`WindowInsets`	`dispatchApplyWindowInsets(WindowInsets insets)` Request to apply the given window insets to this view or another view in its subtree.
`void`	`dispatchConfigurationChanged(Configuration newConfig)` Dispatch a notification about a resource configuration change down the view hierarchy.
`void`	`dispatchDisplayHint(int hint)` Dispatch a hint about whether this view is displayed.
`boolean`	`dispatchDragEvent(DragEvent event)` Detects if this View is enabled and has a drag event listener.
`void`	`dispatchDraw(Canvas canvas)` Called by draw to draw the child views.
`void`	`dispatchDrawableHotspotChanged(float x, float y)` Dispatches drawableHotspotChanged to all of this View's children.
`void`	`dispatchFinishTemporaryDetach()` Dispatch `onFinishTemporaryDetach()` to this View and its direct children if this is a container View.
`boolean`	`dispatchGenericFocusedEvent(MotionEvent event)` Dispatch a generic motion event to the currently focused view.
`boolean`	`dispatchGenericMotionEvent(MotionEvent event)` Dispatch a generic motion event.
`boolean`	`dispatchGenericPointerEvent(MotionEvent event)` Dispatch a generic motion event to the view under the first pointer.
`boolean`	`dispatchHoverEvent(MotionEvent event)` Dispatch a hover event.
`boolean`	`dispatchKeyEvent(KeyEvent event)` Dispatch a key event to the next view on the focus path.
`boolean`	`dispatchKeyEventPreIme(KeyEvent event)` Dispatch a key event before it is processed by any input method associated with the view hierarchy.
`boolean`	`dispatchKeyShortcutEvent(KeyEvent event)` Dispatches a key shortcut event.
`boolean`	`dispatchNestedFling(float velocityX, float velocityY, boolean consumed)` Dispatch a fling to a nested scrolling parent.
`boolean`	`dispatchNestedPreFling(float velocityX, float velocityY)` Dispatch a fling to a nested scrolling parent before it is processed by this view.
`boolean`	`dispatchNestedPrePerformAccessibilityAction(int action, Bundle arguments)` Report an accessibility action to this view's parents for delegated processing.
`boolean`	`dispatchNestedPreScroll(int dx, int dy, int[] consumed, int[] offsetInWindow)` Dispatch one step of a nested scroll in progress before this view consumes any portion of it.
`boolean`	`dispatchNestedScroll(int dxConsumed, int dyConsumed, int dxUnconsumed, int dyUnconsumed, int[] offsetInWindow)` Dispatch one step of a nested scroll in progress.
`boolean`	`dispatchPopulateAccessibilityEvent(AccessibilityEvent event)` Dispatches an `AccessibilityEvent` to the `View` first and then to its children for adding their text content to the event.
`void`	`dispatchProvideStructure(ViewStructure structure)` Dispatch creation of `ViewStructure` down the hierarchy.
`void`	`dispatchRestoreInstanceState(SparseArray<Parcelable> container)` Called by `restoreHierarchyState(android.util.SparseArray)` to retrieve the state for this view and its children.
`void`	`dispatchSaveInstanceState(SparseArray<Parcelable> container)` Called by `saveHierarchyState(android.util.SparseArray)` to store the state for this view and its children.
`void`	`dispatchSetActivated(boolean activated)` Dispatch setActivated to all of this View's children.
`void`	`dispatchSetPressed(boolean pressed)` Dispatch setPressed to all of this View's children.
`void`	`dispatchSetSelected(boolean selected)` Dispatch setSelected to all of this View's children.
`void`	`dispatchStartTemporaryDetach()` Dispatch `onStartTemporaryDetach()` to this View and its direct children if this is a container View.
`void`	`dispatchSystemUiVisibilityChanged(int visibility)` Dispatch callbacks to `setOnSystemUiVisibilityChangeListener(View.OnSystemUiVisibilityChangeListener)` down the view hierarchy.
`boolean`	`dispatchTouchEvent(MotionEvent event)` Pass the touch screen motion event down to the target view, or this view if it is the target.
`boolean`	`dispatchTrackballEvent(MotionEvent event)` Pass a trackball motion event down to the focused view.
`boolean`	`dispatchUnhandledMove(View focused, int direction)` This method is the last chance for the focused view and its ancestors to respond to an arrow key.
`void`	`dispatchVisibilityChanged(View changedView, int visibility)` Dispatch a view visibility change down the view hierarchy.
`void`	`dispatchWindowFocusChanged(boolean hasFocus)` Called when the window containing this view gains or loses window focus.
`void`	`dispatchWindowSystemUiVisiblityChanged(int visible)` Dispatch callbacks to `onWindowSystemUiVisibilityChanged(int)` down the view hierarchy.
`void`	`dispatchWindowVisibilityChanged(int visibility)` Dispatch a window visibility change down the view hierarchy.
`void`	`draw(Canvas canvas)` Manually render this view (and all of its children) to the given Canvas.
`void`	`drawableHotspotChanged(float x, float y)` This function is called whenever the view hotspot changes and needs to be propagated to drawables or child views managed by the view.
`void`	`drawableStateChanged()` This function is called whenever the state of the view changes in such a way that it impacts the state of drawables being shown.
`View`	`findFocus()` Find the view in the hierarchy rooted at this view that currently has focus.
`final View`	`findViewById(int id)` Look for a child view with the given id.
`final View`	`findViewWithTag(Object tag)` Look for a child view with the given tag.
`void`	`findViewsWithText(ArrayList<View> outViews, CharSequence searched, int flags)` Finds the Views that contain given text.
`boolean`	`fitSystemWindows(Rect insets)` This method was deprecated in API level 20. As of API 20 use `dispatchApplyWindowInsets(WindowInsets)` to apply insets to views. Views should override `onApplyWindowInsets(WindowInsets)` or use `setOnApplyWindowInsetsListener(android.view.View.OnApplyWindowInsetsListener)` to implement handling their own insets.
`View`	`focusSearch(int direction)` Find the nearest view in the specified direction that can take focus.
`void`	`forceHasOverlappingRendering(boolean hasOverlappingRendering)` Sets the behavior for overlapping rendering for this view (see `hasOverlappingRendering()` for more details on this behavior).
`void`	`forceLayout()` Forces this view to be laid out during the next layout pass.
`static int`	`generateViewId()` Generate a value suitable for use in `setId(int)`.
`CharSequence`	`getAccessibilityClassName()` Return the class name of this object to be used for accessibility purposes.
`int`	`getAccessibilityLiveRegion()` Gets the live region mode for this View.
`AccessibilityNodeProvider`	`getAccessibilityNodeProvider()` Gets the provider for managing a virtual view hierarchy rooted at this View and reported to `AccessibilityService`s that explore the window content.
`int`	`getAccessibilityTraversalAfter()` Gets the id of a view after which this one is visited in accessibility traversal.
`int`	`getAccessibilityTraversalBefore()` Gets the id of a view before which this one is visited in accessibility traversal.
`float`	`getAlpha()` The opacity of the view.
`Animation`	`getAnimation()` Get the animation currently associated with this view.
`IBinder`	`getApplicationWindowToken()` Retrieve a unique token identifying the top-level "real" window of the window that this view is attached to.
`Drawable`	`getBackground()` Gets the background drawable
`ColorStateList`	`getBackgroundTintList()` Return the tint applied to the background drawable, if specified.
`PorterDuff.Mode`	`getBackgroundTintMode()` Return the blending mode used to apply the tint to the background drawable, if specified.
`int`	`getBaseline()` Return the offset of the widget's text baseline from the widget's top boundary.
`final int`	`getBottom()` Bottom position of this view relative to its parent.
`float`	`getBottomFadingEdgeStrength()` Returns the strength, or intensity, of the bottom faded edge.
`int`	`getBottomPaddingOffset()` Amount by which to extend the bottom fading region.
`float`	`getCameraDistance()` Gets the distance along the Z axis from the camera to this view.
`boolean`	`getClipBounds(Rect outRect)` Populates an output rectangle with the clip bounds of the view, returning `true` if successful or `false` if the view's clip bounds are `null`.
`Rect`	`getClipBounds()` Returns a copy of the current `clipBounds`.
`final boolean`	`getClipToOutline()` Returns whether the Outline should be used to clip the contents of the View.
`CharSequence`	`getContentDescription()` Returns the `View`'s content description.
`final Context`	`getContext()` Returns the context the view is running in, through which it can access the current theme, resources, etc.
`ContextMenu.ContextMenuInfo`	`getContextMenuInfo()` Views should implement this if they have extra information to associate with the context menu.
`static int`	`getDefaultSize(int size, int measureSpec)` Utility to return a default size.
`Display`	`getDisplay()` Gets the logical display to which the view's window has been attached.
`final int[]`	`getDrawableState()` Return an array of resource IDs of the drawable states representing the current state of the view.
`Bitmap`	`getDrawingCache()` Calling this method is equivalent to calling `getDrawingCache(false)`.
`Bitmap`	`getDrawingCache(boolean autoScale)` Returns the bitmap in which this view drawing is cached.
`int`	`getDrawingCacheBackgroundColor()`
`int`	`getDrawingCacheQuality()` Returns the quality of the drawing cache.
`void`	`getDrawingRect(Rect outRect)` Return the visible drawing bounds of your view.
`long`	`getDrawingTime()` Return the time at which the drawing of the view hierarchy started.
`float`	`getElevation()` The base elevation of this view relative to its parent, in pixels.
`boolean`	`getFilterTouchesWhenObscured()` Gets whether the framework should discard touches when the view's window is obscured by another visible window.
`boolean`	`getFitsSystemWindows()` Check for state of `setFitsSystemWindows(boolean)`.
`ArrayList<View>`	`getFocusables(int direction)` Find and return all focusable views that are descendants of this view, possibly including this view if it is focusable itself.
`void`	`getFocusedRect(Rect r)` When a view has focus and the user navigates away from it, the next view is searched for starting from the rectangle filled in by this method.
`Drawable`	`getForeground()` Returns the drawable used as the foreground of this View.
`int`	`getForegroundGravity()` Describes how the foreground is positioned.
`ColorStateList`	`getForegroundTintList()` Return the tint applied to the foreground drawable, if specified.
`PorterDuff.Mode`	`getForegroundTintMode()` Return the blending mode used to apply the tint to the foreground drawable, if specified.
`final boolean`	`getGlobalVisibleRect(Rect r)`
`boolean`	`getGlobalVisibleRect(Rect r, Point globalOffset)` If some part of this view is not clipped by any of its parents, then return that area in r in global (root) coordinates.
`Handler`	`getHandler()`
`final boolean`	`getHasOverlappingRendering()` Returns the value for overlapping rendering that is used internally.
`final int`	`getHeight()` Return the height of your view.
`void`	`getHitRect(Rect outRect)` Hit rectangle in parent's coordinates
`int`	`getHorizontalFadingEdgeLength()` Returns the size of the horizontal faded edges used to indicate that more content in this view is visible.
`int`	`getHorizontalScrollbarHeight()` Returns the height of the horizontal scrollbar.
`int`	`getId()` Returns this view's identifier.
`int`	`getImportantForAccessibility()` Gets the mode for determining whether this View is important for accessibility which is if it fires accessibility events and if it is reported to accessibility services that query the screen.
`boolean`	`getKeepScreenOn()` Returns whether the screen should remain on, corresponding to the current value of `KEEP_SCREEN_ON`.
`KeyEvent.DispatcherState`	`getKeyDispatcherState()` Return the global `KeyEvent.DispatcherState` for this view's window.
`int`	`getLabelFor()` Gets the id of a view for which this view serves as a label for accessibility purposes.
`int`	`getLayerType()` Indicates what type of layer is currently associated with this view.
`int`	`getLayoutDirection()` Returns the resolved layout direction for this view.
`ViewGroup.LayoutParams`	`getLayoutParams()` Get the LayoutParams associated with this view.
`final int`	`getLeft()` Left position of this view relative to its parent.
`float`	`getLeftFadingEdgeStrength()` Returns the strength, or intensity, of the left faded edge.
`int`	`getLeftPaddingOffset()` Amount by which to extend the left fading region.
`final boolean`	`getLocalVisibleRect(Rect r)`
`void`	`getLocationInWindow(int[] outLocation)` Computes the coordinates of this view in its window.
`void`	`getLocationOnScreen(int[] outLocation)` Computes the coordinates of this view on the screen.
`Matrix`	`getMatrix()` The transform matrix of this view, which is calculated based on the current rotation, scale, and pivot properties.
`final int`	`getMeasuredHeight()` Like `getMeasuredHeightAndState()`, but only returns the raw width component (that is the result is masked by `MEASURED_SIZE_MASK`).
`final int`	`getMeasuredHeightAndState()` Return the full height measurement information for this view as computed by the most recent call to `measure(int, int)`.
`final int`	`getMeasuredState()` Return only the state bits of `getMeasuredWidthAndState()` and `getMeasuredHeightAndState()`, combined into one integer.
`final int`	`getMeasuredWidth()` Like `getMeasuredWidthAndState()`, but only returns the raw width component (that is the result is masked by `MEASURED_SIZE_MASK`).
`final int`	`getMeasuredWidthAndState()` Return the full width measurement information for this view as computed by the most recent call to `measure(int, int)`.
`int`	`getMinimumHeight()` Returns the minimum height of the view.
`int`	`getMinimumWidth()` Returns the minimum width of the view.
`int`	`getNextFocusDownId()` Gets the id of the view to use when the next focus is `FOCUS_DOWN`.
`int`	`getNextFocusForwardId()` Gets the id of the view to use when the next focus is `FOCUS_FORWARD`.
`int`	`getNextFocusLeftId()` Gets the id of the view to use when the next focus is `FOCUS_LEFT`.
`int`	`getNextFocusRightId()` Gets the id of the view to use when the next focus is `FOCUS_RIGHT`.
`int`	`getNextFocusUpId()` Gets the id of the view to use when the next focus is `FOCUS_UP`.
`View.OnFocusChangeListener`	`getOnFocusChangeListener()` Returns the focus-change callback registered for this view.
`ViewOutlineProvider`	`getOutlineProvider()` Returns the current `ViewOutlineProvider` of the view, which generates the Outline that defines the shape of the shadow it casts, and enables outline clipping.
`int`	`getOverScrollMode()` Returns the over-scroll mode for this view.
`ViewOverlay`	`getOverlay()` Returns the overlay for this view, creating it if it does not yet exist.
`int`	`getPaddingBottom()` Returns the bottom padding of this view.
`int`	`getPaddingEnd()` Returns the end padding of this view depending on its resolved layout direction.
`int`	`getPaddingLeft()` Returns the left padding of this view.
`int`	`getPaddingRight()` Returns the right padding of this view.
`int`	`getPaddingStart()` Returns the start padding of this view depending on its resolved layout direction.
`int`	`getPaddingTop()` Returns the top padding of this view.
`final ViewParent`	`getParent()` Gets the parent of this view.
`ViewParent`	`getParentForAccessibility()` Gets the parent for accessibility purposes.
`float`	`getPivotX()` The x location of the point around which the view is `rotated` and `scaled`.
`float`	`getPivotY()` The y location of the point around which the view is `rotated` and `scaled`.
`PointerIcon`	`getPointerIcon()` Gets the pointer icon for the current view.
`Resources`	`getResources()` Returns the resources associated with this view.
`final int`	`getRight()` Right position of this view relative to its parent.
`float`	`getRightFadingEdgeStrength()` Returns the strength, or intensity, of the right faded edge.
`int`	`getRightPaddingOffset()` Amount by which to extend the right fading region.
`View`	`getRootView()` Finds the topmost view in the current view hierarchy.
`WindowInsets`	`getRootWindowInsets()` Provide original WindowInsets that are dispatched to the view hierarchy.
`float`	`getRotation()` The degrees that the view is rotated around the pivot point.
`float`	`getRotationX()` The degrees that the view is rotated around the horizontal axis through the pivot point.
`float`	`getRotationY()` The degrees that the view is rotated around the vertical axis through the pivot point.
`float`	`getScaleX()` The amount that the view is scaled in x around the pivot point, as a proportion of the view's unscaled width.
`float`	`getScaleY()` The amount that the view is scaled in y around the pivot point, as a proportion of the view's unscaled height.
`int`	`getScrollBarDefaultDelayBeforeFade()` Returns the delay before scrollbars fade.
`int`	`getScrollBarFadeDuration()` Returns the scrollbar fade duration.
`int`	`getScrollBarSize()` Returns the scrollbar size.
`int`	`getScrollBarStyle()` Returns the current scrollbar style.
`int`	`getScrollIndicators()` Returns a bitmask representing the enabled scroll indicators.
`final int`	`getScrollX()` Return the scrolled left position of this view.
`final int`	`getScrollY()` Return the scrolled top position of this view.
`int`	`getSolidColor()` Override this if your view is known to always be drawn on top of a solid color background, and needs to draw fading edges.
`StateListAnimator`	`getStateListAnimator()` Returns the current StateListAnimator if exists.
`int`	`getSuggestedMinimumHeight()` Returns the suggested minimum height that the view should use.
`int`	`getSuggestedMinimumWidth()` Returns the suggested minimum width that the view should use.
`int`	`getSystemUiVisibility()` Returns the last `setSystemUiVisibility(int)` that this view has requested.
`Object`	`getTag()` Returns this view's tag.
`Object`	`getTag(int key)` Returns the tag associated with this view and the specified key.
`int`	`getTextAlignment()` Return the resolved text alignment.
`int`	`getTextDirection()` Return the resolved text direction.
`final int`	`getTop()` Top position of this view relative to its parent.
`float`	`getTopFadingEdgeStrength()` Returns the strength, or intensity, of the top faded edge.
`int`	`getTopPaddingOffset()` Amount by which to extend the top fading region.
`TouchDelegate`	`getTouchDelegate()` Gets the TouchDelegate for this View.
`ArrayList<View>`	`getTouchables()` Find and return all touchable views that are descendants of this view, possibly including this view if it is touchable itself.
`String`	`getTransitionName()` Returns the name of the View to be used to identify Views in Transitions.
`float`	`getTranslationX()` The horizontal location of this view relative to its `left` position.
`float`	`getTranslationY()` The vertical location of this view relative to its `top` position.
`float`	`getTranslationZ()` The depth location of this view relative to its `elevation`.
`int`	`getVerticalFadingEdgeLength()` Returns the size of the vertical faded edges used to indicate that more content in this view is visible.
`int`	`getVerticalScrollbarPosition()`
`int`	`getVerticalScrollbarWidth()` Returns the width of the vertical scrollbar.
`ViewTreeObserver`	`getViewTreeObserver()` Returns the ViewTreeObserver for this view's hierarchy.
`int`	`getVisibility()` Returns the visibility status for this view.
`final int`	`getWidth()` Return the width of the your view.
`int`	`getWindowAttachCount()`
`WindowId`	`getWindowId()` Retrieve the `WindowId` for the window this view is currently attached to.
`int`	`getWindowSystemUiVisibility()` Returns the current system UI visibility that is currently set for the entire window.
`IBinder`	`getWindowToken()` Retrieve a unique token identifying the window this view is attached to.
`int`	`getWindowVisibility()` Returns the current visibility of the window this view is attached to (either `GONE`, `INVISIBLE`, or `VISIBLE`).
`void`	`getWindowVisibleDisplayFrame(Rect outRect)` Retrieve the overall visible display size in which the window this view is attached to has been positioned in.
`float`	`getX()` The visual x position of this view, in pixels.
`float`	`getY()` The visual y position of this view, in pixels.
`float`	`getZ()` The visual z position of this view, in pixels.
`boolean`	`hasFocus()` Returns true if this view has focus itself, or is the ancestor of the view that has focus.
`boolean`	`hasFocusable()` Returns true if this view is focusable or if it contains a reachable View for which `hasFocusable()` returns true.
`boolean`	`hasNestedScrollingParent()` Returns true if this view has a nested scrolling parent.
`boolean`	`hasOnClickListeners()` Return whether this view has an attached OnClickListener.
`boolean`	`hasOverlappingRendering()` Returns whether this View has content which overlaps.
`boolean`	`hasTransientState()` Indicates whether the view is currently tracking transient state that the app should not need to concern itself with saving and restoring, but that the framework should take special note to preserve when possible.
`boolean`	`hasWindowFocus()` Returns true if this view is in a window that currently has window focus.
`static View`	`inflate(Context context, int resource, ViewGroup root)` Inflate a view from an XML resource.
`void`	`invalidate()` Invalidate the whole view.
`void`	`invalidate(Rect dirty)` Mark the area defined by dirty as needing to be drawn.
`void`	`invalidate(int l, int t, int r, int b)` Mark the area defined by the rect (l,t,r,b) as needing to be drawn.
`void`	`invalidateDrawable(Drawable drawable)` Invalidates the specified Drawable.
`void`	`invalidateOutline()` Called to rebuild this View's Outline from its `outline provider`
`boolean`	`isAccessibilityFocused()` Returns whether this View is accessibility focused.
`boolean`	`isActivated()` Indicates the activation state of this view.
`boolean`	`isAttachedToWindow()` Returns true if this view is currently attached to a window.
`boolean`	`isClickable()` Indicates whether this view reacts to click events or not.
`boolean`	`isContextClickable()` Indicates whether this view reacts to context clicks or not.
`boolean`	`isDirty()` True if this view has changed since the last time being drawn.
`boolean`	`isDrawingCacheEnabled()` Indicates whether the drawing cache is enabled for this view.
`boolean`	`isDuplicateParentStateEnabled()` Indicates whether this duplicates its drawable state from its parent.
`boolean`	`isEnabled()` Returns the enabled status for this view.
`final boolean`	`isFocusable()` Returns whether this View is able to take focus.
`final boolean`	`isFocusableInTouchMode()` When a view is focusable, it may not want to take focus when in touch mode.
`boolean`	`isFocused()` Returns true if this view has focus
`boolean`	`isHapticFeedbackEnabled()`
`boolean`	`isHardwareAccelerated()` Indicates whether this view is attached to a hardware accelerated window or not.
`boolean`	`isHorizontalFadingEdgeEnabled()` Indicate whether the horizontal edges are faded when the view is scrolled horizontally.
`boolean`	`isHorizontalScrollBarEnabled()` Indicate whether the horizontal scrollbar should be drawn or not.
`boolean`	`isHovered()` Returns true if the view is currently hovered.
`boolean`	`isImportantForAccessibility()` Computes whether this view should be exposed for accessibility.
`boolean`	`isInEditMode()` Indicates whether this View is currently in edit mode.
`boolean`	`isInLayout()` Returns whether the view hierarchy is currently undergoing a layout pass.
`boolean`	`isInTouchMode()` Returns whether the device is currently in touch mode.
`boolean`	`isLaidOut()` Returns true if this view has been through at least one layout since it was last attached to or detached from a window.
`boolean`	`isLayoutDirectionResolved()`
`boolean`	`isLayoutRequested()` Indicates whether or not this view's layout will be requested during the next hierarchy layout pass.
`boolean`	`isLongClickable()` Indicates whether this view reacts to long click events or not.
`boolean`	`isNestedScrollingEnabled()` Returns true if nested scrolling is enabled for this view.
`boolean`	`isOpaque()` Indicates whether this View is opaque.
`boolean`	`isPaddingOffsetRequired()` If the View draws content inside its padding and enables fading edges, it needs to support padding offsets.
`boolean`	`isPaddingRelative()` Return if the padding has been set through relative values `setPaddingRelative(int, int, int, int)` or through
`boolean`	`isPressed()` Indicates whether the view is currently in pressed state.
`boolean`	`isSaveEnabled()` Indicates whether this view will save its state (that is, whether its `onSaveInstanceState()` method will be called).
`boolean`	`isSaveFromParentEnabled()` Indicates whether the entire hierarchy under this view will save its state when a state saving traversal occurs from its parent.
`boolean`	`isScrollContainer()` Indicates whether this view is one of the set of scrollable containers in its window.
`boolean`	`isScrollbarFadingEnabled()` Returns true if scrollbars will fade when this view is not scrolling
`boolean`	`isSelected()` Indicates the selection state of this view.
`boolean`	`isShown()` Returns the visibility of this view and all of its ancestors
`boolean`	`isSoundEffectsEnabled()`
`final boolean`	`isTemporarilyDetached()`
`boolean`	`isTextAlignmentResolved()`
`boolean`	`isTextDirectionResolved()`
`boolean`	`isVerticalFadingEdgeEnabled()` Indicate whether the vertical edges are faded when the view is scrolled horizontally.
`boolean`	`isVerticalScrollBarEnabled()` Indicate whether the vertical scrollbar should be drawn or not.
`void`	`jumpDrawablesToCurrentState()` Call `Drawable.jumpToCurrentState()` on all Drawable objects associated with this view.
`void`	`layout(int l, int t, int r, int b)` Assign a size and position to a view and all of its descendants This is the second phase of the layout mechanism.
`final void`	`measure(int widthMeasureSpec, int heightMeasureSpec)` This is called to find out how big a view should be.
`static int[]`	`mergeDrawableStates(int[] baseState, int[] additionalState)` Merge your own state values in `additionalState` into the base state values `baseState` that were returned by `onCreateDrawableState(int)`.
`void`	`offsetLeftAndRight(int offset)` Offset this view's horizontal location by the specified amount of pixels.
`void`	`offsetTopAndBottom(int offset)` Offset this view's vertical location by the specified number of pixels.
`void`	`onAnimationEnd()` Invoked by a parent ViewGroup to notify the end of the animation currently associated with this view.
`void`	`onAnimationStart()` Invoked by a parent ViewGroup to notify the start of the animation currently associated with this view.
`WindowInsets`	`onApplyWindowInsets(WindowInsets insets)` Called when the view should apply `WindowInsets` according to its internal policy.
`void`	`onAttachedToWindow()` This is called when the view is attached to a window.
`void`	`onCancelPendingInputEvents()` Called as the result of a call to `cancelPendingInputEvents()` on this view or a parent view.
`boolean`	`onCheckIsTextEditor()` Check whether the called view is a text editor, in which case it would make sense to automatically display a soft input window for it.
`void`	`onConfigurationChanged(Configuration newConfig)` Called when the current configuration of the resources being used by the application have changed.
`void`	`onCreateContextMenu(ContextMenu menu)` Views should implement this if the view itself is going to add items to the context menu.
`int[]`	`onCreateDrawableState(int extraSpace)` Generate the new `Drawable` state for this view.
`InputConnection`	`onCreateInputConnection(EditorInfo outAttrs)` Create a new InputConnection for an InputMethod to interact with the view.
`void`	`onDetachedFromWindow()` This is called when the view is detached from a window.
`void`	`onDisplayHint(int hint)` Gives this view a hint about whether is displayed or not.
`boolean`	`onDragEvent(DragEvent event)` Handles drag events sent by the system following a call to `startDragAndDrop()`.
`void`	`onDraw(Canvas canvas)` Implement this to do your drawing.
`void`	`onDrawForeground(Canvas canvas)` Draw any foreground content for this view.
`final void`	`onDrawScrollBars(Canvas canvas)` Request the drawing of the horizontal and the vertical scrollbar.
`boolean`	`onFilterTouchEventForSecurity(MotionEvent event)` Filter the touch event to apply security policies.
`void`	`onFinishInflate()` Finalize inflating a view from XML.
`void`	`onFinishTemporaryDetach()` Called after `onStartTemporaryDetach()` when the container is done changing the view.
`void`	`onFocusChanged(boolean gainFocus, int direction, Rect previouslyFocusedRect)` Called by the view system when the focus state of this view changes.
`boolean`	`onGenericMotionEvent(MotionEvent event)` Implement this method to handle generic motion events.
`void`	`onHoverChanged(boolean hovered)` Implement this method to handle hover state changes.
`boolean`	`onHoverEvent(MotionEvent event)` Implement this method to handle hover events.
`void`	`onInitializeAccessibilityEvent(AccessibilityEvent event)` Initializes an `AccessibilityEvent` with information about this View which is the event source.
`void`	`onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info)` Initializes an `AccessibilityNodeInfo` with information about this view.
`boolean`	`onKeyDown(int keyCode, KeyEvent event)` Default implementation of `KeyEvent.Callback.onKeyDown()`: perform press of the view when `KEYCODE_DPAD_CENTER` or `KEYCODE_ENTER` is released, if the view is enabled and clickable.
`boolean`	`onKeyLongPress(int keyCode, KeyEvent event)` Default implementation of `KeyEvent.Callback.onKeyLongPress()`: always returns false (doesn't handle the event).
`boolean`	`onKeyMultiple(int keyCode, int repeatCount, KeyEvent event)` Default implementation of `KeyEvent.Callback.onKeyMultiple()`: always returns false (doesn't handle the event).
`boolean`	`onKeyPreIme(int keyCode, KeyEvent event)` Handle a key event before it is processed by any input method associated with the view hierarchy.
`boolean`	`onKeyShortcut(int keyCode, KeyEvent event)` Called on the focused view when a key shortcut event is not handled.
`boolean`	`onKeyUp(int keyCode, KeyEvent event)` Default implementation of `KeyEvent.Callback.onKeyUp()`: perform clicking of the view when `KEYCODE_DPAD_CENTER`, `KEYCODE_ENTER` or `KEYCODE_SPACE` is released.
`void`	`onLayout(boolean changed, int left, int top, int right, int bottom)` Called from layout when this view should assign a size and position to each of its children.
`void`	`onMeasure(int widthMeasureSpec, int heightMeasureSpec)` Measure the view and its content to determine the measured width and the measured height.
`void`	`onOverScrolled(int scrollX, int scrollY, boolean clampedX, boolean clampedY)` Called by `overScrollBy(int, int, int, int, int, int, int, int, boolean)` to respond to the results of an over-scroll operation.
`void`	`onPopulateAccessibilityEvent(AccessibilityEvent event)` Called from `dispatchPopulateAccessibilityEvent(AccessibilityEvent)` giving a chance to this View to populate the accessibility event with its text content.
`void`	`onProvideStructure(ViewStructure structure)` Called when assist structure is being retrieved from a view as part of `Activity.onProvideAssistData`.
`void`	`onProvideVirtualStructure(ViewStructure structure)` Called when assist structure is being retrieved from a view as part of `Activity.onProvideAssistData` to generate additional virtual structure under this view.
`PointerIcon`	`onResolvePointerIcon(MotionEvent event, int pointerIndex)` Returns the pointer icon for the motion event, or null if it doesn't specify the icon.
`void`	`onRestoreInstanceState(Parcelable state)` Hook allowing a view to re-apply a representation of its internal state that had previously been generated by `onSaveInstanceState()`.
`void`	`onRtlPropertiesChanged(int layoutDirection)` Called when any RTL property (layout direction or text direction or text alignment) has been changed.
`Parcelable`	`onSaveInstanceState()` Hook allowing a view to generate a representation of its internal state that can later be used to create a new instance with that same state.
`void`	`onScreenStateChanged(int screenState)` This method is called whenever the state of the screen this view is attached to changes.
`void`	`onScrollChanged(int l, int t, int oldl, int oldt)` This is called in response to an internal scroll in this view (i.e., the view scrolled its own contents).
`boolean`	`onSetAlpha(int alpha)` Invoked if there is a Transform that involves alpha.
`void`	`onSizeChanged(int w, int h, int oldw, int oldh)` This is called during layout when the size of this view has changed.
`void`	`onStartTemporaryDetach()` This is called when a container is going to temporarily detach a child, with `ViewGroup.detachViewFromParent`.
`boolean`	`onTouchEvent(MotionEvent event)` Implement this method to handle touch screen motion events.
`boolean`	`onTrackballEvent(MotionEvent event)` Implement this method to handle trackball motion events.
`void`	`onVisibilityAggregated(boolean isVisible)` Called when the user-visibility of this View is potentially affected by a change to this view itself, an ancestor view or the window this view is attached to.
`void`	`onVisibilityChanged(View changedView, int visibility)` Called when the visibility of the view or an ancestor of the view has changed.
`void`	`onWindowFocusChanged(boolean hasWindowFocus)` Called when the window containing this view gains or loses focus.
`void`	`onWindowSystemUiVisibilityChanged(int visible)` Override to find out when the window's requested system UI visibility has changed, that is the value returned by `getWindowSystemUiVisibility()`.
`void`	`onWindowVisibilityChanged(int visibility)` Called when the window containing has change its visibility (between `GONE`, `INVISIBLE`, and `VISIBLE`).
`boolean`	`overScrollBy(int deltaX, int deltaY, int scrollX, int scrollY, int scrollRangeX, int scrollRangeY, int maxOverScrollX, int maxOverScrollY, boolean isTouchEvent)` Scroll the view with standard behavior for scrolling beyond the normal content boundaries.
`boolean`	`performAccessibilityAction(int action, Bundle arguments)` Performs the specified accessibility action on the view.
`boolean`	`performClick()` Call this view's OnClickListener, if it is defined.
`boolean`	`performContextClick(float x, float y)` Call this view's OnContextClickListener, if it is defined.
`boolean`	`performContextClick()` Call this view's OnContextClickListener, if it is defined.
`boolean`	`performHapticFeedback(int feedbackConstant)` BZZZTT!!1! Provide haptic feedback to the user for this view.
`boolean`	`performHapticFeedback(int feedbackConstant, int flags)` BZZZTT!!1! Like `performHapticFeedback(int)`, with additional options.
`boolean`	`performLongClick(float x, float y)` Calls this view's OnLongClickListener, if it is defined.
`boolean`	`performLongClick()` Calls this view's OnLongClickListener, if it is defined.
`void`	`playSoundEffect(int soundConstant)` Play a sound effect for this view.
`boolean`	`post(Runnable action)` Causes the Runnable to be added to the message queue.
`boolean`	`postDelayed(Runnable action, long delayMillis)` Causes the Runnable to be added to the message queue, to be run after the specified amount of time elapses.
`void`	`postInvalidate()` Cause an invalidate to happen on a subsequent cycle through the event loop.
`void`	`postInvalidate(int left, int top, int right, int bottom)` Cause an invalidate of the specified area to happen on a subsequent cycle through the event loop.
`void`	`postInvalidateDelayed(long delayMilliseconds, int left, int top, int right, int bottom)` Cause an invalidate of the specified area to happen on a subsequent cycle through the event loop.
`void`	`postInvalidateDelayed(long delayMilliseconds)` Cause an invalidate to happen on a subsequent cycle through the event loop.
`void`	`postInvalidateOnAnimation(int left, int top, int right, int bottom)` Cause an invalidate of the specified area to happen on the next animation time step, typically the next display frame.
`void`	`postInvalidateOnAnimation()` Cause an invalidate to happen on the next animation time step, typically the next display frame.
`void`	`postOnAnimation(Runnable action)` Causes the Runnable to execute on the next animation time step.
`void`	`postOnAnimationDelayed(Runnable action, long delayMillis)` Causes the Runnable to execute on the next animation time step, after the specified amount of time elapses.
`void`	`refreshDrawableState()` Call this to force a view to update its drawable state.
`boolean`	`removeCallbacks(Runnable action)` Removes the specified Runnable from the message queue.
`void`	`removeOnAttachStateChangeListener(View.OnAttachStateChangeListener listener)` Remove a listener for attach state changes.
`void`	`removeOnLayoutChangeListener(View.OnLayoutChangeListener listener)` Remove a listener for layout changes.
`void`	`requestApplyInsets()` Ask that a new dispatch of `onApplyWindowInsets(WindowInsets)` be performed.
`void`	`requestFitSystemWindows()` This method was deprecated in API level 20. Use `requestApplyInsets()` for newer platform versions.
`final boolean`	`requestFocus(int direction)` Call this to try to give focus to a specific view or to one of its descendants and give it a hint about what direction focus is heading.
`final boolean`	`requestFocus()` Call this to try to give focus to a specific view or to one of its descendants.
`boolean`	`requestFocus(int direction, Rect previouslyFocusedRect)` Call this to try to give focus to a specific view or to one of its descendants and give it hints about the direction and a specific rectangle that the focus is coming from.
`final boolean`	`requestFocusFromTouch()` Call this to try to give focus to a specific view or to one of its descendants.
`void`	`requestLayout()` Call this when something has changed which has invalidated the layout of this view.
`boolean`	`requestRectangleOnScreen(Rect rectangle)` Request that a rectangle of this view be visible on the screen, scrolling if necessary just enough.
`boolean`	`requestRectangleOnScreen(Rect rectangle, boolean immediate)` Request that a rectangle of this view be visible on the screen, scrolling if necessary just enough.
`final void`	`requestUnbufferedDispatch(MotionEvent event)` Request unbuffered dispatch of the given stream of MotionEvents to this View.
`static int`	`resolveSize(int size, int measureSpec)` Version of `resolveSizeAndState(int, int, int)` returning only the `MEASURED_SIZE_MASK` bits of the result.
`static int`	`resolveSizeAndState(int size, int measureSpec, int childMeasuredState)` Utility to reconcile a desired size and state, with constraints imposed by a MeasureSpec.
`void`	`restoreHierarchyState(SparseArray<Parcelable> container)` Restore this view hierarchy's frozen state from the given container.
`void`	`saveHierarchyState(SparseArray<Parcelable> container)` Store this view hierarchy's frozen state into the given container.
`void`	`scheduleDrawable(Drawable who, Runnable what, long when)` Schedules an action on a drawable to occur at a specified time.
`void`	`scrollBy(int x, int y)` Move the scrolled position of your view.
`void`	`scrollTo(int x, int y)` Set the scrolled position of your view.
`void`	`sendAccessibilityEvent(int eventType)` Sends an accessibility event of the given type.
`void`	`sendAccessibilityEventUnchecked(AccessibilityEvent event)` This method behaves exactly as `sendAccessibilityEvent(int)` but takes as an argument an empty `AccessibilityEvent` and does not perform a check whether accessibility is enabled.
`void`	`setAccessibilityDelegate(View.AccessibilityDelegate delegate)` Sets a delegate for implementing accessibility support via composition (as opposed to inheritance).
`void`	`setAccessibilityLiveRegion(int mode)` Sets the live region mode for this view.
`void`	`setAccessibilityTraversalAfter(int afterId)` Sets the id of a view after which this one is visited in accessibility traversal.
`void`	`setAccessibilityTraversalBefore(int beforeId)` Sets the id of a view before which this one is visited in accessibility traversal.
`void`	`setActivated(boolean activated)` Changes the activated state of this view.
`void`	`setAlpha(float alpha)` Sets the opacity of the view to a value from 0 to 1, where 0 means the view is completely transparent and 1 means the view is completely opaque.
`void`	`setAnimation(Animation animation)` Sets the next animation to play for this view.
`void`	`setBackground(Drawable background)` Set the background to a given Drawable, or remove the background.
`void`	`setBackgroundColor(int color)` Sets the background color for this view.
`void`	`setBackgroundDrawable(Drawable background)` This method was deprecated in API level 16. use `setBackground(Drawable)` instead
`void`	`setBackgroundResource(int resid)` Set the background to a given resource.
`void`	`setBackgroundTintList(ColorStateList tint)` Applies a tint to the background drawable.
`void`	`setBackgroundTintMode(PorterDuff.Mode tintMode)` Specifies the blending mode used to apply the tint specified by `setBackgroundTintList(ColorStateList)`} to the background drawable.
`final void`	`setBottom(int bottom)` Sets the bottom position of this view relative to its parent.
`void`	`setCameraDistance(float distance)` Sets the distance along the Z axis (orthogonal to the X/Y plane on which views are drawn) from the camera to this view.
`void`	`setClickable(boolean clickable)` Enables or disables click events for this view.
`void`	`setClipBounds(Rect clipBounds)` Sets a rectangular area on this view to which the view will be clipped when it is drawn.
`void`	`setClipToOutline(boolean clipToOutline)` Sets whether the View's Outline should be used to clip the contents of the View.
`void`	`setContentDescription(CharSequence contentDescription)` Sets the `View`'s content description.
`void`	`setContextClickable(boolean contextClickable)` Enables or disables context clicking for this view.
`void`	`setDrawingCacheBackgroundColor(int color)` Setting a solid background color for the drawing cache's bitmaps will improve performance and memory usage.
`void`	`setDrawingCacheEnabled(boolean enabled)` Enables or disables the drawing cache.
`void`	`setDrawingCacheQuality(int quality)` Set the drawing cache quality of this view.
`void`	`setDuplicateParentStateEnabled(boolean enabled)` Enables or disables the duplication of the parent's state into this view.
`void`	`setElevation(float elevation)` Sets the base elevation of this view, in pixels.
`void`	`setEnabled(boolean enabled)` Set the enabled state of this view.
`void`	`setFadingEdgeLength(int length)` Set the size of the faded edge used to indicate that more content in this view is available.
`void`	`setFilterTouchesWhenObscured(boolean enabled)` Sets whether the framework should discard touches when the view's window is obscured by another visible window.
`void`	`setFitsSystemWindows(boolean fitSystemWindows)` Sets whether or not this view should account for system screen decorations such as the status bar and inset its content; that is, controlling whether the default implementation of `fitSystemWindows(Rect)` will be executed.
`void`	`setFocusable(boolean focusable)` Set whether this view can receive the focus.
`void`	`setFocusableInTouchMode(boolean focusableInTouchMode)` Set whether this view can receive focus while in touch mode.
`void`	`setForeground(Drawable foreground)` Supply a Drawable that is to be rendered on top of all of the content in the view.
`void`	`setForegroundGravity(int gravity)` Describes how the foreground is positioned.
`void`	`setForegroundTintList(ColorStateList tint)` Applies a tint to the foreground drawable.
`void`	`setForegroundTintMode(PorterDuff.Mode tintMode)` Specifies the blending mode used to apply the tint specified by `setForegroundTintList(ColorStateList)`} to the background drawable.
`void`	`setHapticFeedbackEnabled(boolean hapticFeedbackEnabled)` Set whether this view should have haptic feedback for events such as long presses.
`void`	`setHasTransientState(boolean hasTransientState)` Set whether this view is currently tracking transient state that the framework should attempt to preserve when possible.
`void`	`setHorizontalFadingEdgeEnabled(boolean horizontalFadingEdgeEnabled)` Define whether the horizontal edges should be faded when this view is scrolled horizontally.
`void`	`setHorizontalScrollBarEnabled(boolean horizontalScrollBarEnabled)` Define whether the horizontal scrollbar should be drawn or not.
`void`	`setHovered(boolean hovered)` Sets whether the view is currently hovered.
`void`	`setId(int id)` Sets the identifier for this view.
`void`	`setImportantForAccessibility(int mode)` Sets how to determine whether this view is important for accessibility which is if it fires accessibility events and if it is reported to accessibility services that query the screen.
`void`	`setKeepScreenOn(boolean keepScreenOn)` Controls whether the screen should remain on, modifying the value of `KEEP_SCREEN_ON`.
`void`	`setLabelFor(int id)` Sets the id of a view for which this view serves as a label for accessibility purposes.
`void`	`setLayerPaint(Paint paint)` Updates the `Paint` object used with the current layer (used only if the current layer type is not set to `LAYER_TYPE_NONE`).
`void`	`setLayerType(int layerType, Paint paint)` Specifies the type of layer backing this view.
`void`	`setLayoutDirection(int layoutDirection)` Set the layout direction for this view.
`void`	`setLayoutParams(ViewGroup.LayoutParams params)` Set the layout parameters associated with this view.
`final void`	`setLeft(int left)` Sets the left position of this view relative to its parent.
`void`	`setLongClickable(boolean longClickable)` Enables or disables long click events for this view.
`final void`	`setMeasuredDimension(int measuredWidth, int measuredHeight)` This method must be called by `onMeasure(int, int)` to store the measured width and measured height.
`void`	`setMinimumHeight(int minHeight)` Sets the minimum height of the view.
`void`	`setMinimumWidth(int minWidth)` Sets the minimum width of the view.
`void`	`setNestedScrollingEnabled(boolean enabled)` Enable or disable nested scrolling for this view.
`void`	`setNextFocusDownId(int nextFocusDownId)` Sets the id of the view to use when the next focus is `FOCUS_DOWN`.
`void`	`setNextFocusForwardId(int nextFocusForwardId)` Sets the id of the view to use when the next focus is `FOCUS_FORWARD`.
`void`	`setNextFocusLeftId(int nextFocusLeftId)` Sets the id of the view to use when the next focus is `FOCUS_LEFT`.
`void`	`setNextFocusRightId(int nextFocusRightId)` Sets the id of the view to use when the next focus is `FOCUS_RIGHT`.
`void`	`setNextFocusUpId(int nextFocusUpId)` Sets the id of the view to use when the next focus is `FOCUS_UP`.
`void`	`setOnApplyWindowInsetsListener(View.OnApplyWindowInsetsListener listener)` Set an `View.OnApplyWindowInsetsListener` to take over the policy for applying window insets to this view.
`void`	`setOnClickListener(View.OnClickListener l)` Register a callback to be invoked when this view is clicked.
`void`	`setOnContextClickListener(View.OnContextClickListener l)` Register a callback to be invoked when this view is context clicked.
`void`	`setOnCreateContextMenuListener(View.OnCreateContextMenuListener l)` Register a callback to be invoked when the context menu for this view is being built.
`void`	`setOnDragListener(View.OnDragListener l)` Register a drag event listener callback object for this View.
`void`	`setOnFocusChangeListener(View.OnFocusChangeListener l)` Register a callback to be invoked when focus of this view changed.
`void`	`setOnGenericMotionListener(View.OnGenericMotionListener l)` Register a callback to be invoked when a generic motion event is sent to this view.
`void`	`setOnHoverListener(View.OnHoverListener l)` Register a callback to be invoked when a hover event is sent to this view.
`void`	`setOnKeyListener(View.OnKeyListener l)` Register a callback to be invoked when a hardware key is pressed in this view.
`void`	`setOnLongClickListener(View.OnLongClickListener l)` Register a callback to be invoked when this view is clicked and held.
`void`	`setOnScrollChangeListener(View.OnScrollChangeListener l)` Register a callback to be invoked when the scroll X or Y positions of this view change.
`void`	`setOnSystemUiVisibilityChangeListener(View.OnSystemUiVisibilityChangeListener l)` Set a listener to receive callbacks when the visibility of the system bar changes.
`void`	`setOnTouchListener(View.OnTouchListener l)` Register a callback to be invoked when a touch event is sent to this view.
`void`	`setOutlineProvider(ViewOutlineProvider provider)` Sets the `ViewOutlineProvider` of the view, which generates the Outline that defines the shape of the shadow it casts, and enables outline clipping.
`void`	`setOverScrollMode(int overScrollMode)` Set the over-scroll mode for this view.
`void`	`setPadding(int left, int top, int right, int bottom)` Sets the padding.
`void`	`setPaddingRelative(int start, int top, int end, int bottom)` Sets the relative padding.
`void`	`setPivotX(float pivotX)` Sets the x location of the point around which the view is `rotated` and `scaled`.
`void`	`setPivotY(float pivotY)` Sets the y location of the point around which the view is `rotated` and `scaled`.
`void`	`setPointerIcon(PointerIcon pointerIcon)` Set the pointer icon for the current view.
`void`	`setPressed(boolean pressed)` Sets the pressed state for this view.
`final void`	`setRight(int right)` Sets the right position of this view relative to its parent.
`void`	`setRotation(float rotation)` Sets the degrees that the view is rotated around the pivot point.
`void`	`setRotationX(float rotationX)` Sets the degrees that the view is rotated around the horizontal axis through the pivot point.
`void`	`setRotationY(float rotationY)` Sets the degrees that the view is rotated around the vertical axis through the pivot point.
`void`	`setSaveEnabled(boolean enabled)` Controls whether the saving of this view's state is enabled (that is, whether its `onSaveInstanceState()` method will be called).
`void`	`setSaveFromParentEnabled(boolean enabled)` Controls whether the entire hierarchy under this view will save its state when a state saving traversal occurs from its parent.
`void`	`setScaleX(float scaleX)` Sets the amount that the view is scaled in x around the pivot point, as a proportion of the view's unscaled width.
`void`	`setScaleY(float scaleY)` Sets the amount that the view is scaled in Y around the pivot point, as a proportion of the view's unscaled width.
`void`	`setScrollBarDefaultDelayBeforeFade(int scrollBarDefaultDelayBeforeFade)` Define the delay before scrollbars fade.
`void`	`setScrollBarFadeDuration(int scrollBarFadeDuration)` Define the scrollbar fade duration.
`void`	`setScrollBarSize(int scrollBarSize)` Define the scrollbar size.
`void`	`setScrollBarStyle(int style)` Specify the style of the scrollbars.
`void`	`setScrollContainer(boolean isScrollContainer)` Change whether this view is one of the set of scrollable containers in its window.
`void`	`setScrollIndicators(int indicators, int mask)` Sets the state of the scroll indicators specified by the mask.
`void`	`setScrollIndicators(int indicators)` Sets the state of all scroll indicators.
`void`	`setScrollX(int value)` Set the horizontal scrolled position of your view.
`void`	`setScrollY(int value)` Set the vertical scrolled position of your view.
`void`	`setScrollbarFadingEnabled(boolean fadeScrollbars)` Define whether scrollbars will fade when the view is not scrolling.
`void`	`setSelected(boolean selected)` Changes the selection state of this view.
`void`	`setSoundEffectsEnabled(boolean soundEffectsEnabled)` Set whether this view should have sound effects enabled for events such as clicking and touching.
`void`	`setStateListAnimator(StateListAnimator stateListAnimator)` Attaches the provided StateListAnimator to this View.
`void`	`setSystemUiVisibility(int visibility)` Request that the visibility of the status bar or other screen/window decorations be changed.
`void`	`setTag(int key, Object tag)` Sets a tag associated with this view and a key.
`void`	`setTag(Object tag)` Sets the tag associated with this view.
`void`	`setTextAlignment(int textAlignment)` Set the text alignment.
`void`	`setTextDirection(int textDirection)` Set the text direction.
`final void`	`setTop(int top)` Sets the top position of this view relative to its parent.
`void`	`setTouchDelegate(TouchDelegate delegate)` Sets the TouchDelegate for this View.
`final void`	`setTransitionName(String transitionName)` Sets the name of the View to be used to identify Views in Transitions.
`void`	`setTranslationX(float translationX)` Sets the horizontal location of this view relative to its `left` position.
`void`	`setTranslationY(float translationY)` Sets the vertical location of this view relative to its `top` position.
`void`	`setTranslationZ(float translationZ)` Sets the depth location of this view relative to its `elevation`.
`void`	`setVerticalFadingEdgeEnabled(boolean verticalFadingEdgeEnabled)` Define whether the vertical edges should be faded when this view is scrolled vertically.
`void`	`setVerticalScrollBarEnabled(boolean verticalScrollBarEnabled)` Define whether the vertical scrollbar should be drawn or not.
`void`	`setVerticalScrollbarPosition(int position)` Set the position of the vertical scroll bar.
`void`	`setVisibility(int visibility)` Set the enabled state of this view.
`void`	`setWillNotCacheDrawing(boolean willNotCacheDrawing)` When a View's drawing cache is enabled, drawing is redirected to an offscreen bitmap.
`void`	`setWillNotDraw(boolean willNotDraw)` If this view doesn't do any drawing on its own, set this flag to allow further optimizations.
`void`	`setX(float x)` Sets the visual x position of this view, in pixels.
`void`	`setY(float y)` Sets the visual y position of this view, in pixels.
`void`	`setZ(float z)` Sets the visual z position of this view, in pixels.
`boolean`	`showContextMenu()` Shows the context menu for this view.
`boolean`	`showContextMenu(float x, float y)` Shows the context menu for this view anchored to the specified view-relative coordinate.
`ActionMode`	`startActionMode(ActionMode.Callback callback, int type)` Start an action mode with the given type.
`ActionMode`	`startActionMode(ActionMode.Callback callback)` Start an action mode with the default type `TYPE_PRIMARY`.
`void`	`startAnimation(Animation animation)` Start the specified animation now.
`final boolean`	`startDrag(ClipData data, View.DragShadowBuilder shadowBuilder, Object myLocalState, int flags)` This method was deprecated in API level 24. Use `startDragAndDrop()` for newer platform versions.
`final boolean`	`startDragAndDrop(ClipData data, View.DragShadowBuilder shadowBuilder, Object myLocalState, int flags)` Starts a drag and drop operation.
`boolean`	`startNestedScroll(int axes)` Begin a nestable scroll operation along the given axes.
`void`	`stopNestedScroll()` Stop a nested scroll in progress.
`String`	`toString()` Returns a string representation of the object.
`void`	`unscheduleDrawable(Drawable who, Runnable what)` Cancels a scheduled action on a drawable.
`void`	`unscheduleDrawable(Drawable who)` Unschedule any events associated with the given Drawable.
`final void`	`updateDragShadow(View.DragShadowBuilder shadowBuilder)` Updates the drag shadow for the ongoing drag and drop operation.
`boolean`	`verifyDrawable(Drawable who)` If your view subclass is displaying its own Drawable objects, it should override this function and return true for any Drawable it is displaying.
`boolean`	`willNotCacheDrawing()` Returns whether or not this View can cache its drawing or not.
`boolean`	`willNotDraw()` Returns whether or not this View draws on its own.

From class


  
    java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

From interface


  
    android.graphics.drawable.Drawable.Callback

From interface


  
    android.view.KeyEvent.Callback

From interface


  
    android.view.accessibility.AccessibilityEventSource

From interface


  
    android.view.SurfaceHolder.Callback2

From interface


  
    android.view.SurfaceHolder.Callback

Constants

DEBUG_CHECK_GL_ERROR

Added in API level 3

int DEBUG_CHECK_GL_ERROR

Check glError() after every GL call and throw an exception if glError indicates that an error has occurred. This can be used to help track down which OpenGL ES call is causing an error.

See also:

Constant Value: 1 (0x00000001)

DEBUG_LOG_GL_CALLS

Added in API level 3

int DEBUG_LOG_GL_CALLS

Log GL calls to the system log at "verbose" level with tag "GLSurfaceView".

See also:

Constant Value: 2 (0x00000002)

RENDERMODE_CONTINUOUSLY

Added in API level 3

int RENDERMODE_CONTINUOUSLY

The renderer is called continuously to re-render the scene.

See also:

Constant Value: 1 (0x00000001)

RENDERMODE_WHEN_DIRTY

Added in API level 3

int RENDERMODE_WHEN_DIRTY

The renderer only renders when the surface is created, or when requestRender() is called.

See also:

Constant Value: 0 (0x00000000)

Public constructors

GLSurfaceView

Added in API level 3

GLSurfaceView (Context context)

Standard View constructor. In order to render something, you must call setRenderer(GLSurfaceView.Renderer) to register a renderer.

Parameters
`context`	`Context`

GLSurfaceView

Added in API level 3

GLSurfaceView (Context context, 
                AttributeSet attrs)

Standard View constructor. In order to render something, you must call setRenderer(GLSurfaceView.Renderer) to register a renderer.

Parameters
`context`	`Context`
`attrs`	`AttributeSet`

Public methods

getDebugFlags

Added in API level 3

int getDebugFlags ()

Get the current value of the debug flags.

Returns
`int`	the current value of the debug flags.

getPreserveEGLContextOnPause

Added in API level 11

boolean getPreserveEGLContextOnPause ()

Returns
`boolean`	true if the EGL context will be preserved when paused

getRenderMode

Added in API level 3

int getRenderMode ()

Get the current rendering mode. May be called from any thread. Must not be called before a renderer has been set.

Returns
`int`	the current rendering mode.

See also:

onPause

Added in API level 3

void onPause ()

Inform the view that the activity is paused. The owner of this view must call this method when the activity is paused. Calling this method will pause the rendering thread. Must not be called before a renderer has been set.

onResume

Added in API level 3

void onResume ()

Inform the view that the activity is resumed. The owner of this view must call this method when the activity is resumed. Calling this method will recreate the OpenGL display and resume the rendering thread. Must not be called before a renderer has been set.

queueEvent

Added in API level 3

void queueEvent (Runnable r)

Queue a runnable to be run on the GL rendering thread. This can be used to communicate with the Renderer on the rendering thread. Must not be called before a renderer has been set.

Parameters
`r`	`Runnable`: the runnable to be run on the GL rendering thread.

requestRender

Added in API level 3

void requestRender ()

Request that the renderer render a frame. This method is typically used when the render mode has been set to RENDERMODE_WHEN_DIRTY, so that frames are only rendered on demand. May be called from any thread. Must not be called before a renderer has been set.

setDebugFlags

Added in API level 3

void setDebugFlags (int debugFlags)

Set the debug flags to a new value. The value is constructed by OR-together zero or more of the DEBUG_CHECK_* constants. The debug flags take effect whenever a surface is created. The default value is zero.

Parameters
`debugFlags`	`int`: the new debug flags

See also:

setEGLConfigChooser

Added in API level 3

void setEGLConfigChooser (boolean needDepth)

Install a config chooser which will choose a config as close to 16-bit RGB as possible, with or without an optional depth buffer as close to 16-bits as possible.

If this method is called, it must be called before setRenderer(Renderer) is called.

If no setEGLConfigChooser method is called, then by default the view will choose an RGB_888 surface with a depth buffer depth of at least 16 bits.

setEGLConfigChooser

Added in API level 3

void setEGLConfigChooser (GLSurfaceView.EGLConfigChooser configChooser)

Install a custom EGLConfigChooser.

If this method is called, it must be called before setRenderer(Renderer) is called.

If no setEGLConfigChooser method is called, then by default the view will choose an EGLConfig that is compatible with the current android.view.Surface, with a depth buffer depth of at least 16 bits.

setEGLConfigChooser

Added in API level 3

void setEGLConfigChooser (int redSize, 
                int greenSize, 
                int blueSize, 
                int alphaSize, 
                int depthSize, 
                int stencilSize)

Install a config chooser which will choose a config with at least the specified depthSize and stencilSize, and exactly the specified redSize, greenSize, blueSize and alphaSize.

If this method is called, it must be called before setRenderer(Renderer) is called.

If no setEGLConfigChooser method is called, then by default the view will choose an RGB_888 surface with a depth buffer depth of at least 16 bits.

Parameters
`redSize`	`int`
`greenSize`	`int`
`blueSize`	`int`
`alphaSize`	`int`
`depthSize`	`int`
`stencilSize`	`int`

setEGLContextClientVersion

Added in API level 8

void setEGLContextClientVersion (int version)

Inform the default EGLContextFactory and default EGLConfigChooser which EGLContext client version to pick.

Use this method to create an OpenGL ES 2.0-compatible context. Example:

     public MyView(Context context) {
         super(context);
         setEGLContextClientVersion(2); // Pick an OpenGL ES 2.0 context.
         setRenderer(new MyRenderer());
     }

Note: Activities which require OpenGL ES 2.0 should indicate this by setting @lt;uses-feature android:glEsVersion="0x00020000" /> in the activity's AndroidManifest.xml file.

If this method is called, it must be called before setRenderer(Renderer) is called.

This method only affects the behavior of the default EGLContexFactory and the default EGLConfigChooser. If setEGLContextFactory(EGLContextFactory) has been called, then the supplied EGLContextFactory is responsible for creating an OpenGL ES 2.0-compatible context. If setEGLConfigChooser(EGLConfigChooser) has been called, then the supplied EGLConfigChooser is responsible for choosing an OpenGL ES 2.0-compatible config.

Parameters
`version`	`int`: The EGLContext client version to choose. Use 2 for OpenGL ES 2.0

setEGLContextFactory

Added in API level 5

void setEGLContextFactory (GLSurfaceView.EGLContextFactory factory)

Install a custom EGLContextFactory.

If this method is called, it must be called before setRenderer(Renderer) is called.

If this method is not called, then by default a context will be created with no shared context and with a null attribute list.

Parameters
`factory`	`GLSurfaceView.EGLContextFactory`

setEGLWindowSurfaceFactory

Added in API level 5

void setEGLWindowSurfaceFactory (GLSurfaceView.EGLWindowSurfaceFactory factory)

Install a custom EGLWindowSurfaceFactory.

If this method is called, it must be called before setRenderer(Renderer) is called.

If this method is not called, then by default a window surface will be created with a null attribute list.

Parameters
`factory`	`GLSurfaceView.EGLWindowSurfaceFactory`

setGLWrapper

Added in API level 3

void setGLWrapper (GLSurfaceView.GLWrapper glWrapper)

Set the glWrapper. If the glWrapper is not null, its wrap(GL) method is called whenever a surface is created. A GLWrapper can be used to wrap the GL object that's passed to the renderer. Wrapping a GL object enables examining and modifying the behavior of the GL calls made by the renderer.

Wrapping is typically used for debugging purposes.

The default value is null.

Parameters
`glWrapper`	`GLSurfaceView.GLWrapper`: the new GLWrapper

setPreserveEGLContextOnPause

Added in API level 11

void setPreserveEGLContextOnPause (boolean preserveOnPause)

Control whether the EGL context is preserved when the GLSurfaceView is paused and resumed.

If set to true, then the EGL context may be preserved when the GLSurfaceView is paused. Whether the EGL context is actually preserved or not depends upon whether the Android device that the program is running on can support an arbitrary number of EGL contexts or not. Devices that can only support a limited number of EGL contexts must release the EGL context in order to allow multiple applications to share the GPU.

If set to false, the EGL context will be released when the GLSurfaceView is paused, and recreated when the GLSurfaceView is resumed.

The default is false.

Parameters
`preserveOnPause`	`boolean`: preserve the EGL context when paused

setRenderMode

Added in API level 3

void setRenderMode (int renderMode)

Set the rendering mode. When renderMode is RENDERMODE_CONTINUOUSLY, the renderer is called repeatedly to re-render the scene. When renderMode is RENDERMODE_WHEN_DIRTY, the renderer only rendered when the surface is created, or when requestRender() is called. Defaults to RENDERMODE_CONTINUOUSLY.

Using RENDERMODE_WHEN_DIRTY can improve battery life and overall system performance by allowing the GPU and CPU to idle when the view does not need to be updated.

This method can only be called after setRenderer(Renderer)

Parameters
`renderMode`	`int`: one of the RENDERMODE_X constants

See also:

setRenderer

Added in API level 3

void setRenderer (GLSurfaceView.Renderer renderer)

Set the renderer associated with this view. Also starts the thread that will call the renderer, which in turn causes the rendering to start.

This method should be called once and only once in the life-cycle of a GLSurfaceView.

The following GLSurfaceView methods can only be called before setRenderer is called:

The following GLSurfaceView methods can only be called after setRenderer is called:

Parameters
`renderer`	`GLSurfaceView.Renderer`: the renderer to use to perform OpenGL drawing.

surfaceChanged

Added in API level 3

void surfaceChanged (SurfaceHolder holder, 
                int format, 
                int w, 
                int h)

This method is part of the SurfaceHolder.Callback interface, and is not normally called or subclassed by clients of GLSurfaceView.

Parameters
`holder`	`SurfaceHolder`: The SurfaceHolder whose surface has changed.
`format`	`int`: The new PixelFormat of the surface.
`w`	`int`: The new width of the surface.
`h`	`int`: The new height of the surface.

surfaceCreated

Added in API level 3

void surfaceCreated (SurfaceHolder holder)

This method is part of the SurfaceHolder.Callback interface, and is not normally called or subclassed by clients of GLSurfaceView.

Parameters
`holder`	`SurfaceHolder`: The SurfaceHolder whose surface is being created.

surfaceDestroyed

Added in API level 3

void surfaceDestroyed (SurfaceHolder holder)

This method is part of the SurfaceHolder.Callback interface, and is not normally called or subclassed by clients of GLSurfaceView.

Parameters
`holder`	`SurfaceHolder`: The SurfaceHolder whose surface is being destroyed.

surfaceRedrawNeeded

Added in API level 24

void surfaceRedrawNeeded (SurfaceHolder holder)

This method is part of the SurfaceHolder.Callback interface, and is not normally called or subclassed by clients of GLSurfaceView.

Parameters
`holder`	`SurfaceHolder`: The SurfaceHolder whose surface has changed.

Protected methods

finalize

Added in API level 3

void finalize ()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. A subclass overrides the finalize method to dispose of system resources or to perform other cleanup.

The general contract of finalize is that it is invoked if and when the Java^TM virtual machine has determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, except as a result of an action taken by the finalization of some other object or class which is ready to be finalized. The finalize method may take any action, including making this object available again to other threads; the usual purpose of finalize, however, is to perform cleanup actions before the object is irrevocably discarded. For example, the finalize method for an object that represents an input/output connection might perform explicit I/O transactions to break the connection before the object is permanently discarded.

The finalize method of class Object performs no special action; it simply returns normally. Subclasses of Object may override this definition.

The Java programming language does not guarantee which thread will invoke the finalize method for any given object. It is guaranteed, however, that the thread that invokes finalize will not be holding any user-visible synchronization locks when finalize is invoked. If an uncaught exception is thrown by the finalize method, the exception is ignored and finalization of that object terminates.

After the finalize method has been invoked for an object, no further action is taken until the Java virtual machine has again determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, including possible actions by other objects or classes which are ready to be finalized, at which point the object may be discarded.

The finalize method is never invoked more than once by a Java virtual machine for any given object.

Any exception thrown by the finalize method causes the finalization of this object to be halted, but is otherwise ignored.

Throws
`Throwable`

onAttachedToWindow

Added in API level 3

void onAttachedToWindow ()

This method is used as part of the View class and is not normally called or subclassed by clients of GLSurfaceView.

onDetachedFromWindow

Added in API level 3

void onDetachedFromWindow ()

This is called when the view is detached from a window. At this point it no longer has a surface for drawing.

Most visited

Recently visited

Results for

GLSurfaceView

Developer Guides

Using GLSurfaceView

Initializing GLSurfaceView

Specifying the android.view.Surface

Choosing an EGL Configuration

Debug Behavior

Setting a Renderer

Rendering Mode

Activity Life-cycle

Handling events

Summary

Nested classes

Inherited XML attributes

Constants

Inherited constants

Inherited fields

Public constructors

Public methods

Protected methods

Inherited methods

Constants

DEBUG_CHECK_GL_ERROR

DEBUG_LOG_GL_CALLS

RENDERMODE_CONTINUOUSLY

RENDERMODE_WHEN_DIRTY

Public constructors

GLSurfaceView

GLSurfaceView

Public methods

getDebugFlags

getPreserveEGLContextOnPause

getRenderMode

onPause

onResume

queueEvent

requestRender

setDebugFlags

setEGLConfigChooser

setEGLConfigChooser

setEGLConfigChooser

setEGLContextClientVersion

setEGLContextFactory

setEGLWindowSurfaceFactory

setGLWrapper

setPreserveEGLContextOnPause

setRenderMode

setRenderer

surfaceChanged

surfaceCreated

surfaceDestroyed

surfaceRedrawNeeded

Protected methods

finalize

onAttachedToWindow

onDetachedFromWindow