DepthFlow UX Helper

About

 DepthFlow UX by SubLevel10 Technologies is a User Experience wrapper for DepthFlow
 Making it easier for everybody to use the scripts, with easy to use presets with option sliders for intensity, depth, and more
 If you're experienced in command line usage of DepthFlow
 There is an 'expert mode' where you can input your own codes.
 Python 3.10 is included with all neccessary packages pre-installed and
 Depth Anything v2 (small) model included and used by default
 Other models can be downloaded and used from the config page


Main Page

Input Image

This will open a window where you can browse to the image you would like to make into an animated video.

Acceptable input file types are:
.jpg
.jpeg
.png
.tif
.tiff
.bmp
.webp
Any other file types will not show up in the pop up window.

Presets and Samples

The presets are pre-coded animations that will be applied to your image
click the 'sample' text above each one to view a sample of the animation

Choices and samples are:

./videos/orbital.mp4

Orbit

./videoss/circle.mp4

Circle

./videos/dolly.mp4

Dolly


./videos/zoom.mp4

Zoom

./videos/vertical.mp4

Vertical

./videos/horizontal.mp4

Horizontal

Siders

With each preset animation, certain sliders and input boxes are available.
You can use the slider to change the amount,
or type in the amount desired into the box, without using the slider.
The slider position does not matter. The number in the box is what that the program uses

DURATION - Controls the duration (length) of the animation.
                  The animation will be as long or short as you want to set it.
                  The longer the duration, the slower the animation.
                  You can also use decimals. example 8 or 9.75 or 12.36

INTENSITY - Controls the intensity of the movement in the animation.
                  The higher the intensity,
                  The more movement in the animations

PHASE - Controls the shift of the wave the animation uses
             The animations use waves such as Sine, Cosine, and Triangle

STATIC - Controls the camera movement displacement depth.
             The higher this value, the more (background) movement

DEPTH - Controls the focal depth of this animation
             The higher this value, the more background movement and less foreground movement
             The lower this value, the more foreground movement and less background movement

BIAS - Controls the bias of the animation.
          If your output video has streaks between
          some of the near and far objects,
          change this setting.
          It may take a few trys to get it right for the input image

Video Size

You can choose the output size of the video.
Type in a size and choose 'width' or 'height'
We will not stretch your image.

If you choose width,
we will figure out the height by getting info from the input image.

If you choose height,
we will figure out the width by getting info from the input image.

FPS

Frames Per Second
How many frames per second you want.
You can type in any number, default is 30
but the common ones are

60 = Better (crisper, but larger file size due to twice as many frames)
30 = most common - web videos, live tv, sports, soap operas
24 = cinema - tv and film

anything below 24 can be noticably choppy.

Loop

This controls if the animation loops or not

Some types, such as Orbital, do not have this option.

With Zoom, for example, with a looped animation,
the video will zoom in and then out, to make a perfect loop.
Un-checking loop will just zoom in for the total length of the video.

Unlooped animations are half the speed of looped animations,
but the same length.

Play After Processing

If this is checked,
The output video will play automatically
when processing is finished.

When unchecked, nothing will happen when the processing window closes.

You can always click the button to play the output video
click the button to view the input image
click the button to open the folder of the input or output

Rotate

Some Images from older phones used in landscape mode,
get flipped into portrait mode during processing.

If your output video is sideways and you want to rotate it,
click the button
To open a pop up screen, where you can rotate the video clockwise or counter clockwise.

Save Custom

If you tweak a preset, and want to save where all the sliders are set
so you can use the same settings anytime
Use this button
It only save one custom setting, so clicking again will overwrite any old custom saves.

Load Custom

If you saved a custom preset, clicking this will load all the settings

Expert Mode

If you want to type in your own codes to send to DepthFlow (python)
see Expert Mode


Expert Mode

Command Line Box

Type in your code(s) in the box provided
This will send the -m DepthFlow command to python with your code(s) after.
So ... Do not include Python or -m DepthFlow in the beginning
Escape special characters with \
Input and output locations should be in " " (quotes)

example... dav2 --model small zoom --loop input -i "C:\Users\blah\blah\pic.jpg" main -o "C:\Users\foo\bar\pic_zoom.mp4" -w 800 --fps 30 --time 9.0

We (try) to find your output video from this box and play it automatically when finished processing.

All CMD window are shown (not minimized) so you can see what's going on.
If there is an error in your code, it will not be processed and the CMD will quickly close.

Rotate Output Video

When processing is finished, a rotate button will become available on the bottom right, if you need to rotate the output video.

