ippa-movie_maker 0.3.0

data/History.txt

@@ -0,0 +1,27 @@
+=== 0.3.0 2009-08-17
+- new name, new gemified filestructure, gemspec
+
+=== 0.x 2008-08-13
+- Too much to list. New shiny API, better c0dezetc.
+- this CHANGELOG deprecated until further.
+- See http://github.com/ippa/rubygame_movie_maker/commits/master for changes.
+
+=== 0.x  2008-08-06:
+- Too much to list, but new actions.. zoom, rotate, play_sound etc
+- Better chaining with "after" method
+- Alot more samples
+
+=== 0.x 2008-08-05:
+- various renaming, :target_surface => :screen, :surface => sprite
+- All action-work is now done with sprites instead of surfaces, a sprite must meet some common rubygameish criterias: have attributes x,y and image.
+- make it more rubygame'ish 
+
+=== 0.x 2008-07-31:
+- New better namespace/class names
+- able to pass a Color to :background params
+- new examples
+- better organizing of files
+- screen.update Outside of eventloop makes stuff faster :)
+
+=== 0.x 2008-07-30:
+- first version with basic example

data/README.rdoc

@@ -0,0 +1,154 @@
+= MovieMaker README
+http://github.com/ippa/movie_maker/tree/master
+
+== DESCRIPTION
+Automate image movements/effects and sounds over a period of time, useful for games.
+
+== What is it?
+A rubylibrary to automate sprite movement/effects and sound over a timeline.
+Either Rubygame (SDL) or Gosu (OpenGL) does the heavy lifting for us when it comes to drawing on the screen.
+MovieMaker transparently supports both gamelibraries.
+
+Use it for intros, ingame animations and simple "demos". Namingconventions tries to follow Rubygame.
+It's also easy extendable with own actions. Documentation about that comming as soon as someone wants it =).
+
+== Features:
+
+Basic:
+* @movie = MovieMaker.new
+* @movie.resource(@sprite) - choose a resource (for now, a sprite) that following commands will apply on
+
+Timeline methods
+
+* @movie.between(start_at, stop_at) - following actions are performered between start_at/stop_at (seconds in floats)
+* @movie.at(start_at) - following actions are performered once at start_at seconds into the movie
+* @movie.delay(delay) - pause timeline for delay seconds
+* @movie.during(time) - perform actions during time in seconds, starting right after the last action
+* @movie.then - perform next action after the last one finishes
+
+Action modifying a resource + are influenced by the timeline methods
+
+* @movie.move([x,y]) - move sprite to x,y coordinates
+* @movie.move_facing_direction([x,y]) - move sprite to x,y coordinates, but also turn the sprite in that direction using angle
+* @movie.zoom(factor) - zoom height/width by factor (factor of 2 doubles the size, 0.5 makes it half the size)					
+* @movie.rotate(angle) - rotates clockwise for angle degrees. Give negative angles to rotate counterclockwise.
+* @movie.fade_out - Fades to total transperency, only GOSU so far.
+
+Actions modifying a resource
+
+* @movie.acceleration([x,y]) - accelerates resource with the specified [x,y] offset. For example [-1,0] would make object accelerate left.
+* @movie.velocity([x,y]) - sets static velocity specified [x,y] offset. For example [-1,0] would make object move left in a constant rate.
+
+Actions doing a single thing
+
+* @movie.play_sound(sound) - Play sound-object
+
+
+All commands are chainable for a clear and verbose way of building scenes. For example:
+  @movie.resource(@cat).move([0,100]).between(0,5).move([500,100]).rotate(360).then.during(4).move([500,600]).then.play_sound(@sound)
+
+see samples/ dir for more examples.
+
+== Use it for:
+=== Intros
+Build up your game with a intro 
+
+=== ingame animations
+You can make the movie play by calling update on it in your gameloop -- just like you do with your rubygame sprites/spritegroups. Note - this remains to be tested in an example.
+
+=== Simple demos for your local demoparty
+
+
+== Simple example
+create your sprite (should include rubygames Sprites::Sprite):
+  @sprite = Sprite.new("sprite.png")
+	
+Sets up the movie, give it your initiated @screen-object and @background. MovieMaker supports autocreation of simple colored background as you can see bellow
+  movie = MovieMaker::Movie.new(:screen => @screen, :background => Color[:black]) 
+
+1 sec (1000ms) into the movie, start moving the sprite from x/y: 0,0 (top left of the screen)
+during 9 seconds (until 10000ms into the movie), set the speed so it will reach position x/y 800,600.
+  @movie.resource(@sprite).move([0,0]).between(1,10).move([800,600])
+
+Play the movie you're created, blocks until it's done
+  @movie.play
+
+
+== Chaining Simple example
+movie_maker supports various chaining of actions, we could for example modify our last example like this:
+Between seconds 1-9, move the sprite across the screen,rotate it 360 degrees at the same time, and when it's done, play a sound woff. Without the ".after."-chaining the sound would have been played after 1 seconds, not 10.
+  @movie.resource(@sprite).move([0,0]).between(1,10).move([800,600]).rotate(360).then.play_sound(Sound["woff.wav"])
+
+
+== Gosu Example
+Since Gosu has a different approach then rubygame a longer example is needed:
+
+	class MovieMakerWindow < Gosu::Window
+		def initialize
+			$screen = super(800, 600, false)
+			
+			# Make Surface & Sound behave like shortcuts to GOSUs Image & Sample
+			require 'gosu_autoload'
+			
+			# Set our autoloading dirs for quick and easy access to images and samples
+			Surface.autoload_dirs = [ File.join("samples", "media"), "media" ]
+			Sound.autoload_dirs = [ File.join("samples", "media"), "media" ]
+	
+			@clock = ::Gosu::Clock.new
+			@clock.target_framerate = 200
+
+			setup_movie
+		end
+		
+		#
+		# It's there the movie gets created
+		#
+		def setup_movie
+			@movie = Movie.new(:framework => :gosu, :screen => $screen)
+			0.upto(200) do |start|
+				# x,y = 0,0 is default
+				@star = Sprite.new("star_5.png")
+				# all following actions are applied to this resource
+				@movie.resource(@star)
+				@movie.color( Color.new(100 + rand(155),rand(255),rand(255),rand(255)) )
+				@movie.zoom(0.2)
+				@movie.between(start/10.0, start/10.0 + 2)
+				@movie.velocity([10,0])
+				@movie.acceleration([0, 0.05 + rand(0.1)])
+				@movie.rotate(angle = 90 * rand(10))
+				@movie.zoom(1.0 + rand(2.0))
+				@movie.fade_out.then.color(0x00FFFFFF)
+			end
+		end
+
+		#
+		# Gosu calls update() automaticly
+		#
+		def update
+			@tick = @clock.tick()
+			
+			if @movie.playing?(@clock.lifetime)
+				@movie.gosu_update(@clock.lifetime)
+				self.caption = "[framerate: #{@clock.framerate.to_i}] [Spriteupdates: #{@movie.updated_count}] [#{@clock.lifetime} : #{@movie.stop_at}]"
+			else
+				close
+			end
+		end
+		
+		#
+		# Gosu calls draw() automaticly
+		#
+		def draw
+			@movie.gosu_draw(@clock.lifetime)
+		end
+	end
+	
+	MovieMakerWindow.new.show		# Initialize and show main gosu window (starts calling update/draw)
+
+== Requirements
+Rubygame 2.3+ or Gosu 0.7.9+
+
+
+== License
+
+Same as rubygame.

