tracksperanto 2.10.0 → 2.11.0

data/History.txt

@@ -1,3 +1,7 @@
+=== 2.11.0
+
+* This release adds a Softimage|XSI export module which outputs a Python script with moving nulls on an image plane
+
 === 2.10.0
 
 * Nuke importer now supports PlanarTracker nodes and their corner-pin output

data/README.rdoc

@@ -73,6 +73,7 @@ Export only:
 * AfterEffects .jsx script that creates one null object per tracker (run through the script editor)
 * Ruby (will make calls to Tracksperanto to create trackers/keyframes) - useful if you want to play with trackers as data
 * Maya locators (animated locators on an image plane)
+* Softimage/XSI Python script (animated nulls on an image plane)
 
 == Editing your tracks while converting
 

data/lib/export/xsi.rb

@@ -0,0 +1,69 @@
+# -*- encoding : utf-8 -*-
+# Export each tracker as a moving Softimage|XSI null
+class Tracksperanto::Export::XSI < Tracksperanto::Export::Base
+
+  IMAGE_PLANE = 'Application.CreatePrim("Grid", "MeshSurface", "", "")
+Application.SetValue("grid.Name", "ImagePlane", "")
+Application.SetValue("ImagePlane.grid.ulength", %0.5f, "")
+Application.SetValue("ImagePlane.grid.vlength", %0.5f, "")
+Application.Rotate("", 90, 0, 0, "siRelative", "siLocal", "siObj", "siXYZ", "", "", "", "", "", "", "", 0, "")'
+  
+  MULTIPLIER = 10.0
+  
+  def self.desc_and_extension
+    "xsi_nulls.py"
+  end
+  
+  def self.human_name
+    "Autodesk Softimage nulls Python script"
+  end
+  
+  def start_export(w, h)
+    # Pixel sizes are HUGE. Hence we downscale
+    @factor = (1 / w.to_f) * MULTIPLIER
+    @true_width, @true_height = w * @factor, h * @factor
+    
+    # Generate a Grid primitive
+    @io.puts(IMAGE_PLANE % [@true_width, @true_height])
+    @tracker_names = []
+  end
+  
+  def start_tracker_segment(tracker_name)
+    @t = tracker_name
+    @io.puts("# Data for tracker %s" % @t)
+    @io.puts 'Application.GetPrim("Null", "", "", "")'
+    @io.puts('Application.SetValue("null.Name", "%s", "")' % @t)
+    # Application.ToggleSelection("Track_Point_02", "", "")
+    # Select the tracker that we will animate
+    @io.puts('Application.SelectObj("%s", "", True)' % @t)
+  end
+  
+  def end_tracker_segment
+    # Parent the null to the image plane
+    @tracker_names.push(@t)
+  end
+  
+  def export_point(frame, abs_float_x, abs_float_y, float_residual)
+    coords = get_coordinates(abs_float_x, abs_float_y)
+    @io.puts('Application.Translate("", %0.5f, %0.5f, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")'% coords)
+    @io.puts('Application.SaveKeyOnKeyable("%s", %d, "", "", "", False, "")' % [@t, frame + 1])
+  end
+  
+  def end_export
+    # Create a Model group and parent all the trackers and the image plane to it
+    @io.puts('Application.DeselectAll()')
+    @io.puts('Application.AddToSelection("ImagePlane", "", "")')
+    @tracker_names.each do | tracker_name |
+      @io.puts('Application.AddToSelection("%s", "", "")' % tracker_name)
+    end
+    @io.puts('Application.CreateModel("", "", "", "")')
+    @io.puts('Application.SetValue("Model.Name", "Tracksperanto", "")')
+  end
+  
+  private
+  
+  def get_coordinates(x, y)
+    # Get the coords multiplied by factor, and let the scene origin be the center of the composition
+    [(x * @factor) - (@true_width / 2), y * @factor - (@true_height / 2)]
+  end
+end

data/lib/import/base.rb

@@ -38,9 +38,8 @@ class Tracksperanto::Import::Base
   end
   
   # Return an extension WITH DOT if this format has a typical extension that
