Skip to content

Latest commit

 

History

History
171 lines (132 loc) · 10.4 KB

README.md

File metadata and controls

171 lines (132 loc) · 10.4 KB

VidEffects

Android Arsenal

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.

Img

Change Log

1.1.0 - Added ability to save video once you apply a FILTER (not EFFECT), Updated Sample app with a detailed example, (Available on Jcenter)
1.1.1 - Updated Dependencies & Published the videffects to MavenCentral. All future versions from now onwards will be distributed via MavenCentral.

Supported Effects

The following list of effects are currently avaialble and can be applied using VidEffects

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.gradle file
  repositories {
        mavenCentral()
    }
  • Add the following gradle path to your app/build.gradle file
dependencies {
//	Gradle path for VidEffects
   	implementation "com.github.krazykira:videffects:1.1.1"
}
  • Then you need to add VideoSurfaceView either using java code or as xml in your layout file.
<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 VideoSurfaceView and call its init() method in your Activity or Fragment onCreate() supplying it with a MediaPlayer instance and a Video Effect. Also you would need to call VideoSurfaceView onResume() in your Activity or Fragment onResume() 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 Effects on your videos.
  • For Advance implementation and saving Filters, check the file VideoActivity

See it in working

Video screenshot without any Effect

Video screenshot without any Effect

Video screenshot with Black and White Effect

Video screenshot with Black and White Effect

Video screenshot with Invert Colors Effect

Video screenshot with Invert Colors Effect

Special Thanks to

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

License

Copyright 2022 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.