# Archivo de ayuda del Plugin dec_Burn

- Qué puede hacer dec_Burn por ti
- Acciones y uso del Plugin dec_Burn
- Traducción de textos en tiempo de ejecución
- Limitaciones del Plugin sin Registrar
- Cómo registrar el Plugin dec_Relay

## Preguntas frecuentes

- ¿Soporta dec_Burn todo tipo de dispositivos?

Qué puede hacer dec_Burn por ti

dec_Burn es un Plugin para el programa Neobook 4 que pretende darte la posibilidad de grabar en discos CDR, CDRW, DVDR, DVDRW y DVDRAM. También podrás crear archivos de imagen ISO así como grabar dichos archivos ISO en un disco de alguno de los tipos dichos anteriormente.

dec_Burn te proporciona más de 25 Acciones para trabajar con él, así como otras tantas variables que te ofrecerán información sobre los discos, sobre los dispositivos, por ejemplo.

Por favor, para saber cómo funciona y cómo utilizar el Plugin diríjete a los ejemplos que acomñan al mismo: podrás darle múltiples usos en tus publicaciones, por eso mismo es complicado dar una "norma general de uso".

subir

Acciones y uso del Plugin dec_Burn

dec_Burn añade las Acciones que ahora se referirán, tal como las encontrarás, distribuidas en diferentes apartados. Fíjate que, además de describir la acción correspondiente, también se dan una serie de notas relativas al uso que puede hacerse de ellas.

Iniciar/Liberar ASPI

dec_IniciarASPI
  Esta acción tendrás que utilizarla antes de realizar ninguna grabación. Si ASPI se inicia correctamente la variable [dec_Resultado] devolverá "listo", y "error", en caso de que no pudiera inicializarse ASPI correctamente. También la variable [dec_LogSesion] contendrá luego de ejecutarse esta acción el mensaje oportuno, así como la fecha y hora en que se llevó a cabo.
  Por otro lado, esta acción provoca que la variable [dec_Dispositivo[x]] se "llene" con los dispositivos disponibles (un dispositivo es, por ejemplo, un lector de CDROM, o de CDRs). La "x" de esta variable es un número. Así, en un ordenador de dos lectores/dispositivos encontrarás dos variables [dec_Dispositivo1] y [dec_Dispositivo2].
  ¿Y cómo sabes tú cuántos dispositivos hay en el ordenador? Pues gracias a la variable [dec_NumDispositivos], que también devuelve esta Acción, y que contendrá el número de los disponibles.
  Esto es más sencillo de lo que parece: fíjate en los ejemplos que acompañan al Plugin lo sencillo que es "llenar" una lista desplegable con los dispositivos disponibles, para que el usuario eliga el que convenga.
dec_LiberarASPI
  Esta acción no es obligada, pero es muy recomendable su uso. Sirve para liberar ASPI una vez realizada la grabación de un Disco, por ejemplo. Puedes situarla luego de grabar un disco, por ejemplo, o al "finalizar el libro", o al "salir de la página", si tu publicación es de una sola página. En cualquier caso la variable [dec_Resultado] devolverá "error", si lo hubiera, o "listo", en caso contrario. La variable [dec_LogSesion] también contendrá el correspondiente mensaje relativo al resultado de esta acción.

Dispositivos

dec_EstablecerDispositivo
  Esta Acción has de llevarla a cabo después de haber inicializado ASPI. Esta Acción requiere de un parámetro, el cual es ni más ni menos que el dispositivo que piensas utilizar, o del cual quieres conocer sus características. Si antes se dijo que la variable [dec_Dispositivo1], por ejemplo, contenía el dispositivo número uno encontrado en el ordenador, podrás, pues, llamar a esta acción utilizando como parámetro dicha variable. Te remito a los ejemplos que acompañan al Plugin de nuevo, para que veas cómo hacer uso de esta acción.
  Esta acción te ofrece, luego de ser ejecutada, en la variable [dec_VelocidadDispositivo[x]] las velocidades de lectura/escritura que el dispositivo en cuestión soporta. Como sabes, la "x" es un número, y dicho número estará determinado por la variable [dec_NumVelocidades]. Con la información de dichas variables podrás llenar, por ejemplo, una lista desplegable (tal como ves en los ejemplos) que contenga las velocidades que soporte un dispositivo determinado.
  En cualquier caso que, por ejemplo, antes de utilizar la acción que te informa sobre un dispositivo en cuestión, has de establecer el dispositivo del cual quieres informarte, de entre los disponibles en el ordenador. Para esto, precisamente, puedes utilizar esta acción.
  Por supuesto, añadir que esta acción también devolverá en la variable [dec_resultado] el valor "listo", si todo va bien, o "error", si ocurre alguno.
