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.3.1 (12/13/2024)

• New 16-BIT Depth Map Style: This latest version introduces an exciting new feature for a 16-BIT Depth Map Style. With this new style, you can now generate 16-bit depth maps for both 8-bit and 16-bit images or video files. If you’ve encountered banding issues in the mesh with 8-bit depth maps, this update is worth exploring.

v2.2.1 (12/07/2024)

• Fixed New Install Issues: A new version of Ultralytics was released last night that was causing problems with new installs. This issue has been fixed. 
• Fixed Video Output of Normals: Using Video as the input method wasn't generating the output type for Normals. This issue has been fixed.

v2.2.0 (12/06/2024)

• Higher Quality Depth Maps: Generate even better results using Depth Anything V2 using the new "Max Resolution". There are three options including 512, 1024, and 1600. Please be careful with using 1600!
• New Model Weights UI: Select a directory for all your model weights files, easily choose models from a dropdown, and save the path for future projects.

v2.1.0 (11/30/2024)

• New Path-Saving Feature: You can now save your model weights file path, so you don’t have to browse for it each time you open Blender. Simply select your file path, enable “Use Saved Path”, and click “Save As Default Path” to have it automatically load in future sessions.

Compatibility with Blender 4.3 (11/23/2024)

• Tested compatibility with Blender 4.3: The most recent version of Depth Map Batch for v2.0.9_Beta is compatible with the newest release of Blender 4.3.

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.

For 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.	Quick Getting Started Guide (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