NT-MDT palette format: Java parsing library

It is a color scheme for visualising SPM scans.

Application

["Nova", "Image Analysis", "NanoEducator"]

File extension

pal

KS implementation details

License: Unlicense

This page hosts a formal specification of NT-MDT palette format using Kaitai Struct. This specification can be automatically translated into a variety of programming languages to get a parsing library.

Usage

Runtime library

All parsing code for Java generated by Kaitai Struct depends on the Java runtime library. You have to install it before you can parse data.

The Java runtime library is published in the Maven Central Repository. Refer to the artifact page for instructions how to add it into your project with the build tool that you use.

Code

Parse a local file and get structure in memory:

NtMdtPal data = NtMdtPal.fromFile("path/to/local/file.pal");

Or parse structure from a byte array:

byte[] someArray = new byte[] { ... };
NtMdtPal data = new NtMdtPal(new ByteBufferKaitaiStream(someArray));

After that, one can get various attributes from the structure by invoking getter methods like:

data.signature() // => get signature

Java source code to parse NT-MDT palette format

NtMdtPal.java

// This is a generated file! Please edit source .ksy file and use kaitai-struct-compiler to rebuild

import io.kaitai.struct.ByteBufferKaitaiStream;
import io.kaitai.struct.KaitaiStruct;
import io.kaitai.struct.KaitaiStream;
import java.io.IOException;
import java.util.Arrays;
import java.util.ArrayList;
import java.nio.charset.Charset;


/**
 * It is a color scheme for visualising SPM scans.
 */
public class NtMdtPal extends KaitaiStruct {
    public static NtMdtPal fromFile(String fileName) throws IOException {
        return new NtMdtPal(new ByteBufferKaitaiStream(fileName));
    }

    public NtMdtPal(KaitaiStream _io) {
        this(_io, null, null);
    }

    public NtMdtPal(KaitaiStream _io, KaitaiStruct _parent) {
        this(_io, _parent, null);
    }

    public NtMdtPal(KaitaiStream _io, KaitaiStruct _parent, NtMdtPal _root) {
        super(_io);
        this._parent = _parent;
        this._root = _root == null ? this : _root;
        _read();
    }
    private void _read() {
        this.signature = this._io.readBytes(26);
        if (!(Arrays.equals(signature(), new byte[] { 78, 84, 45, 77, 68, 84, 32, 80, 97, 108, 101, 116, 116, 101, 32, 70, 105, 108, 101, 32, 32, 49, 46, 48, 48, 33 }))) {
            throw new KaitaiStream.ValidationNotEqualError(new byte[] { 78, 84, 45, 77, 68, 84, 32, 80, 97, 108, 101, 116, 116, 101, 32, 70, 105, 108, 101, 32, 32, 49, 46, 48, 48, 33 }, signature(), _io(), "/seq/0");
        }
        this.count = this._io.readU4be();
        this.meta = new ArrayList<Meta>();
        for (int i = 0; i < count(); i++) {
            this.meta.add(new Meta(this._io, this, _root));
        }
        this.something2 = this._io.readBytes(1);
        this.tables = new ArrayList<ColTable>();
        for (int i = 0; i < count(); i++) {
            this.tables.add(new ColTable(this._io, this, _root, i));
        }
    }
    public static class Meta extends KaitaiStruct {
        public static Meta fromFile(String fileName) throws IOException {
            return new Meta(new ByteBufferKaitaiStream(fileName));
        }

        public Meta(KaitaiStream _io) {
            this(_io, null, null);
        }

        public Meta(KaitaiStream _io, NtMdtPal _parent) {
            this(_io, _parent, null);
        }

        public Meta(KaitaiStream _io, NtMdtPal _parent, NtMdtPal _root) {
            super(_io);
            this._parent = _parent;
            this._root = _root;
            _read();
        }
        private void _read() {
            this.unkn00 = this._io.readBytes(3);
            this.unkn01 = this._io.readBytes(2);
            this.unkn02 = this._io.readBytes(1);
            this.unkn03 = this._io.readBytes(1);
            this.colorsCount = this._io.readU2le();
            this.unkn10 = this._io.readBytes(2);
            this.unkn11 = this._io.readBytes(1);
            this.unkn12 = this._io.readBytes(2);
            this.nameSize = this._io.readU2be();
        }
        private byte[] unkn00;
        private byte[] unkn01;
        private byte[] unkn02;
        private byte[] unkn03;
        private int colorsCount;
        private byte[] unkn10;
        private byte[] unkn11;
        private byte[] unkn12;
        private int nameSize;
        private NtMdtPal _root;
        private NtMdtPal _parent;

