Houdini 20.5 Reference Stand-alone utilities

iconvert

Converts an image of one type to another type.

On this page

Overview 

iconvert [options] infile outfile [tag tagvalue] ...

Options

-d ‹depth›

The bit-depth of the output file.

Use one of the following depth values:

Value

Result

byte, char, or 8

8 bit unsigned int

short or 16

16 bit unsigned int

half

16 bit floating point

float

32 bit floating point

For example, use -d half to convert to 16-bit floating point pixels.

-n ‹informat›

Normally, the program decides the input format based on the input file extension. You can force the input format using this option.

-t ‹outformat›

Normally, the program decides the output format based on the output file extension. You can force the output format using this option.

-g off|auto

By default, the program converts color gamma between formats. For example, .exr files are typically in linear format while .jpg files have gamma applied. If you specify -g auto, the program converts gamma (the default). If you specify -g off, the program does not convert gamma. You can set a default value for this option in the HOUDINI_AUTOCONVERT_IMAGE_FILES environment variable.

-m ‹miplevel›

When converting a mipmapped texture, use this map level as the input image.

-L ‹input_lut›

The path to a Cineon LUT file to use on the input image.

-O ‹output_lut›

The path to a Cineon LUT file to use on the output image.

--ocio

Use OCIO to detect the color space of the input and output images. This uses the OCIO file parsing rules.

--iscolorspace ‹ispace›

Explicitly specify the input OCIO color space.

--tocolorspace ‹ospace›

Explicitly specify the output OCIO color space.

--colorconvert ‹ispace› ‹ospace›

Explicitly specify both the input and output OCIO color spaces.

--ociolook ‹look_name›

An OCIO look to apply when transforming colors.

--ociodisplay ‹display› ‹view›

Apply a preset OCIO transformation using a display and view to look up the destination color space, transform, and tone mapping operation. You can reverse this transformation and transform from the display/view with the --ocioreverse flag.

--ocioreverse

Apply the inverse of the transformation specified by the --ociodisplay option, transforming from the display/view.

Note

When reversing the transform, use the output color space as the “source” color space.

Examples

Transform color spaces using OpenColorIO file rules

iconvert --ocio source.jpg output.exr

Transform color spaces using explicit OpenColorIO color spaces

iconvert --colorconvert srgb_tx lin_rec709 source.jpg output.exr
iconvert --colorconvert "sRGB Texture" "ACEScg" source.jpg output.exr
iconvert --colorconvert "sRGB Texture" "scene_linear" source.jpg output.exr

Transform color spaces using OpenColorIO display/view

# Use the default view for "sRGB - Display"
iconvert --ocio --ociodisplay "sRGB - Display" "" source.exr output.jpg

# Explicitly choose a view
iconvert --ocio --ociodisplay "sRGB - Display" "ACES 1.0 - SDR Video" source.exr output.jpg
iconvert --ocio --ociodisplay "sRGB - Display" "Un-tone-mapped" source.exr output.jpg

# Reverse the display transform
iconvert --iscolorspace ACEScg --ocioreverse --ociodisplay "sRGB - Display" "" source.exr output.jpg

Notes

  • iconvert applies gamma correction to color planes when converting between formats of different types, if those formats have different colorspaces. Use -g off to disable gamma correction.

  • Houdini’s list of known file extensions is in $HFS/houdini/dso_fb/index.

  • Tags are usually passed to the output image processor. You can prefix tags with in: or out: to specify which image the tag is for.

