Skip to content

README.md

Latest commit

 

History

History
65 lines (42 loc) · 1.52 KB

README.md

File metadata and controls

65 lines (42 loc) · 1.52 KB

DCIMG Reader

DCIMG reader for MATLAB and Fiji.

DCIMG is an image format produced by Hamamatsu cameras. It is designed for high-speed data storage.

MATLAB MEX Functions

Download DCIMG-MEX-Windows-x64.zip from releases.

Decompress and add all files (dcimg_get_size.mexw64, dcimg_read_frame.mexw64, and dcimgapi.dll) to MATLAB path.

Example Usage

[height, width, n_frames] = dcimg_get_size('filename.dcimg')

image = dcimg_read_frame('filename.dcimg', 1)  % read the 1st frame (1-indexed)
image = dcimg_read_frame_range('filename.dcimg', 1, 100)  % read frame 100 frames starting from frame 1

Fiji Plugin

Download DCIMG-Fiji-Plugin-Windows-x64.zip from releases.

Decompress and put the "DCIMG" folder into Fiji/ImageJ2's plugins folder.

Then, you can open .dcimg files by File -> Open or drag-and-drop.

Build

DCIMG Reader only supports 64-bit Windows platform.

Building MATLAB MEX Functions

To build the mex files from source, you need these dependencies installed:

  • CMake
  • At least one C++ build tools. For example,
    • Visual Studio
    • MinGW

Run the following lines in the top-level directory of this repository.

mkdir build
cd build
cmake ..
cmake --build . --config Release

Building Fiji Plugin

Dependencies:

  • Maven
  • JDK

In addition to the steps in "Building MATLAB MEX Functions", run

cd fiji_plugin
mvn

The resulting JAR file locates in target folder. You also need the DLL files dcimg_jni.dll and dcimgapi.dll generated by CMake.