data/Rakefile

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'hoe'
+require File.dirname(__FILE__) + '/lib/movie_maker.rb'
+
+include MovieMaker
+
+Hoe.plugin :git
+Hoe.spec "movie_maker" do
+  developer "ippa", "ippa@rubylicio.us"
+  self.readme_file   = 'README.rdoc'
+  self.rubyforge_name = "movie_maker"
+  self.version = MovieMaker::VERSION
+end
+
+desc "Build a working gemspec"
+task :gemspec do
+  system "rake git:manifest"
+  system "rake debug_gem | grep -v \"(in \" | grep -v \"erik\" > movie_maker.gemspec"
+end

data/examples/axe.rb

@@ -0,0 +1,24 @@
+#!/usr/bin/ruby
+require File.join("..", "lib", "movie_maker")
+
+include Rubygame
+include MovieMaker
+include MovieMaker::Rubygame
+
+Rubygame.init()
+Surface.autoload_dirs = [ "media" ]
+Sound.autoload_dirs = [ "media" ]
+	
+@screen = Screen.set_mode([800, 600], 0, [HWSURFACE, DOUBLEBUF])
+@background = Surface.autoload("outdoor_scene.bmp")
+@axe = Sprite.new("axe.png")
+@chop = Sound["chop.wav"]
+
+movie = Movie.new(:screen => @screen, :background => @background)
+#
+# Monsterline that demonstrates moviemakes chaining
+#
+# OLD: movie.between(0, 2).move(@axe, :from => [0,200], :to => [700,350]).rotate(@axe, :angle => 370*2, :direction => :clockwise).after.play_sound(@chop)
+
+movie.resource(@axe).move([0,200]).between(0, 2).move([700,350]).rotate(370*2).then.play_sound(@chop)
+movie.play(:stop_at => 4)

