Customizing the metamodel > Keywords for USRPROPS > DEPICTIONS
  
DEPICTIONS
The DEPICTIONS keyword identifies how a symbol can be represented by an image file that you supply.
Menu images must be bitmaps.
Diagram images can be metafiles (WMF, EMF or EMF+), BMP, JPG, PNG or SVG.
You can specify how this symbol is depicted on the diagram workspace by using the DEPICTIONS keyword combined with the DIAGRAM keyword. Also add the RETAIN STYLE keyword to the syntax if it is important to retain the style of the image that you are using. This maintains the original coloring and style of the symbol in the tool but is only supported for windows metafiles.
You can also specify how the symbol is depicted in the toolbox and Draw menu by using the DEPICTIONS keyword combined with the MENU keyword. You can also use the DEPICTIONS keyword in a list, so that the symbol is depicted in different ways based on the value of the list that is selected. Where a symbol type supports a property-based depiction and a body depiction, the user has an extra couple of menu options, to show as symbol type, to show according to property. The type or property label/name is presented where available.
Use of the DEPICTIONS clause forces a symbol to have its name presented outside the symbol, unless text borders are specified (see the BORDERS keyword). Without this, the assumption is made that there is no space for the name in the specified image.
Note A symbol's 'Symbol Depiction' value overrides its definition's 'Definition Depiction' value. These override all other depictions. A symbol's list property depiction overrides a symbol's body depiction and that overrides the definition body depiction which overrides any supertype definition body depiction.
Depiction keyword specification hierarchy
Depiction specified for List property in symbol overrides depiction specified against symbol type which overrides depiction specified against definition type which overrides depiction specified against supertype definition.
Syntax 1
SYMBOL symbol-type-name
{ ...
DEPICTIONS { DIAGRAM RETAIN STYLE depiction-file }
DEPICTIONS { MENU depiction-file }
...
}
depiction-file is the name and full path of a metafile or a bitmap.
Example 1
Rename Symbol "User 3" To "Radar"
SYMBOL "Radar"
{ ASSIGN To "Wireless Network"
DEPICTIONS { DIAGRAM RETAIN STYLE "C:\Program Files\UNICOM Systems\System Architect\Pictures\radar.bmp" }
DEPICTIONS { MENU "C:\Program Files\UNICOM Systems\System Architect\Pictures\radartoolbar.bmp" }
}
Syntax 2
List "..."
{
VALUE "..." DEPICTIONS {...}
}
Example 2
List "Class Stereotypes"
{
Value "actor" DEPICTIONS {DIAGRAM RETAIN STYLE images\slctact.wmf MENU images\slctact.bmp}
Value "boundary" DEPICTIONS { DIAGRAM RETAIN STYLE images\slctbndy.wmf MENU images\slctbndy.bmp}
...
}
DEFINITION "Class" {
PROPERTY "Stereotype"
{ EDIT Text LIST "Class Stereotypes"
INIT_FROM_SYMBOL Default "" LENGTH 20 }
...
}
Syntax 3
DEFINITION definition-type-name
{ ...
DEPICTIONS { DIAGRAM RETAIN STYLE depiction-file }
DEPICTIONS { MENU depiction-file }
...
}
See also
Depicting a symbol with an image
DIAGRAM
MENU
RETAIN STYLE
Keywords for USRPROPS