Editing CSSU Features Configuration Editor

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 3: Line 3:
It has been built using the PyQt libraries and the Python language.  
It has been built using the PyQt libraries and the Python language.  
-
It provides the ability to change a number of parameters in the transitions.ini configuration file as well as the relevant GConf entries' values. The options are described in the [[Community SSU/Features]] wiki page.
+
It provides the ability to change a number of parameters in the transitions.ini configuration file. The options are shown in the [[Community SSU/Features]] wiki page.
Additional information on the usage, settings and implications could be found below.
Additional information on the usage, settings and implications could be found below.
Line 24: Line 24:
==Usage info==
==Usage info==
-
===Start-Up===
+
===General===
-
On the application start-up the <code>transition.ini</code> file and the relevant GConf key entries are read.
+
FIXME
 +
====Start-Up====
 +
 +
On the start-up of the application, the <code>transition.ini</code> file and the relevant GConf key entries are read.
Their values are shown in the corresponding UI elements.
Their values are shown in the corresponding UI elements.
    
    
[[Image:CSSUfeaturesConfiguration_main1.png|500px]]
[[Image:CSSUfeaturesConfiguration_main1.png|500px]]
-
Depending on the orientation of the device one gets a different view.
+
====Errors====
-
The application uses the accelerometer to provide landscape or portrait modes. 
+
FIXME
-
 
+
-
Both modes are fully usable without the need of a keyboard.
+
-
 
+
-
[[Image:CSSUfeaturesConfiguration_main1p.png|250px]]
+
-
[[Image:CSSUfeaturesConfiguration_main2p.png|250px]]
+
-
 
+
-
===Errors===
+
When the application starts it checks first if the [[Community SSU]] is installed.
When the application starts it checks first if the [[Community SSU]] is installed.
-
In the case it does not finds it an error message is displayed.
+
In the case it does not finds it an error message is displayed and the application exits.  
-
 
+
-
'''Note''': In the latest versions the application does not exit but continues allowing custom/partial installations of the CSSU to have the ability to edit their options using this application.    
+
[[Image:CSSUfeaturesConfiguration_error1.png|350px]]
[[Image:CSSUfeaturesConfiguration_error1.png|350px]]
-
Subsequently, a check is made if the options in the <code>transition.ini</code> file are available for editing.  
+
Subsequently, a check is made if the options in the <code>transition.ini</code> file are available for editing. In the case of their unavailability an error banner is displayed for user information and the application exits.
-
 
+
-
In the case of their unavailability, a new window opens which provides information and two ways to resolve this.
+
-
 
+
-
[[Image:CSSUfeaturesConfiguration_fixWindow.png|500px]]
+
-
 
+
-
The options are to either try to fix by adding the missing variables in the configuration file or restore the complete file by replacing it with a default.
+
-
 
+
-
The messages given in either case are similar to those:
+
-
 
+
-
[[Image:CSSUfeaturesConfiguration_fixWindow_optionFix.png|350px]]
+
-
[[Image:CSSUfeaturesConfiguration_fixWindow_optionDefault.png|350px]]
+
-
 
+
-
''NOTE:'' After the completion of either operation the application exits.
+
-
+
-
In the case the file is corrupted and cannot still be read an error banner is displayed for user information. In this case, the application exits.
+
[[Image:CSSUfeaturesConfiguration_error1.jpg|350px]]
[[Image:CSSUfeaturesConfiguration_error1.jpg|350px]]
===Changing Options===
===Changing Options===
-
 
The operation of the application is simple:  
The operation of the application is simple:  
-
* Choose the options you would like to have (for info on the options look in the [[Community SSU/Features]] page).
+
* Choose the options you would like to have (for info on the options look in the [[Community SSU/Features]] page).
-
* Press the "Update" button to register in the system your choice.
+
* Press the "Update" button.
-
 
+
[[Image:CSSUfeaturesConfiguration_main1.png|350px]]
-
[[Image:CSSUfeaturesConfiguration_edit1.jpg|250px]]
+
[[Image:CSSUfeaturesConfiguration_main2.png|350px]]
-
[[Image:CSSUfeaturesConfiguration_edit2.jpg|250px]]
+
'''''Note''''': Options like the "tactile feedback" will be disabled if the relevant package is not installed.
-
 
+
-
'''''Note''''': Options like the "tactile feedback" will be '''disabled''' if the relevant package is not installed.
+
===Other Options===
-
 
