iup-stack/im/include/im_format_jp2.h

76 lines
2.2 KiB
C
Raw Normal View History

2023-02-20 16:44:45 +00:00
/** \file
* \brief Register the JP2 Format
*
* See Copyright Notice in im_lib.h
*/
#ifndef __IM_FORMAT_JP2_H
#define __IM_FORMAT_JP2_H
#if defined(__cplusplus)
extern "C" {
#endif
/** \defgroup jp2 JP2 - JPEG-2000 JP2 File Format
* \section Description
*
* \par
* ISO/IEC 15444 (2000, 2003)\n
* http://www.jpeg.org/
* \par
* You must link the application with "im_jp2.lib"
* and you must call the function \ref imFormatRegisterJP2 once
* to register the format into the IM core library.
* In Lua call require"imlua_jp2". \n
* \par
* Access to the JPEG2000 file format uses libJasper version 2.0.14 \n
* https://www.ece.uvic.ca/~frodo/jasper/ \n
* Copyright (c) 2001-2016 Michael David Adams. \n
*
* \par
* See \ref im_format_jp2.h
*
* \section Features
*
\verbatim
Data Types: Byte and UShort
Color Spaces: Binary, Gray, RGB, YCbCr, Lab and XYZ
Compressions:
JPEG-2000 - ISO JPEG 2000 [default]
Only one image.
Can have an alpha channel.
Internally the components are always unpacked.
Internally the lines are arranged from top down to bottom.
Handle(1) returns jas_image_t*
Handle(2) returns jas_stream_t*
Attributes:
CompressionRatio IM_FLOAT (1) [write only, example: Ratio=7 just like 7:1]
Comments:
We read code stream syntax and JP2, but we write always as JP2.
Used definitions EXCLUDE_JPG_SUPPORT,EXCLUDE_MIF_SUPPORT,
EXCLUDE_PNM_SUPPORT,EXCLUDE_RAS_SUPPORT,
EXCLUDE_BMP_SUPPORT,EXCLUDE_PGX_SUPPORT
Changed jas_config.h to match our needs.
New file jas_binfile.c
Changed base/jas_stream.c to export jas_stream_create and jas_stream_initbuf.
The counter is for memory transfer only.
These changes can be ignored when using an external libJasper distribution,
but in this case the imBinFile global features will not work.
\endverbatim
* \ingroup format */
/** Register the JP2 Format. \n
* In Lua, when using require"imlua_jp2" this function will be automatically called.
* \ingroup jp2 */
void imFormatRegisterJP2(void);
#if defined(__cplusplus)
}
#endif
#endif