Class TableOfColor


  • public class TableOfColor
    extends Object
    Основной класс библиотеки - таблица именованных цветов. При создании таблицы именованные цвета извлекаются из yml-файла и раскладываются по вёдрам
    Version:
    1.0.6
    Author:
    Othernik aka Folko85
    • Field Detail

      • ymlFile

        private final String ymlFile
        Поле - имя файла
      • colors

        private final List<ColorPoint> colors
        Поле - список точек-цветов
      • buckets

        private final List<BucketOfColor> buckets
        Поле - список вёдер
      • startPoint

        private int[] startPoint
        Поле - начальная граничная точка рабочей области
      • endPoint

        private int[] endPoint
        Поле - конечная граничная точка рабочей области
      • maxPointsCount

        private static int maxPointsCount
        Поле - максимальное количество точек-цветов в ведре
    • Constructor Detail

      • TableOfColor

        public TableOfColor​(Locale locale)
        Конструктор - создание нового объекта с определенными значениями
        Parameters:
        locale - - в зависимости от языка создаваемой таблицы из соответствующего файла загружается список точек-цветов и распределяется по вёдрам
    • Method Detail

      • extractYml

        private List<ColorPoint> extractYml​(String ymlFile)
        Метод извлечения точек из yml-файла
        Parameters:
        ymlFile - - имя файла, зависящее от языка создаваемой таблицы
        Returns:
        - возвращает список всех точек-цветов, извлечённых из файла
      • distributePoints

        private void distributePoints​(List<ColorPoint> points)
        Метод распределяет все именованные цвета по вёдрам
        Parameters:
        points - - список всех цветов-точек, полученных из yml-файла
      • findBucket

        private BucketOfColor findBucket​(ColorPoint point)
        Метод поиска подходящего ведра для точки-цвета. При переполнении ведра вызывается метод splitBucket, делящий ведро на две части, а затем метод рекурсивно вызывает сам себя.
        Parameters:
        point - - точка-цвет, которую нужно положить в ведро. Метод выполняется для каждого именованного цвета
        Returns:
        - метод возвращает ведро, в границах которого находится наша точка-цвет
      • splitBucket

        private void splitBucket​(BucketOfColor resultBucket)
        Метод разделения вёдер при переполнении.
        Parameters:
        resultBucket - - на вход принимается полное ведро, которое нужно разделить. В ходе работы метода ведро делится надвое по координате с самым большим разбросом точек. Новые вёдра добавляются в список вёдер, а старое удаляется из списка. Точки распределяются между вёдрами рекурсивным вызовом метода distributePoints
      • findNamedColorFromHex

        public String findNamedColorFromHex​(String hexCode)
        Основной метод библиотеки - поиск ближайшего именованного цвета
        Parameters:
        hexCode - - на вход метод принимает шестизначный шестнадцатеричный код
        Returns:
        - метод возвращает название ближайшего именованного цвета.
      • findNamedColorFromRGB

        public String findNamedColorFromRGB​(int r,
                                            int g,
                                            int b)
        Метод повторяет предыдущий и отличается лишь входными параметрами, являющимися RGB-кодом
        Parameters:
        r - - десятичное число от 0 до 256 характеризующее интенсивность красного цвета
        g - - десятичное число от 0 до 256 характеризующее интенсивность зелёного цвета
        b - - десятичное число от 0 до 256 характеризующее интенсивность голубого цвета
        Returns:
        - метод возвращает название ближайшего именованного цвета
      • getNearestNamedColor

        private static Map.Entry<String,​Double> getNearestNamedColor​(List<ColorPoint> candidates,
                                                                           ColorPoint targetPoint)
        Вспомогательный метод используемый для поиска ближайшего именованного цвета. Метод принимает на вход
        Parameters:
        candidates - - список цветов-точек, являющихся ближайшими к введённому цвету-точке
        targetPoint - - цвет-точку, созданную на основе переданного пользователем цветового кода
        Returns:
        - метод возвращает пару ключ-значение с координатами и именем ближайшего цвета-точки
      • getDistanceToBucketSide

        private static double getDistanceToBucketSide​(ColorPoint targetPoint,
                                                      BucketOfColor targetBucket)
        Вспомогательный метод для поиска расстояния от цвета-точки до границы ведра
        Parameters:
        targetPoint - - цвет-точка, созданная на основе переданного пользователем цветового кода
        targetBucket - - ведро, в котором находится данная точка
        Returns:
        - метод возвращает переменную типа double с минимальным расстоянием до границы ведра