Z1 Designer Software Release Notes Manual Index
Full history of release notes for the Z1 Designer.
v 2021.3
September 13th, 2021
* The Dashboard Gallery. This is where you can download any currently available dashboards that have been made using the Z1 Designer. These dashboards will have been created by either Z1 Software or other users. To view the gallery select Gallery->View Gallery. You can filter the results by category, sim, or specific search terms. You can scroll up or down using the mouse wheel or the scroll bar on the right egde of the screen. You can collapse or expand a category by clicking on its line within the dashboard gallery. The gallery loads in 20 dashboards at a time. As you scroll down more will be loaded. The preview pictures will be loaded in the first time you open the gallery, and stored on your PC for faster future display. This gallery will grow over time as we, and other users, add more dashboards to it. Any dashboard downloaded from the gallery can be used in the Z1 Dashboard, and can be modified in the Z1 Designer.

* Uploading your dashboards. You can now upload your dashboards to our Dashboard Gallery. The Dashboard Gallery is how dashboards will be distributed moving forward. If you upload your dashboard to the gallery other users will be able to download and use it. To upload your dashboard, go to the Gallery-Upload My Dashboard menu option. This will display a dialog where you can enter your name (very important because we want to credit the dashboard to you!) You can also specify if it is intended for a specific sim, and the category that best described the dashboard. In addition you can enter keywords to help users find it more easily. Clicking the 'Upload' button will start the upload process. Note that when you upload the dashboard it will first be saved, and have a preview image auto-generated to make sure all files are up-to-date.

* A completely new color dialog has been incorporated. This will allow for easier selection of colors, conditional colors and gradients.

* Conditional Images are now supported. A conditional image can have between 2 and 20 images. Each image should have a unique file name. Any current data channel can be used to determine which image is displayed. For each image you specify the minimum and maximum values of the chosen data channel that will trigger that image to be displayed. Conditional images should be placed in the foreground.

* Conditional Colors are now supported. You can create a conditional color by using the Edit->New Conditional Color menu option. This displays the Conditional Color dialog. You assign your color a name, and a data channel that will determine when the color changes. You can have up to 20 color changes within your conditional color. Use the Colors drop down to specify the desired number of colors. To change any of the colors, just click on its swatch and use the color dialog. There are two text fields for each color. They specify the values between which that color will be displayed. Currently all units are in metric values.

* Conditional colors can be permanently or temporary. If you are only going to use the color on one dashboard then it would make sense to create it as a temporary color. It will be saved with the dashboard, but not with the Designer. However if you are going to use the conditional color on multiple dashboards it would make sense to create it as a permanent color. To do this make sure you click the 'Save for future use' check box in the Conditional Color dialog. The permanent/temporary state of any color can be changed at any time you like.

* Conditional colors are saved with their dashboard as needed. So if you open a dashboard that was created by someone else then any conditional colors that are used by that dashboard will be added to your list of conditional colors as temporary colors. This lets you edit the dashboard.

* The names of conditional colors do not have to be unique. This is because if you open a dashboard that someone else created, that dashboard could have a conditional color with the same name as one you have already created. We do, however, recommend using unique names in your own conditional colors for simplicity.

* You can see a list of all available colors, and edit those colors by going to Edit->Edit Conditional Colors. This will display a dialog with the current list of conditional colors. Double clicking on any of them will let you edit the color.

* A conditional color can be assigned to any element created within your dashboard. Simply click the color swatch of the object. This will display the color chooser. At the bottom left is a drop down of the current conditional colors. To assign the color, just choose its name from the list. The color swatch will display the first color in the range along with a 'C' when a conditional color is selected.

* To remove a conditional color from an element, click on the color swatch and in the color dialog choose any other color.

* You can create a new conditional color from within the Color chooser, by selecting '<Add New%gt;' from the conditional colors drop down. This will display the conditional color dialog. If you create a new color it will be added to the drop down in the color chooser and automatically selected.

* Another way to edit an assigned conditional color is to click on the color swatch to open the color chooser. Then within the color chooser if the 'New' color is a conditional color, double clicking on the 'new' color area will display the conditional color dialog allowing you to edit that conditional color.

* You can delete an existing conditional color by going to Edit->Edit Conditional Colors, right clicking on the desired color and choosing 'Delete'. Note if the conditional color is being used by the currently opened dashboard then you cannot delete it.