-  # you can detect (like ".nk" for Nuke) 
+  # you can detect (like ".nk" for Nuke)
   def self.distinct_file_ext
-    nil
   end
   
   # Should return a human-readable (read: properly capitalized and with spaces) name of the
@@ -49,6 +48,10 @@ class Tracksperanto::Import::Base
     "Abstract import format"
   end
   
+  # Returns a textual description of things to check when the user wants to import from this specific format
+  def self.known_snags
+  end
+  
   # Return true from this method if your importer can deduce the comp size from the passed file
   def self.autodetects_size?
     false

data/lib/import/maya_live.rb

@@ -14,6 +14,10 @@ class Tracksperanto::Import::MayaLive < Tracksperanto::Import::Base
     true
   end
   
+  def self.known_snags
+    'Only square pixel aspect ratio shots are supported.'
+  end
+  
   COMMENT = /^# /
   
   def each

data/lib/import/nuke_script.rb

@@ -5,7 +5,7 @@ require File.expand_path(File.dirname(__FILE__)) + "/nuke_grammar/utils"
 class Tracksperanto::Import::NukeScript < Tracksperanto::Import::Base
   
   def self.human_name
-    "Nuke .nk script file with Tracker or Reconcile3D nodes"
+    "Nuke .nk script file with Tracker, Reconcile3D and PlanarTracker nodes"
   end
   
   def self.distinct_file_ext

data/lib/import/pftrack.rb

@@ -9,6 +9,11 @@ class Tracksperanto::Import::PFTrack < Tracksperanto::Import::Base
     ".2dt"
   end
   
+  def self.known_snags
+    'PFTrack only exports the trackers for the solved part of the shot. To export the whole shot, ' + 
+    "first delete the camera solve."
+  end
+  
   CHARACTERS_OR_QUOTES = /[AZaz"]/
   INTS = /^\d+$/
   

data/lib/import/shake_script.rb

@@ -12,6 +12,10 @@ class Tracksperanto::Import::ShakeScript < Tracksperanto::Import::Base
     ".shk"
   end
   
+  def self.known_snags
+    'Expressions in node parameters may cause parse errors or incomplete imports. Take care to remove expressions or nodes containing them first.'
+  end
+  
   def each
     s = Sentinel.new
     s.progress_proc = method(:report_progress)

data/lib/pipeline/base.rb

@@ -14,10 +14,18 @@ module Tracksperanto::Pipeline
   end
   
   class NoTrackersRecoveredError < RuntimeError
+    def initialize(importer)
+      if importer.class.known_snags
+        @snags = "Also note that this particular format (%s) has the following snags: %s" % [importer.const_name, importer.snags]
+      end
+    end
+    
     def message;
-      "Could not recover any non-empty trackers from this file.\n" + 
-      "Wrong import format maybe?\n" + 
-      "Note that PFTrack will only export trackers from the solved segment of the shot.";
+      [
+        "Could not recover any non-empty trackers from this file.",
+        "Wrong import format maybe?",
+        @snags
+      ].join("\n")
     end
   end
   
@@ -165,7 +173,7 @@ module Tracksperanto::Pipeline
     obuf = Obuf.new(Tracksperanto::YieldNonEmpty.new(importer))
     
     report_progress(percent_complete = 50.0, "Validating #{obuf.size} imported trackers")
-    raise NoTrackersRecoveredError if obuf.size.zero?
+    raise NoTrackersRecoveredError.new(importer) if obuf.size.zero?
   
     report_progress(percent_complete, "Starting export")
   

data/lib/tracksperanto.rb

@@ -3,7 +3,7 @@
 
 module Tracksperanto
   PATH = File.expand_path(File.dirname(__FILE__))
-  VERSION = '2.10.0'
+  VERSION = '2.11.0'
   
   module Import; end
   module Export; end

data/test/export/README_EXPORT_TESTS.txt

@@ -1,6 +1,6 @@
 Export tests are conformance tests. That means that:
 
-1) An export is made using Tracksperanto
+1) An export is made using Tracksperanto 
 2) This export gets checked by importing it into the main app 
 that accepts such files
 3) The export is compared with Tracksperanto output in the test
