U gL@s$dZddlmZmZmZmZmZmZmZddl m Z ddl m Z ddl mZddlmZddlmZddlmZerdd l mZGd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZdS)z9This module contains objects related to chat backgrounds.) TYPE_CHECKINGDictFinalOptionalSequenceTupleType) constants)Document)TelegramObject)enum)parse_sequence_arg)JSONDict)BotcseZdZUdZdZejjZeeje d<ejj Z eeje d<ejj Z eeje d<dde e edfd d Zede ee d e dd fd d ZZS)BackgroundFillauBase class for Telegram BackgroundFill Objects. It can be one of: * :class:`telegram.BackgroundFillSolid` * :class:`telegram.BackgroundFillGradient` * :class:`telegram.BackgroundFillFreeformGradient` Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type` is equal. .. versionadded:: 21.2 Args: type (:obj:`str`): Type of the background fill. Can be one of: :attr:`~telegram.BackgroundFill.SOLID`, :attr:`~telegram.BackgroundFill.GRADIENT` or :attr:`~telegram.BackgroundFill.FREEFORM_GRADIENT`. Attributes: type (:obj:`str`): Type of the background fill. Can be one of: :attr:`~telegram.BackgroundFill.SOLID`, :attr:`~telegram.BackgroundFill.GRADIENT` or :attr:`~telegram.BackgroundFill.FREEFORM_GRADIENT`. typeSOLIDGRADIENTFREEFORM_GRADIENTN api_kwargsrrcs6tj|dttj|||_|jf|_|dSNr) super__init__r get_memberr BackgroundFillTyper _id_attrs_freezeselfrr __class__r$r$r"r%r.fsr.cs:eZdZdZdZddeeeeedfddZZ S)r/a~ The background is a gradient fill. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`top_color`, :attr:`bottom_color` and :attr:`rotation_angle` are equal. .. versionadded:: 21.2 Args: top_color (:obj:`int`): Top color of the gradient in the `RGB24` format. bottom_color (:obj:`int`): Bottom color of the gradient in the `RGB24` format. rotation_angle (:obj:`int`): Clockwise rotation angle of the background fill in degrees; 0-:tg-const:`telegram.constants.BackgroundFillLimit.MAX_ROTATION_ANGLE`. Attributes: type (:obj:`str`): Type of the background fill. Always :attr:`~telegram.BackgroundFill.GRADIENT`. top_color (:obj:`int`): Top color of the gradient in the `RGB24` format. bottom_color (:obj:`int`): Bottom color of the gradient in the `RGB24` format. rotation_angle (:obj:`int`): Clockwise rotation angle of the background fill in degrees; 0-:tg-const:`telegram.constants.BackgroundFillLimit.MAX_ROTATION_ANGLE`. ) bottom_colorrotation_angle top_colorNr)rFrDrErc sNtj|j|d|*||_||_||_|j|j|jf|_W5QRXdSr@)rrrrArFrDrEr)r!rFrDrErr"r$r%rs  zBackgroundFillGradient.__init__rBr$r$r"r%r/sr/cs:eZdZdZdZddeeeedfddZ Z S)r0a The background is a freeform gradient that rotates after every message in the chat. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`colors` is equal. .. versionadded:: 21.2 Args: colors (Sequence[:obj:`int`]): A list of the 3 or 4 base colors that are used to generate the freeform gradient in the `RGB24` format Attributes: type (:obj:`str`): Type of the background fill. Always :attr:`~telegram.BackgroundFill.FREEFORM_GRADIENT`. colors (Sequence[:obj:`int`]): A list of the 3 or 4 base colors that are used to generate the freeform gradient in the `RGB24` format )colorsNr)rGrc s>tj|j|d|t||_|jf|_W5QRXdSr@)rrrrAr rGr)r!rGrr"r$r%rs  z'BackgroundFillFreeformGradient.__init__) r6r7r8r9r:rrCrrrr>r$r$r"r%r0sr0cseZdZUdZdZejjZeeje d<ejj Z eeje d<ejj Z eeje d<ejj Z eeje d<dde eed fd d Zedeeed edd fdd ZZS)BackgroundTypeaBase class for Telegram BackgroundType Objects. It can be one of: * :class:`telegram.BackgroundTypeFill` * :class:`telegram.BackgroundTypeWallpaper` * :class:`telegram.BackgroundTypePattern` * :class:`telegram.BackgroundTypeChatTheme`. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type` is equal. .. versionadded:: 21.2 Args: type (:obj:`str`): Type of the background. Can be one of: :attr:`~telegram.BackgroundType.FILL`, :attr:`~telegram.BackgroundType.WALLPAPER` :attr:`~telegram.BackgroundType.PATTERN` or :attr:`~telegram.BackgroundType.CHAT_THEME`. Attributes: type (:obj:`str`): Type of the background. Can be one of: :attr:`~telegram.BackgroundType.FILL`, :attr:`~telegram.BackgroundType.WALLPAPER` :attr:`~telegram.BackgroundType.PATTERN` or :attr:`~telegram.BackgroundType.CHAT_THEME`. rFILL WALLPAPERPATTERN CHAT_THEMENrrcs6tj|dttj|||_|jf|_|dSr) rrr rr BackgroundTypeTyperrrr r"r$r%rs zBackgroundType.__init__rr&cs||}|sdS|jt|jt|jt|jti}|t kr\| d|kr\|| dj ||dSd|krzt | d||d<d|krt | d||d<tj ||dS)r+Nrr,filldocument)r-rIBackgroundTypeFillrJBackgroundTypeWallpaperrKBackgroundTypePatternrLBackgroundTypeChatThemerHr1r2r3rr rr4r"r$r%r3s& zBackgroundType.de_json)N)r6r7r8r9r:r rMrIrr;rJrKrLr<rrrr=r3r>r$r$r"r%rHs$  rHcs8eZdZdZdZddeeeedfddZ Z S)rPa The background is automatically filled based on the selected colors. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`fill` and :attr:`dark_theme_dimming` are equal. .. versionadded:: 21.2 Args: fill (:class:`telegram.BackgroundFill`): The background fill. dark_theme_dimming (:obj:`int`): Dimming of the background in dark themes, as a percentage; 0-:tg-const:`telegram.constants.BackgroundTypeLimit.MAX_DIMMING`. Attributes: type (:obj:`str`): Type of the background. Always :attr:`~telegram.BackgroundType.FILL`. fill (:class:`telegram.BackgroundFill`): The background fill. dark_theme_dimming (:obj:`int`): Dimming of the background in dark themes, as a percentage; 0-:tg-const:`telegram.constants.BackgroundTypeLimit.MAX_DIMMING`. )dark_theme_dimmingrNNr)rNrTrc sDtj|j|d| ||_||_|j|jf|_W5QRXdSr@)rrrIrArNrTr)r!rNrTrr"r$r%rFs  zBackgroundTypeFill.__init__) r6r7r8r9r:rrCrrrr>r$r$r"r%rP,srPcsFeZdZdZdZdddeeeeeeee dfddZ Z S) rQa The background is a wallpaper in the `JPEG` format. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`document` and :attr:`dark_theme_dimming` are equal. .. versionadded:: 21.2 Args: document (:class:`telegram.Document`): Document with the wallpaper dark_theme_dimming (:obj:`int`): Dimming of the background in dark themes, as a percentage; 0-:tg-const:`telegram.constants.BackgroundTypeLimit.MAX_DIMMING`. is_blurred (:obj:`bool`, optional): :obj:`True`, if the wallpaper is downscaled to fit in a 450x450 square and then box-blurred with radius 12 is_moving (:obj:`bool`, optional): :obj:`True`, if the background moves slightly when the device is tilted Attributes: type (:obj:`str`): Type of the background. Always :attr:`~telegram.BackgroundType.WALLPAPER`. document (:class:`telegram.Document`): Document with the wallpaper dark_theme_dimming (:obj:`int`): Dimming of the background in dark themes, as a percentage; 0-:tg-const:`telegram.constants.BackgroundTypeLimit.MAX_DIMMING`. is_blurred (:obj:`bool`): Optional. :obj:`True`, if the wallpaper is downscaled to fit in a 450x450 square and then box-blurred with radius 12 is_moving (:obj:`bool`): Optional. :obj:`True`, if the background moves slightly when the device is tilted )rTrO is_blurred is_movingNr)rOrTrUrVrc sPtj|j|d|,||_||_||_||_|j|jf|_W5QRXdSr@) rrrJrArOrTrUrVr)r!rOrTrUrVrr"r$r%rxs  z BackgroundTypeWallpaper.__init__)NN) r6r7r8r9r:r rCrboolrrr>r$r$r"r%rQVsrQc sHeZdZdZdZdddeeeee ee ee dfddZ Z S) rRa The background is a `PNG` or `TGV` (gzipped subset of `SVG` with `MIME` type `"application/x-tgwallpattern"`) pattern to be combined with the background fill chosen by the user. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`document` and :attr:`fill` and :attr:`intensity` are equal. .. versionadded:: 21.2 Args: document (:class:`telegram.Document`): Document with the pattern. fill (:class:`telegram.BackgroundFill`): The background fill that is combined with the pattern. intensity (:obj:`int`): Intensity of the pattern when it is shown above the filled background; 0-:tg-const:`telegram.constants.BackgroundTypeLimit.MAX_INTENSITY`. is_inverted (:obj:`int`, optional): :obj:`True`, if the background fill must be applied only to the pattern itself. All other pixels are black in this case. For dark themes only. is_moving (:obj:`bool`, optional): :obj:`True`, if the background moves slightly when the device is tilted. Attributes: type (:obj:`str`): Type of the background. Always :attr:`~telegram.BackgroundType.PATTERN`. document (:class:`telegram.Document`): Document with the pattern. fill (:class:`telegram.BackgroundFill`): The background fill that is combined with the pattern. intensity (:obj:`int`): Intensity of the pattern when it is shown above the filled background; 0-:tg-const:`telegram.constants.BackgroundTypeLimit.MAX_INTENSITY`. is_inverted (:obj:`int`): Optional. :obj:`True`, if the background fill must be applied only to the pattern itself. All other pixels are black in this case. For dark themes only. is_moving (:obj:`bool`): Optional. :obj:`True`, if the background moves slightly when the device is tilted. )rOrN intensity is_invertedrVNr)rOrNrXrYrVrc sZtj|j|d|6||_||_||_||_||_|j|j|jf|_ W5QRXdSr@) rrrKrArOrNrXrYrVr)r!rOrNrXrYrVrr"r$r%rs  zBackgroundTypePattern.__init__)NN) r6r7r8r9r:r rrCrrWrrr>r$r$r"r%rRs' rRcs6eZdZdZdZddeeedfddZZ S)rSa3 The background is taken directly from a built-in chat theme. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`theme_name` is equal. .. versionadded:: 21.2 Args: theme_name (:obj:`str`): Name of the chat theme, which is usually an emoji. Attributes: type (:obj:`str`): Type of the background. Always :attr:`~telegram.BackgroundType.CHAT_THEME`. theme_name (:obj:`str`): Name of the chat theme, which is usually an emoji. ) theme_nameNr)rZrc s:tj|j|d|||_|jf|_W5QRXdSr@)rrrLrArZr)r!rZrr"r$r%rs z BackgroundTypeChatTheme.__init__) r6r7r8r9r:r<rrrr>r$r$r"r%rSsrScs^eZdZdZdZddeeedfddZe d eeededd fd d Z Z S) ChatBackgrounda This object represents a chat background. Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their :attr:`type` is equal. .. versionadded:: 21.2 Args: type (:class:`telegram.BackgroundType`): Type of the background. Attributes: type (:class:`telegram.BackgroundType`): Type of the background. rNrrcs*tj|d||_|jf|_|dSr)rrrrrr r"r$r%r s zChatBackground.__init__rr&cs8||}|sdSt|d||d<tj||dSr*)r-rHr3r1r)r5r'r(r"r$r%r3s  zChatBackground.de_json)N) r6r7r8r9r:rHrrrr=r3r>r$r$r"r%r[s r[N) r9typingrrrrrrrZtelegramr Ztelegram._files.documentr Ztelegram._telegramobjectr Ztelegram._utilsr Ztelegram._utils.argumentparsingr Ztelegram._utils.typesrrrr.r/r0rHrPrQrRrSr[r$r$r$r%s&$       E"0$P*8H"