mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-26 10:19:47 -04:00
Matthew Stanley
96 lines
3.1 KiB
C
96 lines
3.1 KiB
C
#ifndef PSXRECOMP_MDEC_H
|
||
#define PSXRECOMP_MDEC_H
|
||
|
||
#include <stdint.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
void mdec_init(void);
|
||
uint32_t mdec_read(uint32_t addr);
|
||
void mdec_write(uint32_t addr, uint32_t value);
|
||
|
||
void mdec_dma_write_word(uint32_t value);
|
||
uint32_t mdec_dma_read_word(void);
|
||
/* Contiguous LE bursts — bit-identical to N× word helpers; MotK FMV DMA. */
|
||
uint32_t mdec_dma_write_words(const uint32_t *src, uint32_t max_words);
|
||
uint32_t mdec_dma_read_words(uint32_t *dst, uint32_t max_words);
|
||
int mdec_dma_write_ready(void);
|
||
int mdec_dma_read_ready(void);
|
||
|
||
/* FMV detector: nonzero if a colour (15/24-bit) MDEC decode ran within the
|
||
* last `within_frames` vblanks. Streamed video decodes continuously; the
|
||
* widescreen present pins such frames to native 4:3 (FMVs are authored 4:3
|
||
* and get no GTE squash to compensate the stretch). */
|
||
int mdec_recently_active(uint32_t within_frames);
|
||
/* Guest cycles since last colour decode; UINT64_MAX if never / reset. */
|
||
uint64_t mdec_color_age_cycles(void);
|
||
|
||
typedef struct MDECDebugState {
|
||
uint32_t command;
|
||
uint32_t expected_halfwords;
|
||
uint32_t input_count;
|
||
uint32_t output_size;
|
||
uint32_t output_pos;
|
||
uint32_t output_depth;
|
||
uint32_t output_signed;
|
||
uint32_t output_bit15;
|
||
uint32_t busy;
|
||
uint32_t input_full;
|
||
uint32_t enable_dma_in;
|
||
uint32_t enable_dma_out;
|
||
uint32_t last_status;
|
||
uint32_t decode_macroblocks;
|
||
uint32_t decode_blocks;
|
||
uint32_t decode_stop_reason;
|
||
uint32_t decode_input_pos;
|
||
uint32_t decode_input_end;
|
||
uint32_t dma_in_words;
|
||
uint32_t dma_out_words;
|
||
uint32_t dma_read_underflows;
|
||
} MDECDebugState;
|
||
|
||
typedef struct MDECDebugEvent {
|
||
uint64_t seq;
|
||
uint32_t frame;
|
||
uint32_t kind;
|
||
uint32_t value;
|
||
uint32_t command;
|
||
uint32_t input_count;
|
||
uint32_t expected_halfwords;
|
||
uint32_t output_size;
|
||
uint32_t output_pos;
|
||
uint32_t macroblocks;
|
||
uint32_t blocks;
|
||
uint32_t stop_reason;
|
||
uint32_t underruns;
|
||
} MDECDebugEvent;
|
||
|
||
/* Monotonic decode-invocation counter — frontend FMV detector samples this
|
||
* per display-frame to detect active MDEC video (FMV) vs idle. */
|
||
uint32_t mdec_get_decode_count(void);
|
||
|
||
void mdec_debug_get_state(MDECDebugState *out);
|
||
uint64_t mdec_debug_get_event_total(void);
|
||
uint32_t mdec_debug_copy_events(uint64_t seq_lo, uint64_t seq_hi,
|
||
MDECDebugEvent *out, uint32_t max_count);
|
||
void mdec_debug_clear(void);
|
||
void mdec_debug_dma_in_start(uint32_t addr, uint32_t words);
|
||
void mdec_debug_dma_in_end(uint32_t addr, uint32_t words);
|
||
void mdec_debug_dma_out_start(uint32_t addr, uint32_t words);
|
||
void mdec_debug_dma_out_end(uint32_t addr, uint32_t words);
|
||
|
||
/* boot_state / savestate: full MDEC FIFO + tables (required for FMV resume). */
|
||
uint32_t mdec_snapshot_bytes(void);
|
||
void mdec_snapshot_write(uint8_t *p);
|
||
int mdec_snapshot_read(const uint8_t *p, uint32_t len);
|
||
/* 1 iff mdec_snapshot_read(p, len) would accept the section; mutates nothing. */
|
||
int mdec_snapshot_validate(const uint8_t *p, uint32_t len);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* PSXRECOMP_MDEC_H */
|