This class supervises the construction of an EggData structure from a single Maya file, or from the data already in the global Maya model space. More...
#include "mayaToEggConverter.h"
Public Types | |
enum | TransformType { TT_invalid, TT_all, TT_model, TT_dcs, TT_none } |
Public Member Functions | |
MayaToEggConverter (const std::string &program_name="") | |
MayaToEggConverter (const MayaToEggConverter ©) | |
void | add_exclude (const GlobPattern &glob) |
Adds a name pattern to the list of excluded nodes. More... | |
void | add_force_joint (const GlobPattern &glob) |
Adds a name pattern to the list of force_joints. More... | |
void | add_ignore_slider (const GlobPattern &glob) |
Adds a name pattern to the list of ignore_sliders. More... | |
void | add_subroot (const GlobPattern &glob) |
Adds a name pattern to the list of subroot nodes. More... | |
void | add_subset (const GlobPattern &glob) |
Adds a name pattern to the list of subset nodes. More... | |
void | clear () |
Frees all of the Maya pointers kept within this object, in preparation for loading a new scene or releasing the Maya API. More... | |
void | clear_excludes () |
Empties the list of excluded nodes added via add_exclude(). More... | |
void | clear_force_joints () |
Empties the list of force_joints added via add_force_joint(). More... | |
void | clear_ignore_sliders () |
Empties the list of ignore_sliders added via add_ignore_slider(). More... | |
void | clear_subroots () |
Empties the list of subroot nodes added via add_subroot(). More... | |
void | clear_subsets () |
Empties the list of subset nodes added via add_subset(). More... | |
void | close_api () |
Closes the Maya API, if it was previously opened. More... | |
virtual bool | convert_file (const Filename &filename) |
Handles the reading of the input file and converting it to egg. More... | |
bool | convert_maya () |
Fills up the egg_data structure according to the global maya model data. More... | |
bool | force_joint (const std::string &name) const |
Returns true if the indicated name is on the list of DAG nodes to treat as a joint, false otherwise. More... | |
virtual std::string | get_additional_extensions () const |
Returns a space-separated list of extension, in addition to the one returned by get_extension(), that are recognized by this converter. More... | |
virtual std::string | get_extension () const |
Returns the common extension of the file type this converter supports. More... | |
virtual DistanceUnit | get_input_units () |
This may be called after convert_file() has been called and returned true, indicating a successful conversion. More... | |
virtual std::string | get_name () const |
Returns the English name of the file type this converter supports. More... | |
bool | ignore_slider (const std::string &name) const |
Returns true if the indicated name is on the list of sliders to ignore, false otherwise. More... | |
virtual SomethingToEggConverter * | make_copy () |
Allocates and returns a new copy of the converter. More... | |
bool | open_api (bool revert_directory=true) |
Attempts to open the Maya API if it was not already open, and returns true if successful, or false if there is an error. More... | |
PT (MayaApi) _maya | |
void | set_from_selection (bool from_selection) |
Sets the flag that indicates whether the currently selected Maya geometry will be converted. More... | |
Public Member Functions inherited from SomethingToEggConverter | |
SomethingToEggConverter (const SomethingToEggConverter ©) | |
void | clear_egg_data () |
Sets the EggData to NULL and makes the converter invalid. More... | |
void | clear_end_frame () |
Removes the value previously set by set_end_frame(). More... | |
void | clear_error () |
Resets the error flag to the no-error state. More... | |
void | clear_frame_inc () |
Removes the value previously set by set_frame_inc(). More... | |
void | clear_input_frame_rate () |
Removes the value previously set by set_input_frame_rate(). More... | |
void | clear_neutral_frame () |
Removes the value previously set by set_neutral_frame(). More... | |
void | clear_output_frame_rate () |
Removes the value previously set by set_output_frame_rate(). More... | |
void | clear_start_frame () |
Removes the value previously set by set_start_frame(). More... | |
Filename | convert_model_path (const Filename &orig_filename) |
Converts the indicated model filename to a relative or absolute or whatever filename, according to _path_replace. More... | |
AnimationConvert | get_animation_convert () const |
Returns how source animation will be converted into egg structures. More... | |
const std::string & | get_character_name () const |
Returns the name of the character generated. More... | |
EggData * | get_egg_data () |
Returns the EggData structure. More... | |
double | get_end_frame () const |
Returns the value set by a previous call to set_end_frame(). More... | |
double | get_frame_inc () const |
Returns the value set by a previous call to set_frame_inc(). More... | |
double | get_input_frame_rate () const |
Returns the value set by a previous call to set_input_frame_rate(). More... | |
bool | get_merge_externals () const |
Returns the current state of the merge_externals flag. More... | |
double | get_neutral_frame () const |
Returns the value set by a previous call to set_neutral_frame(). More... | |
double | get_output_frame_rate () const |
Returns the value set by a previous call to set_output_frame_rate(). More... | |
PathReplace * | get_path_replace () |
Returns a pointer to the PathReplace object associated with this converter. More... | |
const PathReplace * | get_path_replace () const |
Returns a pointer to the PathReplace object associated with this converter. More... | |
double | get_start_frame () const |
Returns the value set by a previous call to set_start_frame(). More... | |
bool | had_error () const |
Returns true if an error was detected during the conversion process (unless _allow_errors is true), false otherwise. More... | |
bool | handle_external_reference (EggGroupNode *egg_parent, const Filename &ref_filename) |
Handles an external reference in the source file. More... | |
bool | has_end_frame () const |
Returns true if the ending frame has been explicitly specified via set_end_frame(), or false if the ending frame should be implicit based on the source. More... | |
bool | has_frame_inc () const |
Returns true if the frame increment has been explicitly specified via set_frame_inc(), or false if the ending frame should be implicit based on the source. More... | |
bool | has_input_frame_rate () const |
Returns true if the frame rate has been explicitly specified via set_input_frame_rate(), or false otherwise. More... | |
bool | has_neutral_frame () const |
Returns true if the neutral frame has been explicitly specified via set_neutral_frame(), or false otherwise. More... | |
bool | has_output_frame_rate () const |
Returns true if the frame rate has been explicitly specified via set_output_frame_rate(), or false otherwise. More... | |
bool | has_start_frame () const |
Returns true if the starting frame has been explicitly specified via set_start_frame(), or false if the starting frame should be implicit based on the source. More... | |
virtual | PT (PandaNode) convert_to_node(const LoaderOptions &options |
void | set_animation_convert (AnimationConvert animation_convert) |
Specifies how source animation will be converted into egg structures. More... | |
void | set_character_name (const std::string &character_name) |
Specifies the name of the character generated. More... | |
void | set_egg_data (EggData *egg_data) |
Sets the egg data that will be filled in when convert_file() is called. More... | |
void | set_end_frame (double end_frame) |
Specifies the ending frame of the animation to convert, in the units specified by set_input_frame_rate(). More... | |
void | set_frame_inc (double frame_inc) |
Specifies the increment between frames to extract. More... | |
void | set_input_frame_rate (double input_frame_rate) |
Specifies the number of frames per second that is represented by the "frame" unit in the animation package. More... | |
void | set_merge_externals (bool merge_externals) |
Sets the merge_externals flag. More... | |
void | set_neutral_frame (double neutral_frame) |
Specifies the frame of animation to represent the neutral pose of the model. More... | |
void | set_output_frame_rate (double output_frame_rate) |
Specifies the number of frames per second that the resulting animation should be played at. More... | |
void | set_path_replace (PathReplace *path_replace) |
Replaces the PathReplace object (which specifies how to mangle paths from the source to the destination egg file) with a new one. More... | |
void | set_start_frame (double start_frame) |
Specifies the starting frame of the animation to convert, in the units specified by set_input_frame_rate(). More... | |
virtual bool | supports_compressed () const |
Returns true if this file type can transparently load compressed files (with a .pz extension), false otherwise. More... | |
virtual bool | supports_convert_to_node (const LoaderOptions &options) const |
Returns true if this converter can directly convert the model type to internal Panda memory structures, given the indicated options, or false otherwise. More... | |
Static Public Member Functions | |
static TransformType | string_transform_type (const std::string &arg) |
Returns the TransformType value corresponding to the indicated string, or TT_invalid. More... | |
Static Public Member Functions inherited from SomethingToEggConverter | |
static double | get_default_frame_rate () |
Returns the default frame rate if nothing is specified for input_frame_rate or output_frame_rate, and the animation package does not have an implicit frame rate. More... | |
Public Attributes | |
bool | _always_show_vertex_color |
bool | _convert_cameras |
bool | _convert_lights |
bool | _keep_all_uvsets |
bool | _legacy_shader |
bool | _polygon_output |
double | _polygon_tolerance |
bool | _respect_maya_double_sided |
bool | _round_uvs |
MayaShaders | _shaders |
EggTextureCollection | _textures |
TransformType | _transform_type |
Public Attributes inherited from SomethingToEggConverter | |
bool | _allow_errors |
virtual const Filename & | filename |
This class supervises the construction of an EggData structure from a single Maya file, or from the data already in the global Maya model space.
Note that since the Maya API presents just one global model space, it is not possible to simultaneously load two distinct Maya files.
Definition at line 52 of file mayaToEggConverter.h.
void MayaToEggConverter::add_exclude | ( | const GlobPattern & | glob | ) |
Adds a name pattern to the list of excluded nodes.
Definition at line 262 of file mayaToEggConverter.cxx.
void MayaToEggConverter::add_force_joint | ( | const GlobPattern & | glob | ) |
Adds a name pattern to the list of force_joints.
Any DAG node that matches a name on the list will be treated as if it were a joint during the conversion process; it will receive animation and position information. Normally, a true Maya joint, as well as any DAG nodes whose transforms are animated, will automatically be flagged as a Panda joint.
Definition at line 322 of file mayaToEggConverter.cxx.
void MayaToEggConverter::add_ignore_slider | ( | const GlobPattern & | glob | ) |
Adds a name pattern to the list of ignore_sliders.
Any slider (blend shape deformer) that matches a name on the list will not be converted or otherwise molested by the converter. This is occasionally necessary to filter out automatically-created sliders that are not intended to be used directly, but instead have an indirect effect on other sliders.
Definition at line 283 of file mayaToEggConverter.cxx.
void MayaToEggConverter::add_subroot | ( | const GlobPattern & | glob | ) |
Adds a name pattern to the list of subroot nodes.
If the list of subroot nodes is not empty, then only a subroot of the nodes in the maya file will be converted: those whose names match one of the patterns given on this list.
Definition at line 226 of file mayaToEggConverter.cxx.
void MayaToEggConverter::add_subset | ( | const GlobPattern & | glob | ) |
Adds a name pattern to the list of subset nodes.
If the list of subset nodes is not empty, then only a subset of the nodes in the maya file will be converted: those whose names match one of the patterns given on this list.
Definition at line 246 of file mayaToEggConverter.cxx.
void MayaToEggConverter::clear | ( | ) |
Frees all of the Maya pointers kept within this object, in preparation for loading a new scene or releasing the Maya API.
Definition at line 567 of file mayaToEggConverter.cxx.
References MayaShaders::clear(), MayaNodeTree::clear(), and EggTextureCollection::clear().
Referenced by close_api(), convert_file(), and convert_maya().
void MayaToEggConverter::clear_excludes | ( | ) |
Empties the list of excluded nodes added via add_exclude().
Definition at line 254 of file mayaToEggConverter.cxx.
void MayaToEggConverter::clear_force_joints | ( | ) |
Empties the list of force_joints added via add_force_joint().
No joints will be forced.
Definition at line 308 of file mayaToEggConverter.cxx.
void MayaToEggConverter::clear_ignore_sliders | ( | ) |
Empties the list of ignore_sliders added via add_ignore_slider().
No sliders will be ignored.
Definition at line 271 of file mayaToEggConverter.cxx.
void MayaToEggConverter::clear_subroots | ( | ) |
Empties the list of subroot nodes added via add_subroot().
The entire file will once again be converted.
Definition at line 215 of file mayaToEggConverter.cxx.
void MayaToEggConverter::clear_subsets | ( | ) |
Empties the list of subset nodes added via add_subset().
The entire file will once again be converted.
Definition at line 235 of file mayaToEggConverter.cxx.
void MayaToEggConverter::close_api | ( | ) |
Closes the Maya API, if it was previously opened.
Caution! Maya appears to call exit() when its API is closed.
Definition at line 556 of file mayaToEggConverter.cxx.
References clear().
|
virtual |
Handles the reading of the input file and converting it to egg.
Returns true if successful, false otherwise.
This is designed to be as generic as possible, generally in support of run- time loading. Also see convert_maya().
Implements SomethingToEggConverter.
Definition at line 185 of file mayaToEggConverter.cxx.
References clear(), convert_maya(), Filename::get_basename_wo_extension(), and open_api().
bool MayaToEggConverter::convert_maya | ( | ) |
Fills up the egg_data structure according to the global maya model data.
Returns true if successful, false if there is an error.
Definition at line 369 of file mayaToEggConverter.cxx.
References clear(), SomethingToEggConverter::clear_error(), and open_api().
Referenced by convert_file().
bool MayaToEggConverter::force_joint | ( | const std::string & | name | ) | const |
Returns true if the indicated name is on the list of DAG nodes to treat as a joint, false otherwise.
Definition at line 331 of file mayaToEggConverter.cxx.
Referenced by MayaNodeDesc::from_dag_path().
|
virtual |
Returns a space-separated list of extension, in addition to the one returned by get_extension(), that are recognized by this converter.
Reimplemented from SomethingToEggConverter.
Definition at line 173 of file mayaToEggConverter.cxx.
|
virtual |
Returns the common extension of the file type this converter supports.
Implements SomethingToEggConverter.
Definition at line 164 of file mayaToEggConverter.cxx.
|
virtual |
This may be called after convert_file() has been called and returned true, indicating a successful conversion.
It will return the distance units represented by the converted egg file, if known, or DU_invalid if not known.
Reimplemented from SomethingToEggConverter.
Definition at line 360 of file mayaToEggConverter.cxx.
|
virtual |
Returns the English name of the file type this converter supports.
Implements SomethingToEggConverter.
Definition at line 156 of file mayaToEggConverter.cxx.
bool MayaToEggConverter::ignore_slider | ( | const std::string & | name | ) | const |
Returns true if the indicated name is on the list of sliders to ignore, false otherwise.
Definition at line 292 of file mayaToEggConverter.cxx.
Referenced by MayaNodeTree::ignore_slider().
|
virtual |
Allocates and returns a new copy of the converter.
Implements SomethingToEggConverter.
Definition at line 148 of file mayaToEggConverter.cxx.
bool MayaToEggConverter::open_api | ( | bool | revert_directory = true | ) |
Attempts to open the Maya API if it was not already open, and returns true if successful, or false if there is an error.
Definition at line 541 of file mayaToEggConverter.cxx.
Referenced by convert_file(), and convert_maya().
void MayaToEggConverter::set_from_selection | ( | bool | from_selection | ) |
Sets the flag that indicates whether the currently selected Maya geometry will be converted.
If this is true, and the selection is nonempty, then only the selected geometry will be converted. If this is false, the entire file will be converted.
Definition at line 349 of file mayaToEggConverter.cxx.
|
static |
Returns the TransformType value corresponding to the indicated string, or TT_invalid.
Definition at line 3137 of file mayaToEggConverter.cxx.