translation_driver.h

Go to the documentation of this file.

#ifndef __TRANSLATION_DRIVER__H
#define __TRANSLATION_DRIVER__H

#include <boolean.h>
#include <retro_common_api.h>

#include "ocr_driver.h"

RETRO_BEGIN_DECLS

enum translation_init_errors
{
   TRANSLATION_INIT_SUCCESS = 0,
   TRANSLATION_INIT_UNSUPPORTED_DEVICE_LANGUAGE,
   TRANSLATION_INIT_UNSUPPORTED_GAME_LANGUAGE,
   TRANSLATION_INIT_UNKNOWN_DEVICE_LANGUAGE,
   TRANSLATION_INIT_UNKNOWN_GAME_LANGUAGE
};

struct translation_driver_info
{
    int device_language;
    int game_language;
};

typedef struct translation_driver
{
    void* (*init)(const struct translation_driver_info *params);
    void  (*free)(void* data);
    
    /* use translate_image if non NULL else run image through ocr driver then run translate_text */
    /* returned char pointers do not need to be freed but are 1 time use, they may be destroyed on the next call to translate_image/text */
    /* NOTE: translate_image is allowed to call the ocr driver itself if it wants */
    char* (*translate_text)(void* data, const char* game_text);
    char* (*translate_image)(void* data, struct ocr_image_info image);
    
    const char *ident;
} translation_driver_t;

extern const translation_driver_t translation_cached_google;
extern const translation_driver_t translation_null;

bool  translation_driver_init(void);
void  translation_driver_free(void);

/* returned char pointers do not need to be freed but are 1 time use, they may be destroyed on the next call to translation_driver_translate_image */
char* translation_driver_translate_image(struct ocr_image_info image);

RETRO_END_DECLS

#endif