Класс RenderingHints

public static final RenderingHints.Key KEY_ANTIALIASING

Ключ подсказки по устранению ступенчатости. Подсказка ANTIALIASING определяет, будут ли методы отрисовки геометрии объекта Graphics2D пытаться уменьшить артефакты ступенчатости по краям фигур.

Типичный алгоритм устранения ступенчатости работает путём смешивания существующих цветов пикселей по границе фигуры с запрошенным цветом заливки в соответствии с оценкой частичного покрытия фигурой пикселей.

Допустимые значения для этой подсказки:

• VALUE_ANTIALIAS_ON
• VALUE_ANTIALIAS_OFF
• VALUE_ANTIALIAS_DEFAULT

public static final Object VALUE_ANTIALIAS_ON

Значение подсказки по устранению ступенчатости — отрисовка выполняется с устранением ступенчатости.

public static final Object VALUE_ANTIALIAS_OFF

Значение подсказки по устранению ступенчатости — отрисовка выполняется без устранения ступенчатости.

public static final Object VALUE_ANTIALIAS_DEFAULT

Значение подсказки по устранению ступенчатости — отрисовка выполняется с использованием режима устранения ступенчатости по умолчанию, выбранного реализацией.

public static final RenderingHints.Key KEY_RENDERING

Ключ подсказки по рендерингу. Подсказка RENDERING — это общая подсказка, которая даёт высокую рекомендацию относительно того, следует ли смещать выбор алгоритмов в сторону скорости или качества при оценке компромиссов. Эта подсказка может быть использована для любой операции рендеринга или обработки изображений, но решения обычно учитывают другие, более специфические подсказки, отдавая им предпочтение перед этой подсказкой.

Допустимые значения для этой подсказки:

• VALUE_RENDER_SPEED
• VALUE_RENDER_QUALITY
• VALUE_RENDER_DEFAULT

public static final Object VALUE_RENDER_SPEED

Значение подсказки по рендерингу — алгоритмы рендеринга выбираются с предпочтением к скорости вывода.

public static final Object VALUE_RENDER_QUALITY

Значение подсказки по рендерингу — алгоритмы рендеринга выбираются с предпочтением к качеству вывода.

public static final Object VALUE_RENDER_DEFAULT

Значение подсказки по рендерингу — алгоритмы рендеринга выбираются реализацией для достижения хорошего компромисса между производительностью и качеством.

public static final RenderingHints.Key KEY_DITHERING

Ключ подсказки по дизерингу. Подсказка DITHERING управляет тем, насколько точно приблизить цвет при сохранении в целевой области с ограниченной цветовой разрешающей способностью.

Некоторые целевые области рендеринга могут поддерживать ограниченное количество цветовых вариантов, которые могут не точно отображать весь спектр цветов, которые могут получиться во время операций рендеринга. Для таких целевых областей подсказка DITHERING управляет тем, выполняется ли рендеринг сплошной заливкой одного пиксельного значения, которое является ближайшим поддерживаемым цветом к тому, что было запрошено, или фигуры будут закрашиваться узором цветов, которые объединяются для лучшего приближения этого цвета.

Допустимые значения для этой подсказки:

• VALUE_DITHER_DISABLE
• VALUE_DITHER_ENABLE
• VALUE_DITHER_DEFAULT

public static final Object VALUE_DITHER_DISABLE

Значение подсказки по дизерингу — не использовать дизеринг при рендеринге геометрии.

public static final Object VALUE_DITHER_ENABLE

Значение подсказки по дизерингу — использовать дизеринг при рендеринге геометрии, если необходимо.

public static final Object VALUE_DITHER_DEFAULT

Значение подсказки по дизерингу — использовать значение по умолчанию для дизеринга, выбранное реализацией.

public static final RenderingHints.Key KEY_TEXT_ANTIALIASING

