RagePhoto.hpp

/*****************************************************************************
* libragephoto RAGE Photo Parser
* Copyright (C) 2021-2023 Syping
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* This software is provided as-is, no warranties are given to you, we are not
* responsible for anything with use of the software, you are self responsible.
*****************************************************************************/
 
#ifndef RAGEPHOTO_HPP
#define RAGEPHOTO_HPP
 
#ifdef __cplusplus
#include "RagePhotoLibrary.h"
#include "RagePhotoTypedefs.h"
#include <iostream>
#include <cstdlib>
#include <cstdint>
#include <cstdio>
 
class LIBRAGEPHOTO_CXX_PUBLIC RagePhoto
{
public:
    enum DefaultSize : uint32_t {
        DEFAULT_GTA5_PHOTOBUFFER = 524288UL, 
        DEFAULT_RDR2_PHOTOBUFFER = 1048576UL, 
        DEFAULT_DESCBUFFER = 256UL, 
        DEFAULT_JSONBUFFER = 3072UL, 
        DEFAULT_TITLBUFFER = 256UL, 
        GTA5_HEADERSIZE = 264UL, 
        RDR2_HEADERSIZE = 272UL, 
    };
    enum Error : int32_t {
        DescBufferTight = 39L, 
        DescMallocError = 31L, 
        DescReadError = 32L, 
        HeaderBufferTight = 35L, 
        HeaderMallocError = 4L, 
        IncompatibleFormat = 2L, 
        IncompleteChecksum = 7L, 
        IncompleteDescBuffer = 30L, 
        IncompleteDescMarker = 28L, 
        IncompleteDescOffset = 11L, 
        IncompleteEOF = 8L, 
        IncompleteHeader = 3L, 
        IncompleteJendMarker = 33L, 
        IncompleteJpegMarker = 12L, 
        IncompleteJsonBuffer = 20L, 
        IncompleteJsonMarker = 18L, 
        IncompleteJsonOffset = 9L, 
        IncompletePhotoBuffer = 14L, 
        IncompletePhotoSize = 15L, 
        IncompleteTitleBuffer = 25L, 
        IncompleteTitleMarker = 23L, 
        IncompleteTitleOffset = 10L, 
        IncorrectDescMarker = 29L, 
        IncorrectJendMarker = 34L, 
        IncorrectJpegMarker = 13L, 
        IncorrectJsonMarker = 19L, 
        IncorrectTitleMarker = 24L, 
        JsonBufferTight = 37L, 
        JsonMallocError = 21L, 
        JsonReadError = 22L, 
        NoError = 255L, 
        NoFormatIdentifier = 1L, 
        PhotoBufferTight = 36L, 
        PhotoMallocError = 16L, 
        PhotoReadError = 17L, 
        TitleBufferTight = 38L, 
        TitleMallocError = 26L, 
        TitleReadError = 27L, 
        UnicodeInitError = 5L, 
        UnicodeHeaderError = 6L, 
        Uninitialised = 0L, 
    };
    enum PhotoFormat : uint32_t {
        GTA5 = 0x01000000UL, 
        RDR2 = 0x04000000UL, 
    };
    enum SignInitials : uint32_t {
        SIGTA5 = 0xE47AB81CUL, 
        SIRDR2 = 0x00FEEB1EUL, 
    };
    RagePhoto();
    ~RagePhoto();
    void addParser(RagePhotoFormatParser *rp_parser); 
    static void clear(RagePhotoData *rp_data); 
    void clear(); 
    RagePhotoData* data(); 
    static bool load(const char *data, size_t size, RagePhotoData *rp_data, RagePhotoFormatParser *rp_parser); 
    bool load(const char *data, size_t size);
    bool load(const std::string &data);
    bool loadFile(const std::string &filename);
    int32_t error() const; 
    uint32_t format() const; 
    const std::string jpeg() const; 
#if (RAGEPHOTO_CXX_STD >= 17) && (__cplusplus >= 201703L)
    const std::string_view jpeg_view() const; 
#endif
    const char* jpegData() const; 
    static uint64_t jpegSign(uint32_t photoFormat, RagePhotoData *rp_data); 
    static uint64_t jpegSign(RagePhotoData *rp_data); 
    uint64_t jpegSign(uint32_t photoFormat) const; 
    uint64_t jpegSign() const; 
    uint32_t jpegSize() const; 
    const char* description() const; 
    const char* json() const; 
    const char* header() const; 
    const char* title() const; 
    static const char* version(); 
    static bool save(char *data, uint32_t photoFormat, RagePhotoData *rp_data, RagePhotoFormatParser *rp_parser); 
    static bool save(char *data, RagePhotoData *rp_data, RagePhotoFormatParser *rp_parser); 
    bool save(char *data, uint32_t photoFormat);
    bool save(char *data);
    const std::string save(uint32_t photoFormat, bool *ok = nullptr);
    const std::string save(bool *ok = nullptr);
    bool saveFile(const std::string &filename, uint32_t photoFormat); 
    bool saveFile(const std::string &filename); 
    static size_t saveSize(uint32_t photoFormat, RagePhotoData *rp_data, RagePhotoFormatParser *rp_parser); 
    static size_t saveSize(RagePhotoData *rp_data, RagePhotoFormatParser *rp_parser); 
    size_t saveSize(uint32_t photoFormat); 
    size_t saveSize(); 
    static void setBufferDefault(RagePhotoData *rp_data); 
    void setBufferDefault(); 
    static void setBufferOffsets(RagePhotoData *rp_data); 
    void setBufferOffsets(); 
    bool setData(RagePhotoData *rp_data, bool takeCopy = true); 
    void setDescription(const char *description, uint32_t bufferSize = 0); 
    void setFormat(uint32_t photoFormat); 
    bool setJpeg(const char *data, uint32_t size, uint32_t bufferSize = 0);
    bool setJpeg(const std::string &data, uint32_t bufferSize = 0);
    void setJson(const char *json, uint32_t bufferSize = 0); 
    void setHeader(const char *header, uint32_t headerSum, uint32_t headerSum2 = 0); 
    void setTitle(const char *title, uint32_t bufferSize = 0); 
private:
    RagePhotoData *m_data;
    RagePhotoFormatParser *m_parser;
};
#endif // __cplusplus
 
#endif // RAGEPHOTO_HPP