data/examples/balls.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/ruby
+require File.join("..", "lib", "movie_maker")
+
+include Rubygame
+include MovieMaker
+include MovieMaker::Rubygame
+
+Rubygame.init()
+Surface.autoload_dirs = [ "media" ]
+	
+@screen = Screen.set_mode([800, 600], 0)
+@background = Surface.autoload("cloth_background.png")
+
+movie = Movie.new(:screen => @screen, :background => @background)
+movie.resource(Sprite.new("ball.png")).move([100,100]).between(0,6).move([600,100])
+movie.resource(Sprite.new("ball.png")).move([100,200]).between(1,6).move([600,200])
+movie.resource(Sprite.new("ball.png")).move([100,300]).between(2,6).move([600,300])
+movie.resource(Sprite.new("ball.png")).move([100,400]).between(3,6).move([600,400])
+movie.resource(Sprite.new("ball.png")).move([100,500]).between(4,6).move([600,500])
+movie.play

data/examples/echoes.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby
+require File.join("..", "lib", "movie_maker")
+
+include Rubygame
+include MovieMaker
+include MovieMaker::Rubygame
+
+TTF.setup()
+Rubygame.init()
+Surface.autoload_dirs = [ "media" ]
+Sound.autoload_dirs = [ "media" ]
+
+@raindrop = Sprite.new("raindrop.png")
+@drip = Sound["drip.wav"]
+@screen = Screen.set_mode([800, 600], 0, [HWSURFACE])
+@movie = Movie.new(:screen => @screen, :background => Color[:black], :target_framerate => 200)
+
+@echo_delay = 0.4
+#
+# create 10 raindrops after eachother with echo soundeffects
+#
+(0..5).each do |nr|
+	x = 100+rand(600)
+	fall_time = 2
+	start_at = nr * fall_time
+	stop_at = nr * fall_time + fall_time
+	@movie.resource(@raindrop).move([x,-1000]).between(start_at,stop_at).move([x, 650])
+	@movie.at(stop_at).play_sound(@drip.dup).delay(@echo_delay).play_sound(@drip.dup, :volume=>0.6).delay(@echo_delay).play_sound(@drip.dup,:volume => 0.3).delay(@echo_delay).play_sound(@drip.dup,:volume => 0.2)
+end
+@movie.play(:stop_at => 13)

data/examples/gosu_base.rb

@@ -0,0 +1,40 @@
+#!/usr/bin/env ruby
+require File.join("..", "lib", "movie_maker")
+
+#
+# Usefull stuff for the Gosu examples
+#
+module Gosu
+	class MovieMakerWindow < Gosu::Window
+		def initialize
+			$screen = super(800, 600, false)
+			
+			# Make Surface & Sound behave like shortcuts to GOSUs Image & Sample
+			require 'gosu_autoload'
+			
+			# Set our autoloading dirs for quick and easy access to images and samples
+			Surface.autoload_dirs = [ File.join("samples", "media"), "media" ]
+			Sound.autoload_dirs = [ File.join("samples", "media"), "media" ]
+	
+			@clock = ::Gosu::Clock.new
+			@clock.target_framerate = 200
+
+			self
+		end
+	
+		def update
+			@tick = @clock.tick()
+			
+			#if @movie.playing?(@clock.lifetime)
+				@movie.gosu_update(@clock.lifetime)
+				self.caption = "[framerate: #{@clock.framerate.to_i}] [Spriteupdates: #{@movie.updated_count}] [#{@clock.lifetime} : #{@movie.stop_at}]"
+			#else
+			#	close
+			#end
+		end
+		
+		def draw
+			@movie.gosu_draw(@clock.lifetime)
+		end
+	end
+end

