Map Popup Script

[Midi]

Map Popup Script

Descrizione

Questo script permette di mostrare dei brevi messaggi sotto forma di popup sopra i character (Eventi e Player).

http://img593.imageshack.us/img593/8592/v845.png

 

Può tornare utile per mostrare brevi descrizioni, dialoghi, eccetera.

Tra le altre cose è possibile scegliere font, colori, aggiungere effetti (come fadeout e floating).

Autore

Midi

Allegati

Nessuno

Istruzioni per l'uso

Incollare lo script nella sezione "Materials", sopra il "Main".

Le istruzioni per impostare i popup e mostrarli si trovano all'inizio dello script.

Script

#=============================================================================

#  Map Text Popup

#-----------------------------------------------------------------------------

#  vers. 1.0.0 (03-11-2013)

#  by Midi

#-----------------------------------------------------------------------------

module Map_Text_Popup

#=============================================================================

# ** DESCRIZIONE **

#  Questo script permette di mostrare brevi messaggi sopra agli eventi e al

#  Player, tramite dei popup in mappa.

#  Può essere utile per dialoghi, indicazioni, informazioni, eccetera.

#-----------------------------------------------------------------------------

# ** ISTRUZIONI **

#  Per mostrare i messaggi nel popup, chiamare un Call Script come segue:

#

#      Popup.new("testo")

#  oppure

#      Popup.new("testo", target)

#  oppure

#      Popup.new("testo", target, long_txt)

#

#  - "testo" : il testo da mostrare nel popup, tra virgolette. È possibile

#              andare a capo normalmente. In tal caso, il testo andrà a capo

#              anche nel popup.

#  - target  : un intero. Indica l'ID dell'evento sopra cui apparirà il popup.

#              Per indicare il Player, inserire un numero negativo oppure il

#              simbolo ":player", senza virgolette. Per indicare l'evento

#              corrente (ovvero quello dal quale è lanciato il call script),

#              inserire 0.

#              Se il target è assente, il popup viene mostrato sull'evento

#              corrente.

#  - long_txt: true o false. Se true, indica il popup sarà visibile per più

#              più tempo (utile per testi molto lunghi).

#              Se il parametro long_txt è assente, è considerato false e la

#              durata del popup sarà normale.

#-----------------------------------------------------------------------------

#  Esempi:

#

#  Popup.new("Trovata 1 Pozione")

#      Viene mostrato il testo tra virgolette in un popup sopra l'evento che

#      ha effettuato la chiamata.

#

#  Popup.new("Trovata 1 Pozione

#  Trovata 1 Spada Corta")

#      Viene mostrato il testo tra virgolette in un popup di 2 righe sopra

#      l'evento che ha effettuato la chiamata.

#

#  Popup.new("Fermati, ladro!", 3)

#      Viene mostrato il testo tra virgolette in un popup sopra l'evento con

#      ID 3.

#

#  Popup.new("Aiuto!", :player)

#      o anche

#  Popup.new("Aiuto!", -1)

#      Viene mostrato il testo tra virgolette in un popup sopra il Player.

#

#  Popup.new("Direzione Nord: città di Sugtah

#  Direzione Est: Deserto del Got'ha

#  Direzione Ovest: Montagne Maledette

#  Direzione Sud: Baia dei Pirati", 4, true)

#      Viene mostrato il testo tra virgolette in un popup sopra l'evento con

#      ID 4. Il popup sarà visibile a lungo.

#

#=============================================================================

# ** IMPOSTAZIONI **