* You can create a copy of an existing conditional color by going to Edit->Edit Conditional Colors, right clicking on the desired color and choosing 'Copy'.

* Added new warning types: DRS Active, DRS Available, DRS Next Zone, Car Left, Cars Left, Car Right, Cars Right.

* Improvements to the text fields. You can now highlight parts of the text within them using the shift+left/right arrow keys and delete the highlighted text. Double clicking the text field selects all of the text. Left/Right arrow keys now repeat.

* If you place an object in a layer that could make it not display properly you will get a warning dialog asking if you'd like to move it to the correct layer. For example placing a data channel in the background layer would display this warning, as would placing an image in the foreground layer.

* You can now use the TAB key to move to the next text field or drop down.

* The Home/End keys can now be used to move the cursor in a text field.

* The arrow keys can now be used to navigate a drop down's items. The Enter key can now be used to seelct the currently highlighted item in a drop down.

* The copy (CTRL-C) option will now copy any currently selected text in a text field. This copited tex can then be pasted into another text field using the CTRL-V paste option. Note you can have both text and an object in the 'copied' memory. When you go to paste, if a text field is selected then the copied text (if any) will be pasted there, if no text fields are selected then the last copied object (if any) will be pasted on the Dashboard window.

* Select All (CTRL-A) has been implemented. This will select all the text in the currently active text field.

* Added a new widget: Fuel To Add At Stop.

v 2021.2
June 28th, 2021
* When you change the type of a Data Channel, Warning, LED, Widget, Units, or Graph, the Display Name for that object will be updated to reflect the newly type of the object. Note that this will only happen if the Display Name is the default name for that object. If you have manually changed the Display Name, then it will not be changed.

* If an object is selected when the auto-generated preview is requested, the selection bounds of that object are no longer included in the preview image.

* You can now specify the width and height of your dashboard. The default is 480 x 272. This fits most standard USB screens. However if you wanted the larger NASCAR size dashboards of 1280 x 400, then you would just enter those values in to the Dashboard Properties 'width' and 'height' text fields. Any dashboard width and height can be used.

* There is now a 'Track Map' tool. This lets you place a track map object on your dashboard.

* There is now a 'Friction Circle' tool. This lets you place a friction circle on your dashboard.

* There is now an 'Image' tool. This lets you place images on your dashboard. It is recommended that you place images in the background layer. The resolution of the image should be such that it looks good at larger scales. The image must be a PNG image.

* There is now a 'Standings' tool. This lets you place a standings object on your dashboard. The standings object can be customized with the desired number of columns. You can specify what data is displayed in each column, the name of each column and the alignment of the data with each column.

* When creating or resizing objects, holding the shift key down will constrain the object to a square. For ellipses, holding the shift key down while moving the bottom right resize handle will constrain it to a circle. Holding the shift key down while creating a line or multi-line has no effect, as you can accomplish the same by using the Snap To Grid option.

* There is a new 'Toggle Pointer' option under the Edit menu. Selecting this option toggles the currently selected tool with the pointer. After you create an object you can quickly toggle to the pointer to reposition or resize the object, and then toggle back to the tool and create another object. The Space key is the keyboard shortcut for this option.

* In the Text Align drop down in the Object Properties Window the 'Leading' option has been renamed 'Left', and the 'Trailing' option has been renamed 'Right'. This makes it easier to understand the meaning of these options.

* In the Paragraph Align drop down in the Object Properties Window the 'Near' option has been renamed 'Top', and the 'Far' option has been renamed 'Bottom'. This makes it easier to understand the meaning of these options.

* LED objects now have the option to be displayed as either circles or rectangles. This gives you more options for how you want your shift lights and warnings lights to appear on your dashboard.

* Cut, Copy and Paste functions have been implemented. These are available under the Edit menu, or by using the standard Windows keyboard shortcuts (CTRL-C,X,V). Pasting an object will paste the last cut/copied object into the currently selected layer (either Foreground or Background).

* The New Dashboard dialog has been redesigned for better aesthetics, as well as functionality.

* Added two new Widget options: iRating SOF, and iRating Class SOF. iRating SOF shows the average iRating for all entries. iRating Class SOF shows the average iRating broken out by class. These are for iRacing only.

