Skip to content

ATF Glossary

Gary edited this page Sep 29, 2014 · 1 revision

This glossary defines ATF technical terms and utilities.

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

A

adaptable control

Control that can have adapters that add capabilities to the control. See control adapter.

adaptee

An object that is adapted to an adapter and behaves like an instance of the adapter's class. See adapter.

adapter

An object that dynamically casts an object to another type or class. An object can be its own adapter, if it can be cast to the desired type. An adapter for A converts something of a different type than A to the type A. An adapter may also adapt a control to displaying data, such as the TreeListViewAdapter class adapting data to be displayed in a TreeListView control.

adaptation

Technique used to allow one type of C# object to look like another, without using inheritance. Adaptation is the process of dynamically casting an object (adaptee) to a type of the class of the adapter. The adaptee can be treated as an instance of the adapter's class. In terms of software engineering design patterns, adaptation consists of the Adapter and Decorator pattern. See adapter, DOM extension, and DOM adapter.

adaptation framework

ATF framework that allows supporting different kinds of data models and managed data stores, such as a DOM or other CLR objects, by converting objects to other types. See adaptation.

advertise (Bonjour)

Process of a Bonjour server indicating which groups should be seen by network broadcasters and discovered by other Bonjour servers. See Bonjour.

annotation (DOM)

An entry in a type definition that contains additional information about a type that is not in the regular type definition. In an XML Schema, annotations are defined inside the standard XSD <xs:annotation> and <xs:appinfo> tags. In the ATF DOM, annotations can be used to convey information such as the icon used to represent a data type in a palette or the control used to edit a type's properties.

annotation (graph)

A text window added to a graph canvas. See graph.

application shell framework

ATF framework containing core application services and interfaces needed for applications with a GUI. It includes the components ControlHostService, CommandService, SettingsService, and StatusService, or components of similar functionality.

AtfScriptVariables

Component to set script variables for common ATF services. See ScriptingService.

ATGI

Sony intermediate file format (.atgi extension) for exchanging digital assets among graphics software applications. See Collada.

attribute (DOM)

Information describing a type. For example, a type that defines graphical objects could have "x" and "y" attributes to specify a coordinate location on a canvas.

attribute (MEF)

A C# decorator for programming entities. In MEF, a class or item can be decorated with an attribute indicating information MEF uses. Attributes can designate that items are to be imported or exported, for instance.

AutomationService

Component that provides facilities to run automated scripts. See ScriptingService.

B

BasicPythonService

Component that sets up the Python scripting engine and imports many common .NET and ATF types into the Python namespace. See PythonService.

Bonjour

Apple Company implementation of Multicast Domain Name System (mDNS) for zero-configuration networking, enabling automatic discovery of devices and services on a local network using standard IP protocols.

Bonjour server

Any process that initializes Bonjour and has a name.

C

catalog (MEF)

A container class holding components that MEF can compose for an application. There are several kinds of MEF catalogs, deriving from the base class ComposablePartCatalog. ATF mainly uses TypeCatalog, which creates a catalog from a collection of component types. See compose.

channel (Bonjour)

Group of clients subscribing to receive Bonjour messages. Same as message group. See Bonjour.

circuit

A graph where nodes are circuit elements with pins, such as OR gates, and edges are wires connecting pins. See graph, pin.

Collada

Open standard file format (.dae extension) for exchanging digital assets among graphics software applications. The name comes from Colla{}borative d{}esign a{}ctivity. See ATGI.

command

An action invoked from a menu item or tool strip button.

command client

Client class that implements the ICommandClient interface for a command. In addition to performing a command, this interface provides methods to determine whether the command can be performed and to update the command state. See command, command state.

command group

Group of commands with related functions, both in menus and tool strips. For example, File > Save and File > SaveAs are closely related commands, grouped together. See command.

CommandService

Component in the application shell framework that provides a service to handle commands in menus and tool strips. See command and application shell framework.

command state

The CommandState class contains properties describing a command's state: the menu item name and whether its menu item has a check mark. See command.

command visibility

Where command is visible, as on menus, tool strips, and so on, described by the CommandVisibility enum in the CommandState. See command state.

component (MEF)

An object or a C# type that is added to a MEF container, so that the component can discover and use other components without having a hard-dependency between them. See compose.

complex type (DOM)

A type describing elements with attributes and/or child elements. See type definition (DOM), simple type.

