(v13) Starting the Harlequin Core

This page applies to Harlequin v13.1r0 and later; and to Harlequin Core but not Harlequin MultiRIP

This chapter describes the functions provided by the core RIP library used by the skin kit to implement the wrapped RIP functionality described in previous sections. it is not necessary to read or understand this section.

The Harlequin Core RIP core is started by calling SwStart(). SwStart only returns in the case of serious errors; normal termination is by the Harlequin Core calling SkinExit().

SwStart is passed a pointer to an array of SWSTART structures. Each element contains one item of information that the Harlequin Core may need to start up properly, and consists of two fields: a tag field to identify what aspect of the Harlequin Core this element affects, and a value field, the meaning of which depends on the tag. If this is used as a pointer to a string, the string should be zero-terminated.

The last element (there must always be at least one) contains a tag SWEndTag ; the value of this one is ignored.

Defined in swstart.h :

                        typedef struct SWSTART { int32 tag;
                        union {
                          int32 int_value; void *pointer_value; float float_value;
                        } value ;
                      } SWSTART;