ManimPango 0.4.3__cp39-cp39-win32.whl → 1.0.0a2__cp39-cp39-win32.whl

{ManimPango-0.4.3.dist-info → ManimPango-1.0.0a2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ManimPango
-Version: 0.4.3
+Version: 1.0.0a2
 Summary: Bindings for Pango for using with Manim.
 Home-page: https://manimpango.manim.community/
 Author: Naveen M K
@@ -24,7 +24,7 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Cython
-Requires-Python: >=3.7
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: LICENSE.win32

ManimPango-1.0.0a2.dist-info/RECORD

@@ -0,0 +1,85 @@
+manimpango/__init__.py,sha256=ELRxGogKS5uPGatJzGmPAaj068ZOO-Sze88nenz4RE8,1153
+manimpango/_distributor_init.py,sha256=z3NAjz5oUeNo6Pbk6zuA9Lfi71rB3ucus0XDpZ3nSrk,1233
+manimpango/_version.py,sha256=Vq7ueDz68EUGVviee7EKuGy1u4lkrTzFM_-KtqwbrfY,50
+manimpango/buffer.pxi,sha256=NklqLNZ0462IL9CpZc9AFG8c1N2ULr6JAURJdhegQng,419
+manimpango/cmanimpango.c,sha256=I70k5es0wpKk27irx7rANAaNUdeVm7L1dQvWWFxCxVs,418073
+manimpango/cmanimpango.cp39-win32.pyd,sha256=fnodAVOFTUTX3q1UpK5kivYgjhVDeM82aLEW3WcqaH4,61440
+manimpango/cmanimpango.pxd,sha256=Apb6qZMqtkL9ldE_nMxVtdsnTH2tkmYt94lrhsB0Qwc,65
+manimpango/cmanimpango.pyx,sha256=f3wr3BpOmIsr1yi7jQsaKv9ntyKyzRWJmbNo8JPLqig,10744
+manimpango/enums.c,sha256=oioIF1_bIhVCfgwMzxU8uWUqUQLb2KagidBxsfgViU4,149445
+manimpango/enums.cp39-win32.pyd,sha256=bkvRKCJgtADJVt6lVHnui36JiCpm0yIo5-ByzLL3BBc,23040
+manimpango/enums.pyx,sha256=5qEKGgt3ueVXJkDKo5f_gyfOcuYCQ_j3sHKuXXkrO14,2370
+manimpango/exceptions.py,sha256=sg8znK3Yr_Qw_BoACd4sS3ZiWLXgsStAi1tmK-9549o,146
+manimpango/register_font.c,sha256=hJ4G1WlNZ1bD-Y7jYOYKsk7MVltjwDzaFa0fLMFM_6w,199324
+manimpango/register_font.cp39-win32.pyd,sha256=pOCautzNcBzkGw5wCDBMShve0c4YsJWioc9YoDSRvDI,31232
+manimpango/register_font.pxd,sha256=8iZpMnQenfTdUUxhNdesi21GeGjHX07pvIWiQom6Jio,1653
+manimpango/register_font.pyx,sha256=H_fe5SLNue6H3vpB01aindxxNQEbtG7jiDhXCk0PZTo,7548
+manimpango/.libs/CORE_MANIM_cairo-2.dll,sha256=gcguaZqS7ELKV1ge1at322p4BtOe3_1Un8xlO70yC9U,753664
+manimpango/.libs/CORE_MANIM_cairo-gobject-2.dll,sha256=wJNHV_0I0hfQI6ejLH68Nx3V4TsoBFLU1XY-OTQZpbA,23040
+manimpango/.libs/CORE_MANIM_cairo-script-interpreter-2.dll,sha256=dpOR0Afc6O89rf8A-vwXz9ByXTqR1vJYTxs-_eThi6k,91136
+manimpango/.libs/CORE_MANIM_expat.dll,sha256=_VAIS-Rv5ktQlv3KheRgIkk8fnL15DKNb_4e6EJLyqU,115712
+manimpango/.libs/CORE_MANIM_ffi-7.dll,sha256=lXk1Gs2PbEsVaQIqOQMG9znfCld7eNIXs8NSo1pwP3A,22016
+manimpango/.libs/CORE_MANIM_fontconfig-1.dll,sha256=hy07QUGCuS32o5AMQoy7yNGxPU1dJ9oYYwG4hp3k2qI,225792
+manimpango/.libs/CORE_MANIM_freetype-6.dll,sha256=5na9-CLo9bXpLnRmhlMg7fvqqMiBaaqZs8P6wY4ueKU,517120
+manimpango/.libs/CORE_MANIM_fribidi-0.dll,sha256=94B9vV9arcywUqF6KF2RvbCaj-lqqOWXn8mp6pJzItI,111616
+manimpango/.libs/CORE_MANIM_gio-2.0-0.dll,sha256=f_hjRyG-TGA7SXX4V5iYdhPcuCheyeMUIbfL-2xsrFU,1235968
+manimpango/.libs/CORE_MANIM_glib-2.0-0.dll,sha256=8P8KAOi4aKsNetE43HyTfx1R9TUOf5r9cFbvT9lWH9Q,1291776
+manimpango/.libs/CORE_MANIM_gmodule-2.0-0.dll,sha256=LLijZJu5D6zRM_O_r0ZRUegu9KLNLIiVtBNCEw_C8Yk,15360
+manimpango/.libs/CORE_MANIM_gobject-2.0-0.dll,sha256=kz_sEFfNBIAzL-oiZ_6vdtxA2pdlVSXMY4FSnSv6eIE,244736
+manimpango/.libs/CORE_MANIM_gthread-2.0-0.dll,sha256=toRgniPdGG8WjlsPUeMGtSXt-gE30Bm6qqIQzwl-INs,9216
+manimpango/.libs/CORE_MANIM_harfbuzz-gobject.dll,sha256=2KtVy4pBEf7KQtor321nT6lTsHoY8QCrD--q-wgXDko,68096
+manimpango/.libs/CORE_MANIM_harfbuzz-subset.dll,sha256=-OQjaM0pofUZENnoVnK7gVtamzoEd_XfWF4IYeXnQCA,585728
+manimpango/.libs/CORE_MANIM_harfbuzz.dll,sha256=DS4kze2N-hIwDQ-ziI1ZAPKK4YWlCCnv3qczDiGPDoA,809984
+manimpango/.libs/CORE_MANIM_intl-8.dll,sha256=hq1CpigY9R_C15GtaE165xUw4Ak7f_gkAFY4FM6yATM,8704
+manimpango/.libs/CORE_MANIM_pango-1.0-0.dll,sha256=uWyw9AJXHs1ALm5FEu2OeaWsvK5LTO7D1tlH6SqEV64,297984
+manimpango/.libs/CORE_MANIM_pangocairo-1.0-0.dll,sha256=l42D4t3U2foWwnZvdfex-hRaskIvsSxYSlYmtuv6WtM,46080
+manimpango/.libs/CORE_MANIM_pangoft2-1.0-0.dll,sha256=IdlSTStPZVtcJcrf3nWJtnwFIw58SVXwaWani2uN1NM,61952
+manimpango/.libs/CORE_MANIM_pangowin32-1.0-0.dll,sha256=AoIotEryhwlIMrE7-hwyPPnhfy5R7WtU6oY3mBDilFM,43520
+manimpango/.libs/CORE_MANIM_pixman-1-0.dll,sha256=81A_FOT4VAjuYqjQD7GKhWXgJwf5k8t_XltiA1SLNJI,570368
+manimpango/.libs/CORE_MANIM_png16-16.dll,sha256=EK-X1ON8Bm4gZvRqgBAMGr6euNEUWmH64UtQvarkOhs,163840
+manimpango/.libs/CORE_MANIM_z.dll,sha256=YuxBjO59t-sQ0-jPE-R8ixNHGXcDghbRxObZ1zd9IIA,74752
+manimpango/attributes/__init__.py,sha256=IqbS6YvnX_5YBcvhhh-jOuqsG26hywrwWxO7rf2eMH4,10777
+manimpango/attributes/attributes.pxi,sha256=o_EAkxTXVQa-GKXmjqjRpyl3rRM2oxqI2B8nGsCPxoY,6298
+manimpango/fonts/__init__.py,sha256=ijgoYEfA6oETMQZlb613YSGc7cAuWPyM9-jxgKMMznA,4142
+manimpango/fonts/_font_desc.c,sha256=JBWffxqT0OSelbMv4dXZgUMwXRG2fCxn3gj_3-0e_ls,306216
+manimpango/fonts/_font_desc.cp39-win32.pyd,sha256=DiAy0Cs5GATuC22ezSD3v5FSiC02mykn0N8V4eftqD4,33792
+manimpango/fonts/_font_desc.pxd,sha256=f7L1fDqWEqeANGliVzPLAabpsNf_S5hYZfYAHbA0Qjw,104
+manimpango/fonts/_font_desc.pyi,sha256=5K3qwRygAb6Am9B7I7mg3HhzxSw66UJR_eAnXTc1hBM,670
+manimpango/fonts/_font_desc.pyx,sha256=XWCfWLoWm3v7RHvfC3cmwj6neD89-40KyiKO9FjCpFM,3386
+manimpango/fonts/enums.c,sha256=yryvG-ZT6qHSDVjw8cm1ij4PiXMQOBeIPjffHJ1X1Ug,145914
+manimpango/fonts/enums.cp39-win32.pyd,sha256=WTegIWc1IcjTdSZlqtX4yZrFx_Z8MpnpkD6GK95-8fc,22016
+manimpango/fonts/enums.pyi,sha256=F39pBJVtL7i74PkPcMScAWTNsprWg421XzBwrcEMR24,390
+manimpango/fonts/enums.pyx,sha256=3tpHGD28albK5_xrKMxf4xndyCggGGfBZAgtw9umh-E,2305
+manimpango/include/cairo.pxd,sha256=IhCmKOEvR8xc36M5Q7SzuQpdv1obgoXO9VjASi5QG3E,1369
+manimpango/include/glib.pxd,sha256=-rd7ww83I3unntJ7ZI1NbT25QaoGr7786DqFe5RrY8M,907
+manimpango/include/pango.pxd,sha256=ZEg-P74BE4nEvcafDldeacEpUUpGt33-QF3ZWbidAMQ,6201
+manimpango/include/pango_attributes.pxd,sha256=cJwiACUQmIAEk-26d-sKpO28Q4Fbd7V8WKJF44tfm4o,5240
+manimpango/layout/__init__.py,sha256=TPHpFluM2m8WwmBotcI5Ve6uYx3Y3Z_IvYYmnFlo8FY,7841
+manimpango/layout/_layout.c,sha256=ecy4ebf5uxiYwzFDc0h3mc6qz4nNC6WMpCzW2TrCxWQ,360782
+manimpango/layout/_layout.cp39-win32.pyd,sha256=kwU9U-P1fJB7SJPYUnUpdTUYbiVPd56EbhbH-8NZc_g,37376
+manimpango/layout/_layout.pyx,sha256=BYkon6U7KNmWgkvyxB9HfxncjhyPG2xGGLU0VsbfKd8,1784
+manimpango/layout/layout.pxi,sha256=N902NZq0ILyUnTY43yhP84WBSvQjM3bbCDwMDwStSgE,1389
+manimpango/renderer/__init__.py,sha256=krRnN0pgAQiyvnabo2Q2dHJgNK9ZpGebW6Al8TD4FIQ,191
+manimpango/renderer/cairo_utils.pxi,sha256=J-L17N5tiz87fUthMq-RBFFSU9V0_r2w8XepeFOgK0Q,2603
+manimpango/renderer/image_renderer.c,sha256=CBEYd4zeh_oU30MCalkPESgjQbBc_32MGlYMveQeN_U,521783
+manimpango/renderer/image_renderer.cp39-win32.pyd,sha256=OCiIVCTdidMPCly95r6MIjomo-qOZqIbFjwwoCTNpnI,60416
+manimpango/renderer/image_renderer.pxd,sha256=vLbnxD-KYaChrXY1w_FB-iiCJ6cE6U2ArpZHkyjuWCQ,560
+manimpango/renderer/image_renderer.pyi,sha256=zFir_N8OoPaH6Vn7Eov_E-j0J2eJCt50Icw4deC2Mcc,521
+manimpango/renderer/image_renderer.pyx,sha256=qRzHCSC8QEQFd16yMo9gOTdwiVP4LJjkX7AFXyyWosc,6757
+manimpango/renderer/svg_renderer.c,sha256=yHIhhJIRcS5W6X6tlvDOG6y5Syyl8Of9amq_jsdQ3LQ,448017
+manimpango/renderer/svg_renderer.cp39-win32.pyd,sha256=GQeFk8xmh1JW5Azlcqlf0ciwS7GgGDhSMmU_HEcFxhk,51712
+manimpango/renderer/svg_renderer.pxd,sha256=LcVuCOc4x-8ZR8GLimFLvGG-dxhhcQ3Xx7bFk6wIy1o,562
+manimpango/renderer/svg_renderer.pyi,sha256=n6NN90qhGQun7Vu1xDgUmYW7rH8PIZ5m-DZHfv4uHBo,418
+manimpango/renderer/svg_renderer.pyx,sha256=5vf8x88bDDOmlSy62EqO_Dx_dMziujhuv9JtKuIVkic,5284
+manimpango/utils/__init__.py,sha256=w3VK15PRAEtSnedU9IzOosOi18rCCLDBDs2NPP9_0d0,110
+manimpango/utils/_utils.cp39-win32.pyd,sha256=ZNDbMYPwtykGyHVCODc5hM4PFtJPjixxYApliKDFpAY,16896
+manimpango/utils/_utils.pyi,sha256=L4bczjAKJTKbq4FZercUiQEnuVOqTXbfePmp8FWbkrc,112
+manimpango/utils/utils.c,sha256=6vFOGF3PXPxhjZWsZFZcoBqLUCKJ09Ko-2TjLbjQZro,136649
+manimpango/utils/utils.py,sha256=mYBmmr0bLk72bjcPBoD10q5dIBWdI06m9Tm2J-dEXrc,1699
+manimpango/utils/utils.pyx,sha256=ydDxtOMbqNexX-IzD6ZuFLfwamsmGqSxGKyRkvZ0nsA,658
+ManimPango-1.0.0a2.dist-info/LICENSE,sha256=ZB7Op1KnTg-rYuSNFk6dIaWt5fwrfsSWTuJW8Ql55ok,1088
+ManimPango-1.0.0a2.dist-info/LICENSE.win32,sha256=XJh88_PtJqmEAfFqLLztbIcxPCJaccrFbz1w6ux-9Zg,163586
+ManimPango-1.0.0a2.dist-info/METADATA,sha256=jpQ6EtG_iXvb9kPdS32XbE2oNGFaf2p06Ds3Zk_JTlk,8600
+ManimPango-1.0.0a2.dist-info/WHEEL,sha256=1aMbN4t2zTDfBHuhuWzAfIzzQesiKpXOWwJmQwUBD2M,96
+ManimPango-1.0.0a2.dist-info/top_level.txt,sha256=_7RXNU2cbck8IbstWHzYv6YV58wtKUDBX-pmUjE6SKs,11
+ManimPango-1.0.0a2.dist-info/RECORD,,

{ManimPango-0.4.3.dist-info → ManimPango-1.0.0a2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.38.4)
+Generator: bdist_wheel (0.40.0)
 Root-Is-Purelib: false
 Tag: cp39-cp39-win32
 

manimpango/__init__.py

@@ -1,19 +1,17 @@
 # -*- coding: utf-8 -*-
-import os
 import sys
 
+from . import _distributor_init  # noqa: F401
 from ._version import __version__  # noqa: F403,F401
 
-if os.name == "nt":  # pragma: no cover
-    os.environ["PATH"] = (
-        f"{os.path.abspath(os.path.dirname(__file__))}"
-        f"{os.pathsep}"
-        f"{os.environ['PATH']}"
-    )
 try:
+    from .attributes import *  # noqa: F403,F401
     from .cmanimpango import *  # noqa: F403,F401
     from .enums import *  # noqa: F403,F401
+    from .fonts import *  # noqa: F403,F401
+    from .layout import *  # noqa: F403,F401
     from .register_font import *  # noqa: F403,F401
+    from .renderer import *  # noqa: F403,F401
 except ImportError as ie:  # pragma: no cover
     py_ver = ".".join(map(str, sys.version_info[:3]))
     msg = f"""

manimpango/_distributor_init.py

@@ -0,0 +1,36 @@
+"""
+Helper to preload windows dlls to prevent dll not found errors.
+Once a DLL is preloaded, its namespace is made available to any
+subsequent DLL. This file is created as part of the scripts that
+build the wheel.
+"""
+import glob
+import os
+
+if os.name == "nt":
+    # convention for storing / loading the DLL from
+    # ManimPango/.libs/, if present
+    basedir = os.path.dirname(__file__)
+    libs_dir = os.path.abspath(os.path.join(basedir, ".libs"))
+
+    # first add them to os.add_dll_directory
+    try:
+        if hasattr(os, "add_dll_directory"):
+            libs_dir = os.path.abspath(os.path.join(basedir, ".libs"))
+            if os.path.isdir(libs_dir):
+                os.add_dll_directory(libs_dir)
+    except Exception:
+        pass
+
+    try:
+        from ctypes import WinDLL
+    except Exception:
+        pass
+    else:
+        DLL_filenames = []
+        if os.path.isdir(libs_dir):
+            for filename in glob.glob(os.path.join(libs_dir, "*openblas*dll")):
+                # NOTE: would it change behavior to load ALL
+                # DLLs at this path vs. the name restriction?
+                WinDLL(os.path.abspath(filename))
+                DLL_filenames.append(filename)

manimpango/_version.py

@@ -1,2 +1,2 @@
 # -*- coding: utf-8 -*-
-__version__ = "0.4.3"
+__version__ = "1.0.0a2"

manimpango/attributes/__init__.py

@@ -0,0 +1,324 @@
+# -*- coding: utf-8 -*-
+from __future__ import annotations
+
+import typing as T
+
+from ..fonts.enums import Weight
+from ..utils import covert_hex_to_rbg
+
+__all__ = ["TextAttribute"]
+
+
+def _parse_color_output(val: T.Union[str, T.Iterable[int]]):
+    color_hex = None
+    red, green, blue = None, None, None
+    if isinstance(val, str):
+        color_hex = val
+    else:
+        if len(val) != 3:
+            raise ValueError("Either a Iterable of 3 items or a string must be passed.")
+        red, green, blue = val
+    if color_hex:
+        red, green, blue = covert_hex_to_rbg(color_hex)
+    if not ((0 <= red <= 65535) and (0 <= green <= 65535) and (0 <= blue <= 65535)):
+        raise ValueError("red, green, blue should be between 0 and 65535.")
+    return (red, green, blue)
+
+
+class TextAttribute:
+    """:class:`TextAttribute` defines the properties/attributes of the
+    text within a specific range of the text.
+
+
+    A :class:`TextAttribute` object can define multiple properties at
+    the same time, for example, it can change the :attr:`background_color`,
+    as well as, :attr:`foreground_color`. Also, a :class:`TextAttribute` can
+    be used for multiple times for different texts.
+    By default, an attribute has an inclusive range from ``0`` to the
+    end of the text ``-1``, ie. ``[0, -1]``.
+    """
+
+    def __init__(
+        self,
+        start_index: int = 0,
+        end_index: int = -1,
+        *,
+        allow_breaks: bool | None = None,
+        background_alpha: float | None = None,
+        background_color: T.Union[str, T.Iterable[int]] | None = None,
+        foreground_alpha: float | None = None,
+        foreground_color: T.Union[str, T.Iterable[int]] | None = None,
+        fallback: bool | None = None,
+        family: str | None = None,
+        weight: Weight | None = None,
+        line_height: float | None = None,
+    ) -> None:
+        """Initialize :class:`TextAttribute`.
+
+        Parameters
+        ----------
+        start_index : int, optional
+            The start index of the range, by default 0 (start of the string).
+        end_index : int, optional
+            End index of the range. The character at this index is not included
+            in the range, by default -1 (end of the string).
+        """
+        self.start_index = start_index
+        self.end_index = end_index
+        if allow_breaks:
+            self.allow_breaks = allow_breaks
+        if background_alpha:
+            self.background_alpha = background_alpha
+        if background_color:
+            self.background_color = background_color
+        if foreground_alpha:
+            self.foreground_alpha = foreground_alpha
+        if foreground_color:
+            self.foreground_color = foreground_color
+        if fallback:
+            self.fallback = fallback
+        if family:
+            self.family = family
+        if weight:
+            self.weight = weight
+        if line_height:
+            self.line_height = line_height
+
+    @property
+    def start_index(self) -> int:
+        """It is the end index of the range.
+
+        Raises
+        ------
+        ValueError
+            If the value is not an :class:`int`.
+        """
+        return self._start_index
+
+    @start_index.setter
+    def start_index(self, val: int) -> None:
+        if not isinstance(val, int):
+            raise ValueError("'start_index' should be an int")
+        # check if the value is negative
+        if val < 0:
+            raise ValueError("'start_index' should be a positive int")
+        self._start_index = val
+
+    @property
+    def end_index(self) -> int:
+        """It is the start of the range. The character at this index is not
+        included in the range.
+
+        Raises
+        ------
+        ValueError
+            If the value is not an :class:`int`.
+        """
+        return self._end_index
+
+    @end_index.setter
+    def end_index(self, val: int) -> None:
+        if not isinstance(val, int):
+            raise ValueError("'end_index' should be an int")
+        # check if the value is negative
+        if val < 0 and val != -1:
+            raise ValueError("'end_index' should be a positive int")
+        self._end_index = val
+
+    @property
+    def allow_breaks(self) -> T.Union[bool, None]:
+        """Whether to break text or not.
+
+        If breaks are disabled, the range will be kept in a single run,
+        as far as possible.
+        """
+        if hasattr(self, "_allow_breaks"):
+            return self._allow_breaks
+        return None
+
+    @allow_breaks.setter
+    def allow_breaks(self, val: bool) -> None:
+        self._allow_breaks = bool(val)
+
+    @property
+    def background_alpha(self) -> T.Union[float, None]:
+        """The background_alpha of the text.
+
+        Raises
+        ------
+        ValueError
+            If the value is not between 0 and 1.
+        """
+        if hasattr(self, "_background_alpha"):
+            return self._background_alpha
+        return None
+
+    @background_alpha.setter
+    def background_alpha(self, val: float) -> None:
+        if not (0 <= val <= 1):
+            raise ValueError("'val' should be between 0 and 1")
+        self._background_alpha = val
+
+    @property
+    def background_color(self) -> T.Union[T.Tuple[int], None]:
+        """The background color of the region.
+
+        If the input is a :class:`str` the value is considered as
+        string representation of color from
+        `CSS Specification <https://www.w3.org/TR/css-color-4/#named-colors>`_.
+        The color is then parsed and :class:`ValueError` is raised
+        if the color is invalid.
+
+        If the input is a :class:`collections.abc.Iterable` then the items
+        in them are parsed in the order of ``red, green, blue`` and checked
+        whether they are valid (between 0 and 65535).
+
+
+        Returns either ``None`` or a :class:`tuple` with 3 elements
+        representing red, green, blue respectively. The value of each
+        items in that tuple ranges from 0 to 65535.
+
+        Raises
+        ------
+        ValueError
+            If the value passed isn't a :class:`collections.abc.Iterable` of 3
+            elements or a string. Another condition when `ValueError` is
+            raised is when the color passed is invalid.
+
+        """
+        if hasattr(self, "_background_color"):
+            return self._background_color
+        return None
+
+    @background_color.setter
+    def background_color(self, val: T.Union[str, T.Iterable[int]]) -> None:
+        self._background_color = _parse_color_output(val)
+
+    @property
+    def foreground_alpha(self) -> T.Union[float, None]:
+        """The foreground_alpha of the text.
+
+        Raises
+        ------
+        ValueError
+            If the value is not between 0 and 1.
+        """
+        if hasattr(self, "_foreground_alpha"):
+            return self._foreground_alpha
+        return None
+
+    @foreground_alpha.setter
+    def foreground_alpha(self, val: float) -> None:
+        if not (0 <= val <= 1):
+            raise ValueError("'val' should be between 0 and 1")
+        self._foreground_alpha = val
+
+    @property
+    def foreground_color(self) -> T.Union[T.Tuple[int], None]:
+        """The foreground color attribute.
+
+        If the input is a :class:`str` the value is considered as
+        string representation of color from
+        `CSS Specification <https://www.w3.org/TR/css-color-4/#named-colors>`_.
+        The color is then parsed and :class:`ValueError` is raised
+        if the color is invalid.
+
+        If the input is a :class:`collections.abc.Iterable` then the items
+        in them are parsed in the order of ``red, green, blue`` and checked
+        whether they are valid (between 0 and 65535).
+
+
+        Returns either ``None`` or a :class:`tuple` with 3 elements
+        representing red, green, blue respectively. The value of each
+        items in that tuple ranges from 0 to 65535.
+
+        Raises
+        ------
+        ValueError
+            If the value passed isn't a :class:`collections.abc.Iterable` of 3
+            elements or a string. Another condition when `ValueError` is
+            raised is when the color passed is invalid.
+
+        """
+        if hasattr(self, "_foreground_color"):
+            return self._foreground_color
+        return None
+
+    @foreground_color.setter
+    def foreground_color(self, val: T.Union[str, T.Iterable[int]]) -> None:
+        self._foreground_color = _parse_color_output(val)
+
+    @property
+    def fallback(self) -> bool:
+        """Enable or disable fallbacks.
+
+        If fallback is disabled, characters will only be used from the
+        closest matching font on the system. No fallback will be done to
+        other fonts on the system that might contain the characters in
+        the text.
+        """
+        if hasattr(self, "_fallback"):
+            return self._fallback
+        return None
+
+    @fallback.setter
+    def fallback(self, val: bool) -> None:
+        self._fallback = bool(val)
+
+    @property
+    def family(self) -> T.Union[str, None]:
+        """The font family the text should render. Can be a comma seperated
+        list of fonts in a string.
+
+        Raises
+        ------
+        ValueError
+            If value isn't a str.
+        """
+        if hasattr(self, "_family"):
+            return self._family
+        return None
+
+    @family.setter
+    def family(self, val: str) -> None:
+        if not isinstance(val, str):
+            raise ValueError("'family' must be a string")
+        self._family = val
+
+    @property
+    def weight(self) -> T.Union[Weight, None]:
+        """The font weight of the text.
+
+        Raises
+        ------
+        ValueError
+            If value isn't a str.
+        """
+        if hasattr(self, "_weight"):
+            return self._weight
+        return None
+
+    @weight.setter
+    def weight(self, val: Weight) -> None:
+        if not isinstance(val, Weight):
+            raise ValueError("'weight' must be a Weight")
+        self._weight = val
+
+    @property
+    def line_height(self) -> T.Union[float, None]:
+        """The line height of the text.
+
+        Raises
+        ------
+        ValueError
+            If value isn't a float.
+        """
+        if hasattr(self, "_line_height"):
+            return self._line_height
+        return None
+
+    @line_height.setter
+    def line_height(self, val: float) -> None:
+        if not isinstance(val, float):
+            raise ValueError("'line_height' must be a float")
+        self._line_height = val