Difference between revisions of "Icon Font"

Latest revision as of 11:22, 21 August 2024

UBIK-Standard.ttf is a custom set of font icons developed primarily for use on the Xamarin Client, due to concerns over the legality of using Microsoft's Segoe MDL2 Assets icon font file on non-Windows platforms (ie. Android and iOS). Apart from this legal concern, having a standardized font icon set will contribute to having a more consistent look across the various platforms and clients as UBIK-Standard.ttf becomes more widely adopted.

The latest font set can be downloaded directly from here using the UBIK-Standard.zip file.

UBIK-Standard is an Icon Font. For Xamarin, the standard Text Font is Inter, which is included in the resources and thus available to use immediately.

UBIK-Standard is currently only supported for the Xamarin client.

Usage

UBIK-Standard.ttf is currently only supported for the Xamarin client.

Xamarin Client

The first full version of the icon set was completed in September 2019. The tables on this page show the icons, along with a description of their intended purpose (some have multiple), and the natural language In-App Name, and Hex code suffix, both of which can be used to call the icons using XAML.

Using XAML, Glyphs can be called in two ways. One method is to use the Hex Code, and another is the In-App Name. Of these two methods, the recommended method is to use the In-App Name, as it uses a natural language attribute as opposed to a glyph code, making it more immediately apparent which icon is being requested by the code.

The two below examples show how one might use both methods to create a User symbol.

In-App Name Usage

In the below example, Glyph="{x:Static resources:UBIKIcons.User}" is used to call the User symbol.

Hex Code Usage

In the below example, the attribute Glyph= and the following Hex Code is used to call the User icon. These Hex codes can be found using a Character Map program, or by searching through the icon tables below.

Directly Accessing Icons

The icons can also be used like every other font by setting the FontFamily attribute. For example:

Available Icons

There are two options available to a customizer wishing to browse available icons.

If a required icon is not found in UBIK, it is instead possible to render custom icons using Path data.

The best way is to download and unzip the UBIK-Standard.zip file. Once unzipped, open the "demo" webpage file to view all icons, as well as the human readable labels you can use to render them in your UI. Because the demo webpage does not provide a good overview of all the icons, it is possible to combine this approach with the second one described below using that to browse the icons, and then this method to retrieve the human readable labels for the icons you wish to use.

The second way requires installation of the Character Map tool from Microsoft. This can be used to browse the characters of all the fonts installed on your machine, so to use this method you should certainly download and install the latest version of UBIK-Standard.ttf above. The downside of using this method is that you don't have access to the human readable labels using this app.

Note that icons installed on your machine are not necessarily available to customers, as they only have access to the icons delivered through UBIK, which is version-dependent.

Known Issues

Xamarin Client

The development of the custom icon font on the Xamarin client was hampered significantly by unexpected icon substitutions, which appeared to be vendor/device-specific. To avoid this issue, the individual icons in the text file were mapped to the Hex codes used by the most basic alphabet and symbol characters.

A second issue was encountered where using unstable behavior was observed when using UBIK-Standard.ttf for icons when the user switched tabs, leaving UBIK running in the background. In these cases, circular icon containers became square when switching back to the app, and the icon glyphs were no longer visible. However, using the GlyphButton and GlyphLabel elements (as opposed to simply Button and Label) seems to prevent this issue.

Creation

The process for creating icons is documented here.

Step 01: Asset Creation

The first step is to find similar, open-source icons to tweak. Pixeden, LineIcons, or LineA, are good starting points, as they have a similar style.

When tweaking (for example, in Adobe Illustrator), use a stroke width of 3 for the base line thickness.

It is good practice to produce three sets of .SVGs; a stroke version, an expanded version, and a final version. The stroke version is more easily edited, but the lines must be 'expanded' in Illustrator to be imported as icons. Finally, duplicate the expanded version, and name it using the following syntax: 001#ubik-U0x26

The first number is used to keep the icon list orderly.
Add as many tags as desired using the # as separators. For example, a check mark icon may be listed as #ok#confirm#check. The - ends the tag portion of the syntax.
The glyph code assigns the icon to a certain space on the character map. As different device vendors block different glyph code sets for different uses, it is good practice to overwrite the basic alphabet, numbers, and symbols, to ensure the icons work on a large range of devices. Starting from 21, glyph codes may use numbers, or letters from 2A (2 here being an example) to 2F.

