picker_screen_int.h

Go to the documentation of this file.

#pragma once
 
#include <stdbool.h>
#include <stdint.h>
 
#include "gfx.h"
#include "link_drawing.h"
#include "out_bind.h"
#include "outputs_screen.h"
#include "picker_screen.h"
#include "ui_cats.h"
#include "ui_layout.h"
#include "ui_screen.h"
#include "ui_widgets.h"
 
#define SCREEN_W UI_PANEL_W   
#define SCREEN_H UI_BODY_H    
#define MAX_FBS  3     

#define FOOT (UI_ALERT_Y - UI_BAND_H - 4)

#define PK_FONT_LABEL (&gfx_font_10x20)
#define PK_FONT_FINE  (&gfx_font_8x16)    
#define PK_FONT_PIN   (&gfx_font_16x28)   
#define PK_FONT_HEAD  (&gfx_font_20x36)   
#define PK_CELL       10 

#define BOARD_W  600
#define BOARD_MAX_H 240   

#define TIERS 2               
#define TGAP  6               
#define BTNW  50              
#define KEY_H UI_BTN_H_TALL   
#define GAP   6         
 
_Static_assert((FOOT - BOARD_MAX_H) / 2 >= TIERS * KEY_H + TGAP + GAP,
               "two tiers of keys fit above and below the tallest board");
_Static_assert(BTNW >= UI_TAP_MIN && KEY_H >= UI_TAP_MIN,
               "a key is a finger wide and tall");
 
/*
 * The marks inside the board.  A ground is a round marker 36px across, 40
 * px in from its pad: a servo lead needs a ground as much as a signal, so it
 * is as legible as a button, and grounds are five pads apart, so it has
 * nothing to collide with.  A rail is 32px across, enough for "5V0", at one
 * of two depths that alternate along the row: rails sit on neighbouring
 * pads, 29px apart, and a rail beside a ground goes below the ground's
 * marker -- 78px is the ground's 40 plus both radii and both rings.
 */
#define GND_R       18                  
#define GND_DROP    40                  
#define RAIL_R      16                  
#define RAIL_DROP_0 30
#define RAIL_DROP_1 78                  
#define RING        2                   

#define HEAD_X      8         
#define HEAD_Y      8         
#define HEAD_W      350       
#define FACE_W      280       
#define FACE_H      56        
#define COUNT_Y     (HEAD_Y + FACE_H + 8) 
#define REASON_Y    (COUNT_Y + 24) 
#define REASON_PITCH 22   
#define HEAD_H      (REASON_Y + REASON_PITCH + 20 - HEAD_Y)
 
/*
 * The open list covers the board, as it covers the pins on OUTPUTS: the
 * protocols in a column of 48px rows from the face's top, the PROG PORT
 * entries in a second column beside it.  With its margins and shadow it
 * ends at body y 404.
 */
#define POP_W       300       
#define POP_ROW     UI_TAP_MIN 
 
_Static_assert(HEAD_Y + (int)OUTBIND_PROTOS * POP_ROW + 8 + 4 <= FOOT,
               "the protocol list ends above the alert band");

#define PINS_X      8         
#define PINS_Y      (HEAD_Y + HEAD_H + 10) 
#define PINS_W      171       
#define PINS_NAME_X 34        
#define PINS_TOP    (PINS_Y + 48)   
#define ROW_H       36        
 
_Static_assert(PINS_TOP + (int)LINK_OUT_SLOTS * ROW_H <= FOOT,
               "the PINS table holds 8 pins above the alert band");
_Static_assert(PINS_NAME_X + 7 * 16 + 4 <= PINS_W - 2 * PK_CELL,
               "a pin name (GPIO 28) ends 4px left of a two-digit pad");
_Static_assert(PINS_X + PINS_W + 8 <= (SCREEN_W - BOARD_W) / 2 - BTNW / 2,
               "the PINS table ends 8px left of any key");

#define USE_W       168       
#define USE_X       (SCREEN_W - 8 - USE_W) 
#define USE_Y       4         
#define USE_TOP     (USE_Y + 56) 
#define USE_FOOT    FOOT      
#define USE_NAME_H  20        
#define USE_PIN_H   28        
#define USE_PIN_H_C 20        
#define USE_PIN_H_D 16        
 
