osmgl 0.9.0 → 0.9.1

package/dist/osmgl.d.cts

@@ -1367,16 +1367,27 @@ interface ModelLayerSpec {
         /** Прятать здание, которое модель заменяет (`replaces` + `anchor: replace`). */
         maskReplaced?: boolean;
         /**
-         * Показывать модели СРАЗУ во всей подробности, с самого нижнего зума.
+         * Полная геометрия (lod0) с самого нижнего зума, без упрощённой ступени.
          *
-         * По умолчанию у порога показа объект получает упрощённую геометрию (lod1) и четверть бюджета:
-         * на общем плане он занимает считанные пиксели, и подробность там не видна, а трафик и кадр
-         * стоит. Флаг отменяет обе поблажки — полный lod0 и полный бюджет на любом зуме.
+         * По умолчанию у порога показа объект получает lod1 и «дорисовывается» до lod0 только через
+         * два зума. На общем плане это незаметно, но если карта показывает объект как достопримечательность,
+         * читается браком: сначала огрублённый силуэт, потом подмена.
          *
-         * Включать с открытыми глазами: модели дают около 84 % треугольников кадра, и на широком
-         * экране полный набор с нижнего зума — это и загрузка, и память.
+         * Число объектов флаг НЕ трогает — за него отвечает `fullBudget`. Разделены они не для порядка:
+         * замер на боевой карте (Душанбе, z15.2, окно 1551×1346, наклон 55°) показал, что кадр сажает
+         * именно количество, а не подробность — со снятыми обеими поблажками медиана кадра при панораме
+         * была 30–38 мс против 17 мс на z17.8.
          */
         fullDetail?: boolean;
+        /**
+         * Полный бюджет моделей с нижнего зума.
+         *
+         * По умолчанию на пороге показа берётся четверть бюджета, и дальше он плавно растёт до полного
+         * за три зума: на общем плане объект занимает считанные пиксели, и сотня таких объектов стоит
+         * кадра и трафика, ничего не добавляя глазу. Включать на широком экране с осторожностью —
+         * модели дают около 84 % треугольников кадра.
+         */
+        fullBudget?: boolean;
     };
 }
 type StyleLayerSpec = FillLayerSpec | LineLayerSpec | FillExtrusionLayerSpec | SurfaceLayerSpec | SymbolLayerSpec | RasterLayerSpec;

package/dist/osmgl.d.ts

@@ -1367,16 +1367,27 @@ interface ModelLayerSpec {
         /** Прятать здание, которое модель заменяет (`replaces` + `anchor: replace`). */
         maskReplaced?: boolean;
         /**
-         * Показывать модели СРАЗУ во всей подробности, с самого нижнего зума.
+         * Полная геометрия (lod0) с самого нижнего зума, без упрощённой ступени.
          *
-         * По умолчанию у порога показа объект получает упрощённую геометрию (lod1) и четверть бюджета:
-         * на общем плане он занимает считанные пиксели, и подробность там не видна, а трафик и кадр
-         * стоит. Флаг отменяет обе поблажки — полный lod0 и полный бюджет на любом зуме.
+         * По умолчанию у порога показа объект получает lod1 и «дорисовывается» до lod0 только через
+         * два зума. На общем плане это незаметно, но если карта показывает объект как достопримечательность,
+         * читается браком: сначала огрублённый силуэт, потом подмена.
          *
-         * Включать с открытыми глазами: модели дают около 84 % треугольников кадра, и на широком
-         * экране полный набор с нижнего зума — это и загрузка, и память.
+         * Число объектов флаг НЕ трогает — за него отвечает `fullBudget`. Разделены они не для порядка:
+         * замер на боевой карте (Душанбе, z15.2, окно 1551×1346, наклон 55°) показал, что кадр сажает
+         * именно количество, а не подробность — со снятыми обеими поблажками медиана кадра при панораме
+         * была 30–38 мс против 17 мс на z17.8.
          */
         fullDetail?: boolean;
+        /**
+         * Полный бюджет моделей с нижнего зума.
+         *
+         * По умолчанию на пороге показа берётся четверть бюджета, и дальше он плавно растёт до полного
+         * за три зума: на общем плане объект занимает считанные пиксели, и сотня таких объектов стоит
+         * кадра и трафика, ничего не добавляя глазу. Включать на широком экране с осторожностью —
+         * модели дают около 84 % треугольников кадра.
+         */
+        fullBudget?: boolean;
     };
 }
 type StyleLayerSpec = FillLayerSpec | LineLayerSpec | FillExtrusionLayerSpec | SurfaceLayerSpec | SymbolLayerSpec | RasterLayerSpec;