@@ -9,9 +9,16 @@ This means that unless you own an app that accepts this particular format
 you cannot overwrite the export with your own since you got no way to verify
 that the export works
 
-The current test set consists of the two parabolic curves that cross. The second
-parabolic curve goes left, the first one - right, and they start at opposite
-corners of the reference 1920x1080 export. At the first point the track has the residual of 0,
-at the end of the curve - the biggest residual (PFTrack marks it red exactly at the last keyframe).
+The current test set consists of three trackers. First - two two parabolic curves that cross.
+The first tracker goes left to right, the second right to left and they start at opposite
+corners of the reference 1920x1080 export.
 
-In the middle of the curves a couple of keyframes is skipped to verify that proper gaps are written into the export.
+At the first point the track has the residual of 0, at the end of the curve - the biggest 
+residual (PFTrack marks it red exactly at the last keyframe).
+
+The third tracker has one keyframe and is positioned exactly in the middle.
+
+In the middle of the curves a couple of keyframes is skipped to verify that proper gaps are written into the export.
+
+When changing the export parameters you will need to overwrite all test exports, to do so set the environment variable
+called TRACKSPERANTO_OVERWRITE_ALL_TEST_DATA

data/test/export/samples/ref_AfterEffects.jsx

@@ -57,7 +57,7 @@ pos.setValueAtTime(convertFrameToSeconds(layer1, 19), [96.00000,874.80000]);
 pos.setValueAtTime(convertFrameToSeconds(layer1, 20), [0.00000,1080.00000]);
 
 var layer2 = app.project.activeItem.layers.addNull();
-layer2.name = "SingleFrame";
+layer2.name = "SingleFrame_InTheMiddle";
 
 var pos = layer2.property("Transform").property("Position");
 pos.setValueAtTime(convertFrameToSeconds(layer2, 0), [970.00000,530.00000]);

data/test/export/samples/ref_MayaLocators.ma

@@ -83,8 +83,8 @@ setKeyframe -time 20 -value 0.50000 "Parabolic_2_from_bottom_right.tx";
 setKeyframe -time 20 -value 1.06875 "Parabolic_2_from_bottom_right.ty";
 setKeyframe -time 21 -value 0.00000 "Parabolic_2_from_bottom_right.tx";
 setKeyframe -time 21 -value 0.00000 "Parabolic_2_from_bottom_right.ty";
-spaceLocator -name "SingleFrame" -p 0 0 0;
-setKeyframe -time 1 -value 5.05208 "SingleFrame.tx";
-setKeyframe -time 1 -value 2.86458 "SingleFrame.ty";
-select -r TracksperantoImagePlane Parabolic_1_from_top_left Parabolic_2_from_bottom_right SingleFrame;
+spaceLocator -name "SingleFrame_InTheMiddle" -p 0 0 0;
+setKeyframe -time 1 -value 5.05208 "SingleFrame_InTheMiddle.tx";
+setKeyframe -time 1 -value 2.86458 "SingleFrame_InTheMiddle.ty";
+select -r TracksperantoImagePlane Parabolic_1_from_top_left Parabolic_2_from_bottom_right SingleFrame_InTheMiddle;
 group -name TracksperantoGroup; xform -os -piv 0 0 0;

data/test/export/samples/ref_Mayalive.txt

@@ -39,5 +39,5 @@
 1 18 -1.4222222222 -0.2800000000 0.0857140000
 1 19 -1.6000000000 -0.6200000000 0.0904760000
 1 20 -1.7777777778 -1.0000000000 0.0952380000
-#  Name SingleFrame
+#  Name SingleFrame_InTheMiddle
 2 0 0.0185185185 0.0185185185 0.0000000000

data/test/export/samples/ref_Mayalive_CustomAspect.txt

@@ -39,5 +39,5 @@
 1 18 -1.4240000000 -0.2800000000 0.0857140000
 1 19 -1.6020000000 -0.6200000000 0.0904760000
 1 20 -1.7800000000 -1.0000000000 0.0952380000
-#  Name SingleFrame
+#  Name SingleFrame_InTheMiddle
 2 0 0.0185416667 0.0185185185 0.0000000000

