tracksperanto 2.9.3 → 2.9.4

data/Gemfile

@@ -4,7 +4,7 @@ source :rubygems
 gem "obuf", "~> 1.0.4"
 gem "progressive_io", "~> 1.0"
 gem "flame_channel_parser", "~> 4.0"
-gem "progressbar", "~> 0.9"
+gem "progressbar", "0.10.0"
 gem "update_hints", "~> 1.0"
 
 group :development do

data/History.txt

@@ -1,4 +1,9 @@
-=== 2.9.2
+=== 2.9.4
+
+* Add MatchMover RZML import support
+* Export Boujou trackers starting at frame 0, not at frame 1
+
+=== 2.9.3
 
 * Add export for AE null layers as a .jsx script
 

data/README.rdoc

@@ -1,11 +1,5 @@
-= Tracksperanto
-
-* http://guerilla-di.org/tracksperanto
-
 {<img src="https://secure.travis-ci.org/guerilla-di/tracksperanto.png" />}[http://travis-ci.org/guerilla-di/tracksperanto]
 
-== Description
-
 Tracksperanto is a universal 2D-track translator between many apps.
 
 == Why Tracksperanto?
@@ -63,7 +57,7 @@ converted files already exist <b>they will be overwritten without warning</b>.
 Import and export support:
 * Nuke v5 script (Tracker3 nodes, also known as Tracker in the UI - this is the node that you track with)
 * Shake tracker node export (textfile with many tracks per file)
-* PFTrack 2dt files (version 4 and 5)
+* PFTrack 2dt (version 4 and 5) anf PFMatchit/PFTrack 2011 point track exports
 * Syntheyes 2D tracking data exports
 * 3DE point exports (as output by the default script) - versions 3 and 4
 * MatchMover Pro .rz2
@@ -72,10 +66,12 @@ Import and export support:
 * Boujou feature track export
 
 Import only:
-* Shake script (Tracker, Matchmove and Stabilize nodes embedded in ANY shake script)
+* Shake scripts (Tracker, Matchmove and Stabilize nodes embedded in ANY shake script)
+* MatchMover RZML files
 
 Export only:
-* Ruby (will make calls to Tracksperanto to create trackers/keyframes)
+* 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)
 
 == Modularity

data/lib/export/boujou.rb

@@ -29,6 +29,7 @@ class Tracksperanto::Export::Boujou < Tracksperanto::Export::Base
   
   def export_point(frame, abs_float_x, abs_float_y, float_residual)
     height_inv = @height - abs_float_y
-    @io.puts(POINT_T % [@tracker_name, frame + 1, abs_float_x, height_inv])
+    # Frames in Boujou are likely to start from 0
+    @io.puts(POINT_T % [@tracker_name, frame, abs_float_x, height_inv])
   end
 end

data/lib/export/cosa.rb

@@ -1,8 +1,9 @@
 # -*- encoding : utf-8 -*-
-# Export each tracker as an AfterEffects script creating nulls
+# Exports trackers as an AfterEffects script creating nulls
 class Tracksperanto::Export::AE < Tracksperanto::Export::Base
 