Ключ подсказки по устранению ступенчатости текста. Подсказка TEXT_ANTIALIASING может управлять использованием алгоритмов устранения ступенчатости для текста независимо от выбора, используемого для рендеринга фигур. Часто приложение может захотеть использовать устранение ступенчатости только для текста, а не для других фигур. Кроме того, алгоритмы уменьшения артефактов ступенчатости для текста часто более сложны, чем разработанные для общего рендеринга, поэтому этот ключ подсказки предоставляет дополнительные значения, которые могут управлять выбором некоторых из этих алгоритмов, специфичных для текста. Если оставить этот ключ в DEFAULT состоянии, эта подсказка обычно будет отсылать к значению обычной подсказки KEY_ANTIALIASING.

Допустимые значения для этой подсказки:

• VALUE_TEXT_ANTIALIAS_ON
• VALUE_TEXT_ANTIALIAS_OFF
• VALUE_TEXT_ANTIALIAS_DEFAULT
• VALUE_TEXT_ANTIALIAS_GASP
• VALUE_TEXT_ANTIALIAS_LCD_HRGB
• VALUE_TEXT_ANTIALIAS_LCD_HBGR
• VALUE_TEXT_ANTIALIAS_LCD_VRGB
• VALUE_TEXT_ANTIALIAS_LCD_VBGR

public static final Object VALUE_TEXT_ANTIALIAS_ON

Значение подсказки по устранению ступенчатости текста — рендеринг текста выполняется с какой-либо формой устранения ступенчатости.

public static final Object VALUE_TEXT_ANTIALIAS_OFF

Значение подсказки по устранению ступенчатости текста — рендеринг текста выполняется без какой-либо формы устранения ступенчатости.

public static final Object VALUE_TEXT_ANTIALIAS_DEFAULT

Значение подсказки по устранению ступенчатости текста — рендеринг текста выполняется в соответствии с подсказкой KEY_ANTIALIASING или по умолчанию, выбранному реализацией.

public static final Object VALUE_TEXT_ANTIALIAS_GASP

Значение подсказки по устранению ступенчатости текста — запрашивается рендеринг текста с использованием информации в ресурсе шрифта, которая для каждого размера точки указывает, применять VALUE_TEXT_ANTIALIAS_ON или VALUE_TEXT_ANTIALIAS_OFF.

Шрифты TrueType обычно предоставляют эту информацию в таблице 'gasp'. В отсутствие этой информации поведение для конкретного шрифта и размера определяется значениями по умолчанию реализации.

Примечание: Дизайнер шрифтов обычно тщательно подбирает шрифт для наиболее распространённых размеров шрифта пользовательского интерфейса. Вследствие чего таблица 'gasp' скорее всего укажет использовать только начертание шрифта при этих размерах, а не "сглаживание". Поэтому во многих случаях отображение текста эквивалентно VALUE_TEXT_ANTIALIAS_OFF. Это может быть неожиданно, но верно.

Логические шрифты, составленные из нескольких физических шрифтов, будут для согласованности использовать настройку, наиболее подходящую для составного шрифта в целом.

public static final Object VALUE_TEXT_ANTIALIAS_LCD_HRGB

Значение подсказки антиалиасинга текста — запрос отображения текста, оптимизированного для ЖК-дисплея с субпикселями R, G, B слева направо, причём горизонтальное разрешение субпикселей в три раза больше горизонтального разрешения полного пикселя (HRGB). Это наиболее распространённая конфигурация. Выбор этой подсказки для дисплеев с другой конфигурацией субпикселей ЖК-дисплея, вероятно, приведёт к нечёткому тексту.

Примечания:
Реализация при выборе, применять ли любое из значений подсказок текста для ЖК-дисплея, может учитывать факторы, включая необходимость глубины цвета назначения не менее 15 бит на пиксель (то есть 5 бит на цветовой компонент), характеристики шрифта, такие как возможность встраивания битовых карт для получения лучших результатов, или отображение на удалённом сетевом дисплее, разрешая это только в случае наличия соответствующих протоколов, или игнорирование подсказки при выполнении рендеринга с очень высоким разрешением или если целевое устройство не подходит: например, при печати.