Post Process Dolly Glitch

While we automatically fix a glitch in the 'dolly' preset that shows 2 flashes during the video (sometimes),
In expert mode, if you use the dolly preset, and end up with 2 flashes in the output video
You'll have to click the 'Post Process Dolly Glitch' button on the bottom left.
A window will pop up, where we try to fix the flashes
You can also pick the 2 frames to remove, if our auto-fix doesn't get it right.

History

The last 5 codes sent to DepthFlow are saves here
If you click the 'reload' button, that coresponding line will be re-loaded into the command line box.


Info


Information about SubLevel10 Technologies


Config


Default Output Folder

By default, the final output video will be created in the same folder as the input image, with a few numbers attached to the name.
If you want all the video to be created in a specific folder, for example a folder on the desktop named Output
you can set that up here

Output Video Type

By default, the output video is an mp4
you can change this here, and the new output type will be selected evrey time on the main page.

Choices are:
.mp4
.webm
.mov
.avi
.flv
.hevc
.mpg
.ts
.vob
Other

If 'Other' is selected, you can enter a video extension in the box provided.
Only enter the letters and/or numbers of the extension. Do not enter the . (dot)
If the extension is known to FFmpeg, it will attempt to create it.

Play After Processing

If this is checked,
The output video will play automatically
when processing is finished.

Model

Each 'model' produces a slightly different output and amount of depth.
Depth Anything v2 small is included with this program

When you select a model, The first time you process an image with it,
It will be downloaded and stored in the DepthFlow_UX\bin\hf\hub folder
Some of these models are large (+-1.3gb)
You can delete any downloaded models you do not use or want

If deleting models
PLEASE CLOSE THIS PROGRAM FIRST

Video Size

You can choose the output size of the video.
Type in a size and choose 'width' or 'height'
We will not stretch your image.

If you choose width,
we will figure out the height by getting info from the input image.

If you choose height,
we will figure out the width by getting info from the input image.

FPS

Frames Per Second
How many frames per second you want.
You can type in any number, default is 30
but the common ones are

60 = Better (crisper, but larger file size due to twice as many frames)
30 = most common - web videos, live tv, sports, soap operas
24 = cinema - tv and film

anything below 24 can be noticably choppy.

Empty Debug File

Every time you create a new video, the program writes a line of code to a debug file.
If you contact us with a problem, the contact form asks if you want to send the debug file. This is very helpfull in trying to figure out why you had a problem.
Empty Debug File button resets the debug file and erases ALL history

Check For Updates

This will compare your programs version number, with the latest one compiled on our site. It will either tell you you are up to date, or it will assk you if you want to download the new version.

Reset Defaults

Reset will reset the dafaults to how they were the first time you used this program


WWW - Online Resources

Check For Updates

This will compare your programs version number, with the latest one compiled on our site. It will either tell you you are up to date, or it will ask you if you want to download the new version.

DepthFlow UX Website

Visit the DepthFlow UX portion of our website

SubLevel10 Website

Visit SubLevel10 website

Donate

Give us a little somethin' somthin' if you enjoy this program

Contact Us

A page for you to contact us without having to go to a website and try to find an actual contact page.

List Of Links

A list Of Licenses, papers, DepthFlow sites, and others

Donate

3D File

Select a valid 3d fi


Contact


A copy of all emails and files sent to us will be stored in the bin/Contact folder
After 20 contacts, the 'Send It' button will be disabled!!! 21 is too many. I don't know you.

Reason For Contacting Us

*Required
Choices are:
Feedback (be nice, I'm a newbie)
How To Questions
I Gots Issues
Just Sayin' Hey
Here a bug - there a bug - everywhere a bug bug
Something Else ...

Name

Not required, but if you leave it blank, I will probably address you as Susan when I reply

Email

*Required
If you are going to email us, at least let us respond to you

What's Up

*Required
No point in sending us anything if you have nothing to say

Files To Include

If you want to include any images or whatnot. NO .EXE .BAT .VBS and such will be sent. All files are zipped before sending and scanned before opening.

Send Debug File Or Not

The debug file is a list of commands sent to python while using this program. It is VERY helpfull to send if you are having issues, but not required to be sent.
Sometimes issues can be as simple as some funny special characters in your folder or file name. The debug file lets us see that, and lets us send the same commands on our system to see the results.

Send It

This will check for errors and send us an email with the attached file, if any.
There is a 20 contact limit. After you contact us 20 times, this button will no longer function







2024 Sub Level 10 Technologies
All Rights Reserved.

×
×