dec_EstablecerVelocidad
  Esta acción requiere de un parámetro, que es la velocidad a la que quieres que trabaje el dispositivo en cuestión. Este parámetro puede ser la palabra "Max" o una cadena vacía: en cualquiera de estos casos se trabará con el dispositivo a la máxima velocidad que este permita. Vuelvo a remitirte a los ejemplos que acompañan al Plugin para que veas cómo usar esta acción.
  En cualquier caso añadir que se determina la velocidad del dispositivo a la hora de grabar un disco o de borrar un disco. Por supuesto esta acción devuelve en la variable [dec_Resultado] "listo", si todo va bien, o "error", en caso contrario.
dec_DispositivoEstaListo
  Esta acción puedes usarla para averiguar si un dispositivo está listo para ser utilizado o no. Por añadidura, con esta acción compruebas si el disco que hay dentro del dispositivo es válido para lo que te propones. Por ejemplo, si piensas grabar en él, esta acción te devolverá en [dec_Resultado] "si", caso que el disco sea grabable y puedas continuar, o "no", si este no es regrabable, o, sencillamente, no se encuentra disco en el dispositivo.
dec_CapacidadesDispositivo
  Al utilizar esta acción conseguirás que las siguientes variables un valor "verdadero" o "falso" (en realidad "si" o "no") y así puedas trabajar en función de estos resultados, u ofrecer al usuario esta información, por ejemplo:
  - [dec_PuedeLeerCDR]
  - [dec_PuedeLeerCDRW]
  - [dec_PuedeLeerMetodo2]
  - [dec_PuedeLeerDVD]
  - [dec_PuedeLeerDVDR]
  - [dec_PuedeLeerDVDRAM]
  - [dec_PuedeEscribirCDR]
  - [dec_PuedeEscribirCDRW]
  - [dec_PuedeHacerTest]
  - [dec_PuedeEscribirDVDR]
  - [dec_PuedeEscribirDVDRAM]
  - [dec_PuedeEscribirISRC]
  - [dec_SoportaProteccion]
  Puedes observar el uso que se da a estas variables en los ejemplos que acompañan al Plugin, pero, recuerda que admiten otros usos, que dejo a tu imaginación discurrir.

Trabajo con Discos

dec_CargarDisco
  Esta acción puedes usarla para "cerrar la Bandeja del dispositivo/lector/grabador", que hubieras determinado previamente. Es ideal (esta acción) para usarla en conjunto con la que se describe justo más abajo. La acción devolverá en la variable [dec_Resultado] "listo", si todo fue bien o "error", en caso contrario. También la variable [dec_LogSesion] contendrá luego de ejecutar esta acción el mensaje oportuno, que podrás o no mostrar al usuario, según entiendas.
dec_ExpulsarDisco
  Con esta acción podrás "expulsar", abrir la Bandeja del dispositivo que hubieras determinado. La variable [dec_Resultado] contendrá "listo" o "error", y [dec_LogSesion] su correspondiente mensaje.
  Cabe decir que no tendrás que usar esta acción si quieres que, por ejemplo, luego de grabarse un disco este sea expulsado: en la acción para comenzar a grabar un disco, como luego verás, ya puedes determinar si el disco tiene que ser expulsado después de realizada la tarea. Lo mismo vale para la acción para borrar discos.