Эти подсказки могут быть применены и при рендеринге в программные изображения, но эти изображения могут не подходить для общей экспортной задачи, так как текст будет рендерирован соответствующим образом для определённой организации субпикселей. Также не следует использовать сжатые изображения или форматы изображений, такие как GIF, имеющие ограниченное количество цветов. Поэтому, если изображение предназначено исключительно для рендеринга на устройстве отображения с той же конфигурацией, может быть предпочтительнее использовать другую подсказку антиалиасинга текста, такую как VALUE_TEXT_ANTIALIAS_ON.

Выбор значения, не соответствующего используемому ЖК-дисплею, скорее всего, приведёт к ухудшению качества текста. На устройствах отображения (например, CRT), не обладающих такими же характеристиками, как ЖК-дисплеи, общий эффект может быть аналогичен стандартному антиалиасингу текста, но качество может быть ухудшено искажением цвета. У ЖК-дисплеев с аналоговым подключением преимущества перед стандартным антиалиасингом текста также могут быть незначительными и аналогичны CRT.

Другими словами, для достижения наилучших результатов используйте ЖК-дисплей с цифровым разъёмом и укажите соответствующую конфигурацию субпикселей.

public static final Object VALUE_TEXT_ANTIALIAS_LCD_HBGR

Значение подсказки антиалиасинга текста — запрос отображения текста, оптимизированного для ЖК-дисплея с субпикселями B, G, R слева направо, причём горизонтальное разрешение субпикселей в три раза больше горизонтального разрешения полного пикселя (HBGR). Эта конфигурация встречается намного реже, чем HRGB. Выбор этой подсказки для дисплеев с другой конфигурацией субпикселей ЖК-дисплея, вероятно, приведёт к нечёткому тексту. См. VALUE_TEXT_ANTIALIAS_LCD_HRGB для получения дополнительной информации о применении этой подсказки.

public static final Object VALUE_TEXT_ANTIALIAS_LCD_VRGB

Значение подсказки антиалиасинга текста — запрос отображения текста, оптимизированного для ЖК-дисплея с субпикселями R, G, B сверху вниз, причём вертикальное разрешение субпикселей в три раза больше вертикального разрешения полного пикселя (VRGB). Вертикальная ориентация встречается крайне редко и, вероятно, полезна в основном для физически повернутого дисплея. Выбор этой подсказки для дисплеев с другой конфигурацией субпикселей ЖК-дисплея, вероятно, приведёт к нечёткому тексту. См. VALUE_TEXT_ANTIALIAS_LCD_HRGB для получения дополнительной информации о применении этой подсказки.

public static final Object VALUE_TEXT_ANTIALIAS_LCD_VBGR

Значение подсказки антиалиасинга текста — запрос отображения текста, оптимизированного для ЖК-дисплея с субпикселями B, G, R сверху вниз, причём вертикальное разрешение субпикселей в три раза больше вертикального разрешения полного пикселя (VBGR). Вертикальная ориентация встречается крайне редко и, вероятно, полезна в основном для физически повернутого дисплея. Выбор этой подсказки для дисплеев с другой конфигурацией субпикселей ЖК-дисплея, вероятно, приведёт к нечёткому тексту. См. VALUE_TEXT_ANTIALIAS_LCD_HRGB для получения дополнительной информации о применении этой подсказки.

public static final RenderingHints.Key KEY_TEXT_LCD_CONTRAST

Ключ подсказки рендеринга контраста текста ЖК-дисплея. Значение — Integer объект, используемый для регулировки контраста текста при использовании подсказки антиалиасинга текста ЖК-дисплея, такой как VALUE_TEXT_ANTIALIAS_LCD_HRGB.

• Значения должны быть положительными целыми числами в диапазоне от 100 до 250.
• Меньшее значение (например, 100) соответствует более высокому контрасту текста при отображении тёмного текста на светлом фоне.
• Большее значение (например, 200) соответствует более низкому контрасту текста при отображении тёмного текста на светлом фоне.
• Типичное полезное значение находится в узком диапазоне 140-180.
• Если значение не указано, будет применено системное или реализуемое значение по умолчанию.

Значение по умолчанию может быть достаточным для большинства целей, поэтому клиентам редко нужно указывать значение для этой подсказки, если нет конкретной информации о подходящем значении. Более высокое значение не означает более высокий контраст, на самом деле наоборот. Коррекция применяется аналогичным образом к корректировке гаммы для нелинейной перцептуальной световой отдачи систем отображения, но не указывает полную коррекцию для этого.

