mirror of
https://github.com/elasota/Aerofoil.git
synced 2025-09-24 15:16:38 +00:00
Improve PICT compatibility, add batch mode to gpr2gpa
This commit is contained in:
27
Documentation/picterrors.txt
Normal file
27
Documentation/picterrors.txt
Normal file
@@ -0,0 +1,27 @@
|
||||
Many Glider PRO houses, including the bundled ones, contain images in QuickDraw
|
||||
PICT format in the game resource data.
|
||||
|
||||
Additionally, some PICT features are impossible to support because they
|
||||
require copyrighted pattern sets and fonts that are bundled with the
|
||||
operating system.
|
||||
|
||||
My goal is to support as many community houses as possible, but there is a
|
||||
point where supporting the format is more work than just manually converting
|
||||
the resources on a Macintosh machine or emulator.
|
||||
|
||||
All of the remaining known unsupported features necessary to decode the
|
||||
remaining cases are only used by one house that I'm aware of each.
|
||||
|
||||
Known error codes:
|
||||
|
||||
Code 5 subcode 25: Strange image channel layout
|
||||
Code 8 subcode 145: Unsupported BitsRgn opcode.
|
||||
Code 8 subcode 40960: Undocumented opcode, possibly a format parsing error.
|
||||
|
||||
Code 8 subcode 34: Unsupported ShortLine opcode. (PICT contains vector graphics.)
|
||||
Code 8 subcode 35: Unsupported ShortLineFrom opcode. (PICT contains vector graphics.)
|
||||
Code 8 subcode 49: Unsupported PaintRect opcode. (PICT contains vector graphics.)
|
||||
Code 8 subcode 51: Unsupported PaintOval opcode. (PICT contains vector graphics.)
|
||||
Code 8 subcode 129: paintRgn opcode. (PICT contains vector graphics.)
|
||||
Code 8 subcode 33280: Unsupported CompressedQuickTime opcode. (PICT contains a QuickTime frame.)
|
||||
Code 8 subcode 33281: Unsupported UncompressedQuickTime opcode. (PICT contains a QuickTime frame.)
|
@@ -55,4 +55,30 @@ Some old QuickTime movies contain movie tracking information in the movie
|
||||
resource fork, in which case you need to merge them into the data for modern
|
||||
utilities to read them. You can use the "flattenmov" tool to do this: Pass
|
||||
it the data (.gpd) and resource (.gpr) data files for a movie, and it will
|
||||
merge them into a single .mov file.
|
||||
merge them into a single .mov file.
|
||||
|
||||
|
||||
BATCH CONVERSION
|
||||
------------------------------------------------------------------------------
|
||||
To batch-convert house resource files, use gpr2gpa with a path that ends
|
||||
with an asterisk (*) and omit the output filename.
|
||||
|
||||
|
||||
SECURITY CONSIDERATIONS
|
||||
------------------------------------------------------------------------------
|
||||
Glider PRO didn't really do any validation of houses. Currently, Aerofoil
|
||||
doesn't do any additional validation either, and it's possible that invalid
|
||||
house data may lead to crashes or even remote code execution.
|
||||
|
||||
I will be doing a hardening pass on the loader for the 1.1 release. Until
|
||||
then, please only load houses from trusted sources.
|
||||
|
||||
Also, Glider PRO houses were able to take advantage of a resource overlaying
|
||||
feature of the Macintosh operating system, where a resource being present in
|
||||
the house file with the same ID as an application resource would cause the
|
||||
resource to override the application resource.
|
||||
|
||||
Aerofoil's resource loader is much more restrictive: Currently, only
|
||||
backgrounds, audio triggers, and icons may load from the house data. This
|
||||
restriction will be loosened in the 1.1 release to allow resources to be
|
||||
overrided if I can confirm that it's safe to override them.
|
Reference in New Issue
Block a user