sonolus.py 0.1.0__py3-none-any.whl

sonolus/script/text.py

@@ -0,0 +1,404 @@
+class StandardText:
+    Post = "#POST"
+    Playlist = "#PLAYLIST"
+    Level = "#LEVEL"
+    Skin = "#SKIN"
+    Background = "#BACKGROUND"
+    Effect = "#EFFECT"
+    Particle = "#PARTICLE"
+    Engine = "#ENGINE"
+    Replay = "#REPLAY"
+    Room = "#ROOM"
+    Grade = "#GRADE"
+    ArcadeScore = "#ARCADE_SCORE"
+    AccuracyScore = "#ACCURACY_SCORE"
+    Combo = "#COMBO"
+    Perfect = "#PERFECT"
+    Great = "#GREAT"
+    Good = "#GOOD"
+    Miss = "#MISS"
+    Keywords = "#KEYWORDS"
+    Name = "#NAME"
+    Rating = "#RATING"
+    RatingMinimum = "#RATING_MINIMUM"
+    RatingMaximum = "#RATING_MAXIMUM"
+    Title = "#TITLE"
+    Subtitle = "#SUBTITLE"
+    Artists = "#ARTISTS"
+    Time = "#TIME"
+    Author = "#AUTHOR"
+    Genre = "#GENRE"
+    Type = "#TYPE"
+    Category = "#CATEGORY"
+    Language = "#LANGUAGE"
+    Difficulty = "#DIFFICULTY"
+    Version = "#VERSION"
+    Length = "#LENGTH"
+    LengthMinimum = "#LENGTH_MINIMUM"
+    LengthMaximum = "#LENGTH_MAXIMUM"
+    AdditionalInformation = "#ADDITIONAL_INFORMATION"
+    Timezone = "#TIMEZONE"
+    Region = "#REGION"
+    Content = "#CONTENT"
+    Comment = "#COMMENT"
+    Review = "#REVIEW"
+    Reply = "#REPLY"
+    Message = "#MESSAGE"
+    Role = "#ROLE"
+    Permission = "#PERMISSION"
+    User = "#USER"
+    Speed = "#SPEED"
+    Mirror = "#MIRROR"
+    Random = "#RANDOM"
+    Hidden = "#HIDDEN"
+    JudgmentStrict = "#JUDGMENT_STRICT"
+    JudgmentLoose = "#JUDGMENT_LOOSE"
+    EffectAuto = "#EFFECT_AUTO"
+    Stage = "#STAGE"
+    StagePosition = "#STAGE_POSITION"
+    StageSize = "#STAGE_SIZE"
+    StageRotation = "#STAGE_ROTATION"
+    StageDirection = "#STAGE_DIRECTION"
+    StageAlpha = "#STAGE_ALPHA"
+    StageAnimation = "#STAGE_ANIMATION"
+    StageTilt = "#STAGE_TILT"
+    StageCoverVertical = "#STAGE_COVER_VERTICAL"
+    StageCoverHorizontal = "#STAGE_COVER_HORIZONTAL"
+    StageCoverAlpha = "#STAGE_COVER_ALPHA"
+    StageAspectratioLock = "#STAGE_ASPECTRATIO_LOCK"
+    StageEffect = "#STAGE_EFFECT"
+    StageEffectPosition = "#STAGE_EFFECT_POSITION"
+    StageEffectSize = "#STAGE_EFFECT_SIZE"
+    StageEffectRotation = "#STAGE_EFFECT_ROTATION"
+    StageEffectDirection = "#STAGE_EFFECT_DIRECTION"
+    StageEffectAlpha = "#STAGE_EFFECT_ALPHA"
+    Lane = "#LANE"
+    LanePosition = "#LANE_POSITION"
+    LaneSize = "#LANE_SIZE"
+    LaneRotation = "#LANE_ROTATION"
+    LaneDirection = "#LANE_DIRECTION"
+    LaneAlpha = "#LANE_ALPHA"
+    LaneAnimation = "#LANE_ANIMATION"
+    LaneEffect = "#LANE_EFFECT"
+    LaneEffectPosition = "#LANE_EFFECT_POSITION"
+    LaneEffectSize = "#LANE_EFFECT_SIZE"
+    LaneEffectRotation = "#LANE_EFFECT_ROTATION"
+    LaneEffectDirection = "#LANE_EFFECT_DIRECTION"
+    LaneEffectAlpha = "#LANE_EFFECT_ALPHA"
+    Judgeline = "#JUDGELINE"
+    JudgelinePosition = "#JUDGELINE_POSITION"
+    JudgelineSize = "#JUDGELINE_SIZE"
+    JudgelineRotation = "#JUDGELINE_ROTATION"
+    JudgelineDirection = "#JUDGELINE_DIRECTION"
+    JudgelineAlpha = "#JUDGELINE_ALPHA"
+    JudgelineAnimation = "#JUDGELINE_ANIMATION"
+    JudgelineEffect = "#JUDGELINE_EFFECT"
+    JudgelineEffectPosition = "#JUDGELINE_EFFECT_POSITION"
+    JudgelineEffectSize = "#JUDGELINE_EFFECT_SIZE"
+    JudgelineEffectRotation = "#JUDGELINE_EFFECT_ROTATION"
+    JudgelineEffectDirection = "#JUDGELINE_EFFECT_DIRECTION"
+    JudgelineEffectAlpha = "#JUDGELINE_EFFECT_ALPHA"
+    Slot = "#SLOT"
+    SlotPosition = "#SLOT_POSITION"
+    SlotSize = "#SLOT_SIZE"
+    SlotRotation = "#SLOT_ROTATION"
+    SlotDirection = "#SLOT_DIRECTION"
+    SlotAlpha = "#SLOT_ALPHA"
+    SlotAnimation = "#SLOT_ANIMATION"
+    SlotEffect = "#SLOT_EFFECT"
+    SlotEffectPosition = "#SLOT_EFFECT_POSITION"
+    SlotEffectSize = "#SLOT_EFFECT_SIZE"
+    SlotEffectRotation = "#SLOT_EFFECT_ROTATION"
+    SlotEffectDirection = "#SLOT_EFFECT_DIRECTION"
+    SlotEffectAlpha = "#SLOT_EFFECT_ALPHA"
+    Note = "#NOTE"
+    NoteSpeed = "#NOTE_SPEED"
+    NoteSpeedRandom = "#NOTE_SPEED_RANDOM"
+    NotePosition = "#NOTE_POSITION"
+    NoteSize = "#NOTE_SIZE"
+    NoteRotation = "#NOTE_ROTATION"
+    NoteDirection = "#NOTE_DIRECTION"
+    NoteColor = "#NOTE_COLOR"
+    NoteAlpha = "#NOTE_ALPHA"
+    NoteAnimation = "#NOTE_ANIMATION"
+    NoteEffect = "#NOTE_EFFECT"
+    NoteEffectPosition = "#NOTE_EFFECT_POSITION"
+    NoteEffectSize = "#NOTE_EFFECT_SIZE"
+    NoteEffectRotation = "#NOTE_EFFECT_ROTATION"
+    NoteEffectDirection = "#NOTE_EFFECT_DIRECTION"
+    NoteEffectColor = "#NOTE_EFFECT_COLOR"
+    NoteEffectAlpha = "#NOTE_EFFECT_ALPHA"
+    Marker = "#MARKER"
+    MarkerPosition = "#MARKER_POSITION"
+    MarkerSize = "#MARKER_SIZE"
+    MarkerRotation = "#MARKER_ROTATION"
+    MarkerDirection = "#MARKER_DIRECTION"
+    MarkerColor = "#MARKER_COLOR"
+    MarkerAlpha = "#MARKER_ALPHA"
+    MarkerAnimation = "#MARKER_ANIMATION"
+    Connector = "#CONNECTOR"
+    ConnectorPosition = "#CONNECTOR_POSITION"
+    ConnectorSize = "#CONNECTOR_SIZE"
+    ConnectorRotation = "#CONNECTOR_ROTATION"
+    ConnectorDirection = "#CONNECTOR_DIRECTION"
+    ConnectorColor = "#CONNECTOR_COLOR"
+    ConnectorAlpha = "#CONNECTOR_ALPHA"
+    ConnectorAnimation = "#CONNECTOR_ANIMATION"
+    Simline = "#SIMLINE"
+    SimlinePosition = "#SIMLINE_POSITION"
+    SimlineSize = "#SIMLINE_SIZE"
+    SimlineRotation = "#SIMLINE_ROTATION"
+    SimlineDirection = "#SIMLINE_DIRECTION"
+    SimlineColor = "#SIMLINE_COLOR"
+    SimlineAlpha = "#SIMLINE_ALPHA"
+    SimlineAnimation = "#SIMLINE_ANIMATION"
+    None_ = "#NONE"
+    Any = "#ANY"
+    All = "#ALL"
+    Others = "#OTHERS"
+    Short = "#SHORT"
+    Long = "#LONG"
+    High = "#HIGH"
+    Mid = "#MID"
+    Low = "#LOW"
+    Small = "#SMALL"
+    Medium = "#MEDIUM"
+    Large = "#LARGE"
+    Left = "#LEFT"
+    Right = "#RIGHT"
+    Up = "#UP"
+    Down = "#DOWN"
+    Front = "#FRONT"
+    Back = "#BACK"
+    Center = "#CENTER"
+    Top = "#TOP"
+    Bottom = "#BOTTOM"
+    TopLeft = "#TOP_LEFT"
+    TopCenter = "#TOP_CENTER"
+    TopRight = "#TOP_RIGHT"
+    CenterLeft = "#CENTER_LEFT"
+    CenterRight = "#CENTER_RIGHT"
+    BottomLeft = "#BOTTOM_LEFT"
+    BottomCenter = "#BOTTOM_CENTER"
+    BottomRight = "#BOTTOM_RIGHT"
+    Clockwise = "#CLOCKWISE"
+    Counterclockwise = "#COUNTERCLOCKWISE"
+    Forward = "#FORWARD"
+    Backward = "#BACKWARD"
+    Default = "#DEFAULT"
+    Neutral = "#NEUTRAL"
+    Red = "#RED"
+    Green = "#GREEN"
+    Blue = "#BLUE"
+    Yellow = "#YELLOW"
+    Purple = "#PURPLE"
+    Cyan = "#CYAN"
+    Simple = "#SIMPLE"
+    Easy = "#EASY"
+    Normal = "#NORMAL"
+    Hard = "#HARD"
+    Expert = "#EXPERT"
+    Master = "#MASTER"
+    Pro = "#PRO"
+    Technical = "#TECHNICAL"
+    Special = "#SPECIAL"
+    KeywordsPlaceholder = "#KEYWORDS_PLACEHOLDER"
+    NamePlaceholder = "#NAME_PLACEHOLDER"
+    RatingPlaceholder = "#RATING_PLACEHOLDER"
+    RatingMinimumPlaceholder = "#RATING_MINIMUM_PLACEHOLDER"
+    RatingMaximumPlaceholder = "#RATING_MAXIMUM_PLACEHOLDER"
+    TitlePlaceholder = "#TITLE_PLACEHOLDER"
+    SubtitlePlaceholder = "#SUBTITLE_PLACEHOLDER"
+    ArtistsPlaceholder = "#ARTISTS_PLACEHOLDER"
+    TimePlaceholder = "#TIME_PLACEHOLDER"
+    AuthorPlaceholder = "#AUTHOR_PLACEHOLDER"
+    GenrePlaceholder = "#GENRE_PLACEHOLDER"
+    TypePlaceholder = "#TYPE_PLACEHOLDER"
+    CategoryPlaceholder = "#CATEGORY_PLACEHOLDER"
+    LanguagePlaceholder = "#LANGUAGE_PLACEHOLDER"
+    DifficultyPlaceholder = "#DIFFICULTY_PLACEHOLDER"
+    LengthPlaceholder = "#LENGTH_PLACEHOLDER"
+    LengthMinimumPlaceholder = "#LENGTH_MINIMUM_PLACEHOLDER"
+    LengthMaximumPlaceholder = "#LENGTH_MAXIMUM_PLACEHOLDER"
+    AdditionalInformationPlaceholder = "#ADDITIONAL_INFORMATION_PLACEHOLDER"
+    TimezonePlaceholder = "#TIMEZONE_PLACEHOLDER"
+    RegionPlaceholder = "#REGION_PLACEHOLDER"
+    ContentPlaceholder = "#CONTENT_PLACEHOLDER"
+    CommentPlaceholder = "#COMMENT_PLACEHOLDER"
+    ReviewPlaceholder = "#REVIEW_PLACEHOLDER"
+    ReplyPlaceholder = "#REPLY_PLACEHOLDER"
+    MessagePlaceholder = "#MESSAGE_PLACEHOLDER"
+    RolePlaceholder = "#ROLE_PLACEHOLDER"
+    PermissionPlaceholder = "#PERMISSION_PLACEHOLDER"
+    UserPlaceholder = "#USER_PLACEHOLDER"
+    PercentageUnit = "#PERCENTAGE_UNIT"
+    SecondUnit = "#SECOND_UNIT"
+    MillisecondUnit = "#MILLISECOND_UNIT"
+    Tap = "#TAP"
+    TapHold = "#TAP_HOLD"
+    TapRelease = "#TAP_RELEASE"
+    TapFlick = "#TAP_FLICK"
+    TapSlide = "#TAP_SLIDE"
+    Hold = "#HOLD"
+    HoldSlide = "#HOLD_SLIDE"
+    HoldFollow = "#HOLD_FOLLOW"
+    Release = "#RELEASE"
+    Flick = "#FLICK"
+    Slide = "#SLIDE"
+    SlideFlick = "#SLIDE_FLICK"
+    Avoid = "#AVOID"
+    Jiggle = "#JIGGLE"
+    Newest = "#NEWEST"
+    Oldest = "#OLDEST"
+    Recommended = "#RECOMMENDED"
+    Popular = "#POPULAR"
+    Featured = "#FEATURED"
+    Competitive = "#COMPETITIVE"
+    Holiday = "#HOLIDAY"
+    Limited = "#LIMITED"
+    Following = "#FOLLOWING"
+    Announcement = "#ANNOUNCEMENT"
+    Information = "#INFORMATION"
+    Help = "#HELP"
+    Maintenance = "#MAINTENANCE"
+    Event = "#EVENT"
+    Update = "#UPDATE"
+    Search = "#SEARCH"
+    Advanced = "#ADVANCED"
+    Related = "#RELATED"
+    SameAuthor = "#SAME_AUTHOR"
+    SameArtists = "#SAME_ARTISTS"
+    SameRating = "#SAME_RATING"
+    SameCategory = "#SAME_CATEGORY"
+    SameDifficulty = "#SAME_DIFFICULTY"
+    SameGenre = "#SAME_GENRE"
+    SameVersion = "#SAME_VERSION"
+    OtherAuthors = "#OTHER_AUTHORS"
+    OtherArtists = "#OTHER_ARTISTS"
+    OtherRatings = "#OTHER_RATINGS"
+    OtherCategories = "#OTHER_CATEGORIES"
+    OtherDifficulties = "#OTHER_DIFFICULTIES"
+    OtherGenres = "#OTHER_GENRES"
+    OtherVersions = "#OTHER_VERSIONS"
+    Draft = "#DRAFT"
+    Reviewing = "#REVIEWING"
+    Published = "#PUBLISHED"
+    Verifying = "#VERIFYING"
+    Verified = "#VERIFIED"
+    Removed = "#REMOVED"
+    Public = "#PUBLIC"
+    Private = "#PRIVATE"
+    Locked = "#LOCKED"
+    Pop = "#POP"
+    Rock = "#ROCK"
+    Hiphop = "#HIPHOP"
+    Country = "#COUNTRY"
+    Electronic = "#ELECTRONIC"
+    Metal = "#METAL"
+    Classical = "#CLASSICAL"
+    Folk = "#FOLK"
+    Indie = "#INDIE"
+    Anime = "#ANIME"
+    Vocaloid = "#VOCALOID"
+    Remix = "#REMIX"
+    Instrumental = "#INSTRUMENTAL"
+    ShortVersion = "#SHORT_VERSION"
+    LongVersion = "#LONG_VERSION"
+    LiveVersion = "#LIVE_VERSION"
+    Report = "#REPORT"
+    Reason = "#REASON"
+    IllegalActivities = "#ILLEGAL_ACTIVITIES"
+    Cheating = "#CHEATING"
+    Afk = "#AFK"
+    Spamming = "#SPAMMING"
+    VerbalAbuse = "#VERBAL_ABUSE"
+    InappropriateLanguage = "#INAPPROPRIATE_LANGUAGE"
+    NegativeAttitude = "#NEGATIVE_ATTITUDE"
+    Dnf = "#DNF"
+    Suggestions = "#SUGGESTIONS"
+    SuggestionsPerPlayer = "#SUGGESTIONS_PER_PLAYER"
+    MatchScoring = "#MATCH_SCORING"
+    MatchTiebreaker = "#MATCH_TIEBREAKER"
+    MatchCount = "#MATCH_COUNT"
+    MatchLimit = "#MATCH_LIMIT"
+    RoundScoring = "#ROUND_SCORING"
+    RoundTiebreaker = "#ROUND_TIEBREAKER"
+    RoundCount = "#ROUND_COUNT"
+    RoundLimit = "#ROUND_LIMIT"
+    TeamScoring = "#TEAM_SCORING"
+    TeamTiebreaker = "#TEAM_TIEBREAKER"
+    TeamCount = "#TEAM_COUNT"
+    TeamLimit = "#TEAM_LIMIT"
+    Qualified = "#QUALIFIED"
+    Disqualified = "#DISQUALIFIED"
+    Ranking = "#RANKING"
+    Score = "#SCORE"
+    Player = "#PLAYER"
+    Spectator = "#SPECTATOR"
+    Referee = "#REFEREE"
+    Eliminated = "#ELIMINATED"
+    Finalist = "#FINALIST"
+    Finished = "#FINISHED"
+    Winner = "#WINNER"
+    GoldMedal = "#GOLD_MEDAL"
+    SilverMedal = "#SILVER_MEDAL"
+    BronzeMedal = "#BRONZE_MEDAL"
+    Team1 = "#TEAM_1"
+    Team2 = "#TEAM_2"
+    Team3 = "#TEAM_3"
+    Team4 = "#TEAM_4"
+    Team5 = "#TEAM_5"
+    Team6 = "#TEAM_6"
+    Team7 = "#TEAM_7"
+    Team8 = "#TEAM_8"
+    TeamRed = "#TEAM_RED"
+    TeamGreen = "#TEAM_GREEN"
+    TeamBlue = "#TEAM_BLUE"
+    TeamYellow = "#TEAM_YELLOW"
+    TeamPurple = "#TEAM_PURPLE"
+    TeamCyan = "#TEAM_CYAN"
+    TeamWhite = "#TEAM_WHITE"
+    TeamBlack = "#TEAM_BLACK"
+    Upload = "#UPLOAD"
+    Submit = "#SUBMIT"
+    Edit = "#EDIT"
+    Like = "#LIKE"
+    Liked = "#LIKED"
+    Dislike = "#DISLIKE"
+    Disliked = "#DISLIKED"
+    Bookmark = "#BOOKMARK"
+    Bookmarked = "#BOOKMARKED"
+    Delete = "#DELETE"
+    Restore = "#RESTORE"
+    Confirm = "#CONFIRM"
+    Cancel = "#CANCEL"
+    Increase = "#INCREASE"
+    Decrease = "#DECREASE"
+    Upvote = "#UPVOTE"
+    Upvoted = "#UPVOTED"
+    Downvote = "#DOWNVOTE"
+    Downvoted = "#DOWNVOTED"
+    Agree = "#AGREE"
+    Agreed = "#AGREED"
+    Disagree = "#DISAGREE"
+    Disagreed = "#DISAGREED"
+    Lock = "#LOCK"
+    Unlock = "#UNLOCK"
+    Pin = "#PIN"
+    Unpin = "#UNPIN"
+    Follow = "#FOLLOW"
+    Unfollow = "#UNFOLLOW"
+    Subscribe = "#SUBSCRIBE"
+    Unsubscribe = "#UNSUBSCRIBE"
+    Publish = "#PUBLISH"
+    Unpublish = "#UNPUBLISH"
+    Show = "#SHOW"
+    Hide = "#HIDE"
+    Allow = "#ALLOW"
+    Disallow = "#DISALLOW"
+    Approve = "#APPROVE"
+    Deny = "#DENY"
+    Accept = "#ACCEPT"
+    Reject = "#REJECT"
+    Star = "#STAR"
+    Starred = "#STARRED"

