View source for Dialer

==librtcom-dialer-ui==
These different sets of functions are exported by librtcom-dialer-ui for use by the dialer app. It specifically concentrates on non-UI stuff as that's what a dialer replacement would need.
Types are implement via the glib type system (g_type_register_static_simple and friends)

===cui_account_model===
Implements type CuiAccountModel which is a UI widget derived from a GtkListStore

===cui_account_selector===
Implements type CuiAccountSelector which is a UI widget derived from a HildonTouchSelector

===cui_audio_call_view===
Implements type CuiAudioCallView which is a UI widget derived from a <code>CuiCallView</code>

===cui_audio_policy===
Implements type <code>CuiAudioPolicy</code> which is used to control audio policy settings

====set mute====
dbus method call to <code>org.maemo.Playback.Manager</code> <code>/org/maemo/Playback/Manager</code> <code>org.maemo.Playback.Manager.RequestMute</code> one argument, boolean (true/false to set mute)

====set speaker====
dbus method call to <code>org.maemo.Playback.Manager</code> <code>/org/maemo/Playback/Manager</code> <code>org.maemo.Playback.Manager.RequestPrivacyOverride</code> one argument, boolean (true/false to set mute)

====set bluetooth override====
dbus method call to <code>org.maemo.Playback.Manager</code> <code>/org/maemo/Playback/Manager</code> <code>org.maemo.Playback.Manager.RequestBluetoothOverride</code> one argument, boolean (true/false to set mute)

====mute signal====
dbus signal from<code>org.maemo.Playback.Manager</code> <code>/org/maemo/Playback/Manager</code> <code>Mute</code> one argument, boolean (true/false to get mute)

====speaker signal====
dbus signal from <code>org.maemo.Playback.Manager</code> <code>/org/maemo/Playback/Manager</code> <code>PrivacyOverride</code> one argument, boolean (true/false to get speaker)

====bluetooth override signal====
dbus signal from <code>org.maemo.Playback.Manager</code> <code>/org/maemo/Playback/Manager</code> <code>BluetoothOverride</code> one argument, integer (unknown argument)

====request hold====
dbus method call to <code>com.nokia.policy.telephony</code> <code>/com/nokia/policy/telephony</code> <code>com.nokia.policy.telephony.RequestHold</code> arguments appear to be string, object_path, boolean (unknown arguments)

====request accept====
dbus method call to <code>com.nokia.policy.telephony</code> <code>/com/nokia/policy/telephony</code> <code>com.nokia.policy.telephony.RequestAccept</code> arguments appear to be, object_path (unknown arguments)

====headset button pressed signal====
Register callback via <code>libhal_ctx_set_device_condition</code> and listen for condition_name = "<code>ButtonPressed</code>" and condition_detail = "<code>phone</code>"

====headset jack state signal====
Register callback via <code>libhal_ctx_set_device_property_modified</code> and listen for udi = "<code>/org/freedesktop/Hal/devices/platform_soc_audio_logicaldev_input</code>" and key = "<code>input.jack.type</code>"
Also call <code>libhal_device_add_property_watch</code> to watch for property "<code>/org/freedesktop/Hal/devices/platform_soc_audio_logicaldev_input</code>"

====get headset jack type====
call <code>libhal_device_get_property_strlist</code> udi = "<code>/org/freedesktop/Hal/devices/platform_soc_audio_logicaldev_input</code>" key = "<code>input.jack.type</code>". Code checks for type = "<code>headphone</code>"

===cui_avatar_image===
Implements type <code>CuiAvatarImage</code> which is a UI widget derived from <code>OssoABookAvatarImage</code>

===cui_button_box===
Implements type <code>CuiButtonBox</code> which is a UI widget derived from <code>GtkBox</code>

===cui_call_banner===
Implements type <code>CuiCallBanner</code> which is a UI widget derived from <code>GtkFrame</code>

===cui_call_context===
Implements type <code>CuiCallContext</code> which is used for call context. Details TBA.

===cui_call_control===
Implements type <code>CuiCallControl</code> which is a UI widget derived from <code>GtkAlignment</code>.

===cui_call_store===
Implements type <code>CuiCallStore</code> which is used for call store. Details TBA.

===cui_call_view===
Implements type <code>CuiCallView</code> which is a UI widget derived from <code>GtkAlignment</code>

===cui_conf_call_context===
Implements type <code>CuiConfCallContext</code> which is used for conference call context (derives from <code>CuiCallContext</code>). Details TBA.

===cui_conf_call_view===
Implements type <code>CuiConfCallView</code> which is a UI widget derived from <code>CuiCallView</code>