compose, composition (MEF)

The process of putting together components into a cohesive whole in an application, where the components meet each others' import and export contracts, specified by their attributes. See component.

connection (graph)

The entity or edge connecting nodes in a graph. See edge, graph.

context

An environment or interrelated conditions in which something exists or occurs. ATF has interfaces and classes to provide services for an application's data and operations in various contexts. The term context is often used to refer to an instance of a context interface or class. A context interface or class can be very general, working with different kinds of data.

context framework

ATF framework that tracks and works with application contexts. See context.

context registry

Component that tracks all context interface or class objects in an application, including the active context, maintaining a collection of context objects. A context registry implements IContextRegistry.

control adapter

Class derived from ControlAdapter that adds capabilities to an adaptable control, such as rendering, view changing, or selection. See adaptable control.

control client, control host client

Client class that implements the IControlHostClient interface for a control. The client specifies the control's behavior, if any, when the control gains or loses focus, or is closed. The control client is specified when registering a control with the ControlHostService. See ControlHostService.

ControlHostService

Component in the application shell framework that implements IControlHostService and is responsible for exposing client controls in the application's main form. See application shell framework.

D

data model

A model of user data in an application specifying the types of application data. See type definition (DOM).

data persistence

See persistence.

define extension (DOM)

Associating a data type with a DOM extension. A type can have any number of DOM extensions defined for it. See DOM extension, initialize extension.

Direct2D

Microsoft 2D vector graphics application programming interface (API).

document

A file containing application data. A class representing documents often implements the IDocument interface.

document client

Class that does the work of handling a document and implements IDocumentClient for operations on the document, mainly file-related, such as open, save, and close.

document framework

ATF framework that enables application components to track documents that a user is working on and which document is currently active.

Document Object Model (DOM) framework

A modeling, management, and persistence framework that provides data management for loading, storing, validating, and managing changes to application or game data. The ATF DOM is unrelated to the W3C DOM. Document Object Model is a term borrowed from XML that describes an in-memory hierarchy of XML elements.

document registry

A component that tracks all documents an application has open. A document in this context is any object implementing IDocument.

DOM adapter (DOM)

An ATF DOM extension derived from the DomNodeAdapter class, which provides an infrastructure for connecting an extension to its underlying DOM node, as well as many useful methods and properties for DOM extensions. See DOM extension.

DomExplorer

A MEF component you can use to visualize the contents of a DOM node tree. See Dom node, component (MEF).

DOM extension (DOM)

A class that extends or adapts a DomNode's data type to another type. If you adapt a DomNode to a DOM extension, the DomNode is dynamically cast to the DOM extension class's type. An extension can also listen to events on Dom nodes. See DOM adapter.

DomGen (DOM)

A utility that, given an XSD type definition file, generates a set of type metadata classes you can reference — instead of names inside the type definition file.

DOM metadata (DOM)

Classes that represent data associated with types. These classes can be used to provide information about the primitive data type associated with a type or the type's attributes, for instance. The DomNodeType metadata class represents the type of a DomNode.

DomNode, DOM node (DOM)

A node in a tree that represents a piece of application data. Each node has a DomNodeType that specifies the type of the node's data. See DOM node tree.

DomNodeAdapter (DOM)

See DOM adapter.

DOM node tree (DOM)

A tree of DOM nodes representing all the application's data. See Dom node.

DomNodeType (DOM)

Metadata class representing the type of a DomNode. See DomNode and DOM metadata.

DomRecorder (DOM)

Component that records DOM events on the active context and displays them in a list in a window.

E

edge (graph)

A connection between nodes in a graph. See connection, graph.

entity-relationship modeling (DOM)

A way of representing entities and the relationships between them. For example, DOM types have attributes associated with them.

export (MEF)

An attribute indicating that a component is making a class, property, or some item available to other components. See import.

G

ghost (timeline)

When a timeline object is moved, a ghosted copy of the timeline object moves to indicate the possible positions of the object. See timeline.

graph

Collection of nodes with connecting edges. Graphs can be specialized to other forms, such as circuits and statecharts. ATF offers a rich facility for handling graphs. See circuit, statechart.

GridPropertyEditor

Property editor component that displays items with properties in a spreadsheet type control, allowing you to see the properties of all selected items. See property editor, PropertyEditor.

group (graphs)

