                    ---------------=====-------------

                             Unpack.svobject
                    ENGLISH and SPANISH documentation

                    ---------------=====-------------

  [ENGLISH]

  Unpack.svobject

  © 1994-97 by Andreas R. Kleinert.

  FREEWARE. All rights reserved.

  Version      : 4.6
  Release Date : 24.06.1997


  Disclaimer
  ~~~~~~~~~~
  The author takes no responsibility for any results of the use of this
  program.
  This software is provided "AS IS" and there is no warranty of any kind,
  so that you use this software at your own risk.

  Foreign Copyrights and Credits
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  The "xpkmaster.library" (part of the useful Xpk package, which can be
  found on Aminet) is developed under the concept of the GNU license by
  its authors (c/o Dirk Stöcker, stoecker@rcs.urz.tu-dresden.de).
  This freely distributable Library is needed by Unpack.svobject, to read
  and decode XPK-packed files.

  Some of the mentioned names or products in this document may be
  copyrighted by companies or trademarks of companies.

  Requirements
  ~~~~~~~~~~~~
  - appropriate SuperView-Library environment
  - xpkmaster.library V2+

  Description
  ~~~~~~~~~~~
  Unpack.svobject is an external Library-Module for the superview.library.

  I supports reading of XPK-packed files and will re-parse these through
  superview.library by creating an temporary, unpacked file at the location
  "VMEM:" and then retries the specific operation on the file.

  So this is just a Dummy-SVObject which does for you the work of
  unpacking graphics files before displaying them.

  Writing (packing) of files is not possible (yet).

  Remarks
  ~~~~~~~
  * VMEM:
  * Temporary data will be written to a directory assigned to "VMEM:".

  * Compatibility:
  * This SVObject is just thought to make your life easier, if you've
    to handle many packed files, which you don't want to unpack each time
    you want to display them.
    Nevertheless it is recommended instead to work with unpacked files,
    wherever possible.
    If you wish to pack files with PP20 or XPK, please use SuperView's
    own SVG file format for this instead.

  History
  ~~~~~~~
  V4.6 (24.06.1997) :

   - fixed "memory loss on LibInit failure" bug

  V4.5 (01.01.1997) :

   - forgot updating these docs
   - added new note about Xpk
   - no longer directly supports powerpacker.library
     (use Xpk plus powerpacker.library instead, please)
   - recompiled with new headers
   - and more

  V4.4 (29.12.1996) :

   - various things cleaned up

  V4.3 (17.11.1996) :

   - recompiled with SAS/C V6.57

  V4.2 (27.08.1996) :

   - now has new disk read/write flags set
   - V4.1 did contain wrong docs (V3.6)

  V4.1 (06.08.1996) :

   - now uses/requires semaphore system of superview.library V14+
   - now correcly handles SVOCheckFile

****************************************************************************
* Revision history entries before V4.1 have been deleted for space reasons *
****************************************************************************

                    ---------------=====-------------

  [ESPAÑOL]

  Unpack.svobject

  © 1994-97 de Andreas R. Kleinert.

  DE LIBRE/GRATUITA DISTRIBUCIÓN. Todos los derechos reservados.

  Versión               : 4.6
  Fecha del lanzamiento : 24.06.1997


  Garantías/responsabilidades
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  El  autor no asume responsabilidad alguna por los resultados/efectos de
  este  programa  que  se  suministra  "TAL  CUAL",  de manera que no hay
  ninguna  garantía implícita o explícita:  usted asume todos los riesgos
  de su uso.

  Derechos de autor de terceros y créditos
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  La  biblioteca  "xpkmaster.library"  (que  forma parte del útil paquete
  Xpk,  que puede encontrar en Aminet) está desarrollado bajo el concepto
  de  licencia  GNU  por  sus  autores  (actualmente  está  a cargo de su
  desarrollo   Dirk   Stöcker   <stoecker@rcs.urz.tu-dresden.de>).   Esta
  biblioteca  de  libre distribución es necesaria para utilizar el módulo
  Unpack.svobject  y  así  poder leer y descodificar ficheros comprimidos
  con XPK.

  Algunos  de los nombre o producots mencionados en este documento pueden
  estar registrados o pertenecer legalmente a compañías.

  Requerimientos
  ~~~~~~~~~~~~~~
  - biblioteca SuperView correctamente instalada.
  - biblioteca "xpkmaster.library" versión 2 o superior.

  Descripción
  ~~~~~~~~~~~
                 "Unpack.svobject" es un módulo externo
                  de la biblioteca "superview.library".

  Soporta  la  lectura  de  ficheros  comprimidos  con  XPK y es capaz de
  procesarlos  creando  un fichero  descomprimido y temporal en la unidad
  asignable  "VMEM:", para a continuación volver a intentar procesar éste
  según  la  operación específica solicitada.  Resumiendo, es tan sólo un
  falso  objeto SV que le permite descomprimir ficheros gráficos antes de
  visualizarlos.

  La escritura (empaquetado) de ficheros (aún) no es posible.

  Notas
  ~~~~~
  * VMEM:
  * Los datos temporales serán escritos
    en el directorio asignable "VMEM:".

  * Compatibilidad:
  * Este  objeto  SV le hará la vida más fácil, si desea manejar ficheros
    comprimidos,  al  evitarle tener que descomprimirlos previamente cada
    vez  que  desee  visualizarlos.   Aún así, se recomienda trabajar con
    ficheros  sin  comprimir siempre que sea posible:  si desea comprimir
    los  ficheros  con PP20 o XPK, utilice por favor el formato SVG en su
    lugar.

  Historia
  ~~~~~~~~
  4.6 (24.06.1997) :

   - corregido error de pérdida de
     memoria al fallar la iniciación de biblioteca.

  4.5 (01.01.1997) :

   - se me olvidó actualizar esta documentación.
   - añadida nueva nota sobre Xpk.
   - ya no se soporta la bilbioteca "powerpacker.library" directamente
     (utilice Xpk junto con "powerpacker.library", por favor).
   - vuelto a compilar con nuevos ficheros de cabecera.
   - ...

  4.4 (29.12.1996) :

   - mejoras varias.

  4.3 (17.11.1996) :

   - vuelto a compilar con SAS/C V6.57

  4.2 (27.08.1996) :

   - ahora se dispone de nuevos atributos
     a definir para lectura/escritura de disco.
   - la versión 4.1 contenía documentación incorrecta (versión 3.6)

  4.1 (06.08.1996) :

   - ahora se usa/requiere
     el sistema semafórico de "superview.library" versión 14 o superior.
   - ahora se maneja correctamente SVOCheckFile.

****************************************************************************
                 Evolución histórica del programa previa
            a la versión 4.1 suprimida por razones de espacio
****************************************************************************

    Traducción al español libre y sin garantías 9.01.1 (24.10.99) de
     © 1999 Dámaso D. Estévez, basada en el documento "Unpack.doc".
             Recuerde consultar la versión original en inglés
                    para comprobar que este documento
               está 100% actualizado y exento de erratas.

                    ---------------=====-------------
