Category:TSFC

From the Oblivion ConstructionSet Wiki
Jump to navigation Jump to search


Tibixe's String Function Collection
Author(s)

Tibixe, Arius, Speedo

Current Version 0.5.0 (GetPluginVersion returns 0)
Description

TSFC is a plugin for OBSE that provides functions to read, create and manipulate string variables in Oblivion.

Installation
  • OMOD Version:
    1. Double-click the .omod file to add it to Oblivion Mod Manager
    2. After OBMM starts, double click the file in the OMOD list to install it
  • Manual Install:
    1. Browse to the folder Oblivion\Data\obse\plugins
    2. Extract the contents of the downloaded zip into that folder
Download

TES Nexus

Source Code

TES Nexus

Discussions

Bethesda Forums "[Alpha] Tibixe's String Function Collection"

OBSE Name "Tibixes_String_Function_Collection"

(for use with IsPluginInstalled/GetPluginVersion)


Obsolete[edit | edit source]

OBSE (v16) now includes its own set of string functions, rendering TSFC obsolete.

Also, Speedo has removed his update of TSFC. He fixed a 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[edit | edit source]

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).

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[edit | edit source]

In Tibixe's absence, this plugin was last updated by Speedo. The last version released by Tibixe may be found at TES Nexus, and the source code found at Source Forge.