forked from Blendman974/faceclaw
257 lines
11 KiB
TypeScript
257 lines
11 KiB
TypeScript
import { getDefaultLargeFont, getDefaultMediumFont, getDefaultSmallFont } from "../../graphics/ui-fonts";
|
|
import { GrayImage, type UiFont } from "../../graphics/image";
|
|
import { wrapText, truncateText } from "../../graphics/textwrap";
|
|
import { WEATHER_SOURCE_NAMES, type ForecastPeriod, type WeatherState } from "../../native/weather";
|
|
import { GESTURE_CLICK, type InputEvent } from "../../ui/gestures";
|
|
import { type Layer, type LayerContext } from "../../ui/layers";
|
|
import { Menu, type MenuDrawArgs } from "../../ui/menu-core";
|
|
import { centeredTextY, lineStep, tightRowHeight } from "../../ui/metrics";
|
|
import { renderWeatherIcon } from "./weather-icons";
|
|
import { formatTemperature, widestTemperatureSample } from "./temperature-format";
|
|
|
|
const PAGE_X = 18;
|
|
const HEADER_Y = 8;
|
|
const CURRENT_TOP = 34;
|
|
/** Minimum x of the description column right of the temperature. */
|
|
const CURRENT_TEXT_X = 112;
|
|
/** The current-conditions icon, left of the temperature. */
|
|
const CURRENT_ICON_SIZE = 40;
|
|
const CURRENT_ICON_GAP = 10;
|
|
/** Gap between the temperature and the description column. */
|
|
const CURRENT_TEXT_GAP = 16;
|
|
const FORECAST_HEADER_Y = 105;
|
|
const FORECAST_TOP = 124;
|
|
/** Forecast rows hold a 20px icon; grow with the font past that. */
|
|
const FORECAST_MIN_ROW_HEIGHT = 23;
|
|
/** Gap between forecast columns. */
|
|
const FORECAST_COL_GAP = 14;
|
|
/** Left edge of the forecast rows' selection boxes. */
|
|
const FORECAST_BOX_X = PAGE_X - 7;
|
|
/** Pixels between consecutive forecast rows' selection boxes. */
|
|
const FORECAST_ROW_GAP = 2;
|
|
|
|
/** Forecast column x offsets from the row box's left edge. */
|
|
type ForecastColumns = { name: number; temp: number; precip: number; summary: number };
|
|
|
|
/** Weather's current-conditions summary and scrollable 12-hour forecast. */
|
|
export class WeatherLayer implements Layer {
|
|
/** Forecast table rows: selection only, a click does nothing there. */
|
|
private readonly forecastMenu = new Menu<ForecastPeriod>({
|
|
wrap: false,
|
|
rowGap: FORECAST_ROW_GAP,
|
|
highlight: { radius: 5 },
|
|
getHeight: () => forecastRowHeight(getDefaultSmallFont()),
|
|
draw: (args) => this.drawForecastRow(args),
|
|
});
|
|
/** Column layout for drawForecastRow, set by each drawForecast. */
|
|
private columns: ForecastColumns = { name: 0, temp: 0, precip: 0, summary: 0 };
|
|
|
|
constructor(
|
|
private readonly state: () => WeatherState,
|
|
private readonly requestUpdate: () => void,
|
|
) {}
|
|
|
|
paint(ctx: LayerContext): GrayImage {
|
|
const font = getDefaultSmallFont();
|
|
const { width, height } = ctx.stack.getBaseSize();
|
|
const image = new GrayImage(width, height, 0);
|
|
const weather = this.state();
|
|
image.drawText(font, PAGE_X, HEADER_Y, "Weather", 225);
|
|
if (weather.locationName) {
|
|
image.drawText(
|
|
font,
|
|
width - PAGE_X - font.measureText(truncateText(font, weather.locationName, 220)),
|
|
HEADER_Y,
|
|
truncateText(font, weather.locationName, 220),
|
|
150,
|
|
);
|
|
}
|
|
|
|
if (weather.phase === "permission-required") {
|
|
this.drawMessage(
|
|
image,
|
|
font,
|
|
width,
|
|
height,
|
|
"Allow approximate location on your phone to get local weather.",
|
|
`${GESTURE_CLICK} request`,
|
|
);
|
|
return image;
|
|
}
|
|
// A refresh with earlier data in hand keeps showing that data.
|
|
if ((weather.phase === "locating" || weather.phase === "loading") && !weather.current) {
|
|
this.drawMessage(image, font, width, height, weather.status);
|
|
return image;
|
|
}
|
|
if (weather.phase === "error") {
|
|
this.drawMessage(image, font, width, height, weather.status, `${GESTURE_CLICK} retry`);
|
|
return image;
|
|
}
|
|
|
|
this.drawCurrent(image, weather, width);
|
|
this.drawForecast(image, weather.forecast, ctx, width, height);
|
|
return image;
|
|
}
|
|
|
|
handleInput(event: InputEvent): void {
|
|
const weather = this.state();
|
|
if (event.type === "click") {
|
|
// Refresh on the forecast view lives in the long-press menu; a tap
|
|
// only acts on the permission prompt and the error screen.
|
|
if (weather.phase === "permission-required" || weather.phase === "error") {
|
|
this.requestUpdate();
|
|
}
|
|
return;
|
|
}
|
|
if (!weather.forecast.length || !showsForecast(weather)) return;
|
|
if (event.type === "scroll-up" || event.type === "scroll-down") {
|
|
this.forecastMenu.setItems(weather.forecast);
|
|
void this.forecastMenu.handleInput(event);
|
|
}
|
|
}
|
|
|
|
private drawCurrent(image: GrayImage, weather: WeatherState, width: number): void {
|
|
const current = weather.current;
|
|
if (!current) return;
|
|
const large = getDefaultLargeFont();
|
|
const medium = getDefaultMediumFont();
|
|
const small = getDefaultSmallFont();
|
|
const temperature = current.temperatureF === null ? "--°" : formatTemperature(current.temperatureF);
|
|
const temperatureY = CURRENT_TOP + 8;
|
|
let temperatureX = PAGE_X;
|
|
if (current.condition) {
|
|
const icon = renderWeatherIcon(current.condition, current.isDaytime, CURRENT_ICON_SIZE);
|
|
if (icon) image.drawImage(icon, PAGE_X, temperatureY + (((large.lineHeight - icon.height) / 2) | 0));
|
|
temperatureX += CURRENT_ICON_SIZE + CURRENT_ICON_GAP;
|
|
}
|
|
image.drawText(large, temperatureX, temperatureY, temperature, 245);
|
|
const textX = Math.max(CURRENT_TEXT_X, temperatureX + Math.ceil(large.measureText(temperature)) + CURRENT_TEXT_GAP);
|
|
// Description / details / source stack compactly from just below the
|
|
// header line, so at large font sizes they stay clear of the forecast
|
|
// table instead of running into it.
|
|
let cy = 30;
|
|
image.drawText(
|
|
medium,
|
|
textX,
|
|
cy,
|
|
truncateText(medium, current.description || "Current conditions", width - textX - PAGE_X),
|
|
220,
|
|
);
|
|
cy += medium.lineHeight + 2;
|
|
|
|
const details: string[] = [];
|
|
if (current.humidityPercent !== null) details.push(`Humidity ${Math.round(current.humidityPercent)}%`);
|
|
if (current.windSpeedMph !== null) {
|
|
details.push(`Wind ${current.windDirection ? `${current.windDirection} ` : ""}${Math.round(current.windSpeedMph)} mph`);
|
|
}
|
|
image.drawText(small, textX, cy, details.join(" ") || "Current forecast", 170);
|
|
cy += lineStep(small);
|
|
// Naming the source also credits Open-Meteo, as its CC BY licence asks.
|
|
const sourceName = weather.source ? `${WEATHER_SOURCE_NAMES[weather.source]} ` : "";
|
|
const source = `${sourceName}${current.observed ? "observed" : "forecast"}`;
|
|
const age = current.timestampMs ? formatAge(Date.now() - current.timestampMs) : "";
|
|
const updating = weather.phase === "locating" || weather.phase === "loading" ? " · updating" : "";
|
|
image.drawText(small, textX, cy, `${source}${age ? ` ${age}` : ""}${updating}`, 105);
|
|
image.drawLine(PAGE_X, FORECAST_HEADER_Y - 7, width - PAGE_X, FORECAST_HEADER_Y - 7, 40);
|
|
}
|
|
|
|
private drawForecast(
|
|
image: GrayImage,
|
|
forecast: ForecastPeriod[],
|
|
ctx: LayerContext,
|
|
width: number,
|
|
height: number,
|
|
): void {
|
|
const font = getDefaultSmallFont();
|
|
if (!forecast.length) {
|
|
image.drawText(font, PAGE_X, FORECAST_TOP, "No upcoming forecast periods.", 160);
|
|
return;
|
|
}
|
|
const rowH = forecastRowHeight(font);
|
|
// The last row only needs its text line (not a full row pitch of
|
|
// clearance below), which usually fits one more row before the bottom.
|
|
// The menu only draws rows whose whole selection box fits, so the box
|
|
// holds that many rows, cut at the image's bottom edge.
|
|
const visibleRows = Math.max(1, 1 + Math.floor((height - FORECAST_TOP - (font.lineHeight + 4)) / rowH));
|
|
const boxTop = FORECAST_TOP - 2;
|
|
const boxHeight = Math.min(visibleRows * rowH - FORECAST_ROW_GAP, height - boxTop);
|
|
|
|
// Columns are sized to the widest period name so names ("Wednesday
|
|
// Night") never truncate; the summary column absorbs what's left.
|
|
const nameWidth = Math.max(
|
|
font.measureText("Upcoming"),
|
|
...forecast.map((period) => font.measureText(period.name)),
|
|
);
|
|
const tempX = PAGE_X + nameWidth + FORECAST_COL_GAP;
|
|
const precipX = tempX + Math.max(font.measureText("Temp"), font.measureText(widestTemperatureSample())) + FORECAST_COL_GAP;
|
|
const summaryX = precipX + Math.max(font.measureText("Rain"), font.measureText("100%")) + FORECAST_COL_GAP;
|
|
|
|
image.drawText(font, PAGE_X, FORECAST_HEADER_Y, "Upcoming", 150);
|
|
image.drawText(font, tempX, FORECAST_HEADER_Y, "Temp", 105);
|
|
image.drawText(font, precipX, FORECAST_HEADER_Y, "Rain", 105);
|
|
|
|
this.columns = {
|
|
name: PAGE_X - FORECAST_BOX_X,
|
|
temp: tempX - FORECAST_BOX_X,
|
|
precip: precipX - FORECAST_BOX_X,
|
|
summary: summaryX - FORECAST_BOX_X,
|
|
};
|
|
this.forecastMenu.setItems(forecast);
|
|
this.forecastMenu.paint(
|
|
image,
|
|
{ x: FORECAST_BOX_X, y: boxTop, width: width - 2 * FORECAST_BOX_X, height: boxHeight },
|
|
ctx.stack.isFocused(),
|
|
);
|
|
}
|
|
|
|
private drawForecastRow({ image, item: period, x, y, width, height, selected }: MenuDrawArgs<ForecastPeriod>): void {
|
|
const font = getDefaultSmallFont();
|
|
const columns = this.columns;
|
|
const shade = selected ? 245 : 190;
|
|
const textY = centeredTextY(font, y, height);
|
|
image.drawText(font, x + columns.name, textY, period.name, shade);
|
|
image.drawText(font, x + columns.temp, textY, period.temperatureF === null ? "--" : formatTemperature(period.temperatureF), shade);
|
|
image.drawText(font, x + columns.precip, textY, period.precipitationPercent === null ? "--" : `${Math.round(period.precipitationPercent)}%`, selected ? 220 : 155);
|
|
// The summary stops PAGE_X short of the viewport's right edge, as the name starts PAGE_X in from the left.
|
|
const summaryWidth = width - columns.summary - columns.name;
|
|
image.drawText(font, x + columns.summary, textY, truncateText(font, period.shortForecast, summaryWidth), selected ? 220 : 165);
|
|
}
|
|
|
|
private drawMessage(
|
|
image: GrayImage,
|
|
font: UiFont,
|
|
width: number,
|
|
height: number,
|
|
message: string,
|
|
footer?: string,
|
|
): void {
|
|
const lines = wrapText(font, message, width - 2 * (PAGE_X + 6));
|
|
const top = Math.max(52, Math.round((height - lines.length * 15) / 2) - 8);
|
|
for (let index = 0; index < lines.length; index++) {
|
|
image.drawText(font, PAGE_X + 6, top + index * 15, lines[index]!, 185);
|
|
}
|
|
if (footer) {
|
|
image.drawText(font, PAGE_X, height - 20, footer, 110);
|
|
}
|
|
}
|
|
}
|
|
|
|
/** Whether paint shows the forecast table (ready, or refreshing over earlier data). */
|
|
function showsForecast(weather: WeatherState): boolean {
|
|
if (weather.phase === "ready") return true;
|
|
return (weather.phase === "locating" || weather.phase === "loading") && weather.current !== null;
|
|
}
|
|
|
|
/** Forecast row pitch, including the gap between selection boxes. */
|
|
function forecastRowHeight(font: UiFont): number {
|
|
return Math.max(FORECAST_MIN_ROW_HEIGHT, tightRowHeight(font) + 3);
|
|
}
|
|
|
|
function formatAge(ageMs: number): string {
|
|
const minutes = Math.max(0, Math.round(ageMs / 60_000));
|
|
if (minutes < 1) return "just now";
|
|
if (minutes < 60) return `${minutes}m ago`;
|
|
return `${Math.round(minutes / 60)}h ago`;
|
|
}
|
|
|