mirror of
https://github.com/holub/mame
synced 2025-05-10 00:01:52 +03:00
af071893a6
to private member variables with accessors: machine->m_respool ==> machine->respool() machine->config ==> machine->config() machine->gamedrv ==> machine->system() machine->m_regionlist ==> machine->first_region() machine->sample_rate ==> machine->sample_rate() Also converted internal lists to use simple_list.
329 lines
14 KiB
C++
329 lines
14 KiB
C++
/***************************************************************************
|
|
|
|
screen.h
|
|
|
|
Core MAME screen device.
|
|
|
|
****************************************************************************
|
|
|
|
Copyright Aaron Giles
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are
|
|
met:
|
|
|
|
* Redistributions of source code must retain the above copyright
|
|
notice, this list of conditions and the following disclaimer.
|
|
* Redistributions in binary form must reproduce the above copyright
|
|
notice, this list of conditions and the following disclaimer in
|
|
the documentation and/or other materials provided with the
|
|
distribution.
|
|
* Neither the name 'MAME' nor the names of its contributors may be
|
|
used to endorse or promote products derived from this software
|
|
without specific prior written permission.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY AARON GILES ''AS IS'' AND ANY EXPRESS OR
|
|
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL AARON GILES BE LIABLE FOR ANY DIRECT,
|
|
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
|
|
IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
***************************************************************************/
|
|
|
|
#pragma once
|
|
|
|
#ifndef __EMU_H__
|
|
#error Dont include this file directly; include emu.h instead.
|
|
#endif
|
|
|
|
#ifndef __SCREEN_H__
|
|
#define __SCREEN_H__
|
|
|
|
|
|
//**************************************************************************
|
|
// CONSTANTS
|
|
//**************************************************************************
|
|
|
|
// screen types
|
|
enum screen_type_enum
|
|
{
|
|
SCREEN_TYPE_INVALID = 0,
|
|
SCREEN_TYPE_RASTER,
|
|
SCREEN_TYPE_VECTOR,
|
|
SCREEN_TYPE_LCD
|
|
};
|
|
|
|
|
|
|
|
//**************************************************************************
|
|
// TYPE DEFINITIONS
|
|
//**************************************************************************
|
|
|
|
// forward references
|
|
class render_texture;
|
|
class screen_device;
|
|
|
|
|
|
// device type definition
|
|
extern const device_type SCREEN;
|
|
|
|
|
|
// callback that is called to notify of a change in the VBLANK state
|
|
typedef void (*vblank_state_changed_func)(screen_device &device, void *param, bool vblank_state);
|
|
typedef UINT32 (*screen_update_func)(screen_device *screen, bitmap_t *bitmap, const rectangle *cliprect);
|
|
typedef void (*screen_eof_func)(screen_device *screen, running_machine *machine);
|
|
|
|
|
|
// ======================> screen_device_config
|
|
|
|
class screen_device_config : public device_config
|
|
{
|
|
friend class screen_device;
|
|
|
|
// construction/destruction
|
|
screen_device_config(const machine_config &mconfig, const char *tag, const device_config *owner, UINT32 clock);
|
|
|
|
public:
|
|
// allocators
|
|
static device_config *static_alloc_device_config(const machine_config &mconfig, const char *tag, const device_config *owner, UINT32 clock);
|
|
virtual device_t *alloc_device(running_machine &machine) const;
|
|
|
|
// configuration readers
|
|
screen_device_config *next_screen() const { return downcast<screen_device_config *>(typenext()); }
|
|
screen_type_enum screen_type() const { return m_type; }
|
|
int width() const { return m_width; }
|
|
int height() const { return m_height; }
|
|
const rectangle &visible_area() const { return m_visarea; }
|
|
bool oldstyle_vblank_supplied() const { return m_oldstyle_vblank_supplied; }
|
|
attoseconds_t refresh() const { return m_refresh; }
|
|
attoseconds_t vblank() const { return m_vblank; }
|
|
bitmap_format format() const { return m_format; }
|
|
float xoffset() const { return m_xoffset; }
|
|
float yoffset() const { return m_yoffset; }
|
|
float xscale() const { return m_xscale; }
|
|
float yscale() const { return m_yscale; }
|
|
bool have_screen_update() const { return m_screen_update != NULL; }
|
|
|
|
// inline configuration helpers
|
|
static void static_set_format(device_config *device, bitmap_format format);
|
|
static void static_set_type(device_config *device, screen_type_enum type);
|
|
static void static_set_raw(device_config *device, UINT32 pixclock, UINT16 htotal, UINT16 hbend, UINT16 hbstart, UINT16 vtotal, UINT16 vbend, UINT16 vbstart);
|
|
static void static_set_refresh(device_config *device, attoseconds_t rate);
|
|
static void static_set_vblank_time(device_config *device, attoseconds_t time);
|
|
static void static_set_size(device_config *device, UINT16 width, UINT16 height);
|
|
static void static_set_visarea(device_config *device, INT16 minx, INT16 maxx, INT16 miny, INT16 maxy);
|
|
static void static_set_default_position(device_config *device, double xscale, double xoffs, double yscale, double yoffs);
|
|
static void static_set_screen_update(device_config *device, screen_update_func callback);
|
|
static void static_set_screen_eof(device_config *device, screen_eof_func callback);
|
|
|
|
private:
|
|
// device_config overrides
|
|
virtual bool device_validity_check(emu_options &options, const game_driver &driver) const;
|
|
|
|
// inline configuration data
|
|
screen_type_enum m_type; // type of screen
|
|
int m_width, m_height; // default total width/height (HTOTAL, VTOTAL)
|
|
rectangle m_visarea; // default visible area (HBLANK end/start, VBLANK end/start)
|
|
bool m_oldstyle_vblank_supplied; // MCFG_SCREEN_VBLANK_TIME macro used
|
|
attoseconds_t m_refresh; // default refresh period
|
|
attoseconds_t m_vblank; // duration of a VBLANK
|
|
bitmap_format m_format; // bitmap format
|
|
float m_xoffset, m_yoffset; // default X/Y offsets
|
|
float m_xscale, m_yscale; // default X/Y scale factor
|
|
screen_update_func m_screen_update; // screen update callback
|
|
screen_eof_func m_screen_eof; // screen eof callback
|
|
};
|
|
|
|
|
|
// ======================> screen_device
|
|
|
|
class screen_device : public device_t
|
|
{
|
|
friend class screen_device_config;
|
|
friend class render_manager;
|
|
friend resource_pool_object<screen_device>::~resource_pool_object();
|
|
|
|
// construction/destruction
|
|
screen_device(running_machine &_machine, const screen_device_config &config);
|
|
virtual ~screen_device();
|
|
|
|
public:
|
|
// information getters
|
|
const screen_device_config &config() const { return m_config; }
|
|
screen_device *next_screen() const { return downcast<screen_device *>(typenext()); }
|
|
screen_type_enum screen_type() const { return m_config.m_type; }
|
|
int width() const { return m_width; }
|
|
int height() const { return m_height; }
|
|
const rectangle &visible_area() const { return m_visarea; }
|
|
bitmap_format format() const { return m_config.m_format; }
|
|
render_container &container() const { assert(m_container != NULL); return *m_container; }
|
|
bool screen_update(bitmap_t &bitmap, const rectangle &cliprect);
|
|
void screen_eof();
|
|
|
|
// dynamic configuration
|
|
void configure(int width, int height, const rectangle &visarea, attoseconds_t frame_period);
|
|
void reset_origin(int beamy = 0, int beamx = 0);
|
|
void set_visible_area(int min_x, int max_x, int min_y, int max_y);
|
|
|
|
// beam positioning and state
|
|
int vpos() const;
|
|
int hpos() const;
|
|
bool vblank() const { return (machine->time() < m_vblank_end_time); }
|
|
bool hblank() const { int curpos = hpos(); return (curpos < m_visarea.min_x || curpos > m_visarea.max_x); }
|
|
|
|
// timing
|
|
attotime time_until_pos(int vpos, int hpos = 0) const;
|
|
attotime time_until_vblank_start() const { return time_until_pos(m_visarea.max_y + 1); }
|
|
attotime time_until_vblank_end() const;
|
|
attotime time_until_update() const { return (machine->config().m_video_attributes & VIDEO_UPDATE_AFTER_VBLANK) ? time_until_vblank_end() : time_until_vblank_start(); }
|
|
attotime scan_period() const { return attotime(0, m_scantime); }
|
|
attotime frame_period() const { return (this == NULL || !started()) ? DEFAULT_FRAME_PERIOD : attotime(0, m_frame_period); };
|
|
UINT64 frame_number() const { return m_frame_number; }
|
|
int partial_updates() const { return m_partial_updates_this_frame; }
|
|
|
|
// updating
|
|
bool update_partial(int scanline);
|
|
void update_now();
|
|
|
|
// additional helpers
|
|
void register_vblank_callback(vblank_state_changed_func vblank_callback, void *param);
|
|
bitmap_t *alloc_compatible_bitmap(int width = 0, int height = 0) { return auto_bitmap_alloc(machine, (width == 0) ? m_width : width, (height == 0) ? m_height : height, m_config.m_format); }
|
|
|
|
// internal to the video system
|
|
bool update_quads();
|
|
void update_burnin();
|
|
|
|
// globally accessible constants
|
|
static const int DEFAULT_FRAME_RATE = 60;
|
|
static const attotime DEFAULT_FRAME_PERIOD;
|
|
|
|
private:
|
|
// device-level overrides
|
|
virtual void device_start();
|
|
virtual void device_post_load();
|
|
|
|
// internal helpers
|
|
void set_container(render_container &container) { m_container = &container; }
|
|
void realloc_screen_bitmaps();
|
|
|
|
static TIMER_CALLBACK( static_vblank_begin_callback ) { reinterpret_cast<screen_device *>(ptr)->vblank_begin_callback(); }
|
|
void vblank_begin_callback();
|
|
|
|
static TIMER_CALLBACK( static_vblank_end_callback ) { reinterpret_cast<screen_device *>(ptr)->vblank_end_callback(); }
|
|
void vblank_end_callback();
|
|
|
|
static TIMER_CALLBACK( static_scanline0_callback ) { reinterpret_cast<screen_device *>(ptr)->scanline0_callback(); }
|
|
public: // temporary
|
|
void scanline0_callback();
|
|
private:
|
|
|
|
static TIMER_CALLBACK( static_scanline_update_callback ) { reinterpret_cast<screen_device *>(ptr)->scanline_update_callback(param); }
|
|
void scanline_update_callback(int scanline);
|
|
|
|
void finalize_burnin();
|
|
void load_effect_overlay(const char *filename);
|
|
|
|
// internal state
|
|
const screen_device_config &m_config;
|
|
render_container * m_container; // pointer to our container
|
|
|
|
// dimensions
|
|
int m_width; // current width (HTOTAL)
|
|
int m_height; // current height (VTOTAL)
|
|
rectangle m_visarea; // current visible area (HBLANK end/start, VBLANK end/start)
|
|
|
|
// textures and bitmaps
|
|
render_texture * m_texture[2]; // 2x textures for the screen bitmap
|
|
bitmap_t * m_bitmap[2]; // 2x bitmaps for rendering
|
|
bitmap_t * m_burnin; // burn-in bitmap
|
|
UINT8 m_curbitmap; // current bitmap index
|
|
UINT8 m_curtexture; // current texture index
|
|
INT32 m_texture_format; // texture format of bitmap for this screen
|
|
bool m_changed; // has this bitmap changed?
|
|
INT32 m_last_partial_scan; // scanline of last partial update
|
|
bitmap_t * m_screen_overlay_bitmap;// screen overlay bitmap
|
|
|
|
// screen timing
|
|
attoseconds_t m_frame_period; // attoseconds per frame
|
|
attoseconds_t m_scantime; // attoseconds per scanline
|
|
attoseconds_t m_pixeltime; // attoseconds per pixel
|
|
attoseconds_t m_vblank_period; // attoseconds per VBLANK period
|
|
attotime m_vblank_start_time; // time of last VBLANK start
|
|
attotime m_vblank_end_time; // time of last VBLANK end
|
|
emu_timer * m_vblank_begin_timer; // timer to signal VBLANK start
|
|
emu_timer * m_vblank_end_timer; // timer to signal VBLANK end
|
|
emu_timer * m_scanline0_timer; // scanline 0 timer
|
|
emu_timer * m_scanline_timer; // scanline timer
|
|
UINT64 m_frame_number; // the current frame number
|
|
UINT32 m_partial_updates_this_frame;// partial update counter this frame
|
|
|
|
struct callback_item
|
|
{
|
|
callback_item * m_next;
|
|
vblank_state_changed_func m_callback;
|
|
void * m_param;
|
|
};
|
|
callback_item * m_callback_list; // list of VBLANK callbacks
|
|
};
|
|
|
|
|
|
|
|
//**************************************************************************
|
|
// SCREEN DEVICE CONFIGURATION MACROS
|
|
//**************************************************************************
|
|
#define SCREEN_UPDATE_NAME(name) screen_update_##name
|
|
#define SCREEN_UPDATE(name) UINT32 SCREEN_UPDATE_NAME(name)(screen_device *screen, bitmap_t *bitmap, const rectangle *cliprect)
|
|
#define SCREEN_UPDATE_CALL(name) SCREEN_UPDATE_NAME(name)(screen, bitmap, cliprect)
|
|
|
|
#define SCREEN_EOF_NAME(name) screen_eof_##name
|
|
#define SCREEN_EOF(name) void SCREEN_EOF_NAME(name)(screen_device *screen, running_machine *machine)
|
|
#define SCREEN_EOF_CALL(name) SCREEN_EOF_NAME(name)(screen, machine)
|
|
|
|
#define screen_eof_0 NULL
|
|
|
|
#define MCFG_SCREEN_ADD(_tag, _type) \
|
|
MCFG_DEVICE_ADD(_tag, SCREEN, 0) \
|
|
MCFG_SCREEN_TYPE(_type) \
|
|
|
|
#define MCFG_SCREEN_MODIFY(_tag) \
|
|
MCFG_DEVICE_MODIFY(_tag)
|
|
|
|
#define MCFG_SCREEN_FORMAT(_format) \
|
|
screen_device_config::static_set_format(device, _format); \
|
|
|
|
#define MCFG_SCREEN_TYPE(_type) \
|
|
screen_device_config::static_set_type(device, SCREEN_TYPE_##_type); \
|
|
|
|
#define MCFG_SCREEN_RAW_PARAMS(_pixclock, _htotal, _hbend, _hbstart, _vtotal, _vbend, _vbstart) \
|
|
screen_device_config::static_set_raw(device, _pixclock, _htotal, _hbend, _hbstart, _vtotal, _vbend, _vbstart);
|
|
|
|
#define MCFG_SCREEN_REFRESH_RATE(_rate) \
|
|
screen_device_config::static_set_refresh(device, HZ_TO_ATTOSECONDS(_rate)); \
|
|
|
|
#define MCFG_SCREEN_VBLANK_TIME(_time) \
|
|
screen_device_config::static_set_vblank_time(device, _time); \
|
|
|
|
#define MCFG_SCREEN_SIZE(_width, _height) \
|
|
screen_device_config::static_set_size(device, _width, _height); \
|
|
|
|
#define MCFG_SCREEN_VISIBLE_AREA(_minx, _maxx, _miny, _maxy) \
|
|
screen_device_config::static_set_visarea(device, _minx, _maxx, _miny, _maxy); \
|
|
|
|
#define MCFG_SCREEN_DEFAULT_POSITION(_xscale, _xoffs, _yscale, _yoffs) \
|
|
screen_device_config::static_set_default_position(device, _xscale, _xoffs, _yscale, _yoffs); \
|
|
|
|
#define MCFG_SCREEN_UPDATE(_func) \
|
|
screen_device_config::static_set_screen_update(device, SCREEN_UPDATE_NAME(_func)); \
|
|
|
|
#define MCFG_SCREEN_EOF(_func) \
|
|
screen_device_config::static_set_screen_eof(device, SCREEN_EOF_NAME(_func)); \
|
|
|
|
#endif /* __SCREEN_H__ */
|