data/test/export/samples/ref_NukeScript.nk

@@ -31,7 +31,7 @@ Tracker3 {
 
 Tracker3 {
      track1 {{curve i x1 970.0000} {curve i x1 550.0000}}
-     name SingleFrame
+     name SingleFrame_InTheMiddle
      xpos 0
      ypos 90
 }

data/test/export/samples/ref_PFMatchit.2dt

@@ -48,7 +48,7 @@
 21 0.000 0.000 0.119
 
 
-"SingleFrame"
+"SingleFrame_InTheMiddle"
 1
 1
 1 970.000 550.000 0.000

data/test/export/samples/ref_PFTrack.2dt

@@ -46,6 +46,6 @@
 20 0.000 0.000 0.119
 
 
-"SingleFrame"
+"SingleFrame_InTheMiddle"
 1
 0 970.000 550.000 0.000

data/test/export/samples/ref_PFTrack5.2dt

@@ -48,7 +48,7 @@
 20 0.000 0.000 0.119
 
 
-"SingleFrame"
+"SingleFrame_InTheMiddle"
 "Primary"
 1
 0 970.000 550.000 0.000

data/test/export/samples/ref_Ruby.rb

@@ -48,7 +48,7 @@ trackers << Tracksperanto::Tracker.new(:name => "Parabolic_2_from_bottom_right")
   t.keyframe!(:frame => 20, :abs_x => 0.00000, :abs_y => 0.00000, :residual => 0.95238)
 end
  
-trackers << Tracksperanto::Tracker.new(:name => "SingleFrame") do |t|
+trackers << Tracksperanto::Tracker.new(:name => "SingleFrame_InTheMiddle") do |t|
   t.keyframe!(:frame => 0, :abs_x => 970.00000, :abs_y => 550.00000, :residual => 0.00000)
 end
  

data/test/export/samples/ref_ShakeText.txt

@@ -42,7 +42,7 @@ TrackName Parabolic_2_from_bottom_right
    20.00   96.000   205.200   0.095
    21.00   0.000   0.000   0.048
 
-TrackName SingleFrame
+TrackName SingleFrame_InTheMiddle
    Frame             X             Y   Correlation
    1.00   970.000   550.000   1.000
 

data/test/export/samples/ref_Syntheyes.txt

@@ -36,4 +36,4 @@ Parabolic2FromBottomRight 17 -0.700000 -0.020000 7
 Parabolic2FromBottomRight 18 -0.800000 0.280000 7
 Parabolic2FromBottomRight 19 -0.900000 0.620000 7
 Parabolic2FromBottomRight 20 -1.000000 1.000000 7
-SingleFrame 0 0.010417 -0.018519 15
+SingleFrameInTheMiddle 0 0.010417 -0.018519 15

data/test/export/samples/ref_XSI.py

@@ -0,0 +1,102 @@
+Application.CreatePrim("Grid", "MeshSurface", "", "")
+Application.SetValue("grid.Name", "ImagePlane", "")
+Application.SetValue("ImagePlane.grid.ulength", 10.00000, "")
+Application.SetValue("ImagePlane.grid.vlength", 5.62500, "")
+Application.Rotate("", 90, 0, 0, "siRelative", "siLocal", "siObj", "siXYZ", "", "", "", "", "", "", "", 0, "")
+# Data for tracker Parabolic_1_from_top_left
+Application.GetPrim("Null", "", "", "")
+Application.SetValue("null.Name", "Parabolic_1_from_top_left", "")
+Application.SelectObj("Parabolic_1_from_top_left", "", True)
+Application.Translate("", -5.00000, 2.81250, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 1, "", "", "", False, "")
+Application.Translate("", -4.50000, 1.74375, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 2, "", "", "", False, "")
+Application.Translate("", -4.00000, 0.78750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 3, "", "", "", False, "")
+Application.Translate("", -3.50000, -0.05625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 4, "", "", "", False, "")
+Application.Translate("", -3.00000, -0.78750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 5, "", "", "", False, "")
+Application.Translate("", -2.50000, -1.40625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 6, "", "", "", False, "")
+Application.Translate("", -2.00000, -1.91250, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 7, "", "", "", False, "")
+Application.Translate("", -1.50000, -2.30625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 8, "", "", "", False, "")
+Application.Translate("", -1.00000, -2.58750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 9, "", "", "", False, "")
+Application.Translate("", -0.50000, -2.75625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 10, "", "", "", False, "")
+Application.Translate("", 1.00000, -2.58750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 13, "", "", "", False, "")
+Application.Translate("", 1.50000, -2.30625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 14, "", "", "", False, "")
+Application.Translate("", 2.00000, -1.91250, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 15, "", "", "", False, "")
+Application.Translate("", 2.50000, -1.40625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 16, "", "", "", False, "")
+Application.Translate("", 3.00000, -0.78750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 17, "", "", "", False, "")
+Application.Translate("", 3.50000, -0.05625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 18, "", "", "", False, "")
+Application.Translate("", 4.00000, 0.78750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 19, "", "", "", False, "")
+Application.Translate("", 4.50000, 1.74375, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 20, "", "", "", False, "")
+Application.Translate("", 5.00000, 2.81250, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_1_from_top_left", 21, "", "", "", False, "")
+# Data for tracker Parabolic_2_from_bottom_right
+Application.GetPrim("Null", "", "", "")
+Application.SetValue("null.Name", "Parabolic_2_from_bottom_right", "")
+Application.SelectObj("Parabolic_2_from_bottom_right", "", True)
+Application.Translate("", 5.00000, -2.81250, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 1, "", "", "", False, "")
+Application.Translate("", 4.50000, -1.74375, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 2, "", "", "", False, "")
+Application.Translate("", 4.00000, -0.78750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 3, "", "", "", False, "")
+Application.Translate("", 3.50000, 0.05625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 4, "", "", "", False, "")
+Application.Translate("", 3.00000, 0.78750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 5, "", "", "", False, "")
+Application.Translate("", 2.50000, 1.40625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 6, "", "", "", False, "")
+Application.Translate("", 2.00000, 1.91250, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 7, "", "", "", False, "")
+Application.Translate("", 1.50000, 2.30625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 8, "", "", "", False, "")
+Application.Translate("", 1.00000, 2.58750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 9, "", "", "", False, "")
+Application.Translate("", 0.50000, 2.75625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 10, "", "", "", False, "")
+Application.Translate("", -1.00000, 2.58750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 13, "", "", "", False, "")
+Application.Translate("", -1.50000, 2.30625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 14, "", "", "", False, "")
+Application.Translate("", -2.00000, 1.91250, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 15, "", "", "", False, "")
+Application.Translate("", -2.50000, 1.40625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 16, "", "", "", False, "")
+Application.Translate("", -3.00000, 0.78750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 17, "", "", "", False, "")
+Application.Translate("", -3.50000, 0.05625, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 18, "", "", "", False, "")
+Application.Translate("", -4.00000, -0.78750, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 19, "", "", "", False, "")
+Application.Translate("", -4.50000, -1.74375, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 20, "", "", "", False, "")
+Application.Translate("", -5.00000, -2.81250, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("Parabolic_2_from_bottom_right", 21, "", "", "", False, "")
+# Data for tracker SingleFrame_InTheMiddle
+Application.GetPrim("Null", "", "", "")
+Application.SetValue("null.Name", "SingleFrame_InTheMiddle", "")
+Application.SelectObj("SingleFrame_InTheMiddle", "", True)
+Application.Translate("", 0.05208, 0.05208, 0, "siAbsolute", "siView", "siObj", "siXYZ", "", "", "", "", "", "", "", "", "", 0, "")
+Application.SaveKeyOnKeyable("SingleFrame_InTheMiddle", 1, "", "", "", False, "")
+Application.DeselectAll()
+Application.AddToSelection("ImagePlane", "", "")
+Application.AddToSelection("Parabolic_1_from_top_left", "", "")
+Application.AddToSelection("Parabolic_2_from_bottom_right", "", "")
+Application.AddToSelection("SingleFrame_InTheMiddle", "", "")
+Application.CreateModel("", "", "", "")
+Application.SetValue("Model.Name", "Tracksperanto", "")

data/test/export/samples/ref_boujou.txt

@@ -41,4 +41,4 @@ Parabolic_2_from_bottom_right  17  288.000  530.200
 Parabolic_2_from_bottom_right  18  192.000  692.200
 Parabolic_2_from_bottom_right  19  96.000  875.800
 Parabolic_2_from_bottom_right  20  0.000  1081.000
-SingleFrame  0  970.000  531.000
+SingleFrame_InTheMiddle  0  970.000  531.000

data/test/export/samples/ref_equalizer.txt

@@ -43,7 +43,7 @@ Parabolic_2_from_bottom_right
 19 192.000000000000000 388.800000000000011
 20 96.000000000000000 205.199999999999989
 21 0.000000000000000 0.000000000000000
-SingleFrame
+SingleFrame_InTheMiddle
 0
 1
 1 970.000000000000000 550.000000000000000

data/test/export/samples/ref_equalizer3.txt

@@ -39,6 +39,6 @@ Parabolic_2_from_bottom_right
 	19	192.000	388.800
 	20	96.000	205.200
 	21	0.000	0.000
-SingleFrame
+SingleFrame_InTheMiddle
 	1	970.000	550.000
 

data/test/export/samples/ref_matchmover.rz2

@@ -46,7 +46,7 @@ pointTrack  "Parabolic_2_from_bottom_right"  rgb( 255 0 0 )
 	20	   96.000     874.800     p+( 0.095240 )	
 	21	   0.000     1080.000     p+( 0.047620 )	
 }
-pointTrack  "SingleFrame"  rgb( 255 0 0 )	
+pointTrack  "SingleFrame_InTheMiddle"  rgb( 255 0 0 )	
 {
 	1	   970.000     530.000    ki( 0.8 )	    s( 66 66 64 64 )  p( 24 24 25 25 )
 }

data/test/export/test_ruby_export.rb

@@ -6,7 +6,6 @@ class RubyExportTest < Test::Unit::TestCase
   P = File.dirname(__FILE__) + "/samples/ref_Ruby.rb"
   
   def test_export_output_written
-    create_reference_output Tracksperanto::Export::Ruby, P
     ensure_same_output Tracksperanto::Export::Ruby, P
   end
   

data/test/export/test_xsi_python_export.rb

@@ -0,0 +1,17 @@
+# -*- encoding : utf-8 -*-
+require File.expand_path(File.dirname(__FILE__)) + '/../helper'
+
+class XSIExportTest < Test::Unit::TestCase
+  include ParabolicTracks
+  
+  P_XSI = File.dirname(__FILE__) + "/samples/ref_XSI.py"
+  
+  def test_export_output_written
+    ensure_same_output Tracksperanto::Export::XSI, P_XSI
+  end
+  
+  def test_exporter_meta
+    assert_equal "xsi_nulls.py", Tracksperanto::Export::XSI.desc_and_extension
+    assert_equal "Autodesk Softimage nulls Python script", Tracksperanto::Export::XSI.human_name
+  end
+end

data/test/helper.rb

@@ -81,7 +81,7 @@ module ParabolicTracks
     t.keyframe!(:frame => 20, :abs_x => 0.00000, :abs_y => 0.00000, :residual => 0.95238)
   end
   
-  SINGLE_FRAME_TRACK = Tracksperanto::Tracker.new(:name => "SingleFrame") do |t|
+  SINGLE_FRAME_TRACK = Tracksperanto::Tracker.new(:name => "SingleFrame_InTheMiddle") do |t|
     t.keyframe!(:frame => 0, :abs_x => 970.00000, :abs_y => 550.00000, :residual => 0.00000)
   end
   
@@ -91,6 +91,7 @@ module ParabolicTracks
       yield(x) if block_given?
       export_parabolics_with(x)
     end
+    flunk "The test output was overwritten, so this test is meaningless"
   end
   
   def assert_same_buffer(ref_buffer, actual_buffer, message = "The line should be identical")
@@ -102,6 +103,15 @@ module ParabolicTracks
   end
   
   def ensure_same_output(exporter_klass, reference_path, message = "The line should be identical")
+    # If we need to update ALL the references at once
+    if ENV['TRACKSPERANTO_OVERWRITE_ALL_TEST_DATA']
+      STDERR.puts "Achtung! Overwriting the file at #{reference_path} with the test output for now"
+      create_reference_output(exporter_klass, reference_path) do | x |
+        yield(x) if block_given?
+      end
+      return
+    end
+    
     io = StringIO.new
     x = exporter_klass.new(io)
     yield(x) if block_given?

data/test/import/test_nuke_import.rb

@@ -6,7 +6,7 @@ class NukeImportTest < Test::Unit::TestCase
   
   def test_introspects_properly
     i = Tracksperanto::Import::NukeScript
-    assert_equal "Nuke .nk script file with Tracker or Reconcile3D nodes", i.human_name
+    assert_equal "Nuke .nk script file with Tracker, Reconcile3D and PlanarTracker nodes", i.human_name
     assert !i.autodetects_size?
   end
   

data/test/test_cli.rb

@@ -40,7 +40,7 @@ class TestCli < Test::Unit::TestCase
       flm.stabilizer flm_3de_v3.txt flm_3de_v4.txt flm_boujou_text.txt flm_flame.stabilizer 
       flm_matchmover.rz2 flm_mayalive.txt flm_nuke.nk flm_pftrack_2011_pfmatchit.txt flm_pftrack_v4.2dt
       flm_pftrack_v5.2dt flm_shake_trackers.txt flm_syntheyes_2dt.txt flm_flame_cornerpin.stabilizer 
-      flm_tracksperanto_ruby.rb flm_mayaLocators.ma flm_createNulls.jsx
+      flm_tracksperanto_ruby.rb flm_mayaLocators.ma flm_createNulls.jsx flm_xsi_nulls.py
     )
     assert_match /Found and converted 1 trackers with 232 keyframes\./, o, "Should have output coversion statistics"
     assert_same_set fs, Dir.entries(TEMP_DIR)
@@ -90,7 +90,7 @@ class TestCli < Test::Unit::TestCase
     assert_match /There were no trackers exported/, results[-1] # STDERR
   end
   
-  # We use this instead of assert_equals for arrays since different filesystems
+  # We use this instead of assert_equals for arrays of file names since different filesystems
   # return files in different order
   def assert_same_set(expected_enum, enum, message = "Should be the same set")
     assert_equal Set.new(expected_enum), Set.new(enum), message

data/test/test_pipeline.rb

@@ -71,6 +71,13 @@ class TestPipeline < Test::Unit::TestCase
     assert_raise(Tracksperanto::Pipeline::EmptySourceFileError) { pipeline.run(empty_file_path) }
   end
   
+  def test_run_crashes_with_no_trackers
+    empty_file_path = "./input_empty.stabilizer"
+    f = File.open(empty_file_path, "w"){|f| f.write('xx') }
+    pipeline = Tracksperanto::Pipeline::Base.new
+    assert_raise(Tracksperanto::Pipeline::NoTrackersRecoveredError) { pipeline.run(empty_file_path) }
+  end
+  
   def test_middleware_initialization_from_tuples
     create_stabilizer_file
     

data/tracksperanto.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "tracksperanto"
-  s.version = "2.10.0"
+  s.version = "2.11.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Julik Tarkhanov"]
-  s.date = "2012-05-30"
+  s.date = "2012-07-06"
   s.description = "Converts 2D track exports between different apps like Flame, MatchMover, PFTrack..."
   s.email = "me@julik.nl"
   s.executables = ["tracksperanto"]
