Color
Un color representado en formato RGBA.
Descripción
A color represented in RGBA format by a red (r), green (g), blue (b), and alpha (a) component. Each component is a 32-bit floating-point value, usually ranging from 0.0 to 1.0. Some properties (such as CanvasItem.modulate) may support values greater than 1.0, for overbright or HDR (High Dynamic Range) colors.
Colors can be created in various ways: By the various Color constructors, by static methods such as from_hsv(), and by using a name from the set of standardized colors based on X11 color names with the addition of TRANSPARENT. GDScript also provides @GDScript.Color8(), which uses integers from 0 to 255 and doesn't support overbright colors.
Color data may be stored in many color spaces and encodings. The srgb_to_linear() and linear_to_srgb() methods can convert between nonlinear sRGB encoding and linear RGB encoding.
Note: In a boolean context, a Color will evaluate to false if it is equal to Color(0, 0, 0, 1) (opaque black). Otherwise, a Color will always evaluate to true.
Nota
Hay diferencias notables cuando usa esta API con C#. Véase Diferencias de la API de C# con GDScript para más información.
Tutoriales
Propiedades
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Constructores
Color() |
|
Métodos
clamp(min: Color = Color(0, 0, 0, 0), max: Color = Color(1, 1, 1, 1)) const |
|
from_hsv(h: float, s: float, v: float, alpha: float = 1.0) static |
|
from_ok_hsl(h: float, s: float, l: float, alpha: float = 1.0) static |
|
from_rgba8(r8: int, g8: int, b8: int, a8: int = 255) static |
|
from_rgbe9995(rgbe: int) static |
|
from_string(str: String, default: Color) static |
|
get_luminance() const |
|
html_is_valid(color: String) static |
|
inverted() const |
|
is_equal_approx(to: Color) const |
|
linear_to_srgb() const |
|
srgb_to_linear() const |
|
to_abgr32() const |
|
to_abgr64() const |
|
to_argb32() const |
|
to_argb64() const |
|
to_rgba32() const |
|
to_rgba64() const |
Operadores
operator !=(right: Color) |
|
operator *(right: Color) |
|
operator *(right: float) |
|
operator *(right: int) |
|
operator +(right: Color) |
|
operator -(right: Color) |
|
operator /(right: Color) |
|
operator /(right: float) |
|
operator /(right: int) |
|
operator ==(right: Color) |
|
operator [](index: int) |
|
Constantes
ALICE_BLUE = Color(0.9411765, 0.972549, 1, 1) 🔗
Color azul Alice.
ANTIQUE_WHITE = Color(0.98039216, 0.92156863, 0.84313726, 1) 🔗
Color blanco antiguo.
AQUA = Color(0, 1, 1, 1) 🔗
Color agua.
AQUAMARINE = Color(0.49803922, 1, 0.83137256, 1) 🔗
Color aguamarina.
AZURE = Color(0.9411765, 1, 1, 1) 🔗
Color Azure.
BEIGE = Color(0.9607843, 0.9607843, 0.8627451, 1) 🔗
Color beige.
BISQUE = Color(1, 0.89411765, 0.76862746, 1) 🔗
Color bisque.
BLACK = Color(0, 0, 0, 1) 🔗
Color negro. En GDScript, este es el valor predeterminado de cualquier color.
BLANCHED_ALMOND = Color(1, 0.92156863, 0.8039216, 1) 🔗
Color almendra blanqueada.
BLUE = Color(0, 0, 1, 1) 🔗
Color azul.
BLUE_VIOLET = Color(0.5411765, 0.16862746, 0.8862745, 1) 🔗
Color azul violeta.
BROWN = Color(0.64705884, 0.16470589, 0.16470589, 1) 🔗
Color marrón.
BURLYWOOD = Color(0.87058824, 0.72156864, 0.5294118, 1) 🔗
Color madera fuerte.
CADET_BLUE = Color(0.37254903, 0.61960787, 0.627451, 1) 🔗
Color azul cadete.
CHARTREUSE = Color(0.49803922, 1, 0, 1) 🔗
Color cartujo.
CHOCOLATE = Color(0.8235294, 0.4117647, 0.11764706, 1) 🔗
Color chocolate.
CORAL = Color(1, 0.49803922, 0.3137255, 1) 🔗
Color coral.
CORNFLOWER_BLUE = Color(0.39215687, 0.58431375, 0.92941177, 1) 🔗
Color azul aciano.
CORNSILK = Color(1, 0.972549, 0.8627451, 1) 🔗
Color seda de maíz.
CRIMSON = Color(0.8627451, 0.078431375, 0.23529412, 1) 🔗
Color carmesí.
CYAN = Color(0, 1, 1, 1) 🔗
Color cian.
DARK_BLUE = Color(0, 0, 0.54509807, 1) 🔗
Color azul oscuro.
DARK_CYAN = Color(0, 0.54509807, 0.54509807, 1) 🔗
Color cian oscuro.
DARK_GOLDENROD = Color(0.72156864, 0.5254902, 0.043137256, 1) 🔗
Color de vara dorada oscura.
DARK_GRAY = Color(0.6627451, 0.6627451, 0.6627451, 1) 🔗
Color gris oscuro.
DARK_GREEN = Color(0, 0.39215687, 0, 1) 🔗
Color verde oscuro.
DARK_KHAKI = Color(0.7411765, 0.7176471, 0.41960785, 1) 🔗
Color caqui oscuro.
DARK_MAGENTA = Color(0.54509807, 0, 0.54509807, 1) 🔗
Color magenta oscuro.
DARK_OLIVE_GREEN = Color(0.33333334, 0.41960785, 0.18431373, 1) 🔗
Color verde oliva oscuro.
DARK_ORANGE = Color(1, 0.54901963, 0, 1) 🔗
Color naranja oscuro.
DARK_ORCHID = Color(0.6, 0.19607843, 0.8, 1) 🔗
Color de orquídea oscura.
DARK_RED = Color(0.54509807, 0, 0, 1) 🔗
Color rojo oscuro.
DARK_SALMON = Color(0.9137255, 0.5882353, 0.47843137, 1) 🔗
Color salmón oscuro.
DARK_SEA_GREEN = Color(0.56078434, 0.7372549, 0.56078434, 1) 🔗
Color verde mar oscuro.
DARK_SLATE_BLUE = Color(0.28235295, 0.23921569, 0.54509807, 1) 🔗
Color azul pizarra oscuro.
DARK_SLATE_GRAY = Color(0.18431373, 0.30980393, 0.30980393, 1) 🔗
Color gris pizarra oscuro.
DARK_TURQUOISE = Color(0, 0.80784315, 0.81960785, 1) 🔗
Color turquesa oscuro.
DARK_VIOLET = Color(0.5803922, 0, 0.827451, 1) 🔗
Color violeta oscuro.
DEEP_PINK = Color(1, 0.078431375, 0.5764706, 1) 🔗
Color rosa intenso.
DEEP_SKY_BLUE = Color(0, 0.7490196, 1, 1) 🔗
Color azul cielo profundo.
DIM_GRAY = Color(0.4117647, 0.4117647, 0.4117647, 1) 🔗
Color gris oscuro.
DODGER_BLUE = Color(0.11764706, 0.5647059, 1, 1) 🔗
Color azul de los Dodgers.
FIREBRICK = Color(0.69803923, 0.13333334, 0.13333334, 1) 🔗
Color de ladrillo de fuego.
FLORAL_WHITE = Color(1, 0.98039216, 0.9411765, 1) 🔗
Color blanco floral.
FOREST_GREEN = Color(0.13333334, 0.54509807, 0.13333334, 1) 🔗
Color verde del bosque.
FUCHSIA = Color(1, 0, 1, 1) 🔗
Color fucsia.
GAINSBORO = Color(0.8627451, 0.8627451, 0.8627451, 1) 🔗
Color Gainsboro.
GHOST_WHITE = Color(0.972549, 0.972549, 1, 1) 🔗
Color blanco fantasma.
GOLD = Color(1, 0.84313726, 0, 1) 🔗
Color oro.
GOLDENROD = Color(0.85490197, 0.64705884, 0.1254902, 1) 🔗
Color de la vara de oro.
GRAY = Color(0.74509805, 0.74509805, 0.74509805, 1) 🔗
Color gris.
GREEN = Color(0, 1, 0, 1) 🔗
Color verde.
GREEN_YELLOW = Color(0.6784314, 1, 0.18431373, 1) 🔗
Color amarillo verde.
HONEYDEW = Color(0.9411765, 1, 0.9411765, 1) 🔗
Color melón.
HOT_PINK = Color(1, 0.4117647, 0.7058824, 1) 🔗
Color rosa vivo.
INDIAN_RED = Color(0.8039216, 0.36078432, 0.36078432, 1) 🔗
Color rojo indio.
INDIGO = Color(0.29411766, 0, 0.50980395, 1) 🔗
Color índigo.
IVORY = Color(1, 1, 0.9411765, 1) 🔗
Color marfil.
KHAKI = Color(0.9411765, 0.9019608, 0.54901963, 1) 🔗
Color caqui.
LAVENDER = Color(0.9019608, 0.9019608, 0.98039216, 1) 🔗
Color lavanda.
LAVENDER_BLUSH = Color(1, 0.9411765, 0.9607843, 1) 🔗
Color de rubor lavanda.
LAWN_GREEN = Color(0.4862745, 0.9882353, 0, 1) 🔗
Color verde césped.
LEMON_CHIFFON = Color(1, 0.98039216, 0.8039216, 1) 🔗
Color chifón limón.
LIGHT_BLUE = Color(0.6784314, 0.84705883, 0.9019608, 1) 🔗
Color azul claro.
LIGHT_CORAL = Color(0.9411765, 0.5019608, 0.5019608, 1) 🔗
Color coral claro.
LIGHT_CYAN = Color(0.8784314, 1, 1, 1) 🔗
Color cian claro.
LIGHT_GOLDENROD = Color(0.98039216, 0.98039216, 0.8235294, 1) 🔗
Color de vara de oro claro.
LIGHT_GRAY = Color(0.827451, 0.827451, 0.827451, 1) 🔗
Color gris claro.
LIGHT_GREEN = Color(0.5647059, 0.93333334, 0.5647059, 1) 🔗
Color verde claro.
LIGHT_PINK = Color(1, 0.7137255, 0.75686276, 1) 🔗
Color rosa claro.
LIGHT_SALMON = Color(1, 0.627451, 0.47843137, 1) 🔗
Color salmón claro.
LIGHT_SEA_GREEN = Color(0.1254902, 0.69803923, 0.6666667, 1) 🔗
Color verde mar claro.
LIGHT_SKY_BLUE = Color(0.5294118, 0.80784315, 0.98039216, 1) 🔗
Color azul celeste.
LIGHT_SLATE_GRAY = Color(0.46666667, 0.53333336, 0.6, 1) 🔗
Color gris pizarra claro.
LIGHT_STEEL_BLUE = Color(0.6901961, 0.76862746, 0.87058824, 1) 🔗
Color azul acero claro.
LIGHT_YELLOW = Color(1, 1, 0.8784314, 1) 🔗
Color amarillo claro.
LIME = Color(0, 1, 0, 1) 🔗
Color lima.
LIME_GREEN = Color(0.19607843, 0.8039216, 0.19607843, 1) 🔗
Color verde lima.
LINEN = Color(0.98039216, 0.9411765, 0.9019608, 1) 🔗
Color lino.
MAGENTA = Color(1, 0, 1, 1) 🔗
Color magenta.
MAROON = Color(0.6901961, 0.1882353, 0.3764706, 1) 🔗
Color granate.
MEDIUM_AQUAMARINE = Color(0.4, 0.8039216, 0.6666667, 1) 🔗
Color aguamarina medio.
MEDIUM_BLUE = Color(0, 0, 0.8039216, 1) 🔗
Color azul medio.
MEDIUM_ORCHID = Color(0.7294118, 0.33333334, 0.827451, 1) 🔗
Color de orquídea medio.
MEDIUM_PURPLE = Color(0.5764706, 0.4392157, 0.85882354, 1) 🔗
Color púrpura medio.
MEDIUM_SEA_GREEN = Color(0.23529412, 0.7019608, 0.44313726, 1) 🔗
Color verde marino medio.
MEDIUM_SLATE_BLUE = Color(0.48235294, 0.40784314, 0.93333334, 1) 🔗
Color azul pizarra medio.
MEDIUM_SPRING_GREEN = Color(0, 0.98039216, 0.6039216, 1) 🔗
Color verde primaveral medio.
MEDIUM_TURQUOISE = Color(0.28235295, 0.81960785, 0.8, 1) 🔗
Color turquesa medio.
MEDIUM_VIOLET_RED = Color(0.78039217, 0.08235294, 0.52156866, 1) 🔗
Color rojo violáceo medio.
MIDNIGHT_BLUE = Color(0.09803922, 0.09803922, 0.4392157, 1) 🔗
Color azul medianoche.
MINT_CREAM = Color(0.9607843, 1, 0.98039216, 1) 🔗
Color crema de menta.
MISTY_ROSE = Color(1, 0.89411765, 0.88235295, 1) 🔗
Color rosa niebla.
MOCCASIN = Color(1, 0.89411765, 0.70980394, 1) 🔗
Color mocasín.
Color blanco navajo.
Color azul marino.
OLD_LACE = Color(0.99215686, 0.9607843, 0.9019608, 1) 🔗
Color de encaje antiguo.
OLIVE = Color(0.5019608, 0.5019608, 0, 1) 🔗
Color oliva.
OLIVE_DRAB = Color(0.41960785, 0.5568628, 0.13725491, 1) 🔗
Color aceituna monótono.
ORANGE = Color(1, 0.64705884, 0, 1) 🔗
Color naranja.
ORANGE_RED = Color(1, 0.27058825, 0, 1) 🔗
Color rojo anaranjado.
ORCHID = Color(0.85490197, 0.4392157, 0.8392157, 1) 🔗
Color orquídea.
PALE_GOLDENROD = Color(0.93333334, 0.9098039, 0.6666667, 1) 🔗
Color de vara de oro pálido.
PALE_GREEN = Color(0.59607846, 0.9843137, 0.59607846, 1) 🔗
Color verde pálido.
PALE_TURQUOISE = Color(0.6862745, 0.93333334, 0.93333334, 1) 🔗
Color turquesa pálido.
PALE_VIOLET_RED = Color(0.85882354, 0.4392157, 0.5764706, 1) 🔗
Color rojo violeta pálido.
PAPAYA_WHIP = Color(1, 0.9372549, 0.8352941, 1) 🔗
Color del látigo de papaya.
PEACH_PUFF = Color(1, 0.85490197, 0.7254902, 1) 🔗
Color melocotón.
PERU = Color(0.8039216, 0.52156866, 0.24705882, 1) 🔗
Color Perú.
PINK = Color(1, 0.7529412, 0.79607844, 1) 🔗
Color rosa.
PLUM = Color(0.8666667, 0.627451, 0.8666667, 1) 🔗
Color ciruela.
POWDER_BLUE = Color(0.6901961, 0.8784314, 0.9019608, 1) 🔗
Color azul de polvo.
PURPLE = Color(0.627451, 0.1254902, 0.9411765, 1) 🔗
Color púrpura.
REBECCA_PURPLE = Color(0.4, 0.2, 0.6, 1) 🔗
Color púrpura de Rebecca.
RED = Color(1, 0, 0, 1) 🔗
Color rojo.
ROSY_BROWN = Color(0.7372549, 0.56078434, 0.56078434, 1) 🔗
Color marrón rosado.
ROYAL_BLUE = Color(0.25490198, 0.4117647, 0.88235295, 1) 🔗
Color azul real.
SADDLE_BROWN = Color(0.54509807, 0.27058825, 0.07450981, 1) 🔗
Color marrón silla de montar.
SALMON = Color(0.98039216, 0.5019608, 0.44705883, 1) 🔗
Color salmón.
SANDY_BROWN = Color(0.95686275, 0.6431373, 0.3764706, 1) 🔗
Color marrón arenoso.
SEA_GREEN = Color(0.18039216, 0.54509807, 0.34117648, 1) 🔗
Color verde mar.
SEASHELL = Color(1, 0.9607843, 0.93333334, 1) 🔗
Color de la concha marina.
SIENNA = Color(0.627451, 0.32156864, 0.1764706, 1) 🔗
Color siena.
SILVER = Color(0.7529412, 0.7529412, 0.7529412, 1) 🔗
Color plata.
SKY_BLUE = Color(0.5294118, 0.80784315, 0.92156863, 1) 🔗
Color azul cielo.
SLATE_BLUE = Color(0.41568628, 0.3529412, 0.8039216, 1) 🔗
Color azul pizarra.
SLATE_GRAY = Color(0.4392157, 0.5019608, 0.5647059, 1) 🔗
Color gris pizarra.
SNOW = Color(1, 0.98039216, 0.98039216, 1) 🔗
Color nieve.
SPRING_GREEN = Color(0, 1, 0.49803922, 1) 🔗
Color verde primaveral.
STEEL_BLUE = Color(0.27450982, 0.50980395, 0.7058824, 1) 🔗
Color azul acero.
TAN = Color(0.8235294, 0.7058824, 0.54901963, 1) 🔗
Color bronceado.
TEAL = Color(0, 0.5019608, 0.5019608, 1) 🔗
Color verde azulado.
THISTLE = Color(0.84705883, 0.7490196, 0.84705883, 1) 🔗
Color cardo.
TOMATO = Color(1, 0.3882353, 0.2784314, 1) 🔗
Color tomate.
TRANSPARENT = Color(1, 1, 1, 0) 🔗
Color transparente (blanco con alfa cero).
TURQUOISE = Color(0.2509804, 0.8784314, 0.8156863, 1) 🔗
Color turquesa.
VIOLET = Color(0.93333334, 0.50980395, 0.93333334, 1) 🔗
Color violeta.
WEB_GRAY = Color(0.5019608, 0.5019608, 0.5019608, 1) 🔗
Color gris web.
WEB_GREEN = Color(0, 0.5019608, 0, 1) 🔗
Color verde web.
WEB_MAROON = Color(0.5019608, 0, 0, 1) 🔗
Color granate web.
WEB_PURPLE = Color(0.5019608, 0, 0.5019608, 1) 🔗
Color púrpura web.
WHEAT = Color(0.9607843, 0.87058824, 0.7019608, 1) 🔗
Color trigo.
WHITE = Color(1, 1, 1, 1) 🔗
Color blanco.
WHITE_SMOKE = Color(0.9607843, 0.9607843, 0.9607843, 1) 🔗
Color humo blanco.
YELLOW = Color(1, 1, 0, 1) 🔗
Color amarillo.
YELLOW_GREEN = Color(0.6039216, 0.8039216, 0.19607843, 1) 🔗
Color verde amarillo.
Descripciones de Propiedades
El componente alfa del color, normalmente en el rango de 0 a 1. Un valor de 0 significa que el color es totalmente transparente. Un valor de 1 significa que el color es totalmente opaco.
Nota: El canal alfa siempre se almacena con codificación lineal, independientemente del espacio de color de los otros canales de color. Los métodos linear_to_srgb() y srgb_to_linear() no afectan al canal alfa.
Wrapper for a that uses the range 0 to 255, instead of 0 to 1.
El componente azul del color, típicamente en el rango de 0 a 1.
Wrapper for b that uses the range 0 to 255, instead of 0 to 1.
El componente verde del color, típicamente en el rango de 0 a 1.
Wrapper for g that uses the range 0 to 255, instead of 0 to 1.
El tono del HSV de este color, en el rango de 0 a 1..
El tono OKHSL de este color, en el rango de 0 a 1.
La luminosidad OKHSL de este color, en el rango de 0 a 1.
La saturación OKHSL de este color, en el rango de 0 a 1.
El componente rojo del color, típicamente en el rango de 0 a 1.
Wrapper for r that uses the range 0 to 255, instead of 0 to 1.
La saturación del HSV de este color, en el rango de 0 a 1.
El valor HSV (brillo) de este color, en el rango de 0 a 1.
Descripciones de Constructores
Construye un Color por defecto a partir de negro opaco. Es lo mismo que BLACK.
Nota: En C#, esto construye un Color con todos sus componentes establecidos a 0.0 (negro transparente).
Color Color(from: Color, alpha: float)
Construye un Color a partir del color existente, con a establecido al valor alpha dado.
var red = Color(Color.RED, 0.2) # Rojo opaco al 20%.
var red = new Color(Colors.Red, 0.2f); // Rojo opaco al 20%.
Construye un Color como una copia del Color dado.
Construye un Color ya sea desde un código de color HTML o desde un nombre de color estandarizado. Los nombres de color soportados son los mismos que las constantes.
Color Color(code: String, alpha: float)
Construye un Color ya sea desde un código de color HTML o desde un nombre de color estandarizado, con alpha en el rango de 0.0 a 1.0. Los nombres de color soportados son los mismos que las constantes.
Color Color(r: float, g: float, b: float)
Construye un Color a partir de valores RGB, normalmente entre 0.0 y 1.0. a se establece en 1.0.
var color = Color(0.2, 1.0, 0.7) # Similar a `Color8(51, 255, 178, 255)`
var color = new Color(0.2f, 1.0f, 0.7f); // Similar a `Color.Color8(51, 255, 178, 255)`
Color Color(r: float, g: float, b: float, a: float)
Construye un Color a partir de valores RGBA, normalmente entre 0.0 y 1.0.
var color = Color(0.2, 1.0, 0.7, 0.8) # Similar a `Color8(51, 255, 178, 204)`
var color = new Color(0.2f, 1.0f, 0.7f, 0.8f); // Similar a `Color.Color8(51, 255, 178, 255, 204)`
Descripciones de Métodos
Color blend(over: Color) const 🔗
Devuelve un nuevo color resultante de superponer este color sobre el color dado. En un programa de pintura, puedes imaginarlo como el color over pintado sobre este color (incluyendo el alfa).
var bg = Color(0.0, 1.0, 0.0, 0.5) # Verde con alfa del 50%
var fg = Color(1.0, 0.0, 0.0, 0.5) # Rojo con alfa del 50%
var blended_color = bg.blend(fg) # Marrón con alfa del 75%
var bg = new Color(0.0f, 1.0f, 0.0f, 0.5f); // Verde con alfa del 50%
var fg = new Color(1.0f, 0.0f, 0.0f, 0.5f); // Rojo con alfa del 50%
Color blendedColor = bg.Blend(fg); // Marrón con alfa del 75%
Color clamp(min: Color = Color(0, 0, 0, 0), max: Color = Color(1, 1, 1, 1)) const 🔗
Devuelve un nuevo color con todos los componentes sujetos entre los componentes de min y max, ejecutando @GlobalScope.clamp() en cada componente.
Color darkened(amount: float) const 🔗
Devuelve un nuevo color resultante de oscurecer este color según la amount especificada (relación de 0.0 a 1.0). Véase también lightened().
var green = Color(0.0, 1.0, 0.0)
var darkgreen = green.darkened(0.2) # 20% más oscuro que el verde normal
var green = new Color(0.0f, 1.0f, 0.0f);
Color darkgreen = green.Darkened(0.2f); // 20% más oscuro que el verde normal
Color from_hsv(h: float, s: float, v: float, alpha: float = 1.0) static 🔗
Construye un color a partir de un perfil HSV. El tono (h), la saturación (s) y el valor (v) están normalmente entre 0.0 y 1.0.
var color = Color.from_hsv(0.58, 0.5, 0.79, 0.8)
var color = Color.FromHsv(0.58f, 0.5f, 0.79f, 0.8f);
Color from_ok_hsl(h: float, s: float, l: float, alpha: float = 1.0) static 🔗
Construye un color a partir de un perfil OK HSL. El tono (h), la saturación (s) y la luminosidad (l) están normalmente entre 0.0 y 1.0.
var color = Color.from_ok_hsl(0.58, 0.5, 0.79, 0.8)
var color = Color.FromOkHsl(0.58f, 0.5f, 0.79f, 0.8f);
Color from_rgba8(r8: int, g8: int, b8: int, a8: int = 255) static 🔗
Returns a Color constructed from red (r8), green (g8), blue (b8), and optionally alpha (a8) integer channels, each divided by 255.0 for their final value.
var red = Color.from_rgba8(255, 0, 0) # Same as Color(1, 0, 0).
var dark_blue = Color.from_rgba8(0, 0, 51) # Same as Color(0, 0, 0.2).
var my_color = Color.from_rgba8(306, 255, 0, 102) # Same as Color(1.2, 1, 0, 0.4).
Note: Due to the lower precision of from_rgba8() compared to the standard Color constructor, a color created with from_rgba8() will generally not be equal to the same color created with the standard Color constructor. Use is_equal_approx() for comparisons to avoid issues with floating-point precision error.
Color from_rgbe9995(rgbe: int) static 🔗
Decodifica un Color desde un entero con formato RGBE9995. Véase Image.FORMAT_RGBE9995.
Color from_string(str: String, default: Color) static 🔗
Crea un Color a partir de la string dada, que puede ser un código de color HTML o un color con nombre (insensible a mayúsculas y minúsculas). Devuelve default si no se puede inferir el color de la string.
Si quieres crear un color desde una String en una expresión constante, usa el constructor equivalente en su lugar (ej. Color("color string")).
Devuelve la intensidad de la luz del color, como un valor entre 0.0 y 1.0 (inclusivo). Esto es útil para determinar el color claro u oscuro. Los colores con una luminancia inferior a 0.5 pueden considerarse generalmente oscuros.
Nota: get_luminance() se basa en que el color esté en el espacio de color lineal para devolver un valor de luminancia relativa preciso. Si el color está en el espacio de color sRGB, usa srgb_to_linear() para convertirlo primero al espacio de color lineal.
Devuelve el Color asociado con el entero hex proporcionado en formato RGBA de 32 bits (8 bits por canal). Este método es el inverso de to_rgba32().
En GDScript y C#, el int se visualiza mejor con notación hexadecimal ("0x" prefijo, haciéndolo "0xRRGGBBAA").
var red = Color.hex(0xff0000ff)
var dark_cyan = Color.hex(0x008b8bff)
var my_color = Color.hex(0xbbefd2a4)
var red = new Color(0xff0000ff);
var dark_cyan = new Color(0x008b8bff);
var my_color = new Color(0xbbefd2a4);
Si quieres usar la notación hexadecimal en una expresión constante, usa el constructor equivalente en su lugar (ej. Color(0xRRGGBBAA)).
Color hex64(hex: int) static 🔗
Devuelve el Color asociado con el entero hex proporcionado en formato RGBA de 64 bits (16 bits por canal). Este método es el inverso de to_rgba64().
En GDScript y C#, el int se visualiza mejor con la notación hexadecimal ("0x" prefijo, haciéndolo "0xRRRRGGGGBBBBAAAA").
Color html(rgba: String) static 🔗
Devuelve un nuevo color de rgba, una string de color hexadecimal HTML. rgba no distingue entre mayúsculas y minúsculas, y puede tener el prefijo de un signo hash (#).
rgba debe ser una string de color hexadecimal válida de tres o seis dígitos, y puede contener un valor de canal alfa. Si rgba no contiene un valor de canal alfa, se aplica un valor de canal alfa de 1.0. Si rgba no es válido, devuelve un color vacío.
var azul = Color.html("#0000ff") # azul es Color(0.0, 0.0, 1.0, 1.0)
var verde = Color.html("#0F0") # verde es Color(0.0, 1.0, 0.0, 1.0)
var col = Color.html("663399cc") # col es Color(0.4, 0.2, 0.6, 0.8)
var azul = Color.FromHtml("#0000ff"); // azul es Color(0.0, 0.0, 1.0, 1.0)
var verde = Color.FromHtml("#0F0"); // verde es Color(0.0, 1.0, 0.0, 1.0)
var col = Color.FromHtml("663399cc"); // col es Color(0.4, 0.2, 0.6, 0.8)
bool html_is_valid(color: String) static 🔗
Devuelve true si color es una string hexadecimal HTML válida.La string debe ser un valor hexadecimal (insensible a mayúsculas y minúsculas) de 3, 4, 6 u 8 dígitos, y puede tener el prefijo de un signo hash (#).Este método es idéntico a String.is_valid_html_color().
Color.html_is_valid("#55aaFF") # Devuelve true
Color.html_is_valid("#55AAFF20") # Devuelve true
Color.html_is_valid("55AAFF") # Devuelve true
Color.html_is_valid("#F2C") # Devuelve true
Color.html_is_valid("#AABBC") # Devuelve false
Color.html_is_valid("#55aaFF5") # Devuelve false
Color.HtmlIsValid("#55AAFF"); // Devuelve true
Color.HtmlIsValid("#55AAFF20"); // Devuelve true
Color.HtmlIsValid("55AAFF"); // Devuelve true
Color.HtmlIsValid("#F2C"); // Devuelve true
Color.HtmlIsValid("#AABBC"); // Devuelve false
Color.HtmlIsValid("#55aaFF5"); // Devuelve false
Devuelve el color con sus componentes r, g y b invertidos ((1 - r, 1 - g, 1 - b, a)).
var black = Color.WHITE.inverted()
var color = Color(0.3, 0.4, 0.9)
var inverted_color = color.inverted() # Equivalente a `Color(0.7, 0.6, 0.1)`
var black = Colors.White.Inverted();
var color = new Color(0.3f, 0.4f, 0.9f);
Color invertedColor = color.Inverted(); // Equivalente a `new Color(0.7f, 0.6f, 0.1f)`
bool is_equal_approx(to: Color) const 🔗
Returns true if this color and to are approximately equal, by running @GlobalScope.is_equal_approx() on each component.
Color lerp(to: Color, weight: float) const 🔗
Devuelve la interpolación lineal entre los componentes de este color y los componentes de to. El factor de interpolación weight debe estar entre 0.0 y 1.0 (inclusivo). Véase también @GlobalScope.lerp().
var rojo = Color(1.0, 0.0, 0.0)
var aqua = Color(0.0, 1.0, 0.8)
rojo.lerp(aqua, 0.2) # Devuelve Color(0.8, 0.2, 0.16)
rojo.lerp(aqua, 0.5) # Devuelve Color(0.5, 0.5, 0.4)
rojo.lerp(aqua, 1.0) # Devuelve Color(0.0, 1.0, 0.8)
var rojo = new Color(1.0f, 0.0f, 0.0f);
var aqua = new Color(0.0f, 1.0f, 0.8f);
rojo.Lerp(aqua, 0.2f); // Devuelve Color(0.8f, 0.2f, 0.16f)
rojo.Lerp(aqua, 0.5f); // Devuelve Color(0.5f, 0.5f, 0.4f)
rojo.Lerp(aqua, 1.0f); // Devuelve Color(0.0f, 1.0f, 0.8f)
Color lightened(amount: float) const 🔗
Devuelve un nuevo color resultante de hacer este color más claro según la amount especificada, que debería ser una relación de 0.0 a 1.0. Véase también darkened().
var verde = Color(0.0, 1.0, 0.0)
var light_green = verde.lightened(0.2) # 20% más claro que el verde normal
var verde = new Color(0.0f, 1.0f, 0.0f);
Color verdeClaro = verde.Lightened(0.2f); // 20% más claro que el verde normal
Color linear_to_srgb() const 🔗
Devuelve el color convertido al espacio de color sRGB. Este método asume que el color original está en el espacio de color lineal. Véase también srgb_to_linear(), que realiza la operación opuesta.
Nota: El canal alfa a del color no se ve afectado. El canal alfa siempre se almacena con codificación lineal, independientemente del espacio de color de los otros canales de color.
Color srgb_to_linear() const 🔗
Devuelve el color convertido al espacio de color lineal. Este método asume que el color original ya está en el espacio de color sRGB. Véase también linear_to_srgb(), que realiza la operación opuesta.
Nota: El canal alfa a del color no se ve afectado. El canal alfa siempre se almacena con codificación lineal, independientemente del espacio de color de los otros canales de color.
Devuelve el color convertido a un entero de 32 bits en formato ABGR (cada componente ocupa 8 bits). ABGR es la versión invertida del formato RGBA por defecto.
var color = Color(1, 0.5, 0.2)
print(color.to_abgr32()) # Imprime 4281565439
var color = new Color(1.0f, 0.5f, 0.2f);
GD.Print(color.ToAbgr32()); // Imprime 4281565439
Devuelve el color convertido a un entero de 64 bits en formato ABGR (cada componente ocupa 16 bits). ABGR es la versión invertida del formato RGBA por defecto.
var color = Color(1, 0.5, 0.2)
print(color.to_abgr64()) # Imprime -225178692812801
var color = new Color(1.0f, 0.5f, 0.2f);
GD.Print(color.ToAbgr64()); // Imprime -225178692812801
Devuelve el color convertido a un entero de 32 bits en formato ARGB (cada componente ocupa 8 bits). ARGB es más compatible con DirectX.
var color = Color(1, 0.5, 0.2)
print(color.to_argb32()) # Imprime 4294934323
var color = new Color(1.0f, 0.5f, 0.2f);
GD.Print(color.ToArgb32()); // Imprime 4294934323
Devuelve el color convertido a un entero de 64 bits en formato ARGB (cada componente ocupa 16 bits). ARGB es más compatible con DirectX.
var color = Color(1, 0.5, 0.2)
print(color.to_argb64()) # Imprime -2147470541
var color = new Color(1.0f, 0.5f, 0.2f);
GD.Print(color.ToArgb64()); // Imprime -2147470541
String to_html(with_alpha: bool = true) const 🔗
Devuelve el color convertido a una String de color hexadecimal HTML en formato RGBA, sin el prefijo hash (#).
Si estableces with_alpha a false, se excluye el alfa de la string hexadecimal, usando el formato RGB en lugar del formato RGBA.
var white = Color(1, 1, 1, 0.5)
var with_alpha = white.to_html() # Devuelve "ffffff7f"
var without_alpha = white.to_html(false) # Devuelve "ffffff"
var white = new Color(1, 1, 1, 0.5f);
string withAlpha = white.ToHtml(); // Devuelve "ffffff7f"
string withoutAlpha = white.ToHtml(false); // Devuelve "ffffff"
Devuelve el color convertido a un entero de 32 bits en formato RGBA (cada componente tiene 8 bits). RGBA es el formato por defecto de Godot. Este método es el inverso de hex().
var color = Color(1, 0.5, 0.2)
print(color.to_rgba32()) # Imprime 4286526463
var color = new Color(1, 0.5f, 0.2f);
GD.Print(color.ToRgba32()); // Imprime 4286526463
Returns the color converted to a 64-bit integer in RGBA format (each component is 16 bits). RGBA is Godot's default format. This method is the inverse of hex64().
var color = Color(1, 0.5, 0.2)
print(color.to_rgba64()) # Prints -140736629309441
var color = new Color(1, 0.5f, 0.2f);
GD.Print(color.ToRgba64()); // Prints -140736629309441
Descripciones de Operadores
bool operator !=(right: Color) 🔗
Returns true if the colors are not exactly equal.
Note: Due to floating-point precision errors, consider using is_equal_approx() instead, which is more reliable.
Color operator *(right: Color) 🔗
Multiplica cada componente del Color por los componentes del Color dado.
Color operator *(right: float) 🔗
Multiplica cada componente del Color por el float dado.
Color operator *(right: int) 🔗
Multiplica cada componente de Color por el int dado.
Color operator +(right: Color) 🔗
Suma cada componente del Color con los componentes del Color dado.
Color operator -(right: Color) 🔗
Resta cada componente del Color por los componentes del Color dado.
Color operator /(right: Color) 🔗
Divide cada componente del Color por los componentes del Color dado.
Color operator /(right: float) 🔗
Divide cada componente del Color por el float dado.
Color operator /(right: int) 🔗
Divide cada componente de Color por el int dado.
bool operator ==(right: Color) 🔗
Returns true if the colors are exactly equal.
Note: Due to floating-point precision errors, consider using is_equal_approx() instead, which is more reliable.
float operator [](index: int) 🔗
Accede a los componentes de color usando su índice. [0] es equivalente a r, [1] es equivalente a g, [2] es equivalente a b, y [3] es equivalente a a.
Devuelve el mismo valor como si el + no estuviera ahí. El + unario no hace nada, pero a veces puede hacer que tu código sea más legible.
Invierte el color dado. Esto es equivalente a Color.WHITE - c o a Color(1 - c.r, 1 - c.g, 1 - c.b, 1 - c.a). A diferencia de inverted(), el componente a también se invierte.