Stand-alone utilities

  • abcconvert

    Convert between Alembic formats.

  • abcecho

    Print information about an Alembic file.

  • abcinfo

    Print information about an Alembic file.

  • chchan

    Copies channel collection to/from action channel format.

  • chcp

    Copies channel collection file to another format.

  • chinfo

    Prints information about a channel collection file.

  • claudio

    Copies CHOP data (clip) to/from audio formats.

  • clchan

    Copies CHOP data (clip) to/from action channel format.

  • clchn

    Copies CHOP data (clip) to/from channel collection format.

  • clcp

    Copies CHOP data (clip) to another format.

  • clinfo

    Prints information about a CHOP data (clip) file.

  • dsmconvert

  • dsmmerge

  • dsparse

    Parses and displays dialog scripts.

  • gabc

    Convert between Alembic and Houdini geometry.

  • gconvert

    Convert between Houdini polygon formats.

  • gdxf

    Converts DXF polygons to/from Houdini format.

  • geodiff

    Display Geometry Differences.

  • geps

    Converts EPS files to Houdini polygon format.

  • giges

  • ginfo

    Prints polygon file statistics.

  • glightwave

    Converts LightWave files to/from Houdini format.

  • gpdb

    Converts .pdb files to/from Houdini format.

  • gplay

    Geometry viewer.

  • gply

    Converts .ply files to/from Houdini format.

  • gptex

    Makes a ptexture image file from a geometry file.

  • greduce

    Reduces polygons in a file.

  • gwavefront

    Converts .obj files to/from Houdini format.

  • hcollapse

    Collapses a directory structure.

  • hcpio

  • hexpand

    Expands hip files into a directory structure.

  • hkey / License Administrator

    Opens a graphical user interface for viewing and managing licenses and license server options.

  • hoiiotool

    Swiss-army knife of image operation tools.

  • hotl utility

    Command line utility to work with .hda/.otl files.

  • hrender

  • hsc

  • hscript

    Command line HScript interpreter.

  • hserver

    Houdini communicates through this proxy server to the sesinetd licensing daemon.

  • htexcache

    Query or modify the disk texture cache.

  • husk

    Command line utility for rendering a USD file using Karma or some other Hydra client.

  • i3dconvert

  • iautocrop

    Crops images based on pixel values.

  • icineon

    Convert images from 10-bit Cineon format to an 8 bit format.

  • icomposite

  • iconvert

    Converts an image of one type to another type.

  • icp

    Isolate a region of an image in a new image.

  • idenoise

    Removes noise from an image file.

  • idiff

    Display Image Differences.

  • iflip - Flip Image

  • iinfo

    Outputs information about an image.

  • ilut

    Generates a lookup table (LUT) from standard channel formats or another LUT.

  • ilutcomp

    Generates a single lookup table (LUT) from from two LUTs.

  • ilutinfo

    Prints information about a lookup table (LUT) file.

  • imaketx

    Creates mipmapped .exr or .rat textures from image files.

  • imdisplay

    Sends an image to an mdisplay window.

  • iprint

    Prints the RGBA values for an image as text.

  • iquantize

    Reduces the number of colors in an image.

  • isixpack

    Generates an environment/reflection map from six images representing the six sides of a cube, or a cross image.

  • itilestitch

    Assemble a series of image files with crop windows into a single image.

  • izg

    Converts Z-depth images to 8-bit grayscale images.

  • Launcher

    The Houdini Launcher downloads, installs, upgrades, and uninstall Houdini and its components.

  • mcacclaim

    Converts an Acclaim motion file to a Houdini script and channel file(s).

  • mcbiovision

    Converts a BioVision motion file to a Houdini script and channel file(s).

  • mcmotanal

    Converts a Motion Analysis TRC motion file to a Houdini script and channel file(s).

  • mcp

    Convert an image sequence to a movie file.

  • minfo

    Prints information about movie files.

  • mqserver

    Message Queue Server for PDG/TOPs

  • py23convert

    Convert Python 2 expressions in HDAs to Python 2/3.

  • renderstatsoverlay

    Generates a (possibly scaled down) version of a rendered image with render statistics baked in.

  • renderstatsreport

    Generates an HTML page containing render statistics from an EXR image.

  • sesictrl

    Sets Houdini license server options from the command line.

  • sesinetd

    The Houdini license server. This program runs in the background managing Houdini licenses.

  • siminfo

    Prints simulation cache file statistics.

  • spiff

    Display Text Differences.

  • spy

    Shell utility for navigating the UNIX filesystem.

  • usdview

    Command line utility for viewing and inspecting USD scenes.

  • vexcache

    Query or modify the VEX compile cache.

  • vexexec

    Execute a cvex shader.