Differences

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

--- tips:tapcolor [2015/03/30 19:46] – [Changing Color Through Tap Action] jt3
+++ tips:tapcolor [2015/04/24 05:16] (current) – [Explanation] jt3
@@ Line 3: / Line 3: @@
 A feature that's becoming more and more common, especially with paid watches that can't be edited, is the ability to change the color of an item or items on your watch face via tap action.  This tutorial will explain the most efficient method for doing this.  We'll be using arrays, so you're going to need version 3.4 (or higher) of WatchMaker to pull this off.
-===== Examples =====
+===== Example =====
 ==== Main Script ====
@@ Line 19: / Line 19: @@
-==== Color Field of Object ====
+==== Color Field of Object(s) ====
    var_color1[var_clrnum]
 ==== Tap Action ====
@@ Line 28: / Line 28: @@
 We start in the main script by initializing our variables.  we do this to avoid having a variable set to NULL, which is always a good idea.  The two variables we care about are "var_clrnum," which is color selection, and "var_color1" which is the color itself.  If you were wanting to have themes, where each theme has multiple colors that go together, you'd simply add a var_color2, var_color3, etc. in the same manner.  Everything else would stay the same, and you'd use the same, single, var_clrnum, to set the color on everything.
-Let's take a closer look at that "var_color1."  This is called an array (or table).  What we've done here is set 7 separate values to the same variable, each being a color in hexadecimal format.  These seven values are comma-separated, and since they're strings, each must have a string identifier.  In this case, we used apostrophes as string identifiers, but you can use quotes if you're one of **those** people :-P.  Just be consistent throughout each array.  Don't mix quote identifiers, or things can get ugly.
+Let's take a closer look at that "var_color1."  This is called an array (or table).  What we've done here is set 7 separate values to the same variable, each being a color in hexadecimal format.  These seven values are comma-separated, and since they're strings, each must have a string identifier.  In this case, we used apostrophes as string identifiers, but you can use quotes if you're one of **those** people :-P.  Just be consistent throughout each array.  Don't mix string identifiers, or things can get ugly.
-In an array, we determine which value we want like this:  var_color1[1], var_color1[2], and so on.  So, all we need to do to change the color is change the number in the brackets.  That's where var_clrnum comes in.
+Since, in an array, a variable can have multiple values, we determine which value we want like this:  var_color1[1], var_color1[2], and so on.  So, all we need to do to change the color is change the number in the brackets.  That's where var_clrnum comes in.
 In the script, we set up a function that acts as a toggle.  Each time we call the function, which we'll do via tap action, we increase the value of var_clrnum by one.  When we reach the maximum (the number of entries in our array) value of 7, we simply set it back to 1.  That way, var_clrnum is never a number that does not represent a value in var_color1.