/* Chrysalide - Outil d'analyse de fichiers binaires
 * operand-ui.c - gestion générique des opérandes sous forme graphique
 *
 * Copyright (C) 2024 Cyrille Bagard
 *
 *  This file is part of Chrysalide.
 *
 *  Chrysalide is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  Chrysalide 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 General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with Chrysalide.  If not, see <http://www.gnu.org/licenses/>.
 */


#include "operand-ui.h"


#include "operand-ui-int.h"



/* Procède à l'initialisation de l'interface d'opérande UI. */
static void g_arch_operand_ui_default_init(GArchOperandUIInterface *);



/* Indique le type défini pour un opérande d'architecture avec représentation graphique. */
G_DEFINE_INTERFACE(GArchOperandUI, g_arch_operand_ui, G_TYPE_OBJECT);


/******************************************************************************
*                                                                             *
*  Paramètres  : iface = interface GLib à initialiser.                        *
*                                                                             *
*  Description : Procède à l'initialisation de l'interface d'opérande UI.     *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void g_arch_operand_ui_default_init(GArchOperandUIInterface *iface)
{
    iface->print = NULL;
    iface->build_tooltip = NULL;

}


/******************************************************************************
*                                                                             *
*  Paramètres  : operand = opérande à traiter.                                *
*                line    = ligne tampon où imprimer l'opérande donné.         *
*                                                                             *
*  Description : Traduit un opérande en version humainement lisible.          *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

void g_arch_operand_ui_print(const GArchOperandUI *operand, GBufferLine *line)
{
    GArchOperandUIInterface *iface;         /* Interface utilisée          */

    iface = G_ARCH_OPERAND_UI_GET_IFACE(operand);

    iface->print(operand, line);

}


/******************************************************************************
*                                                                             *
*  Paramètres  : operand = opérande à consulter.                              *
*                binary  = informations relatives au binaire chargé.          *
*                                                                             *
*  Description : Construit un petit résumé concis de l'opérande.              *
*                                                                             *
*  Retour      : Chaîne de caractères à libérer après usage ou NULL.          *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

char *g_arch_operand_ui_build_tooltip(const GArchOperandUI *operand, const GLoadedBinary *binary)
{
    char *result;                           /* Description à retourner     */
    GArchOperandUIInterface *iface;         /* Interface utilisée          */

    iface = G_ARCH_OPERAND_UI_GET_IFACE(operand);

    if (iface->build_tooltip != NULL)
        result = iface->build_tooltip(operand, binary);
    else
        result = NULL;

    return result;

}