more fixes |
Some clarification |
||
| Line 10: | Line 10: | ||
!Description | !Description | ||
!Range | !Range | ||
|- | |||
|<code>World/ColorVersion</code> | |||
|<code>uint</code> | |||
|'''Must''' exist if there is color information in the world. Corresponds to the version of the world color standard. | |||
|<code>1</code> | |||
|- | |||
|<code>World/ColorCount</code> | |||
|<code>uint</code> | |||
|'''Must''' exist if there is color information in the world. Corresponds to the amount of color variables in the world. | |||
|<code>1</code> - Unlimited | |||
|- | |||
|<code>World/ColorType</code> | |||
|<code>uint</code> | |||
|Optional. Defines how users will interpret the color list. | |||
If <code>0</code>, users are free to interpret it however they like. | |||
If the user does not recognize the color type, treat the color list as if the type is set to <code>0</code> | |||
|<code>0</code> - Unlimited | |||
|- | |- | ||
|<code>World/Hue'''''<sup>I</sup>'''''</code> | |<code>World/Hue'''''<sup>I</sup>'''''</code> | ||
| Line 31: | Line 48: | ||
|'''Must''' be a combination of <code>World/Hue'''''<sup>I</sup>'''''</code> and <code>World/Saturation'''''<sup>I</sup>'''''</code> with the Intensity set to <code>1.0</code> | |'''Must''' be a combination of <code>World/Hue'''''<sup>I</sup>'''''</code> and <code>World/Saturation'''''<sup>I</sup>'''''</code> with the Intensity set to <code>1.0</code> | ||
|<code>(H,S,1.0)</code> | |<code>(H,S,1.0)</code> | ||
|- | |- | ||
|<code>World/Hue</code> | |<code>World/Hue</code> | ||
|<code>float</code> | |<code>float</code> | ||
|''' | |'''Required and must''' be the same as <code>World/Hue0</code> | ||
|<code>World/Hue0</code> | |<code>World/Hue0</code> | ||
|- | |- | ||
|<code>World/Saturation</code> | |<code>World/Saturation</code> | ||
|<code>float</code> | |<code>float</code> | ||
|''' | |'''Required and must''' be the same as <code>World/Saturation0</code> | ||
|<code>World/Saturation0</code> | |<code>World/Saturation0</code> | ||
|- | |- | ||
|<code>World/Intensity</code> | |<code>World/Intensity</code> | ||
|<code>float</code> | |<code>float</code> | ||
|''' | |'''Required and must''' be the same as <code>World/Intensity0</code> | ||
|<code>World/Intensity0</code> | |<code>World/Intensity0</code> | ||
|- | |- | ||
|<code>World/Color</code> | |<code>World/Color</code> | ||
|<code>ColorX</code> | |<code>ColorX</code> | ||
|''' | |'''Required and must''' be the same as <code>World/Color0</code> | ||
|<code>World/Color0</code> | |<code>World/Color0</code> | ||
|} | |} | ||
A world can have multiple colors in a list going from 0 to infinity. For each Dynvar that has an <code>'''''<sup>I</sup>'''''</code> at the end of it, replace the <code>'''''<sup>I</sup>'''''</code> with the color's unsigned color index. Indices start at 0. | A world can have multiple colors in a list going from 0 to infinity. For each Dynvar that has an <code>'''''<sup>I</sup>'''''</code> at the end of it, replace the <code>'''''<sup>I</sup>'''''</code> with the color's unsigned color index. Indices start at 0. There must be at least <code>World/ColorCount</code> Hue, Saturation, Intensity and Color dynvars in the list. | ||
=== Color Types === | === Color Types === | ||
Revision as of 11:42, 6 May 2025
This article or section is a Stub. You can help the Resonite Wiki by expanding it.
Do not use any of these standards yet as they are all WIP!
World Color
| Dynamic Variable Name | Type | Description | Range |
|---|---|---|---|
World/ColorVersion
|
uint
|
Must exist if there is color information in the world. Corresponds to the version of the world color standard. | 1
|
World/ColorCount
|
uint
|
Must exist if there is color information in the world. Corresponds to the amount of color variables in the world. | 1 - Unlimited
|
World/ColorType
|
uint
|
Optional. Defines how users will interpret the color list.
If |
0 - Unlimited
|
World/HueI
|
float
|
The main HSV hue value of the world color. | 0.0 - 1.0
|
World/SaturationI
|
float
|
The main HSV saturation value of the world color. | 0.0 - 1.0
|
World/IntensityI
|
float
|
The main HSV intensity value of the world color.
When in a music world, should correspond to the volume of the music. |
0.0 - Unlimited
|
World/ColorI
|
ColorX
|
Must be a combination of World/HueI and World/SaturationI with the Intensity set to 1.0
|
(H,S,1.0)
|
World/Hue
|
float
|
Required and must be the same as World/Hue0
|
World/Hue0
|
World/Saturation
|
float
|
Required and must be the same as World/Saturation0
|
World/Saturation0
|
World/Intensity
|
float
|
Required and must be the same as World/Intensity0
|
World/Intensity0
|
World/Color
|
ColorX
|
Required and must be the same as World/Color0
|
World/Color0
|
A world can have multiple colors in a list going from 0 to infinity. For each Dynvar that has an I at the end of it, replace the I with the color's unsigned color index. Indices start at 0. There must be at least World/ColorCount Hue, Saturation, Intensity and Color dynvars in the list.
Color Types
| Index | Behavior | Amount of indices |
|---|---|---|
| 0 | Any. | Unlimited |
| 1 | Simple list. Colors can be anything. | Unlimited |
| 2 | Stereo channel volume. Intensity corresponds to the volume. Hue and saturation can be anything. | 2
|
| 3 | FFT16. 0 is lowest frequency, 15 is the highest. Intensity corresponds to the volume of that frequency. Hue and saturation can be anything.
|
16
|
| 4 | Percussion. Louder instruments go lower in the color list. Intensity corresponds to the current loudness of that instrument. Hue and saturation can be anything. | Unlimited |
| 5 | Melody. Lower notes go lower in the color list where 0 is C2 and 59 is C7. Intensity corresponds to the current velocity of a given note. Hue and saturation can be anything.
|
60
|
| 6 | Primary, Secondary, Tertiary, Quaternary colors. More common colors go lower in the color list. If a user requests the color that is above the index count, they must choose the highest one in the list. Colors can be anything. | 1 - 4
|
Examples
This article or section is a Stub. You can help the Resonite Wiki by expanding it.