mame/src/emu/devfind.c
Alex W. Jackson 6ca10ab4fa devfind: Add rom_ptr_finder, which works like shared_ptr_finder
except it finds a ROM region instead of a memory share.
Unlike the old memory_region_finder, these can be accessed without
any overhead (since it's a pointer directly to the data and not
to the memory_region object), can be whatever data type you want
(no casting needed) and are strictly type-checked--if you have a
required_rom_ptr<UINT32> the region has to be a ROM_REGION32
(or an implicitly 32-bit region due to belonging to a CPU) or
the finder won't find it and will tell you why.

Basically, rom_ptr_finders are strictly better than
memory_region_finders and all drivers using the latter should be
converted over. I've done megasys1.c and twin16.c as examples.

megasys1: Use a device address map for the peekaboo oki instead
of memcpy().

twin16: Convert the scrolling layers to tilemaps (the fixed text
layer was already one). Miscellaneous cleanups/modernizations.

(nw)

Notice that rom_ptr_finder has a length() method which returns the
length in whatever size unit the pointer is, instead of a bytes()
method. Yes, I'm going to convert shared_ptr_finder to match, since
this way makes a lot more sense (in particular, mask() is useless
for shared_ptrs that are anything other than INT8/UINT8)
2014-10-17 02:59:51 +00:00

113 lines
2.9 KiB
C

// license:BSD-3-Clause
// copyright-holders:Aaron Giles
/***************************************************************************
devfind.c
Device finding template helpers.
***************************************************************************/
#include "emu.h"
//**************************************************************************
// BASE FINDER CLASS
//**************************************************************************
//-------------------------------------------------
// finder_base - constructor
//-------------------------------------------------
finder_base::finder_base(device_t &base, const char *tag)
: m_next(base.register_auto_finder(*this)),
m_base(base),
m_tag(tag)
{
}
//-------------------------------------------------
// ~finder_base - destructor
//-------------------------------------------------
finder_base::~finder_base()
{
}
//-------------------------------------------------
// find_memregion - find memory region
//-------------------------------------------------
void *finder_base::find_memregion(UINT8 width, size_t &length, bool required)
{
// look up the region and return NULL if not found
memory_region *region = m_base.memregion(m_tag);
if (region == NULL)
return NULL;
// check the width and warn if not correct
if (region->width() != width)
{
if (required)
osd_printf_warning("Region '%s' found but is width %d, not %d as requested\n", m_tag, region->width()*8, width*8);
return NULL;
}
// return results
length = region->bytes() / width;
return region->base();
}
//-------------------------------------------------
// find_memshare - find memory share
//-------------------------------------------------
void *finder_base::find_memshare(UINT8 width, size_t &bytes, bool required)
{
// look up the share and return NULL if not found
memory_share *share = m_base.memshare(m_tag);
if (share == NULL)
return NULL;
// check the width and warn if not correct
if (width != 0 && share->width() != width)
{
if (required)
osd_printf_warning("Shared ptr '%s' found but is width %d, not %d as requested\n", m_tag, share->width(), width);
return NULL;
}
// return results
bytes = share->bytes();
return share->ptr();
}
//-------------------------------------------------
// report_missing - report missing objects and
// return true if it's ok
//-------------------------------------------------
bool finder_base::report_missing(bool found, const char *objname, bool required)
{
if (required && strcmp(m_tag, FINDER_DUMMY_TAG)==0)
{
osd_printf_error("Tag not defined for required device\n");
return false;
}
// just pass through in the found case
if (found)
return true;
// otherwise, report
if (required)
osd_printf_error("Required %s '%s' not found\n", objname, m_tag);
else
osd_printf_verbose("Optional %s '%s' not found\n", objname, m_tag);
return !required;
}