Package ru.folko85.tableofcolor
Class TableOfColor
- java.lang.Object
-
- ru.folko85.tableofcolor.TableOfColor
-
public class TableOfColor extends Object
Основной класс библиотеки - таблица именованных цветов. При создании таблицы именованные цвета извлекаются из yml-файла и раскладываются по вёдрам- Version:
- 1.0.6
- Author:
- Othernik aka Folko85
-
-
Field Summary
Fields Modifier and Type Field Description private List<BucketOfColor>bucketsПоле - список вёдерprivate List<ColorPoint>colorsПоле - список точек-цветовprivate int[]endPointПоле - конечная граничная точка рабочей областиprivate static intmaxPointsCountПоле - максимальное количество точек-цветов в ведреprivate int[]startPointПоле - начальная граничная точка рабочей областиprivate StringymlFileПоле - имя файла
-
Constructor Summary
Constructors Constructor Description TableOfColor(Locale locale)Конструктор - создание нового объекта с определенными значениями
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description private voiddistributePoints(List<ColorPoint> points)Метод распределяет все именованные цвета по вёдрамprivate List<ColorPoint>extractYml(String ymlFile)Метод извлечения точек из yml-файлаprivate BucketOfColorfindBucket(ColorPoint point)Метод поиска подходящего ведра для точки-цвета.StringfindNamedColorFromHex(String hexCode)Основной метод библиотеки - поиск ближайшего именованного цветаStringfindNamedColorFromRGB(int r, int g, int b)Метод повторяет предыдущий и отличается лишь входными параметрами, являющимися RGB-кодомprivate static doublegetDistanceToBucketSide(ColorPoint targetPoint, BucketOfColor targetBucket)Вспомогательный метод для поиска расстояния от цвета-точки до границы ведраprivate static Map.Entry<String,Double>getNearestNamedColor(List<ColorPoint> candidates, ColorPoint targetPoint)Вспомогательный метод используемый для поиска ближайшего именованного цвета.private voidsplitBucket(BucketOfColor resultBucket)Метод разделения вёдер при переполнении.
-
-
-
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 с минимальным расстоянием до границы ведра
-
-