tools/collectAssetCustomizationInfo.pl

   1 # ======================================================================
   2 # collectAssetCustomizationInfo.pl
   3 # Copyright 2003, Sony Online Entertainment, Inc.
   4 # All rights reserved.
   5 # ======================================================================
   6
   7 use strict;
   8
   9 use AppearanceTemplate;
  10 use BlueprintTextureRendererTemplate;
  11 use ComponentAppearanceTemplate;
  12 use CustomizableShaderTemplate;
  13 use CustomizationVariableCollector;
  14 use DetailAppearanceTemplate;
  15 use LightsaberAppearanceTemplate;
  16 use LodMeshGeneratorTemplate;
  17 use MeshAppearanceTemplate;
  18 use PortalAppearanceTemplate;
  19 use SkeletalAppearanceTemplate;
  20 use SkeletalMeshGeneratorTemplate;
  21 use SwitchShaderTemplate;
  22 use TreeFile;
  23 use VehicleCustomizationVariableGenerator;
  24
  25 # ======================================================================
  26
  27 my $branch = "current";
  28 my $debug = 0;
  29 my $treeFileLookupDataFile;
  30
  31 # ======================================================================
  32
  33 sub printUsage
  34 {
  35         print "Usage:\n";
  36         print "\tperl collectAssetCustomizationInfo.pl [-d] [-h] [-b <branch>] -t <treefile lookup filename>\n";
  37         print "\n";
  38         print "-d: if specified, turns on debugging info (Default: off)\n";
  39         print "-h: print this help\n";
  40         print "-t: loads the TreeFile lookup data from the specified filename\n";
  41 }
  42
  43 # ----------------------------------------------------------------------
  44
  45 sub processCommandLineArgs
  46 {
  47         my $printHelp = 0;
  48         my $requestedHelp = 0;
  49
  50         # Grab options from commandline.
  51         while ((scalar @_) && !$printHelp)
  52         {
  53                 if ($_[0] =~ m/^-h/)
  54                 {
  55                         $printHelp         = 1;
  56                         $requestedHelp = 1;
  57                 }
  58                 elsif ($_[0] =~ m/^-b/)
  59                 {
  60                         shift;
  61                         $branch = $_[0];
  62                         if (!defined($branch))
  63                         {
  64                                 print "User must specify a branch name after the -t option, printing help.\n";
  65                                 $printHelp = 1;
  66                         }
  67                         else
  68                         {
  69                                 print "\$branch=[$branch]\n" if $debug;
  70                         }
  71                 }
  72                 elsif ($_[0] =~ m/^-d/)
  73                 {
  74                         $debug = 1;
  75                 }
  76                 elsif ($_[0] =~ m/^-t/)
  77                 {
  78                         shift;
  79                         $treeFileLookupDataFile = $_[0];
  80                         if (!defined($treeFileLookupDataFile))
  81                         {
  82                                 print "User must specify a treefile lookup data filename after the -t option, printing help.\n";
  83                                 $printHelp = 1;
  84                         }
  85                         else
  86                         {
  87                                 print "\$treeFileLookupDataFile=[$treeFileLookupDataFile]\n" if $debug;
  88                         }
  89                 }
  90                 else
  91                 {
  92                         print "Unsupported option [$_[0]], printing help.\n";
  93                         $printHelp = 1;
  94                 }
  95
  96                 # Shift past current argument.
  97                 shift;
  98         }
  99
 100         # Check if we're missing anything required.
 101         if (!$requestedHelp)
 102         {
 103                 if (!defined($treeFileLookupDataFile))
 104                 {
 105                         print "No TreeFile lookup data file specified, printing usage info.\n";
 106                         $printHelp = 1;
 107                 }
 108         }
 109
 110         if ($printHelp)
 111         {
 112                 printUsage();
 113                 exit ($requestedHelp ? 0 : -1);
 114         }
 115 }
 116
 117 # ----------------------------------------------------------------------
 118
 119 sub initialize
 120 {
 121         # Initialize data handlers.
 122         &AppearanceTemplate::install();
 123         &BlueprintTextureRendererTemplate::install();
 124         &ComponentAppearanceTemplate::install();
 125         &CustomizableShaderTemplate::install();
 126         &DetailAppearanceTemplate::install();
 127         &LightsaberAppearanceTemplate::install();
 128         &LodMeshGeneratorTemplate::install();
 129         &MeshAppearanceTemplate::install();
 130         &PortalAppearanceTemplate::install();
 131         &SkeletalAppearanceTemplate::install();
 132         &SkeletalMeshGeneratorTemplate::install();
 133         &SwitchShaderTemplate::install();
 134         &VehicleCustomizationVariableGenerator::install();
 135
 136         # Open the TreeFile lookup datafile.
 137         my $dataFileHandle;
 138         die "Failed to open [$treeFileLookupDataFile]: $!" unless open($dataFileHandle, "< " . $treeFileLookupDataFile);
 139
 140         # Initialize the treefile.
 141         TreeFile::loadFileLookupTable($dataFileHandle);
 142
 143         # Close the TreeFile lookup datafile.
 144         die "Failed to close [$treeFileLookupDataFile]: $!" unless close($dataFileHandle);
 145 }
 146
 147 # ======================================================================
 148 # Main Program
 149 # ======================================================================
 150
 151 # Handle command line.
 152 processCommandLineArgs(@ARGV);
 153
 154 # Initialize subsystems (e.g. TreeFile)
 155 initialize();
 156
 157 # Setup the list of patterns to match against
 158 # TreeFile-relative filenames.  Any files in the TreeFile system
 159 # that match one of these patterns will be processed by the
 160 # CustomizationVariableCollector.
 161
 162 my @processFilePatterns =
 163         (
 164          '^texturerenderer/.+\.trt$', '^shader/.+\.sht$',
 165          '^appearance/.+\.(apt|cmp|lmg|lod|lsb|mgn|msh|sat|pob)$'
 166 # ---
 167 # TEST ENTRIES: don't include these for real processing, used to test formats one-at-a-time.
 168 # ---
 169 #        '^appearance/.+\.sat$'
 170 #        '^appearance/.+\.mgn$'
 171 #         '^shader/.+\.sht$'
 172 #         '^appearance/.+\.lsb$'
 173 #         '^appearance/.+\.lod$'
 174 #         '^appearance/.+\.apt$'
 175 #        '^appearance/.+\.msh$'
 176 #        '^appearance/.+\.cmp$'
 177 # ---
 178          );
 179
 180 CustomizationVariableCollector::collectData(@processFilePatterns);
 181
 182 # Handle vehicle customization steps that cannot be handled by analyzing IFF file contents.
 183 VehicleCustomizationVariableGenerator::collectData($branch);