libragephoto/README.md

## libragephoto
Open Source RAGE Photo Parser for GTA V and RDR 2

  - Read/Write RAGE Photos error free and correct
  - Support for metadata stored in RAGE Photos
  - Export RAGE Photos to jpeg with ragephoto-extract
  - High Efficient and Simple C/C++ API

#### Build libragephoto

```bash
git clone https://github.com/Syping/libragephoto
cmake -B libragephoto-build libragephoto
cmake --build libragephoto-build
sudo cmake --install libragephoto-build
```

##### Optional CMake flags
`-DRAGEPHOTO_CXX_STANDARD=17`  
`-DRAGEPHOTO_BENCHMARK=ON`  
`-DRAGEPHOTO_C_API=OFF`  
`-DRAGEPHOTO_C_LIBRARY=ON`  
`-DRAGEPHOTO_DOC=ON`  
`-DRAGEPHOTO_EXAMPLE_GTKVIEWER=ON`  
`-DRAGEPHOTO_EXAMPLE_QTVIEWER=ON`  
`-DRAGEPHOTO_EXTRACT=OFF`  
`-DRAGEPHOTO_STATIC=ON`

#### RagePhoto API

[RagePhoto C API](https://libragephoto.syping.de/doc/RagePhoto_8h.html)  
[RagePhoto C++ API](https://libragephoto.syping.de/doc/classRagePhoto.html)

#### libragephoto Documentation

[Main Page](https://libragephoto.syping.de/doc/)  
[Build libragephoto](https://libragephoto.syping.de/doc/Build.html)  
[Using libragephoto](https://libragephoto.syping.de/doc/Usage.html)

#### How to Use ragephoto-extract

```bash
ragephoto-extract PGTA5123456789 photo.jpg
ragephoto-extract PRDR3123456789 photo.jpg
```
add error function, README and CI 2021-08-26 00:22:11 +02:00			`## libragephoto`
RDR 2 support 2021-09-03 15:21:02 +02:00			`Open Source RAGE Photo Parser for GTA V and RDR 2`
add error function, README and CI 2021-08-26 00:22:11 +02:00
libragephoto: add ragephoto Python Package - separate RagePhoto and RagePhoto-Extract sources 2023-11-09 20:17:37 +01:00			`- Read/Write RAGE Photos error free and correct`
			`- Support for metadata stored in RAGE Photos`
			`- Export RAGE Photos to jpeg with ragephoto-extract`
			`- High Efficient and Simple C/C++ API`
add error function, README and CI 2021-08-26 00:22:11 +02:00
add Qt example, GTK example fixes, README update 2021-08-27 20:07:14 +02:00			`#### Build libragephoto`
add error function, README and CI 2021-08-26 00:22:11 +02:00
			```bash
CMake, Doc and README updates CMake: add EM_ON EM_OFF and rename BUILD_* and WITH_* options to RAGEPHOTO_* Doc: change C++ API to C/C++ API README: change build libragephoto section and add the reworked CMake options 2021-12-01 07:41:47 +01:00			`git clone https://github.com/Syping/libragephoto`
			`cmake -B libragephoto-build libragephoto`
			`cmake --build libragephoto-build`
			`sudo cmake --install libragephoto-build`
add error function, README and CI 2021-08-26 00:22:11 +02:00			```

add Qt example, GTK example fixes, README update 2021-08-27 20:07:14 +02:00			`##### Optional CMake flags`
CMakeLists and RagePhoto C file access improvements - CMakeLists.txt: CMAKE_CXX_STANDARD -> RAGEPHOTO_CXX_STANDARD - RagePhoto.c: Fix potential issues with file access 2024-01-18 19:53:47 +01:00			`-DRAGEPHOTO_CXX_STANDARD=17`
libragephoto 0.3.0 release - update README.md - update documentation - ragephoto-gtkviewer: fix error uint8_t -> int32_t, NULL -> nullptr - ragephoto-qtviewer: fix error uint8_t -> int32_t - RagePhotoA: fix documentation, fix error() - RagePhotoC: add brief 2023-04-02 21:33:48 +02:00			`-DRAGEPHOTO_BENCHMARK=ON`
CMake, Doc and README updates CMake: add EM_ON EM_OFF and rename BUILD_* and WITH_* options to RAGEPHOTO_* Doc: change C++ API to C/C++ API README: change build libragephoto section and add the reworked CMake options 2021-12-01 07:41:47 +01:00			`-DRAGEPHOTO_C_API=OFF`
libragephoto: add RagePhotoB for best implementation CMakeLists.txt: add RagePhotoB class, improve settings clarification doc/build.doc: add RAGEPHOTO_C_LIBRARY flag doc/index.doc: correct RagePhoto.h header doc/usage.doc: fix minor documentation issue, clarify class differences ragephoto-gtkviewer: use RagePhotoB class ragephoto-qtviewer: use RagePhotoB class RagePhoto-Extract.cpp: use RagePhotoB class RagePhoto.cpp: LIBRAGEPHOTO_C_API -> LIBRAGEPHOTO_CXX_C RagePhotoA.hpp: simplify brief RagePhotoB.hpp: add best implementation detection RagePhotoLibrary.h: fix WASM C API inclusion by default README.md: add RAGEPHOTO_C_LIBRARY flag 2023-06-11 05:41:32 +02:00			`-DRAGEPHOTO_C_LIBRARY=ON`
CMake, Doc and README updates CMake: add EM_ON EM_OFF and rename BUILD_* and WITH_* options to RAGEPHOTO_* Doc: change C++ API to C/C++ API README: change build libragephoto section and add the reworked CMake options 2021-12-01 07:41:47 +01:00			`-DRAGEPHOTO_DOC=ON`
			`-DRAGEPHOTO_EXAMPLE_GTKVIEWER=ON`
			`-DRAGEPHOTO_EXAMPLE_QTVIEWER=ON`
			`-DRAGEPHOTO_EXTRACT=OFF`
			`-DRAGEPHOTO_STATIC=ON`

			`#### RagePhoto API`
README.md: update links and link/ref to C API 2021-11-13 04:53:06 +01:00
libragephoto 0.5.0 release - CMakeLists.txt: add missing RagePhotoA for C API builds - updated README.md 2023-06-11 22:41:55 +02:00			`[RagePhoto C API](https://libragephoto.syping.de/doc/RagePhoto_8h.html)`
README.md: fix C/C++ API links 2021-11-16 06:25:04 +01:00			`[RagePhoto C++ API](https://libragephoto.syping.de/doc/classRagePhoto.html)`
add error function, README and CI 2021-08-26 00:22:11 +02:00
libragephoto 0.3.0 release - update README.md - update documentation - ragephoto-gtkviewer: fix error uint8_t -> int32_t, NULL -> nullptr - ragephoto-qtviewer: fix error uint8_t -> int32_t - RagePhotoA: fix documentation, fix error() - RagePhotoC: add brief 2023-04-02 21:33:48 +02:00			`#### libragephoto Documentation`

			`[Main Page](https://libragephoto.syping.de/doc/)`
			`[Build libragephoto](https://libragephoto.syping.de/doc/Build.html)`
			`[Using libragephoto](https://libragephoto.syping.de/doc/Usage.html)`

add error function, README and CI 2021-08-26 00:22:11 +02:00			`#### How to Use ragephoto-extract`

			```bash
			`ragephoto-extract PGTA5123456789 photo.jpg`
allow loading of std::string, README update 2021-09-03 17:59:54 +02:00			`ragephoto-extract PRDR3123456789 photo.jpg`
add error function, README and CI 2021-08-26 00:22:11 +02:00			```