_Static_assert(USE_X >= (SCREEN_W + BOARD_W) / 2 + BTNW / 2 + 8,
               "the IN USE table starts 8px right of any key");
 
/* With no interface on, every line fits at the 16px pin rows: every port,
 * every protocol's name and every slot's pin. */
_Static_assert(USE_TOP
                   + (1 + (int)OUTBIND_PROTOS - 1) * USE_NAME_H
                   + ((int)LINK_PG_PORTS_MAX + (int)LINK_OUT_SLOTS)
                         * USE_PIN_H_D
                   <= USE_FOOT,
               "the IN USE table holds a binding beside 4 ports");
/* And with every interface on as well, at 16px a line: 27 lines.  PPM's
 * one pin takes all 8 slots, so at most 6 protocols share them, one name
 * fewer than PICKER_USE_MAX counts. */
_Static_assert(USE_TOP + ((int)PICKER_USE_MAX - 1) * USE_PIN_H_D
                   <= USE_FOOT,
               "the IN USE table holds its fullest list");

#define NOART_W 640
#define NOART_H 180   
 
#define IVORY GFX_RGB(236, 235, 228)    
#define EBONY GFX_RGB(22, 23, 28)       
#define INK   GFX_RGB(10, 10, 14)       
#define HALO  GFX_RGB(6, 6, 8)          
 
enum { HIT_NONE = 0, HIT_FACE, HIT_ROW, HIT_BUTTON };

typedef struct {
    outbind_t         bind;             
    picker_apply_fn   apply;            
    picker_select_fn  select;           
    picker_drawing_fn source;           
    /* The IOmcu's drawing, for the board drawing_board names; it
     * agreed with that board's catalogue when it was set. */
    link_drawing_t    drawing;
    uint16_t          drawing_board;    
    bool              has_drawing;      
 
    int      hit_kind;                  
    int      hit;            
    bool     open;           
    /* The binding shown is not one a read confirmed: no button acts. */
    bool     unread;
    /* The pin whose tap a PWM clash refused last, or -1: the reason line
     * says why, until another pick or tick. */
    int      refused;
    /* Each interface's pins at the last frame. */
    uint64_t iface[OUTPUTS_IFACE_COUNT];  
    /* The PROG PORT picked, -1 for a protocol (picker_port.c), and the
     * ports' view drawn. */
    int      port;                      
    uint32_t view_rev;                  
    bool     chrome_valid[MAX_FBS];     
    /* The cat (picker_cat.c): picked on the first frame of a visit from
     * the roll entering took, and drawn while its box stays clear. */
    bool          cat_pending; 
    uint32_t      cat_roll;    
    ui_cat_pick_t cat;         
    gfx_rect_t    cat_drawn;  
} pk_state_t;
 
/* Defined in picker_screen.c. */
extern pk_state_t pk_s;
#define s pk_s
 
/* --- picker_screen.c: the state the other two read -------------------- */
 
void pk_touched(void);
const outbind_shape_t *pk_shape(void);
const link_drawing_t *pk_drawing(void);
uint8_t pk_proto_shown(void);
bool pk_prog_taken(uint8_t index);
outputs_iface_t pk_iface_taken(uint8_t index);
int8_t pk_channel_of(uint8_t index);
 
/* --- picker_geometry.c ------------------------------------------------- */

void pk_board_box(int *x, int *y, int *w, int *h);
bool pk_pad_xy(uint8_t pad, int *px, int *py);
bool pk_pad_is_top(uint8_t pad);
bool pk_button_at(int i, gfx_rect_t *out, int *tier_out);
bool pk_marker_at(uint8_t e, int *mx, int *my, int *r);
int pk_pop_rows(void);
gfx_rect_t pk_pop_rect(void);
 
/* --- picker_draw.c ------------------------------------------------------ */

void pk_render(gfx_canvas_t *c, int buffer_index);
 
/* --- picker_cat.c ------------------------------------------------------- */

void pk_cat_enter(void);
void pk_cat_reset(void);
void pk_cat_render(gfx_canvas_t *c);