@@ -43,6 +43,7 @@ Gem::Specification.new do |s|
     "lib/export/ruby.rb",
     "lib/export/shake_text.rb",
     "lib/export/syntheyes.rb",
+    "lib/export/xsi.rb",
     "lib/import/base.rb",
     "lib/import/boujou.rb",
     "lib/import/equalizer3.rb",
@@ -109,6 +110,7 @@ Gem::Specification.new do |s|
     "test/export/samples/ref_Ruby.rb",
     "test/export/samples/ref_ShakeText.txt",
     "test/export/samples/ref_Syntheyes.txt",
+    "test/export/samples/ref_XSI.py",
     "test/export/samples/ref_boujou.txt",
     "test/export/samples/ref_equalizer.txt",
     "test/export/samples/ref_equalizer3.txt",
@@ -132,6 +134,7 @@ Gem::Specification.new do |s|
     "test/export/test_ruby_export.rb",
     "test/export/test_shake_export.rb",
     "test/export/test_syntheyes_export.rb",
+    "test/export/test_xsi_python_export.rb",
     "test/helper.rb",
     "test/import/README_SAMPLES.txt",
     "test/import/test_3de_import.rb",
@@ -186,7 +189,7 @@ Gem::Specification.new do |s|
   s.homepage = "http://guerilla-di.org/tracksperanto"
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.15"
+  s.rubygems_version = "1.8.24"
   s.summary = "A universal 2D tracks converter"
 
   if s.respond_to? :specification_version then

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tracksperanto
 version: !ruby/object:Gem::Version
