mirror of
https://github.com/gbdk-2020/gbdk-2020.git
synced 2026-03-03 05:54:33 +01:00
54dbf0722e
* Copy gbdk-lib/include/gb/bcd.h to gbdk-lib/include/nes/bcd.h * Add bcd asm implementation in libc/asm/mos6502/bcd.s * Update bcd.h to accept NES target * Update examples/cross-platform/bcd to build for nes
62 lines
2.0 KiB
C
62 lines
2.0 KiB
C
#ifndef __BCD_H_INCLUDE
|
|
#define __BCD_H_INCLUDE
|
|
|
|
#include <types.h>
|
|
#include <stdint.h>
|
|
|
|
/** @file bcd.h
|
|
Support for working with BCD (Binary Coded Decimal)
|
|
|
|
See the example BCD project for additional details.
|
|
*/
|
|
|
|
// macro for creating BCD constants
|
|
#define BCD_HEX(v) ((BCD)(v))
|
|
|
|
/** Converts an integer value into BCD format
|
|
|
|
A maximum of 8 digits may be used
|
|
*/
|
|
#define MAKE_BCD(v) BCD_HEX(0x ## v)
|
|
|
|
typedef uint32_t BCD;
|
|
|
|
/** Converts integer __i__ into BCD format (Binary Coded Decimal)
|
|
@param i Numeric value to convert
|
|
@param value Pointer to a BCD variable to store the converted result
|
|
*/
|
|
void uint2bcd(uint16_t i, BCD * value) OLDCALL;
|
|
|
|
/** Adds two numbers in BCD format: __sour__ += __value__
|
|
@param sour Pointer to a BCD value to add to (and where the result is stored)
|
|
@param value Pointer to the BCD value to add to __sour__
|
|
*/
|
|
void bcd_add(BCD * sour, const BCD * value) OLDCALL;
|
|
|
|
/** Subtracts two numbers in BCD format: __sour__ -= __value__
|
|
@param sour Pointer to a BCD value to subtract from (and where the result is stored)
|
|
@param value Pointer to the BCD value to subtract from __sour__
|
|
*/
|
|
void bcd_sub(BCD * sour, const BCD * value) OLDCALL;
|
|
|
|
/** Convert a BCD number into an asciiz (null terminated) string and return the length
|
|
@param bcd Pointer to BCD value to convert
|
|
@param tile_offset Optional per-character offset value to add (use 0 for none)
|
|
@param buffer Buffer to store the result in
|
|
|
|
Returns: Length in characters (always 8)
|
|
|
|
__buffer__ should be large enough to store the converted string
|
|
(9 bytes: 8 characters + 1 for terminator)
|
|
|
|
There are a couple different ways to use __tile_offset__.
|
|
For example:
|
|
\li It can be the Index of the Font Tile '0' in VRAM to
|
|
allow the buffer to be used directly with @ref set_bkg_tiles.
|
|
\li It can also be set to the ascii value for character '0'
|
|
so that the buffer is a normal string that can be passed to @ref printf.
|
|
*/
|
|
uint8_t bcd2text(const BCD * bcd, uint8_t tile_offset, uint8_t * buffer) OLDCALL;
|
|
|
|
#endif
|