Skip to main content
Skip table of contents

(v13) The functions and callback functions

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

The functions and callback functions can be found in the .c and .h files within \skinkit\export\ and \skinkit\src\ folders.

(v13) SwLeInitRuntime

This should be used when restarting the RIP. It initializes skinkit variables prior to starting the RIP.

(v13) SwLeSDKStart

This prepares the memory arena that the RIP uses, and initializes some support libraries.

(v13) SwLeSetRipRendererThreads

A call to this function is optional, and if called, it must be before the first call to SwLeMemInit() or SwLeStart() for a RIP instantiation.

(v13) SwLeMemInit

This is optional and initializes memory for the Harlequin Core, giving it a memory buffer of a given size to work in.

(v13) SwLeSetRasterCallbacks

Sets the callback functions that the RIP calls back to the skin.

(v13) SwLePgbSetCallback

Sets a callback function to determine what to do with blank pages omitted, trimmed, or detected by the RIP.

(v13) SwLeAddCustomDevices

Adds DEVICETYPE* objects to the array passed to the RIP during startup.

(v13) SwLeStart

This starts the RIP.

(v13) SwLeProcessInputQueue

SwLeProcessInputQueue processes one job from the skin's input queue. It encapsulates the sequence of SwLeSetJobNumber(), SwLeSetJobName(), SwLeJobStart(), SwLePS() and SwLeJobEnd() , providing a simpler interface.

(v13) SwLeJobStart

This prepares the RIP to accept the job.

(v13) SwLePS

This passes a buffer of PostScript language or PDF to the RIP. Global Graphics recommends using SwLeProcessInputQueue () instead of this function.

(v13) SwLeJobEnd

This tells the RIP that the current job has no more data.

(v13) SwLeStop

This function should only be called in between job boundaries. It submits a shutdown PostScript language job to the RIP, then waits for the RIP to exit.

(v13) SwLeSDKEnd

This should be called before SwLeShutdown() , before exiting the application. The RIP may be re-started without shutting down the SDK libraries if it can share the same memory configuration.

(v13) SwLeShutdown

Performs shutdown operations when the application exits.

These functions are detailed below, also see the file skinkit.h in the \skinkit\export\ folder.

All memory handling in skinkit should use the routines provided by mem.h, (that is, MemAlloc() and MemFree()). There are two separate groups of allocators: MemAlloc() means allocate memory within the skin's pool of RIP memory, and SysAlloc() means allocate the memory via the operating system, unless overriding functions are provided.

The MemRealloc() function is provided to assist in the integration of third-party libraries such as Expat, allowing their memory management to be wired up to the skin pool.

The job submission interface is primarily made up of the functions SwLeStart(), SwLeProcessInputQueue() and SwLeStop(). When these functions are used the RIP is started up on a separate thread.

A typical host application, which is reading or manufacturing a PostScript language stream, has the following structure (described here in pseudo code):

                        for ( <all different RIP instantiations or configurations> ) { SwLeSDKStart()
                        <any time after SwLeSDKStart, start adding jobs to the input queue with inputq_print_job()...>
                        <optionally initialise RIP memory, required if registering modules later> SwLeMemInit(...)
                        SwLeSetRasterCallbacks(...) SwLePgbSetCallback(...) SwLeAddCustomDevices(...)
                        <optionally register core modules and interfaces> SwRegisterCMM(...)
                        SwRegisterHTM(...) SwRegisterRDR(...) SwRegisterPFIN(...)
                        SwLeStart (...)
                        do {
                            switch ( SwLeProcessInputQueue() ) { case <no more jobs> do <terminate loop>
                            case <error in job> do <abnormal job action>
                            <post-job actions>
                        } while <not done> SwLeStop()

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.