/* * This file is licensed under the MIT License, part of Roughly Enough Items. * Copyright (c) 2018, 2019, 2020 shedaniel * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ package me.shedaniel.rei.api; import me.shedaniel.math.api.Rectangle; import me.shedaniel.rei.RoughlyEnoughItemsCore; import me.shedaniel.rei.gui.config.SearchFieldLocation; import me.shedaniel.rei.utils.CollectionUtils; import net.minecraft.util.ActionResult; import org.jetbrains.annotations.ApiStatus; import java.util.List; import java.util.function.Supplier; import static net.minecraft.util.ActionResult.PASS; public interface DisplayHelper { /** * @return the api instance of {@link me.shedaniel.rei.impl.DisplayHelperImpl} */ static DisplayHelper getInstance() { return RoughlyEnoughItemsCore.getDisplayHelper(); } /** * Gets the sorted version of all responsible bounds handlers * * @param screenClass the class for checking responsible bounds handlers * @return the sorted list of responsible bounds handlers * @see DisplayHelper#getResponsibleBoundsHandler(Class) for the unsorted version */ List> getSortedBoundsHandlers(Class screenClass); /** * Gets all registered bounds handlers * * @return the list of registered bounds handlers * @deprecated see {@link #getAllOverlayDeciders()} */ @Deprecated @ApiStatus.ScheduledForRemoval default List> getAllBoundsHandlers() { return (List) CollectionUtils.castAndMap(getAllOverlayDeciders(), DisplayBoundsHandler.class); } /** * Gets all registered overlay deciders * * @return the list of registered overlay deciders */ List getAllOverlayDeciders(); /** * Gets all responsible bounds handlers * * @param screenClass the class for checking responsible bounds handlers * @return the the list of responsible bounds handlers * @see DisplayHelper#getSortedBoundsHandlers(Class) for the sorted version */ DisplayBoundsHandler getResponsibleBoundsHandler(Class screenClass); /** * Registers a bounds handler * * @param handler the handler to register * @deprecated see {@link #registerHandler(OverlayDecider)} */ @Deprecated @ApiStatus.ScheduledForRemoval default void registerBoundsHandler(DisplayBoundsHandler handler) { registerHandler(handler); } /** * Registers a bounds decider * * @param decider the decider to register */ void registerHandler(OverlayDecider decider); /** * Gets the base bounds handler api for exclusion zones * * @return the base bounds handler * @deprecated {@link BaseBoundsHandler#getInstance()} */ @ApiStatus.Internal @Deprecated @ApiStatus.ScheduledForRemoval BaseBoundsHandler getBaseBoundsHandler(); interface DisplayBoundsHandler extends OverlayDecider { /** * Gets the base supported class for the bounds handler * * @return the base class */ Class getBaseSupportedClass(); @Override default boolean isHandingScreen(Class screen) { return getBaseSupportedClass().isAssignableFrom(screen); } /** * Gets the left bounds of the overlay * * @param screen the current screen * @return the left bounds */ Rectangle getLeftBounds(T screen); /** * Gets the right bounds of the overlay * * @param screen the current screen * @return the right bounds */ Rectangle getRightBounds(T screen); /** * Checks if item slot can fit the screen * * @param left the left x coordinates of the stack * @param top the top y coordinates for the stack * @param screen the current screen * @param fullBounds the current bounds * @return whether the item slot can fit * @see BaseBoundsHandler#registerExclusionZones(Class, Supplier) for easier api */ default ActionResult canItemSlotWidgetFit(int left, int top, T screen, Rectangle fullBounds) { return PASS; } /** * Checks if mouse is inside the overlay * * @param mouseX mouse's x coordinates * @param mouseY mouse's y coordinates * @return whether mouse is inside the overlay */ default ActionResult isInZone(double mouseX, double mouseY) { return PASS; } /** * Gets the item list bounds by the overlay bounds * * @param rectangle the overlay bounds * @return the item list bounds */ default Rectangle getItemListArea(Rectangle rectangle) { return new Rectangle(rectangle.x + 1, rectangle.y + 2 + (ConfigObject.getInstance().getSearchFieldLocation() == SearchFieldLocation.TOP_SIDE ? 24 : 0) + (ConfigObject.getInstance().isEntryListWidgetScrolled() ? 0 : 22), rectangle.width - 2, rectangle.height - (ConfigObject.getInstance().getSearchFieldLocation() != SearchFieldLocation.CENTER ? 27 + 22 : 27) + (!ConfigObject.getInstance().isEntryListWidgetScrolled() ? 0 : 22)); } default Rectangle getFavoritesListArea(Rectangle rectangle) { int offset = 31 + (ConfigObject.getInstance().doesShowUtilsButtons() ? 25 : 0); return new Rectangle(rectangle.x + 1, rectangle.y + 2 + offset, rectangle.width - 2, rectangle.height - 5 - offset); } /** * Checks if REI should recalculate the overlay bounds * * @param isOnRightSide whether the user has set the overlay to the right * @param rectangle the current overlay bounds * @return whether REI should recalculate the overlay bounds */ default boolean shouldRecalculateArea(boolean isOnRightSide, Rectangle rectangle) { return false; } /** * Gets the priority of the handler, the higher it is, the earlier it is called. * * @return the priority in float */ @Override default float getPriority() { return 0f; } } }