Skip to content

AGS module for Sierra style conversations forked from speech bubble

License

Notifications You must be signed in to change notification settings

ericoporto/SierraSpeech

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SierraSpeech

SierraSpeech Adventure Game Studio (AGS) module mimics the Sierra Speech Style available by default in AGS, to solve some limitations. This is a fork of the SpeechBubble AGS Module made by Snarky, also available on github, which I aggregated SSH' efforts from GUI Portrait module, It requires AGS v3.4.3.1 or higher.

THIS MODULE IS UNFINISHED. SOME FEATURES ARE NOT YET IMPLEMENTED, AND OTHERS MAY CHANGE BEFORE THE FINAL RELEASE.

How To Use

To use, you call Character.SierraSay(). For example:

player.SierraSay("This line will be said in a speech bubble");

You can also use Character.SierraSayAtBubble() to position the bubble elsewhere on screen, and Character.SierraSayBackgroundBubble() for non-blocking speech. Character.SierraThinkBubble() IS NOT YET IMPLEMENTED.

To configure the appearance of the speech bubbles, you set the SpeechBubble properties. This is usually best done in GlobalScript game_start(). For example:

function game_start()
{
  SierraSpeech.BorderColor = Game.GetColorFromRGB(0,128,0);
  SierraSpeech.BackgroundColor = Game.GetColorFromRGB(128,255,128);
  SierraSpeech.BackgroundTransparency = 33;
  SierraSpeech.PaddingTop = 5;
  SierraSpeech.PaddingBottom = 5;
  SierraSpeech.PaddingLeft = 15;
  SierraSpeech.PaddingRight = 15;
  // Other code
}

See the declaration below for the full list and explanation of the properties.

The module relies on built-in AGS settings as far as possible. In particular, it uses these settings to customize the appearance and behavior of the speech bubbles:

  • Character.SpeechColor
  • Game.SpeechFont
  • Game.TextReadingSpeed
  • Speech.SkipStyle
  • Speech.VoiceMode

Note that to get text-based lip sync to work, you need to provide an invisible font, and set the SpeechBubble.InvisibleFont property accordingly. You may download one here:

http://www.angelfire.com/pr/pgpf/if.html

Finally, the module (usually) calls Character.Say() to render speech animation and play voice clips. If you are already using some custom Say module (e.g. TotalLipSync), you may want to call a custom Say() function instead. To do this, simply change the function call in SB_sayImpl() at the top of SpeechBubble.asc.

License details

This module carries the licenses of the module it forks from.

Speech Bubble was developed by Snarky, who was funded by AGS forum member bx83, who agreed to make the code open-source. Thanks!

This code is offered under the MIT License

It is also licensed under a Creative Commons Attribution 4.0 International License: https://creativecommons.org/licenses/by/4.0/

About

AGS module for Sierra style conversations forked from speech bubble

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • AGS Script 100.0%