===cui_credit_label===
Implements type <code>CuiCreditLabel</code> which is a UI widget derived from <code>GtkAlignment</code>

===cui_cs_proxy===
Implements type <code>CuiCsProxy</code> which is used for call interface items

====get emergency numbers====
dbus method call to <code>com.nokia.csd.Call</code> <code>/com/nokia/csd/call</code> <code>com.nokia.csd.Call.GetEmergencyNumbers</code>. No arguments, reply argument is array of strings.

====get IMEI====
dbus method call to <code>com.nokia.phone.SIM</code> <code>/com/nokia/phone/SIM/security</code> <code>Phone.Sim.Security.get_imei</code>. No arguments, reply argument is string.

====modem state====
dbus method call to <code>com.nokia.phone.SSC</code> <code>/com/nokia/phone/SSC</code> <code>com.nokia.phone.SSC.get_modem_state</code>. No arguments, reply argument is string.

====short code====
compares against the string 0123456789*# with <code>strspn</code>. checks if its emergency number. dbus method call to <code>com.nokia.phone.net</code> <code>/com/nokia/phone/net</code> <code>Phone.Net.get_registration_status</code>. No arguments, reply argument is unsigned int.

====verify security code====
dbus method call to <code>com.nokia.phone.SIM</code> <code>/com/nokia/phone/SIM/security</code> <code>Phone.Sim.Security.verify_code</code>. Arguments are unsigned int, string, string. Return argument is int.

====emergency numbers changed signal====
dbus signal from <code>com.nokia.csd.Call</code> <code>/com/nokia/csd/call</code> <code>EmergencyNumbersChanged</code>. Argument is array of strings.

====modem state changed signal====
dbus signal from <code>com.nokia.phone.SSC</code> <code>/com/nokia/phone/SSC</code> <code>modem_state_changed_ind</code>. Argument is string.

===cui_dial_view===
Implements type <code>CuiDialView</code> which is a UI widget derived from <code>GtkAlignment</code>

===cui_dialog===
Implements type <code>CuiDialog</code> which is a UI widget derived from <code>GtkWindow</code>

===cui_dialpad===
Implements type <code>CuiDialpad</code> which is a UI widget derived from <code>GtkTable</code>

===cui_dtmf_dialog===
Implements type <code>CuiDtmfDialog</code> which is a UI widget derived from <code>CuiDialog</code>

===cui_duration_dialog===
Implements type <code>CuiDurationDialog</code> which is a UI widget derived from <code>CuiDialog</code>

===cui_errors_disconnect_reason_to_string===
<pre>
error string match
0 = voip_ib_undefined_error
1 = voip_fi_call_summary_identifier_no_answer
2 = voip_fi_call_summary_identifier_not_found
3 = call_fi_call_summary_identifier_incorrect_number
4 = voip_fi_call_summary_identifier_call_rejected
5 = voip_fi_call_summary_identifier_busy
6 = voip_fi_call_summary_identifier_not_authorized
7 = voip_ib_error_in_contact
8 = voip_ib_call_not_supported
9 = voip_ib_not_enough_memory
10 = voip_fi_call_summary_identifier_disconnected
11 = voip_fi_call_summary_identifier_disconnected
12 = call_ib_not_allowed
13 = call_ib_cost_limit_reached"
14 = call_ib_cellular_connection_error
15 = call_ib_fdn_active
16 = call_ib_number_not_in_use
17 = conn_ni_no_sim_card_in
18 = conn_ni_sim_not_accepted
19 = conn_ni_sim_lock
20 = call_ib_cellular_network_busy
21 = conn_ni_no_pin_for_sim
22 = call_ib_als_wrong_line
23 = conn_ni_no_cell_network
24 = call_ib_w_not_supported
25 = pres_ib_must_be_online
26 = addr_ib_contact_is_offline
27 = call_ib_request_rejected
28 = pres_ib_must_be_network_connected
29 = skype_fi_credit_is_low
30 = skype_fi_not_enough_credits
31 = skype_fi_call_old_voicemail_removed
32 = skype_fi_too_short_pstn_number
33 = voip_ni_unable_to_negotiate_codec
</pre>

===cui_errors_ssc_state_to_error===
Checks for ssc states "<code>online</code>", "<code>simless</code>", "<code>sim_mode_als2</code>", "<code>blocked_sim</code>", "<code>tablet_state</code>", "<code>sim_locked</code>"

===cui_errors_tp_reason_to_disconnect_reason===
Details TBA.

===cui_ic_dialog===
Implements type <code>CuiICDialog</code> which is a UI widget derived from <code>CuiDialog</code>.

