mirror of
https://git.pwmt.org/pwmt/zathura.git
synced 2024-12-28 19:26:02 +01:00
Update documentation
This commit is contained in:
parent
85290d1463
commit
f8f4345540
3 changed files with 73 additions and 73 deletions
82
document.h
82
document.h
|
@ -19,9 +19,9 @@ typedef bool (*zathura_document_open_t)(zathura_document_t* document);
|
||||||
*/
|
*/
|
||||||
typedef struct zathura_document_plugin_s
|
typedef struct zathura_document_plugin_s
|
||||||
{
|
{
|
||||||
girara_list_t* content_types; /**> List of supported content types */
|
girara_list_t* content_types; /**< List of supported content types */
|
||||||
zathura_document_open_t open_function; /**> Document open function */
|
zathura_document_open_t open_function; /**< Document open function */
|
||||||
void* handle; /**> DLL handle */
|
void* handle; /**< DLL handle */
|
||||||
} zathura_document_plugin_t;
|
} zathura_document_plugin_t;
|
||||||
|
|
||||||
typedef struct zathura_type_plugin_mapping_s
|
typedef struct zathura_type_plugin_mapping_s
|
||||||
|
@ -54,10 +54,10 @@ typedef void (*zathura_plugin_register_service_t)(zathura_document_plugin_t*);
|
||||||
*/
|
*/
|
||||||
typedef struct zathura_image_buffer_s
|
typedef struct zathura_image_buffer_s
|
||||||
{
|
{
|
||||||
unsigned char* data; /**> Image buffer data */
|
unsigned char* data; /**< Image buffer data */
|
||||||
unsigned int height; /**> Height of the image */
|
unsigned int height; /**< Height of the image */
|
||||||
unsigned int width; /**> Width of the image */
|
unsigned int width; /**< Width of the image */
|
||||||
unsigned int rowstride; /**> Rowstride of the image */
|
unsigned int rowstride; /**< Rowstride of the image */
|
||||||
} zathura_image_buffer_t;
|
} zathura_image_buffer_t;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -81,10 +81,10 @@ void zathura_image_buffer_free(zathura_image_buffer_t*);
|
||||||
*/
|
*/
|
||||||
typedef struct zathura_rectangle_s
|
typedef struct zathura_rectangle_s
|
||||||
{
|
{
|
||||||
double x1; /**> X coordinate of point 1 */
|
double x1; /**< X coordinate of point 1 */
|
||||||
double y1; /**> Y coordinate of point 1 */
|
double y1; /**< Y coordinate of point 1 */
|
||||||
double x2; /**> X coordinate of point 2 */
|
double x2; /**< X coordinate of point 2 */
|
||||||
double y2; /**> Y coordinate of point 2 */
|
double y2; /**< Y coordinate of point 2 */
|
||||||
} zathura_rectangle_t;
|
} zathura_rectangle_t;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -92,8 +92,8 @@ typedef struct zathura_rectangle_s
|
||||||
*/
|
*/
|
||||||
typedef enum zathura_link_type_e
|
typedef enum zathura_link_type_e
|
||||||
{
|
{
|
||||||
ZATHURA_LINK_TO_PAGE, /**> Links to a page */
|
ZATHURA_LINK_TO_PAGE, /**< Links to a page */
|
||||||
ZATHURA_LINK_EXTERNAL, /**> Links to an external source */
|
ZATHURA_LINK_EXTERNAL, /**< Links to an external source */
|
||||||
} zathura_link_type_t;
|
} zathura_link_type_t;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -101,12 +101,12 @@ typedef enum zathura_link_type_e
|
||||||
*/
|
*/
|
||||||
typedef struct zathura_link_s
|
typedef struct zathura_link_s
|
||||||
{
|
{
|
||||||
zathura_rectangle_t position; /**> Position of the link */
|
zathura_rectangle_t position; /**< Position of the link */
|
||||||
zathura_link_type_t type; /**> Link type */
|
zathura_link_type_t type; /**< Link type */
|
||||||
union
|
union
|
||||||
{
|
{
|
||||||
unsigned int page_number; /**> Page number */
|
unsigned int page_number; /**< Page number */
|
||||||
char* value; /**> Value */
|
char* value; /**< Value */
|
||||||
} target;
|
} target;
|
||||||
} zathura_link_t;
|
} zathura_link_t;
|
||||||
|
|
||||||
|
@ -115,12 +115,12 @@ typedef struct zathura_link_s
|
||||||
*/
|
*/
|
||||||
typedef struct zathura_index_element_s
|
typedef struct zathura_index_element_s
|
||||||
{
|
{
|
||||||
char* title; /**> Title of the element */
|
char* title; /**< Title of the element */
|
||||||
zathura_link_type_t type; /**> Type */
|
zathura_link_type_t type; /**< Type */
|
||||||
union
|
union
|
||||||
{
|
{
|
||||||
unsigned int page_number; /**> Page number */
|
unsigned int page_number; /**< Page number */
|
||||||
char* uri; /**> Uri */
|
char* uri; /**< Uri */
|
||||||
} target;
|
} target;
|
||||||
} zathura_index_element_t;
|
} zathura_index_element_t;
|
||||||
|
|
||||||
|
@ -129,8 +129,8 @@ typedef struct zathura_index_element_s
|
||||||
*/
|
*/
|
||||||
typedef enum zathura_form_type_e
|
typedef enum zathura_form_type_e
|
||||||
{
|
{
|
||||||
ZATHURA_FORM_CHECKBOX, /**> Checkbox */
|
ZATHURA_FORM_CHECKBOX, /**< Checkbox */
|
||||||
ZATHURA_FORM_TEXTFIELD /**> Textfield */
|
ZATHURA_FORM_TEXTFIELD /**< Textfield */
|
||||||
} zathura_form_type_t;
|
} zathura_form_type_t;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -138,8 +138,8 @@ typedef enum zathura_form_type_e
|
||||||
*/
|
*/
|
||||||
typedef struct zathura_form_s
|
typedef struct zathura_form_s
|
||||||
{
|
{
|
||||||
zathura_rectangle_t position; /**> Position */
|
zathura_rectangle_t position; /**< Position */
|
||||||
zathura_form_type_t type; /**> Type */
|
zathura_form_type_t type; /**< Type */
|
||||||
} zathura_form_t;
|
} zathura_form_t;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -147,15 +147,15 @@ typedef struct zathura_form_s
|
||||||
*/
|
*/
|
||||||
struct zathura_page_s
|
struct zathura_page_s
|
||||||
{
|
{
|
||||||
double height; /**> Page height */
|
double height; /**< Page height */
|
||||||
double width; /**> Page width */
|
double width; /**< Page width */
|
||||||
unsigned int number; /**> Page number */
|
unsigned int number; /**< Page number */
|
||||||
zathura_document_t* document; /**> Document */
|
zathura_document_t* document; /**< Document */
|
||||||
void* data; /**> Custom data */
|
void* data; /**< Custom data */
|
||||||
bool visible; /**> Page is visible */
|
bool visible; /**< Page is visible */
|
||||||
GtkWidget* event_box; /**> Widget wrapper for mouse events */
|
GtkWidget* event_box; /**< Widget wrapper for mouse events */
|
||||||
GtkWidget* drawing_area; /**> Drawing area */
|
GtkWidget* drawing_area; /**< Drawing area */
|
||||||
GStaticMutex lock; /**> Lock */
|
GStaticMutex lock; /**< Lock */
|
||||||
cairo_surface_t* surface; /** Cairo surface */
|
cairo_surface_t* surface; /** Cairo surface */
|
||||||
};
|
};
|
||||||
|
|
||||||
|
@ -164,13 +164,13 @@ struct zathura_page_s
|
||||||
*/
|
*/
|
||||||
struct zathura_document_s
|
struct zathura_document_s
|
||||||
{
|
{
|
||||||
char* file_path; /**> File path of the document */
|
char* file_path; /**< File path of the document */
|
||||||
const char* password; /**> Password of the document */
|
const char* password; /**< Password of the document */
|
||||||
unsigned int current_page_number; /**> Current page number */
|
unsigned int current_page_number; /**< Current page number */
|
||||||
unsigned int number_of_pages; /**> Number of pages */
|
unsigned int number_of_pages; /**< Number of pages */
|
||||||
double scale; /**> Scale value */
|
double scale; /**< Scale value */
|
||||||
int rotate; /**> Rotation */
|
int rotate; /**< Rotation */
|
||||||
void* data; /**> Custom data */
|
void* data; /**< Custom data */
|
||||||
zathura_t* zathura; /** Zathura object */
|
zathura_t* zathura; /** Zathura object */
|
||||||
|
|
||||||
struct
|
struct
|
||||||
|
|
10
render.h
10
render.h
|
@ -12,11 +12,11 @@
|
||||||
|
|
||||||
struct render_thread_s
|
struct render_thread_s
|
||||||
{
|
{
|
||||||
girara_list_t* list; /**> The list of pages */
|
girara_list_t* list; /**< The list of pages */
|
||||||
GThread* thread; /**> The thread object */
|
GThread* thread; /**< The thread object */
|
||||||
GMutex* lock; /**> Lock */
|
GMutex* lock; /**< Lock */
|
||||||
GCond* cond; /**> Condition */
|
GCond* cond; /**< Condition */
|
||||||
zathura_t* zathura; /**> Zathura object */
|
zathura_t* zathura; /**< Zathura object */
|
||||||
};
|
};
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|
54
zathura.h
54
zathura.h
|
@ -36,69 +36,69 @@ typedef struct zathura_s
|
||||||
{
|
{
|
||||||
struct
|
struct
|
||||||
{
|
{
|
||||||
girara_session_t* session; /**> girara interface session */
|
girara_session_t* session; /**< girara interface session */
|
||||||
|
|
||||||
struct
|
struct
|
||||||
{
|
{
|
||||||
girara_statusbar_item_t* buffer; /**> buffer statusbar entry */
|
girara_statusbar_item_t* buffer; /**< buffer statusbar entry */
|
||||||
girara_statusbar_item_t* file; /**> file statusbar entry */
|
girara_statusbar_item_t* file; /**< file statusbar entry */
|
||||||
girara_statusbar_item_t* page_number; /**> page number statusbar entry */
|
girara_statusbar_item_t* page_number; /**< page number statusbar entry */
|
||||||
} statusbar;
|
} statusbar;
|
||||||
|
|
||||||
struct
|
struct
|
||||||
{
|
{
|
||||||
GdkColor recolor_dark_color; /**> Dark color for recoloring */
|
GdkColor recolor_dark_color; /**< Dark color for recoloring */
|
||||||
GdkColor recolor_light_color; /**> Light color for recoloring */
|
GdkColor recolor_light_color; /**< Light color for recoloring */
|
||||||
GdkColor highlight_color; /**> Color for highlighting */
|
GdkColor highlight_color; /**< Color for highlighting */
|
||||||
} colors;
|
} colors;
|
||||||
|
|
||||||
GtkWidget *page_view_alignment;
|
GtkWidget *page_view_alignment;
|
||||||
GtkWidget *page_view; /**> Widget that contains all rendered pages */
|
GtkWidget *page_view; /**< Widget that contains all rendered pages */
|
||||||
GtkWidget *index; /**> Widget to show the index of the document */
|
GtkWidget *index; /**< Widget to show the index of the document */
|
||||||
} ui;
|
} ui;
|
||||||
|
|
||||||
struct
|
struct
|
||||||
{
|
{
|
||||||
render_thread_t* render_thread; /**> The thread responsible for rendering the pages */
|
render_thread_t* render_thread; /**< The thread responsible for rendering the pages */
|
||||||
} sync;
|
} sync;
|
||||||
|
|
||||||
struct
|
struct
|
||||||
{
|
{
|
||||||
girara_list_t* plugins; /**> List of plugins */
|
girara_list_t* plugins; /**< List of plugins */
|
||||||
girara_list_t* path; /**> List of plugin paths */
|
girara_list_t* path; /**< List of plugin paths */
|
||||||
girara_list_t* type_plugin_mapping; /**> List of type -> plugin mappings */
|
girara_list_t* type_plugin_mapping; /**< List of type -> plugin mappings */
|
||||||
} plugins;
|
} plugins;
|
||||||
|
|
||||||
struct
|
struct
|
||||||
{
|
{
|
||||||
gchar* config_dir; /**> Path to the configuration directory */
|
gchar* config_dir; /**< Path to the configuration directory */
|
||||||
gchar* data_dir; /**> Path to the data directory */
|
gchar* data_dir; /**< Path to the data directory */
|
||||||
} config;
|
} config;
|
||||||
|
|
||||||
struct
|
struct
|
||||||
{
|
{
|
||||||
GtkPrintSettings* settings; /**> Print settings */
|
GtkPrintSettings* settings; /**< Print settings */
|
||||||
GtkPageSetup* page_setup; /**> Saved page setup */
|
GtkPageSetup* page_setup; /**< Saved page setup */
|
||||||
} print;
|
} print;
|
||||||
|
|
||||||
struct
|
struct
|
||||||
{
|
{
|
||||||
unsigned int page_padding; /**> Padding between the pages */
|
unsigned int page_padding; /**< Padding between the pages */
|
||||||
bool recolor; /**> Recoloring mode switch */
|
bool recolor; /**< Recoloring mode switch */
|
||||||
} global;
|
} global;
|
||||||
|
|
||||||
struct
|
struct
|
||||||
{
|
{
|
||||||
girara_mode_t normal; /**> Normal mode */
|
girara_mode_t normal; /**< Normal mode */
|
||||||
girara_mode_t fullscreen; /**> Fullscreen mode */
|
girara_mode_t fullscreen; /**< Fullscreen mode */
|
||||||
girara_mode_t index; /**> Index mode */
|
girara_mode_t index; /**< Index mode */
|
||||||
girara_mode_t insert; /**> Insert mode */
|
girara_mode_t insert; /**< Insert mode */
|
||||||
} modes;
|
} modes;
|
||||||
|
|
||||||
struct
|
struct
|
||||||
{
|
{
|
||||||
gchar* file; /**> bookmarks file */
|
gchar* file; /**< bookmarks file */
|
||||||
girara_list_t* bookmarks; /**> bookmarks */
|
girara_list_t* bookmarks; /**< bookmarks */
|
||||||
} bookmarks;
|
} bookmarks;
|
||||||
|
|
||||||
struct
|
struct
|
||||||
|
@ -106,8 +106,8 @@ typedef struct zathura_s
|
||||||
gchar* file;
|
gchar* file;
|
||||||
} stdin_support;
|
} stdin_support;
|
||||||
|
|
||||||
zathura_document_t* document; /**> The current document */
|
zathura_document_t* document; /**< The current document */
|
||||||
zathura_database_t* database; /**> The database */
|
zathura_database_t* database; /**< The database */
|
||||||
} zathura_t;
|
} zathura_t;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|
Loading…
Reference in a new issue