/* * Copyright (C) 2018 Purism SPC * * This file is part of Calls. * * Calls 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. * * Calls 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 Calls. If not, see . * * Author: Bob Ham * * SPDX-License-Identifier: GPL-3.0-or-later * */ #include "calls-origin.h" #include "calls-message-source.h" #include "util.h" /** * SECTION:calls-origin * @short_description: An object that originates calls. * @Title: CallsOrigin */ G_DEFINE_INTERFACE (CallsOrigin, calls_origin, CALLS_TYPE_MESSAGE_SOURCE); enum { SIGNAL_CALL_ADDED, SIGNAL_CALL_REMOVED, SIGNAL_LAST_SIGNAL, }; static guint signals [SIGNAL_LAST_SIGNAL]; static void calls_origin_default_init (CallsOriginInterface *iface) { GType arg_types[2] = { CALLS_TYPE_CALL, G_TYPE_STRING }; signals[SIGNAL_CALL_ADDED] = g_signal_newv ("call-added", G_TYPE_FROM_INTERFACE (iface), G_SIGNAL_RUN_LAST, NULL, NULL, NULL, NULL, G_TYPE_NONE, 1, arg_types); signals[SIGNAL_CALL_REMOVED] = g_signal_newv ("call-removed", G_TYPE_FROM_INTERFACE (iface), G_SIGNAL_RUN_LAST, NULL, NULL, NULL, NULL, G_TYPE_NONE, 2, arg_types); } #define DEFINE_ORIGIN_FUNC(function,rettype,errval) \ CALLS_DEFINE_IFACE_FUNC(origin, Origin, ORIGIN, \ function, rettype, errval) /** * calls_origin_get_name: * @self: a #CallsOrigin * * Get the user-presentable name of the origin. * * Returns: A string containing the name. The string must be freed by * the caller. */ DEFINE_ORIGIN_FUNC(get_name, const gchar *, NULL); /** * calls_origin_get_calls: * @self: a #CallsOrigin * @error: a #GError, or #NULL * * Get the list of current calls. * * Returns: A newly-allocated GList of objects implementing * #CallsCall or NULL if there was an error. */ DEFINE_ORIGIN_FUNC(get_calls, GList *, NULL); /** * calls_origin_dial: * @self: a #CallsOrigin * @number: the number to dial * * Dial a new number from this origin. If a new call is successfully * created, the #call-added signal will be emitted with the call. If * there is an error, an appropriate #message signal will be emitted. */ void calls_origin_dial(CallsOrigin *self, const gchar *number) { CallsOriginInterface *iface; g_return_if_fail (CALLS_IS_ORIGIN (self)); g_return_if_fail (number != NULL); iface = CALLS_ORIGIN_GET_IFACE (self); g_return_if_fail (iface->dial != NULL); return iface->dial(self, number); }