UVtools.Core
2.27.3
See the version list below for details.
dotnet add package UVtools.Core --version 2.27.3
NuGet\Install-Package UVtools.Core -Version 2.27.3
<PackageReference Include="UVtools.Core" Version="2.27.3" />
paket add UVtools.Core --version 2.27.3
#r "nuget: UVtools.Core, 2.27.3"
// Install UVtools.Core as a Cake Addin #addin nuget:?package=UVtools.Core&version=2.27.3 // Install UVtools.Core as a Cake Tool #tool nuget:?package=UVtools.Core&version=2.27.3
UVtools
Download the latest version at:
https://github.com/sn4k3/UVtools/releases/latest
To auto install on Windows via a package manager:
- Winget: winget install -e --id PTRTECH.UVtools
- Chocolatey: choco install -y uvtools
Note: Winget is included on Windows 11 by default.
MSLA/DLP, file analysis, calibration, repair, conversion and manipulation
This simple tool can give you insight of supports and find some failures. Did you forget what resin or other settings you used on a project? This can also save you, check every setting that were used with or simply change them!
- Facebook group: https://www.facebook.com/groups/uvtools
Why this project?
I don't own a Prusa SL1 or any other resin printer, for now I’m only a FDM user with Prusa MK3 and a Ender3. PrusaSlicer is my only choose, why? Because I think it's the best and feature more, at least for me, simple but powerful.
So why this project? Well in fact I’m looking for a resin printer and i like to study and learn first before buy, get good and don't regret, and while inspecting i found that resin printers firmwares are not as universal as FDM, too many file formats and there before each printer can use their own property file, this of course limit the software selection, for example, only PrusaSlicer can slice SL1 files. So with that in mind i'm preparing when I got some resin printer in future I can use PrusaSlicer instead of others. I've explored the other slicers and again, no one give me joy, and i feel them unstable, many users slice model on PrusaSlicer just to get those supports and export stl to load in another, that means again PrusaSlicer is on the win side, the problem is they can't slice directly on PrusaSlicer, so, in the end, my project aims to do almost that, configure a printer on PrusaSlicer, eg: EPAX X1, slice, export file, convert SL1 to native printer file and print.
Please note i don't have any resin printer! All my work is virtual and calculated, so, use experimental functions with care! Once things got confirmed a list will show. But also, i need victims for test subject. Proceed at your own risk!
Features
- View image layer by layer
- View and extract thumbnails
- View all used settings
- Edit print properties and save file
- Mutate and filter layers
- Check islands, overhangs, resin traps, empty layers and repair/remove them as other issues
- Export file to a folder
- Convert format to another format
- Calibration tests
- Portable (No installation needed)
Known File Formats
- SL1 (PrusaSlicer)
- SL1S (PrusaSlicer)
- Zip (Chitubox)
- Photon (Chitubox)
- Photons (Chitubox)
- CBDDLP (Chitubox)
- CBT (Chitubox)
- PHZ (Chitubox)
- FDG (Voxelab)
- PWS (Photon Workshop)
- PW0 (Photon Workshop)
- PWX (Photon Workshop)
- PWMO (Photon Workshop)
- PWMA (Photon Workshop)
- PWMS (Photon Workshop)
- PWMX (Photon Workshop)
- PWMB (Photon Workshop)
- PWSQ (Photon Workshop)
- ZCode (UnizMaker)
- ZCodex (Z-Suite)
- CWS (NovaMaker)
- RGB.CWS (Nova Bene4 Mono / Elfin2 Mono SE)
- XML.CWS (Wanhao Workshop)
- MDLP (Makerbase MKS-DLP v1)
- GR1 (GR1 Workshop)
- CXDLP (Creality Box)
- LGS (Longer Orange 10)
- LGS30 (Longer Orange 30)
- LGS120 (Longer Orange 120)
- LGS4K (Longer Orange 4K & mono)
- VDA.ZIP (Voxeldance Additive)
- VDT (Voxeldance Tango)
- UVJ (Zip file format for manual manipulation)
- Image files (png, jpg, jpeg, gif, bmp)
Available printers for PrusaSlicer
See at: https://github.com/sn4k3/UVtools/tree/master/PrusaSlicer/printer
Available profiles for PrusaSlicer
- From 0.01mm to 0.20mm
- Light, Medium and Heavy Supports
Install and configure profiles under PrusaSlicer
Complete guide: https://github.com/sn4k3/UVtools/wiki/Setup-PrusaSlicer
Custom "Material Notes" and "Printer Notes" keywords for PrusaSlicer
Note that some variables will only work if the target format supports them, otherwise they will be ignored. Replace the "xxx" by your desired value in the correct units
- BottomLightOffDelay_xxx: Sets the bottom light off delay time in seconds
- LightOffDelay_xxx: Sets the light off delay time in seconds
- BottomWaitTimeBeforeCure_xxx: Sets the bottom wait time before cure in seconds
- WaitTimeBeforeCure_xxx: Sets the wait time before cure in seconds
- BottomWaitTimeAfterCure_xxx: Sets the bottom wait time after cure in seconds
- WaitTimeAfterCure_xxx: Sets the wait time after cure in seconds
- BottomLiftHeight_xxx: Sets the bottom lift height in millimeters
- BottomLiftSpeed_xxx: Sets the bottom lift speed in millimeters/minute
- LiftHeight_xxx: Sets the lift height in millimeters
- LiftSpeed_xxx: Sets the lift speed in millimeters/minute
- BottomWaitTimeAfterLift_xxx: Sets the bottom wait time after lift in seconds
- WaitTimeAfterLift_xxx: Sets the wait time after lift in seconds
- RetractSpeed_xxx: Sets the retract speed in millimeters/minute
- BottomLightPWM_xxx: Sets the bottom LED light power (0-255)
- LightPWM_xxx: Sets the LED light power (0-255)
- FILEVERSION_n: Sets the output file format version/revision
- FILEFORMAT_xxx: Sets the output file format extension to be auto converted once open on UVtools
File Convertion
https://github.com/sn4k3/UVtools/wiki/Sliced-File-Conversion
Command-line arguments
The UVtools executable allow to set some arguments to do special functions:
- Open file(s):
- Syntax: UVtools <file1> [file2] [file3] ...
- Example 1: UVtools C:\model.osla
- Example 2: UVtools C:\model.zip D:\other_model.osla
- Note: When a invalid file is pass, the program will open as default.
- Convert a file into another type(s)
- Syntax: UVtools -c/--convert <input_file> <output_file1_or_ext> [output_file2_or_ext] ...
- Example 1: UVtools -c model.zip osla
- Example 2: UVtools -c model.zip model_converted.osla
- Example 3: UVtools --convert model.zip model_converted.osla model_converted.zcode
- Note: Nothing happen when providing wrong files, will quit.
- Extract a file to a folder
- Syntax: UVtools -e/--extract <input_file> [output_folder]
- Example 1: UVtools -e model.zip
- Example 2: UVtools -e model.zip mymodel
- Example 3: UVtools --extract model.zip .
- Note: Nothing happen when providing wrong files/folder, will quit.
- Export a file to a 3D mesh
- Syntax: UVtools --export-mesh <input_file> [output_mesh_file]
- Example 1: UVtools --export-mesh model.zip
- Example 2: UVtools --export-mesh model.zip model_exported.stl
- Note: Nothing happen when providing wrong files, will quit.
Requirements
Windows
Windows 7 SP1 or greater
- If on Windows 10/11 N or NK:
- Media Feature Pack must be installed
- Press Windows + R
- Type: appwiz.cpl (and press Enter key)
- Click on: Turn Windows features on or off
- Check the "Media Extensions" and click Ok
- If on Windows 10/11 N or NK:
4GB RAM or higher
1920 x 1080 @ 100% scale as minimum resolution
Linux
- 4GB RAM or higher
- 64 bit System
- 1920 x 1080 @ 100% scale as minimum resolution
Ubuntu/Mint/Debian/Similars
sudo apt-get update
sudo apt-get install -y libjpeg-dev libpng-dev libgeotiff-dev libdc1394-22 libavcodec-dev libavformat-dev libswscale-dev libopenexr24 libtbb-dev libgl1-mesa-dev libgdiplus
Compile libcvextern.so:
After this if you run UVtools and got a error like:
System.DllNotFoundException: unable to load shared library 'cvextern' or one of its dependencies
This means you haven't the required dependencies to run the cvextern library, that may due system version and included libraries version, they must match the compiled version of libcvextern.
To know what is missing you can open a terminal on UVtools folder and run the following command: ldd libcvextern.so |grep not
That will return the missing dependencies from libcvextern, you can try install them by other means if you can,
but most of the time you will need compile the EmguCV to compile the dependencies and correct link them,
this process is very slow but only need to run once. Open a terminal on any folder of your preference and run the following commands:
sudo apt-get install -y git build-essential cmake
git clone https://github.com/emgucv/emgucv emgucv
cd emgucv
git submodule update --init --recursive
cd platforms/ubuntu/20.04
./apt_install_dependency
./cmake_configure
Make sure all commands run with success. After run these commands you can try run UVtools again, if it runs then nothing more is needed and you can remove the emgucv folder, this means you only need the dependencies on your system.
Otherwise you need to copy the output 'emgucv/libs/x64/libcvextern.so' file created by this compilation to the UVtools folder and replace the original. Keep a copy of file somewhere safe, you will need to replace it everytime you update UVtools. Additionally you can share your libcvextern.so on UVtools GitHub with your system information (Name Version) to help others with same problem, anyone with same system version can make use of it without the need of the compilation process.
Note: You need to repeat this process everytime UVtools upgrades OpenCV version, keep a eye on changelog.
Arch/Manjaro/Similars
sudo pacman -Syu
sudo pacman -S openjpeg2 libjpeg-turbo libpng libgeotiff libdc1394 libdc1394 ffmpeg openexr tbb libgdiplus
To run UVtools open it folder on a terminal and call one of:
- Double-click UVtools file
./UVtools
sh UVtools.sh
dotnet UVtools.dll
[For universal package only, requires dotnet-runtime]- As a pratical alternative you can create a shortcut on Desktop
Compile libcvextern.so:
After this if you run UVtools and got a error like:
System.DllNotFoundException: unable to load shared library 'cvextern' or one of its dependencies
This means you haven't the required dependencies to run the cvextern library, that may due system version and included libraries version, they must match the compiled version of libcvextern.
To know what is missing you can open a terminal on UVtools folder and run the following command: ldd libcvextern.so |grep not
That will return the missing dependencies from libcvextern, you can try install them by other means if you can,
but most of the time you will need compile the EmguCV to compile the dependencies and correct link them,
this process is very slow but only need to run once. Open a terminal on any folder of your preference and run the following commands:
sudo pacman -Syu
sudo pacman -S base-devel git cmake msbuild gtk3 gstreamer ffmpeg libdc1394 v4l-utils ocl-icd freeglut libgeotiff libusb
git clone https://github.com/emgucv/emgucv emgucv
cd emgucv
git submodule update --init --recursive
cd platforms/ubuntu/20.04
./cmake_configure
Make sure all commands run with success. After run these commands you can try run UVtools again, if it runs then nothing more is needed and you can remove the emgucv folder, this means you only need the dependencies on your system.
Otherwise you need to copy the output 'emgucv/libs/x64/libcvextern.so' file created by this compilation to the UVtools folder and replace the original. Keep a copy of file somewhere safe, you will need to replace it everytime you update UVtools. Additionally you can share your libcvextern.so on UVtools GitHub with your system information (Name Version) to help others with same problem, anyone with same system version can make use of it without the need of the compilation process.
Note: You need to repeat this process everytime UVtools upgrades OpenCV version, keep a eye on changelog.
RHEL/Fedora/CentOS
sudo yum update -y
sudo yum install -y https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
sudo yum install -y https://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm
sudo yum install -y libjpeg-devel libjpeg-turbo-devel libpng-devel libgeotiff-devel libdc1394-devel ffmpeg-devel tbb-devel mesa-libGL
Compile libcvextern.so:
After this if you run UVtools and got a error like:
System.DllNotFoundException: unable to load shared library 'cvextern' or one of its dependencies
This means you haven't the required dependencies to run the cvextern library, that may due system version and included libraries version, they must match the compiled version of libcvextern.
To know what is missing you can open a terminal on UVtools folder and run the following command: ldd libcvextern.so |grep not
That will return the missing dependencies from libcvextern, you can try install them by other means if you can,
but most of the time you will need compile the EmguCV to compile the dependencies and correct link them,
this process is very slow but only need to run once. Open a terminal on any folder of your preference and run the following commands:
sudo yum update -y
sudo yum groupinstall -y "Development Tools" "Development Libraries"
sudo yum install -y cmake gcc-c++ dotnet-sdk-5.0 gtk3-devel gstreamer1-devel ffmpeg ffmpeg-devel libdc1394 libv4l-devel cmake-gui ocl-icd-devel freeglut libgeotiff libusb
git clone https://github.com/emgucv/emgucv emgucv
cd emgucv
git submodule update --init --recursive
cd platforms/ubuntu/20.04
./cmake_configure
Make sure all commands run with success. After run these commands you can try run UVtools again, if it runs then nothing more is needed and you can remove the emgucv folder, this means you only need the dependencies on your system.
Otherwise you need to copy the output 'emgucv/libs/x64/libcvextern.so' file created by this compilation to the UVtools folder and replace the original. Keep a copy of file somewhere safe, you will need to replace it everytime you update UVtools. Additionally you can share your libcvextern.so on UVtools GitHub with your system information (Name Version) to help others with same problem, anyone with same system version can make use of it without the need of the compilation process.
Note: You need to repeat this process everytime UVtools upgrades OpenCV version, keep a eye on changelog.
Mac
- macOS 10.13 High Sierra
- 4GB RAM or higher
To run UVtools open it folder on a terminal and call one of:
- Double-click UVtools file
./UVtools
sh UVtools.sh
dotnet UVtools.dll
[For universal package only, requires dotnet-runtime]- As a pratical alternative you can create a shortcut on Desktop
Compile libcvextern.dylib:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
brew analytics off
brew install git cmake mono mono-libgdiplus
brew install --cask dotnet
git clone https://github.com/emgucv/emgucv emgucv
cd emgucv
git submodule update --init --recursive
cd platforms/macos
./configure
How to use
There are multiple ways to open your file:
- Open UVtools and load your file (CTRL + O) (File → Open)
- Open UVtools and drag and drop your file inside window
- Drag and drop file into UVtools.exe
- Set UVtools the default program to open your files
Library → Developers
Are you a developer? This project include a .NET 5.0 library (UVtools.Core) that can be referenced in your application to make use of my work. Easy to use calls that allow you work with the formats. For more information navigate main code to see some calls.
Nuget package: https://www.nuget.org/packages/UVtools.Core
dotnet add package UVtools.Core
Develop and build from Source
The fastest way to compile the project is by run the build/CompileWindows.bat
, however if you wish to develop with visual studio follow the following steps:
- Install Visual Studio and include .NET development support
- Install the .NET 5.0 SDK if not included on previous instalation
- Install the Avalonia for Visual Sutdio:
- Install the Wix Toolset: (Required only for MSI build, optional)
- Open UVtools.sln
- Build
TODO
- More file formats
- Clean up & performance (always)
- See features request under Github
Support my work / Donate
All my work here is given for free (OpenSource), it took some hours to build, test and polish the program. If you're happy to contribute for a better program and for my work i will appreciate the tip.
- Sponsor: https://github.com/sponsors/sn4k3
- PayPal: https://paypal.me/SkillTournament
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net5.0
- AnimatedGif (>= 1.0.5)
- BinarySerializer (>= 8.6.2.2)
- Emgu.CV (>= 4.5.4.4788)
- KdTree (>= 1.4.1)
- Microsoft.CodeAnalysis.CSharp.Scripting (>= 4.1.0-1.final)
- Microsoft.Win32.Registry (>= 6.0.0-preview.5.21301.5)
- morelinq (>= 3.3.2)
- Newtonsoft.Json (>= 13.0.1)
- Portable.BouncyCastle (>= 1.9.0)
- System.Memory (>= 4.5.4)
- System.Reflection.TypeExtensions (>= 4.7.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
4.4.1 | 69 | 8/19/2024 |
4.4.0 | 45 | 7/30/2024 |
4.3.2 | 126 | 4/19/2024 |
4.3.1 | 82 | 4/19/2024 |
4.3.0 | 98 | 4/6/2024 |
4.2.5 | 100 | 3/14/2024 |
4.2.4 | 90 | 3/2/2024 |
4.2.2 | 118 | 2/17/2024 |
4.2.1 | 93 | 2/10/2024 |
4.2.0 | 84 | 1/29/2024 |
4.1.0 | 89 | 1/19/2024 |
4.0.6 | 107 | 12/24/2023 |
4.0.5 | 98 | 12/12/2023 |
4.0.4 | 157 | 11/9/2023 |
4.0.3 | 146 | 10/19/2023 |
4.0.2 | 117 | 10/2/2023 |
4.0.1 | 106 | 9/18/2023 |
4.0.0 | 115 | 9/17/2023 |
3.15.1 | 130 | 6/30/2023 |
3.15.0 | 105 | 6/26/2023 |
3.14.4 | 165 | 6/21/2023 |
3.14.3 | 160 | 6/11/2023 |
3.14.2 | 170 | 6/7/2023 |
3.14.1 | 153 | 6/3/2023 |
3.14.0 | 177 | 5/31/2023 |
3.13.4 | 193 | 5/21/2023 |
3.13.3 | 156 | 5/8/2023 |
3.13.2 | 149 | 5/6/2023 |
3.13.1 | 219 | 4/27/2023 |
3.13.0 | 211 | 4/23/2023 |
3.12.3 | 256 | 3/31/2023 |
3.12.1 | 260 | 3/22/2023 |
3.12.0 | 297 | 2/27/2023 |
3.11.2 | 313 | 2/1/2023 |
3.11.1 | 287 | 1/31/2023 |
3.11.0 | 355 | 1/16/2023 |
3.10.0 | 350 | 1/3/2023 |
3.9.5 | 330 | 12/31/2022 |
3.9.4 | 325 | 12/29/2022 |
3.9.3 | 350 | 12/14/2022 |
3.9.2 | 336 | 12/11/2022 |
3.9.1 | 354 | 12/3/2022 |
3.9.0 | 376 | 12/1/2022 |
3.8.3 | 364 | 11/10/2022 |
3.8.2 | 405 | 11/5/2022 |
3.8.1 | 380 | 11/2/2022 |
3.8.0 | 406 | 10/29/2022 |
3.7.2 | 466 | 10/20/2022 |
3.7.1 | 423 | 10/17/2022 |
3.7.0 | 455 | 10/12/2022 |
3.6.8 | 466 | 10/4/2022 |
3.6.7 | 507 | 10/1/2022 |
3.6.6 | 480 | 9/20/2022 |
3.6.5 | 574 | 9/18/2022 |
3.6.4 | 531 | 9/15/2022 |
3.6.3 | 486 | 8/30/2022 |
3.6.2 | 489 | 8/22/2022 |
3.6.1 | 511 | 8/19/2022 |
3.6.0 | 497 | 8/17/2022 |
3.5.6 | 518 | 7/29/2022 |
3.5.5 | 523 | 7/19/2022 |
3.5.4 | 569 | 7/14/2022 |
3.5.3 | 577 | 7/7/2022 |
3.5.2 | 550 | 6/25/2022 |
3.5.1 | 533 | 6/24/2022 |
3.5.0 | 534 | 6/19/2022 |
3.4.3 | 584 | 5/21/2022 |
3.4.2 | 539 | 5/16/2022 |
3.4.1 | 556 | 5/2/2022 |
3.4.0 | 596 | 5/2/2022 |
3.3.2 | 611 | 4/14/2022 |
3.3.1 | 573 | 4/11/2022 |
3.3.0 | 606 | 4/10/2022 |
3.2.2 | 589 | 4/6/2022 |
3.2.1 | 609 | 4/2/2022 |
3.2.0 | 624 | 3/26/2022 |
3.1.1 | 478 | 3/21/2022 |
3.1.0 | 492 | 3/17/2022 |
3.0.0 | 475 | 3/12/2022 |
2.29.0 | 162 | 2/21/2022 |
2.28.1 | 139 | 2/15/2022 |
2.28.0 | 145 | 2/13/2022 |
2.27.7 | 171 | 1/27/2022 |
2.27.6 | 161 | 1/7/2022 |
2.27.5 | 155 | 1/5/2022 |
2.27.4 | 155 | 12/26/2021 |
2.27.3 | 169 | 12/24/2021 |
2.27.2 | 156 | 12/23/2021 |
2.27.1 | 166 | 12/22/2021 |
2.27.0 | 169 | 12/18/2021 |
2.26.0 | 188 | 12/6/2021 |
2.25.3 | 175 | 12/2/2021 |
2.25.2 | 2,875 | 11/25/2021 |
2.25.1 | 363 | 11/23/2021 |
2.25.0 | 408 | 11/18/2021 |
2.24.4 | 410 | 11/14/2021 |
2.24.3 | 440 | 11/13/2021 |
2.24.2 | 205 | 11/5/2021 |
2.24.1 | 178 | 11/3/2021 |
2.24.0 | 193 | 11/3/2021 |
2.23.6 | 182 | 10/12/2021 |
2.23.5 | 228 | 10/7/2021 |
2.23.4 | 214 | 10/4/2021 |
2.23.3 | 157 | 10/4/2021 |
2.23.2 | 234 | 10/2/2021 |
2.23.1 | 196 | 9/23/2021 |
2.23.0 | 183 | 9/21/2021 |
2.22.0 | 195 | 9/16/2021 |
2.21.1 | 187 | 9/6/2021 |
2.21.0 | 166 | 9/3/2021 |
2.20.5 | 166 | 8/31/2021 |
2.20.4 | 187 | 8/29/2021 |
2.20.3 | 171 | 8/28/2021 |
2.20.2 | 199 | 8/27/2021 |
2.20.1 | 168 | 8/26/2021 |
2.20.0 | 188 | 8/24/2021 |
2.19.5 | 200 | 8/22/2021 |
2.19.4 | 179 | 8/22/2021 |
2.19.3 | 184 | 8/22/2021 |
2.19.2 | 175 | 8/21/2021 |
2.19.1 | 193 | 8/19/2021 |
2.19.0 | 183 | 8/17/2021 |
2.18.0 | 188 | 8/12/2021 |
2.17.0 | 196 | 8/8/2021 |
2.16.0 | 185 | 8/1/2021 |
2.15.1 | 308 | 7/24/2021 |
2.15.0 | 291 | 7/16/2021 |
2.14.3 | 237 | 7/12/2021 |
2.14.2 | 349 | 7/11/2021 |
2.14.1 | 232 | 7/7/2021 |
2.14.0 | 254 | 7/3/2021 |
2.13.4 | 318 | 6/25/2021 |
2.13.3 | 207 | 6/12/2021 |