dec_InformacionDisco
  Con esta acción lograrás que las siguientes variables se "llenen" con la información que su propio nombre indica, o eso pretende:
  - [dec_EspacioLibreDisco]
  - [dec_TipoDeDisco]
  - [dec_TamanoDelDisco]
  - [dec_EspacioUsadoEnDisco]
  - [dec_EstadoDelDisco]
  - [dec_NumSesionesDisco]
  - [dec_ArchivoInsertado]
  - [dec_NumArchivosDisco]
  - [dec_NumDirectoriosDisco]
  - [dec_MegaBytesEnDisco]
  - [dec_KiloBytesEnDisco]
  - [dec_BytesEnDisco]
  - [dec_EtiquetaDelDisco]
  El uso que le des a estas variables puede ser múltiple. En los ejemplos que acompañan al Plugin tienes algunos de ellos. También esta acción te "dice" en la variable [dec_Resultado] "listo", si se pudo reunir la información del disco, o "error", si no fue posible.
dec_PuedeBorrarse
  En la variable [dec_Resultado] obtendrás "si" o "no", luego de ejecutar esta acción, significando que el disco en cuestión puede borrarse o no puede borrarse, porque, por ejemplo, no sea un disco regrabable.
dec_BorrarDisco
  Esta acción requiere de dos parámetros, que, por supuesto, podrás proporcionar a través de un formulario hecho al efecto. El tipo de borrado, que podrá ser "completo" o "rápido" y si se debe expulsar o no el disco luego de borrarse.
  En cualquier caso, es recomendable, antes de ejecutar esta acción, ejecutar la acción dec_EstiloProgresos, con la que podrás determinar el estilo del formulario de progreso que se le mostrará al usuario mientras se lleva a cabo la tarea. Véase más abajo sobre esta última acción dicha.
  También hay que decir que esta acción provoca un resultado en la variable [dec_Resultado], que podrá ser "listo" o "error", dependiendo de si se borra el disco o no, y que en la variable [dec_LogSesion] contarás también con el mensaje oportuno.

Opciones/grabación

dec_GrabarDisco
  Esta acción es la que puedes usar para comenzar el proceso de escritura/grabación de un disco. [dec_Resultado] devolverá "listo" o "error", en función del resultado. A la variable [dec_LogSesion] se irán añadiendo mensajes, al preparar la grabación, al comenzar esta, al terminar, etc. Puedes ver en los ejemplos cómo valerte de la variable [dec_LogSesion], para, si quieres, mostrar dichos mensajes al usuario de tus publicaciones.
  Cabe decir que con esta acción puedes determinar ya varias opciones de la grabación, como, utilizar la protección de errores (si el dispositivo lo permite), el tamaño del Caché para los archivos, si se debe o no expulsar el disco al terminar, etc. Para determinar todo esto cuentas con el formulario de edición de los parámetros de esta acción, por supuesto.
  Añadir acaso que, al igual que en el proceso de borrado de un disco, se presenta al usuario una ventana con el progreso de la tarea, entre otra información. De esta ventana puedes determinar su estilo, ejecutando, por ejemplo, justo antes de esta acción, la acción dec_EstiloProgresos.
  El estilo de las ventanas de progreso también lo determinarás mediante un formulario hecho para tal efecto, en el que podrás ver una muestra de cómo quedará la ventana de progreso según vayas probando los estilos disponibles.
dec_GrabarImagenISO
  Con esta acción puedes comenzar a grabar un archivo de imagen ISO en un Disco. La acción devolverá en la variable [dec_Resultado] "listo" o "error", y la variable [dec_LogSesion] también irá ofreciendo los correspondientes mensajes.
  Naturalmente, antes de llevar a cabo esta acción tendrás que haber determinado el dispositivo para la grabación, así como comprobado si el disco está disponible con las acciones oportunas. También puedes determinar antes de realizar esta acción el estilo de la ventana que muestra el progreso de la tarea.
  Uno de los ejemplos que acompañan al Plugin es, trata, precisamente, sobre cómo grabar un archivo de imagen ISO en un Disco. Te remito, por tanto, a dicho ejemplo para más información.
dec_CrearImagenISO
  Crear un archivo de imagen ISO es más sencillo aún que grabar esta, si es que esto es complicado con este Plugin. Se trata de iniciar ASPI, de añadir los archivos y carpetas que consideres oportunas, y de comenzar la creación de la imagen ISO. Lo que tienes que determinar es dónde se guardará dicho archivo de imagen ISO, sencillamente. [dec_Resultado] devolverá "listo" o "error", si hubiera alguno, y [dec_LogSesion] los mensajes oportunos según se vaya realizando la tarea.