#-----------------------------------------------------------------------------

  Font_Name = "Calibri"       # nome del font usato nel popup

  

  Font_Size = 22              # dimensione del font usato nel popup

  

  Font_Italic = true          # corsivo: true/false

  

  Font_Bold = true            # grassetto: true/false

  

  # colori a disposizione per il testo del popup

  Font_Colors = {

    :default => Color.new(255, 255, 255), # colore di default (bianco).

                                          # È possibile modificarlo, ma NON

                                          # VA CANCELLATO, NÉ CAMBIATO DI NOME

                                          # altrimenti lo script non funziona

  # qui sotto è possibile inserire altri colori, nel formato:

  #

  #  :nome  => Color.new(valore_Rosso, valore_Verde, valore_Blu),

  #

  #  (i valori sono da intendersi nel formato RGB, da 0 a 255)

  #

  # per esempio:

  # :blue    => Color.new(0, 0, 255),

  # :green   => Color.new(0, 255, 0),

  # :black   => Color.new(0, 0, 0),

    :red     => Color.new(255, 0, 0)

  }

  # FINE COLORI

  

  Message_Duration = 35       # durata (in frame) del popup (60 = 1 sec.)

  

  Message_Float = 64          # valore del floating (in pixel).

                              # Se questo valore è maggiore di 0, il popup

                              # "galleggerà" verso l'alto per il numero di

                              # pixel indicati. Se il valore è 0 o meno, il

                              # popup resterà fisso.

                              

  Message_Fadeout = 15        # durata del fadeout (in frame, 60 = 1 sec.)

                              # Se questo valore è maggiore di zero, al

                              # termine della durata del popup il messaggio

                              # sbiadirà lentamente fino a scomparire. Se

                              # il valore è 0 o meno, il popup scomparirà

                              # di colpo.

                              

  Message_Long_Multiplier = 4 # moltiplicatore per long_txt

                              # Questo è il valore che moltiplica la durata

                              # del messaggio quando il parametro long_text

                              # del Popup.new viene settato a true.

                              # (quindi ad esempio con questo valore a 4, il

                              # testo verrà mostrato con durata quadrupla

                              # rispetto al normale)

#-----------------------------------------------------------------------------

#  È possibile modificare le impostazioni durante il gioco, tramite dei Call

#  Script:

#

#  $game_system.popup_set_font_name("Nome font")

#      Indicare tra virgolette il nome del nuovo font. Se si inserisce nil

#      (senza virgolette) viene ripristinato il valore di default indicato

#      nella sezione precedente.

#

#  $game_system.popup_set_font_size(dimensione)

#      dimensione: un numero maggiore o uguale a 0, indica la nuova dimensione

#      del font. Se si inserisce nil viene ripristinato il valore di default

#      indicato nella sezione precedente.

#

#  $game_system.popup_set_italic(italic)

#  $game_system.popup_set_bold(bold)

#      italic/bold: true o false, indicano rispettivamente se il font sarà in

#      corsivo o grassetto. Se si inserisce nil verranno ripristinati i valori

#      di default indicati nella sezione precedente.

#

#  $game_system.popup_set_color(color)

#      color può essere: a) un nome tra i colori presenti nelle impostazioni

#      (per esempio :red o :black) oppure b) un nuovo colore (per esempio

#      Color.new(200, 150, 100). Indica il nuovo colore per il font del popup.

#      Se si inserisce nil verrà ripristinato il colore :default indicato

#      nella sezione precedente.

#

#  $game_system.popup_duration(valore)

#  $game_system.popup_message_float(valore)

#  $game_system.popup_fadeout(valore)

#  $game_system.popup_long_multiplier(valore)

#      Indicano i nuovi valori rispettivamente di durata, floating, fadeout e

#      moltiplicatore per la lunga durata. Se si inserisce nil verranno

#      ripristinati i valori di default indicati nella sezione precedente.

#=============================================================================

#=============================================================================

# ** CONDIZIONI DI UTILIZZO **

#  Questo script è sotto licenza Creative Commons BY-NC-SA

#  (Attribuzione-NonCommerciale-CondividiAlloStessoModo 3.0 Unported).

#  - Attribuzione  : è obbligatorio creditare l'autore

#  - NonCommerciale: non si può utilizzare questo script per scopi

#                    commerciali

#  - CondividiAlloStessoModo: se si modifica, trasforma o utilizza questo

#                    script in un'opera, l'opera risultante può essere

#                    distribuita solo sotto la stessa o compatibile licenza

#  Per più informazioni, http://creativecommons.org/licenses/by-nc-sa/3.0/

#=============================================================================



#-----------------------------------------------------------------------------

# Non modificare qui sotto, a meno che tu non sappia cosa stai facendo! :)

#-----------------------------------------------------------------------------

end



class Popup

  def initialize(message, target = 0, message_long = false)

    if message != nil && target != nil && message_long != nil

      character = nil

      if target.is_a?(Numeric)

        character = $game_map.interpreter.get_character(target)

      elsif target.is_a?(Symbol) && target == :player

        character = $game_map.interpreter.get_character(-1)

      end

      if character != nil

        character.message = message

        character.message_long = message_long

      end

    end

  end