-  PREAMBLE = 'function convertFrameToSeconds(layerWithFootage, frameValue)
+  PREAMBLE = '// Run this script from the Script Editor
+function convertFrameToSeconds(layerWithFootage, frameValue)
   {
   		var comp = layerWithFootage.containingComp;
   		var rate = 1.0 / comp.frameDuration;

data/lib/import/match_mover_rzml.rb

@@ -0,0 +1,81 @@
+# -*- encoding : utf-8 -*-
+require "rexml/document"
+
+class Tracksperanto::Import::MatchMoverRZML < Tracksperanto::Import::Base
+  
+  def self.autodetects_size?
+    true
+  end
+  
+  def self.human_name
+    "MatchMover RZML .rzml file"
+  end
+  
+  def self.distinct_file_ext
+    ".rzml"
+  end
+  
+  class Listener
+    
+    def initialize(from_parser, tracker_callback)
+      @cb = tracker_callback
+      @path = []
+      @parser = from_parser
+      @trackers = []
+    end
+    
+    def depth
+      @path.length
+    end
+    
+    def tag_start(element_name, attrs)
+      @path << element_name.downcase
+      
+      if element_name.downcase == 'shot'
+        @parser.width = attrs["w"]
+        @parser.height = attrs["h"]
+      end
+      
+      return unless @path.include?("ipln")
+      
+      #  <IPLN img="/home/torsten/some_local_nuke_scripts/render_tmp/md_145_1070_right.####.jpg" b="1" e="71">
+      #		<IFRM>
+      #			<M i="1" k="i" x="626.68" y="488.56" tt="0.8000000119" cf="0">
+      if element_name.downcase == 'm'
+        @trackers.push(Tracksperanto::Tracker.new(:name => attrs["i"]))
+      end
+      
+      if element_name.downcase == "ifrm" && attrs["t"]
+        @frame = attrs["t"].to_i
+      end
+      
+      if element_name.downcase == "m"
+        target_marker = @trackers.find{|e| e.name == attrs["i"] }
+        target_marker.keyframe!(:frame => @frame, :abs_x => attrs["x"], :abs_y => (@parser.height - attrs["y"].to_f), :residual => attrs["tt"])
+      end
+    end
+    
+    def tag_end(element_name)
+      @path.pop
+      if element_name.downcase == "rzml"
+        @trackers.reject!{|e| e.empty? }
+        
+        @trackers.each do | recovered_tracker |
+          @cb.call(recovered_tracker)
+        end
+      end
+    end
+    
+    def in?(path_elems)
+      File.join(@path).include?(path_elems)
+    end
+    
+    def xmldecl(*a); end
+    def text(t); end
+  end
+  
+  def each
+    cb = lambda{|e| yield(e) }
+    REXML::Document.parse_stream(@io, Listener.new(self, cb))
+  end
+end

data/lib/tracksperanto.rb

@@ -8,7 +8,7 @@ require "progressive_io"
 
 module Tracksperanto
   PATH = File.expand_path(File.dirname(__FILE__))
-  VERSION = '2.9.3'
+  VERSION = '2.9.4'
   
   module Import; end
   module Export; end

data/test/export/samples/ref_AfterEffects.jsx

@@ -1,3 +1,4 @@
+// Run this script from the Script Editor
 function convertFrameToSeconds(layerWithFootage, frameValue)
   {
   		var comp = layerWithFootage.containingComp;

data/test/export/samples/ref_boujou.txt

@@ -3,42 +3,42 @@
 # Creation date : Thu Apr 15 17:21:26 2010
 # 
 # track_id      view      x      y
-Parabolic_1_from_top_left  1  0.000  0.000
-Parabolic_1_from_top_left  2  96.000  205.200
-Parabolic_1_from_top_left  3  192.000  388.800
-Parabolic_1_from_top_left  4  288.000  550.800
-Parabolic_1_from_top_left  5  384.000  691.200
-Parabolic_1_from_top_left  6  480.000  810.000
-Parabolic_1_from_top_left  7  576.000  907.200
-Parabolic_1_from_top_left  8  672.000  982.800
-Parabolic_1_from_top_left  9  768.000  1036.800
-Parabolic_1_from_top_left  10  864.000  1069.200
-Parabolic_1_from_top_left  13  1152.000  1036.800
-Parabolic_1_from_top_left  14  1248.000  982.800
-Parabolic_1_from_top_left  15  1344.000  907.200
-Parabolic_1_from_top_left  16  1440.000  810.000
-Parabolic_1_from_top_left  17  1536.000  691.200
-Parabolic_1_from_top_left  18  1632.000  550.800
-Parabolic_1_from_top_left  19  1728.000  388.800
-Parabolic_1_from_top_left  20  1824.000  205.200
-Parabolic_1_from_top_left  21  1920.000  0.000
-Parabolic_2_from_bottom_right  1  1920.000  1080.000
-Parabolic_2_from_bottom_right  2  1824.000  874.800
-Parabolic_2_from_bottom_right  3  1728.000  691.200
-Parabolic_2_from_bottom_right  4  1632.000  529.200
-Parabolic_2_from_bottom_right  5  1536.000  388.800
-Parabolic_2_from_bottom_right  6  1440.000  270.000
-Parabolic_2_from_bottom_right  7  1344.000  172.800
-Parabolic_2_from_bottom_right  8  1248.000  97.200
-Parabolic_2_from_bottom_right  9  1152.000  43.200
-Parabolic_2_from_bottom_right  10  1056.000  10.800
-Parabolic_2_from_bottom_right  13  768.000  43.200
-Parabolic_2_from_bottom_right  14  672.000  97.200
-Parabolic_2_from_bottom_right  15  576.000  172.800
-Parabolic_2_from_bottom_right  16  480.000  270.000
-Parabolic_2_from_bottom_right  17  384.000  388.800
-Parabolic_2_from_bottom_right  18  288.000  529.200
-Parabolic_2_from_bottom_right  19  192.000  691.200
-Parabolic_2_from_bottom_right  20  96.000  874.800
-Parabolic_2_from_bottom_right  21  0.000  1080.000
-SingleFrame  1  970.000  530.000
+Parabolic_1_from_top_left  0  0.000  0.000
+Parabolic_1_from_top_left  1  96.000  205.200
+Parabolic_1_from_top_left  2  192.000  388.800
+Parabolic_1_from_top_left  3  288.000  550.800
+Parabolic_1_from_top_left  4  384.000  691.200
+Parabolic_1_from_top_left  5  480.000  810.000
+Parabolic_1_from_top_left  6  576.000  907.200
+Parabolic_1_from_top_left  7  672.000  982.800
+Parabolic_1_from_top_left  8  768.000  1036.800
+Parabolic_1_from_top_left  9  864.000  1069.200
+Parabolic_1_from_top_left  12  1152.000  1036.800
+Parabolic_1_from_top_left  13  1248.000  982.800
+Parabolic_1_from_top_left  14  1344.000  907.200
+Parabolic_1_from_top_left  15  1440.000  810.000
+Parabolic_1_from_top_left  16  1536.000  691.200
+Parabolic_1_from_top_left  17  1632.000  550.800
+Parabolic_1_from_top_left  18  1728.000  388.800
+Parabolic_1_from_top_left  19  1824.000  205.200
+Parabolic_1_from_top_left  20  1920.000  0.000
+Parabolic_2_from_bottom_right  0  1920.000  1080.000
+Parabolic_2_from_bottom_right  1  1824.000  874.800
+Parabolic_2_from_bottom_right  2  1728.000  691.200
+Parabolic_2_from_bottom_right  3  1632.000  529.200
+Parabolic_2_from_bottom_right  4  1536.000  388.800
+Parabolic_2_from_bottom_right  5  1440.000  270.000
+Parabolic_2_from_bottom_right  6  1344.000  172.800
+Parabolic_2_from_bottom_right  7  1248.000  97.200
+Parabolic_2_from_bottom_right  8  1152.000  43.200
+Parabolic_2_from_bottom_right  9  1056.000  10.800
+Parabolic_2_from_bottom_right  12  768.000  43.200
+Parabolic_2_from_bottom_right  13  672.000  97.200
+Parabolic_2_from_bottom_right  14  576.000  172.800
+Parabolic_2_from_bottom_right  15  480.000  270.000
+Parabolic_2_from_bottom_right  16  384.000  388.800
+Parabolic_2_from_bottom_right  17  288.000  529.200
+Parabolic_2_from_bottom_right  18  192.000  691.200
+Parabolic_2_from_bottom_right  19  96.000  874.800
+Parabolic_2_from_bottom_right  20  0.000  1080.000
+SingleFrame  0  970.000  530.000

data/test/import/test_match_mover_rzml_import.rb

@@ -0,0 +1,34 @@
+# -*- encoding : utf-8 -*-
+require File.expand_path(File.dirname(__FILE__)) + '/../helper'
+
+class MatchMoverRZMLImportTest < Test::Unit::TestCase
+  DELTA = 0.1
+  
+  P = File.dirname(__FILE__) + '/samples/match_mover_rzml/md_145_1070_right_t1.rzml'
+
+  def test_introspects_properly
+    i = Tracksperanto::Import::MatchMoverRZML
+    assert_equal "MatchMover RZML .rzml file", i.human_name
+    assert i.autodetects_size?
+  end
+  
+  def test_parsing_from_matchmover
+    fixture = File.open(P)
+    
+    parser = Tracksperanto::Import::MatchMoverRZML.new(:io => fixture)
+    trackers = parser.to_a
+    
+    assert_equal 2048, parser.width
+    assert_equal 1152, parser.height
+    
+    assert_equal 2, trackers.length
+    t = trackers[0]
+    
+    assert_equal 0, trackers[0][0].frame
+    assert_equal 1, trackers[0][1].frame
+    
+    assert_in_delta 626.7, trackers[0][0].abs_x, DELTA
+    assert_in_delta 663.4, trackers[0][0].abs_y, DELTA
+  end
+  
+end

data/tracksperanto.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "tracksperanto"
-  s.version = "2.9.3"
+  s.version = "2.9.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Julik Tarkhanov"]
-  s.date = "2012-01-28"
+  s.date = "2012-02-08"
   s.description = "Converts 2D track exports between different apps like Flame, MatchMover, PFTrack..."
   s.email = "me@julik.nl"
   s.executables = ["tracksperanto"]
@@ -49,6 +49,7 @@ Gem::Specification.new do |s|
     "lib/import/equalizer4.rb",
     "lib/import/flame_stabilizer.rb",
     "lib/import/match_mover.rb",
+    "lib/import/match_mover_rzml.rb",
     "lib/import/maya_live.rb",
     "lib/import/nuke_grammar/utils.rb",
     "lib/import/nuke_script.rb",
@@ -133,6 +134,7 @@ Gem::Specification.new do |s|
     "test/import/test_boujou_import.rb",
     "test/import/test_flame_import.rb",
     "test/import/test_match_mover_import.rb",
+    "test/import/test_match_mover_rzml_import.rb",
     "test/import/test_maya_live_import.rb",
     "test/import/test_nuke_import.rb",
     "test/import/test_pftrack_import.rb",
@@ -181,7 +183,7 @@ Gem::Specification.new do |s|
       s.add_runtime_dependency(%q<obuf>, ["~> 1.0.4"])
       s.add_runtime_dependency(%q<progressive_io>, ["~> 1.0"])
       s.add_runtime_dependency(%q<flame_channel_parser>, ["~> 4.0"])
-      s.add_runtime_dependency(%q<progressbar>, ["~> 0.9"])
+      s.add_runtime_dependency(%q<progressbar>, ["= 0.10.0"])
       s.add_runtime_dependency(%q<update_hints>, ["~> 1.0"])
       s.add_development_dependency(%q<jeweler>, [">= 0"])
       s.add_development_dependency(%q<rake>, [">= 0"])
@@ -191,7 +193,7 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<obuf>, ["~> 1.0.4"])
       s.add_dependency(%q<progressive_io>, ["~> 1.0"])
       s.add_dependency(%q<flame_channel_parser>, ["~> 4.0"])