public static final RenderingHints.Key KEY_FRACTIONALMETRICS

Ключ подсказки дробных метрик шрифта. Подсказка FRACTIONALMETRICS контролирует, учитывается ли при позиционировании отдельных глифов шрифта субпиксельная точность масштабированных значений продвижения символов или эти векторы продвижения округляются до целого числа устройств пикселей. Эта подсказка лишь рекомендует, насколько высокая точность должна использоваться для позиционирования глифов и не указывает или не рекомендует, следует ли изменять фактическое растрирование или пиксельные границы глифов, чтобы соответствовать им.

Отображение текста на устройстве с низким разрешением, таком как экран, неизбежно предполагает ряд операций округления, так как высокая точность и очень точное определение формы и метрик глифов символов должны соответствовать дискретным пикселям устройства. В идеале позиционирование глифов при верстке текста должно рассчитываться путём масштабирования метрик дизайна шрифта в соответствии с размером шрифта, но масштабированная ширина продвижения не обязательно будет целым числом пикселей. Если глифы позиционируются с субпиксельной точностью в соответствии с этими масштабированными метриками дизайна, то для каждого возможного начала субпикселя необходимо будет скорректировать растрирование.

К сожалению, масштабирование каждого глифа, настроенного на его точное начало субпикселя при верстке текста, было бы слишком дорогостоящим, поэтому обычно используется упрощённая система, основанная на целочисленных позициях устройства для верстки текста. Растрирование глифа и масштабированная ширина продвижения корректируются вместе, чтобы получить текст, который выглядит хорошо при разрешении устройства, и имеет согласованные целые пиксельные расстояния между глифами, которые помогают глифам выглядеть равномерно и последовательно расположенными и читаемыми.

Этот процесс округления значений продвижения для растрированных глифов до целых расстояний означает, что плотность символов и общая длина строки текста будут отличаться от теоретических проектных измерений из-за накопления серии малых различий в скорректированных ширинах каждого глифа. Уникальные различия будут разными для каждого глифа, некоторые будут шире, а некоторые уже своих теоретических проектных измерений. Таким образом, общее различие в плотности символов и длине будет зависеть от ряда факторов, включая шрифт, целевое разрешение конкретного устройства и выбранные глифы для представления рендерируемой строки. В результате рендеринг той же строки на разных разрешениях устройств может привести к существенно различающимся метрикам для целых строк.

Когда FRACTIONALMETRICS включены, истинные метрики дизайна шрифта масштабируются размером шрифта и используются для верстки с субпиксельной точностью. Средняя плотность глифов и общая длина длинной строки символов, следовательно, будет более близкой к теоретическому дизайну шрифта, но читаемость может пострадать, поскольку отдельные пары символов не всегда будут казаться расположенными на постоянном расстоянии в зависимости от того, как накопление субпикселей исходных глифов сочетается с сеткой пикселей устройства. Включение этой подсказки может быть желательным при выполнении верстки текста, которая должна быть согласованной на широком диапазоне разрешений вывода. В частности, эта подсказка может быть желательна в ситуациях, когда макет текста предварительно просматривается на устройстве с низким разрешением, например, на экране, для вывода, который в конечном итоге будет рендериться на принтере или устройстве наборного текста с высоким разрешением.

При отключении масштабированные метрики дизайна округляются или корректируются до целых расстояний для верстки. Расстояния между любой парой глифов будут более однородными на устройстве, но плотность и общая длина длинных строк могут больше не соответствовать теоретическим целям дизайнера шрифта. Отключение этой подсказки, как правило, даёт более читаемые результаты на устройствах с низким разрешением, таких как мониторы компьютеров.

Допустимые значения для этого ключа:

• VALUE_FRACTIONALMETRICS_OFF
• VALUE_FRACTIONALMETRICS_ON
• VALUE_FRACTIONALMETRICS_DEFAULT

public static final Object VALUE_FRACTIONALMETRICS_OFF

