home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / GFX / viewer / SVLIBS81.LHA / superview-lib / Programmers / Docs / SVObject_Ref_ENG.doc < prev    next >
Encoding:
Text File  |  1994-08-13  |  15.6 KB  |  830 lines
  1.  
  2.    $VER: SVObject_Ref_ENG.doc V2.2 (8.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.    * DO _NEVER_ ACCESS ANY SVOBJECTS DIRECTLY.
  15.    * DO NEVER BYPASS superview.library !
  16.  
  17.    THE FOLLOWING NOTES ARE ONLY FOR PROGRAMMERS OF SVOBJECTS :
  18.  
  19.    Here is a listing of the function set, which any of the version 1
  20.    and version 2 SVObjects does contain, in an Autodoc-like style of
  21.    description :
  22.  
  23.     SVO_AllocHandle        ; since Version 1
  24.     SVO_FreeHandle
  25.     SVO_Show
  26.     SVO_Write
  27.     SVO_CloseDisplay
  28.     SVO_FreeResources
  29.     SVO_SetAccessMode
  30.     SVL_SetScreenType
  31.     SVO_SetWindowFlags
  32.     SVO_SetWindowIDCMP
  33.     SVO_GetScreenAddress
  34.     SVO_GetWindowAddress
  35.     SVO_SetScreenAddress
  36.     SVO_SetWindowAddress
  37.     SVO_SetWriteName
  38.     SVO_SetReadName
  39.     SVO_FileInfoRequest
  40.     SVO_CheckFileType
  41.     SVO_ReadToGfxBuffer       ; since Version 2
  42.     SVO_GetGfxBuffer
  43.     SVO_SetGfxBuffer
  44.  
  45.  (you will never find any notes belonging to "BUGS", because any SVObject
  46.   may have its own ...)
  47.  
  48. -----------------------------------------------------------------------------
  49.    Functions available since Version 1 :
  50. -----------------------------------------------------------------------------
  51.  
  52.    NAME
  53.     SVO_AllocHandle
  54.  
  55.    SYNOPSIS
  56.  
  57.     APTR SVO_AllocHandle(APTR future)
  58.     D0   -$1e         A1
  59.  
  60.    FUNCTION
  61.  
  62.     Allocates a handle for accessing a Graphic via this SVObject.
  63.  
  64.    INPUT(S)
  65.  
  66.     future - always NULL yet
  67.  
  68.    RESULT
  69.  
  70.     A pointer to a new allocated Handle or NULL, if allocation failed.
  71.  
  72.    WARNING
  73.  
  74.     Test, if the result was NULL, or not !
  75.  
  76.    SINCE
  77.  
  78.     ... Version 1 SVObjects.
  79.  
  80.    SEE ALSO
  81.  
  82.     SVO_FreeResources, SVO_FreeHandle
  83.  
  84. -----------------------------------------------------------------------------
  85.  
  86.    NAME
  87.     SVO_FreeHandle
  88.  
  89.    SYNOPSIS
  90.  
  91.     VOID SVO_FreeHandle(APTR handle)
  92.     D0   -$24        A1
  93.  
  94.    FUNCTION
  95.  
  96.        Stops showing, frees all Resources and delocates a Handle, which has
  97.        been allocated with SVO_AllocHandle before.
  98.  
  99.  
  100.        For programmers of SVObjects :
  101.  
  102.        Note, that this function should call
  103.  
  104.       SVO_CloseDisplay(SVHandle);
  105.       SVO_FreeResources(SVHandle);
  106.  
  107.        always. Otherwise memory might be lost.
  108.  
  109.    INPUT(S)
  110.  
  111.     handle - a valid handle
  112.  
  113.    RESULT
  114.  
  115.     -
  116.  
  117.    SINCE
  118.  
  119.     ... Version 1 SVObjects.
  120.  
  121.    SEE ALSO
  122.  
  123.     SVO_AllocHandle, SVO_CloseDisplay, SVO_FreeResources
  124.  
  125. -----------------------------------------------------------------------------
  126.  
  127.    NAME
  128.     SVO_Show
  129.  
  130.    SYNOPSIS
  131.  
  132.     ULONG SVO_Show(APTR handle)
  133.     D0    -$2a     A1
  134.  
  135.    FUNCTION
  136.  
  137.     Loads and shows the Graphic described by a previously set FileName
  138.     or just shows the Graphic, if already been loaded.
  139.  
  140.     Showing can be stopped either via full delocation of the handle
  141.     or via Closing the Display with SVO_CloseDisplay.
  142.  
  143.    INPUT(S)
  144.  
  145.     handle     - a valid handle
  146.  
  147.    RESULT
  148.  
  149.     NULL or an adequate SVERR-Errorcode.
  150.  
  151.    SINCE
  152.  
  153.     ... Version 1 SVObjects.
  154.  
  155.    SEE ALSO
  156.  
  157.     SVO_AllocHandle, SVO_CloseDisplay, SVO_FreeHandle
  158.  
  159. -----------------------------------------------------------------------------
  160.  
  161.    NAME
  162.     SVO_Write
  163.  
  164.    SYNOPSIS
  165.  
  166.     ULONG SVO_Write(APTR handle)
  167.     D0    -$30    A1
  168.  
  169.    FUNCTION
  170.  
  171.     Writes the currently loaded (GfxBuffer) or displayed (Screen)
  172.     graphic into a file or onto any other medium, which has been
  173.     specified via the appropriate function calls before.
  174.  
  175.    INPUT(S)
  176.  
  177.     handle          - a valid handle
  178.  
  179.    RESULT
  180.  
  181.     NULL or an adequate SVERR-Errorcode.
  182.  
  183.    SINCE
  184.  
  185.     ... Version 1 SVObjects.
  186.  
  187.    SEE ALSO
  188.  
  189.  
  190.     SVO_AllocHandle, SVO_FreeHandle
  191.  
  192. -----------------------------------------------------------------------------
  193.  
  194.    NAME
  195.     SVO_CloseDisplay
  196.  
  197.    SYNOPSIS
  198.  
  199.     VOID SVO_CloseDisplay(APTR handle)
  200.     D0   -$36          A1
  201.  
  202.    FUNCTION
  203.  
  204.     Stops showing the Graphic, indentified by the handle.
  205.     The Display-Screen is closed, but no Resources are given free.
  206.  
  207.    INPUT(S)
  208.  
  209.     handle - a valid handle
  210.  
  211.    RESULT
  212.  
  213.     -
  214.  
  215.    SINCE
  216.  
  217.     ... Version 1 SVObjects.
  218.  
  219.    SEE ALSO
  220.  
  221.     SVO_FreeResources, SVO_FreeHandle
  222.  
  223. -----------------------------------------------------------------------------
  224.  
  225.    NAME
  226.     SVO_FreeResources
  227.  
  228.    SYNOPSIS
  229.  
  230.     VOID SVO_FreeResources(APTR handle)
  231.     D0   -$3c           A1
  232.  
  233.    FUNCTION
  234.  
  235.     Frees all resources belonging to the specific Graphic,
  236.     indentified by the handle, which are not needed to just show it.
  237.     The Display will not be closed.
  238.  
  239.     Note, that SVO_FileInfoRequest() will no longer work, then
  240.     ("No file loaded" or similar request appears).
  241.  
  242.    INPUT(S)
  243.  
  244.     handle - a valid handle
  245.  
  246.    RESULT
  247.  
  248.     -
  249.  
  250.    SINCE
  251.  
  252.     ... Version 1 SVObjects.
  253.  
  254.    SEE ALSO
  255.  
  256.     SVO_AllocHandle, SVO_CloseDisplay, SVO_FreeHandle
  257.  
  258. -----------------------------------------------------------------------------
  259.  
  260.    NAME
  261.     SVO_SetAccessMode
  262.  
  263.    SYNOPSIS
  264.  
  265.     ULONG SVO_SetAccessMode(APTR handle, ULONG mode)
  266.     D0    -$42        A1         D1
  267.  
  268.    FUNCTION
  269.  
  270.     Initializes a Handle e.g. for AmigaDOS access, so that the
  271.     separately specified AmigaDOS FileName will be used.
  272.     Another possibility is sometimes to initialize Handles
  273.     for ClipBoard Access (depending on the specific SVObject,
  274.     e.g. IFF-ILBM).
  275.  
  276.    INPUT(S)
  277.  
  278.     handle - a valid handle
  279.     mode   - one of the supported "medium" Flags
  280.  
  281.    RESULT
  282.  
  283.     NULL or an adequate SVERR-Errorcode.
  284.  
  285.    SINCE
  286.  
  287.     ... Version 1 SVObjects.
  288.  
  289.    SEE ALSO
  290.  
  291.     SVO_SetWriteName
  292.  
  293. -----------------------------------------------------------------------------
  294.  
  295.    NAME
  296.     SVL_SetScreenType
  297.  
  298.    SYNOPSIS
  299.  
  300.     ULONG SVL_SetScreenType(APTR handle, ULONG type, APTR future)
  301.     D0    -$48        A1        D1        A2
  302.  
  303.    FUNCTION
  304.  
  305.     Specifies, which ScreenType the Screen should have, on which the
  306.     graphic is to be displayed later.
  307.  
  308.     This statement may have no effect, if the SVObject uses external
  309.     drivers for displaying (e.g. EGS.svdriver will ignore this
  310.     setting more or less).
  311.  
  312.    INPUT(S)
  313.  
  314.     handle - a valid handle
  315.     type   - a ScreenType descriptor, like e.g. CUSTOMSCREEN
  316.     future - always NULL yet
  317.  
  318.    RESULT
  319.  
  320.     NULL or an adequate SVERR-Errorcode.
  321.  
  322.    SINCE
  323.  
  324.     ... Version 1 SVObjects.
  325.  
  326.    SEE ALSO
  327.  
  328.     SVO_GetScreenAddress
  329.  
  330. -----------------------------------------------------------------------------
  331.  
  332.    NAME
  333.     SVO_SetWindowFlags
  334.  
  335.    SYNOPSIS
  336.  
  337.     ULONG SVO_SetWindowFlags(APTR handle, ULONG flags, APTR future)
  338.     D0    -$4e         A1          D1       A2
  339.  
  340.    FUNCTION
  341.  
  342.     Specifies, which Flags the Window should have, on which the
  343.     graphic is to be displayed later.
  344.  
  345.     This statement may have no effect, if the SVObject uses external
  346.     drivers for displaying (e.g. EGS.svdriver will ignore this
  347.     setting more or less).
  348.  
  349.    INPUT(S)
  350.  
  351.     handle       - a valid handle
  352.     flags       - valid WindowFlags, like e.g. WFLG_BACKDROP
  353.     future       - always NULL yet
  354.  
  355.    RESULT
  356.  
  357.     NULL or an adequate SVERR-Errorcode.
  358.  
  359.    SINCE
  360.  
  361.     ... Version 1 SVObjects.
  362.  
  363.    SEE ALSO
  364.  
  365.     SVO_Write
  366.  
  367. -----------------------------------------------------------------------------
  368.  
  369.    NAME
  370.     SVO_SetWindowIDCMP
  371.  
  372.    SYNOPSIS
  373.  
  374.     ULONG SVO_SetWindowIDCMP(APTR handle, ULONG idcmp, APTR future)
  375.     D0    -$54         A1          D1       A2
  376.  
  377.    FUNCTION
  378.  
  379.     Specifies, which IDCMP the Window should have, on which the
  380.     graphic is to be displayed later.
  381.  
  382.     This statement may have no effect, if the SVObject uses external
  383.     drivers for displaying (e.g. EGS.svdriver will ignore this
  384.     setting more or less).
  385.  
  386.    INPUT(S)
  387.  
  388.     handle - a valid handle
  389.     idcmp  - a valid set of IDCMP-Flags
  390.     future - always NULL yet
  391.  
  392.    RESULT
  393.  
  394.     NULL or an adequate SVERR-Errorcode.
  395.  
  396.    SINCE
  397.  
  398.     ... Version 1 SVObjects.
  399.  
  400.    SEE ALSO
  401.  
  402.     SVO_Show
  403.  
  404. -----------------------------------------------------------------------------
  405.  
  406.    NAME
  407.     SVO_GetScreenAddress
  408.  
  409.    SYNOPSIS
  410.  
  411.     struct Screen *SVO_GetScreenAddress(APTR handle, future)
  412.     D0           -$5a            A1         A2
  413.  
  414.    FUNCTION
  415.  
  416.     While displaying, the Address of the DisplayScreen can be get
  417.     via this function.
  418.     See description there and example SourceCodes for more and
  419.     detailed information.
  420.  
  421.    INPUT(S)
  422.  
  423.     handle - a valid handle
  424.     future - always NULL yet
  425.  
  426.    RESULT
  427.  
  428.     A valid ScreenPointer or NULL.
  429.  
  430.    SINCE
  431.  
  432.     ... Version 1 SVObjects.
  433.  
  434.    SEE ALSO
  435.  
  436.     SVO_GetWindowAddress
  437.  
  438. -----------------------------------------------------------------------------
  439.  
  440.    NAME
  441.     SVO_GetWindowAddress
  442.  
  443.    SYNOPSIS
  444.  
  445.     struct Window *SVO_GetWindowAddress(APTR handle, future)
  446.     D0           -$60            A1         A2
  447.  
  448.    FUNCTION
  449.  
  450.     While displaying, the Address of the DisplayWindow can be get
  451.     via this function.
  452.     See description there and example SourceCodes for more and
  453.     detailed information.
  454.  
  455.    INPUT(S)
  456.  
  457.     handle - a valid handle
  458.     future - always NULL yet
  459.  
  460.    RESULT
  461.  
  462.     A valid WindowPointer or NULL.
  463.  
  464.    SINCE
  465.  
  466.     ... Version 1 SVObjects.
  467.  
  468.    SEE ALSO
  469.  
  470.     SVO_GetScreenAddress
  471.  
  472. -----------------------------------------------------------------------------
  473.  
  474.    NAME
  475.     SVO_SetScreenAddress
  476.  
  477.    SYNOPSIS
  478.  
  479.     ULONG SVO_SetScreenAddress(APTR handle, struct Screen *sc, APTR future)
  480.     D0    -$66           A1        A2           A3
  481.  
  482.    FUNCTION
  483.  
  484.     Sets the address of a Screen, which should be used as the Source
  485.     for the next write action.
  486.  
  487.     See description there and example SourceCodes for more and
  488.     detailed information.
  489.  
  490.    INPUT(S)
  491.  
  492.     handle - a valid handle
  493.     sc     - a valid ScreenPointer
  494.     future - always NULL yet
  495.  
  496.    RESULT
  497.  
  498.     NULL or an adequate SVERR-Errorcode.
  499.  
  500.    SINCE
  501.  
  502.     ... Version 1 SVObjects.
  503.  
  504.    SEE ALSO
  505.  
  506.     SVO_SetWindowAddress
  507.  
  508. -----------------------------------------------------------------------------
  509.  
  510.  
  511.    NAME
  512.     SVO_SetWindowAddress
  513.  
  514.    SYNOPSIS
  515.  
  516.     ULONG SVO_SetWindowAddress(APTR handle, struct Window *wi, APTR future)
  517.     D0    -$6c           A1        A2           A3
  518.  
  519.    FUNCTION
  520.  
  521.     Sets the address of a Window, which should be used as the Source
  522.     for the next write action.
  523.  
  524.     See description there and example SourceCodes for more and
  525.     detailed information.
  526.  
  527.    INPUT(S)
  528.  
  529.     handle - a valid handle
  530.     wi     - a valid WindowPointer
  531.     future - always NULL yet
  532.  
  533.    RESULT
  534.  
  535.     NULL or an adequate SVERR-Errorcode.
  536.  
  537.    SINCE
  538.  
  539.     ... Version 1 SVObjects.
  540.  
  541.    SEE ALSO
  542.  
  543.     SVO_SetScreenAddress
  544.  
  545. -----------------------------------------------------------------------------
  546.  
  547.    NAME
  548.     SVO_SetWriteName
  549.  
  550.    SYNOPSIS
  551.  
  552.     ULONG SVO_SetWriteName(APTR handle, UBYTE *name, APTR future)
  553.     D0    -$72           A1        A2         A3
  554.  
  555.    FUNCTION
  556.  
  557.     Sets a filename for the next write action.
  558.  
  559.    INPUT(S)
  560.  
  561.     handle - a valid handle
  562.     name   - a valid AmigaDOS FileName
  563.     future - always NULL yet
  564.  
  565.    RESULT
  566.  
  567.     NULL or an adequate SVERR-Errorcode.
  568.  
  569.    SINCE
  570.  
  571.     ... Version 1 SVObjects.
  572.  
  573.    SEE ALSO
  574.  
  575.     SVO_SetReadName
  576.  
  577. -----------------------------------------------------------------------------
  578.  
  579.    NAME
  580.     SVO_SetReadName
  581.  
  582.    SYNOPSIS
  583.  
  584.     ULONG SVO_SetReadName(APTR handle, UBYTE *name, APTR future)
  585.     D0    -$78          A1       A2        A3
  586.  
  587.    FUNCTION
  588.  
  589.     Sets a filename for the next read action.
  590.  
  591.    INPUT(S)
  592.  
  593.     handle - a valid handle
  594.     name   - a valid AmigaDOS FileName
  595.     future - always NULL yet
  596.  
  597.    RESULT
  598.  
  599.     NULL or an adequate SVERR-Errorcode.
  600.  
  601.    SINCE
  602.  
  603.     ... Version 1 SVObjects.
  604.  
  605.    SEE ALSO
  606.  
  607.     SVO_SetWriteName
  608.  
  609. -----------------------------------------------------------------------------
  610.  
  611.    NAME
  612.     SVO_FileInfoRequest
  613.  
  614.    SYNOPSIS
  615.  
  616.     ULONG SVO_FileInfoRequest(APTR handle, struct Window *window,
  617.     D0    -$7e          A1           A2
  618.  
  619.                   APTR future)
  620.                   A3
  621.  
  622.    FUNCTION
  623.  
  624.     Pops up an Info-Requester with more or less detailed information
  625.     on the currently loaded Graphic.
  626.     A window pointer may be given to select the place to pop it up.
  627.  
  628.     Note, that this function will fail, if you already called
  629.     SVO_FreeResources() (might result in a "No file loaded" message) !
  630.  
  631.    INPUT(S)
  632.  
  633.     handle - a valid handle
  634.     window - a valid Window Pointer or NULL
  635.     future - always NULL yet
  636.  
  637.    RESULT
  638.  
  639.     NULL or an adequate SVERR-Errorcode.
  640.  
  641.    SINCE
  642.  
  643.     ... Version 1 SVObjects.
  644.  
  645.    SEE ALSO
  646.  
  647.     -
  648.  
  649. -----------------------------------------------------------------------------
  650.  
  651.    NAME
  652.     SVO_CheckFileType
  653.  
  654.    SYNOPSIS
  655.  
  656.     ULONG SVO_CheckFileType(BPTR filehandle, UBYTE *filename,
  657.     D0    -$84        A1           A2
  658.  
  659.                 struct SVOCheckFile *svo_check)
  660.                 A3
  661.  
  662.    FUNCTION
  663.  
  664.     Checks, if the given file (or ClipBoard entry, or whatever)
  665.     fits to this SVObject and can be handled therein.
  666.  
  667.     Since Version 4 of superview.library ClipBoard-Support with
  668.     external SVObjects would not have worked at all.
  669.     Since V4 the specification of external Version 2 SVObjects
  670.     has been modified to allow ClipBoard and other media usage :
  671.     To preserve compatibility, this has been done by using the
  672.     "future" parameter as a pointer to a structure (defined in
  673.     "include:svobjects/svobjects.h"), which contains media
  674.     information.
  675.  
  676.     This pointer may be NULL, so that you have to assume default
  677.     settings, if there's not such a structure.
  678.     For disk-access, this pointer will not be set at all, anyway.
  679.  
  680.     Also be prepared, to handle NULL pointers to filename :
  681.     if ClipBoard usage is forced, there will no filename be needed.
  682.     If you don't support any filename-less medias, just do a silent
  683.     exit.
  684.     Currently - for compatibility reasons - superview.library will
  685.     supply a dummy filename and a dummy file for those SVObjects,
  686.     which may not handle a NULL pointer correctly.
  687.  
  688.     So handle SVOCheckFile structures with a HIGHER priority, because
  689.     currently there's always a dummy-file (mostly empty) available.
  690.  
  691.    INPUT(S)
  692.  
  693.     handle      - a valid handle
  694.     name      - a valid AmigaDOS FileName
  695.     svo_check - a pointer to a SVOCheckFile structure or NULL
  696.             for disk-access (default)
  697.  
  698.    RESULT
  699.  
  700.     NULL or an adequate SVERR-Errorcode.
  701.  
  702.    SINCE
  703.  
  704.     ... Version 1 SVObjects.
  705.  
  706.    SEE ALSO
  707.  
  708.     -
  709.  
  710. -----------------------------------------------------------------------------
  711.    Functions added with Version 2 :
  712. -----------------------------------------------------------------------------
  713.  
  714.    NAME
  715.     SVO_ReadToGfxBuffer
  716.  
  717.    SYNOPSIS
  718.  
  719.     ULONG SVO_ReadToGfxBuffer(APTR handle)
  720.     D0    -$8a          A1
  721.  
  722.    FUNCTION
  723.  
  724.     Does a read action to a GfxBuffer, using the current settings
  725.     for FileName and medium.
  726.  
  727.     This Buffer may be displayed via SVO_Show and/or exported
  728.     via SVO_GetGfxBuffer.
  729.  
  730.    INPUT(S)
  731.  
  732.     handle      - a valid handle
  733.  
  734.    RESULT
  735.  
  736.     NULL or an adequate SVERR-Errorcode.
  737.  
  738.    SINCE
  739.  
  740.     ... Version 2 SVObjects.
  741.  
  742.    SEE ALSO
  743.  
  744.     SVO_Show, SVO_GetGfxBuffer
  745.  
  746. -----------------------------------------------------------------------------
  747.  
  748.    NAME
  749.     SVO_GetGfxBuffer
  750.  
  751.    SYNOPSIS
  752.  
  753.     ULONG SVO_GetGfxBuffer(APTR handle, struct SV_GfxBuffer **buffer,
  754.     D0    -$90          A1        A2
  755.  
  756.                    ULONG future)
  757.                    A3
  758.  
  759.    FUNCTION
  760.  
  761.     Initializes a given pointer with the address to the GfxBuffer for
  762.     the currently loaded Graphic.
  763.  
  764.     This Buffer MUST NOT be given free by handle (use SVO_FreeHandle
  765.     or SVO_FreeResources on the main handle) and may still be
  766.     displayed via SVO_Show or saved anywhere else.
  767.  
  768.    INPUT(S)
  769.  
  770.     handle      - a valid handle
  771.     buffer      - a pointer to a SV_GfxBuffer pointer, which should be
  772.             initialized with a valid pointer
  773.     future      - always NULL yet
  774.  
  775.    RESULT
  776.  
  777.     NULL or an adequate SVERR-Errorcode.
  778.  
  779.    SINCE
  780.  
  781.     ... Version 2 SVObjects.
  782.  
  783.    SEE ALSO
  784.  
  785.     SVO_ReadToGfxBuffer, SVO_Show, SVO_SetGfxBuffer, SVO_Write
  786.  
  787. -----------------------------------------------------------------------------
  788.  
  789.    NAME
  790.     SVO_SetGfxBuffer
  791.  
  792.    SYNOPSIS
  793.  
  794.     ULONG SVO_SetGfxBuffer(APTR handle, struct SV_GfxBuffer *buffer,
  795.     D0    -$90          A1        A2
  796.  
  797.                    ULONG future)
  798.                    A3
  799.  
  800.    FUNCTION
  801.  
  802.     Initializes the given handle with a pointer to a SV_GfxBuffer, which
  803.     should be used for the next write action.
  804.  
  805.     This Buffer STILL HAS TO BE GIVEN FREE the way it has been allocated
  806.     (usually via a SVO_FreeHandle or SVO_FreeResources call with the
  807.     origin handle) and may still be displayed via SVO_Show or saved
  808.     anywhere else.
  809.  
  810.    INPUT(S)
  811.  
  812.     handle      - a valid handle
  813.     buffer      - a pointer to a SV_GfxBuffer pointer, which should be
  814.             used to initialize the handle for a write action
  815.     future      - always NULL yet
  816.  
  817.    RESULT
  818.  
  819.     NULL or an adequate SVERR-Errorcode.
  820.  
  821.    SINCE
  822.  
  823.     ... Version 2 SVObjects.
  824.  
  825.    SEE ALSO
  826.  
  827.     SVO_ReadToGfxBuffer, SVO_Show, SVO_GetGfxBuffer, SVO_Write
  828.  
  829. -----------------------------------------------------------------------------
  830.