rock-qtbindings 4.8.6.5

data/examples/ruboids/LICENSE.txt

@@ -0,0 +1,58 @@
+Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.co.jp>.
+You can redistribute it and/or modify it under either the terms of the GPL
+(see COPYING.txt file), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+	  modifications to Usenet or an equivalent medium, or by allowing
+	  the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) rename any non-standard executables so the names do not conflict
+	  with standard executables, which must also be provided.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or executable
+     form, provided that you do at least ONE of the following:
+
+       a) distribute the executables and library files of the software,
+	  together with instructions (in the manual page or equivalent)
+	  on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+	  the software.
+
+       c) give non-standard executables non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under this terms.
+
+     They are gc.c(partly), utils.c(partly), regex.[ch], st.[ch] and some
+     files under the ./missing directory.  See each file for the copying
+     condition.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.
+

data/examples/ruboids/Manifest

@@ -0,0 +1,26 @@
+Manifest
+README
+TODO
+boids.properties
+generateManifest.rb
+index.html
+release.rb
+ruboids/
+	Boid.rb
+	BoidView.rb
+	Camera.rb
+	CameraDialog.rb
+	Canvas.rb
+	Cloud.rb
+	CloudView.rb
+	Flock.rb
+	Graphics.rb
+	Params.rb
+	Point.rb
+	Thing.rb
+	Triangle.rb
+	View.rb
+	World.rb
+	WorldWindow.rb
+	info.rb
+	ruboids.rb

data/examples/ruboids/README

