aboutsummaryrefslogblamecommitdiffstats
path: root/em-format/e-mail-formatter.h
blob: 2c7b144359cec70010b21b9a1c19065bbaa8efea (plain) (tree)




















                                                                             


                                         


                                                

























                                                             
                                  
































                                                                               
                                        




                               
                                 
                                
                                        

                   










                                                            
                                                   

                                          
                                                         
 

                                                                     
 



                                                                                
 

                                                                           
 
                     
                                                                            









                                                                           
                                                                                 





                                                                            
                                                                                 


























                                                                                

                                                      

                                                                            
               



                                                                               


                                                                           













                                                                                 


















                                                                             
                                                                            




                                                                            

                                                                            




                                                                            
                                                                            








                                                                            
                                                                                  





















                                                                                     
/*
 * e-mail-formatter.h
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) version 3.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with the program; if not, see <http://www.gnu.org/licenses/>
 *
 */

#ifndef E_MAIL_FORMATTER_H_
#define E_MAIL_FORMATTER_H_

#include <gdk/gdk.h>
#include <libemail-engine/e-mail-enums.h>

#include <em-format/e-mail-extension-registry.h>
#include <em-format/e-mail-part-list.h>

/* Standard GObject macros */
#define E_TYPE_MAIL_FORMATTER \
    (e_mail_formatter_get_type ())
#define E_MAIL_FORMATTER(obj) \
    (G_TYPE_CHECK_INSTANCE_CAST \
    ((obj), E_TYPE_MAIL_FORMATTER, EMailFormatter))
#define E_MAIL_FORMATTER_CLASS(cls) \
    (G_TYPE_CHECK_CLASS_CAST \
    ((cls), E_TYPE_MAIL_FORMATTER, EMailFormatterClass))
#define E_IS_MAIL_FORMATTER(obj) \
    (G_TYPE_CHECK_INSTANCE_TYPE \
    ((obj), E_TYPE_MAIL_FORMATTER))
#define E_IS_MAIL_FORMATTER_CLASS(cls) \
    (G_TYPE_CHECK_CLASS_TYPE \
    ((cls), E_TYPE_MAIL_FORMATTER))
#define E_MAIL_FORMATTER_GET_CLASS(obj) \
    (G_TYPE_INSTANCE_GET_CLASS \
    ((obj), E_TYPE_MAIL_FORMATTER, EMailFormatterClass))

G_BEGIN_DECLS;

typedef enum {
    E_MAIL_FORMATTER_MODE_INVALID           = -1,
    E_MAIL_FORMATTER_MODE_NORMAL            = 0,
    E_MAIL_FORMATTER_MODE_SOURCE,
    E_MAIL_FORMATTER_MODE_RAW,
    E_MAIL_FORMATTER_MODE_CID,
    E_MAIL_FORMATTER_MODE_PRINTING,
    E_MAIL_FORMATTER_MODE_ALL_HEADERS
} EMailFormatterMode;

typedef enum {
    E_MAIL_FORMATTER_HEADER_FLAG_COLLAPSABLE    = 1 << 0,
    E_MAIL_FORMATTER_HEADER_FLAG_COLLAPSED      = 1 << 1,
    E_MAIL_FORMATTER_HEADER_FLAG_HTML       = 1 << 2,
    E_MAIL_FORMATTER_HEADER_FLAG_NOCOLUMNS      = 1 << 3,
    E_MAIL_FORMATTER_HEADER_FLAG_BOLD       = 1 << 4,
    E_MAIL_FORMATTER_HEADER_FLAG_NODEC      = 1 << 5,
    E_MAIL_FORMATTER_HEADER_FLAG_HIDDEN     = 1 << 6,
    E_MAIL_FORMATTER_HEADER_FLAG_NOLINKS        = 1 << 7,
    E_MAIL_FORMATTER_HEADER_FLAG_NOELIPSIZE     = 1 << 8
} EMailFormatterHeaderFlags;

typedef enum {
    E_MAIL_FORMATTER_COLOR_BODY,        /* header area background */
    E_MAIL_FORMATTER_COLOR_CITATION,    /* citation font color */
    E_MAIL_FORMATTER_COLOR_CONTENT,     /* message area background */
    E_MAIL_FORMATTER_COLOR_FRAME,       /* frame around message area */
    E_MAIL_FORMATTER_COLOR_HEADER,      /* header font color */
    E_MAIL_FORMATTER_COLOR_TEXT,        /* message font color */
    E_MAIL_FORMATTER_NUM_COLOR_TYPES
} EMailFormatterColorType;

typedef struct _EMailFormatter EMailFormatter;
typedef struct _EMailFormatterClass EMailFormatterClass;
typedef struct _EMailFormatterPrivate EMailFormatterPrivate;
typedef struct _EMailFormatterHeader EMailFormatterHeader;
typedef struct _EMailFormatterContext EMailFormatterContext;

struct _EMailFormatterHeader {
    EMailFormatterHeaderFlags flags;
    gchar *name;
    gchar *value;
};

struct _EMailFormatterContext {
    EMailPartList *part_list;
    EMailFormatterMode mode;
    EMailFormatterHeaderFlags flags;

    gchar *uri;
};

struct _EMailFormatter {
    GObject parent;
    EMailFormatterPrivate *priv;
};

struct _EMailFormatterClass {
    GObjectClass parent_class;

    EMailFormatterExtensionRegistry *extension_registry;
    CamelMimeFilterToHTMLFlags text_html_flags;