end



class Game_System

  attr_reader :map_text_popup

  

  alias midi_development_initialize initialize

  

  def initialize

    midi_development_initialize

    @map_text_popup = Popup_Controller.new

  end

  

  def popup_set_font_name(name = nil)

    if name == nil

      @map_text_popup.font_name = Map_Text_Popup::Font_Name

    else

      @map_text_popup.font_name = name

    end

  end

  

  def popup_set_font_size(size = 0)

    if size == nil || (!size.is_a?(Numeric)) || size <= 0

      @map_text_popup.font_size = Map_Text_Popup::Font_Size

    else

      @map_text_popup.font_size = size

    end

  end

  

  def popup_set_italic(italic)

    if italic == nil

      @map_text_popup.font_italic = Map_Text_Popup::Font_Italic

    else

      @map_text_popup.font_italic = italic

    end

  end

  

  def popup_set_bold(bold)

    if bold == nil

      @map_text_popup.font_bold = Map_Text_Popup::Font_Bold

    else

      @map_text_popup.font_bold = bold

    end

  end

  

  def popup_set_color(color)

    if color != nil

      if color.is_a?(Symbol)

        @map_text_popup.font_color = Map_Text_Popup::Font_Colors[color]

      elsif color.is_a?(Color)

        @map_text_popup.font_color = color

      else

        @map_text_popup.font_color = Map_Text_Popup::Font_Colors[:default]

      end

    else

      @map_text_popup.font_color = Map_Text_Popup::Font_Colors[:default]

    end

  end

  

  def popup_duration(duration)

    if duration == nil || (!duration.is_a?(Numeric)) || duration <= 0

      @map_text_popup.message_duration = Map_Text_Popup::Message_Duration

    else

      @map_text_popup.message_duration = duration

    end

  end

  

  def popup_long_multiplier(multiplier)

    if multiplier == nil || (!multiplier.is_a?(Numeric)) || multiplier <= 0

      m = Map_Text_Popup::Message_Long_Multiplier

      @map_text_popup.message_long_multiplier = m

    else

      @map_text_popup.message_long_multiplier = multiplier

    end

  end

  

  def popup_message_float(float)

    if float == nil || (!float.is_a?(Numeric))

      @map_text_popup.message_float = Map_Text_Popup::Message_Float

    else

      @map_text_popup.message_float = float

    end

  end

  

  def popup_fadeout(fadeout)

    if fadeout == nil || (!fadeout.is_a?(Numeric)) || fadeout < 0

      @map_text_popup.message_fadeout = Map_Text_Popup::Message_Fadeout

    else

      @map_text_popup.message_fadeout = fadeout

    end

  end

end



class Popup_Controller

  attr_accessor :font_name

  attr_accessor :font_size

  attr_accessor :font_italic

  attr_accessor :font_bold

  attr_accessor :font_color

  attr_accessor :message_duration

  attr_accessor :message_long_multiplier

  attr_accessor :message_float

  attr_accessor :message_fadeout

  

  def initialize

    @font_name = Map_Text_Popup::Font_Name

    @font_size = Map_Text_Popup::Font_Size

    @font_italic = Map_Text_Popup::Font_Italic

    @font_bold = Map_Text_Popup::Font_Bold

    @font_color = Map_Text_Popup::Font_Colors[:default]

    @message_duration = Map_Text_Popup::Message_Duration

    @message_float = Map_Text_Popup::Message_Float

    @message_fadeout = Map_Text_Popup::Message_Fadeout

    @message_long_multiplier = Map_Text_Popup::Message_Long_Multiplier

  end

end



class Game_Character

  attr_accessor :message

  attr_accessor :message_long



  alias midi_development_initialize initialize

  def initialize

    midi_development_initialize

    @message = nil

    @message_long = false

  end

end



