Descripción XML de grupos

Sinopsis

Desde la versión 1.7 de BlueBrick se puede escribir un archivo XML que describa varias piezas u otros grupos organizados en posiciones y orientaciones predefinidas. Por lo tanto, un grupo puede usarse como atajo para añadir varias piezas de golpe. Por ejemplo, puedes crear un módulo estándar de 3x baseplates con dos vías rectas en su parte inferior.

Una próxima versión de BlueBrick proporcionará un modo de guardar la selección actual como grupo pero, por ahora, hay que crear el XML de forma manual. Una forma alternativa de hacerlo es guardar las piezas que necesites en un archivo BBM, para luego copiar y pegar los códigos de orientación y posición a un archivo XML de grupo.

Un archivo XML de grupo puede contener una o varias referencias a otros archivos XML de grupo. Sin embargo, no se pueden crear referencias cíclicas, es decir un archivo XML de grupo no puede hacer referencia a si mismo ni a un archivo que hace referencia a otro que a su vez hace referencia al propio archivo, etc. BlueBrick detecta referencias de este tipo durante la carga de la biblioteca de piezas y genera un error si encuentra uno.

Un grupo en la biblioteca de piezas no requiere una imagen .GIF. BlueBrick recrea la imagen de grupo a partir de la descripción del mismo durante la carga de la biblioteca. Al añadir un grupo a un trazado, BlueBrick emplea las imágenes individuales de cada pieza que pertenece al grupo.

Puedes duplicar un archivo XML existente y modificarlo para trabajar más rápido. Ten cuidado, las etiquetas XML requieren correspondencia exacta de mayúsculas y minúsculas. Todos los campos salvo "SubPartList" son opcionales y el orden de los campos no importa. Si falta un campo se usará el ajuste por defecto en su lugar.

Ten cuidado, en el archivo XML, la primera etiqueta, base de la jerarquía, debe ser "group". Es así como BlueBrick distingue entre grupos y piezas.

Codificación del fichero

Para permitir una buena compatibilidad entre plataformas, deberías indicar en el encabezado del fichero XML el codificado en el cual se guarda el archivo. El codificado preferido es UTF-8 porque permite guardar usando caracteres acentuados en la descripción de las piezas en distintos lenguajes. Utiliza un editor de texto para grabar tu fichero XML en formato UTF-8. Por ejemplo, con el programa Bloc de Notas de Windows, elije la codificación correcta en el cuadro de diálogo de guardado::

Y asegúrate de que la cabecera de tu fichero comienza con esta línea:

<?xml version="1.0" encoding="UTF-8"?>

Estructura del archivo XML

Si no sabes lo que es un archivo XML y no estás familiarizado con su sintaxis, te recomiendo que busques ayuda adicional en Internet. Por intentar resumirlo en pocas palabras, este formato organiza la información en un árbol jerárquico por medio de etiquetas que se identifican por estar dentro de los caracteres '<' y '>' (mayor que, y menor que). Esta es una estructura general de un archivo XML de grupo:

<?xml version="1.0" encoding="UTF-8"?>
<group>
    <Author>...</Author>
    <Description>
        <en>...</en>
        ...
    </Description>
    <SortingKey>...</SortingKey>
    <NotListedInLibrary>...</NotListedInLibrary>
    <OldNameList>
        ...
    </OldNameList>
    <ImageURL>...</ImageURL>
    <CanUngroup>...</CanUngroup>
    <SnapMargin>
        ...
    </SnapMargin>
    <SubPartList>
        <SubPart id="...">
            ...
        </SubPart>
        ...
    </SubPartList>
    <GroupConnectionPreferenceList>
        ...
    </GroupConnectionPreferenceList>
</group>

Las diferentes etiquetas XML en detalle

Para una descripción detallada de cada etiqueta XML, se pueden consultar las siguientes secciones: