CommandFusion Wiki

Documentation Resources

User Tools

Site Tools


software:gui-designer:theme-library

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

software:gui-designer:theme-library [2012/08/21 05:48]
aaron created
software:gui-designer:theme-library [2013/11/08 02:58] (current)
aaron [Theme Library]
Line 1: Line 1:
-The Theme Library allows you to use pre-defined themes within your projects. These themes can be created and shared by anyone.\\+====== Theme Library ====== 
 + 
 +The Theme Library allows you to use pre-defined themes within your projects. These themes can be [[software:​gui-designer:​theme-library:​creating-a-theme|created]] and shared by anyone.\\
 Note: Currently sharing is a manual process. We are working on ways to allow full sharing directly within guiDesigner. But for now, you need to share the theme GUI file and all images manually. Note: Currently sharing is a manual process. We are working on ways to allow full sharing directly within guiDesigner. But for now, you need to share the theme GUI file and all images manually.
  
 +{{:​software:​gui-designer:​theme_libraru.png?​nolink|}}
 ===== Accessing the Theme Library ===== ===== Accessing the Theme Library =====
 There are two ways to access the Theme Library within guiDesigner:​ There are two ways to access the Theme Library within guiDesigner:​
Line 7: Line 10:
   - Select Themes > Theme Library from the main menu   - Select Themes > Theme Library from the main menu
  
-===== Creating ​Theme Library ​Files ===== +===== Built in Theme Library ===== 
-You can create your own library files for use in future projects, or to share with othersBasically, a theme library file is just a specially formatted ​[[software:​gui-designer:​gui-file|GUI File]]. +guiDesigner comes with some built-in themes. [[software:​gui-designer:​theme-library:built-in-themes|To learn more about the inbuilt ​themes ​click here.]]
- +
-==== Theme Details ==== +
- +
-The theme library ​name and author details are grabbed from the GUI File [[software:gui-designer:​project-properties|Project Properties]]. The project name is used as the theme name, whilst the author is used as the theme'​s author also. +
- +
-==== Theme Previews ==== +
-Any themes ​defined in the project will be visible in the Theme Library file, using the theme details to render the preview. You can also create a custom preview for a particular theme by creating a subpage and naming it '​theme_<​themename>',​ where <​themename>​ is the actual name of the theme definition you are creating the preview for. This allows you to show how a button theme looks with specific text, an overlay image, or amongst other objects such as a background image, etc. Anything you place on this subpage will be shown on the theme preview window within the Theme Library. If this subpage doesn'​t exist, the Theme Library will draw the theme on the appropriate object based on the theme details alone.+
  
-==== Groups ==== +===== Theme Groups ​===== 
-You can also create '​groups'​ within the theme library file. Groups ​allow you to create ​a collection of GUI Objects which can be dragged and dropped in a single interaction onto a page/​subpage. A good example of this is an Arrow Pad (containing left, right, up and down arrows, as well as an enter button) and a numpad (numbers 0 to 9, an asterix and hash). To create a group in your theme library file, simply create ​a subpage ​called '​group_<​groupname>',​ where <​groupname>​ is the name you want to give your groupFor example, '​group_arrowpad'​. This will then show up as a group option ​within ​Theme Library, allowing users to simply drag the group onto a page in their project and have all the objects automatically added.+Groups ​are a collection of GUI Objects which can be dragged and dropped in two ways: 
 +  - Dragged into the project tree - this will create a copy of the group as new subpage ​in the open project. 
 +  - Dragged onto an open page/​subpage - this will create copies of all the GUI objects ​within the group (buttons, etc) directly ​onto the page (rather than creating ​subpage).
  
 +===== Creating Theme Library Entries =====
 +See our wiki entry on how to [[software:​gui-designer:​theme-library:​creating-a-theme|create your own Theme Library entries]].
software/gui-designer/theme-library.1345528089.txt.gz · Last modified: 2012/08/21 05:48 by aaron