    /* Colors should apply globally */
    GdkRGBA colors[E_MAIL_FORMATTER_NUM_COLOR_TYPES];

    /* sizeof(EMailFormatterContext) or some derivative struct */
    gsize context_size;

    void        (*run)          (EMailFormatter *formatter,
                         EMailFormatterContext *context,
                         CamelStream *stream,
                         GCancellable *cancellable);

    void        (*update_style)     (EMailFormatter *formatter,
                         GtkStateFlags state);

    /* Signals */
    void        (*need_redraw)      (EMailFormatter *formatter);
};

GType       e_mail_formatter_get_type   (void);

EMailFormatter *
        e_mail_formatter_new        (void);

void        e_mail_formatter_format_sync    (EMailFormatter *formatter,
                         EMailPartList *parts_list,
                         CamelStream *stream,
                         EMailFormatterHeaderFlags flags,
                         EMailFormatterMode mode,
                         GCancellable *cancellable);

void        e_mail_formatter_format     (EMailFormatter *formatter,
                         EMailPartList *parts_list,
                         CamelStream *stream,
                         EMailFormatterHeaderFlags flags,
                         EMailFormatterMode mode,
                         GAsyncReadyCallback callback,
                         GCancellable *cancellable,
                         gpointer user_data);

CamelStream *   e_mail_formatter_format_finished
                        (EMailFormatter *formatter,
                         GAsyncResult *result,
                         GError *error);

gboolean    e_mail_formatter_format_as  (EMailFormatter *formatter,
                         EMailFormatterContext *context,
                         EMailPart *part,
                         CamelStream *stream,
                         const gchar *as_mime_type,
                         GCancellable *cancellable);

void        e_mail_formatter_format_text    (EMailFormatter *formatter,
                         EMailPart *part,
                         CamelStream *stream,
                         GCancellable *cancellable);
gchar *     e_mail_formatter_get_html_header
                        (EMailFormatter *formatter);
EMailExtensionRegistry *
        e_mail_formatter_get_extension_registry
                        (EMailFormatter *formatter);

CamelMimeFilterToHTMLFlags
        e_mail_formatter_get_text_format_flags
                        (EMailFormatter *formatter);

const GdkRGBA *
        e_mail_formatter_get_color  (EMailFormatter *formatter,
                         EMailFormatterColorType type);
void        e_mail_formatter_set_color  (EMailFormatter *efh,
                         EMailFormatterColorType type,
                         const GdkRGBA *color);
void        e_mail_formatter_update_style   (EMailFormatter *formatter,
                         GtkStateFlags state);

EMailImageLoadingPolicy
        e_mail_formatter_get_image_loading_policy
                        (EMailFormatter *formatter);
void        e_mail_formatter_set_image_loading_policy
                        (EMailFormatter *formatter,
                         EMailImageLoadingPolicy policy);

gboolean    e_mail_formatter_get_mark_citations
                        (EMailFormatter *formatter);
void        e_mail_formatter_set_mark_citations
                        (EMailFormatter *formatter,
                         gboolean mark_citations);

gboolean    e_mail_formatter_get_show_sender_photo
                        (EMailFormatter *formatter);
void        e_mail_formatter_set_show_sender_photo
                        (EMailFormatter *formatter,
                         gboolean show_sender_photo);

gboolean        e_mail_formatter_get_animate_images
                                                (EMailFormatter *formatter);
void            e_mail_formatter_set_animate_images
                                                (EMailFormatter *formatter,
                                                 gboolean animate_images);

gboolean    e_mail_formatter_get_show_real_date
                        (EMailFormatter *formatter);
void        e_mail_formatter_set_show_real_date
                        (EMailFormatter *formatter,
                         gboolean show_real_date);

const gchar *   e_mail_formatter_get_charset    (EMailFormatter *formatter);
gchar *     e_mail_formatter_dup_charset    (EMailFormatter *formatter);
void        e_mail_formatter_set_charset    (EMailFormatter *formatter,
                         const gchar *charset);

const gchar *   e_mail_formatter_get_default_charset
                        (EMailFormatter *formatter);
gchar *     e_mail_formatter_dup_default_charset
                        (EMailFormatter *formatter);
void        e_mail_formatter_set_default_charset
                        (EMailFormatter *formatter,
                         const gchar *charset);

const GQueue *  e_mail_formatter_get_headers    (EMailFormatter *formatter);
GQueue *    e_mail_formatter_dup_headers    (EMailFormatter *formatter);

void        e_mail_formatter_clear_headers  (EMailFormatter *formatter);

void        e_mail_formatter_set_default_headers
                        (EMailFormatter *formatter);

void        e_mail_formatter_add_header (EMailFormatter *formatter,
                         const gchar *name,
                         const gchar *value,
                         EMailFormatterHeaderFlags flags);

void        e_mail_formatter_add_header_struct
                        (EMailFormatter *formatter,
                         const EMailFormatterHeader *header);

void        e_mail_formatter_remove_header  (EMailFormatter *formatter,
                         const gchar *name,
                         const gchar *value);

void        e_mail_formatter_remove_header_struct
                        (EMailFormatter *formatter,
                         const EMailFormatterHeader *header);

EMailFormatterHeader *
        e_mail_formatter_header_new (const gchar *name,
                         const gchar *value);

void        e_mail_formatter_header_free    (EMailFormatterHeader *header);

G_END_DECLS

#endif /* E_MAIL_FORMATTER_H_ */