bvh 1.0.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,27 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+viewer
+test/data/in/lady.*
+test/data/out/*
+.idea
+*.o
+*.so

data/EXAMPLES.rdoc

@@ -0,0 +1 @@
+Coming soon.

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009  Colin MacKenzie IV
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,97 @@
+= BVH
+
+This library allows you to parse, manipulate and save files in the BVH motion capture format.
+
+To get started, remember to add the obligatory "require" statements:
+
+  require 'rubygems'
+  require 'bvh'
+
+Once done, you can load a BVH file pretty easily:
+
+  bvh = Bvh.import("path/to/animation.bvh")
+
+And you can export them just so:
+
+  bvh.export("path/to/copy_of_animation.bvh")
+
+For a more exhaustive set of examples, see EXAMPLES.
+
+== IMPORTANT
+
+Although BVH is marked as 1.0, there is some functionality I haven't yet tested. In particular, the transform matrices
+may or may not be accurate. The numbers look right from my command line, but I haven't had a chance to plug BVH into my
+graphics engine, so they may in fact be wrong. Please let me know what you learn if you've tested this!
+
+== The Format
+
+What follows is a run-down of what I've learned about the BVH file format while researching and coding this library.
+I reserve the right to be mistaken (but I don't think I am).
+
+The BVH format was developed by a now-defunct company called Biovision, and stands for Biovision Hierarchical data
+format. Used to store motion capture data, a BVH file consists of two sections: a HIERARCHY section, which describes
+the skeletal structure that the motion capture data pertains to; and a MOTION section, which stores the motion capture
+data itself.
+
+=== Hierarchy
+
+The HIERARCHY section contains a set of nested nodes which describe a character. Most of these nodes are named. Though
+the name of a given node seems to be rarely used within the context of the BVH file itself, I suspect it will be quite
+useful when biping 3D models to various body parts -- but that's well beyond the scope of this library.
+
+Each node name is expected to be unique, regardless of usage, and this library enforces that. Every node in the
+HIERARCHY section is referred to by this library as a Bone, and a collection of Bones (beginning with the ROOT node) is
+referred to as a Skeleton.
+
+The first (outermost) node is tagged "ROOT" and is, obviously, considered the root of the skeleton. (Technically, there
+may be more than one ROOT in a BVH file, but this is atypical. This library does support multiple roots, however.)
+Following the tag is the node name, and on the next line is an opening curly brace ("{").
+
+Information about the current Bone follows the curly braces, and includes OFFSET and CHANNELS data. OFFSET information
+specifies the offset from the parent Bone, or an offset from the origin for a root. Offset information of joints are
+also used to infer length and orientation for their parent bone. If multiple joints are found, the length and
+orientation are determined from the first of them.
+
+By convention, the data for a given node is preceded by a tab character for readability. This is not technically
+necessary, but some stricter BVH parsers require this explicitly and cannot support other forms of white space. This
+library supports arbitrary amounts and types of white space.
+
+Child nodes, which are tagged "JOINT", follow the OFFSET and CHANNELS data, and recursively define the tree until an
+"End Site" node is detected. The "End Site" node contains only OFFSET information, which is used exclusively to infer
+length and orientation of the last node in the list.
+
+The CHANNELS information for each node specifies the order in which the channel information will appear; this applies
+to OFFSET data (even though the Xposition, Yposition and Zposition channels are generally only declared at the root
+level, and generally follow in the expected order) as well as the frame data in the MOTION segment.
+
+=== Motion
+
+The Motion section of the file contains the motion capture data itself. There are generally 2 lines preceding the data:
+"Frames" and "Frame Time". The "Frames" line specifies the number of frames that will follow, and the "Frame Time" field
+indicates how many seconds will pass per frame. Most BVH files specify the Frame Time as 0.0333333, or 30 frames per
+second, but this can vary.
+
+This BVH library dynamically counts the number of frames, and only uses the "Frames" field to verify that all available
+data has been loaded. If the "Frames" field is missing, this library will not raise an error -- it will simply be unable
+to verify the number of frames after a file has been loaded. (An error will be raised if the "Frames" field is supplied
+and the numbers do not match, however.)
+
+Finally, the remainder of the file consists of numbers delimited by a tab character and a space (though, again, this
+library isn't particularly picky about the white space). Each line constitutes a single frame, and the series of numbers
+on each line apply to the CHANNELS information in the order it was seen in the file. Because the same order is
+maintained, the first several numbers usually correspond to translation (usually X, Y and Z), while the remainder of
+the numbers correspond to rotation.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit -- do not mess with rakefile, version, or history.
+  (If you want to have your own version, that's fine, but bump version in a commit by itself so that I can ignore it
+  when I pull.)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Colin MacKenzie IV. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,58 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "bvh"
+    gem.summary = %Q{A library for loading, modifying and saving BVH motion capture files.}
+    gem.description = %Q{A library for loading, modifying and saving BVH motion capture files.}
+    gem.email = "sinisterchipmunk@gmail.com"
+    gem.homepage = "http://github.com/sinisterchipmunk/bvh"
+    gem.authors = ["Colin MacKenzie IV (sinisterchipmunk)"]
+    gem.add_development_dependency "shoulda", ">= 0"
+    gem.extensions = FileList["ext/**/extconf.rb"].to_a
+    gem.files.concat FileList["ext/**/*.c"].to_a
+    gem.files.concat FileList["ext/**/*.h"].to_a
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "BVH #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('EXAMPLES*')
+  rdoc.rdoc_files.include('LICENSE')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/bvh.gemspec

