/* ======================================================================== */
/*  Collects all the ROM data for a given assembly, and then outputs it.    */
/*                                                                          */
/*  Intended to add some abstraction to the current ROM output code.        */
/* ======================================================================== */
#ifndef COLLECT_H_
#define COLLECT_H_

/* ------------------------------------------------------------------------ */
/*  COLLECT_INIT     -- Initialize the collector.                           */
/* ------------------------------------------------------------------------ */
void collect_init(void);

/* ------------------------------------------------------------------------ */
/*  COLLECT_ADDSEG   -- Add a segment of data to the ROM image.             */
/* ------------------------------------------------------------------------ */
const char *collect_addseg
(
    uint16_t *data,
    uint32_t  addr,
    uint32_t  len,
    int8_t    page,
    uint8_t   set_attr,
    uint8_t   clr_attr
);

/* ------------------------------------------------------------------------ */
/*  COLLECT_FLUSH    -- Write out everything that was collected.            */
/* ------------------------------------------------------------------------ */
void collect_flush(void);

/* ------------------------------------------------------------------------ */
/*  COLLECT_CFG_VAR  -- Collect configuration variables for BIN+CFG format  */
/* ------------------------------------------------------------------------ */
void collect_cfg_var(const char *var, const char *string, int value);

/* ------------------------------------------------------------------------ */
/*  COLLECT_SET_OVERWRITE_FLAGS -- Modulate set-if-overwritten/force-over   */
/* ------------------------------------------------------------------------ */
void collect_set_overwrite_flags
(
    const int new_warn_if_overwritten,  /* -1 means no change */
    const int new_force_overwrite       /* -1 means no change */
);

/* ------------------------------------------------------------------------ */
/*  COLLECT_SHOW_MAP                                                        */
/* ------------------------------------------------------------------------ */
void collect_show_map(void);

#endif