data/examples/gosu_rain.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+require File.join("..", "lib", "movie_maker")
+require 'gosu_base.rb'
+
+class GameWindow < Gosu::MovieMakerWindow
+	def initialize
+		super
+		setup_movie
+	end
+	
+	def setup_movie
+		@movie = Movie.new(:framework => :gosu, :screen => $screen)
+		
+		start_at = stop_at = 0
+		(1..500).each do |nr|
+			x = rand(800)
+			start_at = nr / 50.0
+			stop_at = nr / 50.0 + 1.0
+	
+			@raindrop = Sprite.new("raindrop_small.png")
+			@movie.resource(@raindrop).move([x,0]).between(start_at, stop_at).move_facing_direction([x+100+(nr/5)+rand(50),650])
+		end
+
+		@movie.at(0).play_sound(Sample["rain2.wav"])
+	end
+end
+
+if $0 == __FILE__
+	include MovieMaker
+	include MovieMaker::Gosu	# Among others add sprites image to global $screen
+	GameWindow.new.show
+end
+
+

data/examples/gosu_river_of_stars.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+require File.join("..", "lib", "movie_maker")
+require 'gosu_base.rb'
+
+class GameWindow < Gosu::MovieMakerWindow
+	def initialize
+		super
+		setup_movie
+	end
+	
+	def setup_movie
+		@movie = Movie.new(:framework => :gosu, :screen => $screen)
+		0.upto(200) do |start|
+			@star = Sprite.new("star_5.png")	# x,y = 0,0 is default
+			@movie.resource(@star)						# all following actions are applied to this resource
+			@movie.color( Color.new(100 + rand(155),rand(255),rand(255),rand(255)) )
+			@movie.zoom(0.2)
+			@movie.between(start/10.0, start/10.0 + 2)
+			@movie.velocity([10,0])
+			@movie.acceleration([0, 0.05 + rand(0.1)])
+			@movie.rotate(angle = 90 * rand(10))
+			@movie.zoom(1.0 + rand(2.0))
+			@movie.fade_out.then.color(0x00FFFFFF)
+		end
+	end
+	
+end
+
+if $0 == __FILE__
+	include MovieMaker
+	include MovieMaker::Gosu
+	GameWindow.new.show
+end
+
+

data/examples/gosu_triangles.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+require File.join("..", "lib", "movie_maker")
+require 'gosu_base.rb'
+
+class GameWindow < Gosu::MovieMakerWindow
+	def initialize
+		super
+		setup_movie
+	end
+	
+	def setup_movie
+		@movie = Movie.new(:framework => :gosu, :screen => $screen)
+		0.upto(5) do |start|
+			
+			@red = Sprite.new("red_triangle.png")
+			@green = Sprite.new("green_triangle.png")
+			@blue = Sprite.new("blue_triangle.png")
+			stop = start + 4
+						
+			@movie.resource(@red).move([0,0]).zoom(0.1).between(start, stop).move([800,650]).rotate(1000).zoom(3).fade_out
+			@movie.resource(@green).move([800,0]).zoom(0.1).between(start, stop).move([0,650]).rotate(1000).zoom(3).fade_out
+			@movie.resource(@blue).move([800,600]).zoom(0.1).between(start, stop).move([0,0]).rotate(1000).zoom(3).fade_out
+		end
+	end
+	
+end
+
+if $0 == __FILE__
+	include MovieMaker
+	include MovieMaker::Gosu
+	GameWindow.new.show
+end
+
+

data/examples/gosu_wish_upon_a_star.rb

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+require File.join("..", "lib", "movie_maker")
+require 'gosu_base.rb'
+
+class GameWindow < Gosu::MovieMakerWindow
+	def initialize
+		super
+		setup_movie
+	end
+	
+	def setup_movie
+		@movie = Movie.new(:framework => :gosu, :screen => $screen, :draw_mode => :additive, :loop => true)
+		0.upto(40) do |nr|		
+			@star = Sprite.new("star_6.png", :x => rand(800), :y => -10)
+			color = Color.new(0x66484D18)
+			flash = Color.new(0xFFFFFFFF)
+			
+			@start = nr/4.0
+			zoom = 0.1+rand(0)/5
+			
+			# this resource will follow through all steps bellow
+			@movie.resource(@star)
+			
+			# setup (before a between)
+			@movie.zoom(zoom).color(color)
+			
+			# the "movie" (resource is still choosen)
+			@movie.between(@start, @start+10).velocity([0,1.2+rand(0)/5]).rotate(200-rand(400))
+		
+			# A falling star
+			if rand(10) == 0
+				@movie.at(@start+2+rand(4)).zoom(zoom+0.3).color(flash).during(1).rotate(720).zoom(0.01).fade_out
+			end
+		end
+		
+		@movie.restart_at(@start)
+		
+	end
+	
+end
+
+if $0 == __FILE__
+	include MovieMaker
+	include MovieMaker::Gosu
+	GameWindow.new.show
+end
+
+