README

   1
   2 OPENJPEG LIBRARY and APPLICATIONS
   3 ----------------------------------
   4
   5 Details on folders hierarchy:
   6
   7 * src
   8   * lib
   9     * openjp2: contains the sources of the openjp2 library (Part 1 & 2)
  10     * openjpwl: contains the additional sources if you want to build a JPWL-flavoured library.
  11     * openjpip: complete client-server architecture for remote browsing of jpeg 2000 images.
  12     * openjp3d: JP3D implementation
  13     * openmj2: MJ2 implementation
  14   * bin: contains all applications that use the openjpeg library
  15     * common: common files to all applications
  16     * jp2: a basic codec
  17     * mj2: motion jpeg 2000 executables
  18     * jpip: OpenJPIP applications (server and dec server)
  19       * java: a Java client viewer for JPIP
  20     * jp3d: JP3D applications
  21       * tcltk: a test tool for JP3D
  22     * wx
  23       * OPJViewer: gui for displaying j2k files (based on wxWidget)
  24 * wrapping
  25   * java: java jni to use openjpeg in a java program
  26 * thirdparty: thirdparty libraries used by some applications. These libraries will be built only if there are not found on the system. Note that libopenjpeg itself does not have any dependency.
  27 * doc: doxygen documentation setup file and man pages
  28 * tests: configuration files and utilities for the openjpeg test suite. All test images are located in 'http://openjpeg.googlecode.com/svn/data' folder.
  29 * cmake: cmake related files
  30
  31 see LICENSE for license and copyright information.
  32 see INSTALL for installation procedures.
  33 see NEWS for user visible changes in successive releases.
  34 see CHANGES for per-revision changes.
  35
  36 ----------------
  37 API/ABI
  38
  39 OpenJPEG strives to provide a stable API/ABI for your applications. As such it
  40 only exposes a limited subset of its functions.  It uses a mecanism of
  41 exporting/hiding functions. If you are unsure which functions you can use in
  42 your applications, you should compile OpenJPEG using something similar to gcc:
  43 -fvisibility=hidden compilation flag.
  44 See also: http://gcc.gnu.org/wiki/Visibility
  45
  46 On windows, MSVC directly supports export/hidding function and as such the only
  47 API available is the one supported by OpenJPEG.