View source for Legacy:Functions

{{LegacyWarning}}


This is a definitive reference of the **legacy** Sphere 1.5 API. In other words, the functions that Sphere 1.5 uses in its JavaScript engine.

For the newer Sphere 2 API, please check [[API:Functions]].

Alternatively, the whole Sphere API, sorted by category, with brief descriptions of the functions is available in the [[Doc Functions|API text file]] mirror itself.

For assistance with using JavaScript itself, consult these links:
*https://developer.mozilla.org/en/Core_JavaScript_1.5_Guide - Mozilla JavaScript Guide
*https://developer.mozilla.org/en/Core_JavaScript_1.5_Reference - Mozilla JavaScript Reference

<noinclude>
{{section|sph-section-green|Making new function/object pages|Simple steps:
#Click a red link.
#Place the following code in the empty edit box: <code><nowiki>{{subst:functemp}}</nowiki></code> for a new function, or <code><nowiki>{{subst:objecttemp}}</nowiki></code> for a new object.
#Check the minor edit flag and save.
#Click 'edit' at the top of the page to add content.
#Try to be [http://en.wiktionary.org/wiki/objective objective] when writing, and save when you're done.
#Remove description from this page, add page link to list at the top of the matching section.
}}

<!-- Disclaimer is hidden
<div style="background-color:#fee; border-color:#fcc; border-style:solid; border-width:1px; padding:4px">
<div style="background-color:#c00; color:#fff; font-weight:bold; padding:5px">Disclaimer</div>
<div>Note the standard disclaimer at the bottom of the edit box:
:''If you don't want your writing to be edited mercilessly and redistributed at will, then don't submit it here.''

Be bold with your editing! If something doesn't look right, click 'edit' and fix it to the best of your ability.</div>
</div>
-->
</noinclude>

__TOC__

= Engine functions =

* [[Legacy:GetVersion|GetVersion]](): Get the version of Sphere as a number.
* [[Legacy:GetVersionString|GetVersionString]](): Get the full Sphere version.

== Game control ==

* [[Legacy:Abort|Abort]](): Exit with a message.
* [[Legacy:Exit|Exit]](): Exit unconditionally.
* [[Legacy:RestartGame|RestartGame]](): Restarts the game.

== Accessing installed games ==

* Sphere [[Legacy:Game|Game]] object: Holds info about an installed Sphere game.
* [[Legacy:GetGameList|GetGameList]](): Get a list of installed Sphere games.
* [[Legacy:ExecuteGame|ExecuteGame]](''directory''): Execute Sphere game installed in ''directory''.

= Script functions =

* [[Legacy:GarbageCollect|GarbageCollect]](): Run JavaScript's garbage collector to free memory.

== File inclusion ==

* [[Legacy:EvaluateScript|EvaluateScript]](''filename''): Include a script file unconditionally.
* [[Legacy:EvaluateSystemScript|EvaluateSystemScript]](''filename''): Include a system script file unconditionally.
* [[Legacy:RequireScript|RequireScript]](''filename''): Include a script file once.
* [[Legacy:RequireSystemScript|RequireSystemScript]](''filename''): Include a system script file once.

== Time ==
* [[Legacy:GetTime|GetTime]](): Get the number of milliseconds since an arbitrary point in time.

== Conversion ==
* [[Legacy:CreateStringFromCode|CreateStringFromCode]](''ascii_code''): Translate a number to the matching character.

= System interfaces =

== Video ==

* [[Legacy:FlipScreen|FlipScreen]](): Show the results of drawing to the screen.
* [[Legacy:GetFrameRate|GetFrameRate]](): Get the frame rate that limits [[Legacy:FlipScreen|FlipScreen]]() call rate.
* [[Legacy:SetFrameRate|SetFrameRate]](''frames_per_second''): Limit the rate of [[Legacy:FlipScreen|FlipScreen]]() calls.
* [[Legacy:ApplyColorMask|ApplyColorMask]](''color''): Fills the whole screen with ''color''.

=== Screen size ===

* [[Legacy:GetScreenWidth|GetScreenWidth]](): Get the width of the screen.
* [[Legacy:GetScreenHeight|GetScreenHeight]](): Get the height of the screen.

=== Clipping ===

* Sphere [[Legacy:ClippingRectangle|ClippingRectangle]] object: Holds dimensions for clipping rectangle functions.
* [[Legacy:GetClippingRectangle|GetClippingRectangle]](): Get the rectangle in which drawing is being clipped on screen.
* [[Legacy:SetClippingRectangle|SetClippingRectangle]](''x'', ''y'', ''width'', ''height''): Set a rectangle to clip screen drawing.

=== Graphics primitives ===

{{Legacy:Functions/Primitives}}

{{Legacy:Functions/Input}}

{{Legacy:Functions/Networking}}

= Map Engine =

{{Legacy:Functions/Map}}

= Sphere objects =

Besides the above, Sphere has a set of built-in objects for more generalized use within projects. Most are loaded from external resource files, but a few (Color, ColorMatrix) are defined solely in script and remain only in-memory during the running of the project.

{{Legacy:Functions/Sounds}}

{{Legacy:Functions/Colors}}

{{Legacy:Functions/ColorMatrices}}

{{Legacy:Functions/Spritesets}}

{{Legacy:Functions/Fonts}}

{{Legacy:Functions/WindowStyles}}

{{Legacy:Functions/Images}}

{{Legacy:Functions/Surfaces}}

{{Legacy:Functions/Animations}}

{{Legacy:Functions/Filesystem}}

{{Legacy:Functions/Files}}

{{Legacy:Functions/Log}}


== ByteArray object ==

* Sphere [[Legacy:ByteArray|ByteArray]] object: Holds an array of bytes.
* [[Legacy:CreateByteArray|CreateByteArray]](''length''): Create a new [[Legacy:ByteArray|ByteArray]].
* [[Legacy:ByteArray/concat|ByteArray.concat]](''byte_array_object'', ''byte_array_to_append''): Returns bytearray with byte_array_to_append attached to the end of it
* [[Legacy:ByteArray/slice|ByteArray.slice]](''start_slice'' [, ''end_slice'']): Returns a slice of the bytearray starting at start, and ending at end or the end of the bytearray if end is omitted. If end is a negative number, the end point is started from the end of the bytearray.

=== Conversion ===

* [[Legacy:CreateByteArrayFromString|CreateByteArrayFromString]](''string''): Create a [[Legacy:ByteArray|ByteArray]] from ''string''.
* [[Legacy:CreateStringFromByteArray|CreateStringFromByteArray]](''byte_array''): Convert a [[Legacy:ByteArray|ByteArray]] into a string.

=== Data hashing ===

* [[Legacy:HashByteArray|HashByteArray]](''byte_array''): Calculate MD5 'fingerprint' of data in ''byte_array''.


[[Category:Functions]]
[[Category:Sphere 1]]