Значение подсказки дробных метрик шрифта — положение глифов символов с округлением значений продвижения до границ пикселей.

public static final Object VALUE_FRACTIONALMETRICS_ON

Значение подсказки дробных метрик шрифта — глифы символов позиционируются с субпиксельной точностью.

public static final Object VALUE_FRACTIONALMETRICS_DEFAULT

Значение подсказки дробных метрик шрифта — глифы символов позиционируются с точностью, выбранной реализацией.

public static final RenderingHints.Key KEY_INTERPOLATION

Ключ подсказки интерполяции. Подсказка INTERPOLATION управляет тем, как пиксели изображения фильтруются или повторно образцуются во время операции рендеринга изображения.

Неявным образом предполагается, что изображения предоставляют цветовые образцы в целочисленных координатах. Когда изображения рендерятся вертикально без масштабирования на целевой объект, выбор того, какие пиксели изображения отображаются на каких пиксели устройства, очевиден, и образцы в целочисленных координатах изображения передаются на пиксели в соответствующих целочисленных координатах на сетке пикселей устройства один к одному. Когда изображения рендерятся в масштабируемой, вращаемой или преобразованной системе координат, отображение координат пикселей устройства обратно на изображение может поставить вопрос о том, какой цветовой образец использовать для непрерывных координат, которые лежат между целочисленными позициями предоставленных образцов изображения. Алгоритмы интерполяции определяют функции, которые предоставляют цветовой образец для любой непрерывной координаты в изображении на основе цветовых образцов в окружающих целочисленных координатах.

Допустимые значения для этой подсказки:

• VALUE_INTERPOLATION_NEAREST_NEIGHBOR
• VALUE_INTERPOLATION_BILINEAR
• VALUE_INTERPOLATION_BICUBIC

public static final Object VALUE_INTERPOLATION_NEAREST_NEIGHBOR

Значение подсказки интерполяции — используется цветовой образец ближайшего соседнего целочисленного образца координаты в изображении. Концептуально изображение рассматривается как сетка квадратных областей цвета единичного размера, центрированных вокруг центра каждого пикселя изображения.

При увеличении масштаба изображения оно будет выглядеть соответствующим образом блочным. При уменьшении масштаба изображения цвета исходных пикселей будут использоваться без изменений или будут полностью пропущены в представлении результата.

public static final Object VALUE_INTERPOLATION_BILINEAR

Значение подсказки интерполяции — цветовые образцы 4 ближайших соседних целочисленных образцов координаты в изображении линейно интерполируются для получения цветового образца. Концептуально изображение рассматривается как набор бесконечно малых точечных цветовых образцов, которые имеют значение только в центрах целочисленных пикселей координат, а пространство между этими центрами пикселей заполняется линейными градиентами цветов, которые соединяют смежные дискретные образцы прямой линией.

При увеличении масштаба изображения нет блочных границ между цветами в изображении, как в случае с NEAREST_NEIGHBOR, но сглаживание может показывать некоторые незначительные разрывы вдоль горизонтальных и вертикальных границ, совпадающих с образцами, вызванными внезапным изменением наклона интерполяции с одной стороны образца на другую. При уменьшении масштаба изображения больше пикселей изображения имеют свои цветовые образцы, представленные в результирующем выводе, поскольку каждый выходной пиксель получает цветовую информацию от до 4 пикселей изображения.

public static final Object VALUE_INTERPOLATION_BICUBIC

Значение подсказки интерполяции — цветовые образцы 9 близлежащих целочисленных образцов координаты в изображении интерполируются с помощью кубической функции как по X, так и по Y для получения цветового образца. Концептуально изображение рассматривается очень похоже на изображение, используемое в алгоритме BILINEAR, за исключением того, что градиенты цветов, соединяющие между образцами, изогнуты и имеют лучшую непрерывность наклона при пересечении границ образцов.

При увеличении масштаба изображения нет блочных границ, и интерполяция должна выглядеть более плавной и с лучшим изображением любых границ в исходном изображении, чем с BILINEAR. При уменьшении масштаба изображения еще больше исходных цветовых образцов из исходного изображения будут переданы и представлены.

