/*
 * _pop_draw.h — внутренний заголовок слоя отрисовки: выбор ядра libbgi
 * (клипающее / линейное «noclip») по одному и тому же тесту для блита и
 * для heal.
 *
 * ПОЧЕМУ ОТДЕЛЬНЫЙ ФАЙЛ, А НЕ pop_bg.h.  Обе функции — `static inline`, а
 * SDCC 4.5 оставляет тело такой функции в КАЖДОМ TU, который видит
 * объявление, даже если тот её не зовёт (memory
 * `sdcc_inline_codegen_findings`).  pop_bg.h включают почти все модули PoP,
 * то есть из общего заголовка эти ~100 Б размножились бы десятком мёртвых
 * копий (замер CLIP-1, 2026-08-01: +1091 Б в _CODE и +636 Б в банке
 * стража — за код, который там никто не вызывает).  Здесь их видят ровно
 * три файла, которые реально рисуют: pop_bg.c, pop_kid.c, pop_gdraw.c.
 */
#ifndef POP_DRAW_H
#define POP_DRAW_H

#include <stdint.h>
#include <gfx.h>

/* Спрайт целиком на экране И укладывается в 8-битные параметры noclip-
 * примитивов libbgi?  Условие входа в gfx_blit_cols_part_noclip: клипающий
 * вариант платит ~5.6 К тактов подготовки на КАЖДЫЙ вызов, независимо от
 * того, вылезает край или нет. */
static inline uint8_t pop_onscreen_cols(int x, int y, uint16_t w, uint16_t h)
{
    return (uint8_t)(x >= 0 && y >= 0 && w < 256 && h < 256 &&
                     x + (int)w <= 320 && y + (int)h <= 256);
}

/* Стереть прямоугольник (heal из ОЗУ-копии) тем же приёмом, что и блит:
 * целиком на экране → линейное ядро без клипа.  Условие входа у
 * gfx_heal_noclip ровно то же, что у gfx_blit_cols_part_noclip, поэтому
 * тест один — общее ядро gfx_heal платит за клип и 16-бит, а не за пиксели
 * (замер: 11 658 тактов на heal 22×22).
 *
 * НЕ inline (тело — pop_draw.c, резидент W1): SDCC 4.5 встраивал бы его в
 * каждое место вызова по 181 Б И оставлял мёртвую копию в каждом TU — см.
 * шапку pop_draw.c с замером.  Зовётся 5 раз за кадр, цена вызова тонет в
 * стоимости самого heal.
 *
 * w/h тут int, а не uint16_t: вызывающие считают их вычитанием (h − skip), и
 * отрицательный результат обязан быть no-op, а не превратиться в огромный
 * unsigned. */
void pop_heal_fast(int x, int y, int w, int h);

#endif
