BenMakesGames.PlayPlayMini.GraphicsExtensions 2.0.1

What Is It?

PlayPlayMini.GraphicsExtensions contains classes and extensions for PlayPlayMini that add more functionality to PlayPlayMini.

Hey, listen! This is a super-early release which contains a very small number of additions.

Game States Transitions

ScreenWipe

The ScreenWipe game state allows you to add a screen wipe transition between two game states.

Example usage:

public void GoToNextScene()
{
    GSM.ChangeState<ScreenWipe, ScreenWipeConfig>(new() {
        PreviousState = this,
        NextState = GSM.CreateState<NextScene>(),
        Color = Color.Black,
        WipeTime = 0.25, // in seconds
        Direction = ScreenWipeDirection.RightToLeft
    });
}

There are also options which let you hold on the black screen while some other process finishes (HoldUntil), and/or show a message (Message and MessageColor), which may be useful when performing a long-running operation, such as saving the game, loading the next level from disk, or making an web API call.

Method Reference

DrawTextWithOutline

PlayPlayMini has a built-in DrawTextWithOutline method. GraphicsExtensions's version is easier to use (you do not need to create an outline version of your font), but is less computationally efficient (2.5x the draw calls).

Most games won't notice this performance difference, but if you're tight on CPU cycles for some reason, you may not want to rely on this method.

GraphicsManage.DrawTextWithOutline(
    string fontName,
    int x,
    int y,
    string text,
    Color fillColor,
    Color outlineColor
);

DrawWavyText

DrawWavyText allows you to draw text that moves up and down in a wavy pattern. There are a few overloads of the method which allow you to customize color and positioning of the text.

Draw waving text starting at the specified x/y position:

GraphicsManager.DrawWavyText(
    string fontName,
    GameTime gameTime,
    int x, int y,
    string text,
    Color color = Color.White
);

Draw waving text horizontally-centered at the specified y position:

GraphicsManager.DrawWavyText(
    string fontName,
    GameTime gameTime,
    int y,
    string text,
    Color color = Color.White
);

Draw waving text in the dead center of the screen:

GraphicsManager.DrawWavyText(
    string fontName,
    GameTime gameTime,
    string text,
    Color color = Color.White
);