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

Значение подсказки интерполяции — цвета 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()

Возвращает количество сопоставлений ключ-значение в этом 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, результаты итерации не определены. Набор поддерживает удаление элементов, которое удаляет соответствующее сопоставление из 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.