Quick Getting Started Guide

As a starting point, here's a quick getting started guide to using Depth Map Batch that covers all the key areas including installation and using key features. It's very possible this video is sufficient to get you ready to go. 

UPDATES

v2.0.9_Beta (11/19/2024)

• Midas 3.1 Model: Fixed issue using the Midas 3.1 depth map model where dimensions of the resulting depth map were not kept consistent with the original image dimensions. Now the generated depth maps maintain the original image dimensions.

v2.0.8_Beta (11/04/2024)

• 16-Bit Depth Map Generation: Introduces the ability to produce 16-bit depth maps! 

v2.0.7 (10/31/2024)

• PNG Export Fix: Corrected DPI handling for PNG file exports. Users selecting PNG as their output format will now have their DPI settings properly applied, matching the existing JPEG functionality.

v2.0.6 (10/28/2024)

• DPI Handling Enhancement: Update to handle different DPI settings when saving images. JPEGs and PNGs now maintain their specified DPI.

v2.0.5 (10/25/2024)

• Alpha Channel Support: Images with transparent backgrounds now retain their transparency throughout processing, ensuring accurate overlays.

v2.0.4 (10/20/2024)

• Two new grayscale styles: There are two new depth map style options added for grayscale, one for Close White and Close Black. The option for Close White is where white represents closer distances, while Close Black is where black represents closer distances.

v2.0.3 (10/19/2024)

• Filenames: Code fix to ensure that existing filenames in the output directory will not be overwritten.  If a filename already exists, the tool will automatically modify it by adding a number to the end of the filename.
• File Type Clarification: Depth map files now have "_depth" included at the end of the original filename. 

v2.0.2 (10/19/2024)

• OneDrive support: Fixed an issue with using OneDrive as your input files and directories.

v2.0.0 (10/16/2024)

• New Depth Map Models: Depth Anything V2 and Midas 3.1 have been added as model options for Depth Map Batch 2.0.  The previous version of Depth Map Batch only had Midas 3.0.

v1.0.6 (10/13/2024)

• Renaming: Renamed the Output Type option for "Images" to "Depth Maps".

v1.0.5 (10/11/2024)

• NEW FEATURE: Added a new input method for using a single image.

GENERATE 16-BIT DEPTH MAPS

Please note to generate 16-bit depth maps you need to follow the steps below. 

1. 16-Bit Original Image Required: To generate 16-bit depth maps, the original image must be in 16-bit format. I’m exploring the possibility of developing an upscale option for images that are not 16-bit in the future, but for now, having a 16-bit image is essential.
2. Depth Map Style: The depth map style must be set to "CLOSE_WHITE," as it is the only style that will generate 16-bit depth maps.
3. Current Functionality: At this stage, the tool supports generating depth maps from either a directory of images or a single image. I am working on expanding this functionality to include video support in the future.
4. Model Compatibility: Please be aware that this feature is currently available only for Depth Anything V2 and is not compatible with either of the two MiDaS models.
5. Image Resizing & Format: Images cannot be resized during processing, and you must select the Image Format as either "PNG" or "JPG_and_PNG."
6. Alpha Transparency Limitation: As of now, the tool does not produce alpha transparency for 16-bit images. However, you can still generate alpha for 8-bit images by selecting PNG as the Image Format option.In-Depth Tutorials

For more in-depth tutorials, please take a look at the video links shared below.

Title	Video Link
Quick Getting Started Guide If you're looking for a quick guide to get started this video covers all key areas including installation and using features. Everything is discussed in under 6 minutes.	All Tutorials (click here)
Playlist of Tutorials Here's where you can go to see all the latest tutorials released about Depth Map Batch.	All Tutorials (click here)
Installing the add-on Here's a quick video on how to install Depth Map Batch and a few other important things to keep in mind.	Installing add-on (click here)
Installing dependencies This tutorial walks through how to install the Python dependency packages, with both an "Install All" option and individual library installations.	Installing dependencies (click here)
Getting started using the tool Here's a walkthrough on getting started and understanding the tool's functionality.	Using the tool (click here)
Referencing model weights A video on how to reference the model weights file. When I initially created this video there was only one model to choose from, but since then there are now 3 different dept map options including Depth Anything V2, MiDaS 3.1, or MiDaS 3.0.	How to reference model weights file (click here)
New model weights files A video on how to use the new model weights file for Depth Map Batch 2.0. Now you have the option for Depth Anything V2, MiDaS 3.1, or MiDaS 3.0.	How to use the new model weights files (click here)
Upgrading to new version of Depth Map Batch Here's how you can upgrade to the newest version of Depth Map Batch.	Upgrading versions of Depth Map Batch (click here)
Uninstalling Python packages Instructions on how to uninstall packages with both an "Uninstall All" option and individual uninstall options.	Uninstalling (click here)

Optional (model weights)

You have the option to instead download the model weights files directly from the websites for each of the depth map projects, but it's not necessary given I provide the same exact model weights files to download in your add-ons file download section. 

If you decide to take this approach it's very important you download the exact model weights files that are already provided in the add-on downloads section, otherwise the code won't work. 

Depth Anything V2 - model weights source

https://github.com/DepthAnything/Depth-Anything-V2/tree/main

MiDaS - model weights source

https://github.com/isl-org/MiDaS/releases/tag/v3_1

Dependency Python Packages

You can install all packages in one step using the "Install All Packages" button, and if you ever want to uninstall packages you can uninstall everything using "Uninstall All Packages".

Here's a list of all the Python libraries required to use the tool. Make sure to install everything first, as the add-on won't display in the sidebar without them:

• cffi
• cycler
• python-dateutil
• facenet-pytorch
• joblib
• kiwisolver
• matplotlib
• mpmath
• opencv-python
• packaging
• pillow
• psutil
• pycparser
• pyparsing
• pyyaml
• scipy
• six
• scikit-learn
• sympy
• threadpoolctl
• timm
• torch
• torchvision
• tqdm
• typing_extensions
• ultralytics