Acerca de las etiquetas de origen del vídeo del archivo AGV

Disponible con una licencia de 3D Analyst.

Es necesario que la capa de vídeo esté conectada con los datos de origen, ya sea mediante un archivo, una carpeta o un servicio, que pueda proporcionar los cuadros de vídeo individuales que se desplegarán sobre la superficie del globo. Es necesario que haya un origen del vídeo, y que ArcGlobe tenga acceso al mismo, para que se pueda visualizar la capa de vídeo.

La información de origen del vídeo debe incluir tanto el tipo de vídeo como la ubicación de los datos.

Hay tres tipos generales de orígenes del vídeo, representadas por los siguientes grupos de etiquetas:

• <VideoFilesSource>: un vídeo almacenado en un único archivo lógico
• <ImageFolderSource>: un vídeo almacenado como un conjunto de imágenes ordenadas en una única carpeta
• <CustomSource>: un tipo de vídeo que se ha puesto a disposición por codificación personalizada

La ruta del origen del vídeo puede estar en cualquiera de los siguientes formatos:

• Una ruta o nombre de archivo local, como C:\Project1\Camera1.mpg
• Una ruta o nombre de archivo UNC como \\myServer\Videos\Camera8_Frames
• Un ruta o nombre de archivo relativo (empezando por la ubicación del archivo AGV) tal como .\CustomVideoLayer.dll

Sugerencia:

• Cuando se define la ruta relativa, se aplican reglas de formato estándar. Por ejemplo, una cadena de caracteres precedida de .\ implica la carpeta actual que contiene el archivo AGV, mientras que una cadena de caracteres precedida de ..\ implica la carpeta principal.

Cada uno de los tres tipos generales de orígenes del vídeo se describe con más detalle a continuación.

Origen de los archivos de vídeo

Esta opción está diseñada para los vídeos almacenados en el disco en un formato de archivo de vídeo compatible, tales como AVI o MPG. El archivo AGV identificará este origen del vídeo incluyendo la información de la conexión dentro de estas etiquetas XML: <VideoSource FrameSourceType="File"> y </VideoSource>, como se muestra en el ejemplo de texto XML siguiente.

La etiqueta principal de la fuente de datos para este tipo de capa de vídeo es el elemento <VideoFilePath>, que define la ubicación del archivo de vídeo. Puede incluir varias etiquetas XML para conectar varios archivos de vídeo un una única capa de vídeo.

Deberá también definir lo siguiente:

• La tasa de actualización real (en milisegundos) de la etiqueta <FrameRequestRate>
  • Este valor aparece en milisegundos y representa el espacio de tiempo que ArcGlobe debe esperar antes de solicitar el siguiente cuadro del vídeo. Por ejemplo, un valor de 50 haría que ArcGlobe solicitase un cuadro cada 0,05 segundos y, por tanto, reprodujera el vídeo a una velocidad de 20 cuadros por segundo.
  • Tenga en cuenta que se trata de la "velocidad de reproducción" del vídeo, que puede ser distinta de las unidades de tiempo reales que cada cuadro representa.

Los archivos de vídeo se pueden almacenar en un gran conjunto de formatos, con muchos códecs posibles. Para que se reproduzca un vídeo en el equipo local (tanto dentro de ArcGlobe o en un reproductor de vídeo como Windows Media Player) el códec requerido debe residir en dicho equipo. Dependiendo del equipo, los formatos de archivos de vídeo compatibles son los siguientes:

• MPG (.mpg, .mpeg, .mp4)
• AVI (.avi)
• WMV (.wmv)

Consideraciones

A continuación presentamos algunos consejos que debe tener en cuenta al crear archivos de origen de vídeos:

• Si especifica varios archivos de vídeos en el grupo VideoFilesSource, todos los vídeos deben tener la misma resolución de imagen.
• Una prueba simple para comprobar que el vídeo se puede visualizar en ArcGlobe es realizar la vista previa del archivo origen en Windows Media Player. Si el vídeo no se visualiza, no se visualizará como capa de vídeo en ArcGlobe.

Ejemplo

A continuación se ofrece un ejemplo de una capa de origen del vídeo realizado a partir de dos archivos de origen AVI con 20 marcos por segundo:

<VideoSource FrameSourceType="File">  <VideoFilesSource>   <VideoFilePath>.\Security_BldF_10.00AM.avi</VideoFilePath>   <VideoFilePath>.\Security_BldF_10.05AM.avi</VideoFilePath>  </VideoFilesSource>  <FrameRequestRate>50</FrameRequestRate>  </VideoSource>

Origen de la carpeta de imágenes

Esta opción está diseñada para formatos de vídeo compatibles no nativos, como el formato de archivo QuickTime (.mov), consumiéndolos una vez se han convertido en un contenedor de imágenes. También soporta el consumo de la carpeta de marcos que pueden ser salida del marco de animación de ArcGIS. El archivo AGV identificará este origen del vídeo incluyendo la información de la conexión dentro de estas etiquetas XML: <ImageSource FrameSourceType="Folder"> y </ImageSource>, como se muestra en el ejemplo de texto XML siguiente.

La etiqueta principal de la fuente de datos para este tipo de capa de vídeo es <ImageFolderPath>, que define la ruta hacia la carpeta que contiene los archivos de imágenes.