Step 02: TTF Generation

IcoMoon is a useful online tool for generating the icon font, that can then be installed on a device or packaged into the client resources.

Import Icons (top left) - Use this button to import an already existing font file, when creating additions, for example.
On the Selection tab (bottom center), ensure that the desired set is fully selected, and shown with an orange outline.
On the Generate Font tab (bottom right), double check the generated tags for the icons. The settings button beside the download button allows you to edit the font file name and version.
The download button exports the .ttf, among other resources, in a .ZIP, that is then downloaded.

@@ Line 13: / Line 13: @@
 The first full version of the icon set was completed in September 2019. The tables on this page show the icons, along with a description of their intended purpose (some have multiple), and the natural language In-App Name, and Hex code suffix, both of which can be used to call the icons using XAML.
-Using XAML, Glyphs can be called in two ways. One method is to use the Hex Code, and another is the In-App Name. The two below examples show how one might use both methods to create a User symbol.
+Using XAML, Glyphs can be called in two ways. One method is to use the Hex Code, and another is the In-App Name. Of these two methods, the recommended method is to use the In-App Name, as it uses a natural language attribute as opposed to a glyph code, making it more immediately apparent which icon is being requested by the code.
-<br>
+The two below examples show how one might use both methods to create a User symbol.
-Hex Code Usage:
-In the below example, the attribute <i>Glyph="</i> and the following Hex Code is used to call the User icon. These Hex codes can be found using a Character Map program, or by searching through the icon tables below.
+<br>
+====In-App Name Usage====
+In the below example, <code>Glyph="{x:Static resources:UBIKIcons.User}"</code> is used to call the <I>User</I> symbol.
 <syntaxhighlight lang="xml">
-<FontIcon FontFamily="UBIK-Standard" Glyph="&#x22;" Foreground="{DynamicResource UBIKLightThemeColor}" />
+<ContentView
+    xmlns:controls="clr-namespace:UBIK.CPL.Controls;assembly=UBIK.CPL" >
+<controls:GlyphLabel
+    Glyph="{x:Static resources:UBIKIcons.User}"
+                            HorizontalOptions="Center"
+                            PrimaryColor="{DynamicResource UBIKLightTextColor}"
+                            Style="{DynamicResource HeaderSymbolStyle}"
+                            VerticalOptions="Center" />
 </syntaxhighlight>
 <br>
-In-AppName Usage:
+====Hex Code Usage====
-In the below example, "UBIKIcons.Service" is used to call the symbol for Service or Group.
+In the below example, the attribute <code>Glyph=</code> and the following Hex Code is used to call the <I>User</I> icon. These Hex codes can be found using a Character Map program, or by searching through the icon tables below.
 <syntaxhighlight lang="xml">
-<ctrls:GlyphLabel
+<ContentView
-     Glyph="{x:Static resources:UBIKIcons.User}"
+     xmlns:controls="clr-namespace:UBIK.CPL.Controls;assembly=UBIK.CPL" >
-    PrimaryColor="{DynamicResource UBIKLightThemeColor}"
-    SecondaryColor="{DynamicResource UBIKDarkThemeColor}"
+<controls:GlyphLabel Glyph="&#x22;" HorizontalOptions="Center"  />
-    Style="{DynamicResource UBIKSymbolLabel}"
-    VerticalOptions="Center" />
 </syntaxhighlight>
