spigot-mirror/bukkit
1
0
Fork 0
mirror of https://hub.spigotmc.org/stash/scm/spigot/bukkit.git synced 2025-08-21 05:44:17 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

SPIGOT-5984: Add non deprecated / magic value way to set pixel in MapCanvas

Browse source
This commit is contained in:
DerFrZocker 2022-06-09 21:27:21 +10:00 • committed by md_5
parent 20caf8ff2d
commit 830db7d55f
No known key found for this signature in database
GPG key ID: E8E901AC7C617C11
1 changed files with 40 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

40
src/main/java/org/bukkit/map/MapCanvas.java
View file

@ -1,5 +1,6 @@
package org.bukkit.map;
import java.awt.Color;
import java.awt.Image;
import org.jetbrains.annotations.NotNull;
@ -35,12 +36,47 @@ public interface MapCanvas {
*/
public void setCursors(@NotNull MapCursorCollection cursors);
/**
* Draw a pixel to the canvas.
* <p>
* The provided color might be converted to another color,
* which is in the map color range. This means, that
* {@link #getPixelColor(int, int)} might return another
* color than set.
*
* @param x The x coordinate, from 0 to 127.
* @param y The y coordinate, from 0 to 127.
* @param color The color.
*/
void setPixelColor(int x, int y, @NotNull Color color);
/**
* Get a pixel from the canvas.
*
* @param x The x coordinate, from 0 to 127.
* @param y The y coordinate, from 0 to 127.
* @return The color.
*/
@NotNull
Color getPixelColor(int x, int y);
/**
* Get a pixel from the layers below this canvas.
*
* @param x The x coordinate, from 0 to 127.
* @param y The y coordinate, from 0 to 127.
* @return The color.
*/
@NotNull
Color getBasePixelColor(int x, int y);
/**
* Draw a pixel to the canvas.
*
* @param x The x coordinate, from 0 to 127.
* @param y The y coordinate, from 0 to 127.
* @param color The color. See {@link MapPalette}.
* @deprecated Magic value, use {@link #setPixelColor(int, int, Color)}
*/
public void setPixel(int x, int y, byte color);
@ -50,7 +86,9 @@ public interface MapCanvas {
* @param x The x coordinate, from 0 to 127.
* @param y The y coordinate, from 0 to 127.
* @return The color. See {@link MapPalette}.
* @deprecated Magic value, use {@link #getPixelColor(int, int)}
*/
@Deprecated
public byte getPixel(int x, int y);
/**
@ -59,7 +97,9 @@ public interface MapCanvas {
* @param x The x coordinate, from 0 to 127.
* @param y The y coordinate, from 0 to 127.
* @return The color. See {@link MapPalette}.
* @deprecated Magic value, use {@link #getBasePixelColor(int, int)}
*/
@Deprecated
public byte getBasePixel(int x, int y);
/**