Man page - mipgen(1)

Packages contains this manual

Package: libfilament-tools
apt-get install libfilament-tools

Manuals in package:

Documentations in package:

libfilament-tools

Manual

MIPGEN

NAME
DESCRIPTION
Usage:
OPTIONS
EXAMPLES
Usage:

NAME

mipgen - filament material tools

DESCRIPTION

mipgen generates mipmaps for an image down to the 1x1 level.

The <output_pattern> argument is a printf-style pattern. For example, "mip%2d.png" generates mip01.png, mip02.png, etc. Miplevel 0 is not generated since it is the original image.

If the output format is a container format like KTX, then <output_pattern> is simply a filename.

Usage:

mipgen [options] <input_file> <output_pattern>

OPTIONS

--help , -h

print this message

--license , -L

print copyright and license information

--linear , -l

assume that image pixels are already linearized

--page , -p

generate HTML page for review purposes (mipmap.html)

--quiet , -q

suppress console output from the mipgen tool

--grayscale , -g

create a single-channel image and do not perform gamma correction

--format = [exr |hdr|rgbm|psd|png|dds|ktx], -f [exr|hdr|rgbm|psd|png|dds|ktx]

specify output file format, inferred from output pattern if omitted

specify filter kernel type (defaults to lanczos) the "normals" filter may automatically change the compression scheme

--add-alpha

if the source image has 3 channels, this adds a fourth channel filled with 1.0

--strip-alpha

ignore the alpha component of the input image

--mip-levels = N , -m N

specifies the number of mip levels to generate if 0 (default), all levels are generated

--compression = COMPRESSION , -c COMPRESSION

format specific compression:

KTX:

astc_[fast|thorough]_[ldr|hdr]_WxH, where WxH is a valid block size s3tc_rgb_dxt1, s3tc_rgba_dxt5 etc_FORMAT_METRIC_EFFORT

FORMAT is r11, signed_r11, rg11, signed_rg11, rgb8, srgb8, rgb8_alpha

srgb8_alpha, rgba8, or srgb8_alpha8

METRIC is rgba, rgbx, rec709, numeric, or normalxyz EFFORT is an integer between 0 and 100

PNG: Ignored Radiance: Ignored Photoshop: 16 (default), 32 OpenEXR: RAW, RLE, ZIPS, ZIP, PIZ (default) DDS: 8, 16 (default), 32