OFPEC Function Library Launched!

[LCD]

Kool  ;D

:thumbsup:

@ snYpir - check ur mail 3 functions are in dere   (used in a script - so u may dont wanna post som of em  :-\)  

LCD OUT

[Spinor]

preprocessFile -> Compiles the file (most probaly into machine code in memory)

loadFile -> copies the content of the file line-by-line into memory

I'm not sure about this. According to the ComRef, preprocessFile only preprocesses i.e. you can use
#define aaa BBBBB
to make substitutions
and \\ to make comments.
When executing the function, there should be no difference in speed.
preprocessFile is still the way to go for precaching functions because of the two above advantages.

[snYpir]

Yeah, i was wrong (sort of) :-\

Suma made a comment on my tutorial, and yeah both loadFile and preprocessFile do the same thing (except for the preprocessing)

I will encourage people to use preprocessFile.

[Messiah]

Code: [Select]

_unitarray= _this select 0
_hurt = []
_say = ["eng22","eng23","eng29","eng30","eng31","eng32","eng33","eng34"]

#start
_tmp= (count _unitarray) - 1
?_tmp < 0 : exit

#loop1
_unit = _unitarray select _tmp
? vehicle _unit != _unit : goto "cycle"
? "man" CountType [_unit] == 0 : goto "cycle"
? _unit in _hurt : goto "check"
? getdammage _unit > 0: _hurt = _hurt + [_unit]; goto "speak"

#cycle
~0.05
_tmp = _tmp - 1
?_tmp < 0 : goto "start"
goto "loop1"

#check
? getdammage _unit == 0: _hurt = _hurt - [_unit]
goto "cycle"

#speak
_rand = random 8
_rand = _rand - _rand % 1
_unit say (_say select _rand)
~5
goto "cycle"

so, could i convert that script into a function? its just a pain script - using a list trigger as the array it see's who is hurt and makes them say one of the editor voices, like 'MEDIC!' etc... can that be made into a function?

[LCD]

no - u cant use delays in functions and u dont wanna make big loops in function cuz it wil b like big loops in scripts only faster  

LCD OUT

[Messiah]

hmmm, well, could some1 post up and example of what you would write? I would like to work this function thing out, as my mission does require many, high end scripts and lag isnt an option.

[toadlife]

Messiah

Skim through snYpir's tute and visit the section with the few function examples.
http://www.ofpec.com/editors/funcref.php

I just added one, which shuffles an array.  Here is the code for that function for you to look at, only with comments that say what is happening.

Code: [Select]

//****************************************************
//
// Shuffle array function by toadlife
//
// http://toadlife.net
//
// Function: Shuffles an array's contents into random order
//
// Returns: array
//
// Initialize this fuction in your init.sqs file with this line: shuffle = preprocessFile "shuffle.sqf"
//
// Call this function like so:  myarray call shuffle -- (Example: [1,2,3,4,5] call shuffle)
//
//***************************************

// Keeps these variables from being snookered if they're used in other scripts? (not sure about that one)
private ["_this","_newarray","_acount","_rand","_moveitem"];

// Initialize the new array that will be returned after processing
_newarray = [];

// Shuffle code - takes "_this", shuffles the contents and put the contents into "_newarray"
while "count _this > 0" do {_acount = (count _this);_rand = random _acount;_rand = _rand - (_rand mod 1);_moveitem = _this select _rand;_newarray = _newarray + [_moveitem];_this = _this - [_moveitem]};

//This is  the new "shuffled" array. This is what is returned by the function.
_newarray;

Here would be an example:

Code: [Select]

_say = ["eng22","eng23","eng29","eng30","eng31","eng32","eng33","eng34"]
_hurt = []
#loop
~0.05
_soldiers = list mytrigger call shuffle
if ((getdammage _x > 0) && ("man" counttype [_x] == 1) && (!_x in _hurt) then {_hurt = [_x] + _hurt;[_x,_say] call injured} foreach _soldiers
if ((_x in _hurt) && getdammage _x == 0)  then {_hurt = _hurt - [_x]} foreach _soldiers
goto "loop"


Code: [Select]

//****************************************************
//
// Injured function by toadlife
//
// http://toadlife.net
//
// Function: Caused an soldier to scream out a random saying
//
// Returns: nothing
//
// Initialize this fuction in your init.sqs file with this line: injured = preprocessFile "injured.sqf"
//
// Call this function like so:  [soldier,[sounds]] call injured -- (Example: [unit1,["bum",crap","shiznit"] call injured)
//
//***************************************
private ["_rand"];
_rand = random count (_this select 1);
_rand = _rand - _rand % 1;
(_this select 0) say ((_this select 1) select _rand);

NOTE THAT THE PRECEEDING EXAMPLE HAS NOT BEEN TESTED FOR SYNTAX ERRORS OR OTHER MISC. BRAIN FARTS!  ;D

[Messiah]

hmmm, ok, i'll have to work it out... cheers.

[toadlife]

Note:

Why you would want to shuffle the list of soldiers in your partucular script is beyond me -- I just inlcuded the function as an example. You could break your script down into more functions if you wanted to, though, I'm not sure what the benefits would be.

You could go function crazy, and make the line that removes soldiers from the "_hurt" array into a function.

[toadlife]

HOw would you include multiple scripts in a pbo file? I tried and can't seem to access them once they are pbo'd.

[KTottE]

Why would you want to .pbo only scripts anyway?

I suggest looking at the config.cpp for the entire game, and scripts.pbo
I'm sure those will tell you what to do.

[toadlife]

Why would you want to .pbo only scripts anyway?

I wouldn't. I would cause more problems than it would solve. At first I though it would be neat to include the functions in an addon, but when I envision the problems that addons allready cause, I think it would be a disaster. Nevermind

[snYpir]

The 'function library' is now officially open. Now, everyone please upload their functions! ;D

There is also a massive tutorial on how to write functions, accessable from the function library main page.

[Turver]

i thought u guys needed cheering up  ;D

[Sui]

Turver,

while that's good for a laugh, could you please refrain from posting off topic stuff in the Announcements forum...

We do some serious stuff in here! ;D