1.1.6 • Published 15 days ago
@4bitlabs/scibud v1.1.6
scibud
scibud
is a CLI utility to assist in inspecting and extracting assets form Sierra SCI0
and SCI01
-engine adventure games.
Command-line usage
The easiest way to use scibud
is to use npx
:
$ npx @4bitlabs/scibud
scibud
will attempt to locate RESOURCE.*
files in your current working directory, if available. You can also use
--root
option to local resources from another directory.
# list pics, using the current directory
$ npx @4bitlabs/scibud pic list
# list pics, using RESOURCE.* files in ~/path/to/game directory
$ npx @4bitlabs/scibud --root=~/path/to/game pic list
Working with PIC
resources
Finding PIC
resources
$ npx @4bitlabs/scibud pic list
Getting details about PIC
resources
$ npx @4bitlabs/scibud pic info 1
Rendering PIC
resources
Usage: scibud pic render [options] <num>
Render pic resource as image
Arguments:
id picture resource number
Options:
-l, --layer <layer> (choices: "visible", "priority", "control", default: "visible")
-S, --pre-scaler <scaler> pre-dither pixel scaler (choices: "none", "2x2", "3x3", "4x4", "5x5", "5x6", "scale2x", "scale3x", "scale5x6", default: "none")
-d, --dither <dither> dither sizing. (default: "1x1")
-p, --palette <pal> the base palette (choices: "cga", "true-cga", "dga", default: "cga")
-c, --contrast <value> IBM 5153-style contrast knob. <value> should be between 0.0 and 1.0, or false (default: false)
-m, --palette-mixer <pal> palette mixing function (choices: "none", "10%", "15%", "25%", "soft", default: "none")
-s, --post-scaler <scaler> post-dither pixel scaler (choices: "none", "2x2", "3x3", "4x4", "5x5", "5x6", "scale2x", "scale3x", "scale5x6", default: "none")
-b, --blur <method> apply blur (choices: "none", "box", "hbox", "hblur", "gauss", default: "none")
-a, --blur-amount <amount> amount of pixels to blur (default: 1)
-F, --force-pal <value> Force (choices: "0", "1", "2", "3")
-f, --format <format> image format. used when writing to STDOUT (choices: "png", "jpg", "webp", "raw", default: "png")
-o, --output <string> output filename, "-" for STDOUT
-h, --help display help for command
For example:
# render PIC #1 to the default filename 'pic.001.png'
$ npx @4bitlabs/scibud pic render 1
# render PIC #1 as 'background.webp'
$ npx @4bitlabs/scibud pic render 1 -o background.webp
# render PIC #1 to STDOUT
$ npx @4bitlabs/scibud pic render 1 -o - | imgcat
Working with VIEW
resources
Finding VIEW
resources
$ npx @4bitlabs/scibud view list
Getting details about VIEW
resources
$ npx @4bitlabs/scibud view info 0
Rendering VIEW
resources
Usage: scibud view render [options] <num> <loop>
Arguments:
num id to render
loop loop to render
Options:
-p, --palette <pal> the base palette (choices: "cga", "true-cga", "dga", default: "cga")
-c, --contrast <value> IBM 5153-style contrast knob. <value> should be between 0.0 and 1.0, or false (default: false)
-s --scaler <scaler> pixel scaler (choices: "none", "2x2", "3x3", "4x4", "5x5", "5x6", "scale2x", "scale3x", "scale5x6", default: "none")
--animated render loop as animated gif (default: false)
--padding <padding> add extra padding around sprite (in pixels)
-o, --output <string> output filename, "-" for STDOUT
-f, --format <format> image format. used when writing to STDOUT (choices: "png", "jpg", "webp", "raw", default: "png")
-h, --help display help for command
# render VIEW #0, LOOP #0 to the default filename 'view.000-0.png'
$ npx @4bitlabs/scibud view render 0 0
# render VIEW #0, LOOP #1 as 'sprite-sheet.webp'
$ npx @4bitlabs/scibud view render 0 1 -o sprite-sheet.webp
# render VIEW #0, LOOP #2 to STDOUT
$ npx @4bitlabs/scibud view render 0 2 -o - | imgcat