dec_CancelarGrabacion
  El usuario podrá por su cuenta cancelar la grabación, de lo cual tú estarás informado en mediante las variable [dec_Resultado] y el usuario (si quieres) en la variable [dec_LogSesion]. En cualquier caso, tú puedes cancelar la grabación, por el motivo que sea, mediante acción, que te devolverá en la variable [dec_Resultado] "listo" o "error".

Archivos/directorios

dec_AnadirArchivo
  Con esta acción puedes añadir un archivo al futuro disco, esto es, a los archivos y/o carpetas que prepares para su posterior grabación (los ingleses llaman a esto Layout Disc y ya se entienden).
  Tras ejecutar esta acción dispondrás de las siguientes variables para que las uses según más te interese:
  - [dec_ArchivoInsertado]
  - [dec_NumArchivosDisco]
  - [dec_NumDirectoriosDisco]
  - [dec_MegaBytesEnDisco]
  - [dec_KiloBytesEnDisco]
  - [dec_BytesEnDisco]
  También la variable [dec_Resultado] devolverá "listo" o "error", según se consiga insertar el archivo o no, por algún problema. Fíjate en los ejemplos que acompañan al Plugin: verás cómo puedes insertar, mediante esta acción y un sencillo "Loop", varios archivos a la vez.
dec_ExisteArchivo
  Con esta acción puedes averiguar si un determinado archivo existe ya entre los que estés preparando para grabarlos en un Disco. La variable [dec_Resultado] devolverá "si", si el archivo existe, o "no", cuando no exista. Esta acción es la ideal para usar antes de borrar un deteterminado archivo.
dec_BorrarArchivo
  Con esta acción puedes borrar un archivo existente entre los que prepares para grabar en un Disco. Esta acción devolverá en la variable [dec_Resultado] "listo", si consigue borrarse el archivo en cuestión, o "error", en caso contrario, porque el archivo no exista, o no pudiera borrarse por otro problema. Si quieres borrar todos los archivos y directorios a la vez usa la acción: dec_BorrarlosTodos.
dec_AnadirDirectorio
  Igual que puedes añadir archivos, también puedes añadir directorios. Sin embargo, con esta acción podrás determinar, por ejemplo, si quieres añadir también los subdirectorios y archivos del directorio que precises añadir para ser después grabados en un disco. En la variable [dec_Resultado] obtendrás "listo", si todo va bien y se añade el directorio, "error", en caso contrario.
  También podrás hacer uso luego de ejecutar esta acción de los valores de las variables:
  - [dec_ArchivoInsertado]
  - [dec_NumArchivosDisco]
  - [dec_NumDirectoriosDisco]
  - [dec_MegaBytesEnDisco]
  - [dec_KiloBytesEnDisco]
  - [dec_BytesEnDisco]
  Por ejemplo, tal como se muestra en los ejemplos que acompañan al Plugin, para mostrar una ventana de progreso al usuario.
dec_CrearDirectorio
  Esta acción puedes usarla para crear un directorio en el Disco, o sea, en lo que será el disco que se ha de grabar después. O en el archivo ISO que puedes crear, con los archivos y/o directorios que determines. La variable [dec_Resultado] responderá con "listo" o "error" según corresponda.
dec_ExisteDirectorio
  Con esta acción puedes comprobar la existencia de un determinado directorio entre los que estés preparando para su posterior grabación en un disco o imagen ISO. Es ideal para usarse antes de borrar un directorio. En la variable [dec_Resultado] encontrarás "error" o "listo", según corresponda al resultado de ejecutar la acción.
dec_BorrarDirectorio
  Esta acción te permite borrar un directorio de los que se encuentren preparados para ser grabados en un disco o para ser escritos en un archivo de imagen ISO. [dec_Resultado] te devolverá "error" o "listo", dependiendo del éxito o fracaso de la acción.
dec_BorrarlosTodos
  Con esta acción puedes, de una vez, borrar todos los archivos y/o directorios que hubieras añadido ya para grabarlos en un disco, por ejemplo. [dec_Resultado] devolverá "error" o "listo" en función del resultado de la acción.

