Pause Script

[leman]

Hi

First of all, thank you for anyone that spent their precious time reading this.

This script is quite simple actually,
When you press a certain button(Z maybe), these will happen :
1.  It pauses the game (you can't move, events can't move, the playtime doesn't move but the BGM should still be played)
2.  Tint the screen (how dark the screen becomes should be easily customizable).
3.  Shows an image at the middle of the screen (the image file should be in the pictures folder and named 'paused' or anything similar)
Here's the image just to help anyone trying to make this script~
http://i226.photobucket.com/albums/dd69 ... paused.png[/img]
(just make the black part transparent when you import it)

For anyone making this, thanks in advance.

 

[Zeriab]

My Dialog system should work nice for this. Here is a Dialog for a single centered picture:

Spoiler: Dialog framework

Place this script above Dialog_Picture.

#==============================================================================
# ** Dialog system
#------------------------------------------------------------------------------
# Zeriab
# Version 1.0
# 2007-11-07 (Year-Month-Day)
#------------------------------------------------------------------------------
# * Description :
#
#   A small framework like script for dialogs
#------------------------------------------------------------------------------
# * License :
#
#   Copyright (C) 2007  Zeriab
#
#   This program is free software: you can redistribute it and/or modify
#   it under the terms of the GNU Lesser Public License as published by
#   the Free Software Foundation, either version 3 of the License, or
#   (at your option) any later version.
#
#   This program is distributed in the hope that it will be useful,
#   but WITHOUT ANY WARRANTY; without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#   GNU Lesser Public License for more details.
#
#   For the full license see <http://www.gnu.org/licenses/> 
#   The GNU General Public License: http://www.gnu.org/licenses/gpl.txt
#   The GNU Lesser General Public License: http://www.gnu.org/licenses/lgpl.txt
#------------------------------------------------------------------------------
# * Instructions :
#
#   You can place this script pretty much anyway you like.
#   Place it above any other Dialogs you might be using.
#   Increase the STARTING_Z_VALUE if you have trouble with the dialog not
#   on top.
#==============================================================================
class Dialog
  STARTING_Z_VALUE = 1500 # Default value is 1500
  attr_accessor :value
  attr_writer :marked_to_close
  #--------------------------------------------------------------------------
  # * Getter with 'false' as default value
  #--------------------------------------------------------------------------
  def marked_to_close
    @marked_to_close = false  if @marked_to_close.nil?
    return @marked_to_close
  end
  #--------------------------------------------------------------------------
  # * Mark the dialog to close
  #--------------------------------------------------------------------------
  def mark_to_close
    self.marked_to_close = true
  end
  #--------------------------------------------------------------------------
  # * Show the dialog
  #   Returns the value from the dialog
  #--------------------------------------------------------------------------
  def self.show(*args, &block)
    dialog = self.new(*args, &block)
    dialog.marked_to_close = false
    return dialog.main
  end
  #--------------------------------------------------------------------------
  # * Initialization
  #--------------------------------------------------------------------------
  def initialize(*args, &block)
    # For subclasses to overwrite
  end
  #--------------------------------------------------------------------------
  # * Main processing
  #--------------------------------------------------------------------------
  def main
    # Create the dimmed background
    create_background
    # Create Windows
    main_window
    # Main loop
    loop do
      # Update game screen
      Graphics.update
      # Update input information
      Input.update
      # Frame update
      update
      # Abort loop if the dialog should close
      if marked_to_close
        break
      end
    end
    # Dispose of windows
    main_dispose
    # Dispose of background
    dispose_background
    # Update input information
    Input.update
    # Returns the acquired value
    return self.value
  end
  #--------------------------------------------------------------------------
  # * Create the dimmed background
  #--------------------------------------------------------------------------
  def create_background
    bitmap = Bitmap.new(640,480)
    bitmap.fill_rect(0,0,640,480,Color.new(0,0,0,128))
    @background_sprite = Sprite.new
    @background_sprite.z = STARTING_Z_VALUE
    @background_sprite.bitmap = bitmap
  end
  #--------------------------------------------------------------------------
  # * Create the windows
  #--------------------------------------------------------------------------
  def main_window
    # For the subclasses to override
    # Remember to set their z.value to at least STARTING_Z_VALUE + 1
  end
  #--------------------------------------------------------------------------
  # * Dispose the background
  #--------------------------------------------------------------------------
  def dispose_background
    @background_sprite.dispose
  end
  #--------------------------------------------------------------------------
  # * Dispose the windows
  #--------------------------------------------------------------------------
  def main_dispose
    # For the subclasses to override
    # Dispose your windows here
  end
  #--------------------------------------------------------------------------
  # * Frame Update
  #--------------------------------------------------------------------------
  def update
    # For the subclasses to override
    if Input.trigger?(Input::B)
      mark_to_close
    end
  end
end

#============================================================================
# * A simple one-centered picture dialog
#============================================================================
class Dialog_Picture < Dialog
  #--------------------------------------------------------------------------
  # * Initialization
  #--------------------------------------------------------------------------
  def initialize(opacity=128, picture="paused")
    @opacity = opacity
    @picture = picture
  end
  #--------------------------------------------------------------------------
  # * Create the windows
  #--------------------------------------------------------------------------
  def main_window
    # Changes the background sprite to have the specified opacity
    @background_sprite.bitmap.fill_rect(0,0,640,480,Color.new(0,0,0,255))
    @background_sprite.opacity = @opacity
    # The picture sprite
    @sprite = Sprite.new
    @sprite.bitmap = RPG::Cache.picture(@picture)
    @sprite.x = (640 - @sprite.src_rect.width) / 2
    @sprite.y = (480 - @sprite.src_rect.height) / 2
    @sprite.z = STARTING_Z_VALUE + 1
  end
  #--------------------------------------------------------------------------
  # * Dispose the windows
  #--------------------------------------------------------------------------
  def main_dispose
    @sprite.dispose
  end
  #--------------------------------------------------------------------------
  # * Frame Update
  #--------------------------------------------------------------------------
  def update
    @sprite.update
    if Input.trigger?(Input::B) || Input.trigger?(Input::C)
      mark_to_close
    end
  end
end

To call it simply use this script command:

Dialog_Picture.show                   # Default with opacity = 128 and picture file = 'paused'
Dialog_Picture.show(255)              # Different opacity, black. Default picture file = 'paused'
Dialog_Picture.show(225, 'paused2')   # Different opacity and picture

I am not really sure when you want this feature available, so I haven't given any scripts integrating it.
You can make an parallel event yourself using a script call with one of the mentioned commands.
The game will not proceed until you press the B or C button. (Cancel and Enter/Trigger)