-  version: 2.10.0
+  version: 2.11.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-30 00:00:00.000000000 Z
+date: 2012-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: obuf
-  requirement: &81500 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,15 @@ dependencies:
         version: 1.1.0
   type: :runtime
   prerelease: false
-  version_requirements: *81500
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
 - !ruby/object:Gem::Dependency
   name: progressive_io
-  requirement: &80900 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +37,15 @@ dependencies:
         version: '1.0'
   type: :runtime
   prerelease: false
-  version_requirements: *80900
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: flame_channel_parser
-  requirement: &80430 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,21 +53,31 @@ dependencies:
         version: '4.0'
   type: :runtime
   prerelease: false
-  version_requirements: *80430
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: progressbar
-  requirement: &79900 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - =
+    - - '='
       - !ruby/object:Gem::Version
         version: 0.10.0
   type: :runtime
   prerelease: false
-  version_requirements: *79900
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.0
 - !ruby/object:Gem::Dependency
   name: update_hints
-  requirement: &79370 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,10 +85,15 @@ dependencies:
         version: '1.0'
   type: :runtime
   prerelease: false
-  version_requirements: *79370
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: approximately
-  requirement: &79050 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +101,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *79050
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &78640 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -87,10 +117,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *78640
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &78050 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -98,10 +133,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *78050
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: flexmock
-  requirement: &524110 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -109,10 +149,15 @@ dependencies:
         version: '0.8'
   type: :development
   prerelease: false
