home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / DeveloperDisk300794.lha / superplay-lib_3_1.LHA / superplay-lib / Programmers / Docs / SuperPlay_Ref_ENG.doc < prev   
Encoding:
Text File  |  1994-07-21  |  18.3 KB  |  840 lines
  1.  
  2.    $VER: SuperPlay_Ref_ENG.doc V3.1 (21.7.94)
  3.  
  4.    © 1994 by Andreas R. Kleinert. All rights reserved.
  5.  
  6.    - Feel free to translate this Doc-File into other languages. -
  7.  
  8.        Andreas R. Kleinert,
  9.        Grube Hohe Grethe 23,
  10.        D-57074 Siegen,
  11.        Germany.                        email : Fido 2:2457/345.10
  12.                                                (checked weekly)
  13.  
  14.    Request at least :  V2+    for bug-fixed ClipBoard-Support
  15.                               with the supplied SPObjects
  16.                        V3+    for a working combination of
  17.                               SVL_SetSampleList() and SuperWrite() calls
  18.  
  19.    Here is a listing of all currently available functions of the
  20.    superview.library in an Autodoc-like style of description :
  21.  
  22.         SPL_AllocHandle            ; since Version 1
  23.         SPL_FreeHandle
  24.         SPL_StopReplay
  25.         SPL_FreeResources
  26.         SPL_SuperPlay
  27.         SPL_SuperWrite
  28.         SPL_InitHandleAsDOS
  29.         SPL_InitHandleAsClip
  30.         SPL_SetWriteType
  31.         SPL_GetErrorString
  32.         SPL_SetWriteName
  33.         SPL_FileInfoRequest
  34.         SPL_SetReqIOWindow
  35.         SPL_ReadPlayData
  36.         SPL_ContinueReplay
  37.         SPL_FastForward
  38.         SPL_FastBackward
  39.         SPL_GetSampleList          ; since Version 2
  40.         SPL_SetSampleList
  41.                    ; no functions added in Version 3
  42.  
  43. -----------------------------------------------------------------------------
  44.    Functions available since Version 1 :
  45. -----------------------------------------------------------------------------
  46.  
  47.    NAME
  48.         SPL_AllocHandle
  49.  
  50.    SYNOPSIS
  51.  
  52.         APTR SPL_AllocHandle(APTR future)
  53.         D0   -$1e            A1
  54.  
  55.    FUNCTION
  56.  
  57.         Allocates a handle for accessing a Sample/Module via SPObjects.
  58.  
  59.    INPUT(S)
  60.  
  61.         future - always NULL yet
  62.  
  63.    RESULT
  64.  
  65.         A pointer to a new allocated Handle or NULL, if allocation failed.
  66.  
  67.    WARNING
  68.  
  69.         Test, if the result was NULL, or not !
  70.  
  71.    BUGS
  72.  
  73.         -
  74.  
  75.    SINCE
  76.  
  77.         ... version 1 of the superplay.library.
  78.  
  79.    SEE ALSO
  80.  
  81.         SPL_FreeResources, SPL_FreeHandle
  82.  
  83. -----------------------------------------------------------------------------
  84.  
  85.    NAME
  86.         SPL_FreeHandle
  87.  
  88.    SYNOPSIS
  89.  
  90.         VOID SPL_FreeHandle(APTR handle)
  91.         D0   -$24           A1
  92.  
  93.    FUNCTION
  94.  
  95.        Stops playing, frees all Resources and delocates a Handle, which has
  96.        been allocated with SPL_AllocHandle before.
  97.  
  98.    INPUT(S)
  99.  
  100.         handle - a valid handle
  101.  
  102.    RESULT
  103.  
  104.         -
  105.  
  106.    BUGS
  107.  
  108.         -
  109.  
  110.    SINCE
  111.  
  112.         ... version 1 of the superplay.library.
  113.  
  114.    SEE ALSO
  115.  
  116.         SPL_AllocHandle, SPL_StopReplay, SPL_FreeResources
  117.  
  118. -----------------------------------------------------------------------------
  119.  
  120.    NAME
  121.         SPL_StopReplay
  122.  
  123.    SYNOPSIS
  124.  
  125.         VOID SPL_StopReplay(APTR handle)
  126.         D0   -$2a           A1
  127.  
  128.    FUNCTION
  129.  
  130.         Stops playing the Sample/Module, indentified by the handle.
  131.         Some SPObjects support to continue the Sample/Module with
  132.         SPL_ContinueReplay after calling SPL_StopReplay.
  133.  
  134.    INPUT(S)
  135.  
  136.         handle - a valid handle
  137.  
  138.    RESULT
  139.  
  140.         -
  141.  
  142.    BUGS
  143.  
  144.         -
  145.  
  146.    SINCE
  147.  
  148.         ... version 1 of the superplay.library.
  149.  
  150.    SEE ALSO
  151.  
  152.         SPL_ContinueReplay, SPL_FreeResources, SPL_FreeHandle
  153.  
  154. -----------------------------------------------------------------------------
  155.  
  156.    NAME
  157.         SPL_FreeResources
  158.  
  159.    SYNOPSIS
  160.  
  161.         VOID SPL_FreeResources(APTR handle)
  162.         D0   -$30              A1
  163.  
  164.    FUNCTION
  165.  
  166.         Frees all resources belonging to the specific Sample/Module,
  167.         indentified by the handle, which are not needed to just replay it.
  168.         Playing of the Sample/Module is not stopped and/or interrupted.
  169.  
  170.    INPUT(S)
  171.  
  172.         handle - a valid handle
  173.  
  174.    RESULT
  175.  
  176.         -
  177.  
  178.    BUGS
  179.  
  180.         -
  181.  
  182.    SINCE
  183.  
  184.         ... version 1 of the superplay.library.
  185.  
  186.    SEE ALSO
  187.  
  188.         SPL_AllocHandle, SPL_StopReplay, SPL_FreeHandle
  189.  
  190. -----------------------------------------------------------------------------
  191.  
  192.    NAME
  193.         SPL_SuperPlay
  194.  
  195.    SYNOPSIS
  196.  
  197.         ULONG SPL_SuperPlay(APTR handle, char *filename)
  198.         D0    -$36          A1           A2
  199.  
  200.    FUNCTION
  201.  
  202.         Loads and plays the Sample/Module described by FileName.
  203.         The handle is initialized and the fitting SPObject is opened
  204.         and accessed for replaying the Sample/Module.
  205.  
  206.         Playing can be stopped either via full delocation of the handle
  207.         or temporal interruption with SPL_StopReplay.
  208.  
  209.    INPUT(S)
  210.  
  211.         handle   - a valid handle
  212.         filename - a valid AmigaDOS FilePath and -Name
  213.  
  214.    RESULT
  215.  
  216.         NULL or an adequate SPERR-Errorcode.
  217.  
  218.    BUGS
  219.  
  220.         -
  221.  
  222.    SINCE
  223.  
  224.         ... version 1 of the superplay.library.
  225.  
  226.    SEE ALSO
  227.  
  228.         SPL_AllocHandle, SPL_StopReplay, SPL_ContinueReplay,
  229.         SPL_FastForward, SPL_FastBackward, SPL_FreeHandle
  230.  
  231. -----------------------------------------------------------------------------
  232.  
  233.    NAME
  234.         SPL_SuperWrite
  235.  
  236.    SYNOPSIS
  237.  
  238.         ULONG SPL_SuperWrite(APTR handle, APTR source_handle)
  239.         D0    -$3c           A1           A2
  240.  
  241.    FUNCTION
  242.  
  243.         Usually a Sample/Module is loaded AND played via SPL_SuperPlay :
  244.         No separate reading and playing calls are done.
  245.  
  246.         For writing - that means : converting - a Sample/Module, you
  247.         have to use the following order :
  248.  
  249.         source_handle = SPL_AllocHandle(N);
  250.         result        = SPL_ReadPlayData(source_handle, source_name);
  251.         dest_handle   = SPL_AllocHandle(N);
  252.         /* result     = SPL_InitHandleAsDOS(dest_handle, N); */ /* default */
  253.         result        = SPL_SetWriteName(dest_handle, dest_name, N);
  254.         result        = SPL_SetWriteType(dest_handle, dest_type, N);
  255.         result        = SPL_SuperWrite(dest_handle, source_handle);
  256.         SPL_FreeHandle(dest_handle);
  257.         SPL_FreeHandle(source_handle);
  258.  
  259.  
  260.         Also : Check the "result" value AFTER EACH function call (see
  261.                Example SourceCodes) !
  262.  
  263.         All available values for dest_type can be found in the specific
  264.         SPOBject-List in the SuperPlayBase.
  265.         The values WILL change with every re-initialization of
  266.         superplay.library, so update them with every new opening !
  267.  
  268.         *** NEW FEATURE : ***
  269.  
  270.         This functions acts different in Versions >= 2 :
  271.  
  272.         1) If "source_handle" is NULL,
  273.            it is checked, whether a SampleList has been set via
  274.            "SPL_SetSampleList()", and then this SampleList is completely
  275.            saved.
  276.  
  277.            ELSE
  278.  
  279.         2) a) If a Version 1 SPObject is the Source, the old behaviour
  280.               takes place.
  281.            b) If a Version 2 SPObject takes place, the new SampleList
  282.               functions are supported (and completely saved).
  283.  
  284.         So, what's new ? Well, if you've any self-created SampleLists,
  285.         you now can save them by just setting them via SPL_SetSampleList()
  286.         and then calling SPL_SuperWrite() with NULL parameter for the
  287.         Source-SPObject handle.
  288.  
  289.  
  290.         It is suggested to use the old style for converting between
  291.         FileFormats and the new style for saving single (self-created)
  292.         SampleLists.
  293.  
  294.    INPUT(S)
  295.  
  296.         handle        - a valid handle        (used for Write Access)
  297.         source_handle - an other valid handle (used for Read Access)
  298.                         (may be NULL for V2+ SPObjects)
  299.  
  300.    RESULT
  301.  
  302.         NULL or an adequate SPERR-Errorcode.
  303.  
  304.    BUGS
  305.  
  306.         Not a bug, but a limitation in V2.1 :
  307.         The new SampleList feature (NULL as parameter) was first
  308.         introduced with the V2.2 release's SPObjects and Library.
  309.  
  310.    SINCE
  311.  
  312.         ... version 1 of the superplay.library.
  313.  
  314.    SEE ALSO
  315.  
  316.  
  317.  
  318.         SPL_AllocHandle, SPL_ReadPlayData, SPL_FreeHandle
  319.  
  320. -----------------------------------------------------------------------------
  321.  
  322.    NAME
  323.         SPL_InitHandleAsDOS
  324.  
  325.    SYNOPSIS
  326.  
  327.         ULONG SPL_InitHandleAsDOS(APTR handle, APTR future)
  328.         D0    -$42                A1           A2
  329.  
  330.    FUNCTION
  331.  
  332.         Initializes a Handle for AmigaDOS access, so that the given
  333.         AmigaDOS FileNames are used.
  334.         Another possibility is sometimes to initialize Handles
  335.         for ClipBoard Access (depending on the specific SPObject,
  336.         e.g. IFF-8SVX).
  337.  
  338.    INPUT(S)
  339.  
  340.         handle - a valid handle
  341.         future - always NULL yet
  342.  
  343.  
  344.    RESULT
  345.  
  346.         NULL or an adequate SPERR-Errorcode.
  347.  
  348.    BUGS
  349.  
  350.         During V1.1 upto V1.6 this was done automatically ALWAYS.
  351.         This was fixed in V2.1
  352.         See BUGS under SPL_InitHandleAsClip.
  353.  
  354.    SINCE
  355.  
  356.         ... version 1 of the superplay.library.
  357.  
  358.    SEE ALSO
  359.  
  360.  
  361.  
  362.         SPL_InitHandleAsClip
  363.  
  364. -----------------------------------------------------------------------------
  365.  
  366.    NAME
  367.         SPL_InitHandleAsClip
  368.  
  369.    SYNOPSIS
  370.  
  371.         ULONG SPL_InitHandleAsClip(APTR handle, APTR future)
  372.         D0    -$48                 A1           A2
  373.  
  374.    FUNCTION
  375.  
  376.         Initializes a Handle for ClipBoard access, so that the (possibly)
  377.         given AmigaDOS FileNames are ignored.
  378.         The nearly always used possibility is to initialize Handles
  379.         for AmigaDOS Access (supported by ALL SPObjects).
  380.  
  381.    INPUT(S)
  382.  
  383.         handle - a valid handle
  384.         future - always NULL yet
  385.  
  386.  
  387.    RESULT
  388.  
  389.         NULL or an adequate SPERR-Errorcode.
  390.  
  391.    BUGS
  392.  
  393.         From 1.1 to 1.6 this function-call was useless, since
  394.         superview.library blocked all medias other than
  395.         SPO_MEDIUM_DISK for external SPObjects :
  396.         For reading calls, this resulted in a "file not found" message
  397.         from superplay.library, for writing calls, this resulted in an
  398.         empty filename string, which caused the SPObject to reject the
  399.         disk access (other accesses were not set correctly).
  400.         This was fixed in 2.1, by using the SPO_SetAccessMode() function
  401.         with the right parameters now and by using the "future" parameter
  402.         of SPO_CheckFileType() - only when using other media than
  403.         SPO_MEDIUM_DISK - as a pointer to an additional SPOCheckFileInfo
  404.         structure now.
  405.         This is 100% compatible, since superplay.library has always set
  406.         this value to NULL, so that older SPObjects will simply ignore
  407.         this pointer and newer versions will only interpret it, if it's
  408.         not NULL.
  409.  
  410.    SINCE
  411.  
  412.         ... version 1 of the superplay.library. (request V2+)
  413.  
  414.    SEE ALSO
  415.  
  416.         SPL_InitHandleAsDOS
  417.  
  418. -----------------------------------------------------------------------------
  419.  
  420.    NAME
  421.         SPL_SetWriteType
  422.  
  423.    SYNOPSIS
  424.  
  425.         ULONG SPL_SetWriteType(APTR handle, ULONG write_type, APTR future)
  426.         D0    -$4e             A1           A2                A3
  427.  
  428.    FUNCTION
  429.  
  430.         Sets the write_type for a SPL_SuperWrite() call.
  431.         See description there and example SourceCodes for more and
  432.         detailed information.
  433.  
  434.    INPUT(S)
  435.  
  436.         handle     - a valid handle
  437.         write_type - a valid temporary write_type code form the SPObject List
  438.         future     - always NULL yet
  439.  
  440.  
  441.    RESULT
  442.  
  443.         NULL or an adequate SPERR-Errorcode.
  444.  
  445.    BUGS
  446.  
  447.         -
  448.  
  449.    SINCE
  450.  
  451.         ... version 1 of the superplay.library.
  452.  
  453.    SEE ALSO
  454.  
  455.         SPL_SuperWrite
  456.  
  457. -----------------------------------------------------------------------------
  458.  
  459.    NAME
  460.         SPL_GetErrorString
  461.  
  462.    SYNOPSIS
  463.  
  464.         char * SPL_GetErrorString(ULONG error_code)
  465.         D0    -$54                A1
  466.  
  467.    FUNCTION
  468.  
  469.         Returns the Error Message for a specific Error Code, returned
  470.         by any function of the superplay.library.
  471.  
  472.    INPUT(S)
  473.  
  474.         error_code - any SPERR Error Code
  475.  
  476.    RESULT
  477.  
  478.         read-only pointer to a SPERR Error String
  479.  
  480.    BUGS
  481.  
  482.         -
  483.  
  484.    SINCE
  485.  
  486.         ... version 1 of the superplay.library.
  487.  
  488.    SEE ALSO
  489.  
  490.         -
  491.  
  492. -----------------------------------------------------------------------------
  493.  
  494.    NAME
  495.         SPL_SetWriteName
  496.  
  497.    SYNOPSIS
  498.  
  499.         ULONG SPL_SetWriteNameClip(APTR handle, ULONG write_name, APTR future)
  500.         D0    -$5a                 A1           A2                A3
  501.  
  502.    FUNCTION
  503.  
  504.         Sets the write_name for a SPL_SuperWrite() call.
  505.         See description there and example SourceCodes for more and
  506.         detailed information.
  507.  
  508.    INPUT(S)
  509.  
  510.         handle     - a valid handle
  511.         write_name - a valid AmigaDOS FilePath and -Name description
  512.         future     - always NULL yet
  513.  
  514.  
  515.    RESULT
  516.  
  517.         NULL or an adequate SPERR-Errorcode.
  518.  
  519.    BUGS
  520.  
  521.         -
  522.  
  523.    SINCE
  524.  
  525.         ... version 1 of the superplay.library.
  526.  
  527.    SEE ALSO
  528.  
  529.         SPL_SuperWrite
  530.  
  531. -----------------------------------------------------------------------------
  532.  
  533.    NAME
  534.         SPL_FileInfoRequest
  535.  
  536.    SYNOPSIS
  537.  
  538.         ULONG SPL_FileInfoRequest(APTR handle, struct Window *window,
  539.         D0    -$60                A1           A2
  540.  
  541.                                   APTR future)
  542.                                   A3
  543.  
  544.    FUNCTION
  545.  
  546.         Pops up an Info-Requester with more or less detailed information
  547.         on the currently loaded Sample/Module.
  548.         A window pointer may be given to select the place to pop it up.
  549.  
  550.    INPUT(S)
  551.  
  552.         handle - a valid handle
  553.         window - a valid Window Pointer or NULL
  554.         future - always NULL yet
  555.  
  556.  
  557.    RESULT
  558.  
  559.         NULL or an adequate SPERR-Errorcode.
  560.  
  561.    BUGS
  562.  
  563.         -
  564.  
  565.    SINCE
  566.  
  567.         ... version 1 of the superplay.library.
  568.  
  569.    SEE ALSO
  570.  
  571.         SPL_SetReqIOWindow
  572.  
  573. -----------------------------------------------------------------------------
  574.  
  575.    NAME
  576.         SPL_SetReqIOWindow
  577.  
  578.    SYNOPSIS
  579.  
  580.         ULONG SPL_SetReqIOWindow(APTR handle, struct Window *window)
  581.         D0    -$66               A1           A2
  582.  
  583.    FUNCTION
  584.  
  585.         Sets a new Default-Window (default : IntuitionBase->FirstWindow)
  586.         for any Requester IO.
  587.  
  588.    INPUT(S)
  589.  
  590.         handle - a valid handle
  591.         window - a valid Window Pointer or NULL
  592.  
  593.    RESULT
  594.  
  595.         NULL or an adequate SPERR-Errorcode.
  596.  
  597.    BUGS
  598.  
  599.         -
  600.  
  601.    SINCE
  602.  
  603.         ... version 1 of the superplay.library.
  604.  
  605.    SEE ALSO
  606.  
  607.         SPL_FileInfoReq
  608.  
  609. -----------------------------------------------------------------------------
  610.  
  611.    NAME
  612.         SPL_ReadPlayData
  613.  
  614.    SYNOPSIS
  615.  
  616.         ULONG SPL_ReadPlayData(APTR handle, char *filename)
  617.         D0    -$6c             A1           A2
  618.  
  619.    FUNCTION
  620.  
  621.         Loads but NOT plays the data of the Sample/Module described by
  622.         FileName.
  623.         The handle is initialized and the fitting SPObject is opened
  624.         to access the Sample/Module data for use with SPL_SuperWrite.
  625.  
  626.    INPUT(S)
  627.  
  628.         handle   - a valid handle
  629.         filename - a valid AmigaDOS FilePath and -Name
  630.  
  631.    RESULT
  632.  
  633.         NULL or an adequate SPERR-Errorcode.
  634.  
  635.    BUGS
  636.  
  637.         -
  638.  
  639.    SINCE
  640.  
  641.         ... version 1 of the superplay.library.
  642.  
  643.    SEE ALSO
  644.  
  645.         SPL_SetWriteName, SPL_SetWriteType, SPL_SuperWrite
  646.  
  647. -----------------------------------------------------------------------------
  648.  
  649.    NAME
  650.         SPL_ContinueReplay
  651.  
  652.    SYNOPSIS
  653.  
  654.         ULONG SPL_ContinueReplay(APTR handle)
  655.         D0    -$72               A1
  656.  
  657.    FUNCTION
  658.  
  659.         Some SPObjects support to continue a Sample/Module which
  660.         has been stopped by calling SPL_StopReplay.
  661.  
  662.    INPUT(S)
  663.  
  664.         handle - a valid handle
  665.  
  666.    RESULT
  667.  
  668.         NULL or an adequate SPERR-Errorcode.
  669.  
  670.    BUGS
  671.  
  672.         -
  673.  
  674.    SINCE
  675.  
  676.         ... version 1 of the superplay.library.
  677.  
  678.    SEE ALSO
  679.  
  680.         SPL_SuperPlay, SPL_StopReplay
  681.  
  682. -----------------------------------------------------------------------------
  683.  
  684.    NAME
  685.         SPL_FastForward
  686.  
  687.    SYNOPSIS
  688.  
  689.         ULONG SPL_FastForward(APTR handle)
  690.         D0    -$78            A1
  691.  
  692.    FUNCTION
  693.  
  694.         Some SPObjects might support a "cassette recorder"-like way
  695.         to browse trough a Sample/Module via FastForward and Rewind.
  696.  
  697.    INPUT(S)
  698.  
  699.         handle - a valid handle
  700.  
  701.    RESULT
  702.  
  703.         NULL or an adequate SPERR-Errorcode.
  704.  
  705.    BUGS
  706.  
  707.         -
  708.  
  709.    SINCE
  710.  
  711.         ... version 1 of the superplay.library.
  712.  
  713.    SEE ALSO
  714.  
  715.         SPL_FastBackward
  716.  
  717. -----------------------------------------------------------------------------
  718.  
  719.    NAME
  720.         SPL_FastBackward
  721.  
  722.    SYNOPSIS
  723.  
  724.         ULONG SPL_FastBackward(APTR handle)
  725.         D0    -$7e            A1
  726.  
  727.    FUNCTION
  728.  
  729.         Some SPObjects might support a "cassette recorder"-like way
  730.         to browse trough a Sample/Module via FastForward and Rewind.
  731.  
  732.    INPUT(S)
  733.  
  734.         handle - a valid handle
  735.  
  736.    RESULT
  737.  
  738.         NULL or an adequate SPERR-Errorcode.
  739.  
  740.    BUGS
  741.  
  742.         -
  743.  
  744.    SINCE
  745.  
  746.         ... version 1 of the superplay.library.
  747.  
  748.    SEE ALSO
  749.  
  750.         SPL_FastForward
  751.  
  752. -----------------------------------------------------------------------------
  753.    Functions added with Version 2 :
  754. -----------------------------------------------------------------------------
  755.  
  756.    NAME
  757.         SPL_GetSampleList
  758.  
  759.    SYNOPSIS
  760.  
  761.         ULONG SPL_GetSampleList(APTR handle, struct SPO_SampleList **list)
  762.         D0    -$84              A1           A2
  763.  
  764.    FUNCTION
  765.  
  766.         While/after loading a Sample-File Version 2 SPObjects might create
  767.         a special list of all Samples, which appear in the File.
  768.         This will usually be one one Sample for SampleFiles, but many more
  769.         for ModuleFiles.
  770.  
  771.         Not all SPObjects, especially not all ModuleType-SPObjects,
  772.         may support this and will return an error value or an empty list.
  773.  
  774.    INPUT(S)
  775.  
  776.         handle - a valid handle
  777.         list   - a pointer to a SPO_SampleList pointer
  778.  
  779.    RESULT
  780.  
  781.         NULL or an adequate SPERR-Errorcode.
  782.  
  783.    BUGS
  784.  
  785.         -
  786.  
  787.    SINCE
  788.  
  789.         ... version 2 of the superplay.library.
  790.  
  791.    SEE ALSO
  792.  
  793.         SPL_SetSampleList
  794.  
  795. -----------------------------------------------------------------------------
  796.  
  797.    NAME
  798.         SPL_SetSampleList
  799.  
  800.    SYNOPSIS
  801.  
  802.         ULONG SPL_SetSampleList(APTR handle, struct SPO_SampleList *list)
  803.         D0    -$8a              A1           A2
  804.  
  805.    FUNCTION
  806.  
  807.         For saving Sample-Files with Version 2 SPObjects, there may be used
  808.         a special list of all Samples, which should appear in the File.
  809.  
  810.         This will usually be one one Sample for SampleFiles, but many more
  811.         for ModuleFiles.
  812.  
  813.         Not all SPObjects, especially not all ModuleType-SPObjects,
  814.         may support this and can return SPERR_ACTION_NOT_SUPPORTED.
  815.  
  816.    INPUT(S)
  817.  
  818.         handle - a valid handle
  819.         list   - a pointer to a SPO_SampleList
  820.  
  821.    RESULT
  822.  
  823.         NULL or an adequate SPERR-Errorcode.
  824.  
  825.    BUGS
  826.  
  827.         Does not work in V2, because SuperWrite() cannot handle
  828.         NULL values for "source_handle", which should indicate, that
  829.         a SampleList has been set.
  830.  
  831.    SINCE
  832.  
  833.         ... version 2 of the superplay.library (request V3+).
  834.  
  835.    SEE ALSO
  836.  
  837.         SPL_GetSampleList
  838.  
  839. -----------------------------------------------------------------------------
  840.