$:.unshift(File.dirname(__FILE__)) unless
	$:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
require 'open-uri'
require 'RipXploreLog'
require 'SubclassTracking'

class HostSystem
  def HostSystem.possible_file_systems
    results=[]
    FileSystem.all_file_systems.each do |candidate| 
      results<<candidate if self==candidate.host_system
    end
    results
  end
  
  def HostSystem.all_host_systems
    HostSystem.subclasses
  end

#each subclass should override to_ascii with a function that converts a character in the native format to an ASCII equivalent
def HostSystem.to_ascii(byte)
  byte.chr
end

def HostSystem.s_to_ascii(s)
  r=""
  s.each_byte do |b|
    r+=to_ascii(b)
  end
  r
end

#given a buffer (e.g a sector or a file), produce a formatted hex dump which includes chars converted to ASCII
def HostSystem.hex_dump(buffer)
   	s=""
		(0..(buffer.length/16)).each {|line_number|
			 lhs=""
			 rhs=""
			 start_byte=line_number*16
			 line=buffer[start_byte,16]
			if line.length>0 then
				 line.each_byte {|byte|
					  lhs+= sprintf("%02X ", byte)
					  rhs+= to_ascii(byte).sub(/[\x00-\x1f]/,'.')
			 	}
				lhs+=" "*(16-line.length)*3
				s+=sprintf("%02X\t%s %s\n",start_byte,lhs,rhs)
			end
		}
		s
end

#does counting of tracks start at track 0 (e.g. Apple 2) or track 1 (e.g. C64)?
def HostSystem.start_track
  0
end
end

HostSystem.extend SubclassTracking
  
# == Author
# Jonno Downes (jonno@jamtronix.com)
#
# == Copyright
# Copyright (c) 2008 Jonno Downes (jonno@jamtronix.com)
#
#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.