sonolus/script/timing.py

@@ -0,0 +1,42 @@
+from sonolus.backend.ops import Op
+from sonolus.script.internal.native import native_function
+
+
+@native_function(Op.BeatToBPM)
+def beat_to_bpm(beat: float) -> float:
+    raise NotImplementedError
+
+
+@native_function(Op.BeatToTime)
+def beat_to_time(beat: float) -> float:
+    raise NotImplementedError
+
+
+@native_function(Op.BeatToStartingBeat)
+def beat_to_starting_beat(beat: float) -> float:
+    raise NotImplementedError
+
+
+@native_function(Op.BeatToStartingTime)
+def beat_to_starting_time(beat: float) -> float:
+    raise NotImplementedError
+
+
+@native_function(Op.TimeToScaledTime)
+def time_to_scaled_time(time: float) -> float:
+    raise NotImplementedError
+
+
+@native_function(Op.TimeToStartingScaledTime)
+def time_to_starting_scaled_time(time: float) -> float:
+    raise NotImplementedError
+
+
+@native_function(Op.TimeToStartingTime)
+def time_to_starting_time(time: float) -> float:
+    raise NotImplementedError
+
+
+@native_function(Op.TimeToTimeScale)
+def time_to_timescale(time: float) -> float:
+    raise NotImplementedError

