This is a set of methods and resources that will produce a UIKit UILabel, containing a localizable description of a span of cleantime, or UIKit UIImages, representing keytags or medallions (standard medallions).
Keytags are displayed as classic "saddle" keytags (the real ones are made from plastic), with a ring at the top. This ring can be specified as "open," or "closed" (more on that, later)
|Figure 1: The Standard Keytag||Figure 2: With the Top Ring "Open"|
The medallions are "skeuomorphic" renditions of the standard NA cleantime medallions (front only):
|Figure 3: The Medallion|
These can be displayed, either as "one-off," single images, or in arrays, Figures 1-3 show them "singly," while Figures 4-6 show them in arrays:
|Figure 4: A Horizontal Matrix of Keytags||Figure 5: A Vertical Strip of Keytags||Figure 6: A Horizontal Matrix of Medallions|
You can see why the top ring is optionally open, in Figure 5.
The package is dependent upon the following three packages:
The URI for the repo is:
If you want to find out more about SPM, then you might want to view this series).
These are not being embedded into the package, because it is likely that you will want to mix them with your own localization resources.
Once you have the package included in your project, you'll need to include the library:
The test harness app is designed to demonstrate the various aspects of the package, and provide some sample implementation. It is an iOS/iPadOS app, and its source code is in the Tests/LGV_UICleantimeTestHarness subdirectory.
It has four tabs, which illustrate each of the above subclasses:
|Figure 7: Tab 0 ("Medallion")||Figure 8: Tab 1 ("Keytag")||Figure 9: Tab 2 ("Keytags")||Figure 10: Tab 3 ("Medallions")|
The Keytags and Medallions tabs have scrollers, which will allow you to scroll the images.
The two keytag tabs have switches, allowing you to change the appearance/layout:
|Figure 11: Keytag Open Top||Figure 12: Vertical Keytag Strip|
The code and keytag images are MIT license. Use them as you will.
However, the medallion images are renderings of the standard bronze NA World Services (NAWS, Inc.) cleantime commemoration medallions. The design of those medallions is copyrighted by NA World Services.
It is important to treat the intellectual property of NA with respect.