Differences

This shows you the differences between two versions of the page.

--- dcx:library_checks_and_execs [2015/11/13 14:06] – vic
+++ dcx:library_checks_and_execs [2026/06/22 12:21] (current) – external edit 127.0.0.1
@@ Line 7: / Line 7: @@
 ValueTypes: numeric, text, regime slot#, people slot#, sftype slot#, etc..
+These functions are really usefull when creating event libraries. As you can create libvars in the libvar tab of the advanced editor and allow end users of the Simple Editor to set their values. Then your scripts here can read the values set by the Simple Editor user.
 ==CheckLibVarCommander==
@@ Line 63: / Line 65: @@
 returns: value of libvar
-===Check the slot# of a specific library imported data instance===
+===Check the slot# or ID# of a specific library imported data instance===
+Your event library might be trying to access data of other libraries for example. Its best not to use these and use your own libvars to ask the Simple Editor user to supply whatever information you need.
+Like for example if you are writing a partisan event library you might want to have global or regime libvars asking the Simple Editor user to tell you the historical unit model to use when placing partisan units.
 ==CheckGetEventPic==
@@ Line 119: / Line 125: @@
 ===The following Execs are available:===
+==ExecSetLibVar==
+parameters: library name, variable name, variable value
+effect: changes or adds the variable
+==ExecSetHisLibVar==
+parameters: library name, historical unit slot#, variable name, variable value
+effect: changes or adds the historical libvar variable
+==ExecSetHexLibVar==
+parameters: library name, variable name, variable value
+NB: You need to call SetCardXY(x,y) to specify the hex you want to edit the libvar of.
+effect: changes or adds the historical libvar variable of the specified hex.
+==ExecAllFunctionByLibrary==
+parameters: library name, event name
+effect: executes stated event.
+NB: more safe than the ExecCallFunction which could pose a problems if end user would have loaded another event library using an event with exactly the same name.