===cui_icon_cache===
Used to store icons for reuse. Uses ,code>gtk_icon_theme_get_default</code> and <code>gtk_icon_theme_load_icon</code>.

===cui_idle_view===
Implements type <code>CuiIdleView</code> which is a UI widget derived from <code>GtkWidget</code>.

===cui_marshal===
Calls <code>g_value_xxx</code> functions to move data around

===cui_mce_proxy===
Implements type <code>CuiMceProxy</code> which is an interface to various MCE signals/calls

====prevent blanking====
dbus method call <code>MCE_PREVENT_BLANK_REQ</code> as documented in <code>mce-dev</code>

====activate display====
dbus method call <code>MCE_DISPLAY_ON_REQ</code> as documented in <code>mce-dev</code>

====accelerometer disable====
dbus method call <code>MCE_ACCELEROMETER_DISABLE_REQ</code> as documented in <code>mce-dev</code>

====device lock state====
dbus method call <code>MCE_DEVLOCK_MODE_GET</code> as documented in <code>mce-dev</code>

====accelerometer enable====
dbus method call <code>MCE_ACCELEROMETER_ENABLE_REQ</code> as documented in <code>mce-dev</code>

====get device orientation====
dbus method call <code>MCE_DEVICE_ORIENTATION_GET</code> as documented in <code>mce-dev</code>

====silent unlock====
dbus method call <code>MCE_TKLOCK_MODE_CHANGE_REQ</code> as documented in <code>mce-dev</code>

====device lock mode signal====
dbus signal <code>MCE_DEVLOCK_MODE_SIG</code> as documented in <code>mce-dev</code>

===cui_member===
Implements type <code>CuiMember</code> which is used for unknown use. Details TBA.

===cui_oc_dialog===
Implements type <code>CuiOCDialog</code> which is a UI widget derived from <code>CuiDialog</code>.

===cui_rotatable===
Implements type <code>CuiRotatable</code> which is a UI interface for things that rotate. Key file (setup via <code>g_key_file_new</code>) is stored in <code><home dir>/.osso/call-ui.ini</code>

===cui_settings===
Implements type <code>CuiSettings</code> used for storing call ui settings

====home gesture disabled====
set gconf path <code>/apps/osso/hildon-desktop/disable_phone_gesture</code>

====orientation setting====
stored in key file group_name rotation key orientation. Also file call-portrait-override is related to this.

====ssc enabled====
stored in key file <code><home-dir>/.osso/call-ui.ini</code> group_name [supplementary] key ssc=1|0. See starhash-enabler.

====keyboard slide open====
gconf location = <code>/system/osso/af/slide-open</code> gconf notify used to watch that location

===cui_ss_dialog===
UI code for supplementary services dialog

===cui_ss_proxy===
Implements type <code>CuiSSProxy</code> used for supplementary services proxy. Details TBA.

===cui_timer_label===
Implements type <code>CuiTimerLabel</code> which is a UI widget derived from GtkAlignment

===cui_tones_ringing_start===
calls <code>com.nokia.HildonSVNotificationDaemon</code> <code>/com/nokia/HildonSVNotificationDaemon</code> <code>com.nokia.HildonSVNotificationDaemon.PlayEvent</code> to play a ring-tone. Specs for this are in <code>hd-sv-notification-daemon.xml</code> in hildon-home source.

===cui_tones_ringing_stop===
calls <code>com.nokia.HildonSVNotificationDaemon</code> <code>/com/nokia/HildonSVNotificationDaemon</code> <code>com.nokia.HildonSVNotificationDaemon.StopEvent</code> to stop the playing ring-tone. Specs for this are in <code>hd-sv-notification-daemon.xml</code> in hildon-home source.

===cui_tones_tone_start===
calls <code>com.Nokia.Telephony.Tones</code> <code>/com/Nokia/Telephony/Tones</code> <code>com.Nokia.Telephony.Tones.StartEventTone</code> to play tones. Arguments are unsigned int event, int volume, unsigned int duration.

===cui_tones_tone_stop===
calls <code>com.Nokia.Telephony.Tones</code> <code>/com/Nokia/Telephony/Tones</code> <code>com.Nokia.Telephony.Tones.StopTone</code> to stop the playing tones. No arguments.

===cui_utils_account_get_vcard_field===
calls <code>mc_account_compat_get_profile</code> to get a profile from a <code>McAccount</code>. Calls <code>mc_profile_lookup</code> to get a <code>McProfile</code> from the profile. Calls <code>mc_profile_get_vcard_field</code> to get the vcard field from the <code>McProfile</code>.

===cui_utils_account_is_ring===
Compares the <code>manager_name</code> field of the <code>McAccount</code> structure with "<code>ring</code>"

