samp.directory
← Scripts et bibliothèques

kristoisberg/samp-screen-colour-fader

Library for fading players' screens between colours for open.mp and SA-MP.

Bibliothèque★ 8mis à jour oct. 2020Pas de licencePawnsampctlArchivé
Ouvrir sur GitHub

L’auteur a archivé ce dépôt, il n’est donc plus maintenu.

Ce dépôt n’a pas de fichier de licence. Il est public en lecture, mais cela ne donne pas à lui seul le droit de le réutiliser.

Installer avec sampctl

sampctl package install kristoisberg/samp-screen-colour-fader

Lance ceci dans le dossier de ton projet. sampctl télécharge le paquet et ce dont il dépend.

L’essayer dans le compilateur Pawn →

Ajoute ses fichiers include, avec les bibliothèques dont il dépend, au compilateur Pawn de ton navigateur, prêts à être inclus dans un script.

Dépend de 2 paquets

README.md

SA-MP Screen Colour Fader

Notice: This repository is not being actively maintained anymore. If anyone wishes to continue the development of the project, please create a fork of the repository and release future versions there.

This library lets you add colour filters to players' screens and fade between them. Until today I was using a modified version of Joe Staff's fader include, but since it was using a separate argument for each part of an RGBA colour and the original was outdated in general, I decided to create my own. Here's what I came up with.

Installation

Simply install to your project:

sampctl package install kristoisberg/samp-screen-colour-fader

Include in your code and begin using the library:

#include <screen-colour-fader>

Functions

native SetPlayerScreenColour(playerid, colour);

Will set the player's screen colour to the specified colour. Can be used during a fade, but the fade will continue after the current step is finished. Returns 1 if the specified player is connected or 0 if not.

native GetPlayerScreenColour(playerid);

Can be used during a fade. Returns the current colour of the player's screen if the player is connected or 0x00000000 if not.

native FadePlayerScreenColour(playerid, colour, time, steps);

Fades the player's screen from the current colour to the colour specified in the function. time specifies the duration of the fade and steps specifies the amount of steps made during the fade. Returns 1 if the specified player is connected and the values of time and steps are valid or 0 if not.

native StopPlayerScreenColourFade(playerid);

Stops the ongoing fade. The colour of the player's screen will remain as it is at the time of the function call. Returns 1 if the specified player is connected and has an ongoing fade or 0 if not.

Callbacks

forward public OnScreenColourFadeComplete(playerid);

Notes

  • Both for the functions and the callback, the American spelling (color instead of colour) is also supported.

Example

The following piece of code (also available in test.pwn) fades the player's screen to red and back to transparent five times.

new bool:reverse, counter;

public OnPlayerConnect(playerid) {
	SetPlayerScreenColour(playerid, 0x00000000);
	FadePlayerScreenColour(playerid, 0xFF0000AA, 1000, 25);
	return 1;
}


public OnScreenColourFadeComplete(playerid) {
	if (++counter == 10) {
		return 1;
	}

	FadePlayerScreenColour(playerid, reverse ? 0xFF0000AA : 0x00000000, 1000, 50);

	reverse = !reverse;

	return 1;
}

Testing

To test, simply run the package:

sampctl package run

And connect to localhost:7777 to test.

colorcolorscolourcoloursfadefaderpawnpawn-packagesa-mpsa-mp-libraryscreen

Cette page est construite à partir de ce que GitHub publie sur le dépôt. samp.directory n’héberge pas le code. Signaler un problème avec cette fiche

kristoisberg/samp-screen-colour-fader : Bibliothèque SA-MP | samp.directory