-  version_requirements: *524110
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: cli_test
-  requirement: &522630 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -120,7 +165,12 @@ dependencies:
         version: '1.0'
   type: :development
   prerelease: false
-  version_requirements: *522630
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: Converts 2D track exports between different apps like Flame, MatchMover,
   PFTrack...
 email: me@julik.nl
@@ -156,6 +206,7 @@ files:
 - lib/export/ruby.rb
 - lib/export/shake_text.rb
 - lib/export/syntheyes.rb
+- lib/export/xsi.rb
 - lib/import/base.rb
 - lib/import/boujou.rb
 - lib/import/equalizer3.rb
@@ -222,6 +273,7 @@ files:
 - test/export/samples/ref_Ruby.rb
 - test/export/samples/ref_ShakeText.txt
 - test/export/samples/ref_Syntheyes.txt
+- test/export/samples/ref_XSI.py
 - test/export/samples/ref_boujou.txt
 - test/export/samples/ref_equalizer.txt
 - test/export/samples/ref_equalizer3.txt
@@ -245,6 +297,7 @@ files:
 - test/export/test_ruby_export.rb
 - test/export/test_shake_export.rb
 - test/export/test_syntheyes_export.rb
+- test/export/test_xsi_python_export.rb
 - test/helper.rb
 - test/import/README_SAMPLES.txt
 - test/import/test_3de_import.rb
@@ -310,7 +363,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -819741475
+      hash: -2148576341251209313
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -319,7 +372,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.15
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: A universal 2D tracks converter