On large projects, it can be difficult to navigate between Cues and tell them apart. Especially if they contain nested Sequences. For example, you may have a Switch Cue that includes several Random SubSequences that may also contain their own SubSequences. Besides having a good naming convention, using colors can be very helpful to quickly locate your assets when browsing your project. Colors can be used in various ways, for example to differentiate Cues based on the type of sounds they play (footsteps, weapons etc\u2026) or how they are implemented (random, sequential…), etc.<\/p>\n
However, should you need color variations across a set of tracks, such as a gradient, it can be cumbersome to select a different color for each track, especially when a Cue can easily contain more than a dozen tracks. Fortunately, the Robot API makes it easy to automatically set a gradient or randomize colors for multiple tracks at once in AtomCraft.<\/p>\n
The get_color<\/em> and set_color<\/em> functions of the Robot API can be used to access the colors of the objects in Atom Craft. The colors of the Cue Sheets, Cue Folders, Cues,<\/em> and Tracks<\/em> can be modified. A color is represented by its comma-separated RGB components (e.g., “255,0,0” for red). For example, to set the first selected Track\u2019s color to red, we can write the following code:<\/p>\n However, when creating a color gradient, it is easier to work in the HSV color space. So, we first need to convert the RGB values to HSV, create our color variations (gradient, randomization…), and then convert back the colors to RGB to change an object\u2019s color.<\/p>\n When converting from RGB to HSV, the steps are:<\/p>\n For the HSV to RGB conversion, simply reverse the steps above and call colorsys.hsv_to_rgb<\/em>.<\/p>\n In our code, we defined two functions to handle these conversions:<\/p>\n Now that we can manipulate our colors, we can define a function to create a simple gradient from the color of the first selected track. A gradient can be easily generated by varying a single component such as S (saturation) or V (value or brightness) in the HSV space.<\/p>\n For instance, to generate a gradient by varying the saturation:<\/p>\n All we need now is to write a loop that assigns the new colors to the selected tracks.<\/p>\n Assigning a color gradient across Tracks is especially useful for Sequential Cues, or Cues that play different sounds based on intensity (car engine, wind, rain…).<\/p>\n\r\n# Get selected tracks:\r\nselected_tracks = acproject.get_selected_objects(\"Track\")[\"data\"]\r\n\r\n# Set first track color to red:\r\ncolor = \"255,0,0\"\r\nnew_color = acproject.set_color(selected_tracks[0], color)\r\n\r\n<\/code><\/pre>\n\n
\r\nimport colorsys\r\nimport cri.atomcraft.debug as acdebug\r\nimport cri.atomcraft.project as acproject\r\n\r\n# Convert RGB to HSV\r\ndef rgb_to_hsv(rgb):\r\n\tr, g, b = map(int, rgb.split(','))\r\n\tr, g, b = r \/ 255.0, g \/ 255.0, b \/ 255.0\r\n\th, s, v = colorsys.rgb_to_hsv(r, g, b)\r\n\treturn h, s, v\r\n\r\n# Convert HSV to RGB\r\ndef hsv_to_rgb(hsv):\r\n\th, s, v = hsv\r\n\tr, g, b = colorsys.hsv_to_rgb(h, s, v)\r\n\tr, g, b = int(r * 255), int(g * 255), int(b * 255)\r\n\treturn f\"{r},{g},{b}\"\r\n\r\n<\/code><\/pre>\nColor Gradient<\/h1>\n
\n
\r\ndef generate_saturation_gradient(base_color, num_objects):\r\n\tbase_hsv = rgb_to_hsv(base_color)\r\n\tstep = 0.6 \/ num_objects\r\n\r\n\tcolors = []\r\n\tfor i in range(num_objects):\r\n\t\t# Increment the saturation component\r\n\t\tnew_s = min(base_hsv[1] + step * i, 1.0)\r\n\t\tnew_color = hsv_to_rgb((base_hsv[0], new_s, base_hsv[2]))\r\n\t\tcolors.append(new_color)\r\n\r\n\treturn colors\r\n\t\r\n<\/code><\/pre>\n