View source for Features/Variable-Appearance-of-Buddy-Icon

<noinclude>
[[Category:Feature Page Incomplete]]
[[Category:Feature|.]]
</noinclude>

<!-- All fields on this form are required to be accepted.
 We also request that you maintain the same order of sections so that all of the feature pages are uniform.  -->

<!-- The actual name of your feature page should look something like: Features/Your Feature Name.  This keeps all features in the same namespace -->

== Summary ==
This feature is a modification to the existing XO icon on the Sugar desktop. The XO icon will now change based on the number of journal entries, battery status, and disk usage. 

== Owner ==
* Name: [[User:HrishiP| Hrishi Patel]]
* Email: Hrishi Patel <hrishipatel99@gmail.com>

== Current status ==
* Targeted release: 0.115-0.116
* Last updated: 30th August 2019
* Percentage of completion: 70%

== Detailed Description ==
* The XO icon on the Sugar desktop changes according to:
** Number of Journal entries. If number of journal entries are less than 10, the embryo will be the style. If the number of journal entries is between 10 and 50, Teen style is selected. For more than 50 journal entries, the Adult style will be selected. 
** Battery status. Badges are shown if a battery is detected. The badge uses the existing battery icon in the Sugar artwork. 
** Disk usage. Currently, the icons will only change for when disk status is below 50%, greater than 50% or greater than 90%. The stroke size of the icons will change accordingly.
* Provides a setting (GSettings) to enable or disable the feature.
In future, the widget will be based on Cairo and will not be using icons for the styles. 

== Benefit to Sugar ==
This feature provides a visual update to the existing XO icon on the Sugar desktop. The user will know more about their Journal, their disk and battery status from the Desktop. The idea was to make the XO icon adapt according to the properties state above for better user experience. 

== Scope ==

''What work do the developers have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

* Review my pull request and commits for the changes I make.
* documentation changes.
* testing the feature as I make changes.

The feature is implemented in buddyicon.py (jarabe/view/buddyicon.py).
The code at extension/deviceicon/battery was also modified.
A gsetting was added to make enabling the feature optional.

==UI Design==

No direct impact on the workflow. The artwork was changed (https://github.com/Hrishi1999/sugar-artwork/tree/tamagotchi-widget).
In future, Cairo will be used to draw the icon instead of using too many icons.

== How To Test ==
Use this branch to test changes: https://github.com/Hrishi1999/sugar/tree/tamagotchi-widget-feature
To test battery badges, the device must be battery-equipped. You will notice a changes to XO icon on Desktop.

== User Experience ==
You will notice that the XO icon on Sugar desktop will change according to the properties state above (journal entries, disk usage, and battery)

== Dependencies ==

No dependencies.

== Contingency Plan ==

None necessary, revert to previous release behavior.

== Documentation ==

See PR #852 at https://github.com/sugarlabs/sugar/pull/852

== Release Notes ==

Variable Appearance of Buddy Icon

This feature is a modification to the existing XO icon on the Sugar desktop. The XO icon will now change based on the number of journal entries, battery status, and disk usage. 

== Comments and Discussion ==
* Link to the discussion on lists.sugarlabs.org: http://lists.sugarlabs.org/archive/sugar-devel/2019-July/057072.html, 
http://lists.sugarlabs.org/archive/sugar-devel/2019-July/057100.html, 
http://lists.sugarlabs.org/archive/sugar-devel/2019-June/057003.html, 
http://lists.sugarlabs.org/archive/sugar-devel/2019-May/056832.html

* See [[{{TALKPAGENAME}}|the discussion tab for this feature.]] <!-- This adds a link to the "discussion" tab associated with your page.  This provides the ability to have ongoing comments or conversation without bogging down the main feature page. -->