osmgl 0.14.0 → 0.15.0

package/README.md

@@ -158,6 +158,31 @@ nginx отдаёт его двумя путями — `/maps/osmgl.global.js` (
 выключенным depth-тестом (всё лежит на z=0, тест дал бы только z-fighting), затем
 объёмные слои с честной глубиной.
 
+### Линия, уступающая подробному слою (`yieldTo`)
+
+Пара «линия дороги — асфальт» живёт в разных наборах тайлов: линия приходит с основой, асфальт
+(полотно по графу) — своим набором с z15. Гасить линию `maxzoom` по зуму камеры нельзя, и это
+измерено, а не придумано:
+
+- пока тайл асфальта едет, улицы нет вовсе — ни линии, ни полотна (замер с задержкой ответов
+  полотна на 4 с: с `maxzoom` проезжая часть пуста, с уступкой видна вся сеть);
+- у наклонённой карты дальние тайлы рисуются с меньшей подробностью (`Transform.detailZoom`), и
+  асфальт с `minzoom: 15` гаснет вдали сам. На z15.6 при наклоне 75° дорог не было в дальней
+  трети кадра — подписи улиц висели над пустой землёй.
+
+Поэтому линия объявляет `"yieldTo": "<id поверхности>"` и рисуется везде, КРОМЕ квадратов тайлов,
+в которых эта поверхность в кадре уже легла. Квадраты ставятся битом трафарета (`PAINTED_BIT`) перед
+проходом поднятых линий и снимаются после него. Это «грубое сразу, подробное кусками» у Baidu
+(`useThumbData`).
+
+Уступка идёт ПО КВАДРАТУ ТАЙЛА, а не по пикселю асфальта: линия дороги шире полотна (ширина линии —
+приём картографии в пикселях), и маска по самому асфальту оставила бы вдоль кромки полоску старой
+линии. Квадрат, чья геометрия отложена бюджетом загрузки, не ставится — иначе в нём на кадр не было
+бы ни того, ни другого. Там, где асфальт уже загружен, кадр совпадает с прежним до пикселя.
+
+ГОЧА: на слабом профиле поверхность рисуется ЗАЛИВКОЙ (`flattened`), поэтому квадраты пишет и
+`drawFill`. Без этого на телефоне линии лежали поверх асфальта, а на компьютере — нет.
+
 ### Разноцветная линия
 
 Маршрут, раскрашенный по пробкам, — как у Яндекса: