]> git.llucax.com Git - z.facultad/75.42/plaqui.git/blobdiff - Constructor/doc/manual.lyx
actualizo imagen de las propiedades del tanque y subo las muestras de los xml individ...
[z.facultad/75.42/plaqui.git] / Constructor / doc / manual.lyx
index a3656218a528ff3089d2bee5d9f96a6e3d290711..076117ee21d1e5a8a95a9279192f395c3087284c 100644 (file)
@@ -78,16 +78,7 @@ Enter
 Pantalla inicial.
 \layout Standard
 
-Una vez abierta la aplicación aparecerá la ventana principal que se puede
- ver en la figura 
-\begin_inset LatexCommand \vref{cap:Ventana-principal}
-
-\end_inset 
-
-.
-\layout Standard
-
-
+Una vez abierta la aplicación aparecerá la ventana principal 
 \begin_inset Float figure
 wide false
 collapsed true
@@ -99,12 +90,12 @@ collapsed true
 
 \end_inset 
 
-Ventana principal de PlaQui Constructor
+Ventana principal de PlaQui Constructor.
 \layout Standard
-
+\align center 
 
 \begin_inset Graphics
-       filename /home/nico/plaqui/Constructor/doc/principal.png
+       filename principal.png
        lyxscale 50
        width 14.7cm
        keepAspectRatio
@@ -114,7 +105,12 @@ Ventana principal de PlaQui Constructor
 
 \end_inset 
 
+ que se puede ver en la figura 
+\begin_inset LatexCommand \vref{cap:Ventana-principal}
+
+\end_inset 
 
+.
 \layout Standard
 
 La ventana contiene los siguientes elementos:
@@ -125,9 +121,6 @@ Barra de men
 
 En la barra de menú se encuentra en la parte superior de la ventana y en
  ella están todas los comandos para trabajar con el programa.
-\layout Comment
-
-En cada ítem de cada menú se podría agregar un ícono.
 \layout Paragraph
 
 Menú 
@@ -143,7 +136,8 @@ En este men
 
 
 \begin_inset Graphics
-       filename /home/nico/plaqui/Constructor/doc/new.png
+       filename new.png
+       rotateOrigin center
 
 \end_inset 
 
@@ -153,7 +147,7 @@ Nuevo Empieza a construir una planta nueva.
 
 
 \begin_inset Graphics
-       filename /home/nico/plaqui/Constructor/doc/open.png
+       filename open.png
 
 \end_inset 
 
@@ -163,7 +157,7 @@ Abrir Abre una planta nueva.
 
 
 \begin_inset Graphics
-       filename /home/nico/plaqui/Constructor/doc/save.png
+       filename save.png
 
 \end_inset 
 
@@ -172,7 +166,7 @@ Guardar Guarda la planta actual.
 
 
 \begin_inset Graphics
-       filename /home/nico/plaqui/Constructor/doc/quit.png
+       filename quit.png
 
 \end_inset 
 
@@ -193,7 +187,7 @@ En este men
 
 
 \begin_inset Graphics
-       filename /home/nico/plaqui/Constructor/doc/delete.png
+       filename delete.png
 
 \end_inset 
 
@@ -202,7 +196,7 @@ Borrar Borra el elemento seleccionado actualmente.
 
 
 \begin_inset Graphics
-       filename /home/nico/plaqui/Constructor/doc/clear.png
+       filename clear.png
 
 \end_inset 
 
@@ -232,16 +226,38 @@ Acerca Obtiene informaci
 Barra de herramientas.
 \layout Standard
 
+La barra de herramientas
+\begin_inset Float figure
+wide false
+collapsed true
+
+\layout Caption
+
+
+\begin_inset LatexCommand \label{cap:Barra-de-herramientas.}
+
+\end_inset 
+
+Barra de herramientas.
+\layout Standard
+\align center 
 
 \begin_inset Graphics
-       filename /home/nico/plaqui/Constructor/doc/barra_herramientas.png
+       filename barra_herramientas.png
+       width 14.7cm
+       keepAspectRatio
 
 \end_inset 
 
 
