Skip to content

iammert/Frames

Repository files navigation

What is Frames?

Frames library retrieves frames from video. It loads frames lazily under the hood. You can customize your frame fetching request as you need.

What is FrameRequest?

There are 3 types of frame request.

SingleFrameRequest

If you want to fetch a specific frame at the specific duration.

val singleFrameRequest = FrameRetrieveRequest.SingleFrameRequest(
    videoPath = "/storage/emulated/0/Download/sample.mp4",
    frameWidth = 400,
    frameHeight = 300,
    durationInMillis = 5213
)

MultiFrameRequest

If you want to fetch all frames with given interval. For instance, If you have 40 seconds video and frame duration is 2 second, Frames library gives you 20 frames.

val multiFrameRequest = FrameRetrieveRequest.MultipleFrameRequest(
    videoPath = "/storage/emulated/0/Download/sample.mp4",
    frameWidth = 400,
    frameHeight = 300,
    durationPerFrame = 2000
)

RangeFrameRequest

If you want to fetch frames with specific range from video with given interval. For instance, you have 40 seconds video and you want to fetch frames between 5. and 15. seconds.

val rangeFrameRequest = FrameRetrieveRequest.RangeFrameRequest(
    videoPath = "/storage/emulated/0/Download/sample.mp4",
    frameWidth = 400,
    frameHeight = 300,
    durationPerFrame = 4000,
    startDuration = 5000,
    endDuration = 15000
)

How to load frames?

Add to XML

 <com.momentolabs.frameslib.ui.view.VideoFramesLayout
      android:id="@+id/layoutFramesLayout"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"/>

Load

Frames.load(frameRequest).into(layoutFramesLayout)

Load frame bitmaps manually

Frames
    .load(frameRetrieveRequest)
    .into { framesResource ->
        when (framesResource.status) {
            Status.EMPTY_FRAMES -> // emit all empty frames initially. (you can draw your own custom view with this)
            Status.LOADING -> // Lazily emits frames while loading. This scope will be called serially until all frames loaded
            Status.COMPLETED -> // Called when all frames loaded.
        }
    }

You can also change provider type.

Frames
    .load(frameRetrieveRequest)
    .setProviderType(ProviderType.FFMPEG or ProviderType.NATIVE_ANDROID)
    .into{...}

How does it work behind the scene?

Notes

  • Before using Frames library, ask for the READ_EXTERNAL_STORAGE permission.

Setup

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.iammert:Frames:0.3'
}

License

Copyright 2019 Mert Şimşek

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.