To help enforce sensible names in data.
This is the root object of the XML data. It defines the entire DF
Must contain the "ApplicationId" property (unsigned short): this is the identification number of the user application associated with this DF. This information is found in the binary DF header.
Refer to Section 4.5.3.2
this is the name of the DF. It corresponds to the name of the file (not including file extension).
Present in the XML Definition File only
(unsigned char): this gives the implementation dependent library version of the DF as
found in the binary DF header. Refer to Section 4.5.3.2
(unsigned char): this gives the supplement version of the DF as found in the binary DF header.
Refer to Section 4.5.3.2
This section describes how to specify an encoding for User Application DF strings. This can be done through the use of an optional element. The following table describes the charset-encoding XML element (not to be confused with the top-level <?xml encoding=... ?>). Refer to Section 4.5.3.2 for more details on encoding
Defines the character set encoding used for UA DF strings
the name of the encoding to use
the name of the ASCII Extended character set mapping: only applicable if name is A661_ASCII_EXTENDED.
Defines a table of Symbol Graphical Definitions that are stored within the DF.
See Section 5 for more information on Symbol Definitions.
Defines the graphical representation of a symbol
Must contain the "ID" property: an unsigned short value giving the ID number of the symbol
a name for the symbol definition. This name may be referenced elsewhere in the XML file instead of a numeric symbol ID value. Present in the XML Definition File only
Defines the standard representation of a symbol defined within the DF
Defines the focus representation of a symbol defined within the DF
Defines the highlight representation of a symbol defined within the DF
Defines a rectangular sensitive area definition command
The properties available correspond directly to the parameters defined in the
rectangular sensitive area definition command in Section 5
Defines a circular sensitive area definition command
The properties available correspond directly to the parameters defined in the
circular sensitive area definition command in Section 5
Defines a symbol graphical definition command
The properties available correspond directly to the parameters defined per type of symbol definition command in Section 5. Unused pad parameters should not be specified as properties
this gives the symbol definition command object a name. Present in the XML Definition variant of the file only. May be used for descriptive or other purposes, and would not be referenced elsewhere in the XML file.
Present in the XML Definition File only
this gives the type of symbol graphical definition command (e.g., A661_SYMBOL_DEFN_ARC_ELLIPSE).
Refer to Section 5 for the legal symbol graphical definition command types.
Note: the following symbol definition types cannot be used here, since they are handled via the **rectangular_sensitive_area**, **circular_sensitive_area**, **focusrepr**, and **highlightrepr** XML elements:
- A661_SYMBOL_DEFN_RECTANGULAR
- A661_SYMBOL_DEFN_CIRCULAR
- A661_SYMBOL_DEFN_FOCUS
- A661_SYMBOL_DEFN_HIGHLIGHT
Defines an animation law table that is stored within the DF.
Defines an animation law table that is stored within the DF.
The following properties define an animationlawdefncmd element:
- AnimationLawId (ushort) : the animation law ID
The other properties available correspond directly to the parameters defined per type of animation law
definition command in Section 9. Unused pad parameters should not be specified as properties
this gives the animation law definition command object a name
this gives the type of animation law definition command (e.g., A661_ANIMATION_LAW_DEFN_EASING_CURVE).
Refer to Section 9 for the legal animation law definition command types
Defines a block of picture definitions that are stored within the DF.
See Section 7 for more information on Picture Definitions.
The picturetable defines the set of picture definitions stored in the DF.
A picturetable corresponds to the sequence of PictureBlockStructure blocks found near the top of the binary DF
Defines a local picture in a DF. A PNG (Portable Network Graphics) file is used to store the pixel data and image size. The PNG file format supports lossless compression and a variety of pixel formats
The following properties define a picturedefn element:
- PictureReference: ushort: a numeric identifier that widgets such as Picture and Picture PushButton use to identify a bitmap they wish to display
- ImageFile (string): file pathname specifying a PNG (Portable Network Graphics) file that contains the image contents and specifies the image size in pixels. The path may be relative or absolute. Relative pathnames are relative to the directory which contains the XML DF file containing the a661_picture_defn element. Note: it is recommended to avoid the usage of absolute pathnames to help make it easier to move XML files from one directory (or machine) to another
- PictureFormat: (uchar): indicates how the picture pixel information will be stored in the binary DF. It does not necessarily correspond to the internal representation of the PNG file itself. The most common PNG internal representations are RGBA-based. It is possible to use an RGBA PNG file in conjunction with any of the picture representations below. In some cases processing could be required to transform the PNG format into the requested binary DF format. This property can have the following values:
-- **A661_PIX_FMT_RGBA_8**: It is easy to extract this format of RGBA pixel information from a PNG file, regardless of its internal representation
-- **A661_PIX_FMT_LUMINANCE_ALPHA_8**: PNG supports a “grayscale with alpha” representation that maps to this directly. If the PNG is in another format that allows non-gray colors its pixel values would be converted to grayscale values
-- **A661_PIX_FMT_COLOR_INDEXED_8**: This setting requires that the PNG file uses 256 or less different colors
- ColorTableFormat (uchar): specifies the format of the color table in the binary DF (only useful if PictureFormat is a color palette format such as A661_PIX_FMT_COLOR_INDEXED_8). The PNG file could have a different representation (e.g., a non-palette representation). This property can have the following values:
-- **A661_PIX_FMT_RGBA_8**: There are no warning or error cases with this choice
-- **A661_PIX_FMT_LUMINANCE_ALPHA_8**: If the PNG is in another format that allows non-gray colors its pixel values would be converted to grayscale values
present in the XML Definition variant of the file only. May be used for descriptive or other purposes.
Defines a layer
Must contain the following properties:
- LayerId (unsigned char): the layer ID number
- ContextNumber (unsigned short): the context number of the layer
- Height (unsigned long): the height of the layer, in 1/100 mm.Present in the XML Definition File only
- Width (unsigned long): the width of the layer, in 1/100 mm. Present in the XML Definition File only
present in the XML Definition variant of the file only. May be used for descriptive or other purposes.
Defines a widget
There is a property specified for each widget D or DR property, **with the following exceptions**:
- **ParentIdent** parameters are not specified using a property because they can be calculated based on the context: 0 if is a top-level widget within the layer, otherwise it is the ParentIdent of the parent widget.
- **WidgetType** parameters are not specified using a property since they are already specified using the type XML Attribute described above
- **UnusedPad** parameters are not specified using properties. Note: all unused pad locations are implicitly zero-filled
these are the extensions of this particular widget
these are the children widgets of this particular parent widget
present in the XML Definition variant of the file only. May be used for descriptive or other purposes.
this gives the type of the ARINC 661 widget (e.g., A661_PUSH_BUTTON)
Defines an extension applied to a widget (i.e., the widget parent node enclosing the a661_extension node)
There is a property specified for each extension D or DR parameter, **with the following exceptions**:
- **ExtensionType**: this parameter is not specified using a property since it is already specified using the type XML Attribute described above
- **UnusedPad** parameters are not specified using properties. Note: all unused pad locations are implicitly zero-filled
present in the XML Definition variant of the file only. May be used for descriptive or other purposes.
this gives the type of the extension used in the widget (e.g., A661_LEGEND_ALIGN_EXTENSION)
Contains the property settings of an object. The object is not necessarily only a widget.
Refer to all XML elements that specify Properties
Sets a simple property value
the name of the property
the simple value of the property
Sets a struct-valued property value
Each child element specifies the value of a field of the structure property
the name of the property
Sets an array-valued property value
Each child element specifies the value of an element of the array property
the name of the property
Specifies the value of a simple field value within a structure
the name of the field
the simple value of the field
Specifies the value of an array-typed field value within a structure
Each child element specifies the value of an element of the array value.
The children are given in the order in which they appear in the array
the name of the field
Specifies the value of a structure-typed field value within a structure
Each child element specifies the value of a field of the sub-structure value
the name of the field
Specifies the value of a simple entry within an array
the simple value of the array entry
Specifies the value of an (x,y) coordinate-typed entry within an array
the x coordinate of the array entry
the y coordinate of the array entry
Specifies the value of an array-typed entry within an array.
Note: this could be a way to specify multi-dimensional arrays
Each child element specifies the value of an element of the array value
Specifies the value of a structure-typed entry within an array
Each child element specifies the value of a field of the sub-structure value
Delimits a logical grouping of sequential data values
assigns a meaningful name to the block of data
Specifies a pair of values within a datablock
the first value
the second value
Specifies a simple value (string or numeric) within a datablock
the simple value (i.e. string or number)
This is the root object of the XML data. It defines the entire DF