sonolus/script/transform.py

@@ -0,0 +1,118 @@
+# fmt: off
+from typing import Self
+
+from sonolus.script.graphics import Quad
+from sonolus.script.math import cos, sin
+from sonolus.script.record import Record
+from sonolus.script.vec import Vec2
+
+
+class Transform2d(Record):
+    a00: float
+    a01: float
+    a02: float
+    a10: float
+    a11: float
+    a12: float
+    a20: float
+    a21: float
+
+    @classmethod
+    def new(cls) -> Self:
+        return cls(
+            1, 0, 0,
+            0, 1, 0,
+            0, 0,
+        )
+
+    def _compose(self,
+        b00: float, b01: float, b02: float,
+        b10: float, b11: float, b12: float,
+        b20: float, b21: float,
+    ) -> Self:
+        """Multiply the matrix with another matrix on the left."""
+        a00 = self.a00 * b00 + self.a10 * b01 + self.a20 * b02
+        a01 = self.a01 * b00 + self.a11 * b01 + self.a21 * b02
+        a02 = self.a02 * b00 + self.a12 * b01 + b02
+        a10 = self.a00 * b10 + self.a10 * b11 + self.a20 * b12
+        a11 = self.a01 * b10 + self.a11 * b11 + self.a21 * b12
+        a12 = self.a02 * b10 + self.a12 * b11 + b12
+        a20 = self.a00 * b20 + self.a10 * b21 + b20
+        a21 = self.a01 * b20 + self.a11 * b21 + b21
+        a22 = self.a02 * b20 + self.a12 * b21 + 1
+        self.a00 = a00 / a22
+        self.a01 = a01 / a22
+        self.a02 = a02 / a22
+        self.a10 = a10 / a22
+        self.a11 = a11 / a22
+        self.a12 = a12 / a22
+        self.a20 = a20 / a22
+        self.a21 = a21 / a22
+        return self
+
+    def translate(self, x: float = 0, y: float = 0) -> Self:
+        return self._compose(
+            1, 0, x,
+            0, 1, y,
+            0, 0,
+        )
+
+    def scale(self, x: float = 1, y: float = 1) -> Self:
+        return self._compose(
+            x, 0, 0,
+            0, y, 0,
+            0, 0,
+        )
+
+    def rotate(self, angle: float) -> Self:
+        c = cos(angle)
+        s = sin(angle)
+        return self._compose(
+            c, -s, 0,
+            s, c, 0,
+            0, 0,
+        )
+
+    def shear_x(self, m: float) -> Self:
+        """Shear along the x-axis."""
+        return self._compose(
+            1, m, 0,
+            0, 1, 0,
+            0, 0,
+        )
+
+    def shear_y(self, m: float) -> Self:
+        """Shear along the y-axis."""
+        return self._compose(
+            1, 0, 0,
+            m, 1, 0,
+            0, 0,
+        )
+
+    def perspective_vanish_y(self, y: float) -> Self:
+        return self._compose(
+            1, 0, 0,
+            0, 1, 0,
+            0, 1 / y,
+        )
+
+    def compose(self, other: Self) -> Self:
+        return self._compose(
+            other.a00, other.a01, other.a02,
+            other.a10, other.a11, other.a12,
+            other.a20, other.a21,
+        )
+
+    def transform_vec(self, v: Vec2) -> Vec2:
+        x = self.a00 * v.x + self.a01 * v.y + self.a02
+        y = self.a10 * v.x + self.a11 * v.y + self.a12
+        w = self.a20 * v.x + self.a21 * v.y + 1
+        return Vec2(x / w, y / w)
+
+    def transform_quad(self, quad: Quad) -> Quad:
+        return Quad(
+            bl=self.transform_vec(quad.bl),
+            br=self.transform_vec(quad.br),
+            tl=self.transform_vec(quad.tl),
+            tr=self.transform_vec(quad.tr),
+        )