resource_dasm
v2024-11-11-macos-arm64
该项目包含多种用于反向工程经典Mac OS应用程序和游戏的工具。
该项目中的工具是：
apt-get install zlibg1-dev 。）cmake . ，然后make 。该项目应适当地基于MacOS和Linux的最新版本。
Resource_dasm是经典Mac OS资源叉的拆卸器。它将资源从任何文件的资源分叉中提取，并将许多经典的Mac OS资源格式（图像，声音，文本等）转换为现代格式。
示例：
将所有资源从特定文件中导出并将其转换为现代格式（默认情况下，输出写入<filename> .out目录）： ./resource_dasm files/Tesserae
从文件夹中的所有文件中导出所有资源，将输出文件写入当前目录中的并行文件夹结构： ./resource_dasm "files/Apeiron ƒ/" ./apeiron.out
以现代和原始格式出口特定资源： ./resource_dasm "files/MacSki 1.7/MacSki Sounds" ./macski.out --target-type=snd --target-id=1023 --save-raw=yes
导出PowerPC应用程序的资源并拆卸其代码： ./resource_dasm "files/Adventures of Billy" ./billy.out ./m68kdasm --pef "files/Adventures of Billy" ./billy.out/dasm.txt
从Mohawk档案中导出所有资源： ./resource_dasm files/Riven/Data/a_Data.MHK ./riven_data_a.out --index-format=mohawk
由于跨不同类型的文件系统复制文件，因此您可能会在单独文件的数据叉中使用文件的资源叉。从此类文件中导出资源： ./resource_dasm "windows/Realmz/Data Files/Portraits.rsf" ./portraits.out --data-fork
创建一个带有几个文本的新资源文件，并有几个文本资源： ./resource_dasm --create --add-resource=TEXT:[email protected] --add-resource=TEXT:[email protected] --add-resource=clut:[email protected] output.rsrc
将资源添加到现有资源文件中： ./resource_dasm file.rsrc --add-resource=TEXT:[email protected] output.rsrc
从现有资源文件中删除资源： ./resource_dasm file.rsrc --delete-resource=TEXT:128 output.rsrc
这并不是所有的资源_DASM都能做到。在没有任何参数的情况下运行它（或在src/resource_dasm.cc中查看print_usage()以查看所有选项的完整说明。
Resource_dasm可以转换以下资源类型：
Type | Output format | Notes
------------------------------------------------------------------------
Text resources
bstr | .txt (one file per string) | *3
card | .txt |
finf | .txt (description of contents) |
FCMT | .txt | *3
FONT | .txt (description) and image (one image per glyph) | *E
lstr | .txt | *3
MACS | .txt | *3
minf | .txt | *3
mstr | .txt | *3
mst# | .txt (one file per string) | *3
NFNT | .txt (description) and image (one image per glyph) | *E
PSAP | .txt |
sfnt | .ttf (TrueType font) |
STR | .txt | *3
STR# | .txt (one file per string) | *3
styl | .rtf | *4
TEXT | .txt | *3
TwCS | .txt (one file per string) |
wstr | .txt |
------------------------------------------------------------------------
Image and color resources
actb | image (24-bit) | *E *8
acur | .txt (list of cursor frame IDs) |
cctb | image (24-bit) | *E *8
cicn | image (32-bit and monochrome) | *E
clut | image (24-bit) | *E *8
crsr | image (32-bit and monochrome) | *E *1
CTBL | image (24-bit) | *E
CURS | image (32-bit) | *E *1
dctb | image (24-bit) | *E *8
fctb | image (24-bit) | *E *8
icl4 | image (24 or 32-bit) and .icns | *E *0
icl8 | image (24 or 32-bit) and .icns | *E *0
icm# | image (32-bit) | *E
icm4 | image (24 or 32-bit) | *E *0
icm8 | image (24 or 32-bit) | *E *0
ICN# | image (32-bit) and .icns | *E
icns | image, .png, .jp2, .txt, .plist, .bin, etc. | *E *9
ICON | image (24-bit) | *E
ics# | image (32-bit) and .icns | *E
ics4 | image (24 or 32-bit) and .icns | *E *0
ics8 | image (24 or 32-bit) and .icns | *E *0
kcs# | image (32-bit) | *E
kcs4 | image (24 or 32-bit) | *E *0
kcs8 | image (24 or 32-bit) | *E *0
PAT | image (24-bit; pattern and 8x8 tiling) | *E
PAT# | image (24-bit; pattern and 8x8 tiling for each pattern) | *E
PICT | image (24-bit) or other format | *E *2
pltt | image (24-bit) | *E *8
ppat | image (24-bit; color, color 8x8, mono, mono 8x8) | *E
ppt# | image (24-bit; 4 images as above for each pattern) | *E
SICN | image (24-bit, one per icon) | *E
wctb | image (24-bit) | *E *8
------------------------------------------------------------------------
Sound and sequence resources
.mod | .mod (ProTracker module) |
ALIS | .txt (description of contents) |
cmid | .midi |
csnd | .wav or .mp3 | *5
ecmi | .midi |
emid | .midi |
esnd | .wav or .mp3 | *5
ESnd | .wav or .mp3 | *5
INST | .json | *6
MADH | .madh (PlayerPRO module) |
MADI | .madi (PlayerPRO module) |
MIDI | .midi |
Midi | .midi |
midi | .midi |
SMSD | .wav | *A
snd | .wav or .mp3 | *5
SONG | .json (smssynth) | *6
SOUN | .wav | *A
Tune | .midi | *7
Ysnd | .wav |
------------------------------------------------------------------------
Code resources
ADBS | .txt (68K assembly) | *C
adio | .txt (68K assembly) | *C
AINI | .txt (68K assembly) | *C
atlk | .txt (68K assembly) | *C
boot | .txt (68K assembly) | *C
CDEF | .txt (68K assembly) | *C
cdek | .txt (PPC32 assembly and header description) |
cdev | .txt (68K assembly) | *C
CDRV | .txt (68K assembly) | *C
cfrg | .txt (description of code fragments) | *D
citt | .txt (68K assembly) | *C
clok | .txt (68K assembly) | *C
cmtb | .txt (68K assembly) | *C
cmu! | .txt (68K assembly) | *C
CODE | .txt (68K assembly or import table description) | *B *C
code | .txt (68K assembly) | *C
dcmp | .txt (68K assembly) | *C
dcod | .txt (PPC32 assembly and header description) |
dem | .txt (68K assembly) | *C
dimg | .txt (68K assembly) | *C
drvr | .txt (68K assembly) | *C
DRVR | .txt (68K assembly) | *C
enet | .txt (68K assembly) | *C
epch | .txt (PPC32 assembly) |
expt | .txt (PPC32 assembly) |
FKEY | .txt (68K assembly) | *C
fovr | .txt (PPC32 assembly and header description) |
gcko | .txt (68K assembly) | *C
gdef | .txt (68K assembly) | *C
GDEF | .txt (68K assembly) | *C
gnld | .txt (68K assembly) | *C
INIT | .txt (68K assembly) | *C
krnl | .txt (PPC32 assembly) |
LDEF | .txt (68K assembly) | *C
lmgr | .txt (68K assembly) | *C
lodr | .txt (68K assembly) | *C
ltlk | .txt (68K assembly) | *C
MBDF | .txt (68K assembly) | *C
MDEF | .txt (68K assembly) | *C
mntr | .txt (68K assembly) | *C
ncmp | .txt (PPC32 assembly and header description) |
ndlc | .txt (PPC32 assembly and header description) |
ndmc | .txt (PPC32 assembly and header description) |
ndrv | .txt (PPC32 assembly and header description) |
nift | .txt (PPC32 assembly and header description) |
nitt | .txt (PPC32 assembly and header description) |
nlib | .txt (PPC32 assembly and header description) |
nsnd | .txt (PPC32 assembly and header description) |
nsrd | .txt (PPC32 assembly) |
ntrb | .txt (PPC32 assembly and header description) |
osl | .txt (68K assembly) | *C
otdr | .txt (68K assembly) | *C
otlm | .txt (68K assembly) | *C
PACK | .txt (68K assembly) | *C
pnll | .txt (68K assembly) | *C
ppct | .txt (PPC32 assembly and header description) |
proc | .txt (68K assembly) | *C
PTCH | .txt (68K assembly) | *C
ptch | .txt (68K assembly) | *C
pthg | .txt (68K or PPC32 assembly and header description) | *C
qtcm | .txt (PPC32 assembly and header description) |
ROvr | .txt (68K assembly) | *C
RSSC | .txt (68K assembly) | *C
scal | .txt (PPC32 assembly and header description) |
scod | .txt (68K assembly) | *C
SERD | .txt (68K assembly) | *C
sfvr | .txt (PPC32 assembly and header description) |
shal | .txt (68K assembly) | *C
sift | .txt (68K assembly) | *C
SMOD | .txt (68K assembly) | *C
snth | .txt (68K assembly) | *C
tdig | .txt (68K assembly) | *C
tokn | .txt (68K assembly) | *C
vdig | .txt (68K or PPC32 assembly and header description) | *C
wart | .txt (68K assembly) | *C
WDEF | .txt (68K assembly) | *C
XCMD | .txt (68K assembly) | *C
XFCN | .txt (68K assembly) | *C
------------------------------------------------------------------------
MacApp resources
68k! | .txt (description of memory config for 680x0) |
CMNU | .txt (description of menu) |
cmnu | .txt (description of menu) |
errs | .txt (description of error ranges) |
mem! | .txt (description of memory config) |
ppc! | .txt (description of memory config for PPC) |
res! | .txt (string list of always resident segments) |
seg! | .txt (string list of segments) |
TxSt | .txt (description of text style) |
------------------------------------------------------------------------
Miscellaneous resources
ALRT | .txt (alert parameters) |
APPL | .txt (description of contents) |
audt | .txt (description of contents) |
BNDL | .txt (description of contents) |
CMDK | .txt (list of keys) |
CNTL | .txt (description of control) |
CTY# | .txt (description of cities) |
dbex | .txt (description of contents) |
DITL | .txt (dialog parameters) |
DLOG | .txt (dialog parameters) |
FBTN | .txt (description of buttons) |
FDIR | .txt (description of contents) |
fld# | .txt (description of folders) |
flst | .txt (description of font family list) |
fmap | .txt (description of finder icon mappings) |
FREF | .txt (description of file references) |
FRSV | .txt (list of font IDs) |
FWID | .txt (font parameters) |
gbly | .txt (description of Gibbly aka. System Enabler) |
GNRL | .txt (description of contents) |
hwin | .txt (description of help window) |
icmt | .txt (icon reference and comment) |
inbb | .txt (description of contents) |
indm | .txt (description of contents) |
infs | .txt (description of contents) |
inpk | .txt (description of contents) |
inra | .txt (description of contents) |
insc | .txt (description of contents) |
itl0 | .txt (international formatting information) |
ITL1 | .txt (short dates flag value) |
itlb | .txt (internationalization parameters) |
itlc | .txt (internationalization parameters) |
itlk | .txt (keyboard mappings) |
KBDN | .txt (keyboard name) |
LAYO | .txt (description of layout) |
mach | .txt (description of contents) |
MBAR | .txt (list of menu IDs) |
mcky | .txt (threshold values) |
MENU | .txt (description of menu) |
mitq | .txt (description of queue sizes) |
nrct | .txt (rectangle boundaries) |
PAPA | .txt (printer parameters) |
PICK | .txt (picker parameters) |
ppcc | .txt (description of contents) |
ppci | .txt (description of contents) |
PRC0 | .txt (description of contents) |
PRC3 | .txt (description of contents) |
pslt | .txt (description of Nubus pseudo-slot lists) |
ptbl | .txt (description of patch table) |
qrsc | .txt (description of queries) |
RECT | .txt (description of the rectangle) |
resf | .txt (list of fonts) |
RMAP | .txt (type mapping and list of ID exceptions) |
ROv# | .txt (list of overridden resource IDs) |
rtt# | .txt (list of database result handlers) |
RVEW | .txt (description of contents) |
scrn | .txt (screen device parameters) |
sect | .txt (description of contents) |
SIGN | .txt (description of contents) |
SIZE | .txt (description of parameters) |
slut | .txt (description of mapping) |
thn# | .txt (description of 'thng' mapping) |
TMPL | .txt (description of format) |
TOOL | .txt (description of contents) |
vers | .txt (version flags and strings) |
WIND | .txt (window parameters) |
Notes:
*0: Produces a 32-bit image if a corresponding monochrome resource exists
(ICN# for icl4/8, icm# for icm4/8, ics# for ics4/8, kcs# for kcs4/8). If
no monochrome resource exists, produces a 24-bit image instead. All
color information in the original resource is reproduced in the output,
even for fully-transparent pixels. If the icon was originally intended
to be used with a nonstandard compositing mode, the colors of fully-
transparent pixels may have been relevant, but most modern image viewers
and editors don't have a way to display this information.
*1: The hotspot coordinates are appended to the output filename. As in *0,
resource_dasm faithfully reproduces the color values of transparent
pixels in the output file, but most modern image editors won't show
these "transparent" pixels.
*2: resource_dasm implements multiple PICT decoders. It will first attempt
to decode the PICT using its internal decoder, which usually produces
correct results but fails on PICTs that contain complex drawing opcodes.
This decoder can handle basic QuickTime images as well (e.g. embedded
JPEGs and PNGs), but can't do any drawing under or over them, or
matte/mask effects. PICTs that contain embedded JPEGs or PNGs will
result in a JPEG or PNG file rather than the format specified by
--image-format (which is BMP by default). If the internal decoder fails,
resource_dasm will fall back to a decoder that uses picttoppm, which is
part of NetPBM. There is a rare failure mode in which picttoppm hangs
forever; resource_dasm gives it 10 seconds to do its job before killing
it and giving up. If picttoppm is not installed, fails to decode the
PICT, or is killed due to a timeout, resource_dasm will prepend the
necessary header and save the data as a PICT file instead.
*3: Text is assumed to use the Mac OS Roman encoding. It is converted to
UTF-8, and line endings (r) are converted to Unix style (n).
*4: Some rare style options may not be translated correctly. styl resources
provide styling information for the TEXT resource with the same ID, so
such a resource must be present to properly decode a styl.
*5: RMF archives can contain snd resources that are actually in MP3 format;
in this case, the exported sound will be a .mp3 file. Otherwise, the
exported sound is an uncompressed WAV file, even if the resource's data
is compressed. resource_dasm can decompress IMA 4:1, MACE 3:1, MACE 6:1,
A-law, and mu-law (ulaw) compression.
*6: JSON files from SoundMusicSys SONG resources can be played with smssynth
(http://www.github.com/fuzziqersoftware/gctools). The JSON file refers
to the instrument sounds and MIDI sequence by filename and does not
include directory names, so if you want to play these, you'll have to
manually put the sounds and MIDI files in the same directory as the JSON
file if you're using --filename-format.
*7: Tune decoding is experimental and will likely produce unplayable MIDIs.
*8: For color table resources, the raw data is always saved even if it is
decoded properly, since the original data contains 16-bit values for
each channel and the output image file has less-precise 8-bit channels.
*9: icns resources are decoded into many different file types depending on
the contents of the resource. For subfields that have split alpha
channels (that is, the transparency data is in a different subfield),
resource_dasm produces an original image and one with transparency
applied. Some icns resources also contain metadata, which is exported as
.bin, .txt, and .plist files, except for the Icon Composer version used
to create the file, which is ignored. If you want the result in Icon
Composer format, use --save-raw=yes and resource_dasm will save it as a
.icns file.
*A: These resources appear to have a fixed format, with a constant sample
rate, sample width and channel count. You may have to adjust these
parameters in the output if it turns out that these are configurable.
*B: The disassembler attempts to find exported functions by parsing the jump
table in the CODE 0 resource, but if this resource is missing or not in
the expected format, it skips this step and does not fail. Generally, if
any "export_X:" labels appear in the disassembly, then export resolution
succeeded and all of the labels should be correct (otherwise they will
all be missing).
*C: Some coprocessor and floating-point opcodes (F-class) are not
implemented and will disassemble with the comment "// unimplemented".
*D: Most PowerPC applications have their executable code in the data fork.
To disassemble it, use m68kdasm (example above).
*E: The output image format can be specified using --image-format. The
default output format is bmp (Windows bitmap); other supported formats
are png and ppm.
如果Resource_dasm无法转换资源或不知道如何转换，则如果存在，它将尝试使用相应的TMPL（模板）资源来解码资源。如果没有适当的TMPL，则TMPL已损坏，或者TMPL无法解码资源，Resource_dasm将产生资源的原始数据。
Resource_DASM中的大多数解码器实现都是基于反设计现有软件并通过旧文档的销售插入的爪子，因此某些稀有类型的资源可能无法正常工作。但是，我希望这个项目尽可能完整，因此，如果您有一个可以解释的资源，但是resource_dasm无法解码，请将其发送给我（也许是通过附加到GitHub问题），我将尽力使Resource_dasm理解它。
Resource_dasm透明地解压缩了由资源管理器标记为压缩的资源。
资源管理器压缩方案从未由Apple正式记录或公开记录，因此这些解压缩器的实现基于反向工程的Resedit和其他经典Mac OS代码。总而言之，通过从DCMP或NCMP资源执行68K或PowerPC代码来解压缩资源，该代码像大多数其他资源一样在开放资源文件链中在运行时查找。 （实际上，相关的DCMP/NCMP通常包含在与压缩资源或系统文件中的同一文件中。）有两种不同的压缩资源格式和两种相应的68K解压缩器的相应格式； Resource_dasm实施两种格式的支持。
Resource_dasm包含Mac OS系统文件中内置的所有四个解压缩器的本机实现。具体来说：
Resource_dasm具有内置的68K和PowerPC模拟器来运行非默认解压缩器。这些仿真器还可以运行默认的解压缩器，这些解压缩器包含在Resource_dasm中。模拟解压缩器的当前状态：
我可能还没有看到其他解压缩器，这可能不起作用。如果您看到使用Resource_DASM时看到“警告：无法解压缩资源”，请创建一个GitHub问题并上传导致故障的导出的压缩资源（.bin文件），以及所有DCMP和NCMP资源从同一源文件中。
运行sudo make install以将标头文件和库复制到构建后的相关路径。安装后，您可以#include <resource_file/IndexFormats/ResourceFork.hh> （例如），然后与-lresource_file链接。除了标题文件中写的内容之外，该库中没有任何文档。
该库包含以下有用的功能和类：
使用M68KDASM相当简单。运行m68kdasm --help以获取完整的选项列表。
目前，M68KDASM可以拆卸这些类型的数据：
这些可执行格式中的一些支持M68KDASM不支持的CPU体系结构；如果遇到其中之一，它将将代码段作为数据段打印。
M68KDASM还可以将POWERPC，X86和SH-4组装组装到RAW二进制中。 （它不支持将M68K文本组装成二进制，但将来将实现。）每个体系结构的预期输入语法与拆卸语法匹配；对于PowerPC和SH-4，这不是大多数其他工具使用的标准语法。
M68Kexec是摩托罗拉68000、32位PowerPC和X86架构的CPU仿真器和调试器。我经常使用它来帮助了解某些古代码正在尝试做什么，或者将我转录为现代语言的代码与原始代码的行为进行比较。对于这样的用例，您通常需要设置一个或多个输入区域，其中包含您要测试的数据，以及一个或多个输出区域，以供仿真代码写入。
也许最好以身作则来解释。该命令用于执行来自Phantasy Star Online Blue Burst的加密上下文生成功能，以与Newserv中实现的相同函数进行比较：
./m68kexec --x86 --trace
--mem=A0000000/2AC43585C46A6366188889BCE3DB88B15C2B3C751DB6757147E7E9390598275CC79547B2E5C00DD145002816B59C067C
--mem=A1000000:1048
--load-pe=files/windows/pso/psobb.exe
--pc=00763FD0
--reg=ecx:A1000000
--push=00000030
--push=A0000000
--push=FFFFFFFF
--breakpoint=FFFFFFFF
--mem选项设置输入区域； A0000000区域包含加密种子（0x30字节），当功能返回时，A1000000区域将包含生成的加密上下文。 --load-pe选项加载要执行的代码， --pc告诉模拟器从哪里开始。 （默认情况下，它将从可执行文件中定义的输入点开始，如果有任何给出；在这里，我们要调用一个特定的函数。） --reg选项将函数中的this设置为我们分配给它的空间。 --push选项设置了函数的参数和返回地址。它将返回到没有分配内存的FFFFFFFF，但是我们还在该地址设置了一个--breakpoint ，该地址将停止仿真在抛出异常之前。
由于我们使用了--trace ，因此模拟器在每个操作码之后都会打印寄存器的状态，因此我们可以追踪其行为并将其与同一功能的外部实现进行比较。当功能返回并触发断点时，我们可以在Shell中使用r A1000000 1048来查看其生成的数据，并将其与我们的外部功能的结果进行比较。
render_bits可以回答“这个看起来随机的二进制数据实际上是图像或二维数组？”很有用吗？”给它一种颜色格式和一些二进制数据，它将产生一个完整的BMP文件，您可以使用自己喜欢的图像查看器或编辑器来查看该文件。如果您认为输入是索引颜色数据，则还可以给出一个颜色表（由clut资源从clut资源中产生的.bin文件）。如果输出看起来像垃圾，请以宽度和颜色格式进行播放，直到找出正确的参数为止。
运行render_bits，没有任何用于使用信息的选项。
render_text可让您查看使用bitmap字体（字体/NFNT资源）呈现时实际文本的样子。要使用它，请从字体或NFNT资源（例如带有Resource_dasm -save-Raw）获取.bin文件。然后在没有参数的情况下运行render_text来查看如何使用它。
有时，在反向工程过程中，您最终会得到一个具有正确内容和结构的图像，但是颜色是完全错误的。可能是用错误的颜色表渲染的。为了解决此问题，您可以使用report_clut将图像的所有像素从一个Colorspace映射到另一个Colorspace。
运行替换_clut，而无需用于使用信息的任何选项。
一些游戏存储了大图像，分为一组较小的纹理。 cossemble_images可以将它们集合到AA单个大图中。运行cossemble_images无需任何选项即可查看如何使用它。
dupe_finder在一个或几个资源文件中找到相同类型的重复资源。
运行dupe_finder，无需使用任何选项以获取信息信息。
hypercard_dasm stack_file [output_dir] ，或只是hypercard_dasm查看所有选项icon_dearchiver archive_file [output_dir]将图标打开到.ICNS文件。vrfs_dump VRFS_file [output_dir]DECODE_DATA可以解码和解压缩各种游戏使用的一些自定义编码格式。具体来说：
Game/App/Library | Encoding | CLI option | Notes
-------------------------------------------------------------
DinoPark Tycoon | LZSS | --dinopark | %0
DinoPark Tycoon | RLE | --dinopark |
Flashback | LZSS | --presage | %0
MacSki | COOK | --macski |
MacSki | CO2K | --macski |
MacSki | RUN4 | --macski |
PackBits (compress) | PackBits | --pack-bits |
PackBits (decompress) | PackBits | --unpack-bits |
Pathways Into Darkness | Pathways | --unpack-pathways |
SoundMusicSys | LZSS | --sms | %0
Notes:
%0: Although these are all variants of LZSS (and are indeed very similar to
each other), they are mutually incompatible formats.
DECODE_DATA可以单独使用来解压缩数据，也可以通过Resource_dasm用作外部预处理器，以透明地解压缩某些格式。例如，要将DECODE_DATA用于Macski Resources，您可以运行诸如resource_dasm --external-preprocessor="./decode_data --macski" input_filename ...命令。
Render_sprite可以渲染几种自定义游戏精灵格式。对于下面列出的某些格式，除精灵资源外，您还必须提供颜色表资源。由clut，pltt或ctbl资源产生的resource_dasm产生的.bin文件就足够了；通常，这些可以在与Sprite Resources或游戏应用程序中的同一文件中找到。运行render_sprite没有关于使用信息的论点。
支持格式：
Game | Type | CLI option | Need color table | Notes
---------------------------------------------------------------------------
Beyond Dark Castle | PBLK | --PBLK | No |
Beyond Dark Castle | PPCT | --PPCT | No |
Beyond Dark Castle | PSCR | --PSCR-v2 | No |
Blobbo | BTMP | --BTMP | No |
Blobbo | PMP8 | --PMP8 | Yes | $9
BodyScope | Imag | --Imag | Yes | $2 $3
Bonkheads | Sprt | --Sprt | Yes |
Bubble Trouble | btSP | --btSP | Yes |
Dark Castle (color) | DC2 | --DC2 | No | $4
Dark Castle (monochrome) | PPCT | --PPCT | No |
Dark Castle (monochrome) | PSCR | --PSCR-v1 | No |
DinoPark Tycoon | BMap | --BMap | No |
DinoPark Tycoon | XBig | --XBig | No | $2
DinoPark Tycoon | XMap | --XMap | Yes | $2 $7
Dr. Quandary | Imag | --Imag | Sometimes | $1 $2 $3
Factory | 1img | --1img | No |
Factory | 4img | --4img | Yes |
Factory | 8img | --8img | Yes |
Flashback | PPSS | --PPSS | Yes | $2 $8
Fraction Munchers | Imag | --Imag-fm | Sometimes | $1 $2 $3
Greebles | GSIF | --GSIF | Yes |
Harry the Handsome Executive | HrSp | --HrSp | Yes | $9
Lemmings | SHPD | --SHPD-v1 | Sometimes | $0 $1 $2 $5
Marathon | .256 | --.256-m | No | $2
Mario Teaches Typing | Pak | --Pak | Sometimes | $1 $2
Mars Rising | btSP | --btSP | Yes |
Number Munchers | Imag | --Imag-fm | Sometimes | $1 $2 $3
Odell Down Under | Imag | --Imag | Sometimes | $1 $2 $3
Oh No! More Lemmings | SHPD | --SHPD-v2 | Sometimes | $0 $1 $2 $5
Pathways Into Darkness | .256 | --.256-pd | No | $2
Prince of Persia | SHPD | --SHPD-p | Sometimes | $0 $1 $2 $5
Prince of Persia 2 | SHAP | --SHAP | Yes |
SimCity 2000 | SPRT | --SPRT | Yes | $2
SimTower | | | No | $A
Slithereens | SprD | --SprD | Yes | $2
SnapDragon | Imag | --Imag | Sometimes | $1 $2 $3
Spectre | shap | --shap | No | $6
Step On It! | sssf | --sssf | Yes | $2
Super Munchers | Imag | --Imag-fm | Sometimes | $1 $2 $3
Swamp Gas | PPic | --PPic | Sometimes | $0 $2 $3
The Amazon Trail | Imag | --Imag | Sometimes | $2 $3
The Oregon Trail | Imag | --Imag | Sometimes | $1 $2 $3
TheZone | Spri | --Spri | Yes |
Word Munchers | Imag | --Imag-fm | Sometimes | $1 $2 $3
Notes:
$0: render_sprite can't tell from the contents of the resource whether it is
color or monochrome, so it assumes the resource is color if you give a
color table on the command line. If decoding fails with a color table,
try decoding without one (or vice versa).
$1: These games contain some color and some monochrome graphics. It should
be obvious which are which (usually color graphics are in a separate
file), but if not, you can give a clut anyway in these cases and
render_sprite will ignore it if the image is monochrome.
$2: These sprite formats contain multiple images, so render_sprite will
produce multiple image files.
$3: Resources of this type can contain embedded color tables; if you're
rendering a color image that doesn't have a color table, you'll have to
provide one via a command-line option. If the resource (or individual
images therein) contain their own color tables or are monochrome, no
color table is required on the command line, and any provided color
table via the command line will be ignored.
$4: You can get DC2 sprites from the DC Data file with
`resource_dasm --index-format=dc-data "DC Data"`.
$5: The graphics files contain resources that refer to segments of the data
fork in the same file. So, this option expects the original Graphics or
BW Graphics or Persia file (with both data and resource forks present),
not an already-extracted resource.
$6: shap resources contain 3D models and 2D top-down projections of them.
When given a shap resource, render_sprite produces an STL file and an
OBJ file for the 3D model, and an SVG file for the 2D top-down view.
$7: Some XMap resources are stored inside CBag archives. You can extract
them with `resource_dasm --index-format=cbag <CBAG_file.bin>`.
$8: This game has only one clut and it's huge - far longer than the usual
256 entries. It seems PPSS image sets are meant to be rendered with a
subset of this clut, but I haven't been able to figure out (yet) how the
game chooses what subset of it to use.
$9: The game doesn't contain any color tables. You can use a 256-color clut
resource from the Mac OS System file, or use the --default-clut option.
$A: The game stores its sprites in normal PICT resources with an incorrect
type. Use `resource_dasm --copy-handler=PICT:%89%E6%91%9C` to decode
them instead of using render_sprite.
Icon_dearchiver将图标档案中的图标（由Alessandro Levi Montalcini）放在.ICNS中。运行它没有任何使用信息的选项。
blobbo_render <Blev-file.bin> <PMP8-128.bmp>ferazel_render ，或ferazel_render --help来查看所有选项（有很多！）gamma_zee_render gamma_zee_application levels_filenameharry_render --clut-file=clut.bin ，或者只是harry_render查看所有选项（有很多！）infotron_renderlemmings_render --clut-file=clut.bin或lemmings_render --help中查看所有选项mshines_render world_file [output_directory]lemmings_render作为原始诱饵，还使用--v2选项realmz_dasm global_data_dir [scenario_dir] out_dir （如果没有给出scenario_dir，请拆卸共享数据）
