zathura/plugin-api.h

/* See LICENSE file for license and copyright information */

#ifndef PLUGIN_API_H
#define PLUGIN_API_H

#include "page.h"
#include "document.h"
#include "version.h"

typedef struct zathura_plugin_functions_s zathura_plugin_functions_t;

/**
 * Functions register function
 *
 * @param functions The functions struct
 */
typedef void (*zathura_plugin_register_function_t)(zathura_plugin_functions_t* functions);

/**
 * Sets the functions register function of the plugin
 *
 * @param plugin The plugin
 * @param register_function The register function that registers the document
 * functions
 */
void zathura_plugin_set_register_functions_function(zathura_plugin_t* plugin,
    zathura_plugin_register_function_t register_function);

/**
 * Sets the functions register function of the plugin
 *
 * @param plugin The plugin
 * @param mime_type The mime type that should be added
 */
void zathura_plugin_add_mimetype(zathura_plugin_t* plugin, const char* mime_type);

/**
 * Register a plugin.
 *
 * @param plugin_name the name of the plugin
 * @param major the plugin's major version
 * @param minor the plugin's minor version
 * @param rev the plugin's revision
 * @param register_functions function to register the plugin's document functions
 * @param mimetypes a char array of mime types supported by the plugin
 */
#define ZATHURA_PLUGIN_REGISTER(plugin_name, major, minor, rev, register_functions, mimetypes) \
  unsigned int zathura_plugin_version_major() { return major; } \
  unsigned int zathura_plugin_version_minor() { return minor; } \
  unsigned int zathura_plugin_version_revision() { return rev; } \
  unsigned int zathura_plugin_api_version() { return ZATHURA_API_VERSION; } \
  unsigned int zathura_plugin_abi_version() { return ZATHURA_ABI_VERSION; } \
  \
  void zathura_plugin_register(zathura_plugin_t* plugin) \
  { \
    if (plugin == NULL) { \
      return; \
    } \
    zathura_plugin_set_register_functions_function(plugin, register_functions); \
    static const char* mime_types[] = mimetypes; \
    for (size_t s = 0; s != sizeof(mime_types) / sizeof(const char*); ++s) { \
      zathura_plugin_add_mimetype(plugin, mime_types[s]); \
    } \
  } \

#define ZATHURA_PLUGIN_MIMETYPES(...) __VA_ARGS__

struct zathura_plugin_functions_s
{
  /**
   * Opens a document
   */
  zathura_error_t (*document_open)(zathura_document_t* document);

  /**
   * Frees the document
   */
  zathura_error_t (*document_free)(zathura_document_t* document, void* data);

  /**
   * Generates the document index
   */
  girara_tree_node_t* (*document_index_generate)(zathura_document_t* document, void* data, zathura_error_t* error);

  /**
   * Save the document
   */
  zathura_error_t (*document_save_as)(zathura_document_t* document, void* data, const char* path);

  /**
   * Get list of attachments
   */
  girara_list_t* (*document_attachments_get)(zathura_document_t* document, void* data, zathura_error_t* error);

  /**
   * Save attachment to a file
   */
  zathura_error_t (*document_attachment_save)(zathura_document_t* document, void* data, const char* attachment, const char* file);

  /**
   * Get document information
   */
  char* (*document_meta_get)(zathura_document_t* document, void* data, zathura_document_meta_t info, zathura_error_t* error);

  /**
   * Gets the page object
   */
  zathura_error_t (*page_init)(zathura_page_t* page);

  /**
   * Free page
   */
  zathura_error_t (*page_clear)(zathura_page_t* page, void* data);

  /**
   * Search text
   */
  girara_list_t* (*page_search_text)(zathura_page_t* page, void* data, const char* text, zathura_error_t* error);

  /**
   * Get links on a page
   */
  girara_list_t* (*page_links_get)(zathura_page_t* page, void* data, zathura_error_t* error);

  /**
   * Get form fields
   */
  girara_list_t* (*page_form_fields_get)(zathura_page_t* page, void* data, zathura_error_t* error);

  /**
   * Get list of images
   */
  girara_list_t* (*page_images_get)(zathura_page_t* page, void* data, zathura_error_t* error);

  /**
   * Get the image
   */
  cairo_surface_t* (*page_image_get_cairo)(zathura_page_t* page, void* data, zathura_image_t* image, zathura_error_t* error);

  /**
   * Get text for selection
   */
  char* (*page_get_text)(zathura_page_t* page, void* data, zathura_rectangle_t rectangle, zathura_error_t* error);

  /**
   * Renders the page
   */
  zathura_image_buffer_t* (*page_render)(zathura_page_t* page, void* data, zathura_error_t* error);

  /**
   * Renders the page
   */
  zathura_error_t (*page_render_cairo)(zathura_page_t* page, void* data, cairo_t* cairo, bool printing);
};


#endif // PLUGIN_API_H