Group of circuit items treated as a single element in the circuit. See circuit.

group (Bonjour)

Group of clients subscribing to receive Bonjour messages. Same as channel or message group. See Bonjour.

group (timeline)

Container for zero or more tracks in a timeline. See timeline and track.

H

hit

A result of a picking operation to click on some object. See pick.

hit record

Encapsulated results of a hit from a picking operation to click on some object. See hit and pick.

I

ID attribute (DOM)

An attribute to uniquely identify objects of a given type.

import (MEF)

An attribute indicating that a component needs a class, property, or some item from another component. See export.

initialize extension (DOM)

Associating a DomNode with a DOM extension that is defined for the type of the DomNode. A node can have any number of DOM extensions associated with it. After intialization, a DOM node can be treated as an instance of the adapter's class. The extension can also listen for events on the DomNode and its children. See DOM extension, define extension.

instancing framework

ATF framework that works with object instances that can be edited, that is, copied, inserted, or deleted. It enables inserting objects, such as typing text onto a page, pasting from a clipboard, or dropping a circuit element onto a canvas.

interval (timeline)

An event of zero or greater time duration on a single track in a timeline. See event, timeline, and track.

K

key (timeline)

An event of zero-length time duration on a single track in a timeline. See event, timeline, and track.

L

LiveConnectService

Component to initialize and simplify using Bonjour to enable automatic discovery of devices and services on a local network and communicate between them.

M

Managed Extensibility Framework (MEF)

A Microsoft library for creating extensions or components that can discover each other with no configuration required, avoiding hard dependencies.

manipulator (timeline)

Class to manipulate timeline objects, such as intervals, in a timeline control. See timeline.

marker (timeline)

An event of zero-length time duration on all tracks in a timeline. See event, timeline, and track.

master (graphs)

A collection of circuit elements that can be copied and reused. Changing one master changes them all. See circuit.

MEF component

See component (MEF).

message group (Bonjour)

Group of clients subscribing to receive Bonjour messages. Same as channel or group. See Bonjour.

metadata

Data describing other data. In the ATF DOM, metadata classes provide information about types in the data model. See DOM metadata.

Multicast Domain Name System (mDNS)

Zero configuration host name resolution service, used by Bonjour. For more information, see the Wikipedia article Multicast DNS. See Bonjour.

N

node

A data point (DomNode) in a tree of application data. An item to be connected in a graph. See DomNode, graph.

NUnit

Unit-testing framework for all .NET languages. For more information, see the NUnit site.

O

Open Sound Control (OSC)

Open, transport-independent, message-based protocol developed for communication among computers, sound synthesizers, and other multimedia devices, according to its specification. For a general introduction to OSC on Wikipedia, see Open Sound Control and The Open Sound Control 1.0 Specification.

OSC client

Any application that sends OSC packets.

OSC packet

Unit of transmission in OSC.

OSC server

Any application that receives OSC packets.

OscService

Component that handles OSC messages by getting and setting properties on C# objects.

P

palette

Container for items that can be dragged and dropped onto an application, typically onto a canvas control.

part creation policy (MEF)

An attribute indicating how a component is used by its importers. A component may be "Shared", one copy for all importers; "NonShared", one copy for each importer; or "Any", either "Shared" or "NonShared".

persistence

Storing application data, usually as a document, so that it can be later recalled and used or edited. Persistent data is most frequently stored in files. See document.

pick

An operation to click on some object that is then hit. See hit.

pin

A connection point on a circuit element in a circuit graph. See circuit, graph.

property

An attribute of a data object, which may be specified in a data model for the object's type. See attribute (DOM).

property descriptor

Metadata class describing a property/attribute of a data type. It contains information about the property, such as its name, description, and an appropriate value editor for the property, given its data type. Used by property editors. See value editor.

property editing framework

ATF framework that works with contexts that allow properties to be edited by controls. ATF offers a variety of property editor controls to edit object properties of various types. See attribute (DOM), property.

property editor

Control showing properties of selected items, containing value editing controls. ATF provides the PropertyEditor and GridPropertyEditor components for property editing.

PropertyEditor

Property editor component that displays items with properties in a two-column, multi-line control, showing properties of one selected item. See property editor, GridPropertyEditor.

prototype

A collection of items that can be copied as a named prototype and then be copied back into the application for reuse. See template.

PythonService

Component that provides a dockable command console for entering Python statements. See BasicPythonService.