-\layout Standard
+\end_inset 
 
-En la barra de herramientas se encuentra debajo de la 
+ (figura 
+\begin_inset LatexCommand \ref{cap:Barra-de-herramientas.}
+
+\end_inset 
+
+) se encuentra debajo de la 
 \family sans 
 Barra de menú
 \family default 
@@ -253,46 +269,57 @@ Barra de men
 
 En la parte inferior se encuentran herramientas adicionales útiles a la
  hora de trabajar con la planta.
-\layout Standard
+\layout Description
 
+Verificar\SpecialChar ~
+Conexionado Verifica que todos los elementos estén conectados,
+ y formen un circuito de manera que pudierda fluir un líquido.
+\layout Description
 
-\series bold 
-Verificar Conexionado 
-\series default 
-Verifica que todos los elementos estén conectados, y formen un circuito
- de manera que pudierda fluir un líquido.
-\layout Standard
+Lista Ubicada en la segunda posición de la barra, indica cuál fué el último
+ elemento seleccionado mediante un click del mouse, y almacena todos los
+ nombres de los elementos que fueron seleccionados.
+\layout Description
+
+Buscar Marca con un recuadro negro el elemento ingresado en el campo de
+ texto
+\begin_inset Float figure
+wide false
+collapsed false
 
+\layout Caption
 
-\series bold 
-Lista
-\series default 
- Ubicada en la segunda posición de la barra, indica cuál fué el último elemento
- seleccionado mediante un click del mouse, y almacena todos los nombres
- de los elementos que fueron seleccionados.
-\layout Standard
 
+\begin_inset LatexCommand \label{cap:Buscar-un-elemento.}
 
-\series bold 
-Buscar
-\series default 
- Marca con un recuadro negro el elemento seleccionado (el que aparece en
- la lista).
-\layout Standard
+\end_inset 
 
+Buscar un elemento.
+\layout Standard
+\align center 
 
 \begin_inset Graphics
-       filename /home/nico/plaqui/Constructor/doc/buscar.png
+       filename buscar.png
+       width 10cm
+       keepAspectRatio
+
+\end_inset 
+
 
 \end_inset 
 
+ (ver figura 
+\begin_inset LatexCommand \ref{cap:Buscar-un-elemento.}
+
+\end_inset 
 
+).
 \layout Subsubsection
 
 Barra de elementos de planta.
 \layout Standard
 
-En la barra de íconos que se encuentra a la izquierda.
+Es la barra de íconos que se encuentra a la izquierda.
  En ella están todos los elementos (físicos) que pueden ser incluídos en
  una planta.
 \layout Subsubsection
@@ -300,9 +327,10 @@ En la barra de 
 Barra de compuertas lógicas.
 \layout Standard
 
-En la barra de íconos que se encuentra a la derecha.
+Es la barra de íconos que se encuentra a la derecha.
  En esta barra se encuentran las compuertas lógicas para diseñar el comportamien
 to dinámico de la planta.
+ Las compuertas son AND, OR y NOT.
 \layout Subsubsection
 
 Barra de estado.
@@ -318,6 +346,38 @@ na informaci
 
 Es el espacio grillado central, en ella se arrastran y sueltan los elementos
  de una planta para su diseño.
+\layout Standard
+
+En la figura 
+\begin_inset LatexCommand \ref{cap:Vista_general}
+
+\end_inset 
+
+ se puede ver el área de trabajo completa.
+\layout Standard
+
+
+\begin_inset Float figure
+wide false
+collapsed false
+
+\layout Caption
+
+
+\begin_inset LatexCommand \label{cap:Vista_general}
+
+\end_inset 
+
+Ventana Principal
+\begin_inset Graphics
+       filename general.png
+
+\end_inset 
+
+
+\end_inset 
+
+
 \layout Section
 
 Guardar y recuperar el trabajo.
@@ -332,10 +392,16 @@ Archivo\SpecialChar \menuseparator
 Abrir
 \family default 
  o presionando sobre el ícono 
+\begin_inset Graphics
+       filename open.png
+
+\end_inset 
+
+ de la 
 \family sans 