class Sprite_Character < Sprite_Base

  

  alias midi_development_update update

  alias midi_development_dispose dispose

  

  def initialize(viewport, character = nil)

    super(viewport)

    @character = character

    @balloon_duration = 0

    @message_duration = 0

    @message_float = 0

    @message_float_rate = 0

    @message_fadeout = 0

    @message_fadeout_rate = 0

    @message_alpha = 0

    update

  end

  

  def update

    super

    if @message_duration > 0

      @message_duration -=1

      @message_sprite.x = self.x

      @message_sprite.y = self.y - self.height - @message_float

    end

    if @message_duration <= 0

      if @message_fadeout > 0

        @message_fadeout -=1

        @message_sprite.x = self.x

        @message_sprite.y = self.y - self.height - @message_float

        @message_alpha -= @message_fadeout_rate

        @message_sprite.opacity = @message_alpha

      end

      if @message_fadeout <= 0

        @message_alpha = 0

        @message_fadeout_rate = 0

        @message_float = 0

        @message_float_rate = 0

        dispose_message

      end

    end

    if @message_sprite != nil

      @message_float += @message_float_rate

    end

    if @character != nil and @character.message != nil

      message = @character.message

      message_long = @character.message_long

      show_message(message, message_long)

      @character.message = nil

      @character.message_long = false

    end

    midi_development_update

  end

  

  def dispose

    midi_development_dispose

    dispose_message

  end

  

  def show_message(value, message_long = false)

    dispose_message

    if value != nil && value.is_a?(String)

      values = value.split("\n")

      popup_control = $game_system.map_text_popup

      @message_duration = popup_control.message_duration

      if message_long != nil && message_long == true

        @message_duration = @message_duration * 3

      end

      @message_float = popup_control.message_float

      if @message_duration > 0

        @message_float_rate = (@message_float / @message_duration.to_f)

      end

      @message_alpha = 255

      @message_fadeout = popup_control.message_fadeout

      if @message_fadeout > 0

        @message_fadeout_rate = (@message_alpha / @message_fadeout.to_f).ceil

        r = (@message_float / (@message_duration + @message_fadeout).to_f)

        @message_float_rate = r

      end

      @message_float = 0

      line_height = popup_control.font_size

      bitmap_height = line_height * values.size

      bitmap = Bitmap.new(220, bitmap_height)

      bitmap.font.name = popup_control.font_name

      bitmap.font.size = popup_control.font_size

      bitmap.font.italic = popup_control.font_italic

      bitmap.font.bold = popup_control.font_bold

      values.each_with_index do |v, i|

        bitmap.font.color.set(0, 0, 0)

        y_line = (i * line_height)

        bitmap.draw_text(1, y_line + 1, 220, line_height, v, 1)

        bitmap.font.color.set(popup_control.font_color)

        bitmap.draw_text(0, y_line, 220, line_height, v, 1)

      end

      @message_sprite = ::Sprite.new(self.viewport)

      @message_sprite.bitmap = bitmap

      @message_sprite.ox = 110

      @message_sprite.oy = bitmap_height

      @message_sprite.x = self.x

      @message_sprite.y = self.y - self.height

      @message_sprite.z += 99999

    end

  end

  

  def dispose_message

    if @message_sprite != nil

      @message_sprite.dispose

      @message_sprite = nil

    end

  end

  

end 

 

Bugs e Conflitti Noti

N/A

Altri dettagli

Le istruzioni sono presenti anche all'interno dello script.

Lo script è sotto licenza Creative Commons BY-NC-SA 3.0. Quindi è possibile usarlo e distribuirlo liberamente purché:

- venga creditato l'autore;

- non venga utilizzato con finalità commerciali;

- tutti le opere derivate e/o basate su esso siano distribuite con la stessa licenza o con licenza compatibile.

Edited November 7, 2013 by Midi

[Guardian of Irael]

Ah ottimo per mostrare testo dove vuoi! Non sarebbe stato male avere un'opzione per mostrare una piccola finestrella sopra il dato evento in caso ^ ^

[Holy87]

Molto bello, buona documentazione e molto personalizzabile :)

[BuddyTroller]

Pensavo fosse la solita richiesta, invece è un tuo script. Bravo!

[Midi]

Grazie a tutti.

 

@Guardian: l'opzione di rendere il popup in una piccola Window sarà una feature della prossima versione, così come quella di dare durata illimitata al popup (e di farlo scomparire alla pressione di un tasto).

Ma attualmente non è tra le mie priorità, ora sto cercando di dedicarmi all'RTP Contest. :)

Il problema non è tanto la stesura degli script in sé, quanto delle istruzioni... @.@

[Guardian of Irael]

Magimagnifico per entrambe le cose, si potranno così creare dialoghi e simili! :3 Vai con calma, prima l'RTP! ^ ^

[Kenshin]