-      s.add_dependency(%q<progressbar>, ["~> 0.9"])
+      s.add_dependency(%q<progressbar>, ["= 0.10.0"])
       s.add_dependency(%q<update_hints>, ["~> 1.0"])
       s.add_dependency(%q<jeweler>, [">= 0"])
       s.add_dependency(%q<rake>, [">= 0"])
@@ -202,7 +204,7 @@ Gem::Specification.new do |s|
     s.add_dependency(%q<obuf>, ["~> 1.0.4"])
     s.add_dependency(%q<progressive_io>, ["~> 1.0"])
     s.add_dependency(%q<flame_channel_parser>, ["~> 4.0"])
-    s.add_dependency(%q<progressbar>, ["~> 0.9"])
+    s.add_dependency(%q<progressbar>, ["= 0.10.0"])
     s.add_dependency(%q<update_hints>, ["~> 1.0"])
     s.add_dependency(%q<jeweler>, [">= 0"])
     s.add_dependency(%q<rake>, [">= 0"])

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tracksperanto
 version: !ruby/object:Gem::Version
-  version: 2.9.3
+  version: 2.9.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-28 00:00:00.000000000 Z
+date: 2012-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: obuf
-  requirement: &4002190 !ruby/object:Gem::Requirement
+  requirement: &3822710 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 1.0.4
   type: :runtime
   prerelease: false