Deberá también definir lo siguiente:

• El formato de nombre de archivo en la etiqueta <NameFormat>
  • Este valor es una cadena de caracteres y proporciona una plantilla para la convención de nombre del marco de imagen, de manera que se puede acceder a los archivos de imágenes correctos en el orden correcto.
  • La parte numérica del nombre de archivo de imágenes se representa mediante un carácter hash, con el prefijo y sufijo del nombre de archivo rodeándolo.

    Por ejemplo, si la carpeta contiene imágenes denominadas Frame1.jpg, Frame2.jpg, etc., se debe usar un valor <NameFormat> de Frame#.jpg.

• Los valores índice del primer y último marco en las etiquetas <FirstIndex> y <LastIndex>
  • Estos dos valores están en números enteros, y especifican el rango de archivos de imágenes que se han de leer.
  • Ejemplo: Si tiene 300 marcos de imágenes secuenciales en la carpeta, y el primer archivo se denomina Frame1.jpg, los valores necesarios serán 1 y 300, respectivamente.
  • Estos valores pueden usarse también para reproducir un subconjunto de una carpeta de marcos de gran tamaño.
• Los valores de tamaño de imagen en las etiquetas <Width> y <Height>
  • Estos dos valores están en pixeles y representan la resolución del vídeo.
  • Sólo las imágenes con esta resolución especificada se visualizarán como marcos en el vídeo.
  • Las etiquetas se leen cuando la capa de vídeo se agrega a ArcGlobe o cuando la capa se vuelve a leer manualmente al hacer clic con el botón derecho del ratón en la tabla de contenido y después de hacer clic en Actualizar.
  • Tenga en cuenta que los marcos de imagen de mayor resolución son caros de presentar en pantalla y pueden dar como resultado una tasa de marcos máxima menor.
• La tasa de actualización de marco de vídeo en la etiqueta <FrameRequestRate>
  • Este valor aparece en milisegundos y representa el espacio de tiempo que ArcGlobe debe esperar antes de solicitar el siguiente cuadro del vídeo.

    Por ejemplo, un valor de 100 haría que ArcGlobe solicitase un cuadro cada 0,1 segundos y, por tanto, reprodujera el vídeo a una velocidad de 10 cuadros por segundo.

  • Tenga en cuenta que se trata de la "velocidad de reproducción" del vídeo, que puede ser distinta de las unidades de tiempo reales que cada cuadro representa.

Ejemplo

A continuación se ofrece un ejemplo de una capa de origen del vídeo realizado a partir de una carpeta de marcos con 10 marcos por segundo:

<ImageSource FrameSourceType="Folder">  <ImageFolderPath>\\server1\VideoOverlays\Analysis1</ImageFolderPath>   <Frames>    <NameFormat>Frame#.jpg</NameFormat>    <FirstIndex>1</FirstIndex>    <Width>600</Width>    <Height>480</Height>   </Frames>  <FrameRequestRate>100</FrameRequestRate> </ImageSource>

Origen personalizado

Esta opción está diseñada para usuarios avanzados que pueden introducir un código para crear una capa de vídeo personalizada, como alimentación en vivo procedente de un vehículo en movimiento. ArcGlobe le solicitará los marcos de vídeo del DLL personalizado en intervalos definidos en lugar de acceder específicamente a un archivo o carpeta de marcos en el disco. El archivo AGV identificará este origen del vídeo incluyendo la información de la conexión dentro de estas etiquetas XML: <VideoSource FrameSourceType="DLLServer"> y <VideoSource>, como se muestra en el ejemplo de texto XML siguiente.

La etiqueta principal de la fuente de datos para este tipo de capa de vídeo es <Location>, que define la ruta completa hasta el DLL que responderá a las peticiones de ArcGlobe de imágenes marco de vídeo e información de georreferenciación.

Deberá también definir lo siguiente:

• La tasa de actualización real (en milisegundos) de la etiqueta <FrameRequestRate>
  • Este valor aparece en milisegundos y representa el espacio de tiempo que ArcGlobe debe esperar antes de solicitar el siguiente cuadro del vídeo desde el DLL personalizado.

    Ejemplo: Un valor de 6000 haría que ArcGlobe solicitase un cuadro cada 6 segundos y, por tanto, reprodujera el vídeo a una velocidad de 10 cuadros por minuto.

  • Tenga en cuenta que se trata de la velocidad de reproducción del vídeo, que puede ser distinta de las unidades de tiempo reales que cada cuadro representa.
• Como muchos elementos <Parameter> opcionales, según necesidad mediante el DLL personalizado
  • Ejemplo: El DLL personalizado puede tratar peticiones de diferentes vídeos, cada archivo AGV utiliza un elemento <Parameter> para distinguir qué vídeo alimenta la capa particular a la que está conectada.

Ejemplo

A continuación se ofrece un ejemplo de una capa de origen del vídeo realizado a partir de un servidor DLL personalizado con 10 marcos por minuto:

<VideoSource FrameSourceType="DLLServer">   <Location>C:\Program Files\App1\bin\MyVideoFrameProvider.dll</Location>   <FrameRequestRate>6000</FrameRequestRate>   <Parameter>VideoSource 1</ Parameter > </VideoSource>