public static final RenderingHints.Key KEY_ALPHA_INTERPOLATION

Ключ подсказки интерполяции альфа-канала. Подсказка ALPHA_INTERPOLATION — это общая подсказка, которая дает общее рекомендацию о том, стоит ли больше ориентироваться на скорость или качество алгоритмов смешивания альфа-канала при оценке компромиссов.

Эта подсказка может управлять выбором вычислений смешивания альфа-канала, которые жертвуют некоторой точностью для использования быстрых таблиц поиска или инструкций SIMD с меньшей точностью. Эта подсказка также может управлять тем, конвертируются ли значения цвета и альфа-канала в линейное цветовое пространство во время вычислений для более линейного визуального эффекта за счет дополнительных вычислений на каждый пиксель.

Допустимые значения для этой подсказки:

• VALUE_ALPHA_INTERPOLATION_SPEED
• VALUE_ALPHA_INTERPOLATION_QUALITY
• VALUE_ALPHA_INTERPOLATION_DEFAULT

public static final Object VALUE_ALPHA_INTERPOLATION_SPEED

Значение подсказки интерполяции альфа-канала — алгоритмы смешивания альфа-канала выбираются с предпочтением к скорости вычислений.

public static final Object VALUE_ALPHA_INTERPOLATION_QUALITY

Значение подсказки интерполяции альфа-канала — алгоритмы смешивания альфа-канала выбираются с предпочтением к точности и визуальному качеству.

public static final Object VALUE_ALPHA_INTERPOLATION_DEFAULT

Значение подсказки интерполяции альфа-канала — алгоритмы смешивания альфа-канала выбираются реализацией для оптимального соотношения производительности и качества.

public static final RenderingHints.Key KEY_COLOR_RENDERING

Ключ подсказки рендеринга цвета. Подсказка COLOR_RENDERING управляет точностью приближения и преобразования при сохранении цветов в целевом изображении или поверхности.

Когда операция рендеринга или обработки изображения генерирует значение цвета, которое должно быть сохранено в целевом объекте, оно сначала должно преобразовать этот цвет в форму, подходящую для хранения в целевом изображении или поверхности. Минимально, цветовые компоненты должны быть преобразованы в битовые представления и упорядочены в правильном порядке, или должен быть выбран индекс в таблицу поиска цветов, прежде чем данные могут быть сохранены в целевой памяти. Без этого минимального преобразования данные в целевом объекте, скорее всего, будут представлять случайные, неправильные или, возможно, даже неподдерживаемые значения. Алгоритмы быстрого преобразования результатов операций рендеринга в цветовой формат наиболее распространенных целевых объектов хорошо известны и довольно оптимальны для выполнения.

Простое выполнение самого базового преобразования цветовых форматов для хранения цветов в целевом объекте может потенциально игнорировать разницу в калибровке ColorSpace источника и назначения или другие факторы, такие как линейность гамма-коррекции. Если источник и назначение ColorSpace не идентичны, для корректного выполнения операции рендеринга с максимальной заботой о точности представляемых цветов цвета источника должны быть преобразованы в независимую от устройства ColorSpace, а результаты затем преобразованы обратно в целевое ColorSpace. Кроме того, если во время операции рендеринга должны выполняться вычисления, такие как смешивание нескольких цветовых источников, для достижения большей визуальной ясности, если промежуточное устройство, независимое от устройства ColorSpace, выбирается таким образом, чтобы существовала линейная зависимость между вычисляемыми значениями и восприятием человеком кривых отклика выходного устройства.

Допустимые значения для этой подсказки:

• VALUE_COLOR_RENDER_SPEED
• VALUE_COLOR_RENDER_QUALITY
• VALUE_COLOR_RENDER_DEFAULT

public static final Object VALUE_COLOR_RENDER_SPEED

Значение подсказки рендеринга цвета — выполнить наибыстрейшее преобразование цвета в формат выходного устройства.

public static final Object VALUE_COLOR_RENDER_QUALITY

Значение подсказки рендеринга цвета — выполнить вычисления преобразования цвета с максимальной точностью и визуальным качеством.

public static final Object VALUE_COLOR_RENDER_DEFAULT