-  version_requirements: *4002190
+  version_requirements: *3822710
 - !ruby/object:Gem::Dependency
   name: progressive_io
-  requirement: &4001450 !ruby/object:Gem::Requirement
+  requirement: &3822230 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '1.0'
   type: :runtime
   prerelease: false
-  version_requirements: *4001450
+  version_requirements: *3822230
 - !ruby/object:Gem::Dependency
   name: flame_channel_parser
-  requirement: &4000830 !ruby/object:Gem::Requirement
+  requirement: &3821780 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,21 +43,21 @@ dependencies:
         version: '4.0'
   type: :runtime
   prerelease: false
-  version_requirements: *4000830
+  version_requirements: *3821780
 - !ruby/object:Gem::Dependency
   name: progressbar
-  requirement: &4000140 !ruby/object:Gem::Requirement
+  requirement: &3821310 !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - =
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: 0.10.0
   type: :runtime
   prerelease: false
-  version_requirements: *4000140
+  version_requirements: *3821310
 - !ruby/object:Gem::Dependency
   name: update_hints
-  requirement: &3999670 !ruby/object:Gem::Requirement
+  requirement: &3820990 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,10 +65,10 @@ dependencies:
         version: '1.0'
   type: :runtime
   prerelease: false
-  version_requirements: *3999670
+  version_requirements: *3820990
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &3998710 !ruby/object:Gem::Requirement
+  requirement: &3820670 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *3998710
+  version_requirements: *3820670
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &3998020 !ruby/object:Gem::Requirement
+  requirement: &3820350 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -87,10 +87,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *3998020
+  version_requirements: *3820350
 - !ruby/object:Gem::Dependency
   name: flexmock
