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

#ifndef ANNOTATION_H
#define ANNOTATION_H

#include <time.h>
#include <stdbool.h>

typedef struct zathura_annotation_s zathura_annotation_t;
typedef struct zathura_annotation_popup_s zathura_annotation_popup_t;

#include "page.h"
#include "types.h"

typedef enum zathura_annotation_type_s {
  ZATHURA_ANNOTATION_UNKNOWN,
  ZATHURA_ANNOTATION_TEXT,
  ZATHURA_ANNOTATION_LINK,
  ZATHURA_ANNOTATION_FREE_TEXT,
  ZATHURA_ANNOTATION_LINE,
  ZATHURA_ANNOTATION_SQUARE,
  ZATHURA_ANNOTATION_CIRCLE,
  ZATHURA_ANNOTATION_POLYGON,
  ZATHURA_ANNOTATION_POLY_LINE,
  ZATHURA_ANNOTATION_HIGHLIGHT,
  ZATHURA_ANNOTATION_UNDERLINE,
  ZATHURA_ANNOTATION_SQUIGGLY,
  ZATHURA_ANNOTATION_STRIKE_OUT,
  ZATHURA_ANNOTATION_STAMP,
  ZATHURA_ANNOTATION_CARET,
  ZATHURA_ANNOTATION_INK,
  ZATHURA_ANNOTATION_POPUP,
  ZATHURA_ANNOTATION_FILE_ATTACHMENT,
  ZATHURA_ANNOTATION_SOUND,
  ZATHURA_ANNOTATION_MOVIE,
  ZATHURA_ANNOTATION_WIDGET,
  ZATHURA_ANNOTATION_SCREEN,
  ZATHURA_ANNOTATION_PRINTER_MARK,
  ZATHURA_ANNOTATION_TRAP_NET,
  ZATHURA_ANNOTATION_WATERMARK,
  ZATHURA_ANNOTATION_3D,
} zathura_annotation_type_t;

typedef enum zathura_annotation_flag_s {
  ZATHURA_ANNOTATION_FLAG_UNKNOWN         = 0,
  ZATHURA_ANNOTATION_FLAG_INVISIBLE       = 1 << 0,
  ZATHURA_ANNOTATION_FLAG_HIDDEN          = 1 << 1,
  ZATHURA_ANNOTATION_FLAG_PRINT           = 1 << 2,
  ZATHURA_ANNOTATION_FLAG_NO_ZOOM         = 1 << 3,
  ZATHURA_ANNOTATION_FLAG_NO_ROTATE       = 1 << 4,
  ZATHURA_ANNOTATION_FLAG_NO_VIEW         = 1 << 5,
  ZATHURA_ANNOTATION_FLAG_READ_ONLY       = 1 << 6,
  ZATHURA_ANNOTATION_FLAG_LOCKED          = 1 << 7,
  ZATHURA_ANNOTATION_FLAG_TOGGLE_NO_VIEW  = 1 << 8,
  ZATHURA_ANNOTATION_FLAG_LOCKED_CONTENTS = 1 << 9,
} zathura_annotation_flag_t;

typedef enum zathura_annotation_text_icon_s {
  ZATHURA_ANNOTATION_TEXT_ICON_UNKNOWN,
  ZATHURA_ANNOTATION_TEXT_ICON_NOTE,
  ZATHURA_ANNOTATION_TEXT_ICON_COMMENT,
  ZATHURA_ANNOTATION_TEXT_ICON_KEY,
  ZATHURA_ANNOTATION_TEXT_ICON_HELP,
  ZATHURA_ANNOTATION_TEXT_ICON_NEW_PARAGRAPH,
  ZATHURA_ANNOTATION_TEXT_ICON_PARAGRAPH,
  ZATHURA_ANNOTATION_TEXT_ICON_INSERT,
  ZATHURA_ANNOTATION_TEXT_ICON_CROSS,
  ZATHURA_ANNOTATION_TEXT_ICON_CIRCLE
} zathura_annotation_text_icon_t;

