xref: /aosp_15_r20/external/sandboxed-api/oss-internship-2020/openjpeg/README.md (revision ec63e07ab9515d95e79c211197c445ef84cefa6a)
1# OpenJPEG Sandboxed API
2
3This library provides sandboxed version of the [OpenJPEG](https://github.com/uclouvain/openjpeg) library.
4
5## Examples
6
7The examples are sandboxed and simplified version of the main tools provided by the OpenJPEG library, namely (for now) `opj_decompress` from [here](https://github.com/uclouvain/openjpeg/blob/master/src/bin/jp2/opj_decompress.c).
8
9In `decompress_example.cc` the library's sandboxed API is used to convert the _.jp2_ to _.pnm_ image format.
10
11## Build
12
13To build this example, after cloning the whole Sandbox API project, you also need to run
14
15```
16git submodule update --init --recursive
17```
18anywhere in the project tree in order to clone the `openjpeg` submodule.
19Then in the `sandboxed-api/oss-internship-2020/openjpeg` run
20```
21mkdir build && cd build
22cmake -G Ninja
23ninja
24```
25To run `decompress_sandboxed`:
26```
27cd examples
28./decompress_sandboxed absolute/path/to/the/file.jp2 absolute/path/to/the/file.pnm
29```
30