[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

3.3.1 Command Line Options

tdlmake is invoqued by specifying at least two file names and an optional set of command-line switches:

 
% tdlmake [options] input.tif [input2.tif ... input6.tif] output.tif

Valid options are:

`-envlatl'
Generate a latitude-longitude environement map;

`-envcube'
Generate a cubic environment map. Needs six TIFFs in input, ordered as follow: +x, -x, +y, -y, +z, -z;

`-shadow'
Generate a shadowmap from a zfile. When generating a shadowmap, only the `-c-' option is functional.

`-lzw'
Compress output texture using LZW algorithm. This option is enabled by default since compressed textures take much less space and there is no noticeable speed penality when accessing them;

`-deflate'
Compress output texture using the Deflate algorithm. Has a better compression ration than LZW;

`-packbits'
Compress output texture using Apple's PackBits algorithm. Compression ratio is not as good as with LZW or Deflate but decompression is very fast;

`-c-'
Do not compress output texture;

`-fov n'
Specifies a field of view, in degrees, for cubic environment maps. Default is `90' degrees;

`-mode <black|clamp|periodic>'
`-smode <black|clamp|periodic>'
`-tmode <black|clamp|periodic>'
Specifies what action should be taken when accessing a texture (using texture()) outside its defined parametric range (s, t = [0..1]):
`black'
Texture is black outside its paramtric range;
`clamp'
Texture's borders extend to infinity;
`periodic'
Texture is tiled infinitely;
`-smode' and `-tmode' specifiy the wrapping modes of the texture in s or t only. Default mode is `black' for normal textures and `periodic' for latitude-longitude environment maps. Note that this option does not affect the look of the `.tdl', its effects will only be noticeable when using texture() from inside a shader.

`-filter <box|triangle|gaussian|catmull-rom|bessel|sinc>'
Specifies a downsampling filter to use when creating mipmap levels. The default filter is sinc. Here is a table showing the complete list of supported filters, along with their `filterwidth' and window defaults:

filter filterwidth window Comment
box 1.0 -- This filter tends to blur textures, use only if texture generation speed is an issue;
triangle 2.0 -- filterwidth larger than 2.0 is unnecessary;
gaussian 2.50 -- A good filter that might produce slightly blurry results, not as much as the box filter though;
catmull-rom 4.0 -- A better filter (producing sharper textures);
bessel 6.47660 `lanczos' Filter width choosen as to include 2 roots;
sinc 8.0 `lanczos' We recommend this high quality filter as the best choice. Although it can produce some ringing artifacts on some textures. Using a filterwidth smaller than 4 is not recommended.

`-window <lanczos|hamming|hann|blackman>'
A windowing function can be applied to bessel and sync filters (which are infinite in width) to achieve a softer cut at the filter's support boundaries. Possible windowing schemes are `lanczos', `hamming', `hann' and `blackman'.

`-filterwidth n'
Overrides the default filter width in s and t. Important : filter width is the diameter of the filter and not the radius;

`-sfilterwidth n'
`-tfilterwidth n'
Overrides the default filter width in s or t;

`-blur n'
Blurs or sharpens the output image. Values larger than one will make the image more blurry and values smaller than one will produce sharper results. This function works by scaling the filter function by the specified value. This is not the same thing as scaling `sfilterwidth' and `tfilterwidth'. Default is `1'.

`-quality <low|medium|high>'
Controls mipmap downsampling strategy: when using `low', each mipmap level is created from the previous one. At `medium' quality, each level is created from the 2nd previous level. At `high' quality, each level is created from up to the 4th previous level. The default `medium' setting is more than enough for most applications.

`-flips'
`-flipt'
Flip the image horizontally or vertically;

`-flipst'
Flip the image in both directions;

`-progress'
Shows texture creation progress, only useful for really large textures (or really slow computers!);

`-v'
Prints version and copyright informations;

`-h'
Shows help text.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated by Aghiles Kheffache on July, 31 2003 using texi2html
3Delight 1.0.0. Copyright 2000-2003 The 3Delight Team. All Rights Reserved.