Класс 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.

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

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

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

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

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

public static final Object VALUE_INTERPOLATION_BICUBIC

Значение подсказки интерполяции — цветовые отсчёты девяти близлежащих целочисленных отсчётов координат изображения интерполируются с помощью кубической функции по 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()

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

public boolean isEmpty()

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

public boolean containsKey(Object key)

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

public boolean containsValue(Object value)

Возвращает true, если RenderingHints сопоставляет один или несколько ключей указанному значению. Точнее, возвращает true тогда и только тогда, когда этот RenderingHints содержит хотя бы одно сопоставление со значением v, для которого выполняется условие

(value==null ? v==null : value.equals(v))

. Для большинства реализаций RenderingHints эта операция, вероятно, потребует времени, линейно зависящего от размера RenderingHints.

public Object get(Object key)

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

public Object put(Object key, Object value)

Связывает указанный key с указанным value в этом объекте 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, результаты итерации не определены. Объект Set поддерживает удаление элементов, которое удаляет соответствующее соответствие из объекта RenderingHints с помощью операций Iterator.remove, Set.remove, removeAll retainAll и clear. Операции add и addAll не поддерживаются.

public Collection<Object> values()

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

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

Возвращает представление в виде Set соответствий, содержащихся в этом объекте RenderingHints. Каждый элемент возвращаемого объекта Set является объектом Map.Entry. Объект Set связан с объектом 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.