Si possono fare anche i dialoghi fra png alla dragon age che parlano fra di loro senza bloccare il gioco ^^

[Midi]

Esattamente, ed era uno dei motivi che mi ha spinto a creare questo script: avevo bisogno di rendere la caoticità di un mercato. ^.^

[Zuppo]

ma perchè si chiama Map Popup o.o?

A primo acchitto pensavo si trattasse di un mostra minimappa su mappa.

Non era più sensato text Popup?

[Kenshin]

Perché mostra i popup su mappa?

[Guardian of Irael]

Mostrarli nel menù era un po' strano! XD Magri in battaglia! XD

^ ^

[Zuppo]

mh... mah. Se per voi ha senso, buon per voi.

[Guardian of Irael]

No, pure io dicevo che era strano XD

[Midi]

L'ho chiamato Map perché esistono degli script che mostrano il popup in battaglia, coi danni e/o l'alterazione degli status, come quello del Victor Engine. :)

 

Spiacente di averti tratto in inganno flame... XD

[Guardian of Irael]

Ah ecco era proprio per la parte in battaglia di altri script XD

^ ^

[Kingartur2]

Il problema non è tanto la stesura degli script in sé, quanto delle istruzioni... @.@

Ti capisco, è più noioso scrivere 10 righe di istruzioni rispetto a 1000 righe di codice, mi capita sempre così xD

[KenzaMe92]

ma solo a me non va?

*controlla bene e...*

MA NEANCHE I MIEI SCRIPT NON VANNO PIÙ

*vxace 1.02a che hai fatto?*

[lynod]

Grazie a tutti.

 

@Guardian: l'opzione di rendere il popup in una piccola Window sarà una feature della prossima versione, così come quella di dare durata illimitata al popup (e di farlo scomparire alla pressione di un tasto).

Ma attualmente non è tra le mie priorità, ora sto cercando di dedicarmi all'RTP Contest. :)

Il problema non è tanto la stesura degli script in sé, quanto delle istruzioni... @.@

Ho visto lo script e ora capisco il problema del tempo speso x le istruzioni...complimenti !!! Sono pochi gli scripter che fanno delle istruzioni cosi dettagliate (in italiano poi...) che sicuramente aiutano parecchio i principianti come me, sia ad usarlo che a capire le varie righe di codice....

[BuddyTroller]

Di solito se non ci sono le istruzioni o non servono o si tratta di qualcuno che ha preso lo script e lo spaccia per suo per fare il figo.

[KenzaMe92]

Ora va tutto!!

*dopo aver resuscitato un pc del '99 ce n'è voluto di tempo prima che si riprendesse*

[siengried]

Raga perchè con questo codice non esce niente in testa al pg?

Popup.new("Direzione Nord: città di Sugtah
# Direzione Est: Deserto del Got'ha
# Direzione Ovest: Montagne Maledette
# Direzione Sud: Baia dei Pirati", 4, true)

Ho provato anche in un nuovo progetto

Cioè se metto bottone premuto il testo appare ma se emtto processo paralleo nn va?...percè?

Edited December 19, 2013 by siengried

[Guardian of Irael]

Fai terminare il processo parallelo tramite switch o provato con l'inizio automatico? ^ ^

[siengried]

Nono continua all'infinito...

[Guardian of Irael]

?

Che intendi? Hai fatto come suggerito, facendo terminare il processo parallelo o l'inizio automatico con una switch? ^ ^

[Midi]

Se lo metti in un processo parallelo e fai partire il comando "Popup" di continuo non funziona.

Il comando "Popup" ha bisogno di tempo per partire (1 frame), se tu lo chiami ripetutamente continui a "resettarlo" e non parte mai.

 

Il modo giusto per chiamarlo è chiamarlo una volta sola, e lasciarlo partire.

 

Se vuoi creare una scritta "fissa" tramite processo parallelo, devi fare così:

- imposta il parametro dello script Message_Duration = 60 (ma va bene qualsiasi altro numero, più è alto meglio è, fino a un massimo di 600)

- crea un processo parallelo con il comando "Popup" e la scritta che vuoi

- subito dopo metti un wait/attendi di durata uguale a quella di Message_Duration -1 (quindi se hai messo 60, metti wait 59)

 

Comunque ti sconsiglio di usarlo in questo modo, non l'ho testato per lasciare scritte fisse.