-Abrir
+Barra de herramientas
 \family default 
- de la barra de herramientas.
+.
  En ambos casos se abrirá una ventana de dialogo en la que puede seleccionar
  el archivo a abrir.
  Una vez seleccionado, presione 
@@ -344,17 +410,6 @@ Aceptar
 \family default 
 .
  La planta aparecerá en la ventana principal.
-\layout Comment
-
-En vez de poner 
-\begin_inset Quotes eld
-\end_inset 
-
-ícono Abrir
-\begin_inset Quotes erd
-\end_inset 
-
- se podría poner una imágen bonita :)
 \layout Subsection
 
 Guardar un archivo de planta.
@@ -382,6 +437,21 @@ r la ubicaci
 Si se desea guardar el archivo con otro nombre o en otra ubicación, siempre
  estará disponible la primera opción, que en todos los casos mostrará el
  diálogo correspondiente.
+\layout Standard
+
+Para poder guardar un archivo de planta, esta debe estar correctamente conectada
+, esto puede verificarse presionando el botón de la barra de herramientas
+\begin_inset Quotes eld
+\end_inset 
+
+Verificar Conexionado
+\begin_inset Quotes erd
+\end_inset 
+
+ el cual desplegará un diálogo de error, indicamdo cual es el elemento que
+ no verifica, si no se cumple la condición o un diálogo de éxito si todo
+ es correcto.
 \layout Subsection
 
 Empezar una planta nueva.
@@ -397,7 +467,9 @@ o directamente desde el acceso r
  el botón con el mismo ícono, que se encuentra en la primera posición.
 \layout Standard
 
-Esta acción 
+Luego de este procedimiento, si el usuario desea guardar nuevamente el trabajo,
+ volverá a aparecer el diálogo para seleccionar la ubicación y nombre del
+ archivo por primera vez.
 \layout Section
 
 Salir del programa.
@@ -432,9 +504,6 @@ A continuaci
 \layout Section
 
 Diseño Físico de la planta.
-\layout Comment
-
-Mencionar el botón de verificar conexionado.
 \layout Subsection
 
 Agregar un elemento.
@@ -482,28 +551,170 @@ Cambiar las propiedades de un elemento.
 \layout Standard
 
 Para modificar las propiedades de un elemento puede hacer doble-click sobre
- el mismo.
+ el mismo o haciendo click con el botón derecho del puntero y seleccionando
+ la opción 
+\family sans 
+Propiedades
+\family default 
+ del menú contextual.
  Esto abre una ventana de diálogo que, según el tipo de elemento le permitirá
  cambiar las siguiente propiedades:
 \layout Description
 
-Nombre Nombre del elemento.
- Este nombre se utiliza para identificar este elemento para poder controlarlo
- desde la aplicación de control.
-\layout Comment
+Nombre Nombre e identificador unico del elemento (todos).
+\layout Description
 
-Poner las otras propiedades que pueden modificarse.
-\layout Comment
+Flujo\SpecialChar ~
+Maximo Indica el flujo maximo que puede pasar por el elemento (tubo,
+ codo, empalme y bomba).
+\layout Description
 
-Poner screenshots???
+Estado Estado del elemento: Abierto o Cerrado (exclusa).
+\layout Description
+
+Tipo\SpecialChar ~
+de\SpecialChar ~
+Conexion Define como se comporta el elemento: Union o Division (empalme).
+\layout Description
+
+Color Color del flujo que esta pasando actualmente por el elemento (bomba
+ y tanque).
+\layout Description
+
+Capacidad\SpecialChar ~
+Maxima Capacidad de almacenamiento de fluidos del elemento (tanque).
+\layout Description
+
+Contenido\SpecialChar ~
+Inicial Cantidad de flujo almacenado inicialmente en el elemento
+ (tanque).
 \layout Standard
 