typedef enum zathura_annotation_text_state_s {
  ZATHURA_ANNOTATION_TEXT_STATE_UNKNOWN,
  ZATHURA_ANNOTATION_TEXT_STATE_NONE,
  ZATHURA_ANNOTATION_TEXT_STATE_MARKED,
  ZATHURA_ANNOTATION_TEXT_STATE_UNMARKED,
  ZATHURA_ANNOTATION_TEXT_STATE_ACCEPTED,
  ZATHURA_ANNOTATION_TEXT_STATE_REJECTED,
  ZATHURA_ANNOTATION_TEXT_STATE_CANCELLED,
  ZATHURA_ANNOTATION_TEXT_STATE_COMPLETED
} zathura_annotation_text_state_t;

/**
 * Creates a new annotation
 *
 * @param type The type of the annotation
 * @return Pointer to the created annotation object or NULL if an error occured
 */
zathura_annotation_t* zathura_annotation_new(zathura_annotation_type_t type);

/**
 * Frees the given annotation
 *
 * @param annotation The annotation
 */
void zathura_annotation_free(zathura_annotation_t* annotation);

/**
 * Returns the pointer to the custom data for the given annotation
 *
 * @param annotation The annotation
 * @return Pointer to the custom data or NULL
 */
void* zathura_annotation_get_data(zathura_annotation_t* annotation);

/**
 * Sets the custom data for the given annotation
 *
 * @param annotation The annotation
 * @param data Custom data
 */
void zathura_annotation_set_data(zathura_annotation_t* annotation, void* data);

/**
 * Returns the type of the annotation
 *
 * @param annotation The annotation
 * @return The type of the annotation (\ref zathura_annotation_type_t)
 */
zathura_annotation_type_t zathura_annotation_get_type(zathura_annotation_t* annotation);

/**
 * Returns the flags of the annotation
 *
 * @param annotation The annotation
 * @return The set flags of the annotation (\ref zathura_annotation_flag_t)
 */
zathura_annotation_flag_t zathura_annotation_get_flags(zathura_annotation_t* annotation);

/**
 * Sets the flags of the annotation
 *
 * @param annotation The annotation
 * @param flags The flags that should be set to the annotation
 */
void zathura_annotation_set_flags(zathura_annotation_t* annotation, zathura_annotation_flag_t flags);

/**
 * Returns the content of the annotation
 *
 * @param annotation The annotation
 * @return The content of the annotation or NULL
 */
char* zathura_annotation_get_content(zathura_annotation_t* annotation);

/**
 * Sets the content of the annotation
 *
 * @param annotation The annotation
 * @param content The new content of the annotation
 */
void zathura_annotation_set_content(zathura_annotation_t* annotation, char* content);

/**
 * Returns the name of the annotation
 *
 * @param annotation The annotation
 * @return The name of the annotation or NULL
 */
char* zathura_annotation_get_name(zathura_annotation_t* annotation);

/**
 * Sets the name of the annotation
 *
 * @param annotation The annotation
 * @param name The new name of the annotation
 */
void zathura_annotation_set_name(zathura_annotation_t* annotation, const char* name);

/**
 * Returns the modification date of the annotation
 *
 * @param annotation The annotation
 * @return The date on which the annotation has been modified the last time
 */
time_t zathura_annotation_get_modification_date(zathura_annotation_t* annotation);

/**
 * Sets the date on which the annotation has been modified the last time
 *
 * @param annotation The annotation
 * @param modification_date The modification date
 */
void zathura_annotation_set_modification_date(zathura_annotation_t* annotation, time_t modification_date);

/**
 * Returns the creation date of the annotation
 *
 * @param annotation The annotation
 * @retun The creation date
 */
time_t zathura_annotation_get_creation_date(zathura_annotation_t* annotation);