@@ -0,0 +1,69 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{bvh}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Colin MacKenzie IV (sinisterchipmunk)"]
+  s.date = %q{2009-12-08}
+  s.description = %q{A library for loading, modifying and saving BVH motion capture files.}
+  s.email = %q{sinisterchipmunk@gmail.com}
+  s.extensions = ["ext/bvh/extconf.rb"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "EXAMPLES.rdoc",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "bvh.gemspec",
+     "ext/bvh/Makefile",
+     "ext/bvh/bvh.c",
+     "ext/bvh/bvh.h",
+     "ext/bvh/bvh_parser.c",
+     "ext/bvh/extconf.rb",
+     "lib/bvh.rb",
+     "lib/bvh/exporter.rb",
+     "lib/bvh/matrix.rb",
+     "lib/bvh/motion.rb",
+     "lib/bvh/motion/channel_data.rb",
+     "lib/bvh/motion/frame.rb",
+     "lib/bvh/parser.rb",
+     "lib/bvh/skeleton.rb",
+     "test/bvh_test.rb",
+     "test/data/in/karate.bvh",
+     "test/helper.rb"
+  ]
+  s.homepage = %q{http://github.com/sinisterchipmunk/bvh}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{A library for loading, modifying and saving BVH motion capture files.}
+  s.test_files = [
+    "test/bvh_test.rb",
+     "test/helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+    else
+      s.add_dependency(%q<shoulda>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<shoulda>, [">= 0"])
+  end
+end
+

data/ext/bvh/Makefile

@@ -0,0 +1,149 @@
+
+SHELL = /bin/sh
+
+#### Start of system configuration section. ####
+
+srcdir = .
+topdir = /c/ruby186-mingw/lib/ruby/1.8/i386-mingw32
+hdrdir = $(topdir)
+VPATH = $(srcdir):$(topdir):$(hdrdir)
+
+DESTDIR = c:
+prefix = $(DESTDIR)/ruby186-mingw
+exec_prefix = $(prefix)
+sitedir = $(exec_prefix)/lib/ruby/site_ruby
+rubylibdir = $(libdir)/ruby/$(ruby_version)
+docdir = $(datarootdir)/doc/$(PACKAGE)
+dvidir = $(docdir)
+datarootdir = $(prefix)/share
+archdir = $(rubylibdir)/$(arch)
+sbindir = $(exec_prefix)/sbin
+psdir = $(docdir)
+localedir = $(datarootdir)/locale
+htmldir = $(docdir)
+datadir = $(datarootdir)
+includedir = $(prefix)/include
+infodir = $(datarootdir)/info
+sysconfdir = $(prefix)/etc
+mandir = $(datarootdir)/man
+libdir = $(exec_prefix)/lib
+sharedstatedir = $(prefix)/com
+oldincludedir = $(DESTDIR)/usr/include
+pdfdir = $(docdir)
+sitearchdir = $(sitelibdir)/$(sitearch)
+localstatedir = $(prefix)/var
+bindir = $(exec_prefix)/bin
+sitelibdir = $(sitedir)/$(ruby_version)
+libexecdir = $(exec_prefix)/libexec
+
+CC = gcc
+LIBRUBY = lib$(LIBRUBY_SO).a
+LIBRUBY_A = lib$(RUBY_SO_NAME)-static.a
+LIBRUBYARG_SHARED = -l$(RUBY_SO_NAME)
+LIBRUBYARG_STATIC = -l$(RUBY_SO_NAME)-static
+
+RUBY_EXTCONF_H = 
+CFLAGS   =  -g -O2  
+INCFLAGS = -I. -I$(topdir) -I$(hdrdir) -I$(srcdir)
+DEFS     = 
+CPPFLAGS =   $(DEFS)
+CXXFLAGS = $(CFLAGS) 
+DLDFLAGS = -L.   -Wl,--enable-auto-image-base,--enable-auto-import,--export-all 
+LDSHARED = gcc -shared -s
+AR = ar
+EXEEXT = .exe
+
+RUBY_INSTALL_NAME = ruby
+RUBY_SO_NAME = msvcrt-ruby18
+arch = i386-mingw32
+sitearch = i386-msvcrt
+ruby_version = 1.8
+ruby = c:/ruby186-mingw/bin/ruby
+RUBY = $(ruby)
+RM = rm -f
+MAKEDIRS = mkdir -p
+INSTALL = /bin/install -c
+INSTALL_PROG = $(INSTALL) -m 0755
+INSTALL_DATA = $(INSTALL) -m 644
+COPY = cp
+
+#### End of system configuration section. ####
+
+preload = 
+
+libpath = . $(libdir)
+LIBPATH =  -L. -L$(libdir)
+DEFFILE = 
+
+CLEANFILES = mkmf.log
+DISTCLEANFILES = 
+
+extout = 
+extout_prefix = 
+target_prefix = 
+LOCAL_LIBS = 
+LIBS = $(LIBRUBYARG_SHARED)  -lshell32 -lws2_32  
+SRCS = bvh.c bvh_parser.c
+OBJS = bvh.o bvh_parser.o
+TARGET = bvh
+DLLIB = $(TARGET).so
+EXTSTATIC = 
+STATIC_LIB = 
+
+RUBYCOMMONDIR = $(sitedir)$(target_prefix)
+RUBYLIBDIR    = $(sitelibdir)$(target_prefix)
+RUBYARCHDIR   = $(sitearchdir)$(target_prefix)
+
+TARGET_SO     = $(DLLIB)
+CLEANLIBS     = $(TARGET).so $(TARGET).il? $(TARGET).tds $(TARGET).map
+CLEANOBJS     = *.o *.a *.s[ol] *.pdb *.exp *.bak
+
+all:		$(DLLIB)
+static:		$(STATIC_LIB)
+
+clean:
+		@-$(RM) $(CLEANLIBS) $(CLEANOBJS) $(CLEANFILES)
+
+distclean:	clean
+		@-$(RM) Makefile $(RUBY_EXTCONF_H) conftest.* mkmf.log
+		@-$(RM) core ruby$(EXEEXT) *~ $(DISTCLEANFILES)
+
+realclean:	distclean
+install: install-so install-rb
+
+install-so: $(RUBYARCHDIR)
+install-so: $(RUBYARCHDIR)/$(DLLIB)
+$(RUBYARCHDIR)/$(DLLIB): $(DLLIB)
+	$(INSTALL_PROG) $(DLLIB) $(RUBYARCHDIR)
+install-rb: pre-install-rb install-rb-default
+install-rb-default: pre-install-rb-default
+pre-install-rb: Makefile
+pre-install-rb-default: Makefile
+$(RUBYARCHDIR):
+	$(MAKEDIRS) $@
+
+site-install: site-install-so site-install-rb
+site-install-so: install-so
+site-install-rb: install-rb
+
+.SUFFIXES: .c .m .cc .cxx .cpp .o
+
+.cc.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.cxx.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.cpp.o:
+	$(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) -c $<
+
+.c.o:
+	$(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) -c $<
+
+$(DLLIB): $(OBJS) Makefile
+	@-$(RM) $@
+	$(LDSHARED) -o $@ $(OBJS) $(LIBPATH) $(DLDFLAGS) $(LOCAL_LIBS) $(LIBS)
+
+
+
+$(OBJS): ruby.h defines.h

data/ext/bvh/bvh.c

@@ -0,0 +1,10 @@
+#include "bvh.h"
+
+VALUE rb_cBvh = Qnil;
+
+void Init_bvh()
+{
+    rb_cBvh = rb_define_class("Bvh", rb_cObject);
+
+    bvh_init_parser();
+}