This is how to write to the presented specification:

1. Implement the algorithm in a single 32-bit Windows DLL with Pascal calling conventions (i.e. reading arguments from left to right, passing parameters via stack, with automatic stack cleaning upon return and uppercase identifiers).
2. DLL will be installed into a directory determined by SuperMemo 8 (standardly ALG, e.g. c:\sm8\alg\<name>.dll)
3. DLL should store its global data files in a single directory with the same name as the library itself and created by the DLL in the same directory in which the DLL had been installed (e.g. c:\sm8\alg\<name>\<data files>.*)
4. DLL should store its local data files (i.e. files pertaining to a given knowledge system) in the ALG\<name> subdirectory of the knowledge system. For example if the plug-in DLL is named sm2.dll and the knowledge system is called mysys then global files might be located in c:\sm8\alg\sm2\ directory while local files in c:\sm8\systems\mysys\alg\sm2\
5. SuperMemo 8 installs the DLL with the command Tools : Options : SuperMemo : Plug-In Algorithm : Install and effectively supplants the default Algorithm SM-8 (uninstallation with Tools : Options : SuperMemo : Plug-In Algorithm : Restore default)
6. Upon installing, the DLL's procedure Install(path:PChar) is be called (if defined). The path argument here indicates the directory in which the DLL is being installed (e.g. 'c:\sm8\alg' in the example mentioned above)
7. Optionally, the DLL can define procedure Description(var text:PChar) that makes it possible to shortly describe the plug-in. The description is used in Tools : Options : SuperMemo : Plug-In Algorithm to identify the currently installed plug-in.
8. Upon opening a new knowledge system a procedure Initialize is called with PChar parameter pointing to the path to the knowledge system files: Initialize(path:PChar). For example, if the system is c:\sm8\systems\mysys.kno then the value of PChar is 'c:\sm8\systems\mysys'.
9. Upon repetition the procedure Repetition is be called:

Repetition(ElementNumber:integer;Grade:0..5;var NewInterval:integer;commit:boolean)
where:
 
• ElementNumber - number of the element that has just been rehearsed
• integer - 32-bit unsigned integer
• Grade - integer denoting the grade the repeated element scored in the current repetition
• NewInterval - new interval in days to be used by the element (next repetition date is the current date plus NewInterval). Note that SuperMemo sets this value on input like it would otherwise be set by Algorithm SM-8! You can use this property for comparing your algorithm with the original SuperMemo algorithm.
• commit - indication if the repetition data should be committed or if the Cancel Grade option could yet be invoked
• boolean - 16-bit boolean variable (0 - false, 1 - true)
10. The procedure Repetition is obligatory and is called twice in the course of a single repetition:
 
• first with commit set to false after executing the repetition and generating a grade (e.g. with pressing Bright, Pass, etc.)
• second with commit set to true at the moment of committing the repetition (e.g. with Next Repetition, Stop, quitting the program, etc.)
11. The program feeds the DLL with the number of the repetition and the grade upon calling Repetition and in return obtains the new interval that indicates the date of the next repetition of the current element
12. Upon resetting the knowledge system, the procedure ResetAlgorithm is be called to delete the data related to the learning process. Note that this procedure is also called at the moment of installing the plug-in!
13. Upon closing the current knowledge system, the procedure Finalize is be called
14. Optionally the DLL can provide the procedure Statisticsfor presenting algorithm-specific statistics and parameters available with Tools : Statistics : Plug-in. The traditional statistics dialog box available from Tools : Statistics : Algorithm still provides access to all parameters that would otherwise be set by Algorithm SM-8 assuming the newly generated intervals were taken from the plug-in process!

More about the repetition scheduling plug-in:

1. For remarks and questions write to wozniak@supermemo.com.
2. For an exemplary source code see: SuperMemo 2 Plug-In Source Code (including an exemplary DLL).