-La ventana de diálogo de propiedades también puede abrirse haciendo click
- con el botón derecho del puntero y seleccionando la opción 
-\family sans 
-Propiedades
-\family default 
- del menú contextual.
+La ventana de propiedades del tubo, el codo, el drenaje y el empalme son
+ practicamente iguales
+\begin_inset Float figure
+wide false
+collapsed true
+
+\layout Caption
+
+
+\begin_inset LatexCommand \label{cap:Propiedades-del-Tubo}
+
+\end_inset 
+
+Propiedades del Tubo y Empalme.
+\layout Standard
+\align center 
+
+\begin_inset Graphics
+       filename tubo_props.png
+       width 6cm
+       keepAspectRatio
+       subcaption
+       subcaptionText "Tubo"
+
+\end_inset 
+
+\begin_inset Graphics
+       filename empalme_props.png
+       width 6cm
+       keepAspectRatio
+       subcaption
+       subcaptionText "Empalme"
+
+\end_inset 
+
+
+\end_inset 
+
+ (ver figura 
+\begin_inset LatexCommand \ref{cap:Propiedades-del-Tubo}
+
+\end_inset 
+
+), a este último elemento se le agrega la opción de seleccionar si es una
+ unión o una división, y el drenaje solo posee la propiedad Nombre.
+\layout Standard
+
+Para la bomba y el tanque aparecerán ventanas similares
+\begin_inset Float figure
+wide false
+collapsed true
+
+\layout Caption
+
+
+\begin_inset LatexCommand \label{cap:Propiedades-del-Tanque}
+
+\end_inset 
+
+Propiedades del Tanque y la Bomba.
+\layout Standard
+\align center 
+
+\begin_inset Graphics
+       filename tanque_props.png
+       width 7cm
+       keepAspectRatio
+       subcaption
+       subcaptionText "Tanque"
+
+\end_inset 
+
+\begin_inset Graphics
+       filename bomba_props.png
+       width 7cm
+       keepAspectRatio
+       subcaption
+       subcaptionText "Bomba"
+
+\end_inset 
+
+
+\end_inset 
+
+ (ver figura 
+\begin_inset LatexCommand \ref{cap:Propiedades-del-Tanque}
+
+\end_inset 
+
+), pero estos elementos tienen la capacidad de definir, además del nombre,
+ el color del fluido que almacenan o entregan.
+\layout Standard
+
+Al presionar el botón Color, se abrirá una nueva ventana de dialogo
+\begin_inset Float figure
+wide false
+collapsed true
+
+\layout Caption
+
+Seleccion de color.
+\layout Standard
+\align center 
+
+\begin_inset Graphics
+       filename color_dlg.png
+       width 12cm
+       keepAspectRatio
+
+\end_inset 
+
+
+\end_inset 
+
+ que permite seleccionar el mismo (ver figura 
+\begin_inset LatexCommand \ref{cap:Propiedades-del-Tanque}
+
+\end_inset 
+
+).
+\layout Standard
+
+Las compuertas lógicas no tienen la capacidad de modificar sus propiedades.
 \layout Subsection
 
 Eliminar un elemento.
@@ -538,20 +749,186 @@ Dise
 \layout Standard
 
 Para agregar un circuito lógico a la planta debe agregar compuertas lógicas.
-\layout Comment
+\layout Standard
+
+El agregado de las compuertas es tan simple como el de los demás elementos,
+ de la misma forma estas pueden rotar para acomodarse a las necesidades
+ del diseñador.
+\layout Standard
+
+Básicamente la conexión lógica se realiza en tres pasos:
+\layout Subsection
+
+Agregar compuertas logicas.
+\layout Standard
+
+Al igual que para agregar elemento comunes, para agregar compuertas logicas
+ basta con arrastrarlas y soltarlas en el 
+\family sans 
+Área de trabajo
+\family default 
+
+\begin_inset Float figure
+wide false
+collapsed true
+
+\layout Caption
+
+
+\begin_inset LatexCommand \label{cap:Agregar-compuertas-logicas.}
+
+\end_inset 
+
+Agregar compuertas logicas.
+\layout Standard
+\align center 
+
+\begin_inset Graphics
+       filename conectando.png
+       lyxscale 70
+       width 14.7cm
+
+\end_inset 
+
+
+\end_inset 
+
+.
+ En la figura 
+\begin_inset LatexCommand \ref{cap:Agregar-compuertas-logicas.}
 