-  requirement: &3996680 !ruby/object:Gem::Requirement
+  requirement: &3820050 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -98,10 +98,10 @@ dependencies:
         version: '0.8'
   type: :development
   prerelease: false
-  version_requirements: *3996680
+  version_requirements: *3820050
 - !ruby/object:Gem::Dependency
   name: cli_test
-  requirement: &3995630 !ruby/object:Gem::Requirement
+  requirement: &3819760 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -109,7 +109,7 @@ dependencies:
         version: '1.0'
   type: :development
   prerelease: false
-  version_requirements: *3995630
+  version_requirements: *3819760
 description: Converts 2D track exports between different apps like Flame, MatchMover,
   PFTrack...
 email: me@julik.nl
@@ -151,6 +151,7 @@ files:
 - lib/import/equalizer4.rb
 - lib/import/flame_stabilizer.rb
 - lib/import/match_mover.rb
+- lib/import/match_mover_rzml.rb
 - lib/import/maya_live.rb
 - lib/import/nuke_grammar/utils.rb
 - lib/import/nuke_script.rb
@@ -235,6 +236,7 @@ files:
 - test/import/test_boujou_import.rb
 - test/import/test_flame_import.rb
 - test/import/test_match_mover_import.rb
+- test/import/test_match_mover_rzml_import.rb
 - test/import/test_maya_live_import.rb
 - test/import/test_nuke_import.rb
 - test/import/test_pftrack_import.rb