VidEffects
This is an Android library which can be used to apply different Filters/Effects on videos. It uses vertexShaders and fragmentShaders to apply effects on GLSurfaceView. It uses MediaPlayer instance for playing videos on GlSurfaceView. See the sample app in order to see a working demo.
Change Log
1.1.0 - Added ability to save video once you apply a FILTER (not EFFECT), Updated Sample app with a detailed example,
Supported Effects
The following list of effects are currently avaialble and can be applied using VidEffects
- AutoFix Effect
- Black and White Effect
- Brightness Effect
- Contrast Effect
- CrossProcess Effect
- Documentary Effect
- Duotone Effect
- FillLight Effect
- Grain Effect
- Greyscale Effect
- Lamoish Effect
- InvertColors Effect
- Posterize Effect
- Saturation Effect
- Sepia Effect
- Sharpness Effect
- Temperature Effect
- Tint Effect
- Vignette Effect
- Hue Effect
- Gamma Effect
Limitations
- The effects applied using this library are temporary. What that means is that the original video doesn't change. Effects are only applied during video playback and once the video ends the effects end with it.
- Minimum Supported Android version is 21 (Lollipop)
- Saving video available only for Filters and requires Android 23 min api version.For more information check the file VideoController.
- Other ways to save video once effect/filter is applied FFmpeg to apply effects on videos. Details about how to do that can be seen on this wiki page
- Some emulators have problems during video playback so try on real device when that happens e.g: Android Lollipop emulators don't show video.
How to use it
- Add the following code to your project's
build.gradlefile
repositories {
jcenter()
}
- Add the following gradle path to your
app/build.gradlefile
dependencies {
// Gradle path for VidEffects
implementation "com.sherazkhilji.videffects:videffects:1.1.0"
}
- Then you need to add
VideoSurfaceVieweither usingjava codeor asxmlin yourlayoutfile.
<com.sherazkhilji.videffect.view.VideoSurfaceView
android:id="@+id/mVideoSurfaceView"
android:layout_width="match_parent"
android:layout_height="match_parent" />
- Then you need to reference the
VideoSurfaceViewand call itsinit()method in yourActivityorFragmentonCreate()supplying it with aMediaPlayerinstance and aVideo Effect. Also you would need to callVideoSurfaceViewonResume()in yourActivityorFragmentonResume()so that your video is rendered properly.
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mResources = getResources();
mMediaPlayer = new MediaPlayer();
try {
// Load video file from SD Card
// File dir = Environment
// .getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
// File file = new File(dir,
// "sample.mp4");
// mMediaPlayer.setDataSource(file.getAbsolutePath());
// -----------------------------------------------------------------------
// Load video file from Assets directory
AssetFileDescriptor afd = getAssets().openFd("sample.mp4");
mMediaPlayer.setDataSource(afd.getFileDescriptor(),
afd.getStartOffset(), afd.getLength());
} catch (Exception e) {
Log.e(TAG, e.getMessage(), e);
}
// Initialize VideoSurfaceView using code
// mVideoView = new VideoSurfaceView(this);
// setContentView(mVideoView);
// or
mVideoView = (VideoSurfaceView) findViewById(R.id.mVideoSurfaceView);
mVideoView.init(mMediaPlayer,
new DuotoneEffect(Color.YELLOW, Color.RED));
setContentView(R.layout.activity_sampleplayer);
}
@Override
protected void onResume() {
super.onResume();
mVideoView.onResume();
}
- Incase of any confusion, check the file SamplePlayerActivity for a complete example on how to apply different
Effectson your videos. - For Advance implementation and saving Filters, check the file VideoActivity
See it in working
Video screenshot without any Effect
Video screenshot with Black and White Effect
Video screenshot with Invert Colors Effect
Special Thanks to
-
Sisik blog posts about converting video and audio files with MediaCodec and Muxer.
-
This blog post by Ashraff Hathibelagal for easing the process of learning Opengl and explaining how to apply effects on images.
-
GrepCode For providing me with Android source code which were helpful in writing video effects/filters.
-
MediaPlayerSurface by crossle It helped me in playing video using a GlsurfaceView.
-
Fadden who is the writer of grafika for pointing me towards right direction on how to apply effects on a video.
-
Intel INDE Media for Mobile Tutorials for the sample app and helping me getting familiar with how fragmentShaders work.
-
Umair Shafique for authoring How to apply permanent effect using FFmpeg wiki page
Development
Want to contribute or add some new Effects? Great! Fork it and send me a pull request or contact me on the email below, if you want to become a permanant contributor.
Developed by
- Sheraz Ahmed Khilji - [email protected]
License
Copyright 2020 Sheraz Ahmed Khilji
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.
180 Nov 25, 2022
56 Oct 3, 2022
198 Dec 28, 2022
2k Dec 20, 2022
847 Dec 30, 2022
166 Nov 12, 2022
5.4k Dec 9, 2022
36 Oct 16, 2022
13 Dec 29, 2022
2 Apr 28, 2022
1 Dec 30, 2021
1 Oct 25, 2021
989 Nov 17, 2022
2.2k Jan 9, 2023
8.6k Dec 28, 2022
3.2k Jan 5, 2023