/**
 * Sets the creation date of the annotation
 *
 * @param annotation The annotation
 * @param creation_date The creation date
 */
void zathura_annotation_set_creation_date(zathura_annotation_t* annotation, time_t creation_date);

/**
 * Returns the page of the annotation
 *
 * @param annotation The annotation
 * @return The page of the annotation
 */
zathura_page_t* zathura_annotation_get_page(zathura_annotation_t* annotation);

/**
 * Sets the page of the annotation
 *
 * @param annotation The annotation
 * @param page The page of the annotation
 */
void zathura_annotation_set_page(zathura_annotation_t* annotation, zathura_page_t* page);

/**
 * Retrieves the position of the annotation and saves it into the given
 * rectangle
 *
 * @param annotation The annotation
 * @return The position of the annotation
 */
zathura_rectangle_t zathura_annotation_get_position(zathura_annotation_t* annotation);

/**
 * Sets the new position of the annotation
 *
 * @param annotation The annotation
 * @param rectangle The rectangle containing the new position information
 */
void zathura_annotation_set_position(zathura_annotation_t* annotation, zathura_rectangle_t position);

/**
 * Returns the popup of the annotation
 *
 * @param annotation The annotation
 * @return The popup or NULL if an error occured or no popup exists
 */
zathura_annotation_popup_t* zathura_annotation_get_popup(zathura_annotation_t* annotation);

/**
 * Sets the annotation popup
 *
 * @param annotation The annotation
 * @param popup The new popup
 */
void zathura_annotation_set_popup(zathura_annotation_t* annotation, zathura_annotation_popup_t* popup);

/**
 * Creates a new annotation popup
 *
 * @return The popup or NULL if an error occured
 */
zathura_annotation_popup_t* zathura_annotation_popup_new();

/**
 * Frees the annotation popup
 *
 * @param popup The annotation popup
 */
void zathura_annotation_popup_free(zathura_annotation_popup_t* popup);

/**
 * Gets the current label of the markup annotation
 *
 * @param annotation The annotation
 * @return The label or NULL
 */
char* zathura_annotation_popup_get_label(zathura_annotation_popup_t* popup);

/**
 * Sets the label of the markup annotation
 *
 * @param annotation The annotation
 * @param label The new label of the markup annotation
 */
void zathura_annotation_popup_set_label(zathura_annotation_popup_t* popup, const char* label);

/**
 * Returns the defined icon of the text annotation
 *
 * @param annotation The annotation
 * @return The set icon of the text annotation
 */
zathura_annotation_text_icon_t zathura_annotation_text_get_icon(zathura_annotation_t* annotation);

/**
 * Sets the icon of the text annotation
 *
 * @param annotation The annotation
 * @param icon The icon of the text annotation
 */
void zathura_annotation_text_set_icon(zathura_annotation_t* annotation, zathura_annotation_text_icon_t icon);

/**
 * Returns the state of the text annotation
 *
 * @param annotation The annotation
 * @return The state of the text annotation
 */
zathura_annotation_text_state_t zathura_annotation_text_get_flags(zathura_annotation_t* annotation);

/**
 * Sets the state of the text annotation
 *
 * @param annotation The annotation
 * @param state The new state of the text annotation
 */
void zathura_annotation_text_set_state(zathura_annotation_t* annotation, zathura_annotation_text_state_t state);

/**
 * Returns the position of the annotation popup
 *
 * @param popup The annotation popup
 * @return The position of the annotation popup
 */
zathura_rectangle_t zathura_annotation_popup_get_position(zathura_annotation_popup_t* popup);

/**
 * Sets the position of the annotation popup
 *
 * @param popup The annotation popup
 * @param position The new position of the annotation popup
 */
void zathura_annotation_popup_set_position(zathura_annotation_popup_t* popup, zathura_rectangle_t position);

#endif // ANNOTATION_H