Skip to content

README.md

Latest commit

 

History

History
68 lines (51 loc) · 3.06 KB

README.md

File metadata and controls

68 lines (51 loc) · 3.06 KB
Raw

PFM/PHM image viewer desktop application v2

PFM stands for Portable FloatMap Image Format, as specified by https://www.pauldebevec.com/Research/HDR/PFM/ PHM is the half-float variant as used by intel open image denoise library.

This software is a minimalist (729 C++/ispc lines) desktop app made with Nana++ GUI library.
It makes use of auto-vectorizing compiler ispc to exploit superscalar AVX512 instructions for tone/exposure updates and for the zoom resampling.
Only the visible viewport is rasterized, so panning and zooming cost what's necessary. v2 introduces a new blitting system that is blazing fast compared to v1. It is built with subsystem:console on windows so it can accept piped data to stdin.

screen capture

Usage:

one argument for file name (or optionally - (dash) to indicate stdin) If no arguments: it will probe for stdin pending data, or open a filebox dialog picker if no pending data on stdin.

Navigation:

  • mouse wheel over the image zooms around the cursor, sqrt(2) per notch, from 1/32x to 32x
  • click and drag the image to pan, or use the scrollbars
  • the - + 1:1 fit buttons zoom around the center of the view

Zoomed in, sampling is nearest neighbour so you see the actual pixels. Zoomed out, the source footprint is box-filtered (up to 4x4 taps) instead of point sampled, so a downscaled preview doesn't turn into aliasing noise.

Create .pfm

Use that snippet to output (usually linear space) 16bits-float-RGB (half3) images from your software:

    // export to PHM:
    std::ofstream f{"hdrimg.phm", std::ios::out | std::ios::binary};
    f << "PH\n";   // capital H = 3 channels of halfs
    f << resolutionX << " " << resolutionY << "\n";
    f << "-1.0\n";  // scale and endian (neg=little)
    f.write((const char*)rowmajorHalfRgbImageData, resolutionX * resolutionY * 3 * 2);

magic legend:
PF=float3
Pf=float
PH=half3
Ph=half

Build:

  • install ispc (version 1.18.0 or v1.30.0 were used for dev) https://ispc.github.io/downloads.html if you have a different version (or unorthodox install path), tune the CMakeLists.txt to adjust the fallback path set (ISPC_EXECUTABLE "$ENV{ProgramFiles}/ISPC/ispc-v1.18.0-windows/bin/ispc.exe") to your version and actual installation path.
  • install cmake 3.15 or newer
  • Download ninja-win.zip from https://github.com/ninja-build/ninja/releases and put ninja.exe in a PATH accessible folder.
  • decompress the nana.zip in place, so that you have a "nana" folder which immediately contains the .hpp. The release .lib for visual studio toolset 142 is included in the zip
  • open a "x64 visual studio tool console" (or execute vcvars64.bat)
    then call
    cmake_suggestion_ninja_cl.bat
  • cd to build/
  • call ninja

You should have PfmViewer.exe ready to go

Debug:

If you want to build in debug mode,

Go to https://github.com/cnjinhao/nana get the 1.7.4 version, build it yourself using your prefered project system.
Copy the .lib produced to nana/BIN

edit cmake_suggestion_ninja_cl.bat and change -DCMAKE_BUILD_TYPE=Release to -DCMAKE_BUILD_TYPE=Debug