Updating Xelerus

[RPC]

So I'm off updating Xelerus (with a goal of 5 functions a day) and there are some functions (like the canvas ones) that I have absolutely NO clue about.
I'm currently using Alterecco's 1.06 fucntionlist as a guide and it's pretty effective at what it does.
Here are some that I need help on:
cnvDrawText
cnvDrawRect
cnvDrawImage
Basically, i have no clue what [Screen] and [ID] are.
The other two are abs and ecoExchange
ecoExchange
abs

They're pretty straightforward, but I'm linking to them here for further review.

[RPC]

error
fmtCurrency
gamSetCrawlImage
gamSetCrawlText
itmGetAverageAppearing
I made up the "Prologue" category for gamSetCrawlImage and gamSetCrawlText... it doesn't seem to fit though.

I also skipped (fncHelp ...), (isprimitive ...), and (itmGetArmorType item) -> type because I have no clue how to use them.
If anybody knows, please enlighten me!

[alterecco]

OK, I filled out the ones you mentioned were missing, and worked the others over a bit. Thanks for starting on this. I hope you decide to continue.

[RPC]

Uh- oh... It seems I have forgotten to update on the 3rd day
Um... to make up for it, I did 10 (or at least, tried) functions today:


itmGetDefaultCurrency
itmGetImageDesc
itmGetInstallPos
itmSetData

match
objAccelerate
objAddBuyOrder
objAddItemEnhancement
objAddSellOrder

no clue what (link ...) or (lookup source target keyIndex) -> found entry, does either



Why doesn't itmSetData return true/nil like ObjSetData?

Apparently my attempt to update Xelerus has created some redundant functions (that I can't delete):
http://xelerus.de/index.php?s=functions&function=370
http://xelerus.de/index.php?s=functions&function=369

Updating Xelerus is making me look at code that makes me feel less of a modder and more of a meddler.

[alterecco]

I removed the duplicate functions. I will take a look at the new updates you made as soon as I have the time.

itmSetData returns the altered item (if you dbgLog the returned list you will see it is the same as the original item, but with the data you set encoded on the end). That means that the typical way of using itmSetData is along these lines:

Code: Select all

(setq itm (itmCreate &someItem; 1))
(setq itm (itmSetData itm "SomeKey" "SomeValue"))

[alterecco]

OK, I edited the new functions you put up to clarify some things. I also added the lookup function. the link function is very specific and mostly for internal use, so I will not put that up atm.

[RPC]

Cool. Thanks, alterecco.

[RPC]

As I continue, the functions become more and more strange....
objcanDetectTarget
objFireItemEvent

need help with these 3 functions as their return isn't specified :
objClearidentified
objClearShowAsDestination
objDamage

[RPC]

Finally! Some functions that make sense
Here's the next 5, ready for review.
objFixParalysis
objGetArmorLevel
objGetDataField
objGetDefaultCurrency
objGetDeviceFireArc

[alterecco]

Looks good... I went over them and added/corrected some small things. I asked george about the syntax for objDamage, so hopefully we will be able to flesh that one out soon. Thanks for keeping this up!

[RPC]

Okay, 5 more done
objGetDevicePos
objGetDisposition
objGetEventHandler
objGetOpenDockingPortCount
objGetOverlayType

[RPC]

objGetType
objIncItemCharges
objIsAngryAt
objIsDeviceEnabled
objIsIdentified

[RPC]

objIsParalyzed
objMatches
objProgramDamage
objRegisterForSystemEvents
objRemoveItemEnhancement

[RPC]

objResume
objSetDeviceActivationDelay
objSetDeviceFireArc
objSetDevicePos
objSetIdentified

[alterecco]

Looks good. One question though. Did we find out the other day that position and firearc could be set outside of the OnInstall event? Did we actually test it with a weapon? I mention this because, in Georges 1.06 announcement, he states that they are to be used inside the OnInstall (it would be cool however if they could be used anywhere). I just figured we should clear up that point.