Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/iammert/frames

Retrieves desired frames from video.
https://github.com/iammert/frames

android customview ffmpeg frames frameslayout kotlin mp4 video video-frames view

Last synced: 3 months ago
JSON representation

Retrieves desired frames from video.

Host: GitHub
URL: https://github.com/iammert/frames
Owner: iammert
Created: 2019-08-07T09:08:30.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2020-01-16T14:56:56.000Z (about 5 years ago)
Last Synced: 2024-03-03T00:33:52.037Z (11 months ago)
Topics: android, customview, ffmpeg, frames, frameslayout, kotlin, mp4, video, video-frames, view
Language: Kotlin
Homepage:
Size: 2.16 MB
Stars: 56
Watchers: 3
Forks: 9
Open Issues: 2
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

## 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.

```kotlin
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.

```kotlin
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.

```kotlin
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
```xml

```

### Load
```kotlin
Frames.load(frameRequest).into(layoutFramesLayout)
```

### Load frame bitmaps manually
```kotlin
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.
```kotlin
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

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

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

License
--------

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.