Photonsters / PhotonFileValidator

A file viewer application for AnyCubic Photon sliced files (*.photon and *.cbddlp). The viewer can show you preview images, print information and all layers with information on overhang and islands issues.
MIT License
302 stars 58 forks source link



PHOTON FILE VIEWER IS NO LONGER MANTAINED OR DEVELOPED!

Use UVTools by Master Photonster Tiago Conceição instead




Photon File Viewer

A file viewer application for AnyCubic Photon sliced files (.photon and .cbddlp). The viewer can show you preview images, print information and all layers with information on overhang and islands issues, and edit layers manually or automatically.

Main screen

Photon files

TL;DR

Basic information, with this application you can:

What is a Photon file

A Photon file is generated by the AnyCubic Photon Slicer (rebrand of ChiTu DLP Slicer). The slicer takes a 3D object and turn it into a list of images, each representing one printable layer. The 3D printer then prints each layer by exposing liquid resin with UV light, and lifting the build plate to peel off the model from the bottom plastic (FEP).

The Photon file contains information about the height of each layer, for how long each layer is exposed to UV light, and some settings for overexposing the first layers to make the print stick to the build plate.

Why do I want to view a photon file

In the ideal world, - you don't. The slicer makes the file, and the printer use the file to print your object.

But, sometimes prints fail.

There are a lot of reasons why prints are failing.

The Photon File Viewer can help you by showing all the layers in full resolution and all settings stored in the file.

The Viewer can also analyze the file for layers that contains areas that is not supported (printed in mid-air, called islands). Islands are a problem, because the model will not be printed as designed. In the best scenario the island will stick to the plastic bottom of the printer or attach itself to the printed model, but if you are unlucky - it could be trapped between the printer and the model, breaking the FEP or the LCD screen.

Installation

Latest Installation files

Install on Windows

Windows Main screen

The windows installer is not signed, so you have to go through some warning pages before you are allowed to install it.

Download: win-photonfilevalidator-x.x.exe (if you have java version 8 or above installed)

Download: win-jre-photonfilevalidator-x.x.exe (includes a java jre runtime engine)

Install on macOS

Download the dmg and open it, then drag the app to the applications folder link. The App is not signed, so you may have to locate the app in finder and right click on it and select open.

Download: osx-photonfilevalidator-x.x.dmg (if you have java version 8 or above installed)

Download: osx-jre-photonfilevalidator-x.x.dmg (includes a java jre runtime engine)

Read more on opening unsigned apps on Apple Support

Install on Linux

No installers are available yet. Use the manual installation option.

Manual installation

If you already have Java installed, you can simply download the jar file and execute it (dobbeltclick or from command line: java -jar PhotonFileValidator.jar

Download: jar-photonfilevalidator-x.x.zip

Usage

Open a slice file

With the open button you can browse your local file system for files with the .photon file extension. When a file has been selected, it will load the file.

During load, it will translate each layer to an image and check you file for overhangs and unsupported areas. The application will update status information so you can follow the process.

When the load is done, it will show layer 0, which is the first layer the printer will print. It will also show if the model extends beyond the border or have islands.

Save the file

If you want to try printing the file with other settings, select the save button. In the save dialog you will be able to change the file name, the normal exposure time, the off time, the bottom layers count and the bottom layer exposure time.

Show Information

With the show information button you can see the following information:

The Print information contains the layer height, the total number of pixels on all layers, the extimated volume of resin to be used and the time it will take to print it.

Jump to layers with to large model areas.

If you set a safty border margin, each layer is check for areas that expand outside the margin. The application will show a list of the first layers. Use the >> button to jump to the next layer. If there are no more layers, it will go back to the first again.

Jump to layers with islands

If you model contains islands, if will show a list with the first layer numbers. With the >> button you can quickly jump to the next layer that contains islands.

As small islands can be hard to find, the application will draw horizontal and vertical cross lines to help you locate the islands. If the island area are very big, no cross lines will be drawn.

Zoom layers

Layers are show 1:1 (zoom center position) which allow you to see exactly what the printer will print. If you want to close in on details, use the zoom scale right positions, or if you want to get better overview on a smaller screen, you can use the left scale positions.

Show previews

The slicer produces preview images that is used by the printer to help you select the correct model to print. You can also see the preview images in the file viewer application.

Fix problems

This dialog allow you to automatically fix pixel related problems, where a small areas are not directly connected to supported areas. Typically these problems areas are located with the corner right next to the corner of a supported pixel. The application will only add a minimal amount of pixels to correct the issues. As long as a layers have added pixels, the application will retry to fix even more problem areas.

Remember to save the file after it has been fixed.

Print Margin

Your printer might have issues printing close to the border. To avoid this, you can optional set a safety margin. When a safty margin is set, the application will check that all model layers is not printed outside the margin.

The margin is set in pixels (0.04725mm) and you find the settings in the photon.properties file, located in the folder where the jar file is installed. You can edit the file with a text editor.

The default is: margin=0

Time calculations

In the information dialog you can see the estimated time for the print. The Photon slicer is known (versions 1.3.6 and before) for showing false print times. The reason is that the application is not including the peel time (the time is takes to remove the model from the FEP). On a standard Photon printer the peel time is 5.5 seconds.

If you modify the Photon printer to have faster or slower peel time, so to handle this you can change the settings used to calculate the time. You find the settings in photon.properties file where the jar is installed.

The default is: peel=5.5

Command line usage

You can use the application from the command line: java -jar PhotonFileCheck.jar

You can add a Photon slice file name as argument, and the file will be loaded when the application starts.

If you have trouble loading large files, add more memory to to the application like:

java -Xms3g -Xmx6g -jar PhotonFileCheck.jar

Developer Information

Source code layout

Code Implementation