Skip to content

Commit

Permalink
Documentation Updated
Browse files Browse the repository at this point in the history
  • Loading branch information
vermavinay982 committed Aug 28, 2021
1 parent e62a117 commit a4e8bdc
Show file tree
Hide file tree
Showing 5 changed files with 97 additions and 8 deletions.
51 changes: 47 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,60 @@
# vigenpy
Video Generation Package
## Video Generation Package

Project URL: https://pypi.org/project/vigenpy/
Github URL: https://github.com/vermavinay982/vigenpy
- Project URL: https://pypi.org/project/vigenpy/
- Github URL: https://github.com/vermavinay982/vigenpy

Having 2 videos and you want to merge them? Tell what side by side, top and bottom, or just wrt time - you can do that too just by choosing the axis where you want to attach the video at.

## Installing Library
```bash
pip install vigenpy
```


Suppose you have trained a model, and want to run comparison on 2 different videos at same time. This tool will help you to choose any axis of placing the frame - you can directly stack 2 videos like lego bricks and it will work for you as single video. You can even process 2 videos individually with different ML model and can put them side by side for comparison - cool just give their path - rest the algo will deal with it. you can even process indiviually and process it later - its very easy.

`Future update` will have shuffle too - meaning one frame of 1st then one from 2nd then again from 1st.
Its upto you what amazing you can do with this tool. Feel free to contribute and add more features in this package.

`vigenpy` is a video generation library. It enables the developer to generate a new video by merging 2 or more videos in one video.
It is a flexible library that provides you total flexibility.

# Axis Stacking
It has 3 axis - axis 0 - horizontal x axis - side by side videos
- axis 1 - vertical y axis - top and bottom merge of videos
- axis 2 - that is back to back - video will be generated combining the 2 videos in time axis
- axis 3 - shuffle in the middle - one frame this another that - again first 1,2,1,2,1,2.....

The video path or the stream path is given as list
and based on the list - the precedence is decided for stacking the video together

## There are multiple modes in the code
1. Show Video as Output:
just show the combined video to the user
you can just pass the frames and it will merge it to create video output
or if you want to show you can do

2. Video Output Generation:
provide the path of output and the program will generate a video merged for you
you can set the time or #frames to get the generated video for.
initially the longer video - and shorter video will run on loop until longer one is over
or the shorter video will be used to break the loop irrespective of longer video time
use_time_of = 0,1 whatever - that will be used to generate the video

3. if you want to fetch frames that are merged so you can do other things
that you can process the frames and use it at your end.


## Sample Code to Start Using
```python
from vigenpy.video import stack_video

videos = ['archery.mp4','cycling.mp4']
stack_video(videos, axis=0)
```
```


- License: Proprietary
- Author: [Vinay Kumar Verma](mailto:vermavinay982@gmail.com)
- Maintainer: [Vinay Kumar Verma](mailto:vermavinay982@gmail.com)
41 changes: 41 additions & 0 deletions documentation
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
Having 2 videos and you want to merge them? Tell what side by side, top and bottom, or just wrt time - you can do that too just by choosing the axis where you want to attach the video at.

Suppose you have trained a model, and want to run comparison on 2 different videos at same time. This tool will help you to choose any axis of placing the frame - you can directly stack 2 videos like lego bricks and it will work for you as single video. You can even process 2 videos individually with different ML model and can put them side by side for comparison - cool just give their path - rest the algo will deal with it. you can even process indiviually and process it later - its very easy

Future update will have shuffle too - meaning one frame of 1st then one from 2nd then again from 1st.
Its upto you what amazing you can do with this tool. Feel free to contribute and add more features in this package.

vigenpy is a video generation library. It enables the developer to generate a new video by merging 2 or more videos in one video.
It is a flexible library that provides you total flexibility.

It has 3 axis - axis 0 - horizontal x axis - side by side videos
axis 1 - vertical y axis - top and bottom merge of videos
axis 2 - that is back to back - video will be generated combining the 2 videos in time axis
axis 3 - shuffle in the middle - one frame this another that - again first 1,2,1,2,1,2.....

the video path or the stream path is given as list
and based on the list - the precedence is decided for stacking the video together


there are multiple modes in the code
1. Show Video as Output:
just show the combined video to the user
you can just pass the frames and it will merge it to create video output
or if you want to show you can do

2. Video Output Generation:
provide the path of output and the program will generate a video merged for you
you can set the time or #frames to get the generated video for.
initially the longer video - and shorter video will run on loop until longer one is over
or the shorter video will be used to break the loop irrespective of longer video time
use_time_of = 1,0 whatever - that will be used to generate the video

3. if you want to fetch frames that are merged so you can do other things
that you can process the frames and use it at your end.


size (w,h) for each video you are having
creating a grid of videos 2 merged top bottom other left right
have to use blank numpy for no video part
flag for write, show
function to get frame to process further
2 changes: 1 addition & 1 deletion notes.txt
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,6 @@ from .class1 import class1
from .class2 import class2



Uploading library
python .\setup.py sdist bdist_wheel
twine upload dist/*
9 changes: 6 additions & 3 deletions setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -3,18 +3,21 @@
with open('readme.md','r') as f:
long_desc = f.read()

with open('short_desc.txt','r') as f:
short_desc = f.read()

with open('requirements.txt','r') as f:
requirements = f.read()


requirements = requirements.split('\n')

setup(
name='vigenpy',
version='0.1.0',
description=long_desc,
version='0.1.3',
description=short_desc,
license='Proprietary',
long_description=long_desc,
long_description_content_type='text/markdown',
author='Vinay Verma',
maintainer='Vinay Verma',
maintainer_email='vermavinay982@gmail.com',
Expand Down
2 changes: 2 additions & 0 deletions short_desc.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
A video generation library, vigenpy . It enables the developer to generate a new video by merging 2 or more videos in one video.
It is a flexible library that provides you total flexibility in generating videos by stacking them. You can also use them as input to your Code. COOL.

0 comments on commit a4e8bdc

Please sign in to comment.