* Added new Widget option: Predictive Lap Time.

* The color chooser now remembers the 16 custom colors for the duration of the Designer being open. You can add a color to the custom color area by clicking on the 'Add to Custom Colors' button. The custom color will be placed into the currently selected custom color slot. Each time you add a new color, the next slot is automatically selected.

* The text fields have been improved. You can now click within the text displayed in the field and edit from that point. You can also use the left/right arrow keys to move around the data within the text field.

v 2021.1.1
April 7th, 2021
* Fixed a bug where a layer would be deleted if you dragged it to the bottom of the list.

* Fixed a bug where layers would sometimes not get transferred between the foreground and background.

* Fixed a bug where the fill color for the multi-line tool did not save.

* Added 'Position' as an option in the Widget tool.

* Added 'Blue Flag', "Full Course Yellow', and 'Local Yellow Flag', as options within the Warning tool.

v 2021.1
March 29th, 2021
* First Release

-- THE BASICS The Z1 Designer lets you create your own dashboards for use with the Z1 Dashboard. A dashboard created in the Z1 Designer requires the same version or higher of the Z1 Dashboard to run. So dashboards created in version 2021.1 of the Z1 Designer will need version 2021.1 or higher of the Z1 Dashboard to run.

Each dashboard currently consists of two files - an XML definition file and a PNG preview image file. Both of these files are placed inside a single folder. This folder should have the same name as the Dashboard. So if you name your dashboard 'My Dashboard', then the folder containing that dashboard's files will be called 'My Dashboard'. The Z1 Designer will create these files and folder automatically when you create a new dashboard.

For a custom dashboard to be available to the Z1 Dashboard its folder should be placed inside the 'Dashboards' folder located inside documents/Z1Dashboard. So with our above example called 'My Dashboard' the folder structure would be 'documents/z1dashboard/dashboards/my dashboard'. The Z1 Designer will place any newly created Dashboards in this location by default.

All custom dashboards available to the Z1 Dashboard will be displayed at the bottom of the Car 2 tab's dashboard drop down.


-- CREATING NEW DASHBOARDS / OPENING DASHBOARDS
After starting the Z1 Designer you need to either Create a new dashboard (File->New Dashboard), or open an previously created dashboard (File->Open Dashboard). There is a sample dashboard provided with version 2021.1 of the Z1 Dashboard. To open this sample dashboard (or any other dashboard) you need to select the 'Dashboard' XML file within its containing folder. To open the sample dashboard select the Dashboard XML file located in 'documents/ z1dashboard/dashboards/Sample Dashboard'.


-- DASHBOARD LAYOUT
All dashboards are separated into two main layers: Background and Foreground. The Background layer is drawn once when the dashboard is created. The Foreground layer is drawn every time the Z1 Dashboard redraws. You should place objects in the appropriate layer when creating your dashboards. Objects that do not change should be placed in the background. Objects that could change (such as data channels, shift lights, warnings, etc) should be placed in the foreground.


-- Z1 DESIGNER WINDOWS
There are 7 windows within the Z1 Designer that you will use to create your dashboard. They are explained below.

You can move any window by dragging its title bar. You can resize any window by dragging its lower right corner. All windows have a minimum size, which they can't be resized below. The Dashboard Properties, Dashboard Defaults and Dashboard Shift Lights windows can be closed by clicking on the X in the top right corner. The other windows cannot be closed. You can display any window by choosing it from the 'Windows' main menu.


-- DASHBOARD WINDOW
This is where your dashboard design is displayed. The dashboard is displayed here exactly as it will appear within the Z1 Dashboard. Resizing this window has the same effect as resizing the Z1 Dashboard. This allows you to see what your Dashboard will look like at different resolutions.


