---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.2
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/util.hd.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.hd.md
  - href: https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.hd.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt?revision=r21950234
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt?revision=r21950234

# util.hd

Статический объект.

Позволяет работать с HD экранами различных устройств.

[Методы ](#methods-summary)

## Методы {#methods-summary}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [getPixelRatio](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.hd.md#getPixelRatio)() | Number | Возвращает отношение виртуальных пикселей на экране к физическим. ||
|| [selectRatio](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.hd.md#selectRatio)([hash](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.hd.md#selectRatio-param-hash)) | Number | Возвращает результат выборки — пиксельное соотношение, либо 1, если передана, например, строка. ||
|| [selectValue](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.hd.md#selectValue)([hash](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.hd.md#selectValue-param-hash)) | Object | Возвращает из переданного хэша объект равный или наиболее близкий к ключу соотношения пикселей. В случае, если передан не хэш, а, например, строка или функция, вернется она же. ||
|#

## Описание методов {#method_detail}

### getPixelRatio {#getPixelRatio}

```javascript
{Number} getPixelRatio()
```

**Возвращает** отношение виртуальных пикселей на экране к физическим.

### selectRatio {#selectRatio}

```javascript
{Number} selectRatio(hash)
```

**Возвращает** результат выборки — пиксельное соотношение, либо 1, если передана, например, строка.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`hash`](#selectRatio-param-hash)[*](*star) | — | Тип: [IRatioMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IRatioMap.md)

Объект типа [IRatioMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IRatioMap.md) для экранов с различным пиксельным соотношением. ||
|#

\* Обязательный параметр/опция.

### selectValue {#selectValue}

```javascript
{Object} selectValue(hash)
```

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

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`hash`](#selectValue-param-hash)[*](*star) | — | Тип: Object\|[IRatioMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IRatioMap.md)

Объект типа [IRatioMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IRatioMap.md) для экранов с различным пиксельным соотношением. ||
|#

\* Обязательный параметр/опция.

**Пример:**

```javascript
// Нам нужно добавить хорошо выглядящую на HD-экранах картинку на балун.
var balloonImages = {
   // Обычная картинка.
    "1": "100x100.png",
   // Картинка для Retina-экранов.
    "2": "200x200.png"
};
var img = ymaps.util.hd.selectValue(balloonImages);
// Добавляем точку на карту.
myMap.geoObjects.add(new ymaps.GeoObject({
    geometry: "Point",
    coordinates: [55, 37],
    properties: {
        balloonContent:
             '<img src="' + img + '" width="100" alt="" >'
    }
});
```

<!-- XLIFF_FARM_OWUzNGU0_CACHING -->

[*star]: Обязательный параметр.