Difference between revisions of "Category:TSFC"

1,632 bytes added ,  12:45, 23 June 2011
no edit summary
imported>DragoonWraith
(OBSE Plug-In)
imported>Grumpf be
 
(26 intermediate revisions by 6 users not shown)
Line 1: Line 1:
Tibixe's String Function Collection (currently in alpha on TESSource) is a plugin for OBSE that provides functions to read, create and manipulate string variables in Oblivion. Unfortunately all of Tibixe's documentation was wiped in the server crash, so feel free to help rebuild it. These descriptions have been gathered through pretty much trial and error, so they may not detail every feature of the functions.
{{OBSE Plugin
|Version    = 0.5.0
|InternalVer = 0
|Name        = Tibixe's String Function Collection
|Author      = [http://www.bethsoft.com/bgsforums/index.php?showuser=97860 Tibixe], Arius, [http://www.bethsoft.com/bgsforums/index.php?showuser=233615 Speedo]
|Description = TSFC is a plugin for OBSE that provides functions to read, create and manipulate string variables in Oblivion.
|Install    =
*'''OMOD Version:'''
*#Double-click the .omod file to add it to [http://timeslip.chorrol.com/obmm.html Oblivion Mod Manager]
*#After OBMM starts, double click the file in the OMOD list to install it
*'''Manual Install:'''
*#Browse to the folder Oblivion\Data\obse\plugins
*#Extract the contents of the downloaded zip into that folder
|Download    = [http://www.tesnexus.com/downloads/file.php?id=11666 TES Nexus]
|Source      = 1
|Discussions = [http://www.bethsoft.com/bgsforums/index.php?showtopic=715123 Bethesda Forums "<nowiki>[Alpha]</nowiki> Tibixe's String Function Collection"]
|OBSEname    = Tibixes_String_Function_Collection
}}


==Obsolete==
[http://obse.silverlock.org/obse_command_doc.html#StringVariables OBSE] (v16) now includes its own set of string functions, rendering TSFC obsolete.
Also, Speedo has removed his update of TSFC. He fixed a [http://www.bethsoft.com/bgsforums/index.php?s=&showtopic=715123&view=findpost&p=12146677 number of issues], most importantly a CTD bug with StrGet/SetXXXPath and setting up a TSFC<->Pluggy string exchange. As Speedo also removed his source code, it's hard to tell just how much he changed.
Note that these wiki pages refer to Speedo's v0.5.5 and may not be true for Tibixe's v.0.5.
==Details==
One important feature of these functions is that they do not store strings directly in the variables you provide- they store the string in memory, and assign it a reference number. You provide the functions with the reference number, and they draw and use the appropriate string. It means that if you reuse the pointer, the string is basically cut loose and floating around in memory. Use the StrDel function to delete the string associates with the pointer if you plan on reusing the long variable used for the pointer, or if the script is temporary (e.g. scripteffect spells, a script on an object that gets removed or otherwise erased).
One important feature of these functions is that they do not store strings directly in the variables you provide- they store the string in memory, and assign it a reference number. You provide the functions with the reference number, and they draw and use the appropriate string. It means that if you reuse the pointer, the string is basically cut loose and floating around in memory. Use the StrDel function to delete the string associates with the pointer if you plan on reusing the long variable used for the pointer, or if the script is temporary (e.g. scripteffect spells, a script on an object that gets removed or otherwise erased).


Bear in mind this is all my interpretation of the currently available information, and is quite likely to be wrong. Direct all complaints to [[User:Talkie Toaster|Talkie Toaster]] 19:03, 13 July 2007 (EDT).
The type stringID is used in this documentation, however this is not recognized by the CS. I use it in to indicate when a long or short is interpreted as a string's identifier, not its integer value.
 
==Note==
In Tibixe's absence, this plugin was last updated by [http://www.bethsoft.com/bgsforums/index.php?showuser=233615 Speedo].  The last version released by Tibixe may be found at [http://www.tesnexus.com/downloads/file.php?id=11666 TES Nexus], and the source code found at [http://obse-plugins.svn.sourceforge.net/viewvc/obse-plugins/TSFC/ Source Forge].


[[Category: OBSE Plug-Ins]]
[[Category: Functions|Z]]
[[Category: Functions (OBSE)]]
Anonymous user