Значение подсказки рендеринга цвета — выполнение вычислений преобразования цвета, как выбрано реализацией, для представления наилучшего компромисса между производительностью и точностью.

public static final RenderingHints.Key KEY_STROKE_CONTROL

Ключ подсказки управления нормализацией штрихов. Подсказка STROKE_CONTROL управляет тем, должна ли и разрешено ли реализации рендеринга изменять геометрию отрисованных фигур для различных целей.

Некоторые реализации могут использовать оптимизированную платформенную библиотеку рендеринга, которая может быть быстрее, чем традиционные алгоритмы программного рендеринга на данной платформе, но которая также может не поддерживать координаты с плавающей запятой. Некоторые реализации также могут иметь сложные алгоритмы, которые изменяют координаты пути таким образом, чтобы толстые линии выглядели более равномерными по ширине и интервалам.

Если реализация выполняет какой-либо тип модификации или "нормализации" пути, она никогда не должна перемещать координаты более чем на половину пикселя в любом направлении.

Допустимые значения для этой подсказки:

• VALUE_STROKE_NORMALIZE
• VALUE_STROKE_PURE
• VALUE_STROKE_DEFAULT

public static final Object VALUE_STROKE_DEFAULT

Значение подсказки управления нормализацией штрихов — геометрия может быть изменена или оставлена неизменной в зависимости от компромиссов в данной реализации. Обычно это значение позволяет реализации использовать быструю платформенную библиотеку рендеринга на основе целых координат, но не требует специально нормализации для равномерности или эстетики.

public static final Object VALUE_STROKE_NORMALIZE

Значение подсказки управления нормализацией штрихов — геометрия должна быть нормализована для улучшения равномерности или интервалов линий и общей эстетики. Обратите внимание, что различные алгоритмы нормализации могут быть более успешными, чем другие, для заданных входных путей.

public static final Object VALUE_STROKE_PURE

Значение подсказки управления нормализацией штрихов — геометрия должна остаться неизменной и отрисоваться с субпиксельной точностью.

public static final RenderingHints.Key KEY_RESOLUTION_VARIANT

Ключ подсказки варианта разрешения изображения. Подсказка RESOLUTION_VARIANT управляет тем, какой вариант разрешения изображения следует выбрать для рисования изображения.

• VALUE_RESOLUTION_VARIANT_DEFAULT
• VALUE_RESOLUTION_VARIANT_BASE
• VALUE_RESOLUTION_VARIANT_SIZE_FIT
• VALUE_RESOLUTION_VARIANT_DPI_FIT

public static final Object VALUE_RESOLUTION_VARIANT_DEFAULT

Значение подсказки варианта разрешения изображения — вариант разрешения изображения выбирается на основе эвристики по умолчанию, которая может зависеть от политик платформы.

public static final Object VALUE_RESOLUTION_VARIANT_BASE

Значение подсказки варианта разрешения изображения — всегда используется стандартное разрешение изображения.

public static final Object VALUE_RESOLUTION_VARIANT_SIZE_FIT

Значение подсказки варианта разрешения изображения — вариант разрешения изображения выбирается на основе DPI экрана и преобразования в контексте Graphics2D.

public static final Object VALUE_RESOLUTION_VARIANT_DPI_FIT

Значение подсказки варианта разрешения изображения — вариант разрешения изображения выбирается только на основе DPI экрана.

public RenderingHints(Map<RenderingHints.Key, ?> init)

Создаёт новый объект со значениями ключей и значений, инициализированных из указанного объекта Map, который может быть null.

public RenderingHints(RenderingHints.Key key, Object value)

Создаёт новый объект с указанной парой ключ/значение.

public int size()

Возвращает количество сопоставлений ключ-значение в этом объекте.

public boolean isEmpty()

Возвращает true, если этот объект не содержит сопоставлений ключ-значение.

public boolean containsKey(Object key)

Возвращает true, если этот объект содержит сопоставление для указанного ключа.

public boolean containsValue(Object value)

