12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472 |
- :github_url: hide
- .. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
- .. DO NOT EDIT THIS FILE, but the Color.xml source instead.
- .. The source is found in doc/classes or modules/<name>/doc_classes.
- .. _class_Color:
- Color
- =====
- Color in RGBA format using floats on the range of 0 to 1.
- Description
- -----------
- A color represented by red, green, blue, and alpha (RGBA) components. The alpha component is often used for transparency. Values are in floating-point and usually range from 0 to 1. Some properties (such as CanvasItem.modulate) may accept values greater than 1 (overbright or HDR colors).
- You can also create a color from standardized color names by using the string constructor or directly using the color constants defined here. The standardized color set is based on the `X11 color names <https://en.wikipedia.org/wiki/X11_color_names>`__.
- If you want to supply values in a range of 0 to 255, you should use :ref:`@GDScript.Color8<class_@GDScript_method_Color8>`.
- **Note:** In a boolean context, a Color will evaluate to ``false`` if it's equal to ``Color(0, 0, 0, 1)`` (opaque black). Otherwise, a Color will always evaluate to ``true``.
- `Color constants cheatsheet <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/color_constants.png>`__
- Tutorials
- ---------
- - `2D GD Paint Demo <https://godotengine.org/asset-library/asset/517>`__
- - `Tween Demo <https://godotengine.org/asset-library/asset/146>`__
- - `GUI Drag And Drop Demo <https://godotengine.org/asset-library/asset/133>`__
- Properties
- ----------
- +---------------------------+------------------------------------+---------+
- | :ref:`float<class_float>` | :ref:`a<class_Color_property_a>` | ``1.0`` |
- +---------------------------+------------------------------------+---------+
- | :ref:`int<class_int>` | :ref:`a8<class_Color_property_a8>` | ``255`` |
- +---------------------------+------------------------------------+---------+
- | :ref:`float<class_float>` | :ref:`b<class_Color_property_b>` | ``0.0`` |
- +---------------------------+------------------------------------+---------+
- | :ref:`int<class_int>` | :ref:`b8<class_Color_property_b8>` | ``0`` |
- +---------------------------+------------------------------------+---------+
- | :ref:`float<class_float>` | :ref:`g<class_Color_property_g>` | ``0.0`` |
- +---------------------------+------------------------------------+---------+
- | :ref:`int<class_int>` | :ref:`g8<class_Color_property_g8>` | ``0`` |
- +---------------------------+------------------------------------+---------+
- | :ref:`float<class_float>` | :ref:`h<class_Color_property_h>` | ``0.0`` |
- +---------------------------+------------------------------------+---------+
- | :ref:`float<class_float>` | :ref:`r<class_Color_property_r>` | ``0.0`` |
- +---------------------------+------------------------------------+---------+
- | :ref:`int<class_int>` | :ref:`r8<class_Color_property_r8>` | ``0`` |
- +---------------------------+------------------------------------+---------+
- | :ref:`float<class_float>` | :ref:`s<class_Color_property_s>` | ``0.0`` |
- +---------------------------+------------------------------------+---------+
- | :ref:`float<class_float>` | :ref:`v<class_Color_property_v>` | ``0.0`` |
- +---------------------------+------------------------------------+---------+
- Constructors
- ------------
- +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`Color<class_Color_constructor_Color>` **(** **)** |
- +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`Color<class_Color_constructor_Color>` **(** :ref:`Color<class_Color>` from, :ref:`float<class_float>` alpha **)** |
- +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`Color<class_Color_constructor_Color>` **(** :ref:`Color<class_Color>` from **)** |
- +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`Color<class_Color_constructor_Color>` **(** :ref:`String<class_String>` code **)** |
- +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`Color<class_Color_constructor_Color>` **(** :ref:`String<class_String>` code, :ref:`float<class_float>` alpha **)** |
- +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`Color<class_Color_constructor_Color>` **(** :ref:`float<class_float>` r, :ref:`float<class_float>` g, :ref:`float<class_float>` b **)** |
- +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`Color<class_Color_constructor_Color>` **(** :ref:`float<class_float>` r, :ref:`float<class_float>` g, :ref:`float<class_float>` b, :ref:`float<class_float>` a **)** |
- +---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- Methods
- -------
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`blend<class_Color_method_blend>` **(** :ref:`Color<class_Color>` over **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`clamp<class_Color_method_clamp>` **(** :ref:`Color<class_Color>` min=Color(0, 0, 0, 0), :ref:`Color<class_Color>` max=Color(1, 1, 1, 1) **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`darkened<class_Color_method_darkened>` **(** :ref:`float<class_float>` amount **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`find_named_color<class_Color_method_find_named_color>` **(** :ref:`String<class_String>` name **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`from_hsv<class_Color_method_from_hsv>` **(** :ref:`float<class_float>` h, :ref:`float<class_float>` s, :ref:`float<class_float>` v, :ref:`float<class_float>` alpha=1.0 **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`from_rgbe9995<class_Color_method_from_rgbe9995>` **(** :ref:`int<class_int>` rgbe **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`from_string<class_Color_method_from_string>` **(** :ref:`String<class_String>` str, :ref:`Color<class_Color>` default **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`get_named_color<class_Color_method_get_named_color>` **(** :ref:`int<class_int>` idx **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`get_named_color_count<class_Color_method_get_named_color_count>` **(** **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`get_named_color_name<class_Color_method_get_named_color_name>` **(** :ref:`int<class_int>` idx **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`hex<class_Color_method_hex>` **(** :ref:`int<class_int>` hex **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`hex64<class_Color_method_hex64>` **(** :ref:`int<class_int>` hex **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`html<class_Color_method_html>` **(** :ref:`String<class_String>` rgba **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`html_is_valid<class_Color_method_html_is_valid>` **(** :ref:`String<class_String>` color **)** |static| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`inverted<class_Color_method_inverted>` **(** **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`is_equal_approx<class_Color_method_is_equal_approx>` **(** :ref:`Color<class_Color>` to **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`lerp<class_Color_method_lerp>` **(** :ref:`Color<class_Color>` to, :ref:`float<class_float>` weight **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`lightened<class_Color_method_lightened>` **(** :ref:`float<class_float>` amount **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`to_abgr32<class_Color_method_to_abgr32>` **(** **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`to_abgr64<class_Color_method_to_abgr64>` **(** **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`to_argb32<class_Color_method_to_argb32>` **(** **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`to_argb64<class_Color_method_to_argb64>` **(** **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`String<class_String>` | :ref:`to_html<class_Color_method_to_html>` **(** :ref:`bool<class_bool>` with_alpha=true **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`to_rgba32<class_Color_method_to_rgba32>` **(** **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- | :ref:`int<class_int>` | :ref:`to_rgba64<class_Color_method_to_rgba64>` **(** **)** |const| |
- +-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
- Operators
- ---------
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`operator !=<class_Color_operator_neq_bool>` **(** **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`operator !=<class_Color_operator_neq_bool>` **(** :ref:`Color<class_Color>` right **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`operator *<class_Color_operator_mul_Color>` **(** :ref:`Color<class_Color>` right **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`operator *<class_Color_operator_mul_Color>` **(** :ref:`float<class_float>` right **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`operator *<class_Color_operator_mul_Color>` **(** :ref:`int<class_int>` right **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`operator +<class_Color_operator_sum_Color>` **(** :ref:`Color<class_Color>` right **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`operator -<class_Color_operator_dif_Color>` **(** :ref:`Color<class_Color>` right **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`operator /<class_Color_operator_div_Color>` **(** :ref:`Color<class_Color>` right **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`operator /<class_Color_operator_div_Color>` **(** :ref:`float<class_float>` right **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`operator /<class_Color_operator_div_Color>` **(** :ref:`int<class_int>` right **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`operator ==<class_Color_operator_eq_bool>` **(** **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`bool<class_bool>` | :ref:`operator ==<class_Color_operator_eq_bool>` **(** :ref:`Color<class_Color>` right **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`float<class_float>` | :ref:`operator []<class_Color_operator_idx_float>` **(** :ref:`int<class_int>` index **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`operator unary+<class_Color_operator_unplus_Color>` **(** **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- | :ref:`Color<class_Color>` | :ref:`operator unary-<class_Color_operator_unminus_Color>` **(** **)** |
- +---------------------------+-----------------------------------------------------------------------------------------------+
- Constants
- ---------
- .. _class_Color_constant_ALICE_BLUE:
- .. _class_Color_constant_ANTIQUE_WHITE:
- .. _class_Color_constant_AQUA:
- .. _class_Color_constant_AQUAMARINE:
- .. _class_Color_constant_AZURE:
- .. _class_Color_constant_BEIGE:
- .. _class_Color_constant_BISQUE:
- .. _class_Color_constant_BLACK:
- .. _class_Color_constant_BLANCHED_ALMOND:
- .. _class_Color_constant_BLUE:
- .. _class_Color_constant_BLUE_VIOLET:
- .. _class_Color_constant_BROWN:
- .. _class_Color_constant_BURLYWOOD:
- .. _class_Color_constant_CADET_BLUE:
- .. _class_Color_constant_CHARTREUSE:
- .. _class_Color_constant_CHOCOLATE:
- .. _class_Color_constant_CORAL:
- .. _class_Color_constant_CORNFLOWER_BLUE:
- .. _class_Color_constant_CORNSILK:
- .. _class_Color_constant_CRIMSON:
- .. _class_Color_constant_CYAN:
- .. _class_Color_constant_DARK_BLUE:
- .. _class_Color_constant_DARK_CYAN:
- .. _class_Color_constant_DARK_GOLDENROD:
- .. _class_Color_constant_DARK_GRAY:
- .. _class_Color_constant_DARK_GREEN:
- .. _class_Color_constant_DARK_KHAKI:
- .. _class_Color_constant_DARK_MAGENTA:
- .. _class_Color_constant_DARK_OLIVE_GREEN:
- .. _class_Color_constant_DARK_ORANGE:
- .. _class_Color_constant_DARK_ORCHID:
- .. _class_Color_constant_DARK_RED:
- .. _class_Color_constant_DARK_SALMON:
- .. _class_Color_constant_DARK_SEA_GREEN:
- .. _class_Color_constant_DARK_SLATE_BLUE:
- .. _class_Color_constant_DARK_SLATE_GRAY:
- .. _class_Color_constant_DARK_TURQUOISE:
- .. _class_Color_constant_DARK_VIOLET:
- .. _class_Color_constant_DEEP_PINK:
- .. _class_Color_constant_DEEP_SKY_BLUE:
- .. _class_Color_constant_DIM_GRAY:
- .. _class_Color_constant_DODGER_BLUE:
- .. _class_Color_constant_FIREBRICK:
- .. _class_Color_constant_FLORAL_WHITE:
- .. _class_Color_constant_FOREST_GREEN:
- .. _class_Color_constant_FUCHSIA:
- .. _class_Color_constant_GAINSBORO:
- .. _class_Color_constant_GHOST_WHITE:
- .. _class_Color_constant_GOLD:
- .. _class_Color_constant_GOLDENROD:
- .. _class_Color_constant_GRAY:
- .. _class_Color_constant_GREEN:
- .. _class_Color_constant_GREEN_YELLOW:
- .. _class_Color_constant_HONEYDEW:
- .. _class_Color_constant_HOT_PINK:
- .. _class_Color_constant_INDIAN_RED:
- .. _class_Color_constant_INDIGO:
- .. _class_Color_constant_IVORY:
- .. _class_Color_constant_KHAKI:
- .. _class_Color_constant_LAVENDER:
- .. _class_Color_constant_LAVENDER_BLUSH:
- .. _class_Color_constant_LAWN_GREEN:
- .. _class_Color_constant_LEMON_CHIFFON:
- .. _class_Color_constant_LIGHT_BLUE:
- .. _class_Color_constant_LIGHT_CORAL:
- .. _class_Color_constant_LIGHT_CYAN:
- .. _class_Color_constant_LIGHT_GOLDENROD:
- .. _class_Color_constant_LIGHT_GRAY:
- .. _class_Color_constant_LIGHT_GREEN:
- .. _class_Color_constant_LIGHT_PINK:
- .. _class_Color_constant_LIGHT_SALMON:
- .. _class_Color_constant_LIGHT_SEA_GREEN:
- .. _class_Color_constant_LIGHT_SKY_BLUE:
- .. _class_Color_constant_LIGHT_SLATE_GRAY:
- .. _class_Color_constant_LIGHT_STEEL_BLUE:
- .. _class_Color_constant_LIGHT_YELLOW:
- .. _class_Color_constant_LIME:
- .. _class_Color_constant_LIME_GREEN:
- .. _class_Color_constant_LINEN:
- .. _class_Color_constant_MAGENTA:
- .. _class_Color_constant_MAROON:
- .. _class_Color_constant_MEDIUM_AQUAMARINE:
- .. _class_Color_constant_MEDIUM_BLUE:
- .. _class_Color_constant_MEDIUM_ORCHID:
- .. _class_Color_constant_MEDIUM_PURPLE:
- .. _class_Color_constant_MEDIUM_SEA_GREEN:
- .. _class_Color_constant_MEDIUM_SLATE_BLUE:
- .. _class_Color_constant_MEDIUM_SPRING_GREEN:
- .. _class_Color_constant_MEDIUM_TURQUOISE:
- .. _class_Color_constant_MEDIUM_VIOLET_RED:
- .. _class_Color_constant_MIDNIGHT_BLUE:
- .. _class_Color_constant_MINT_CREAM:
- .. _class_Color_constant_MISTY_ROSE:
- .. _class_Color_constant_MOCCASIN:
- .. _class_Color_constant_NAVAJO_WHITE:
- .. _class_Color_constant_NAVY_BLUE:
- .. _class_Color_constant_OLD_LACE:
- .. _class_Color_constant_OLIVE:
- .. _class_Color_constant_OLIVE_DRAB:
- .. _class_Color_constant_ORANGE:
- .. _class_Color_constant_ORANGE_RED:
- .. _class_Color_constant_ORCHID:
- .. _class_Color_constant_PALE_GOLDENROD:
- .. _class_Color_constant_PALE_GREEN:
- .. _class_Color_constant_PALE_TURQUOISE:
- .. _class_Color_constant_PALE_VIOLET_RED:
- .. _class_Color_constant_PAPAYA_WHIP:
- .. _class_Color_constant_PEACH_PUFF:
- .. _class_Color_constant_PERU:
- .. _class_Color_constant_PINK:
- .. _class_Color_constant_PLUM:
- .. _class_Color_constant_POWDER_BLUE:
- .. _class_Color_constant_PURPLE:
- .. _class_Color_constant_REBECCA_PURPLE:
- .. _class_Color_constant_RED:
- .. _class_Color_constant_ROSY_BROWN:
- .. _class_Color_constant_ROYAL_BLUE:
- .. _class_Color_constant_SADDLE_BROWN:
- .. _class_Color_constant_SALMON:
- .. _class_Color_constant_SANDY_BROWN:
- .. _class_Color_constant_SEA_GREEN:
- .. _class_Color_constant_SEASHELL:
- .. _class_Color_constant_SIENNA:
- .. _class_Color_constant_SILVER:
- .. _class_Color_constant_SKY_BLUE:
- .. _class_Color_constant_SLATE_BLUE:
- .. _class_Color_constant_SLATE_GRAY:
- .. _class_Color_constant_SNOW:
- .. _class_Color_constant_SPRING_GREEN:
- .. _class_Color_constant_STEEL_BLUE:
- .. _class_Color_constant_TAN:
- .. _class_Color_constant_TEAL:
- .. _class_Color_constant_THISTLE:
- .. _class_Color_constant_TOMATO:
- .. _class_Color_constant_TRANSPARENT:
- .. _class_Color_constant_TURQUOISE:
- .. _class_Color_constant_VIOLET:
- .. _class_Color_constant_WEB_GRAY:
- .. _class_Color_constant_WEB_GREEN:
- .. _class_Color_constant_WEB_MAROON:
- .. _class_Color_constant_WEB_PURPLE:
- .. _class_Color_constant_WHEAT:
- .. _class_Color_constant_WHITE:
- .. _class_Color_constant_WHITE_SMOKE:
- .. _class_Color_constant_YELLOW:
- .. _class_Color_constant_YELLOW_GREEN:
- - **ALICE_BLUE** = **Color(0.94, 0.97, 1, 1)** --- Alice blue color.
- - **ANTIQUE_WHITE** = **Color(0.98, 0.92, 0.84, 1)** --- Antique white color.
- - **AQUA** = **Color(0, 1, 1, 1)** --- Aqua color.
- - **AQUAMARINE** = **Color(0.5, 1, 0.83, 1)** --- Aquamarine color.
- - **AZURE** = **Color(0.94, 1, 1, 1)** --- Azure color.
- - **BEIGE** = **Color(0.96, 0.96, 0.86, 1)** --- Beige color.
- - **BISQUE** = **Color(1, 0.89, 0.77, 1)** --- Bisque color.
- - **BLACK** = **Color(0, 0, 0, 1)** --- Black color.
- - **BLANCHED_ALMOND** = **Color(1, 0.92, 0.8, 1)** --- Blanched almond color.
- - **BLUE** = **Color(0, 0, 1, 1)** --- Blue color.
- - **BLUE_VIOLET** = **Color(0.54, 0.17, 0.89, 1)** --- Blue violet color.
- - **BROWN** = **Color(0.65, 0.16, 0.16, 1)** --- Brown color.
- - **BURLYWOOD** = **Color(0.87, 0.72, 0.53, 1)** --- Burlywood color.
- - **CADET_BLUE** = **Color(0.37, 0.62, 0.63, 1)** --- Cadet blue color.
- - **CHARTREUSE** = **Color(0.5, 1, 0, 1)** --- Chartreuse color.
- - **CHOCOLATE** = **Color(0.82, 0.41, 0.12, 1)** --- Chocolate color.
- - **CORAL** = **Color(1, 0.5, 0.31, 1)** --- Coral color.
- - **CORNFLOWER_BLUE** = **Color(0.39, 0.58, 0.93, 1)** --- Cornflower blue color.
- - **CORNSILK** = **Color(1, 0.97, 0.86, 1)** --- Cornsilk color.
- - **CRIMSON** = **Color(0.86, 0.08, 0.24, 1)** --- Crimson color.
- - **CYAN** = **Color(0, 1, 1, 1)** --- Cyan color.
- - **DARK_BLUE** = **Color(0, 0, 0.55, 1)** --- Dark blue color.
- - **DARK_CYAN** = **Color(0, 0.55, 0.55, 1)** --- Dark cyan color.
- - **DARK_GOLDENROD** = **Color(0.72, 0.53, 0.04, 1)** --- Dark goldenrod color.
- - **DARK_GRAY** = **Color(0.66, 0.66, 0.66, 1)** --- Dark gray color.
- - **DARK_GREEN** = **Color(0, 0.39, 0, 1)** --- Dark green color.
- - **DARK_KHAKI** = **Color(0.74, 0.72, 0.42, 1)** --- Dark khaki color.
- - **DARK_MAGENTA** = **Color(0.55, 0, 0.55, 1)** --- Dark magenta color.
- - **DARK_OLIVE_GREEN** = **Color(0.33, 0.42, 0.18, 1)** --- Dark olive green color.
- - **DARK_ORANGE** = **Color(1, 0.55, 0, 1)** --- Dark orange color.
- - **DARK_ORCHID** = **Color(0.6, 0.2, 0.8, 1)** --- Dark orchid color.
- - **DARK_RED** = **Color(0.55, 0, 0, 1)** --- Dark red color.
- - **DARK_SALMON** = **Color(0.91, 0.59, 0.48, 1)** --- Dark salmon color.
- - **DARK_SEA_GREEN** = **Color(0.56, 0.74, 0.56, 1)** --- Dark sea green color.
- - **DARK_SLATE_BLUE** = **Color(0.28, 0.24, 0.55, 1)** --- Dark slate blue color.
- - **DARK_SLATE_GRAY** = **Color(0.18, 0.31, 0.31, 1)** --- Dark slate gray color.
- - **DARK_TURQUOISE** = **Color(0, 0.81, 0.82, 1)** --- Dark turquoise color.
- - **DARK_VIOLET** = **Color(0.58, 0, 0.83, 1)** --- Dark violet color.
- - **DEEP_PINK** = **Color(1, 0.08, 0.58, 1)** --- Deep pink color.
- - **DEEP_SKY_BLUE** = **Color(0, 0.75, 1, 1)** --- Deep sky blue color.
- - **DIM_GRAY** = **Color(0.41, 0.41, 0.41, 1)** --- Dim gray color.
- - **DODGER_BLUE** = **Color(0.12, 0.56, 1, 1)** --- Dodger blue color.
- - **FIREBRICK** = **Color(0.7, 0.13, 0.13, 1)** --- Firebrick color.
- - **FLORAL_WHITE** = **Color(1, 0.98, 0.94, 1)** --- Floral white color.
- - **FOREST_GREEN** = **Color(0.13, 0.55, 0.13, 1)** --- Forest green color.
- - **FUCHSIA** = **Color(1, 0, 1, 1)** --- Fuchsia color.
- - **GAINSBORO** = **Color(0.86, 0.86, 0.86, 1)** --- Gainsboro color.
- - **GHOST_WHITE** = **Color(0.97, 0.97, 1, 1)** --- Ghost white color.
- - **GOLD** = **Color(1, 0.84, 0, 1)** --- Gold color.
- - **GOLDENROD** = **Color(0.85, 0.65, 0.13, 1)** --- Goldenrod color.
- - **GRAY** = **Color(0.75, 0.75, 0.75, 1)** --- Gray color.
- - **GREEN** = **Color(0, 1, 0, 1)** --- Green color.
- - **GREEN_YELLOW** = **Color(0.68, 1, 0.18, 1)** --- Green yellow color.
- - **HONEYDEW** = **Color(0.94, 1, 0.94, 1)** --- Honeydew color.
- - **HOT_PINK** = **Color(1, 0.41, 0.71, 1)** --- Hot pink color.
- - **INDIAN_RED** = **Color(0.8, 0.36, 0.36, 1)** --- Indian red color.
- - **INDIGO** = **Color(0.29, 0, 0.51, 1)** --- Indigo color.
- - **IVORY** = **Color(1, 1, 0.94, 1)** --- Ivory color.
- - **KHAKI** = **Color(0.94, 0.9, 0.55, 1)** --- Khaki color.
- - **LAVENDER** = **Color(0.9, 0.9, 0.98, 1)** --- Lavender color.
- - **LAVENDER_BLUSH** = **Color(1, 0.94, 0.96, 1)** --- Lavender blush color.
- - **LAWN_GREEN** = **Color(0.49, 0.99, 0, 1)** --- Lawn green color.
- - **LEMON_CHIFFON** = **Color(1, 0.98, 0.8, 1)** --- Lemon chiffon color.
- - **LIGHT_BLUE** = **Color(0.68, 0.85, 0.9, 1)** --- Light blue color.
- - **LIGHT_CORAL** = **Color(0.94, 0.5, 0.5, 1)** --- Light coral color.
- - **LIGHT_CYAN** = **Color(0.88, 1, 1, 1)** --- Light cyan color.
- - **LIGHT_GOLDENROD** = **Color(0.98, 0.98, 0.82, 1)** --- Light goldenrod color.
- - **LIGHT_GRAY** = **Color(0.83, 0.83, 0.83, 1)** --- Light gray color.
- - **LIGHT_GREEN** = **Color(0.56, 0.93, 0.56, 1)** --- Light green color.
- - **LIGHT_PINK** = **Color(1, 0.71, 0.76, 1)** --- Light pink color.
- - **LIGHT_SALMON** = **Color(1, 0.63, 0.48, 1)** --- Light salmon color.
- - **LIGHT_SEA_GREEN** = **Color(0.13, 0.7, 0.67, 1)** --- Light sea green color.
- - **LIGHT_SKY_BLUE** = **Color(0.53, 0.81, 0.98, 1)** --- Light sky blue color.
- - **LIGHT_SLATE_GRAY** = **Color(0.47, 0.53, 0.6, 1)** --- Light slate gray color.
- - **LIGHT_STEEL_BLUE** = **Color(0.69, 0.77, 0.87, 1)** --- Light steel blue color.
- - **LIGHT_YELLOW** = **Color(1, 1, 0.88, 1)** --- Light yellow color.
- - **LIME** = **Color(0, 1, 0, 1)** --- Lime color.
- - **LIME_GREEN** = **Color(0.2, 0.8, 0.2, 1)** --- Lime green color.
- - **LINEN** = **Color(0.98, 0.94, 0.9, 1)** --- Linen color.
- - **MAGENTA** = **Color(1, 0, 1, 1)** --- Magenta color.
- - **MAROON** = **Color(0.69, 0.19, 0.38, 1)** --- Maroon color.
- - **MEDIUM_AQUAMARINE** = **Color(0.4, 0.8, 0.67, 1)** --- Medium aquamarine color.
- - **MEDIUM_BLUE** = **Color(0, 0, 0.8, 1)** --- Medium blue color.
- - **MEDIUM_ORCHID** = **Color(0.73, 0.33, 0.83, 1)** --- Medium orchid color.
- - **MEDIUM_PURPLE** = **Color(0.58, 0.44, 0.86, 1)** --- Medium purple color.
- - **MEDIUM_SEA_GREEN** = **Color(0.24, 0.7, 0.44, 1)** --- Medium sea green color.
- - **MEDIUM_SLATE_BLUE** = **Color(0.48, 0.41, 0.93, 1)** --- Medium slate blue color.
- - **MEDIUM_SPRING_GREEN** = **Color(0, 0.98, 0.6, 1)** --- Medium spring green color.
- - **MEDIUM_TURQUOISE** = **Color(0.28, 0.82, 0.8, 1)** --- Medium turquoise color.
- - **MEDIUM_VIOLET_RED** = **Color(0.78, 0.08, 0.52, 1)** --- Medium violet red color.
- - **MIDNIGHT_BLUE** = **Color(0.1, 0.1, 0.44, 1)** --- Midnight blue color.
- - **MINT_CREAM** = **Color(0.96, 1, 0.98, 1)** --- Mint cream color.
- - **MISTY_ROSE** = **Color(1, 0.89, 0.88, 1)** --- Misty rose color.
- - **MOCCASIN** = **Color(1, 0.89, 0.71, 1)** --- Moccasin color.
- - **NAVAJO_WHITE** = **Color(1, 0.87, 0.68, 1)** --- Navajo white color.
- - **NAVY_BLUE** = **Color(0, 0, 0.5, 1)** --- Navy blue color.
- - **OLD_LACE** = **Color(0.99, 0.96, 0.9, 1)** --- Old lace color.
- - **OLIVE** = **Color(0.5, 0.5, 0, 1)** --- Olive color.
- - **OLIVE_DRAB** = **Color(0.42, 0.56, 0.14, 1)** --- Olive drab color.
- - **ORANGE** = **Color(1, 0.65, 0, 1)** --- Orange color.
- - **ORANGE_RED** = **Color(1, 0.27, 0, 1)** --- Orange red color.
- - **ORCHID** = **Color(0.85, 0.44, 0.84, 1)** --- Orchid color.
- - **PALE_GOLDENROD** = **Color(0.93, 0.91, 0.67, 1)** --- Pale goldenrod color.
- - **PALE_GREEN** = **Color(0.6, 0.98, 0.6, 1)** --- Pale green color.
- - **PALE_TURQUOISE** = **Color(0.69, 0.93, 0.93, 1)** --- Pale turquoise color.
- - **PALE_VIOLET_RED** = **Color(0.86, 0.44, 0.58, 1)** --- Pale violet red color.
- - **PAPAYA_WHIP** = **Color(1, 0.94, 0.84, 1)** --- Papaya whip color.
- - **PEACH_PUFF** = **Color(1, 0.85, 0.73, 1)** --- Peach puff color.
- - **PERU** = **Color(0.8, 0.52, 0.25, 1)** --- Peru color.
- - **PINK** = **Color(1, 0.75, 0.8, 1)** --- Pink color.
- - **PLUM** = **Color(0.87, 0.63, 0.87, 1)** --- Plum color.
- - **POWDER_BLUE** = **Color(0.69, 0.88, 0.9, 1)** --- Powder blue color.
- - **PURPLE** = **Color(0.63, 0.13, 0.94, 1)** --- Purple color.
- - **REBECCA_PURPLE** = **Color(0.4, 0.2, 0.6, 1)** --- Rebecca purple color.
- - **RED** = **Color(1, 0, 0, 1)** --- Red color.
- - **ROSY_BROWN** = **Color(0.74, 0.56, 0.56, 1)** --- Rosy brown color.
- - **ROYAL_BLUE** = **Color(0.25, 0.41, 0.88, 1)** --- Royal blue color.
- - **SADDLE_BROWN** = **Color(0.55, 0.27, 0.07, 1)** --- Saddle brown color.
- - **SALMON** = **Color(0.98, 0.5, 0.45, 1)** --- Salmon color.
- - **SANDY_BROWN** = **Color(0.96, 0.64, 0.38, 1)** --- Sandy brown color.
- - **SEA_GREEN** = **Color(0.18, 0.55, 0.34, 1)** --- Sea green color.
- - **SEASHELL** = **Color(1, 0.96, 0.93, 1)** --- Seashell color.
- - **SIENNA** = **Color(0.63, 0.32, 0.18, 1)** --- Sienna color.
- - **SILVER** = **Color(0.75, 0.75, 0.75, 1)** --- Silver color.
- - **SKY_BLUE** = **Color(0.53, 0.81, 0.92, 1)** --- Sky blue color.
- - **SLATE_BLUE** = **Color(0.42, 0.35, 0.8, 1)** --- Slate blue color.
- - **SLATE_GRAY** = **Color(0.44, 0.5, 0.56, 1)** --- Slate gray color.
- - **SNOW** = **Color(1, 0.98, 0.98, 1)** --- Snow color.
- - **SPRING_GREEN** = **Color(0, 1, 0.5, 1)** --- Spring green color.
- - **STEEL_BLUE** = **Color(0.27, 0.51, 0.71, 1)** --- Steel blue color.
- - **TAN** = **Color(0.82, 0.71, 0.55, 1)** --- Tan color.
- - **TEAL** = **Color(0, 0.5, 0.5, 1)** --- Teal color.
- - **THISTLE** = **Color(0.85, 0.75, 0.85, 1)** --- Thistle color.
- - **TOMATO** = **Color(1, 0.39, 0.28, 1)** --- Tomato color.
- - **TRANSPARENT** = **Color(1, 1, 1, 0)** --- Transparent color (white with zero alpha).
- - **TURQUOISE** = **Color(0.25, 0.88, 0.82, 1)** --- Turquoise color.
- - **VIOLET** = **Color(0.93, 0.51, 0.93, 1)** --- Violet color.
- - **WEB_GRAY** = **Color(0.5, 0.5, 0.5, 1)** --- Web gray color.
- - **WEB_GREEN** = **Color(0, 0.5, 0, 1)** --- Web green color.
- - **WEB_MAROON** = **Color(0.5, 0, 0, 1)** --- Web maroon color.
- - **WEB_PURPLE** = **Color(0.5, 0, 0.5, 1)** --- Web purple color.
- - **WHEAT** = **Color(0.96, 0.87, 0.7, 1)** --- Wheat color.
- - **WHITE** = **Color(1, 1, 1, 1)** --- White color.
- - **WHITE_SMOKE** = **Color(0.96, 0.96, 0.96, 1)** --- White smoke color.
- - **YELLOW** = **Color(1, 1, 0, 1)** --- Yellow color.
- - **YELLOW_GREEN** = **Color(0.6, 0.8, 0.2, 1)** --- Yellow green color.
- Property Descriptions
- ---------------------
- .. _class_Color_property_a:
- - :ref:`float<class_float>` **a**
- +-----------+---------+
- | *Default* | ``1.0`` |
- +-----------+---------+
- The color's alpha (transparency) component, typically on the range of 0 to 1.
- ----
- .. _class_Color_property_a8:
- - :ref:`int<class_int>` **a8**
- +-----------+---------+
- | *Default* | ``255`` |
- +-----------+---------+
- Wrapper for :ref:`a<class_Color_property_a>` that uses the range 0 to 255 instead of 0 to 1.
- ----
- .. _class_Color_property_b:
- - :ref:`float<class_float>` **b**
- +-----------+---------+
- | *Default* | ``0.0`` |
- +-----------+---------+
- The color's blue component, typically on the range of 0 to 1.
- ----
- .. _class_Color_property_b8:
- - :ref:`int<class_int>` **b8**
- +-----------+-------+
- | *Default* | ``0`` |
- +-----------+-------+
- Wrapper for :ref:`b<class_Color_property_b>` that uses the range 0 to 255 instead of 0 to 1.
- ----
- .. _class_Color_property_g:
- - :ref:`float<class_float>` **g**
- +-----------+---------+
- | *Default* | ``0.0`` |
- +-----------+---------+
- The color's green component, typically on the range of 0 to 1.
- ----
- .. _class_Color_property_g8:
- - :ref:`int<class_int>` **g8**
- +-----------+-------+
- | *Default* | ``0`` |
- +-----------+-------+
- Wrapper for :ref:`g<class_Color_property_g>` that uses the range 0 to 255 instead of 0 to 1.
- ----
- .. _class_Color_property_h:
- - :ref:`float<class_float>` **h**
- +-----------+---------+
- | *Default* | ``0.0`` |
- +-----------+---------+
- The HSV hue of this color, on the range 0 to 1.
- ----
- .. _class_Color_property_r:
- - :ref:`float<class_float>` **r**
- +-----------+---------+
- | *Default* | ``0.0`` |
- +-----------+---------+
- The color's red component, typically on the range of 0 to 1.
- ----
- .. _class_Color_property_r8:
- - :ref:`int<class_int>` **r8**
- +-----------+-------+
- | *Default* | ``0`` |
- +-----------+-------+
- Wrapper for :ref:`r<class_Color_property_r>` that uses the range 0 to 255 instead of 0 to 1.
- ----
- .. _class_Color_property_s:
- - :ref:`float<class_float>` **s**
- +-----------+---------+
- | *Default* | ``0.0`` |
- +-----------+---------+
- The HSV saturation of this color, on the range 0 to 1.
- ----
- .. _class_Color_property_v:
- - :ref:`float<class_float>` **v**
- +-----------+---------+
- | *Default* | ``0.0`` |
- +-----------+---------+
- The HSV value (brightness) of this color, on the range 0 to 1.
- Constructor Descriptions
- ------------------------
- .. _class_Color_constructor_Color:
- - :ref:`Color<class_Color>` **Color** **(** **)**
- Constructs a default-initialized ``Color`` with all components set to ``0``.
- ----
- - :ref:`Color<class_Color>` **Color** **(** :ref:`Color<class_Color>` from, :ref:`float<class_float>` alpha **)**
- Constructs a ``Color`` from an existing color, but with a custom alpha value.
- .. tabs::
- .. code-tab:: gdscript
- var red = Color(Color.red, 0.5) # 50% transparent red.
- .. code-tab:: csharp
- var red = new Color(Colors.Red, 0.5f); // 50% transparent red.
- ----
- - :ref:`Color<class_Color>` **Color** **(** :ref:`Color<class_Color>` from **)**
- Constructs a ``Color`` as a copy of the given ``Color``.
- ----
- - :ref:`Color<class_Color>` **Color** **(** :ref:`String<class_String>` code **)**
- Constructs a ``Color`` either from an HTML color code or from a standardized color name. Supported color names are the same as the constants.
- ----
- - :ref:`Color<class_Color>` **Color** **(** :ref:`String<class_String>` code, :ref:`float<class_float>` alpha **)**
- Constructs a ``Color`` either from an HTML color code or from a standardized color name, with ``alpha`` on the range of 0 to 1. Supported color names are the same as the constants.
- ----
- - :ref:`Color<class_Color>` **Color** **(** :ref:`float<class_float>` r, :ref:`float<class_float>` g, :ref:`float<class_float>` b **)**
- Constructs a ``Color`` from RGB values, typically between 0 and 1. Alpha will be 1.
- .. tabs::
- .. code-tab:: gdscript
- var color = Color(0.2, 1.0, 0.7) # Similar to `Color8(51, 255, 178, 255)`
- .. code-tab:: csharp
- var color = new Color(0.2f, 1.0f, 0.7f); // Similar to `Color.Color8(51, 255, 178, 255)`
- ----
- - :ref:`Color<class_Color>` **Color** **(** :ref:`float<class_float>` r, :ref:`float<class_float>` g, :ref:`float<class_float>` b, :ref:`float<class_float>` a **)**
- Constructs a ``Color`` from RGBA values, typically between 0 and 1.
- .. tabs::
- .. code-tab:: gdscript
- var color = Color(0.2, 1.0, 0.7, 0.8) # Similar to `Color8(51, 255, 178, 204)`
- .. code-tab:: csharp
- var color = new Color(0.2f, 1.0f, 0.7f, 0.8f); // Similar to `Color.Color8(51, 255, 178, 255, 204)`
- Method Descriptions
- -------------------
- .. _class_Color_method_blend:
- - :ref:`Color<class_Color>` **blend** **(** :ref:`Color<class_Color>` over **)** |const|
- Returns a new color resulting from blending this color over another. If the color is opaque, the result is also opaque. The second color may have a range of alpha values.
- .. tabs::
- .. code-tab:: gdscript
- var bg = Color(0.0, 1.0, 0.0, 0.5) # Green with alpha of 50%
- var fg = Color(1.0, 0.0, 0.0, 0.5) # Red with alpha of 50%
- var blended_color = bg.blend(fg) # Brown with alpha of 75%
- .. code-tab:: csharp
- var bg = new Color(0.0f, 1.0f, 0.0f, 0.5f); // Green with alpha of 50%
- var fg = new Color(1.0f, 0.0f, 0.0f, 0.5f); // Red with alpha of 50%
- Color blendedColor = bg.Blend(fg); // Brown with alpha of 75%
- ----
- .. _class_Color_method_clamp:
- - :ref:`Color<class_Color>` **clamp** **(** :ref:`Color<class_Color>` min=Color(0, 0, 0, 0), :ref:`Color<class_Color>` max=Color(1, 1, 1, 1) **)** |const|
- Returns a new color with all components clamped between the components of ``min`` and ``max``, by running :ref:`@GlobalScope.clamp<class_@GlobalScope_method_clamp>` on each component.
- ----
- .. _class_Color_method_darkened:
- - :ref:`Color<class_Color>` **darkened** **(** :ref:`float<class_float>` amount **)** |const|
- Returns a new color resulting from making this color darker by the specified percentage (ratio from 0 to 1).
- .. tabs::
- .. code-tab:: gdscript
- var green = Color(0.0, 1.0, 0.0)
- var darkgreen = green.darkened(0.2) # 20% darker than regular green
- .. code-tab:: csharp
- var green = new Color(0.0f, 1.0f, 0.0f);
- Color darkgreen = green.Darkened(0.2f); // 20% darker than regular green
- ----
- .. _class_Color_method_find_named_color:
- - :ref:`int<class_int>` **find_named_color** **(** :ref:`String<class_String>` name **)** |static|
- ----
- .. _class_Color_method_from_hsv:
- - :ref:`Color<class_Color>` **from_hsv** **(** :ref:`float<class_float>` h, :ref:`float<class_float>` s, :ref:`float<class_float>` v, :ref:`float<class_float>` alpha=1.0 **)** |static|
- Constructs a color from an `HSV profile <https://en.wikipedia.org/wiki/HSL_and_HSV>`__. ``h`` (hue), ``s`` (saturation), and ``v`` (value) are typically between 0 and 1.
- .. tabs::
- .. code-tab:: gdscript
- var c = Color.from_hsv(0.58, 0.5, 0.79, 0.8)
- .. code-tab:: csharp
- var c = Color.FromHsv(0.58f, 0.5f, 0.79f, 0.8f);
- ----
- .. _class_Color_method_from_rgbe9995:
- - :ref:`Color<class_Color>` **from_rgbe9995** **(** :ref:`int<class_int>` rgbe **)** |static|
- ----
- .. _class_Color_method_from_string:
- - :ref:`Color<class_Color>` **from_string** **(** :ref:`String<class_String>` str, :ref:`Color<class_Color>` default **)** |static|
- ----
- .. _class_Color_method_get_named_color:
- - :ref:`Color<class_Color>` **get_named_color** **(** :ref:`int<class_int>` idx **)** |static|
- ----
- .. _class_Color_method_get_named_color_count:
- - :ref:`int<class_int>` **get_named_color_count** **(** **)** |static|
- ----
- .. _class_Color_method_get_named_color_name:
- - :ref:`String<class_String>` **get_named_color_name** **(** :ref:`int<class_int>` idx **)** |static|
- ----
- .. _class_Color_method_hex:
- - :ref:`Color<class_Color>` **hex** **(** :ref:`int<class_int>` hex **)** |static|
- ----
- .. _class_Color_method_hex64:
- - :ref:`Color<class_Color>` **hex64** **(** :ref:`int<class_int>` hex **)** |static|
- ----
- .. _class_Color_method_html:
- - :ref:`Color<class_Color>` **html** **(** :ref:`String<class_String>` rgba **)** |static|
- ----
- .. _class_Color_method_html_is_valid:
- - :ref:`bool<class_bool>` **html_is_valid** **(** :ref:`String<class_String>` color **)** |static|
- ----
- .. _class_Color_method_inverted:
- - :ref:`Color<class_Color>` **inverted** **(** **)** |const|
- Returns the inverted color ``(1 - r, 1 - g, 1 - b, a)``.
- .. tabs::
- .. code-tab:: gdscript
- var color = Color(0.3, 0.4, 0.9)
- var inverted_color = color.inverted() # Equivalent to `Color(0.7, 0.6, 0.1)`
- .. code-tab:: csharp
- var color = new Color(0.3f, 0.4f, 0.9f);
- Color invertedColor = color.Inverted(); // Equivalent to `new Color(0.7f, 0.6f, 0.1f)`
- ----
- .. _class_Color_method_is_equal_approx:
- - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`Color<class_Color>` to **)** |const|
- Returns ``true`` if this color and ``color`` are approximately equal, by running :ref:`@GlobalScope.is_equal_approx<class_@GlobalScope_method_is_equal_approx>` on each component.
- ----
- .. _class_Color_method_lerp:
- - :ref:`Color<class_Color>` **lerp** **(** :ref:`Color<class_Color>` to, :ref:`float<class_float>` weight **)** |const|
- Returns the linear interpolation with another color. The interpolation factor ``weight`` is between 0 and 1.
- .. tabs::
- .. code-tab:: gdscript
- var c1 = Color(1.0, 0.0, 0.0)
- var c2 = Color(0.0, 1.0, 0.0)
- var lerp_color = c1.lerp(c2, 0.5) # Equivalent to `Color(0.5, 0.5, 0.0)`
- .. code-tab:: csharp
- var c1 = new Color(1.0f, 0.0f, 0.0f);
- var c2 = new Color(0.0f, 1.0f, 0.0f);
- Color lerpColor = c1.Lerp(c2, 0.5f); // Equivalent to `new Color(0.5f, 0.5f, 0.0f)`
- ----
- .. _class_Color_method_lightened:
- - :ref:`Color<class_Color>` **lightened** **(** :ref:`float<class_float>` amount **)** |const|
- Returns a new color resulting from making this color lighter by the specified percentage (ratio from 0 to 1).
- .. tabs::
- .. code-tab:: gdscript
- var green = Color(0.0, 1.0, 0.0)
- var lightgreen = green.lightened(0.2) # 20% lighter than regular green
- .. code-tab:: csharp
- var green = new Color(0.0f, 1.0f, 0.0f);
- Color lightgreen = green.Lightened(0.2f); // 20% lighter than regular green
- ----
- .. _class_Color_method_to_abgr32:
- - :ref:`int<class_int>` **to_abgr32** **(** **)** |const|
- Returns the color converted to a 32-bit integer in ABGR format (each byte represents a color channel). ABGR is the reversed version of the default format.
- .. tabs::
- .. code-tab:: gdscript
- var color = Color(1, 0.5, 0.2)
- print(color.to_abgr32()) # Prints 4281565439
- .. code-tab:: csharp
- var color = new Color(1.0f, 0.5f, 0.2f);
- GD.Print(color.ToAbgr32()); // Prints 4281565439
- ----
- .. _class_Color_method_to_abgr64:
- - :ref:`int<class_int>` **to_abgr64** **(** **)** |const|
- Returns the color converted to a 64-bit integer in ABGR format (each word represents a color channel). ABGR is the reversed version of the default format.
- .. tabs::
- .. code-tab:: gdscript
- var color = Color(1, 0.5, 0.2)
- print(color.to_abgr64()) # Prints -225178692812801
- .. code-tab:: csharp
- var color = new Color(1.0f, 0.5f, 0.2f);
- GD.Print(color.ToAbgr64()); // Prints -225178692812801
- ----
- .. _class_Color_method_to_argb32:
- - :ref:`int<class_int>` **to_argb32** **(** **)** |const|
- Returns the color converted to a 32-bit integer in ARGB format (each byte represents a color channel). ARGB is more compatible with DirectX.
- .. tabs::
- .. code-tab:: gdscript
- var color = Color(1, 0.5, 0.2)
- print(color.to_argb32()) # Prints 4294934323
- .. code-tab:: csharp
- var color = new Color(1.0f, 0.5f, 0.2f);
- GD.Print(color.ToArgb32()); // Prints 4294934323
- ----
- .. _class_Color_method_to_argb64:
- - :ref:`int<class_int>` **to_argb64** **(** **)** |const|
- Returns the color converted to a 64-bit integer in ARGB format (each word represents a color channel). ARGB is more compatible with DirectX.
- .. tabs::
- .. code-tab:: gdscript
- var color = Color(1, 0.5, 0.2)
- print(color.to_argb64()) # Prints -2147470541
- .. code-tab:: csharp
- var color = new Color(1.0f, 0.5f, 0.2f);
- GD.Print(color.ToArgb64()); // Prints -2147470541
- ----
- .. _class_Color_method_to_html:
- - :ref:`String<class_String>` **to_html** **(** :ref:`bool<class_bool>` with_alpha=true **)** |const|
- Returns the color converted to an HTML hexadecimal color string in RGBA format (ex: ``ff34f822``).
- Setting ``with_alpha`` to ``false`` excludes alpha from the hexadecimal string (and uses RGB instead of RGBA format).
- .. tabs::
- .. code-tab:: gdscript
- var color = Color(1, 1, 1, 0.5)
- var with_alpha = color.to_html() # Returns "ffffff7f"
- var without_alpha = color.to_html(false) # Returns "ffffff"
- .. code-tab:: csharp
- var color = new Color(1, 1, 1, 0.5f);
- String withAlpha = color.ToHtml(); // Returns "ffffff7f"
- String withoutAlpha = color.ToHtml(false); // Returns "ffffff"
- ----
- .. _class_Color_method_to_rgba32:
- - :ref:`int<class_int>` **to_rgba32** **(** **)** |const|
- Returns the color converted to a 32-bit integer in RGBA format (each byte represents a color channel). RGBA is Godot's default format.
- .. tabs::
- .. code-tab:: gdscript
- var color = Color(1, 0.5, 0.2)
- print(color.to_rgba32()) # Prints 4286526463
- .. code-tab:: csharp
- var color = new Color(1, 0.5f, 0.2f);
- GD.Print(color.ToRgba32()); // Prints 4286526463
- ----
- .. _class_Color_method_to_rgba64:
- - :ref:`int<class_int>` **to_rgba64** **(** **)** |const|
- Returns the color converted to a 64-bit integer in RGBA format (each word represents a color channel). RGBA is Godot's default format.
- .. tabs::
- .. code-tab:: gdscript
- var color = Color(1, 0.5, 0.2)
- print(color.to_rgba64()) # Prints -140736629309441
- .. code-tab:: csharp
- var color = new Color(1, 0.5f, 0.2f);
- GD.Print(color.ToRgba64()); // Prints -140736629309441
- Operator Descriptions
- ---------------------
- .. _class_Color_operator_neq_bool:
- - :ref:`bool<class_bool>` **operator !=** **(** **)**
- ----
- - :ref:`bool<class_bool>` **operator !=** **(** :ref:`Color<class_Color>` right **)**
- Returns ``true`` if the colors are not equal.
- **Note:** Due to floating-point precision errors, consider using :ref:`is_equal_approx<class_Color_method_is_equal_approx>` instead, which is more reliable.
- ----
- .. _class_Color_operator_mul_Color:
- - :ref:`Color<class_Color>` **operator *** **(** :ref:`Color<class_Color>` right **)**
- Multiplies each component of the ``Color`` by the components of the given ``Color``.
- ----
- - :ref:`Color<class_Color>` **operator *** **(** :ref:`float<class_float>` right **)**
- Multiplies each component of the ``Color`` by the given :ref:`float<class_float>`.
- ----
- - :ref:`Color<class_Color>` **operator *** **(** :ref:`int<class_int>` right **)**
- Multiplies each component of the ``Color`` by the given :ref:`int<class_int>`.
- ----
- .. _class_Color_operator_sum_Color:
- - :ref:`Color<class_Color>` **operator +** **(** :ref:`Color<class_Color>` right **)**
- Adds each component of the ``Color`` with the components of the given ``Color``.
- ----
- .. _class_Color_operator_dif_Color:
- - :ref:`Color<class_Color>` **operator -** **(** :ref:`Color<class_Color>` right **)**
- Subtracts each component of the ``Color`` by the components of the given ``Color``.
- ----
- .. _class_Color_operator_div_Color:
- - :ref:`Color<class_Color>` **operator /** **(** :ref:`Color<class_Color>` right **)**
- Divides each component of the ``Color`` by the components of the given ``Color``.
- ----
- - :ref:`Color<class_Color>` **operator /** **(** :ref:`float<class_float>` right **)**
- Divides each component of the ``Color`` by the given :ref:`float<class_float>`.
- ----
- - :ref:`Color<class_Color>` **operator /** **(** :ref:`int<class_int>` right **)**
- Divides each component of the ``Color`` by the given :ref:`int<class_int>`.
- ----
- .. _class_Color_operator_eq_bool:
- - :ref:`bool<class_bool>` **operator ==** **(** **)**
- ----
- - :ref:`bool<class_bool>` **operator ==** **(** :ref:`Color<class_Color>` right **)**
- Returns ``true`` if the colors are exactly equal.
- **Note:** Due to floating-point precision errors, consider using :ref:`is_equal_approx<class_Color_method_is_equal_approx>` instead, which is more reliable.
- ----
- .. _class_Color_operator_idx_float:
- - :ref:`float<class_float>` **operator []** **(** :ref:`int<class_int>` index **)**
- Access color components using their index. ``c[0]`` is equivalent to ``c.r``, ``c[1]`` is equivalent to ``c.g``, ``c[2]`` is equivalent to ``c.b``, and ``c[3]`` is equivalent to ``c.a``.
- ----
- .. _class_Color_operator_unplus_Color:
- - :ref:`Color<class_Color>` **operator unary+** **(** **)**
- Returns the same value as if the ``+`` was not there. Unary ``+`` does nothing, but sometimes it can make your code more readable.
- ----
- .. _class_Color_operator_unminus_Color:
- - :ref:`Color<class_Color>` **operator unary-** **(** **)**
- Inverts the given color. This is equivalent to ``Color.WHITE - c`` or ``Color(1 - c.r, 1 - c.g, 1 - c.b, 1 - c.a)``.
- .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
- .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
- .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
- .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
- .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
- .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
|