bastd.actor.popuptext

  1# Released under the MIT License. See LICENSE for details.
  2#
  3"""Defines Actor(s)."""
  4
  5from __future__ import annotations
  6
  7import random
  8from typing import TYPE_CHECKING
  9
 10import ba
 11
 12if TYPE_CHECKING:
 13    from typing import Any, Sequence
 14
 15
 16class PopupText(ba.Actor):
 17    """Text that pops up above a position to denote something special.
 18
 19    category: Gameplay Classes
 20    """
 21
 22    def __init__(self,
 23                 text: str | ba.Lstr,
 24                 position: Sequence[float] = (0.0, 0.0, 0.0),
 25                 color: Sequence[float] = (1.0, 1.0, 1.0, 1.0),
 26                 random_offset: float = 0.5,
 27                 offset: Sequence[float] = (0.0, 0.0, 0.0),
 28                 scale: float = 1.0):
 29        """Instantiate with given values.
 30
 31        random_offset is the amount of random offset from the provided position
 32        that will be applied. This can help multiple achievements from
 33        overlapping too much.
 34        """
 35        super().__init__()
 36        if len(color) == 3:
 37            color = (color[0], color[1], color[2], 1.0)
 38        pos = (position[0] + offset[0] + random_offset *
 39               (0.5 - random.random()), position[1] + offset[0] +
 40               random_offset * (0.5 - random.random()), position[2] +
 41               offset[0] + random_offset * (0.5 - random.random()))
 42
 43        self.node = ba.newnode('text',
 44                               attrs={
 45                                   'text': text,
 46                                   'in_world': True,
 47                                   'shadow': 1.0,
 48                                   'flatness': 1.0,
 49                                   'h_align': 'center'
 50                               },
 51                               delegate=self)
 52
 53        lifespan = 1.5
 54
 55        # scale up
 56        ba.animate(
 57            self.node, 'scale', {
 58                0: 0.0,
 59                lifespan * 0.11: 0.020 * 0.7 * scale,
 60                lifespan * 0.16: 0.013 * 0.7 * scale,
 61                lifespan * 0.25: 0.014 * 0.7 * scale
 62            })
 63
 64        # translate upward
 65        self._tcombine = ba.newnode('combine',
 66                                    owner=self.node,
 67                                    attrs={
 68                                        'input0': pos[0],
 69                                        'input2': pos[2],
 70                                        'size': 3
 71                                    })
 72        ba.animate(self._tcombine, 'input1', {
 73            0: pos[1] + 1.5,
 74            lifespan: pos[1] + 2.0
 75        })
 76        self._tcombine.connectattr('output', self.node, 'position')
 77
 78        # fade our opacity in/out
 79        self._combine = ba.newnode('combine',
 80                                   owner=self.node,
 81                                   attrs={
 82                                       'input0': color[0],
 83                                       'input1': color[1],
 84                                       'input2': color[2],
 85                                       'size': 4
 86                                   })
 87        for i in range(4):
 88            ba.animate(
 89                self._combine, 'input' + str(i), {
 90                    0.13 * lifespan: color[i],
 91                    0.18 * lifespan: 4.0 * color[i],
 92                    0.22 * lifespan: color[i]
 93                })
 94        ba.animate(self._combine, 'input3', {
 95            0: 0,
 96            0.1 * lifespan: color[3],
 97            0.7 * lifespan: color[3],
 98            lifespan: 0
 99        })
100        self._combine.connectattr('output', self.node, 'color')
101
102        # kill ourself
103        self._die_timer = ba.Timer(
104            lifespan, ba.WeakCall(self.handlemessage, ba.DieMessage()))
105
106    def handlemessage(self, msg: Any) -> Any:
107        assert not self.expired
108        if isinstance(msg, ba.DieMessage):
109            if self.node:
110                self.node.delete()
111        else:
112            super().handlemessage(msg)