Skip to content
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.
Java Inno Setup Shell
Branch: master
Clone or download
Latest commit 51ed1e0 Apr 2, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Updated documentation Jul 31, 2018
install Windows 2.0 installer Apr 2, 2019
out Added Play and AA Apr 2, 2019
src Added Play and AA Apr 2, 2019
test Test photon file Jul 17, 2018
.gitignore Add osx installer with JRE included Jul 13, 2018
LICENSE Base documentation Jul 5, 2018
README.md Updated documentation Jul 31, 2018
photon.properties Previous buttons on margins and islands Jul 13, 2018
versions.md Release notes Jul 31, 2018

README.md

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:

  • View all layers of a sliced (AnyCubic Photon Slicer or ChiTu DLP Slicer) file for the Photon 3D printer.
  • Easy see overhangs and unsupported areas (color coded in yellow and red, in 2D and 3D)
  • Change exposure, off time and buttom layer settings on already sliced files.
  • Easy check if any part of a model is to close to the border
  • Quickly navigate beween problem layers and watch if it will break your prints.
  • Automatically fix pixel related unsupported areas (islands).
  • Manually edit pixels on the layers.

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.

  • Leveling, both the printer and the build plate must be leveled. If the printer is not leveled the resin will not flow correctly under the model between layers. If the build plate is not leveled, the distance between the build plate and the bottom layer (FEP) will be too short in some areas and too wide in others.
  • Missing or weak support. When the printer is done printing one layer, the layer is lifted off the botom plastic film (FEP). The support must be strong enough to support the lift (pull).
  • Wrong exposure or off time settings. Each Resin is different in the chemical content, so each resin have a limited time range where it fully cures each layer. To short exposure and you have uncured liquid resin between you new layer and the previous printed layers, and the model will break off the build plate. To much and the layers will overcure and get thinner than the distance the pinter will lift for the next layer, ending in the model will break off the build plate.
  • Separated Resin. Most resin needs to be shaken or stirred befor use, which ensures that the resin compunds are mixed in the correct manor.
  • File, model or slicing errors. Applications have bugs, so errors could be intruduced in the process.
  • Printer errors. When buying a budget printer, some will only pass the quality control on a good day. Some components might be designed with no fault margin, introducing periodic errors (like power supply shortage and the LCD screen flicking).
  • Temperature, if the resin is to cold it will not flow under the model between the layers, if to hot it will have issues with overcuring.

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:

  • Build area set in the file, should be 68.4 * 120.96 mm for the Photon printer.
  • Resolution of the printer, should be 1440 * 2560 pixels for the Photon printer.
  • Print information, with resin usage and time.

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

You can’t perform that action at this time.