OpenGL Canvas

English README

此项目灵感来源:

• Android package com.android.gallery3d.glrenderer 下的源代码
• GPUImage
• grafika

感谢这些源代码提供者！

项目应用

• AndroidInstantVideo

功能

• 提供一个类似Android Canvas类的使用OpenGL来实现绘制的canvasGL。可以像传统自定义View那样直接继承 GLViews, 再使用这个canvas绘制需要的东西。

• 提供类似 GPUImage 里的Filter的API，可以在使用canvasGL画东西时实现图像处理。

• 提供的View是继承 GLSurfaceView 或 TextureView 的，可以使用这两种View的特性，特别是TextureView的特性。

• 另外,因为使用OpenGL在另一线程渲染，所以里面的 GLContinuousView 还提供能够实现高性能的动画的方法。（如果只要这个功能不要其它得话，那么我建议你直接继承View，见浅析Android的canvas性能）

与GPUImage对比：

• 提供无限循环渲染线程的 GLContinuousView 和 GLContinuousTextureView。
• 使用TextureView来实现OpenGL的绘制，可以利用TextureView的优点--TextureView 不会创建一个分离的window，而是像一个普通的view那样显示， 这样就不会像GLSurfaceView那样，要么在所有View上方，要么被其它View遮住(看 setZOrderOnTop(boolean) 的说明)。而且像myView.setAlpha(0.5f)这种方法调用后也会有效果了。
• 提供一个canvas，不只是图片处理，可以画上想画的其它东西。

使用要求

• Android API 14 以上(OpenGL ES 2.0 以上)。 建议21以上

用法

Gradle dependency

sample:

// in root build.gradle
allprojects {
    repositories {
        jcenter()
        maven { url "https://jitpack.io" }
    }
}

// module build.gradle
dependencies {
    implementation 'com.github.ChillingVan:android-openGL-canvas:v1.5.4.0'
}

样例代码

• 自定义一个View.

public class MyGLView extends GLView {

    public MyGLView(Context context) {
        super(context);
    }

    public MyGLView(Context context, AttributeSet attrs) {
        super(context, attrs);
    }


    @Override
    protected void onGLDraw(ICanvasGL canvas) {
        // draw things with canvas here
    }
}

• 其中, GLContinuouslyView, GLTextureView, GLContinuousTextureView, GLMultiTexProducerView and GLMultiTexConsumerView 用法相似.

• 使用CanvasGL实现绘制

        canvas.drawBitmap(textBitmap, left, top);
        
        // transform
        canvas.save();
        canvas.rotate(rotateDegree, x, y);
        canvas.drawBitmap(bitmap, left, top);
        canvas.restore();
        // or
        CanvasGL.BitmapMatrix matrix = new CanvasGL.BitmapMatrix();
        matrix.postScale(2.1f, 2.1f);
        matrix.postRotate(90);
        canvas.drawBitmap(bitmap, matrix);
        
        // apply filter to the bitmap
        textureFilter = new ContrastFilter(2.8f);
        canvas.drawBitmap(bitmap, left, top, textureFilter);

• 可以与Camera结合，注意运行样例代码的时候尽量使用真机而不是模拟器。

• 如果不想使用View，可以使用 MultiTexOffScreenCanvas 实现脱离屏幕的绘制，然后使用getDrawingBitmap方法获取绘制的内容。

• MediaPlayer

可以用 MediaPlayer 去解码视频，并绘制到 TextureView 上。 如果用本项目里的 GLSurfaceTextureProducerView ，那么还可以做视频处理。 结合AndroidInstantVideo的stream publisher，就能生成新视频。

• AndroidCanvasHelper

这个GLCanvas不能绘制文本。只能先把文本转成Bitmap来绘制 可以使用AndroidCanvasHelper来画任意东西再转化为Bitmap给GLCanvas 这有同步和异步模式，视情况用对应的模式，详细请看例子。

• 更多用例请查看wiki

注意事项和常见问题

• 每一个View的onGLDraw都运行在自己的线程而非主线程。

• 目前的Filter没有GPUImage里那么多，如果有需要，参照我的代码自己实现即可，难度不高。

• 为什么Bitmap修改后，再次绘制时并没更新？

  因为没有调用canvasGL的invalidateTextureContent(bitmap)。改变了的Bitmap需要重新绑定texture。因为绑定需要耗时，所以库里面才不做成每次都重新绑定。

• CanvasGL里面没有drawPath或者drawText，要实现的话本库提供了IAndroidCanvasHelper，但这个只是用安卓自己的canvas生成一个Bitmap，所以要注意性能

相关博客文章

• OpenGL绘制一张图片的流程
• 如何封装 opengl 流程
• 代替GLSurfaceView的GLTextureView
• 为什么你的canvas那么慢？浅析Android的canvas性能

最近更新

• 添加高斯模糊 & 修复FilterGroup ViewPort 宽高问题（1.5.4 感谢@iffly))
• 添加录屏demo
• 添加clearTextureCache，比弱引用更快释放内存 (1.5.2)
• AndroidCanvasHelper能直接操作Canvas里的bitmap了 (1.5.2)
• TwoTextureFilter支持RawTexture了
• drawSurfaceTexture也支持BitmapMatrix了
• 添加OrthoBitmapMatrix以支持正交投影。 默认BitmapMatrix用的是透视投影。
• 支持裁切图片的CropFilter
• 增加 MultiTexOffScreenCanvas, GLMultiTexProducerView, GLMultiTexConsumerView，支持提供多张纹理的和消化多张纹理

License

Copyright 2016 ChillingVan.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on
 an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.