| Latest experimental build (with 0.900+ features) can be downloaded here: fCraft_MapUtils_0900_r2344.zip
This is a portable build, and can be used without fCraft.dll and fCraftGUI.dll
MapRenderer is a utility, bundled with fCraft 0.630+, that can render images from map files. MapRenderer.exe requires
fCraftGUI.dll to function.
MapRenderer [options] "MapFile1" "MapFile2" "MapFile3..."
MapRenderer [options] "Directory"
Rendering a single map
- Draws contents of SomeMap.fcm with all default parameters, producing "SomeMap.png"
Rendering multiple maps
MapRenderer "Map1.fcm" "Map2.fcm" "someDir/MapX.fcm"
- Draws contents of all given maps with default parameters, producing "Map1.png", "Map2.png", and "someDir/MapX.png"
MapRenderer -r "maps/"
- Finds all map files in "C:/maps", including files in subdirectories, and renders them with default settings. Images are saved into each map's respective directory. Image filenames are based on mapfile names, with file extension change to ".png"
Moving out rendered images
MapRenderer -r -o="images/" "maps/"
- Same as above, but all images are placed into "images/" directory.
MapRenderer -f=builder* "maps/"
- Looks for mapfile names that start with "builder", draws them with default settings.
MapRenderer --noshadows -q=90 e=JPEG "SomeMap.fcm"
- Draws contents of SomeMap.fcm, without shadows, and saves results to SomeMap.jpg at 90% quality.
| Options have alternative short (one-letter) and a long (whole word) forms. You can use either form: |
One-letter flags can be combined:
- Optional: Angle (orientation) from which the map is drawn. May be -90, 0, 90, 180, or 270. Default is 0.
- Optional: Image format to use for exporting. Supported formats: PNG (default), BMP, GIF, JPEG, TIFF.
- Optional: Pattern to filter input filenames, e.g.
builder*. Applicable only when a directory name is given as input. Regular expressions can be used in the filter if
--regexflag is given.
- Optional: Disables altitude-based gradient/shading on terrain.
- Optional: Converter used for importing/loading maps. Available formats:
- Auto - default; tries to determine file type automatically
- Classic (.dat or .mine) - Minecraft Classic and SurvivalTest maps
- ClassicWorld (.cw) - used by ClassiCube and fCraft 0.900+ (new in 0.900)
- D3 (.map)
- D3Folder (folder) - used by newer versions of D3 server (new in 0.900)
- FCMv2 (.fcm) - used by fCraft prior to version 0.500
- FCMv3 (.fcm) - used in fCraft 0.500-0.64x
- Indev (.mclevel) - from Minecraft Indev maps
- JTE (.gz)
- MCSharp (.lvl) - MCSharp, FemtoCraft, MCZall, MCLawl, MCForge, etc
- MinerCPP (.dat) - MinerCPP and LuaCraft
- Myne (directory-based) - Myne, MyneCraft, Hyvebuild, and iCraft
- Opticraft (.save)
- Optional: Makes all lava partially see-through, instead of opaque.
- Optional: Rendering mode. May be "normal" (default), "cut" (cuts out a quarter of the map, revealing inside), "peeled" (strips the outer-most layer of blocks), "chunk" (renders only a specified region of the map).
- Optional: Path to save images to. If not specified, images will be saved to the maps' directory.
- Optional: Sets JPEG compression quality. Between 0 and 100. Default is 80. Applicable only when exporting images to .jpg or .jpeg.
- Optional: Look through all subdirectories for map files. Applicable only when a directory name is given as input.
- Optional: Region of the map to render. Should be given in following format: "region=x1,y1,z1,x2,y2,z2". By fCraft's conventions, x/y are horizontal coordinates (width/length), and z is the vertical coordinate (height). Applicable only when rendering mode is set to "chunk".
- Optional: Disables rendering of shadows.
- Optional: Number of threads to use, to render multiple files in parallel. Default is same as your CPU count (e.g. 2 threads on a dual-core CPU, 4 threads on quad-core, etc).
- Optional: Try ALL the map converters on files that MapRenderer has trouble loading. When enabled, ALL map converters are tried, including ones that do not typically handle files with the given file extension. BY default (without this flag), MapRenderer will only try converters that typically accept files with the given file extension.
- Optional: Does not crop the finished map image, leaving some empty space around the edges.
- Optional: Makes all water see-through, instead of mostly opaque.
- Optional: When to overwrite existing image files:
- Ask - default; asks the user for every image.
- Always - Always overwrite old files.
- IfNewer - Overwrite if image file is older than the map file.
- Never - Skip any already-existing image files.
-?, -h, --help
- Prints usage information and a list of options.
MapRenderer.exe exit codes
- MapRenderer uses a subset of MapConverter's exit codes:
|1||ArgumentError||Required command-line arguments were missing, or an error occurred while trying to parse options.|
|2||UnrecognizedImporter||Given importer name was not recognized.|
|4||InputPathNotFound||Given file/directory name does not exist.|
|5||PathError||Error occurred while trying to check input directory, or error occurred while trying to check/create output directory.|
|6||UnsupportedLoadFormat||Given map format name ("importer") was recognized, but loading from it is not supported.|
|7||UnsupportedSaveFormat||Given image format name ("export") was recognized, but saving to it is not supported.|
MapRenderer is powered by a library named IsoCat (now part of fCraft), loosely influenced by IsoCraft.