+
-
===Button functions===
+
-
* The "Current" button sets the current options the system is using in the options (which are shown also in the startup of the application)
+
* The "Current" button sets the current options the system is using in the options (which are shown also in the startup of the application)
-
* The "Default" button sets the values in UI equal to those shipped with the Community SSU.
+
* The "Default" button sets the values in UI equal to those shipped with the Community SSU.
-
* The "Update" button registers the choices seen in the UI to the system.  
+
[[Image:CSSUfeaturesConfiguration_current.png|350px]]
[[Image:CSSUfeaturesConfiguration_current.png|350px]]
[[Image:CSSUfeaturesConfiguration_default.png|350px]]
[[Image:CSSUfeaturesConfiguration_default.png|350px]]
-
'''''Note''''': Neither of those buttons propagate any changes to the system. They will only set the UI elements. The options visible in the UI will be applied only after pressing the "Update" button.
+
'''''Note''''': Neither of those buttons propagate any changes to the system. They will only set the UI elements. The options visible in the UI will be applied only after pressing the "Update" button.  
-
===Restoring the original transitions.ini file===
+
===Restoring to Default Options===
-
 
+
-
'''''Note''''': This will restore to the shipped version of the transitions.ini and will not have any effect on the similar file in <code>/etc/hildon/theme/</code> that might be used by theming.
+
If for some reason the transitions.ini file becomes messed up it is possible to restore the default:
If for some reason the transitions.ini file becomes messed up it is possible to restore the default:
Line 102: Line 75:
[[Image:CSSUfeaturesConfiguration_restore.png|350px]]
[[Image:CSSUfeaturesConfiguration_restore.png|350px]]
-
 
+
'''''Note''''': This will restore to the shipped version of the transitions.ini and will not have any effect on the similar file in <code>/etc/hildon/theme/</code> that might be used by theming.
-
If the application exits immediately when started the same operation can be done from the command line:
+
-
 
+
-
* Open the xterm (shortcut: shift [arrow up] + ctrl + x)
+
-
* type the following:
+
-
 
+
-
<code>sudo /opt/CSSUfeatures/updateTransitions copyDefault</code>
+
===Applying changes to the system===
===Applying changes to the system===
Line 135: Line 102:
In the About window, apart from the application version and description, one can find a button pointing to this page.
In the About window, apart from the application version and description, one can find a button pointing to this page.
-
[[Image:CSSUfeaturesConfiguration_about1.png|350px]]
+
[[Image:CSSUfeaturesConfiguration_about.png|350px]]
-
[[Image:CSSUfeaturesConfiguration_about2.png|350px]]
+
==Issues & ToDo==
==Issues & ToDo==
Line 153: Line 119:
==Versions==
==Versions==
-
===2.5-6 '''[http://maemo.org/downloads/product/Maemo5/cssufeatures/ Stable]'''===
+
===2.3-2 '''Testing Version'''===
-
Availability: [[Extras]]
+
Availability: [[Extras-testing]]
-
 
+
If you find it fulfils the QA criteria vote [http://maemo.org/packages/package_instance/view/fremantle_extras-testing_free_armel/cssufeatures/2.3-2/ here]
-
<!--'''[http://maemo.org/packages/source/view/fremantle_extras-devel_free_source/cssufeatures/2.5-6/ Next]'''===
+
-
Availability: [[Extras-devel]], [[Extras-testing]]
+
-
-->
+
-
Changes:
+
-
  * Added new option to the missing variables window for restoring the transitions.ini file.
+
-
 
+
-
===2.5-5===
+
-
 
+
-
Changes:
+
-
  * Added option to add missing variables in the transitions.ini file.
+
-
  * Fix write of settings issue when no space between variable and value.
+
-
  * Added better support for the transitions.ini at theme folders.
+
-
  * Added new and improved WARNING and ERROR messages.
+
-
  * Added new icon.
+
-
 
+
-
===2.4-1===
+
-
 
+
-
Changes:
+
-
  Added support for CSSU version 20.2010.36-maemo16.
+
-
    * added new blurless_saturation variable
+
-
    * added new scroll_vertical gconf entry
+
-
 
+
-
===2.3-3===
+
-
 
+
-
Changes:
+
-
  * Modified the .desktop to have a shorter name in the app menu
+
-
  * Modified the UI to expand on all the available screen estate.
+
-
 
+
-
===2.3-2===
+
Changes:  
Changes:  
Line 204: Line 141:
   * Removed exit condition if CSSU is not installed.
   * Removed exit condition if CSSU is not installed.
-
===2.0-1===
+
===2.0-1 '''Stable Version'''===
 +
Availability: [[Extras]]
Changes:  
Changes:  

Learn more about Contributing to the wiki.


Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!


Cancel | Editing help (opens in new window)