-- TOOL BAR WINDOW
This window displays all available tools. The pointer tool lets you select an object, move it, or resize it. To select an object simply click on it with the pointer. If multiple objects are located in the same place then the one which is 'on top' will be selected. Once an object is selected you can move it by clicking on it and dragging it to the desired location. You can resize a selected object by clicking and dragging on of the displayed resize handles. (To select objects that are underneath other objects, select that object's name in the Layers window.)

The other tools let you add various objects to your dashboard. If you hover the mouse over a tool its function will be displayed. The currently available objects to be added are: Rectangle, Rounded rectangle, Ellipse, Line, Multi-Line, Text, Data channel, Warning, Shift Light, Units, Graph, and Widget. Any newly created object will be placed in the currently active layer. (See the Layer Window section for more information.)

To add any object, select the tool, then click on the Dashboard where you want the object to appear and drag to the right and down to expand the size of the object. It does not matter if you get the size and placement exactly correct as you can move and resize the object at any time. The multi-line tool will add a new line segment every time you use the left mouse button. To end the multi-line object double click the mouse.

'Data Channel' - this displays a specific car data channel, such as gear, RPM, oil temp, etc. Note that data channels associated with user selectable units, like temperatures, will be displayed in the units specified by the user of the Z1 Dashboard when run in the Z1 Dashboard.

'Units' let you display certain units, such as temperature, in the units selected by the user of the Z1 Dashboard. So if you place a units object that is defined to show temperature, it will show 'C' if the user displays temperature in metric units, and 'F' if the user displays them in imperial units.

'Text' - This lets you define a rectangle within which you can display text. Once you create the text rectangle, use the Object Properties window to specify the text to be displayed.

'LED' - This lets you place an LED. There can be up to 15 shift light LEDs and 6 warning LEDs. Each LED can have its own On and Off colors. There is a checkbox within the Shift Lights Properties window that lets you turn the LED on or off to see what it looks like on both configurations. Note this setting has no effect on the Z1 Dashboard, it is only for designing purposes within the Z1 Designer.

'Graph' - This lets you display a data channel as a graph. This is useful for displaying rev counter bars, or brake bias bars, etc. You specify the direction the bar should move in (left to right, right to left, etc). You also specify the data channel associated with it and the minimum and maximum values for that channel.

A 'Warning' object lets you group objects together that are only displayed if the warning criteria is met. For example the pit limiter, or a high oil temperature. A warning object can contain any other type of object except another warning object.

'Widget' - This lets you display various items, or widgets, on your dashboard. Example of these are the lap time, delta time, lap counter, etc.

We suggest playing around with these various tools to see what they do.


-- LAYERS WINDOW
This displays all the objects contained on the background and foreground layers. You can use the scroll bar to move up or down the list if necessary. As mentioned before objects that never change can be placed in the background layer. Objects that could change should be placed in the foreground layer. To set the background as the active layer, click 'Background' in the layers window. To set the foreground as the active layer, click 'Foreground' in the layers window. The currently active layer will be highlighted and have the word 'active' displayed in its header. All new objects are placed on to the currently active layer (either background or foreground).

If you click on the name of an object in the layers window that object will become selected. This allows you to interact with, move and resize objects that are underneath other objects.

The checkboxes on the right side of the layers window allow you to toggle the display of an object on or off. This is intended to make designing your dashboard easier. You may have objects, such as warnings, that you do not need to see all the time when designing your dashboard. Or you may just want to temporarily hide some objects to make it easier to work with other objects. Note the hidden/visible status of an object has no effect on how it is displayed within the Z1 Dashboard.


-- OBJECT PROPERTIES WINDOW
This window displays the properties for the currently selected object in the Dashboard window. The display will change based on what type of object is selected. You can make changes to the currently selected object here as desired.


-- DASHBOARD PROPERTIES WINDOW
This window displays high level dashboard properties. You can change the dashboard's name, background color and preview image here. The preview image is what gets displayed in the Z1 Dashboard in the Car 2 tab when the user is selecting a dashboard.


-- DASHBOARD SHIFT LIGHTS WINDOW
This window displays the options for setting when the shift lights illuminate within your dashboard. If your dashboard does not contain shift lights then you can ignore this window. You can either enter specific RPMs for each shift light illumination, or select an option for them to be automatically turned on at certain RPM values. The drop down on the top right lets you choose this. (Note a user of your dashboard can always override these options. What you are entering here is just the default options for your dashboard's shift lights.)

All gears can use the same RPM shift values, or you can specify unique shift values for each gear. There is a checkbox at the top left that lets you toggle this feature on/off.

Manual Index
(c) zBlueSoftware 2021 | Partners | Forums | Contact Us | Warranty/Terms Of Use | Privacy Policy