txcopy - copy texture files
] | [ [
] ] [
intxtname ... ]
copies one or more PhotoRealistic RenderMan texture files called
and outputs a single new texture file called
Many characteristics of the input texture(s) can be altered by
The simplest use of
pre> txcopy old.txr new.txr
which will copy all of the channel data from the highest resolution from the
into the newly created texture file
By default the output texture file will have its texture data compressed, so
can be used to compress textures that were created using previous releases
of the RenderMan Toolkit which did not support compressed textures. Data
compression can be disabled using the
If more than one input file name is listed all of the channels of texture data
from all of the input files will be copied into subsequent channels of the
output texture. For instance, copying two four-channel textures into a single
output texture will cause the channels of the first input texture to be channels
0-3 of the output texture and the channels of the second input texture to be
channels 4-7 of the output texture. Output textures files are limited to a total
of eight channels.
The data type of the output texture (byte, short or float)
will be the same as the data type of the first input texture.
does not do data format conversion, so all input textures should have the
same data type.
Causes the output texture map to
be compressed. The default is to compress the data.
- -ch list
allows the selection of which texture channels will be copied from the input
file to the output file. Channels may be specified by numbers separated by
commas. The channels 0 to 3 may alternately be represented by the letters
r, g, b
The texture channels will be copied to output in the order the are specified
for all channels of a four channel image would be represented as either
The channels can be reversed in order like so:
To copy only the first channel, the
will apply to all subsequent input files on the command line until another
option is specified. By default all of the input texture's channels are
copied in numerical order.
- -res rcode
Selects which resolution to copy from the input texture.
is either a single number to specify a square resolution or two numbers
separated by a lower case
to specify the
resolution separately. For example
selects the 256 by 256 resolution and
selects the 128 by 512 resolution. The specified resolution must be present
in all of the input texture files. The default resolution is the highest
resolution present in the first texture file listed.
- -face facename
Selects which face to copy out of a cube faced environment map.
consists of two letters. The first is either
to specify positive or negative and the second is either
to specify which axis of the environment. The default is all faces.
- -mode|-smode|-tmode m
Specifies the wrap mode of the texture in both,
or each individual
parameter directions. The default is the mode of the first listed input
- -pattern p
Sets the pattern of resolutions that will be written to the output texture.
writes only the top level resolution copied from the input texture.
writes a series of resolutions generated by reducing the resolution in both
directions by one half until the lowest writeable resolution is reached.
writes all possible resolutions lower than the input resolution by reducing
the resolutions in the
directions separately until the lowest writeable resolution is reached. This
may improve texture system performance if the texture projection requires very
different resolutions of
The default is
- -fov angle
Sets the field of view for a cube-faced environment texture. The default is the
field of view of the first input file. If the first input file is not a
cube-faced environment, then the
option should be specified for correct results.
- -aspect aspectratio
Sets the pixel aspect ratio correction factor for the output simple texture file
(not shadow, environment or bump). By default,
txmake sets this value so as to make
input image pixels remain square if texture mapped through a square projection
onto a square patch, even if the input image is resized or non-square. A value
causes no aspect ratio correction to be performed for the output texture,
texture coordinates will range from 0.0 to 1.0 across the texture map.
- -type texturetype
Determines which type of texture is to be written. Valid types are
for a regular texture file,
for a shadow map (requires that input be a single shadow map),
for a lat-long environment map,
for a cube-face environment (requires either a single cube-face environment
or six individual faces in the order:
The default is the type of the first inpout texture.
Pixar Animation Studios
(510) 752-3000 (voice)
(510) 752-3151 (fax)
Copyright © 1996-
Pixar. All rights reserved.
RenderMan® is a registered trademark of Pixar.