mirror of
https://github.com/holub/mame
synced 2025-05-11 00:28:49 +03:00
f0823886a6
from 4 to 5. This means any diff CHDs will no longer work. If you
absolutely need to keep the data for any existing ones you have,
find both the diff CHD and the original CHD for the game in question
and upgrade using these commands:
rename diff\game.dif diff\game-old.dif
chdman copy -i diff\game-old.dif -ip roms\game.chd -o diff\game.dif -op roms\game.chd -c none
Specifics regarding this change:
Defined a new CHD version 5. New features/behaviors of this version:
- support for up to 4 codecs; each block can use 1 of the 4
- new LZMA codec, which tends to do better than zlib overall
- new FLAC codec, primarily used for CDs (but can be applied anywhere)
- upgraded AVHuff codec now uses FLAC for encoding audio
- new Huffman codec, used to catch more nearly-uncompressable blocks
- compressed CHDs now use a compressed map for significant savings
- CHDs now are aware of a "unit" size; each hunk holds 1 or more units
(in general units map to sectors for hard disks/CDs)
- diff'ing against a parent now diffs at the unit level, greatly
improving compression
Rewrote and modernized chd.c. CHD versions prior to 3 are unsupported,
and version 3/4 CHDs are only supported for reading. Creating a new
CHD now leaves the file open. Added methods to read and write at the
unit and byte level, removing the need to handle this manually. Added
metadata access methods that pass astrings and dynamic_buffers to
simplify the interfaces. A companion class chd_compressor now
implements full multithreaded compression, analyzing and compressing
multiple hunks independently in parallel. Split the codec
implementations out into a separate file chdcodec.*
Updated harddisk.c and cdrom.c to rely on the caching/byte-level read/
write capabilities of the chd_file class. cdrom.c (and chdman) now also
pad CDs to 4-frame boundaries instead of hunk boundaries, ensuring that
the same SHA1 hashes are produced regardless of the hunk size.
Rewrote chdman.exe entirely, switching from positional parameters to
proper options. Use "chdman help" to get a list of commands, and
"chdman help <command>" to get help for any particular command. Many
redundant commands were removed now that additional flexibility is
available. Some basic mappings:
Old: chdman -createblankhd <out.chd> <cyls> <heads> <secs>
New: chdman createhd -o <out.chd> -chs <cyls>,<heads>,<secs>
Old: chdman -createuncomphd <in.raw> <out.chd> ....
New: chdman createhd -i <in.raw> -o <out.chd> -c none ....
Old: chdman -verifyfix <in.chd>
New: chdman verify -i <in.chd> -f
Old: chdman -merge <parent.chd> <diff.chd> <out.chd>
New: chdman copy -i <diff.chd> -ip <parent.chd> -o <out.chd>
Old: chdman -diff <parent.chd> <compare.chd> <diff.chd>
New: chdman copy -i <compare.chd> -o <diff.chd> -op <parent.chd>
Old: chdman -update <in.chd> <out.chd>
New: chdman copy -i <in.chd> -o <out.chd>
Added new core file coretmpl.h to hold core template classes. For now
just one class, dynamic_array<> is defined, which acts like an array
of a given object but which can be appended to and/or resized. Also
defines dynamic_buffer as dynamic_array<UINT8> for holding an
arbitrary buffer of bytes. Expect to see these used a lot.
Added new core helper hashing.c/.h which defines classes for each of
the common hashing methods and creator classes to wrap the
computation of these hashes. A future work item is to reimplement
the core emulator hashing code using these.
Split bit buffer helpers out into C++ classes and into their own
public header in bitstream.h.
Updated huffman.c/.h to C++, and changed the interface to make it
more flexible to use in nonstandard ways. Also added huffman compression
of the static tree for slightly better compression rates.
Created flac.c/.h as simplified C++ wrappers around the FLAC interface.
A future work item is to convert the samples sound device to a modern
device and leverage this for reading FLAC files.
Renamed avcomp.* to avhuff.*, updated to C++, and added support for
FLAC as the audio encoding mechanism. The old huffman audio is still
supported for decode only.
Added a variant of core_fload that loads to a dynamic_buffer.
Tweaked winwork.c a bit to not limit the maximum number of processors
unless the work queue was created with the WORK_QUEUE_FLAG_HIGH_FREQ
option. Further adjustments here are likely going to be necessary.
Fixed bug in aviio.c which caused errors when reading some AVI files.
161 lines
5.5 KiB
C
161 lines
5.5 KiB
C
/***************************************************************************
|
|
|
|
corefile.h
|
|
|
|
Core file I/O interface functions and definitions.
|
|
|
|
****************************************************************************
|
|
|
|
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 __COREFILE_H__
|
|
#define __COREFILE_H__
|
|
|
|
#include <stdarg.h>
|
|
#include "osdcore.h"
|
|
#include "astring.h"
|
|
#include "coretmpl.h"
|
|
|
|
|
|
|
|
/***************************************************************************
|
|
ADDITIONAL OPEN FLAGS
|
|
***************************************************************************/
|
|
|
|
#define OPEN_FLAG_NO_BOM 0x0100 /* don't output BOM */
|
|
|
|
#define FCOMPRESS_NONE 0 /* no compression */
|
|
#define FCOMPRESS_MIN 1 /* minimal compression */
|
|
#define FCOMPRESS_MEDIUM 6 /* standard compression */
|
|
#define FCOMPRESS_MAX 9 /* maximum compression */
|
|
|
|
|
|
|
|
/***************************************************************************
|
|
TYPE DEFINITIONS
|
|
***************************************************************************/
|
|
|
|
typedef struct _core_file core_file;
|
|
|
|
|
|
|
|
/***************************************************************************
|
|
FUNCTION PROTOTYPES
|
|
***************************************************************************/
|
|
|
|
|
|
/* ----- file open/close ----- */
|
|
|
|
/* open a file with the specified filename */
|
|
file_error core_fopen(const char *filename, UINT32 openflags, core_file **file);
|
|
|
|
/* open a RAM-based "file" using the given data and length (read-only) */
|
|
file_error core_fopen_ram(const void *data, size_t length, UINT32 openflags, core_file **file);
|
|
|
|
/* open a RAM-based "file" using the given data and length (read-only), copying the data */
|
|
file_error core_fopen_ram_copy(const void *data, size_t length, UINT32 openflags, core_file **file);
|
|
|
|
/* close an open file */
|
|
void core_fclose(core_file *file);
|
|
|
|
/* enable/disable streaming file compression via zlib; level is 0 to disable compression, or up to 9 for max compression */
|
|
file_error core_fcompress(core_file *file, int level);
|
|
|
|
|
|
|
|
/* ----- file positioning ----- */
|
|
|
|
/* adjust the file pointer within the file */
|
|
int core_fseek(core_file *file, INT64 offset, int whence);
|
|
|
|
/* return the current file pointer */
|
|
UINT64 core_ftell(core_file *file);
|
|
|
|
/* return true if we are at the EOF */
|
|
int core_feof(core_file *file);
|
|
|
|
/* return the total size of the file */
|
|
UINT64 core_fsize(core_file *file);
|
|
|
|
|
|
|
|
/* ----- file read ----- */
|
|
|
|
/* standard binary read from a file */
|
|
UINT32 core_fread(core_file *file, void *buffer, UINT32 length);
|
|
|
|
/* read one character from the file */
|
|
int core_fgetc(core_file *file);
|
|
|
|
/* put back one character from the file */
|
|
int core_ungetc(int c, core_file *file);
|
|
|
|
/* read a full line of text from the file */
|
|
char *core_fgets(char *s, int n, core_file *file);
|
|
|
|
/* get a pointer to a buffer that holds the full file data in RAM */
|
|
/* this function may cause the full file data to be read */
|
|
const void *core_fbuffer(core_file *file);
|
|
|
|
/* open a file with the specified filename, read it into memory, and return a pointer */
|
|
file_error core_fload(const char *filename, void **data, UINT32 *length);
|
|
file_error core_fload(const char *filename, dynamic_buffer &data);
|
|
|
|
|
|
|
|
/* ----- file write ----- */
|
|
|
|
/* standard binary write to a file */
|
|
UINT32 core_fwrite(core_file *file, const void *buffer, UINT32 length);
|
|
|
|
/* write a line of text to the file */
|
|
int core_fputs(core_file *f, const char *s);
|
|
|
|
/* printf-style text write to a file */
|
|
int core_vfprintf(core_file *f, const char *fmt, va_list va);
|
|
int CLIB_DECL core_fprintf(core_file *f, const char *fmt, ...) ATTR_PRINTF(2,3);
|
|
|
|
|
|
|
|
/* ----- filename utilities ----- */
|
|
|
|
/* extract the base part of a filename (remove extensions and paths) */
|
|
astring &core_filename_extract_base(astring &result, const char *name, bool strip_extension = false);
|
|
|
|
/* true if the given filename ends with a particular extension */
|
|
int core_filename_ends_with(const char *filename, const char *extension);
|
|
|
|
|
|
#endif /* __COREFILE_H__ */
|