        /**
         * usually 0s
         */
        public byte[] unkn00() { return unkn00; }
        public byte[] unkn01() { return unkn01; }
        public byte[] unkn02() { return unkn02; }

        /**
         * usually 0s
         */
        public byte[] unkn03() { return unkn03; }
        public int colorsCount() { return colorsCount; }

        /**
         * usually 0s
         */
        public byte[] unkn10() { return unkn10; }

        /**
         * usually 4
         */
        public byte[] unkn11() { return unkn11; }

        /**
         * usually 0s
         */
        public byte[] unkn12() { return unkn12; }
        public int nameSize() { return nameSize; }
        public NtMdtPal _root() { return _root; }
        public NtMdtPal _parent() { return _parent; }
    }
    public static class Color extends KaitaiStruct {
        public static Color fromFile(String fileName) throws IOException {
            return new Color(new ByteBufferKaitaiStream(fileName));
        }

        public Color(KaitaiStream _io) {
            this(_io, null, null);
        }

        public Color(KaitaiStream _io, NtMdtPal.ColTable _parent) {
            this(_io, _parent, null);
        }

        public Color(KaitaiStream _io, NtMdtPal.ColTable _parent, NtMdtPal _root) {
            super(_io);
            this._parent = _parent;
            this._root = _root;
            _read();
        }
        private void _read() {
            this.red = this._io.readU1();
            this.unkn = this._io.readU1();
            this.blue = this._io.readU1();
            this.green = this._io.readU1();
        }
        private int red;
        private int unkn;
        private int blue;
        private int green;
        private NtMdtPal _root;
        private NtMdtPal.ColTable _parent;
        public int red() { return red; }
        public int unkn() { return unkn; }
        public int blue() { return blue; }
        public int green() { return green; }
        public NtMdtPal _root() { return _root; }
        public NtMdtPal.ColTable _parent() { return _parent; }
    }
    public static class ColTable extends KaitaiStruct {

        public ColTable(KaitaiStream _io, int index) {
            this(_io, null, null, index);
        }

        public ColTable(KaitaiStream _io, NtMdtPal _parent, int index) {
            this(_io, _parent, null, index);
        }

        public ColTable(KaitaiStream _io, NtMdtPal _parent, NtMdtPal _root, int index) {
            super(_io);
            this._parent = _parent;
            this._root = _root;
            this.index = index;
            _read();
        }
        private void _read() {
            this.size1 = this._io.readU1();
            this.unkn = this._io.readU1();
            this.title = new String(this._io.readBytes(_root().meta().get((int) index()).nameSize()), Charset.forName("UTF-16LE"));
            this.unkn1 = this._io.readU2be();
            this.colors = new ArrayList<Color>();
            for (int i = 0; i < (_root().meta().get((int) index()).colorsCount() - 1); i++) {
                this.colors.add(new Color(this._io, this, _root));
            }
        }
        private int size1;
        private int unkn;
        private String title;
        private int unkn1;
        private ArrayList<Color> colors;
        private int index;
        private NtMdtPal _root;
        private NtMdtPal _parent;
        public int size1() { return size1; }
        public int unkn() { return unkn; }
        public String title() { return title; }
        public int unkn1() { return unkn1; }
        public ArrayList<Color> colors() { return colors; }
        public int index() { return index; }
        public NtMdtPal _root() { return _root; }
        public NtMdtPal _parent() { return _parent; }
    }
    private byte[] signature;
    private long count;
    private ArrayList<Meta> meta;
    private byte[] something2;
    private ArrayList<ColTable> tables;
    private NtMdtPal _root;
    private KaitaiStruct _parent;
    public byte[] signature() { return signature; }
    public long count() { return count; }
    public ArrayList<Meta> meta() { return meta; }
    public byte[] something2() { return something2; }
    public ArrayList<ColTable> tables() { return tables; }
    public NtMdtPal _root() { return _root; }
    public KaitaiStruct _parent() { return _parent; }
}