messenger-gtk

Gtk+3 graphical user interfaces for GNUnet Messenger
Log | Files | Refs | Submodules | README | LICENSE

media_preview.h (1950B)

      1 /*
      2    This file is part of GNUnet.
      3    Copyright (C) 2024 GNUnet e.V.
      4 
      5    GNUnet is free software: you can redistribute it and/or modify it
      6    under the terms of the GNU Affero General Public License as published
      7    by the Free Software Foundation, either version 3 of the License,
      8    or (at your option) any later version.
      9 
     10    GNUnet is distributed in the hope that it will be useful, but
     11    WITHOUT ANY WARRANTY; without even the implied warranty of
     12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     13    Affero General Public License for more details.
     14 
     15    You should have received a copy of the GNU Affero General Public License
     16    along with this program.  If not, see <http://www.gnu.org/licenses/>.
     17 
     18    SPDX-License-Identifier: AGPL3.0-or-later
     19  */
     20 /*
     21  * @author Tobias Frisch
     22  * @file ui/media_preview.h
     23  */
     24 
     25 #ifndef UI_MEDIA_PREVIEW_H_
     26 #define UI_MEDIA_PREVIEW_H_
     27 
     28 #include <gnunet/gnunet_chat_lib.h>
     29 
     30 #include "messenger.h"
     31 
     32 typedef struct UI_MEDIA_PREVIEW_Handle
     33 {
     34   const struct GNUNET_CHAT_File *file;
     35 
     36   GtkBuilder *builder;
     37 
     38   GtkWidget *media_box;
     39   
     40   GtkDrawingArea *preview_drawing_area;
     41 
     42   MESSENGER_Application *app;
     43 } UI_MEDIA_PREVIEW_Handle;
     44 
     45 /**
     46  * Allocates and creates a new media preview handle
     47  * to manage loading files for a given messenger
     48  * application.
     49  *
     50  * @param app Messenger application
     51  * @return New media preview handle
     52  */
     53 UI_MEDIA_PREVIEW_Handle*
     54 ui_media_preview_new(MESSENGER_Application *app);
     55 
     56 /**
     57  * Updates a media preview handle with a selected
     58  * file to represent it visually.
     59  *
     60  * @param handle Media preview handle
     61  * @param file Chat file
     62  */
     63 void
     64 ui_media_preview_update(UI_MEDIA_PREVIEW_Handle *handle,
     65                         struct GNUNET_CHAT_File *file);
     66 
     67 /**
     68  * Frees its resources and destroys a given media 
     69  * preview handle.
     70  *
     71  * @param handle Media preview handle
     72  */
     73 void
     74 ui_media_preview_delete(UI_MEDIA_PREVIEW_Handle *handle);
     75 
     76 #endif /* UI_MEDIA_PREVIEW_H_ */