R

reference

A relationship between arbitrary elements in a data model. In the ATF DOM, a reference can be an internal reference from one DOM node to another or an external reference to an external resource, such as a URI.

register command

Add a command to the user interface that can be executed from a menu item or tool strip control.

restriction (DOM)

A limitation on data type values that validators in the DOM can automatically check. Restrictions can be defined in the type definition. See validator.

S

schema (DOM)

A set of type definitions, usually in the XML Schema Definition Language. In the DOM, usually synonymous with type definition. See schema loader, type definition (DOM).

schema loader, schema type loader (DOM)

Class that reads a type definition file and converts types to metadata objects containing the types' information. Typically inherits from XmlSchemaTypeLoader. See schema, XMLSchemaLoader.

ScriptConsole

Scripting console window component. See ScriptingService.

ScriptingService

Abstract base class for services (MEF components, for example) that can expose C# objects to a scripting language. See AtfScriptVariables, AutomationService, ScriptConsole.

scrubber (timeline)

Vertical black line that is visible on the timeline, but is not part of the timeline. Events are raised when you move the scrubber on the timeline, and your application can take some action in response to these events, such as setting the current time.

SettingsService

Component in the application shell framework that manages user-editable settings (preferences) and the persistence of these application settings. See application shell framework.

simple type (DOM)

A primitive type, such as integer and float, date and time, and string, as well as a special type like URI. See type definition (DOM), complex type.

statechart

A graph where nodes are states and edges are transitions, as in a state machine. Also known as a state transition diagram. See graph.

state transition diagram

See statechart.

StatusService

Component in the application shell framework that provides a global status text panel on the application's StatusBar and adds a display to show an operation's progress. See application shell framework.

subscribe (Bonjour)

Binding a group to a callback that processes messages to that group. See Bonjour.

sub selection

Selection inside another selection. For instance, a selected attribute of a selected item, as might be highlighted in a property editor.

T

template

An item that can be copied as a named template and then be copied back into the application for reuse. See prototype.

timeline

Graphical representation of a time-sequence. Timelines contain groups that can contain tracks that can contain events, which can be intervals, keys (zero-length intervals) and markers (zero-length events that are on all tracks). See event, group, interval, key, marker, and track.

track (timeline)

Container in a timeline's group containing zero or more events. See event, group, and timeline.

TypeConverter

Class in System.ComponentModel that value converters derive from. See value converter.

type definition (DOM)

A definition of a type in a data model. A type definition can be represented in a variety of languages, including XML Schema Definition Language, which is the default in ATF. See data model, type definition file (DOM).

type definition file (DOM)

A file containing type definitions for a data model. See data model, type definition (DOM).

type loader

See schema type loader.

U

UITypeEditor

Commonly used base class in System.Drawing.Design for a value editor with a value editing control that drops down a control or displays a modal dialog. See value editor, value editing control.

V

validator (DOM)

A DOM adapter that performs automatic validation of DOM data as it changes. See DOM adapter.

value converter

Class that converts a property value between its data representation in a value editor and a type displayable in a value editing control. Typically derived from System.ComponentModel.TypeConverter. See TypeConverter.

value editing control

Control class displaying a property value that interacts with a user to change the value. Typically associated with a value editor. See value editor.

value editor

Class associated with a property to edit its value, typically associated with one or more value editing controls. May derive from UITypeEditor. See value editing control.

W

Windows® Forms (WinForms)

The graphical application programming interface using the Windows® API and GDI, included as part of the Microsoft .NET Framework. You can create Windows® Forms applications with ATF. See Windows® Presentation Foundation (WPF).

WinForms

See Windows® Forms.

Windows® Presentation Foundation (WPF)

The graphical subsystem for rendering user interfaces in Microsoft Windows®-based applications using DirectX instead of GDI and the Windows® API. You can create WPF applications using ATF. See Windows® Forms (WinForms).

wire

A connection between pins in a circuit graph. See connection, circuit.

X

XML Schema Definition Language (XSD), XML Schema

An XML-based language for specifying the structure of an XML document. In the ATF DOM, can be used to define the data model's types. For a reference, see http://www.w3schools.com/schema. See data model, type definition (DOM).

XmlSchemaTypeLoader

ATF DOM class that does much of the work of loading and managing an XML schema. See schema type loader.

Clone this wiki locally