Возвращает true, если этот объект отображает один или несколько ключей на указанное значение. Более формально, возвращает true тогда и только тогда, когда этот объект содержит как минимум одно отображение на значение, такое, что указанное значение равно этому значению. Эта операция, вероятно, займёт время, линейно зависящее от размера объекта для большинства реализаций.

public Object get(Object key)

Возвращает значение, которому сопоставлен указанный ключ.

public Object put(Object key, Object value)

Сопоставляет указанный key со значением, указанным в этом объекте RenderingHints. Ни ключ, ни значение не могут быть null. Значение можно получить, вызвав метод get с ключом, равным исходному ключу.

public void add(RenderingHints hints)

Добавляет все ключи и соответствующие значения из указанного объекта RenderingHints в этот объект RenderingHints. Ключи, присутствующие в этом объекте RenderingHints, но отсутствующие в указанном объекте RenderingHints, не затрагиваются.

public void clear()

Очищает этот объект RenderingHints от всех пар ключ/значение.

public Object remove(Object key)

Удаляет ключ и соответствующее ему значение из этого объекта RenderingHints. Этот метод ничего не делает, если ключ отсутствует в этом объекте RenderingHints.

public void putAll(Map<?,?> m)

Копирует все отображения из указанного Map в этот объект RenderingHints. Эти отображения заменяют любые отображения, которые у этого объекта RenderingHints были для любых ключей, которые сейчас есть в указанном объекте Map.

public Set<Object> keySet()

Возвращает представление типа Set ключей, содержащихся в этом объекте RenderingHints. Множество поддерживается объектом RenderingHints, поэтому изменения в RenderingHints отражаются в Set и наоборот. Если объект RenderingHints изменяется во время итерации по Set, результаты итерации не определены. Множество поддерживает удаление элементов, что удаляет соответствующее отображение из RenderingHints, посредством операций Iterator.remove, Set.remove, removeAll retainAll и clear. Оно не поддерживает операции add или addAll.

public Collection<Object> values()

Возвращает представление типа Collection значений, содержащихся в этом объекте RenderingHints. Коллекция значений поддерживается объектом RenderingHints, поэтому изменения в RenderingHints отражаются в Collection и наоборот. Если объект RenderingHints изменяется во время итерации по Collection, результаты итерации не определены. Коллекция поддерживает удаление элементов, что удаляет соответствующее отображение из RenderingHints посредством операций Iterator.remove, Collection.remove, removeAll, retainAll и clear. Она не поддерживает операции add или addAll.

public Set<Map.Entry<Object,Object>> entrySet()

Возвращает представление типа Set отображений, содержащихся в этом объекте RenderingHints. Каждый элемент в возвращаемом наборе Set представляет собой запись Map.Entry. Набор поддерживается объектом RenderingHints, поэтому изменения в RenderingHints отражаются в Set. Если объект RenderingHints изменяется во время итерации по Set, результаты итерации не определены.

Набор отображений, возвращаемый объектом RenderingHints, не изменяемый.

public boolean equals(Object o)

Сравнивает указанный объект Object с этим объектом RenderingHints на равенство. Возвращает true, если указанный объект также является объектом Map и два объекта Map представляют одни и те же отображения. Более формально, два объекта Map t1 и t2 представляют одни и те же отображения, если t1.keySet().equals(t2.keySet()) и для каждого ключа k в t1.keySet(),

 (t1.get(k)==null ? t2.get(k)==null : t1.get(k).equals(t2.get(k)))
 

. Это гарантирует, что метод equals работает должным образом в разных реализациях интерфейса Map.

public int hashCode()

Возвращает код хэширования для этого объекта RenderingHints. Код хэширования объекта RenderingHints определяется как сумма кодов хэширования каждой Entry в представлении вида entrySet объекта RenderingHints. Это гарантирует, что t1.equals(t2) подразумевает, что t1.hashCode()==t2.hashCode() для любых двух объектов Map t1 и t2, как требуется общим контрактом интерфейса Object.hashCode.

public Object clone()

Создает копию этого объекта RenderingHints, содержащую те же данные, что и в этом объекте RenderingHints.

public String toString()

Возвращает довольно длинное строковое представление хэш-карты, содержащее сопоставления ключей и значений для этого RenderingHints объекта.