-==Icon Tables==
+====Directly Accessing Icons====
-{{Attention|WikiFormatting prevents the entire Hex Code from being displayed in the tables, so a space was used to break the glyph code. Please remove the space when using the Hex Codes from the table.}}
+The icons can also be used like every other font by setting the <code>FontFamily</code> attribute. For example:
-===Basic Icons===
+<syntaxhighlight lang="xml">
-{| class="wikitable" | style="width:100%"
+<ContentView
-|-
+    xmlns:resources="clr-namespace:UBIK.CPL.Resources;assembly=UBIK.CPL">
-! Icon !! Casual Name / Description !! In-App Name !! Hex Code
-|-
+    <Label HorizontalOptions="Center"
-|[[File:UBIKstandard_home-ubik.png|64 px|center]] || ''Ubik'' - Scalable UBIK logo for use on the splash screen. || Ubik || <code>&#x 26; </code>
+        HorizontalTextAlignment="Center"
-|-
+        Text="{x:Static resources:UBIKIcons.User}"
-| [[File:UBIKstandard_home-service-group.png|64 px|center]] || ''Service'' - The customer profile. || Service|| <code>&#x 21;</code>
+        FontFamily="{x:Static UBIKSymbols}"
-|-
+        VerticalOptions="Center"
-| [[File:UBIKstandard_home-user-name.png|64 px|center]] || ''User'' || User || <code>&#x 22;</code>
+        VerticalTextAlignment="Center" />
-|-
-| [[File:UBIKstandard_home-password.png|64 px|center]] || ''Password'' || Password || <code>&#x 23;</code>
-|-
-| [[File:UBIKstandard_home-log-in.png|64 px|center]] || ''Log In'' || Login || <code>&#x 24;</code>
-|-
-| [[File:UBIKstandard_home-log-out.png|64 px|center]] || ''Log Out'' || Logout || <code>&#x 25;</code>
-|-
-| [[File:UBIKstandard_global-navigation-hamburger.png|64 px|center]] || ''Navigation'' - Global navigation or Hamburger Button || Navigation|| <code>&#x 28;</code>
-|-
-| [[File:UBIKstandard_global-more-actions.png|64 px|center]] || ''More Actions'' || Actions || <code>&#x 29;</code>
-|-
-| [[File:UBIKstandard_global-home.png|64 px|center]] || ''Home'' || Home || <code>&#x 2A;</code>
-|-
-| [[File:UBIKstandard_global-scan.png|64 px|center]] || ''Scan'' || Scan || <code>&#x 2B;</code>
-|-
-| [[File:UBIKstandard_global-poi.png|64 px|center]] || ''POI'' - NOT YET CREATED ||  || <code>&#x 2C;</code>
-|-
-| [[File:UBIKstandard_global-settings.png|64 px|center]] || ''Settings'' || Settings || <code>&#x 2D;</code>
-|-
-| [[File:UBIKstandard_global-search.png|64 px|center]] || ''Search'' || Search || <code>&#x 2E;</code>
-|-
-| [[File:UBIKstandard_sync-online.png|64 px|center]] || ''Syncmode-'' - Automatic uploads and downloads || Online || <code>&#x 30;</code>
-|-
-| [[File:UBIKstandard_sync-manual.png|64 px|center]] || ''Syncmode'' - Automatic downloads / manual uploads || Manual || <code>&#x 31;</code>
-|-
-| [[File:UBIKstandard_sync-offline.png|64 px|center]] || ''Syncmode'' - No Automatic uploads or downloads || Offline || <code>&#x 32; </code>
-|-
-|}
-===OBJECT PAGE / TABS===
+<!-- ... -->
-{| class="wikitable" | style="width:100%"
-|-
-! Icon !! Casual Name / Description !! In-App Name !! Hex Code
-|-
-| [[File:UBIKstandard_home-start-children.png|64 px|center]] || ''Start / Objects / Children'' - Symbol used to signify an object hierarchy. Thus used after logging in as the Start symbol, as well as for the Children tab just under the object title in the Header. || Children, Start || <code>&#x 4A;</code>
-|-
-| [[File:UBIKstandard_tab-properties.png|64 px|center]] || ''Properties'' - Used for Properties tab just under the object title in the Header. || Properties || <code>&#x 4B;</code>
-|-
-| [[File:UBIKstandard_tab-documents.png|64 px|center]] || ''Documents'' - Used for Properties tab just under the object title in the Header. || Documents || <code>&#x 4C;</code>
-|-
-| [[File:UBIKstandard_tab-document-viewing.png|64 px|center]] || ''Document being Viewed'' - Used in place of the Children tab (first position) when a document is being viewed. || DocumentView || <code>&#x 4D;</code>
-|-
-|}
-===CHILD OBJECT STATUS BADGES===
+</ContentView>
-{| class="wikitable" | style="width:100%"
+</syntaxhighlight>
-|-
-! Icon !! Casual Name / Description !! In-App Name !! Hex Code
-|-
-| [[File:UBIKstandard_child-changed.png|64 px|center]] || ''Uncommitted Changes'' - Used to show an item has alterations which have not yet been committed to the server (for example, in offline mode). || Changes || <code>&#x 41;</code>
-|-
-| [[File:UBIKstandard_child-changes-VARIANT.png|64 px|center]] || ''Uncommitted Changes / Variant'' - An alternate symbol for the usage. Currently, the small size that the icon is rendered at means that this image is too detailed for use on a child item in the above description. || ChangesAlt || <code>&#x 40;</code>
-|-
-| [[File:UBIKstandard_child-technical-alert.png|64 px|center]] || ''Technical Alert'' - Use to show that one or more children within the branch have an active Technical Alert status. || Technical || <code>&#x 43;</code>
-|-
-| [[File:UBIKstandard_organizational-in-progress.png|64 px|center]] || ''Organizational Status: Ongoing'' - Used to show that one or more of the tasks underneath this object are still in progress. || OrgOngoing || <code>&#x 44;</code>
-|-
-| [[File:UBIKstandard_organizational-complete.png|64 px|center]] || ''Organizational Status: Complete'' - Used to show that all the tasks underneath this object have been completed, and the ORG Status has been confirmed. || OrgComplete || <code>&#x 45;</code>
-|-
-| [[File:UBIKstandard_child-download-or-downloaded.png|64 px|center]] || ''Downloaded'' - Used to show that a branch download has occurred, making this object available offline. || Downloaded || <code>&#x 48;</code>
-|-
-| [[File:UBIKstandard_child-downloaded-VARIANT.png|64 px|center]] || ''Downloaded'' An alternate symbol for the usage. Currently, the small size that the icon is rendered at means that this image is too detailed for use on a child item in the above description. || DownloadedAlt || <code>&#x 46;</code>
-|-
-| [[File:UBIKstandard_child-locked.png|64 px|center]] || ''Locked'' || Locked || <code>&#x 47;</code>
-|-
-| [[File:UBIKstandard_child-deleted-or-action-delete.png|64 px|center]] || ''Deleted''- Indicates an as-yet uncommitted Deleted status (for example, in offline mode).  || Deleted || <code>&#x 52;</code>
-|-
-|}
-===PROPERTIES===
-{| class="wikitable" | style="width:100%"
-|-
-! Icon !! Casual Name / Description !! In-App Name !! Hex Code
-|-
-| [[File:UBIKstandard_document-online-linked.png|64 px|center]] || ''Online/Linked Document'' - Used to indicate strong signal, or as a base for the Ok and Bad signal icons. || OnlineDoc || <code>&#x 66;</code>
-|-
-| [[File:UBIKstandard_property-signal-good.png|64 px|center]] || ''Live Value Signal: Good'' || SignalGood || <code>&#x 63;</code>
-|-
-| [[File:UBIKstandard_property-signal-ok.png|64 px|center]] || ''Live Value Signal: Ok''|| SignalOK || <code>&#x 64;</code>
-|-
-| [[File:UBIKstandard_property-signal-bad.png|64 px|center]] || ''Live Value Signal: Ok''|| SignalBad || <code>&#x 65;</code>
-|-
-| [[File:UBIKstandard_property-read-only.png|64 px|center]] || ''Read Only Property''|| PropReadOnly || <code>&#x 60;</code>
-|-
-| [[File:UBIKstandard_property-editable.png|64 px|center]] || ''Editable Property''|| PropEdit || <code>&#x 61;</code>
-|-
-| [[File:UBIKstandard_property-list-editable.png|64 px|center]] || ''Editable List''|| PropEditList || <code>&#x 62;</code>
-|-
-|}
+== Available Icons==
+There are two options available to a customizer wishing to browse available icons.
+{{Hint|If a required icon is not found in UBIK, it is instead possible to [[Xamarin_XAML#Custom_Icons|render custom icons using Path data]].}}
-===ACTIONS===
+'''The best way''' is to download and unzip  the [[File:UBIK-Standard.zip]] file. Once unzipped, open the "demo" webpage file to view all icons, as well as the [[Icon_Font#In-App_Name_Usage|human readable labels]] you can use to render them in your UI. Because the demo webpage does not provide a good overview of all the icons, it is possible to combine this approach with the second one described below using that to browse the icons, and then this method to retrieve the human readable labels for the icons you wish to use.
-{| class="wikitable" | style="width:100%"
+<br>
-|-
-! Icon !! Casual Name / Description !! In-App Name !! Hex Code
-|-
-| [[File:UBIKstandard_action-add.png|64 px|center]] || ''Add'' - Generic icon for adding something. || Add || <code>&#x 50;</code>
-|-
-| [[File:UBIKstandard_action-photo.png|64 px|center]] || ''Add Photo'' || Photo || <code>&#x 51;</code>
-|-
-| [[File:UBIKstandard_child-deleted-or-action-delete.png|64 px|center]] || ''Delete''- Indicates an as-yet uncommitted Deleted status (for example, in offline mode).  || Delete, Deleted || <code>&#x 52;</code>
-|-
-| [[File:UBIKstandard_editor-cancel-or-action-discard.png|64 px|center]] || ''Discard'' - Discard object from local database. || Discard, Cancel || <code>&#x 53;</code>
-|-
-| [[File:UBIKstandard_action-or-editor-revert.png|64 px|center]] || ''Revert'' - Discard uncommitted changes. || Revert, Reset || <code>&#x 54;</code>
-|-
-| [[File:UBIKstandard_action-download.png|64 px|center]] || ''Download'' - Action to trigger a Branch Download. || Download || <code>&#x 55;</code>
-|-
-| [[File:UBIKstandard_action-use-location.png|64 px|center]] || ''Use Geo Location'' || UseLocation || <code>&#x 56;</code>
-|-
-|}
-===EDITORS===
-{| class="wikitable" | style="width:100%"
-|-
-! Icon !! Casual Name / Description !! In-App Name !! Hex Code
-|-
-| [[File:UBIKstandard_editor-confirm.png|64 px|center]] || ''Confirm'' || Confirm, Check, Ok, TaskYes || <code>&#x 57;</code>
-|-
-| [[File:UBIKstandard_action-or-editor-revert.png|64 px|center]] || ''Revert'' || Revert, Reset || <code>&#x 54;</code>
-|-
-| [[File:UBIKstandard_editor-cancel-or-action-discard.png|64 px|center]] || ''Cancel'' - Exit editor without saving changes. || Cancel || <code>&#x 53;</code>
-|-
-| [[File:UBIKstandard_navigation-right.png|64 px|center]] || ''GUID: Go To'' || GoTo, Right || <code>&#x 5B;</code>
-|-
-| [[File:UBIKstandard_editor-edit.png|64 px|center]] || ''GUID: Edit'' || Edit || &#x 5C;</code>
-|-
-| [[File:UBIKstandard_child-deleted-or-action-delete.png|64 px|center]] || ''GUID: Delete'' || Delete, Deleted || <code>&#x 52;</code>
-|-
-|}
-===TASK ACTIONS===
+The second way requires installation of the [https://apps.microsoft.com/detail/9wzdncrdxf41?hl=en-US&gl=US| Character Map] tool from Microsoft. This can be used to browse the characters of all the fonts installed on your machine, so to use this method you should certainly download and install the latest version of UBIK-Standard.ttf above. The downside of using this method is that you don't have access to the human readable labels using this app.
-{| class="wikitable" | style="width:100%"
+{{Attention|Note that icons installed on your machine are not necessarily available to customers, as they only have access to the icons delivered through UBIK, which is version-dependent.}}
-|-
-! Icon !! Casual Name / Description !! In-App Name !! Hex Code
-|-
-| [[File:UBIKstandard_editor-confirm.png|64 px|center]] || ''Task Yes'' || Confirm, Check, Ok, TaskYes || <code>&#x 57;</code>
-|-
-| [[File:UBIKstandard_editor-cancel-or-action-discard.png|64 px|center]] || ''Task No'' || Discard, Cancel || &#x 57;</code>
-|-
-| [[File:UBIKstandard_editor-confirm.png|64 px|center]] || ''Task Finished'' || Confirm, Check, Ok, TaskYes || <code>&#x 57;</code>
-|-
-| [[File:UBIKstandard_editor-NA.png|64 px|center]] || ''Task NA'' || Task NA || <code>&#x 6A;</code>
-|-
-|}
+<br>
-===GENERIC NAVIGATION===
+[[Category:Pages with broken file links|Icon Font]]
-{| class="wikitable" | style="width:100%"
-|-
-! Icon !! Casual Name / Description !! In-App Name !! Hex Code
-|-
-| [[File:UBIKstandard_navigation-right.png|64 px|center]] || ''Right'' || Right, GoTo || <code>&#x 5B;</code>
-|-
-| [[File:UBIKstandard_navigation-left.png|64 px|center]] || ''Left'' || Left || <code>&#x 5D;</code>
-|-
-| [[File:UBIKstandard_navigation-up.png|64 px|center]] || ''Up'' || Up || <code>&#x 5E;</code>
-|-
-| [[File:UBIKstandard_navigation-down.png|64 px|center]] || ''Down'' || Down || <code>&#x 5F;</code>
-|-
-|}
 == Known Issues ==
@@ Line 218: / Line 83: @@
 A second issue was encountered where using unstable behavior was observed when using UBIK-Standard.ttf for icons when the user switched tabs, leaving UBIK running in the background. In these cases, circular icon containers became square when switching back to the app, and the icon glyphs were no longer visible. However, using the <i>GlyphButton</i> and <i>GlyphLabel</i> elements (as opposed to simply <i>Button</i> and <i>Label</i>) seems to prevent this issue.
+==Creation==
+The process for creating icons is documented here.
+===Step 01: Asset Creation===
+The first step is to find similar, open-source icons to tweak. [https://themes-pixeden.com/font-demos/7-stroke/ Pixeden], [https://lineicons.com/icons/ LineIcons], or [https://linea.io/ LineA], are good starting points, as they have a similar style.
+When tweaking (for example, in Adobe Illustrator), use a stroke width of 3 for the base line thickness.
+It is good practice to produce three sets of .SVGs; a stroke version, an expanded version, and a final version. The stroke version is more easily edited, but the lines must be 'expanded' in Illustrator to be imported as icons. Finally, duplicate the expanded version, and name it using the following syntax:
+<code>001#ubik-U0x26</code>
+* The first number is used to keep the icon list orderly.
+* Add as many tags as desired using the # as separators. For example, a check mark icon may be listed as #ok#confirm#check. The - ends the tag portion of the syntax.
+* The glyph code assigns the icon to a certain space on the character map. As different device vendors block different glyph code sets for different uses, it is good practice to overwrite the basic alphabet, numbers, and symbols, to ensure the icons work on a large range of devices. Starting from 21, glyph codes may use numbers, or letters from 2A (2 here being an example) to 2F.
+===Step 02: TTF Generation===
+[https://icomoon.io/app/ IcoMoon] is a useful online tool for generating the icon font, that can then be installed on a device or packaged into the client resources.
+* Import Icons (top left) - Use this button to import an already existing font file, when creating additions, for example.
+* On the Selection tab (bottom center), ensure that the desired set is fully selected, and shown with an orange outline.
+* On the Generate Font tab (bottom right), double check the generated tags for the icons. The settings button beside the download button allows you to edit the font file name and version.
+* The download button exports the .ttf, among other resources, in a .ZIP, that is then downloaded.
 [[Category:Pages with broken file links|Icon Font]]

Difference between revisions of "Icon Font"

Latest revision as of 11:22, 21 August 2024

Contents

Usage

Xamarin Client

In-App Name Usage

Hex Code Usage

Directly Accessing Icons

Available Icons

Known Issues

Xamarin Client

Creation

Step 01: Asset Creation

Step 02: TTF Generation