@@ -0,0 +1,53 @@
+INTRODUCTION
+============
+
+RuBoids is a Boids simulation written in Ruby and using OpenGL and Qt. For
+information on Boids, see http://www.red3d.com/cwr/boids/.
+
+Ruby is an object-oriented scripting language by Yukihiro Matsumoto. The
+official Ruby Web site (http://www.ruby-lang.org/) contains information and
+pointers to resources for this wonderful language.
+
+RuBoids is developed and maintained by Jim Menard (<jimm@io.com>). The
+latest version of RuBoids can be found on the Ruby Application Archive or
+on the official RuBoids Web page
+(http://www.io.com/~jimm/downloads/ruboids/).
+
+RUNNING
+=======
+
+	cd ruboids
+	ruboids.rb
+
+RuBoids looks for an optional properties file. If none is specified on the
+command line, it looks for a file named 'boids.properties' in the current
+directory. For example, to load the example properties file in this
+directory:
+
+	cd ruboids
+	ruboids.rb ../boids.properties
+
+DEPENDENCIES
+============
+
+RuBoids requires the OpenGL and Qt packages, which can be found on the Ruby
+Application Archive.
+
+COPYING
+=======
+
+RuBoids is copyrighted free software by Jim Menard and is released under the
+same license as Ruby. See the Ruby license
+(http://www.ruby-lang.org/en/LICENSE.txt).
+
+RuBoids may be freely copied in its entirety providing this notice, all
+source code, all documentation, and all other files are included.
+
+RuBoids is copyright (c) 2001 by Jim Menard.
+
+WARRANTY
+========
+
+THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

data/examples/ruboids/TODO

@@ -0,0 +1,29 @@
+BUGS
+====
+
+* Boid rotation.
+
+* Frustum.
+
+TO DO
+=====
+
+* Comment the code.
+
+* More documentation.
+
+* Save/restore params (e.g. camera position).
+
+POSSIBLE ADDITIONS
+==================
+
+* Make sphere output more efficient by using strips or fans.
+
+* Boids-eye view: camera follows position of a boid. This is not hard, but
+  I have to fix boid rotation first.
+
+* Velocity and destination influence proportional to distance from other
+  boids. Boids that are farther away have less influence on your velocity
+  and destination.
+
+* Boids that are behind you don't influence you because you can't see them.

data/examples/ruboids/boids.properties

@@ -0,0 +1,33 @@
+# This is an example configuration file for RuBoids. It sets all of the
+# possible properties. The values here are the default values set in
+# Params.rb.
+
+world.sleep_millis = 75
+world.width = 400
+world.height = 400
+world.depth = 400
+window.width = 500
+window.height = 500
+flock.boids = 10
+boid.max_speed = 30
+boid.bounds_limit_pull = 5
+boid.bounds_limit_above_ground_level = 5
+boid.wing_length = 10
+boid.personal_space_dist = 12
+boid.square_of_personal_space_dist = 144
+boid.max_perching_turns = 150
+boid.perch_wing_flap_percent = 30
+cloud.count = 10
+cloud.min_speed = 2
+cloud.max_speed = 50
+cloud.min_bubbles = 3
+cloud.max_bubbles = 10
+cloud.max_bubble_radius = 10
+cloud.min_altitude = 250
+camera.x = 0
+camera.y = 0
+camera.z = 60
+camera.rot_x = 50
+camera.rot_y = 10
+camera.rot_z = 0
+camera.zoom = 1

data/examples/ruboids/generateManifest.rb

@@ -0,0 +1,42 @@
+#! /usr/bin/env ruby
+#
+# Copyright (c) 2001 by Jim Menard <jimm@io.com>
+#
+# Released under the same license as Ruby. See
+# http://www.ruby-lang.org/en/LICENSE.txt.
+#
+# This script builds the Manifest file. It can be run stand-alone, but
+# is normally used from within release.rb.
+#
+
+def recurseDirectory(io, dirName, indentLevel)
+    Dir.entries(dirName).sort.each { | f |
+	next if f =~ /^\.\.?/
+	fileName = "#{dirName}/#{f}"
+	fileName.sub!(/^\.\//, '')
+	if File.directory?(fileName)
+	    io.puts "\t" * indentLevel + fileName + '/'
+	    recurseDirectory(io, fileName, indentLevel + 1)
+	else
+	    io.puts "\t" * indentLevel + f
+	end
+    }
+end
+
+def generateManifest
+    io = nil
+    begin
+	io = File.open('Manifest', 'w')
+	recurseDirectory(io, '.', 0)
+    ensure
+	io.close() if io
+    end
+end
+
+if $0 == __FILE__
+    generateManifest()
+end
+
+
+
+    

data/examples/ruboids/index.html

@@ -0,0 +1,147 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+<head>
+<title>RuBoids</title>
+<link rel="stylesheet" href="../../style.css" type="text/css">
+</head>
+<body background="../../images/gradient_bg.gif" bgcolor="white">
+<!--#exec cgi="../../cgi-bin/log_visitor.cgi" -->
+
+<table width="100%">
+	<tr>
+		<td valign="top">
+		<table width="100" border="0" cellpadding="0" cellspacing="0">
+			<tr>
+				<td valign="top"><font size="-1">
+<script language="JavaScript"><!--
+PREFIX = "../../"; // -->
+</script>
+<!--     #include virtual="/~jimm/menu.js"-->
+<A href="../../index.html">
+<IMG src="../../images/KeyMaster.gif"
+width="32" height="32" alt="Home" border="0"></A><BR>
+<A href="../../index.html">Home</A><BR>
+<A href="../nqxml/index.html">NQXML</A><BR>
+RuBoids<BR>
+<A href="../../computers.html">Computers</A><BR>
+<A href="../../java.html">Java</A><BR>
+<A href="../../beos.html">BeOS</A><BR>
+<A href="../../ftp_sites.html">FTP sites</A><BR>
+<A href="../../music.html">Music</A><BR>
+<A href="../../midi_ref.html">MIDI Reference</A><BR>
+<A href="../../keymaster.html">KeyMaster</A><BR>
+<A href="../../MIDI_Through.html">MIDI Through</A><BR>
+<A href="../../jimm.html">Narcissism</A><BR>
+<A href="../../resume.html">Resume</A><BR>
+<A href="../../urls.html">Links</A><BR>
+<A href="../../map.html">Site Map</A><BR>
+
+
+				</font></td>
+			</tr>
+		</table>
+		</td>
+		<td valign="top">
+		<table border="0" cellpadding="0" cellspacing="0">
+			<tr valign="top">
+				<td>
+
+<div align="right">
+<font size="+3"><b>RuBoids</b></font>
+<img src="../../images/computer.gif" width="32" height="32"
+ alt="[home]" border="0">
+</div><br>
+<hr>
+
+<h1>Introduction</h1>
+
+<p>
+RuBoids is a Boids simulation written in Ruby and using OpenGL and Qt. For
+information on Boids, see <a
+href="http://www.red3d.com/cwr/boids/">http://www.red3d.com/cwr/boids/</a>.
+</p>
+
+<p>
+Ruby is an object-oriented scripting language by Yukihiro Matsumoto. Visit
+the official <a href="http://www.ruby-lang.org/">Ruby Web site</a> for more
+information.
+</p>
+
+<p>
+</p>
+
+<p>
+RuBoids is developed and maintained by Jim Menard, <a
+href="mailto:jimm@io.com">jimm@io.com</a>. The official
+Web page of RuBoids is <a
+href="http://www.io.com/~jimm/downloads/RuBoids/">http://www.io.com/~jimm/downloads/RuBoids/</a>,
+where the latest release may be found.
+</p>
+
+
+<h1>Dependencies</h1>
+
+<p>
+RuBoids requires the OpenGL and Qt packages, which can be found on the <a
+href="html://www.ruby-lang.org/en/raa.html">Ruby Application Archive</a>.
+</p>
+
+
+<h1>Download</h1>
+
+<p>
+Download the latest version, <a href="ruboids-0.0.1.tar.gz">RuBoids version
+0.0.1</a>.
+</p>
+
+<!--
+<p>
+Earlier versions:
+</p>
+
+<ul>
+<li><a href="RuBoids-0.0.1.tar.gz">Version 0.0.1</a></li>
+</ul>
+-->
+
+<h1>Bugs</h1>
+
+<p>
+Boids don't rotate properly. In other words, they point in the wrong
+direction.
+</p>
+
+
+<h1>Copying</h1>
+
+<p>
+RuBoids is copyrighted free software by Jim Menard and is released under
+the same license as Ruby.
+</p>
+
+<h1>Warranty</h1>
+
+<p>
+THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+</p>
+
+<hr>
+Back to my <a href="../../index.html">home page</a>, or the
+<a href="../../map.html">Site Map</a>.<br>
+<font size="-1">
+<i>Page last modified on
+<!--#config timefmt="%B %d, %Y" -->
+<!--#echo var="LAST_MODIFIED" -->
+by <a href="mailto:jimm@io.com">me</a>.</i>
+<br>Contents &copy; 2001 by Jim Menard. All rights reserved.
+</font>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</body>
+</html>

data/examples/ruboids/release.rb

@@ -0,0 +1,152 @@
+#! /usr/bin/env ruby
+#
+# Copyright (c) 2001 by Jim Menard <jimm@io.com>
+#
+# Released under the same license as Ruby. See
+# http://www.ruby-lang.org/en/LICENSE.txt.
+#
+# This script gathers everything needed to release RuBoids into one directory
+# and, if requested, publishes the contents to the RuBoids Web site.
+#
+# usage:
+#
+#	release.rb [--publish, -p]
+#
+# Specifying --publish or -p causes the resulting files to be published
+# to the Web site.
+#
+
+require 'net/ftp'
+require 'ftools'		# For makedirs and install
+require './generateManifest'	# For--you guessed it--generating the Manifest
+
+# Start looking for RUBOIDS classes in this directory.
+# This forces us to use the local copy of RUBOIDS, even if there is
+# a previously installed version out there somewhere.
+$LOAD_PATH[0, 0] = '.'
+
+require './ruboids/info'		# For Version string
+
+FILE_PERMISSION = 0644
+DIR_PERMISSION = 0755
+
+PUBLISH_FLAG = '-p'
+RUBOIDS_DIR = 'ruboids'
+DOCS_DIR = '.'
+#DOCS_HTML_DIR = "#{DOCS_DIR}/README"
+
+RUBOIDS_DIR_WITH_VERSION = "#{RUBOIDS_DIR}-#{Version}"
+RELEASE_DIR = "/tmp/#{RUBOIDS_DIR_WITH_VERSION}_release"
+#RELEASE_HTML_DIR = "#{RELEASE_DIR}/README"
+
+DOWNLOAD_FILE = "#{DOCS_DIR}/index.html"
+#DOCBOOK_FILE = "#{DOCS_DIR}/README.sgml"
+
+WEB_SITE = 'io.com'
+WEB_DIR = 'public-web/downloads/ruboids'
+
+# Copies all files from `fromDir' into the release directory. Sets the
+# permissions of all files to 0644.
+def copyFiles(fromDir, toDir, match=nil)
+    Dir.foreach(fromDir) { | f |
+	next if f =~ /^\.\.?/ || (!match.nil? && !(f =~ match))
+	File.install("#{fromDir}/#{f}", toDir, FILE_PERMISSION)
+    }
+end
+
+# Recursively removes the contents of a directory.
+def rmDirectory(dirName)
+    return unless File.exists?(dirName)
+    Dir.foreach(dirName) { | f |
+	next if f =~ /^\.\.?/
+	path = "#{dirName}/#{f}"
+	rmDirectory(path) if File.directory?(path)
+	File.delete(path) if !File.directory?(path)
+    }
+    
+end
+
+# Recursively sends files and directories.
+def sendToWebSite(ftp, releaseDir, webDir)
+    ftp.chdir(webDir)
+    Dir.foreach(releaseDir) { | f |
+	next if f =~ /^\.\.?/
+	path = "#{releaseDir}/#{f}"
+	if File.directory?(path)
+	    begin
+		ftp.mkdir(f)
+	    rescue Net::FTPPermError
+		# ignore; it's OK if the directory already exists
+	    end
+	    sendToWebSite(ftp, path, f)
+	    ftp.chdir('..')
+	else
+	    ftp.putbinaryfile(path, f)
+	end
+    }
+end
+
+def ensureVersionInFile(fileName, regex)
+    lines = File.open(fileName).grep(regex)
+    found = lines.detect { | line | line =~ /#{Version}/o }
+    if !found
+	$stderr.puts "Warning: it looks like the #{fileName} version number" +
+	    " is incorrect"
+    end
+end
+
+# ================================================================
+# main
+# ================================================================
+
+# Make sure the docs mention the correct version number.
+#ensureVersionInFile(DOWNLOAD_FILE, /Download the latest/)
+#ensureVersionInFile(DOCBOOK_FILE, /releaseinfo/)
+
+# Empty release dir if it already exists.
+rmDirectory(RELEASE_DIR)
+
+# (Re)create release dir. This makes RELEASE_HTML_DIR, whose parent
+# is RELEASE_DIR. Therefore, RELEASE_DIR is created as well.
+#File.makedirs(RELEASE_HTML_DIR)
+File.makedirs(RELEASE_DIR)
+
+# Recreate the full documentation (creating README and docs/README) and copy
+# the HTML files to the release directory. Finally, clean up the docs
+# directory.
+
+#system("cd #{DOCS_DIR} && make")
+#copyFiles(DOCS_DIR, RELEASE_DIR, /\.html$/)
+#copyFiles(DOCS_HTML_DIR, RELEASE_HTML_DIR, /\.html$/)
+copyFiles(DOCS_DIR, RELEASE_DIR, 'index.html')
+
+# Generate the Manifest file.
+generateManifest()
+
+# Create .tar.gz file. We temporarily rename the RUBOIDS folder to
+# "ruboids-X.Y.Z", tar and gzip that directory, then restore its original
+# name.
+Dir.chdir('..')
+File.rename(RUBOIDS_DIR, RUBOIDS_DIR_WITH_VERSION)
+system("tar -czf #{RELEASE_DIR}/#{RUBOIDS_DIR_WITH_VERSION}.tar.gz " +
+       RUBOIDS_DIR_WITH_VERSION)
+File.chmod(FILE_PERMISSION, "#{RELEASE_DIR}/#{RUBOIDS_DIR_WITH_VERSION}.tar.gz")
+File.rename(RUBOIDS_DIR_WITH_VERSION, RUBOIDS_DIR)
+
+# ftp files if requested
+if !ARGV.empty? && ARGV[0] == PUBLISH_FLAG
+    require 'net/ftp'
+
+    # Ask for ftp username and password
+    guess = ENV['LOGNAME'] || ENV['USER']
+    print "username [#{guess}]: "
+    username = $stdin.gets().chomp()
+    username = guess if username.empty?
+    print "password: "
+    password = $stdin.gets().chomp()
+
+    # ftp files to web site
+    ftp = Net::FTP.open(WEB_SITE, username, password)
+    sendToWebSite(ftp, RELEASE_DIR, WEB_DIR)
+    ftp.close()
+end

data/examples/ruboids/ruboids/Boid.rb

@@ -0,0 +1,141 @@
+#
+# Copyright (c) 2001 by Jim Menard <jimm@io.com>
+#
+# Released under the same license as Ruby. See
+# http://www.ruby-lang.org/en/LICENSE.txt.
+#
+
+require './BoidView'
+require './Flock'
+require './Point'
+require './Params'
+
+class Boid < Thing
+
+    attr_accessor :maxSpeed, :maxSpeedSquared, :perchingTurnsLeft,
+	:wingFlapPos, :almostGroundLevel, :flock
+
+    def initialize(pos = nil)
+	super(pos, nil)
+	init
+    end
+
+    def init
+	@maxSpeed = $PARAMS['boid_max_speed']
+	@maxSpeedSquared = @maxSpeed * @maxSpeed
+	@flock = nil		# set by flock when flock adds to self
+	@wingFlapPos = rand(7)
+	@perchingTurnsLeft = 0
+	@almostGroundLevel = 5.0
+
+	@view = BoidView.new(self)
+    end
+
+    def move
+	# Flap wings. Only flap occasionally if not perching.
+	if (@perchingTurnsLeft == 0 ||
+	    rand(100) < $PARAMS['boid_perch_wing_flap_percent'])
+	    @wingFlapPos = (@wingFlapPos + 1) & 7
+	end
+
+	if @perchingTurnsLeft > 0
+	    # Only take off when wing flap position == 2.
+	    if --@perchingTurnsLeft == 0 && @wingFlapPos != 2
+		@perchingTurnsLeft = (8 + 2 - @wingFlapPos) & 7
+		return
+	    end
+	end
+
+	moveTowardsFlockCenter()
+	avoidOthers()
+	matchOthersVelocities()
+	boundPosition()
+	limitSpeed()
+
+	super()			# Add velocity vector to position.
+
+	# Boids at ground level perch for a while.
+	if @position.y < @almostGroundLevel
+	    @position.y = @almostGroundLevel
+	    @vector.x = @vector.y = @vector.z = 0
+	    @perchingTurnsLeft =
+		rand($PARAMS['boid_max_perching_turns'])
+	end
+    end
+
+    def moveTowardsFlockCenter()
+	flockCenter = @flock.centerExcluding(self)
+	flockCenter.subtractPoint(@position)
+	# Move 1% of the way towards the center
+	flockCenter.divideBy(100.0)
+
+	@vector.addPoint(flockCenter)
+    end
+
+    def avoidOthers()
+	c = Point.new()
+	@flock.members.each { | b |
+	    if b != self
+		otherPos = b.position
+		if @position.squareOfDistanceTo(otherPos) <
+			$PARAMS['boid_square_of_personal_space_dist']
+		    c.addPoint(@position)
+		    c.subtractPoint(otherPos)
+		end
+	    end
+	}
+	@vector.addPoint(c)
+    end
+
+    def matchOthersVelocities()
+	vel = Point.new()
+	flock.members.each { | b |
+	    if b != self
+		vel.addPoint(b.vector)
+	    end
+	}
+	vel.divideBy(flock.members.length - 1)
+	vel.subtractPoint(@vector)
+	vel.divideBy(8)
+
+	@vector.addPoint(vel)
+    end
+
+    def boundPosition()
+	v = Point.new
+
+	halfWidth = $PARAMS['world_width'] / 2
+	halfHeight = $PARAMS['world_height'] / 2
+	halfDepth = $PARAMS['world_depth'] / 2
+
+	if position.x < -halfWidth
+	    v.x = $PARAMS['boid_bounds_limit_pull']
+	elsif position.x > halfWidth
+	    v.x = -$PARAMS['boid_bounds_limit_pull']
+	end
+
+	if position.y < -halfHeight + almostGroundLevel +
+		$PARAMS['boid_bounds_limit_above_ground_level']
+	    v.y = $PARAMS['boid_bounds_limit_pull']
+	elsif position.y > halfHeight
+	    v.y = -$PARAMS['boid_bounds_limit_pull']
+	end
+
+	if position.z < -halfDepth
+	    v.z = $PARAMS['boid_bounds_limit_pull']
+	elsif position.z > halfDepth
+	    v.z = -$PARAMS['boid_bounds_limit_pull']
+	end
+
+	@vector.addPoint(v)
+    end
+
+    def limitSpeed()
+	speedSquared = Point::ORIGIN.squareOfDistanceTo(@vector)
+	if speedSquared > @maxSpeedSquared
+	    f = Math.sqrt(speedSquared) * @maxSpeed
+	    @vector.divideBy(f)
+	end
+    end
+end
+