Quellcode

#===============================================================================
# ** Fortschrittsbalken
#-------------------------------------------------------------------------------
#
# Autor: The King
# Version: 0.7
# Stand: 17.10.2010
#
# 1. Vorbereitung:
#
# Im Ordner Graphics/Pictures müssen 2 gleich große Bilder sein:
#
#  "Balken_fill" (Füllung des Balkens)
#  "Balken_background" (Hintergrund des Balkens)
#
# Um die Größe der Grafiken einzustellen sucht die Zeile
#
#   @sprite.bitmap = Bitmap.new(96, 32)
#
# Und ändert die Zahlen in die Größe eurer Grafik ( Bitmap.new(Breite/Höhe) )
#
# 2.Benutzung:
#
# Ruft per Call-Script auf:
#
# $scene.balken_erstellen(x, y, maximum, typ, text)
#
# erstellt einen Balken an der Stelle x/y mit einem bestimmten Text. 
# typ gibt an ob der Balken gefüllt (0) oder geleert (1) wird.
# maximum gibt den Wert an den der Balken bei maximaler Füllung hat
# (egal welcher Typ).
#
# Beispiel:
#   $scene.balken_erstellen(200, 100, 96, "Zaubern", 0)
#
# Das erstellt einen Balken an der Position 200/100 mit der Inschrift "Zaubern"
# der mit 96 Punkten beginnt und stetig runtergezählt wird.
#
#
# $scene.balken_fertig? 
#
# fragt entweder per call-script oder conditional branch
# ab ob der Balken abgearbeitet wurde (unabhängig vom Typ) und gibt in dem Fall
# "true" zurück, ansonsten "false"
#
# Beispiel:
#   if $scene.balken_fertig == true
#
#
# $scene.balken_löschen 
# 
# löscht den Balken komplett.
# 
# 3. Einstellungen
# Ihr könnt einige Einstellungen für den Text am Ende des Scripts unter
# "def text_settings" treffen
#-------------------------------------------------------------------------------
#
# Freie Verwendung, jedoch bei Benutzung Credits-Vergabe ;)
#
#===============================================================================
 
#----------------------------------------------------------------------------
# class Scene_Map
# zusätzliche Befehle für den Fortschrittsbalken
#----------------------------------------------------------------------------
class Scene_Map
 
  #--------------------------------------------------------------------------
  # balken_erstellen
  # Erzeugt den Fortschrittsbalken
  #--------------------------------------------------------------------------
 
  def balken_erstellen(x, y, maximum, text = "", typ = 0)
    @balken = Balken.new(x, y, maximum, text, typ)
  end
 
  #--------------------------------------------------------------------------
  # balken_löschen
  # Löscht den Fortschrittsbalken
  #--------------------------------------------------------------------------
 
  def balken_löschen
    @balken.dispose if @balken != nil
    @balken = nil
  end
 
  #--------------------------------------------------------------------------
  # balken_fertig?
  # Fragt ab, ob der Balken geleert (Tpy 0) oder gefüllt (Typ 1) wurde
  #--------------------------------------------------------------------------
 
  def balken_fertig?
    return false if @balken == nil
    return @balken.fertig?
  end
 
  #--------------------------------------------------------------------------
  # alias update
  # Fügt ein Update für den Balken hinzu
  #--------------------------------------------------------------------------
  alias balken_update update
  def update
    @balken.update if @balken != nil
    balken_update
  end  
end
 
#----------------------------------------------------------------------------
# class Balken
# Die Klasse für den Fortschrittsbalken
#----------------------------------------------------------------------------
class Balken
 
  #--------------------------------------------------------------------------
  # initialize
  # Erstellt den Balken
  #--------------------------------------------------------------------------
 
  def initialize(x, y, maximum, text, typ)
    @maximum = maximum
    @typ = typ
    if @typ == 0
      @stand = @maximum
    else
      @stand = 0
    end
    @text = text
    @sprite = Sprite.new
    @sprite.bitmap = Bitmap.new(96, 32)
    @sprite.x = x
    @sprite.y = y
    @sprite.z = 1000
    text_settings
  end
 
  #----------------------------------------------------------------------------
  # update
  # Aktualisiert den Balken
  #----------------------------------------------------------------------------
 
  def update
    if @typ == 0 && @stand > 0
      @stand -= 1
    elsif @stand < @maximum
      @stand += 1
    end
    draw
  end
 
  #----------------------------------------------------------------------------
  # draw
  # zeichnet den Balken
  #---------------------------------------------------------------------------- 
 
  def draw
    reset
    draw_background
    text_settings
    background = RPG::Cache.picture("Balken_fill")
    width = @sprite.bitmap.width
    stand = (width.to_f / @maximum.to_f) * @stand.to_f
    height = @sprite.bitmap.height
    rect = Rect.new(0, 0, stand ,height)
    @sprite.bitmap.blt(0, 0, background, rect)
    rect = @sprite.bitmap.rect
    @sprite.bitmap.draw_text(rect, @text, 1)
  end
 
  #----------------------------------------------------------------------------
  # draw
  # zeichnet die Hintergrundgrafik des Balkens
  #----------------------------------------------------------------------------   
 
  def draw_background
    background = RPG::Cache.picture("Balken_back")
    rect = @sprite.bitmap.rect
    @sprite.bitmap.blt(0, 0, background, rect)
  end
 
  #----------------------------------------------------------------------------
  # dispose
  # löscht die Balken-Grafik
  #----------------------------------------------------------------------------
  def dispose
    @sprite.bitmap.dispose
  end
 
  #----------------------------------------------------------------------------
  # fertig?
  # gibt zurück ob der Balken geleert oder gefüllt wurde
  #----------------------------------------------------------------------------
  def fertig?
    case @typ
    when  0
      return (@stand <= 0)
    when  1
      return (@stand >= @maximum)
    end
  end
 
  #----------------------------------------------------------------------------
  # text_settings
  # Einstellungen für den Text des Balkens
  #----------------------------------------------------------------------------
  def text_settings
    @sprite.bitmap.font.name = "Arial"
    @sprite.bitmap.font.size = 16
    @sprite.bitmap.font.color = Color.new(100, 200, 100)
  end
 
  #----------------------------------------------------------------------------
  # reset
  # Setzt die Grafik des Balkens zurück
  #----------------------------------------------------------------------------
 
  def reset
    dispose
    @sprite.bitmap = Bitmap.new(96, 32)
  end
 
end