Difference between revisions of "Legacy:BlendColorsWeighted"
From Spherical
(→Usage: param types) |
|||
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | [[ | + | Returns a [[API:Color|Color]] object that is the blended color of the two input colors, (c1 and c2) but allows you to specify the amount of each color. |
| − | |||
==Usage== | ==Usage== | ||
| + | {{Usage|returns=[[API:Color|Color]]|func=BlendColorsWeighted|params=c1, c2, c1_weight, c2_weight}} | ||
| − | + | * '''c1''' [[API:Color|Color]]. a color object created with [[API:CreateColor|CreateColor]] | |
| − | + | * '''c2''' [[API:Color|Color]]. a color object created with CreateColor | |
| − | * '''c1''' a color object created with [[CreateColor]] | + | * '''c1_weight''' integer. amount of first color |
| − | * '''c2''' a color object created with CreateColor | + | * '''c2_weight''' integer. amount of second color |
| − | * '''c1_weight''' amount of first color | ||
| − | * '''c2_weight''' amount of second color | ||
==Notes== | ==Notes== | ||
| Line 37: | Line 35: | ||
==See also== | ==See also== | ||
| − | * Sphere [[Color]] object | + | * Sphere [[API:Color|Color]] object |
| − | * [[CreateColor]]() | + | * [[API:CreateColor|CreateColor]]() |
| − | * [[ApplyColorMask]]() | + | * [[API:ApplyColorMask|ApplyColorMask]]() |
| − | * [[BlendColors]]() | + | * [[API:BlendColors|BlendColors]]() |
* [http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Math:min Math.min]() | * [http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Math:min Math.min]() | ||
| + | |||
| + | |||
| + | {{API:Color/navbox}} | ||
Latest revision as of 23:40, 11 September 2013
Returns a Color object that is the blended color of the two input colors, (c1 and c2) but allows you to specify the amount of each color.
Contents
Usage
Color BlendColorsWeighted(c1, c2, c1_weight, c2_weight);
- c1 Color. a color object created with CreateColor
- c2 Color. a color object created with CreateColor
- c1_weight integer. amount of first color
- c2_weight integer. amount of second color
Notes
The weights of the two colors are converted to a ratio out of 100%. (1:2 means one part of the first to two parts of the second. Or 33% of the first to 66% of the second.)
Examples
var Red = CreateColor(255, 0, 0); //Creates a red color.
var Blue = CreateColor(0, 255, 0); //Creates a blue color.
var Blend = BlendColorsWeighted(Red, Blue, 2, 1); //Creates a reddish purple color by blending the two colors with 2 parts red to 1 part blue.BlendColorsWeighted can be adapted for the more familiar alpha blending method as follows:
//Alpha can be between 0 and 1
function AlphaBlend (Color,SourceColor,Alpha) {
Alpha = Math.min(Math.max(Alpha,0.0),1.0); //Clamp alpha to 0-1
return BlendColorsWeighted(Color,SourceColor,Alpha,1.0 - Alpha);
}See also
- Sphere Color object
- CreateColor()
- ApplyColorMask()
- BlendColors()
- Math.min()
