66 lines
5.2 KiB
Groff
66 lines
5.2 KiB
Groff
.\" Automatically generated by egg-retarget-anim -write-bam
|
|
.TH EGG-RETARGET-ANIM 1 "27 December 2014" "1.9.0" Panda3D
|
|
.SH NAME
|
|
egg-retarget-anim \- remove transformations from animation data in .egg files
|
|
.SH SYNOPSIS
|
|
\fBegg-retarget-anim\fR -o output.egg [opts] input.egg
|
|
.br
|
|
\fBegg-retarget-anim\fR -d dirname [opts] file.egg [file.egg ...]
|
|
.br
|
|
\fBegg-retarget-anim\fR -inplace [opts] file.egg [file.egg ...]
|
|
.br
|
|
\fBegg-retarget-anim\fR -inf input_list_filename [opts]
|
|
.SH DESCRIPTION
|
|
egg\-retarget\-anim reads a character model and its associated animation files, and removes the translations and scales from the animation files, replacing them with the translations and scales from the rest position of the character model.
|
|
.PP
|
|
This allows an animation that was generated for a model with one skeleton to be played successfully on a model with a different skeleton, provided that both skeletons have the same hierarchy and differ only in scales and/or translations of the various joints, and that scales and translations are not part of the per\-frame animations.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-noabs
|
|
Don't allow any of the named egg files to have absolute pathnames. If any do, abort with an error. This option is designed to help detect errors when populating or building a standalone model tree, which should be self-contained and include only relative pathnames.
|
|
.TP
|
|
.BI "\-r " "file.egg"
|
|
Read the reference model from the indicated egg file. All of the animations will be retargeted to match the indicated file.
|
|
.TP
|
|
.BI "\-keep " "joint[,joint...]"
|
|
Preserve the full animation on the named joint(s). This is especially appropriate for the root joint.
|
|
.TP
|
|
.BI "\-pr " "path_replace"
|
|
Sometimes references to other files (textures, external references) are stored with a full path that is appropriate for some other system, but does not exist here. This option may be used to specify how those invalid paths map to correct paths. Generally, this is of the form 'orig_prefix=replacement_prefix', which indicates a particular initial sequence of characters that should be replaced with a new sequence; e.g. '/c/home/models=/beta/fish'. If the replacement prefix does not begin with a slash, the file will then be searched for along the search path specified by -pp. You may use standard filename matching characters ('*', '?', etc.) in the original prefix, and '**' as a component by itself stands for any number of components.
|
|
|
|
This option may be repeated as necessary; each file will be tried against each specified method, in the order in which they appear in the command line, until the file is found. If the file is not found, the last matching prefix is used anyway.
|
|
.TP
|
|
.BI "\-pp " "dirname"
|
|
Adds the indicated directory name to the list of directories to search for filenames referenced by the source file. This is used only for relative paths, or for paths that are made relative by a -pr replacement string that doesn't begin with a leading slash. The model-path is always implicitly searched anyway.
|
|
.TP
|
|
.BI "\-ps " "path_store"
|
|
Specifies the way an externally referenced file is to be represented in the resulting output file. This assumes the named filename actually exists; see -pr to indicate how to deal with external references that have bad pathnames. This option will not help you to find a missing file, but simply controls how filenames are represented in the output.
|
|
|
|
The option may be one of: rel, abs, rel_abs, strip, or keep. If either rel or rel_abs is specified, the files are made relative to the directory specified by -pd. The default is rel.
|
|
.TP
|
|
.BI "\-pd " "path_directory"
|
|
Specifies the name of a directory to make paths relative to, if '-ps rel' or '-ps rel_abs' is specified. If this is omitted, the directory name is taken from the name of the output file.
|
|
.TP
|
|
.BI "\-pc " "target_directory"
|
|
Copies textures and other dependent files into the indicated directory. If a relative pathname is specified, it is relative to the directory specified with -pd, above.
|
|
.TP
|
|
.BI "\-o " "filename"
|
|
Specify the filename to which the resulting egg file will be written. This is only valid when there is only one input egg file on the command line. If you want to process multiple files simultaneously, you must use either -d or -inplace.
|
|
.TP
|
|
.BI "\-d " "dirname"
|
|
Specify the name of the directory in which to write the resulting egg files. If you are processing only one egg file, this may be omitted in lieu of the -o option. If you are processing multiple egg files, this may be omitted only if you specify -inplace instead.
|
|
.TP
|
|
.B \-inplace
|
|
If this option is given, the input egg files will be rewritten in place with the results. This obviates the need to specify -d for an output directory; however, it's risky because the original input egg files are lost.
|
|
.TP
|
|
.BI "\-cs " "coordinate-system"
|
|
Specify the coordinate system to operate in. This may be one of 'y-up', 'z-up', 'y-up-left', or 'z-up-left'.
|
|
.TP
|
|
.B \-f
|
|
Force complete loading: load up the egg file along with all of its external references.
|
|
.TP
|
|
.BI "\-inf " "filename"
|
|
Reads input args from a text file instead of the command line. Useful for really, really large lists of args that break the OS-imposed limits on the length of command lines.
|
|
.TP
|
|
.B \-h
|
|
Display this help page.
|