net.majorkernelpanic.streaming.gl

Class SurfaceView

java.lang.Object

android.view.SurfaceView

net.majorkernelpanic.streaming.gl.SurfaceView

All Implemented Interfaces:

java.lang.Runnable

public class SurfaceView
extends android.view.SurfaceView
implements java.lang.Runnable

An enhanced SurfaceView in which the camera preview will be rendered. This class was needed for two reasons.
First, it allows to use to feed MediaCodec with the camera preview using the surface-to-buffer method while rendering it in a surface visible to the user. To force the surface-to-buffer method in libstreaming, call MediaStream.setStreamingMethod(byte) with MediaStream.MODE_MEDIACODEC_API_2.
Second, it allows to force the aspect ratio of the SurfaceView to match the aspect ratio of the camera preview, so that the preview do not appear distorted to the user of your app. To do that, call setAspectRatioMode(int) with ASPECT_RATIO_PREVIEW after creating your SurfaceView.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	SurfaceView.ViewAspectRatioMeasurer This class is a helper to measure views that require a specific aspect ratio.

Field Summary

Fields

Modifier and Type	Field and Description
static int	ASPECT_RATIO_PREVIEW The aspect ratio of the surface view will be equal to the aspect ration of the camera preview.
static int	ASPECT_RATIO_STRETCH The surface view will fill completely fill its parent.
static java.lang.String	TAG

Constructor Summary

Constructors

Constructor and Description
SurfaceView(Context context, AttributeSet attrs)

Method Summary

Modifier and Type	Method and Description
void	addMediaCodecSurface(Surface surface)
SurfaceTexture	getSurfaceTexture()
void	onFrameAvailable(SurfaceTexture surfaceTexture)
void	removeMediaCodecSurface()
void	requestAspectRatio(double aspectRatio) Requests a certain aspect ratio for the preview.
void	run()
void	setAspectRatioMode(int mode)
void	startGLThread()
void	surfaceChanged(SurfaceHolder holder, int format, int width, int height)
void	surfaceCreated(SurfaceHolder holder)
void	surfaceDestroyed(SurfaceHolder holder)

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final java.lang.String TAG

See Also:

Constant Field Values

ASPECT_RATIO_PREVIEW

public static final int ASPECT_RATIO_PREVIEW

The aspect ratio of the surface view will be equal to the aspect ration of the camera preview.

See Also:

Constant Field Values

ASPECT_RATIO_STRETCH

public static final int ASPECT_RATIO_STRETCH

The surface view will fill completely fill its parent.

See Also:

Constant Field Values

Constructor Detail

SurfaceView

public SurfaceView(Context context,
                   AttributeSet attrs)

Method Detail

setAspectRatioMode

public void setAspectRatioMode(int mode)

getSurfaceTexture

public SurfaceTexture getSurfaceTexture()

addMediaCodecSurface

public void addMediaCodecSurface(Surface surface)

removeMediaCodecSurface

public void removeMediaCodecSurface()

startGLThread

public void startGLThread()

run

public void run()

Specified by:

run in interface java.lang.Runnable

onFrameAvailable

public void onFrameAvailable(SurfaceTexture surfaceTexture)

surfaceChanged

public void surfaceChanged(SurfaceHolder holder,
                           int format,
                           int width,
                           int height)

surfaceCreated

public void surfaceCreated(SurfaceHolder holder)

surfaceDestroyed

public void surfaceDestroyed(SurfaceHolder holder)

requestAspectRatio

public void requestAspectRatio(double aspectRatio)

Requests a certain aspect ratio for the preview. You don't have to call this yourself, the VideoStream will do it when it's needed.