openjpeg/README.flviewer.md

91 lines
2.5 KiB
Markdown
Raw Normal View History

**If you want to use 'flviewer' for LINUX, APPLE, MS-WINDOWS:**
01. Download the FLTK library from
http://www.fltk.org
e.g. fltk-1.3.x-r10813.tar.bz2
and expand it.
02. For versions < r10813 MANUALLY uncomment in
FL/Enumerations.H
the line
//#define FL_ABI_VERSION 10304
If you do not
#define FL_ABI_VERSION 10304
the horizontal BAR is not activated.
For versions >= r10813, you can do:
either: configure --abi-version=10304
or : cmake -DFL_ABI_VERSION:string="10304"
03. MS-WINDOWS may need in-source configuration/compilation.
MS-WINDOWS out-source configuration/compilation may need
'-DOPTION_BUILD_EXAMPLES:bool=off'.
04. Compile the FLTK library.
05. Install the FLTK library.
06. For FLVIEWER, CMAKE arguments for the OPENJPEG library may be:
-DBUILD_SHARED_LIBS:bool=on
-DBUILD_FLVIEWER:bool=on
-DBUILD_FLVIEWER_WITH_SHARED_LIBS:bool=on
-DFLTK_SKIP_OPENGL:bool=on
-DBUILD_WITH_GERMAN:bool=off
07. Compile the OPENJPEG library.
08. Call 'bin/flviewer --version'.
09. Call 'bin/flviewer' to test the application.
10. Some files with a large number of SOP markers, e.g.
'openjpeg-data/input/conformance/p0_07.j2k'
with 256 tiles, may need some time. On my computer about 2 minutes.
The SOP markers are therefore ON only on demand (read_jpeg2000.cxx).
11. The FLVIEWER menu has some buttons, inputs and outputs:
Tracks, Frames, Threads : for MJ2
Stop, Go on, Restart, Close, <-Step, Step-> : for MJ2, JPX, JPM
Tile, Reduction and Area : for JP2/J2K, JPM, JPX
Section and Browse : for all file types
Layer and Component : for resp. files
To use 'Section':
Push the left mouse button and draw a rectangle
Press 'Section'
To remove the rectangle, click into the main window
In the section window use the right mouse button to select an action.
Only one section window can be open.
Use the right mouse button to close the section window.
If you handle an animation of type MJ2 you must first press
the 'Stop' button to stop the movie before you can get a section.
12. Install the OPENJPEG library together with FLVIEWER.
13. JPM and JPX files can be found on:
http://home.arcor.de
or (possibly) on
https://share.openanalytics.eu/data/public/76cb6a.php
https://share.openanalytics.eu/data/public/1e7708.php