Cara al usuario

dec_EditarGrabacion
  Con esta acción puedes presentar al usuario, por ejemplo, antes de comenzar la grabación de un disco, cierta ventana en la que podrá ver los archivos y directorios que vayan a ser grabados, de tal modo que el propio usuario pueda quitar (no grabar) los archivos y directorios que estime oportuno.
  Esta ventana no es obligatorio que la muestres antes de comenzar a escribir en un disco, es opcional, y, dependerá el mostrarla o no mostrarla del tipo de publicación que estés llevando a cabo, o de tus preferencias o necesidades. La variable [dec_Resultado] contendrá "listo" luego de cerrarse esta ventana, y las variables:
  - [dec_ArchivoInsertado]
  - [dec_NumArchivosDisco]
  - [dec_NumDirectoriosDisco]
  - [dec_MegaBytesEnDisco]
  - [dec_KiloBytesEnDisco]
  - [dec_BytesEnDisco]
  ... serán actualizadas en consecuencia luego de que el usuario borre archivos, directorios, o no los borre.
dec_EstiloProgresos
  Con esta acción no obtienes ningún resultado en ninguna variable: lo que consigues es cambiar la apariencia, el estilo, los colores de las ventanas que para mostrar al usuario los progresos de determinadas tareas ofrece este Plugin. Puedes elegir un estilo de los predeterminados o jugar con ellos, hasta obtener el resultado que prefieras.

Log de sesión

dec_ReinicializarLog
  Con esta acción puedes reinicializar, o sea, borrar el contenido, los mensajes que se hubieran ido acumulando en la variable [dec_LogSesion], sencillamente. La variable [dec_Resultado] te informará del de esta acción, con "error" o "listo".
dec_GuardarEnArchivo
  Con esta acción podrás guardar en un archivo de texto, o archivo "log", el contenido de la variable [dec_LogSesion], directamente. Solo tienes que decidir el archivo en que quieres que se guarde dicha información.
  La variable [dec_Resultado] por su parte devolverá "error" o "listo" luego de ejecutarse esta acción.

subir

Traducción de textos en tiempo de ejecución

Los formularios de progreso pueden traducirse en su mayor parte en tiempo de diseño de tus publicaciones. No obstante, hay ciertos textos que no se pueden traducir en tiempo de diseño.

Sin embargo, con las siguientes variables esto es posible, asignándoles el valor oportuno (la traducción correspondiente) en tiempo de ejecución:

- [dec_TradBorradoRapido]
- [dec_TradBorradoCompleto]
- [dec_TradGrabacionDisco]
- [dec_TradCrearImagenISO]
- [dec_TradGrabarImagenISO]

En cualquier caso la asignación de estas variables es opcional: el Plugin usará los textos por defecto, esto es, los del idioma del Plugin, si no se asignan valores a las variables dichas.

subir

Limitaciones del Plugin sin registrar

El Plugin mostrará una ventana al comenzar y al finalizar una publicación en que sea utilizado sin registrarlo previamente. No limita, sin embargo, el tamaño de los archivos que puedes grabar en un Disco.

subir

Cómo registrar el Plugin dec_Burn

Para registrar el Plugin dec_Burn, por favor, visita la página Web: www.davidesperalta.tk para informarte sobre cómo hacerlo o escribe, directamente, un correo electrónico a la dirección: davidesperalta@wanadoo.es solicitando información al respecto.

subir

¿Soporta dec_Burn todo tipo de dispositivos?

Obviamente esto sería demasiado: dec_Burn no se ha testado en todas las marcas, modelos y diferentes dispositivos que existen en el mercado.

Antes de registrar el Plugin dec_Burn debes asegurarte de que este se adapta a tus necesidades, y, si no es así, porque no reconozca tu dispositivo de grabación, por ejemplo, debes comunicarlo, si te place, para intentar solucionar el problema, pero, en cualquier caso, no registrar el Plugin hasta que dicho inconveniente, más bien, estuviera solucionado.

subir

dec_Burn - ©2004 - David Esperalta - www.davidesperalta.tk