[{"element_type":"text","content":"\n\u003cp\u003e\u003cem\u003eA CircuitPython Community Bundle color palette and list brightness setter and normalizer tool.\u003c/em\u003e\u003c/p\u003e\n","metadata":{}},{"element_type":"text","content":"\n\u003cp\u003e\u003cspan\u003e\u003cem\u003ePaletteFader\u003c/em\u003e is a CircuitPython helper class for brightness-adjusting color lists and displayio palettes. Normalization is optionally applied to the palette prior to brightness and gamma adjustments. Transparency index values are preserved and associated with the adjusted palette. Creates an adjusted displayio color palette object (\u003c/span\u003e\u003ccode\u003edisplayio.Palette\u003c/code\u003e\u003cspan\u003e) property that can also be read as a color list.\u003c/span\u003e\u003c/p\u003e\n","metadata":{}},{"element_type":"text","content":"\n\u003cp\u003e\u003cspan\u003eTwo versions of \u003cem\u003ePaletteFader\u003c/em\u003e are contained in the \u003c/span\u003e\u003ccode\u003ecedargrove_palettefader\u003c/code\u003e\u003cspan\u003e package folder, \u003c/span\u003e\u003ccode\u003epalettefader\u003c/code\u003e\u003cspan\u003e and \u003c/span\u003e\u003ccode\u003epalettefader_ulab\u003c/code\u003e\u003cspan\u003e. The faster of the two is \u003c/span\u003e\u003ccode\u003epalettefader_ulab\u003c/code\u003e\u003cspan\u003e, requiring CircuitPython with \u003c/span\u003e\u003ccode\u003eulab\u003c/code\u003e\u003cspan\u003e as a built-in module. Certain CircuitPython distributions and versions may not support \u003c/span\u003eulab\u003cspan\u003e; check your specific implementation. For example, \u003c/span\u003e\u003ccode\u003eulab\u003c/code\u003e\u003cspan\u003e is not included in MatrixPortal distributions after CircuitPython version 7.3.2.\u003c/span\u003e\u003c/p\u003e\n","metadata":{}},{"element_type":"text","content":"\n\u003ch2\u003eInstalling PaletteFader to a Connected CircuitPython Device with Circup\u003c/h2\u003e\n\u003cp\u003eMake sure that you have\u003cspan\u003e \u003c/span\u003ecircup\u003cspan\u003e \u003c/span\u003einstalled in your Python environment. Install it with the following command if necessary:\u003c/p\u003e\n\u003cpre class=\"code shell literal-block\"\u003epip3 install circup\n\u003c/pre\u003e\n\u003cp\u003eWith\u003cspan\u003e \u003c/span\u003ecircup\u003cspan\u003e \u003c/span\u003einstalled and your CircuitPython device connected use the following command to install:\u003c/p\u003e\n\u003cpre class=\"code shell literal-block\"\u003ecircup install cedargrove_palettefader\n\u003c/pre\u003e\n\u003cp\u003eOr the following command to update an existing version:\u003c/p\u003e\n\u003cpre class=\"code shell literal-block\"\u003ecircup update\n\u003c/pre\u003e\n","metadata":{}},{"element_type":"text","content":"\n        \u003ch2\u003eUsage Examples\u003c/h2\u003e\n\u003cpre class=\"code py literal-block\"\u003e\u003ccode\u003e\u003cspan class=\"comment single\"\u003e# For CircuitPython distributions without ulab (such as the MatrixPortal)\u003c/span\u003e\n\u003cspan class=\"keyword namespace\"\u003efrom\u003c/span\u003e \u003cspan class=\"name namespace\"\u003ecedargrove_palettefader.palettefader\u003c/span\u003e \u003cspan class=\"keyword namespace\"\u003eimport\u003c/span\u003e \u003cspan class=\"name\"\u003ePaletteFader\u003c/span\u003e\n\n\u003cspan class=\"comment single\"\u003e# Instantiate PaletteFader\u003c/span\u003e\n\u003cspan class=\"name\"\u003efaded_object\u003c/span\u003e \u003cspan class=\"operator\"\u003e=\u003c/span\u003e \u003cspan class=\"name\"\u003ePaletteFader\u003c/span\u003e\u003cspan class=\"punctuation\"\u003e(\u003c/span\u003e\u003cspan class=\"name\"\u003esource_palette\u003c/span\u003e\u003cspan class=\"operator\"\u003e=\u003c/span\u003e\u003cspan class=\"name\"\u003eobject_palette\u003c/span\u003e\u003cspan class=\"punctuation\"\u003e,\u003c/span\u003e \u003cspan class=\"name\"\u003ebrightness\u003c/span\u003e\u003cspan class=\"operator\"\u003e=\u003c/span\u003e\u003cspan class=\"literal number float\"\u003e0.5\u003c/span\u003e\u003cspan class=\"punctuation\"\u003e)\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\n\u003cpre class=\"code py literal-block\"\u003e\u003ccode\u003e\u003cspan class=\"comment single\"\u003e# For CircuitPython distributions with ulab\u003c/span\u003e\n\u003cspan class=\"keyword namespace\"\u003efrom\u003c/span\u003e \u003cspan class=\"name namespace\"\u003ecedargrove_palettefader.palettefader_ulab\u003c/span\u003e \u003cspan class=\"keyword namespace\"\u003eimport\u003c/span\u003e \u003cspan class=\"name\"\u003ePaletteFader\u003c/span\u003e\n\n\u003cspan class=\"comment single\"\u003e# Instantiate PaletteFader\u003c/span\u003e\n\u003cspan class=\"name\"\u003efaded_object\u003c/span\u003e \u003cspan class=\"operator\"\u003e=\u003c/span\u003e \u003cspan class=\"name\"\u003ePaletteFader\u003c/span\u003e\u003cspan class=\"punctuation\"\u003e(\u003c/span\u003e\u003cspan class=\"name\"\u003esource_palette\u003c/span\u003e\u003cspan class=\"operator\"\u003e=\u003c/span\u003e\u003cspan class=\"name\"\u003eobject_palette\u003c/span\u003e\u003cspan class=\"punctuation\"\u003e,\u003c/span\u003e \u003cspan class=\"name\"\u003ebrightness\u003c/span\u003e\u003cspan class=\"operator\"\u003e=\u003c/span\u003e\u003cspan class=\"literal number float\"\u003e0.5\u003c/span\u003e\u003cspan class=\"punctuation\"\u003e)\u003c/span\u003e\n\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003e\u003ccode\u003epalettefader_simpletest.py\u003c/code\u003e\u003cspan\u003e \u003c/span\u003eand other examples can be found in the\u003cspan\u003e \u003c/span\u003e\u003ccode\u003eexamples\u003c/code\u003e\u003cspan\u003e \u003c/span\u003efolder.\u003c/p\u003e\n      ","metadata":{}},{"element_type":"text","content":"\n        \u003ch2\u003eDocumentation\u003c/h2\u003e\n\u003cpre\u003e\u003cspan\u003e\u003cbr\u003e\u003c/span\u003e\u003cspan\u003e\u003ca title=\"PaletteFader API documentation\" href=\"https://github.com/CedarGroveStudios/CircuitPython_PaletteFader/blob/main/media/pseudo_rtd_cedargrove_palettefader.pdf\" target=\"_blank\"\u003ePaletteFader API documentation\u003c/a\u003e\u003cbr\u003e\u003cbr\u003e\u003ca title=\"PaletteFader GitHub Repository\" href=\"https://github.com/CedarGroveStudios/CircuitPython_PaletteFader.git\" target=\"_blank\"\u003ePaletteFader GitHub Repository\u003c/a\u003e\u003cbr\u003e\u003cbr\u003e\u003c/span\u003e\u003c/pre\u003e\n      ","metadata":{}},{"element_type":"user_image","content":"https://cdn-learn.adafruit.com/user_assets/assets/000/000/056/original/PaletteFader_Class_description.jpeg?1671321582","metadata":{"caption":"PaletteFader Class Description"}},{"element_type":"user_image","content":"https://cdn-learn.adafruit.com/user_assets/assets/000/000/057/original/PaletteFader_Class_internals.jpeg?1671321702","metadata":{"caption":"PaletteFader Class Internals"}}]