Update annotation functions

This commit is contained in:
Moritz Lipp 2012-05-19 07:51:23 +02:00
parent 5e42c18fc6
commit d02d49c79b
2 changed files with 98 additions and 277 deletions

View file

@ -11,9 +11,11 @@ struct zathura_annotation_s {
char* name; /**< Name of the annotation */ char* name; /**< Name of the annotation */
char* content; /**< Content of the annotation */ char* content; /**< Content of the annotation */
time_t modification_date; /**< Modification date */ time_t modification_date; /**< Modification date */
time_t creation_date; /**< Creation date */
zathura_page_t* page; /**< Zathura page */ zathura_page_t* page; /**< Zathura page */
zathura_rectangle_t position; /**< Position of the annotation */ zathura_rectangle_t position; /**< Position of the annotation */
void* user_data; /**< Custom data */ void* user_data; /**< Custom data */
zathura_annotation_popup_t* popup; /**< Optional popup */
union { union {
struct { struct {
@ -22,19 +24,11 @@ struct zathura_annotation_s {
bool opened; /**< Open status of the text annotation */ bool opened; /**< Open status of the text annotation */
} text; } text;
} data; } data;
struct {
char* label; /**< Label */
char* subject; /**< Subject of the annotation */
zathura_annotation_popup_t* popup; /**< Optional popup */
time_t creation_date; /**< Creation date */
} markup;
}; };
struct zathura_annotation_popup_s { struct zathura_annotation_popup_s {
double opacity; /**< The opacity of the popup */ char* label; /**< Label */
zathura_rectangle_t position; /**< Position of the annotation */ zathura_rectangle_t position; /**< Position of the annotation */
bool opened; /**< true if popup is opened */
}; };
static char* __strdup(const char* string); static char* __strdup(const char* string);
@ -57,7 +51,7 @@ zathura_annotation_new(zathura_annotation_type_t type)
annotation->type = type; annotation->type = type;
annotation->modification_date = (time_t) -1; annotation->modification_date = (time_t) -1;
annotation->markup.creation_date = (time_t) -1; annotation->creation_date = (time_t) -1;
annotation->data.text.icon = ZATHURA_ANNOTATION_TEXT_ICON_UNKNOWN; annotation->data.text.icon = ZATHURA_ANNOTATION_TEXT_ICON_UNKNOWN;
annotation->data.text.state = ZATHURA_ANNOTATION_TEXT_STATE_UNKNOWN; annotation->data.text.state = ZATHURA_ANNOTATION_TEXT_STATE_UNKNOWN;
@ -79,16 +73,8 @@ zathura_annotation_free(zathura_annotation_t* annotation)
free(annotation->content); free(annotation->content);
} }
if (annotation->markup.label != NULL) { if (annotation->popup != NULL) {
free(annotation->markup.label); zathura_annotation_popup_free(annotation->popup);
}
if (annotation->markup.subject != NULL) {
free(annotation->markup.subject);
}
if (annotation->markup.popup != NULL) {
zathura_annotation_popup_free(annotation->markup.popup);
} }
free(annotation); free(annotation);
@ -124,29 +110,6 @@ zathura_annotation_get_type(zathura_annotation_t* annotation)
return annotation->type; return annotation->type;
} }
bool
zathura_annotation_is_markup_annotation(zathura_annotation_t* annotation)
{
if (annotation == NULL) {
return false;
}
switch (annotation->type) {
case ZATHURA_ANNOTATION_TEXT:
case ZATHURA_ANNOTATION_FREE_TEXT:
case ZATHURA_ANNOTATION_LINE:
case ZATHURA_ANNOTATION_STAMP:
case ZATHURA_ANNOTATION_POLYGON:
case ZATHURA_ANNOTATION_CARET:
case ZATHURA_ANNOTATION_INK:
case ZATHURA_ANNOTATION_FILE_ATTACHMENT:
case ZATHURA_ANNOTATION_SOUND:
return true;
default:
return false;
}
}
zathura_annotation_flag_t zathura_annotation_flag_t
zathura_annotation_get_flags(zathura_annotation_t* annotation) zathura_annotation_get_flags(zathura_annotation_t* annotation)
{ {
@ -235,6 +198,27 @@ zathura_annotation_set_modification_date(zathura_annotation_t* annotation, time_
annotation->modification_date = modification_date; annotation->modification_date = modification_date;
} }
time_t
zathura_annotation_get_creation_date(zathura_annotation_t* annotation)
{
if (annotation == NULL) {
return (time_t) -1;
}
return annotation->creation_date;
}
void
zathura_annotation_set_creation_date(zathura_annotation_t* annotation, time_t creation_date)
{
if (annotation == NULL) {
return;
}
annotation->creation_date = creation_date;
}
zathura_page_t* zathura_page_t*
zathura_annotation_get_page(zathura_annotation_t* annotation) zathura_annotation_get_page(zathura_annotation_t* annotation)
{ {
@ -285,98 +269,55 @@ zathura_annotation_set_position(zathura_annotation_t* annotation,
} }
char* char*
zathura_annotation_markup_get_label(zathura_annotation_t* annotation) zathura_annotation_popup_get_label(zathura_annotation_popup_t* popup)
{ {
if (annotation == NULL || zathura_annotation_is_markup_annotation(annotation) == false) { if (popup == NULL) {
return NULL; return NULL;
} }
return annotation->markup.label; return popup->label;
} }
void void
zathura_annotation_markup_set_label(zathura_annotation_t* annotation, const char* label) zathura_annotation_popup_set_label(zathura_annotation_popup_t* popup, const char* label)
{ {
if (annotation == NULL || zathura_annotation_is_markup_annotation(annotation) == false) { if (popup == NULL) {
return; return;
} }
if (annotation->markup.label != NULL) { if (popup->label != NULL) {
free(annotation->markup.label); free(popup->label);
} }
if (label != NULL) { if (label != NULL) {
annotation->markup.label = __strdup(label); popup->label = __strdup(label);
} else { } else {
annotation->markup.label = NULL; popup->label = NULL;
}
}
char*
zathura_annotation_markup_get_subject(zathura_annotation_t* annotation)
{
if (annotation == NULL || zathura_annotation_is_markup_annotation(annotation) == false) {
return NULL;
}
return annotation->markup.subject;
}
void
zathura_annotation_markup_set_subject(zathura_annotation_t* annotation, const char* subject)
{
if (annotation == NULL || zathura_annotation_is_markup_annotation(annotation) == false) {
return;
}
if (annotation->markup.subject != NULL) {
free(annotation->markup.subject);
}
if (subject != NULL) {
annotation->markup.subject = __strdup(subject);
} else {
annotation->markup.subject = NULL;
} }
} }
zathura_annotation_popup_t* zathura_annotation_popup_t*
zathura_annotation_markup_get_popup(zathura_annotation_t* annotation) zathura_annotation_get_popup(zathura_annotation_t* annotation)
{ {
if (annotation == NULL || zathura_annotation_is_markup_annotation(annotation) == false) { if (annotation == NULL) {
return NULL; return NULL;
} }
return annotation->markup.popup; return annotation->popup;
} }
void void
zathura_annotation_markup_set_popup(zathura_annotation_t* annotation, zathura_annotation_popup_t* popup) zathura_annotation_set_popup(zathura_annotation_t* annotation, zathura_annotation_popup_t* popup)
{ {
if (annotation == NULL || zathura_annotation_is_markup_annotation(annotation) == false || popup == NULL) { if (annotation == NULL) {
return; return;
} }
annotation->markup.popup = popup; if (annotation->popup != NULL) {
zathura_annotation_popup_free(annotation->popup);
} }
time_t annotation->popup = popup;
zathura_annotation_markup_get_creation_date(zathura_annotation_t* annotation)
{
if (annotation == NULL || zathura_annotation_is_markup_annotation(annotation) == false) {
return (time_t) -1;
}
return annotation->markup.creation_date;
}
void
zathura_annotation_markup_set_creation_date(zathura_annotation_t* annotation, time_t creation_date)
{
if (annotation == NULL || zathura_annotation_is_markup_annotation(annotation) == false) {
return;
}
annotation->markup.creation_date = creation_date;
} }
zathura_annotation_text_icon_t zathura_annotation_text_icon_t
@ -447,8 +388,6 @@ zathura_annotation_popup_new()
return NULL; return NULL;
} }
popup->opacity = 1.0;
return popup; return popup;
} }
@ -490,52 +429,6 @@ zathura_annotation_popup_set_position(zathura_annotation_popup_t* popup, zathura
popup->position.y2 = position.y2; popup->position.y2 = position.y2;
} }
double
zathura_annotation_popup_get_opacity(zathura_annotation_popup_t* popup)
{
if (popup == NULL) {
return 0.0;
}
return popup->opacity;
}
void
zathura_annotation_popup_set_opacity(zathura_annotation_popup_t* popup, double opacity)
{
if (popup == NULL) {
return;
}
if (opacity < 0) {
popup->opacity = 0;
} else if (opacity > 1) {
popup->opacity = 1;
} else {
popup->opacity = opacity;
}
}
bool
zathura_annotation_popup_get_open_status(zathura_annotation_popup_t* popup)
{
if (popup == NULL) {
return false;
}
return popup->opened;
}
void
zathura_annotation_popup_set_open_status(zathura_annotation_popup_t* popup, bool opened)
{
if (popup == NULL) {
return;
}
popup->opened = opened;
}
static char* static char*
__strdup(const char* string) __strdup(const char* string)
{ {

View file

@ -118,14 +118,6 @@ void zathura_annotation_set_data(zathura_annotation_t* annotation, void* data);
*/ */
zathura_annotation_type_t zathura_annotation_get_type(zathura_annotation_t* annotation); zathura_annotation_type_t zathura_annotation_get_type(zathura_annotation_t* annotation);
/**
* True if the given annotation is a markup annotation
*
* @param annotation The annotation
* @return true whether the annotation is a markup annotation otherwise false
*/
bool zathura_annotation_is_markup_annotation(zathura_annotation_t* annotation);
/** /**
* Returns the flags of the annotation * Returns the flags of the annotation
* *
@ -190,6 +182,22 @@ time_t zathura_annotation_get_modification_date(zathura_annotation_t* annotation
*/ */
void zathura_annotation_set_modification_date(zathura_annotation_t* annotation, time_t 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 * Returns the page of the annotation
* *
@ -223,13 +231,43 @@ zathura_rectangle_t zathura_annotation_get_position(zathura_annotation_t* annota
*/ */
void zathura_annotation_set_position(zathura_annotation_t* annotation, zathura_rectangle_t position); 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 * Gets the current label of the markup annotation
* *
* @param annotation The annotation * @param annotation The annotation
* @return The label or NULL * @return The label or NULL
*/ */
char* zathura_annotation_markup_get_label(zathura_annotation_t* annotation); char* zathura_annotation_popup_get_label(zathura_annotation_popup_t* popup);
/** /**
* Sets the label of the markup annotation * Sets the label of the markup annotation
@ -237,55 +275,7 @@ char* zathura_annotation_markup_get_label(zathura_annotation_t* annotation);
* @param annotation The annotation * @param annotation The annotation
* @param label The new label of the markup annotation * @param label The new label of the markup annotation
*/ */
void zathura_annotation_markup_set_label(zathura_annotation_t* annotation, const char* label); void zathura_annotation_popup_set_label(zathura_annotation_popup_t* popup, const char* label);
/**
* Returns the subject of the markup annotation
*
* @param annotation The annotation
* @return The subject or NULL
*/
char* zathura_annotation_markup_get_subject(zathura_annotation_t* annotation);
/**
* Sets the new subject of the markup annotation
*
* @param annotation The annotation
* @param subject The new subject of the markup annotation
*/
void zathura_annotation_markup_set_subject(zathura_annotation_t* annotation, const char* subject);
/**
* Sets the annotation popup of the markup annotation
*
* @param annotation The annotation
* @return The popup (if available) from the markup annotation
*/
zathura_annotation_popup_t* zathura_annotation_markup_get_popup(zathura_annotation_t* annotation);
/**
* Sets the new popup for the markup annotation
*
* @param annotation The annotation
* @param popup The new popup for the markup annotation
*/
void zathura_annotation_markup_set_popup(zathura_annotation_t* annotation, zathura_annotation_popup_t* popup);
/**
* Returns the creation date of the annotation
*
* @param annotation The annotation
* @retun The creation date
*/
time_t zathura_annotation_markup_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_markup_set_creation_date(zathura_annotation_t* annotation, time_t creation_date);
/** /**
* Returns the defined icon of the text annotation * Returns the defined icon of the text annotation
@ -309,7 +299,7 @@ void zathura_annotation_text_set_icon(zathura_annotation_t* annotation, zathura_
* @param annotation The annotation * @param annotation The annotation
* @return The state of the text annotation * @return The state of the text annotation
*/ */
zathura_annotation_text_state_t zathura_annotation_text_get_state(zathura_annotation_t* annotation); int zathura_annotation_text_get_flags(zathura_annotation_t* annotation);
/** /**
* Sets the state of the text annotation * Sets the state of the text annotation
@ -317,37 +307,7 @@ zathura_annotation_text_state_t zathura_annotation_text_get_state(zathura_annota
* @param annotation The annotation * @param annotation The annotation
* @param state The new state of the text 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); void zathura_annotation_text_set_flags(zathura_annotation_t* annotation, int flags);
/**
* Returns whether the text annotation is open or not
*
* @param annotation The annotation
* @return true if the annotation is open otherwise false
*/
bool zathura_annotation_text_get_open_status(zathura_annotation_t* annotation);
/**
* Sets the text annotation open status
*
* @param annotation The annotation
* @param opened The new open status
*/
void zathura_annotation_text_set_open_status(zathura_annotation_t* annotation, bool opened);
/**
* 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);
/** /**
* Returns the position of the annotation popup * Returns the position of the annotation popup
@ -365,36 +325,4 @@ zathura_rectangle_t zathura_annotation_popup_get_position(zathura_annotation_pop
*/ */
void zathura_annotation_popup_set_position(zathura_annotation_popup_t* popup, zathura_rectangle_t position); void zathura_annotation_popup_set_position(zathura_annotation_popup_t* popup, zathura_rectangle_t position);
/**
* Returns the opacity of the annotation popup
*
* @param popup The annotation popup
* @return The opacity of the annotation popup
*/
double zathura_annotation_popup_get_opacity(zathura_annotation_popup_t* popup);
/**
* Sets the opacity of the annotation popup
*
* @param popup The annotation popup
* @param opacity The new value for the opacity
*/
void zathura_annotation_popup_set_opacity(zathura_annotation_popup_t* popup, double opacity);
/**
* Returns whether the popup is opened or not
*
* @param popup The annotation popup
* @return true if the popup is opened otherwise false
*/
bool zathura_annotation_popup_get_open_status(zathura_annotation_popup_t* popup);
/**
* Sets the open status of the popup
*
* @param popup The annotation popup
* @param opened The new status
*/
void zathura_annotation_popup_set_open_status(zathura_annotation_popup_t* popup, bool opened);
#endif // ANNOTATION_H #endif // ANNOTATION_H