-Comentar que primero hay que poner compuertas, después poner 
-\begin_inset Quotes eld
 \end_inset 
 
+ puede ver un ejemplo.
+\layout Subsection
+
+Activar el modo de Logica.
+\layout Standard
+
+Para crear conexiones es necesario activar el modo de Lógica del 
+\family sans 
+Área de trabajo
+\family default 
+.
+ Esto se hace haciendo click en la caja de selección 
+\family sans 
 Lógica
-\begin_inset Quotes erd
+\family default 
+ que se encuentra en la 
+\family sans 
+Barra de herramientas
+\family default 
+.
+\layout Standard
+
+Mientras este estado se encuentre activo, no se podrán realizar cambios
+ en las posiciones de los elementos, ni agregar nuevos, pero si podrán rotarse.
+\layout Standard
+
+Al mismo tiempo que se acciona la lógica, podran verse las zonas de conexion
+ de cada elemento que tenga una entrada o una salida (exclusas, tanques,
+ bombas y conectores logicos)
+\begin_inset Float figure
+wide false
+collapsed false
+
+\layout Caption
+
+
+\begin_inset LatexCommand \label{cap:Modo-de-Logica.}
+
+\end_inset 
+
+Modo de Logica.
+\layout Standard
+\align center 
+
+\begin_inset Graphics
+       filename logica.png
+       lyxscale 70
+       width 14.7cm
+
+\end_inset 
+
+
+\end_inset 
+
+.
+ Las salidas se identifican con el color azul y las entradas con el rojo.
+ En la figura 
+\begin_inset LatexCommand \ref{cap:Modo-de-Logica.}
+
 \end_inset 
 
- y empezar a conectar.
-\layout Comment
+ puede ver un ejemplo.
+\layout Subsection
+
+Conectar los elementos.
+\layout Standard
+
+Todas las conexiones deben hacerse desde una compuerta logica hacia otro
+ elemento (comun u otra compuerta logica).
+ Para seleccionar la compuerta logica desde la cual comenzar la conexión
+ simplemente haga click sobre la zona de conexión (entrada o salida).
+ A continuacion haga click en la zona de conexión del otro elmento y aparecera
+ una linea de color rojo o azul.
+ El azul indica una conexión entrante a la compuerta lógica y el rojo una
+ conexión saliente de la compuerta lógica.
+ Solo pueden hacerse conexiones desde la entrada de una compuerta lógica
+ (zona roja) a la salida de otro elemento (zona azul) o desde una salida
+ de una compuerta lógica (zona azul) a la entrada de otro elemento (zona
+ roja).
+\layout Standard
+
+Para conectar dos compuertas se debe clickear en primer lugar la salida
+ de la compuerta origen y en segunda instancia la entrada de la compuerta
+ destino.
+\layout Standard
+
+Las compuertas lógicas 
+\family sans 
+AND
+\family default 
+ y 
+\family sans 
+OR
+\family default 
+ pueden tener un número indefinido de entradas, mientras que la compuerta
+\family sans 
+NOT
+\family default 
+ puede debe tener solo una.
+ Todas las compuertas pueden tener una sola salida.
+ Los elementos de transporte de flujo con zonas de conexion aceptan un número
+ indefinido de conexiones.
+\layout Standard
 
-Explicar tema de los colores (cual es entrada y cual salida) y las limitaciones
- de cada elemento (cuantas entradas soporta cada compuerta lógica, cuantas
- salidas, que tipo de entradas y salidas tiene cada elemento de la planta).
+En la figura
+\begin_inset LatexCommand \ref{cap:Planta_logica}
+
+\end_inset 
+
+ se puede ver una planta terminada.
+\begin_inset Float figure
+wide false
+collapsed true
+
+\layout Caption
+
+
+\begin_inset LatexCommand \label{cap:Planta_logica}
+
+\end_inset 
+
+Planta Completa
+\begin_inset Graphics
+       filename planta_logica.png
+
+\end_inset 
+
+
+\end_inset 
+
 \the_end