===cui_utils_account_is_tel===
Compares the <code>protocol_name</code> field of the <code>McAccount</code> structure with "<code>tel</code>"

===cui_utils_avatar_button_new===
UI widget for an avatar button involving a <code>GtkButton</code>.

===cui_utils_button_new===
UI widget for a button.

===cui_utils_button_set_height_hint===
Sets height of a button UI widget.

===cui_utils_get_current_time===
calls <code>clock_gettime</code> to obtain the current time

===cui_utils_get_elapsed_time===
calls <code>clock_gettime</code> to obtain the time and does some math on it

===cui_utils_get_formatted_time===
calls <code>time_format</code> to get a formatted time

===cui_utils_get_formatted_time_lz===
calls <code>time_format</code> to get a formatted time

===cui_utils_get_icon_from_account===
calls <code>mc_account_compat_get_profile</code> to get a profile from a <code>McAccount</code>. Calls <code>mc_profile_lookup</code> to get a <code>McProfile</code> from the profile. Calls <code>mc_profile_get_icon_name</code> to get the icon name from the <code>McProfile</code>.

===cui_utils_get_timespec_diff===
Gets the difference between 2 times.

===cui_utils_key_event_to_dtmf_digit===
Takes a <code>GdkEventKey *</code>, converts it to DTMF tone via <code>gdk_keymap_get_default</code> then <code>gdk_keymap_lookup_key</code> then does something to convert it to a DTMF value

===cui_utils_normalize_number===
Does some stuff to a phone number (removing - and ( and ) and space and etc)

===cui_utils_parse_uri===
Parses a URI

===cui_utils_validate_number===
Validates a number

===cui_utils_vcard_find_attribute===
Finds a vcard attribute

===cui_utils_widget_modify_font_size===
Changes the font size of a widget. Uses the font Nokia Sans.

===cui_utils_window_request_orientation===
Uses <code>_HILDON_PORTRAIT_MODE_REQUEST</code> to request orientation of a window

===cui_utils_window_set_orientation===
Uses <code>_HILDON_PORTRAIT_MODE_REQUEST</code> to set orientation of a window

===cui_utils_window_set_supports_portrait===
Uses <code>_HILDON_PORTRAIT_MODE_SUPPORT</code> to set portrait support for a window

===cui_video_frame===
Implements type <code>CuiVideoFrame</code> which is a UI widget derived from <code>GtkFrame</code>.

===cui_video_window_get_type===
Implements type <code>CuiVideoWindow</code> which is a UI widget derived from <code>GtkSocket</code>.

===rtcom_tp_cli_channel_interface_conference===
Functions for conference calls. Details TBA.

===rtcom_tp_cli_channel_interface_dial_strings===
Functions for dial strings. Details TBA.

===rtcom_tp_cli_channel_interface_emergency===
Functions for emergency calls. Details TBA.

===rtcom_tp_cli_channel_interface_mute===
Functions related to mute. Details TBA.

===rtcom_tp_cli_channel_interface_privacy===
Functions related to privacy. Details TBA.

===rtcom_tp_cli_channel_interface_skype===
Functions related to skype. Details TBA.

===rtcom_tp_cli_channel_interface_tp_conference===
Functions related to conference channels. Details TBA.

===rtcom_tp_cli_channel_type_contact_search===
Functions related to contact search. Details TBA.

===rtcom_tp_cli_connection_interface_contact_info===
Functions related to contact info. Details TBA.

===rtcom_tp_cli_connection_interface_emergency===
Functions related to emergency. Details TBA.

===rtcom_tp_cli_connection_interface_forwarding===
Functions related to forwarding. Details TBA.

===rtcom_tp_cli_connection_interface_privacy===
Functions related to privacy. Details TBA.

===rtcom_tp_cli_connection_interface_skype===
Functions related to skype. Details TBA.

===rtcom_tp_cli_connection_interface_stored_messages===
Functions related to stored messages. Details TBA.

===rtcom_tp_cli_init===
Initialize call UI rtcom stuff

===rtcom_tp_cli_stream_engine===
Functions related to stream engine. Details TBA.

===rtcom_tp_cli_streamhandler_interface_video_control===
Functions related to video control. Details TBA.

===rtcom_tp_iface_quark===
Obtains quarks for various static strings


===rtcom_tp_stream_engine===
Creates object of type <code>RTComTpStreamEngine</code> and hooks up to dbus interface <code>org.maemo.Telepathy.StreamEngine</code>

===rtcom_tp_type===
Marshal functions for dbus stuff

[[Category:Development]]
[[Category:Fremantle]]