Skip to content
This repository has been archived by the owner on Dec 23, 2023. It is now read-only.
/ ScreenSaver Public archive

A .NET library for creating screen savers for the Microsoft Windows operating system; mirror of the official repository https://gitlab.com/tobiaskoch/ScreenSaver

License

Notifications You must be signed in to change notification settings

t081as/ScreenSaver

Repository files navigation

SCREENSAVER

SCREENSAVER

ScreenSaver is a .NET library for creating screen savers for the Microsoft Windows operating system.

Installation

Option 0: NuGet

NuGet packages are available here.

Option 1: Binary

Stable versions can be downloaded here.

Option 2: Source

Requirements

The following applications must be available and included in you PATH environment variable:

Source code

Get the source code using the following command:

> git clone https://gitlab.com/tobiaskoch/ScreenSaver.git

Build

> .\Build.cmd

The library will be located in the directory .\Build\Release if the build succeeds.

Usage

Add a reference to the ScreenSaver nuget package or the ScreenSaver library

Create a UserControl that serves as screen saver

Create a screen saver configuration class implementing the IScreenSaverConfiguration interface:

/// <summary>
/// The configuration of the test screen saver.
/// </summary>
internal class ScreenSaverTestConfiguration : IScreenSaverConfiguration
{
    #region Properties

    /// <summary>
    /// Gets the name of the screen saver.
    /// </summary>
    public string ScreenSaverName
    {
        get
        {
            return "Test";
        }
    }

    #endregion

    #region Methods

    /// <summary>
    /// Creates and returns a new instance of a <see cref="Control"/> used as a screen saver for the given screen.
    /// </summary>
    /// <param name="screen">
    /// The <see cref="Screen"/> this screen saver control shall be used for
    /// or <c>null</c> if the control is used as a preview.
    /// </param>
    /// <returns>A <see cref="Control"/> used as a screen saver for the given screen.</returns>
    public Control CreateScreenSaverControl(Screen screen)
    {
        return new FancyScreenSaverControl();
    }

    /// <summary>
    /// Creates and returns a new instance of a <see cref="Control"/> used as a preview of the screen saver.
    /// </summary>
    /// <returns>
    /// A <see cref="Control"/> used as a preview of the screen saver.
    /// </returns>
    public Control CreatePreviewControl()
    {
        return new FancyScreenSaverControl();
    }

    /// <summary>
    /// Creates and returns a new instance of a <see cref="Control"/> used to configure the screen saver.
    /// </summary>
    /// <returns>
    /// A <see cref="Control"/> used to configure the screen saver or <c>null</c> if the screen saver
    /// can't be configured.
    /// </returns>
    public ConfigurationControl CreateConfigurationControl()
    {
        return null;
    }
}

Add the following code to your Main method:

public static void Main(string[] args)
{
    ScreenSaver screenSaver = new ScreenSaver(new ScreenSaverTestConfiguration());
    screenSaver.Run(args);
}

That's it.

The solution contains an example that demonstrates the usage of this library and additional helper classes.

Please keep in mind that the helper classes are implemented using the Graphics.DrawImage method; feel free to use a more performant implementation (DirectX).

Contributing

see CONTRIBUTING.md

Contributors

see AUTHORS.txt

Donating

Thanks for your interest in this project. You can show your appreciation and support further development by donating.

License

ScreenSaver © 2017-2019 Tobias Koch. Released under the MIT License.

About

A .NET library for creating screen savers for the Microsoft Windows operating system; mirror of the official repository https://gitlab.com/tobiaskoch/ScreenSaver

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published