Model Control Options

OptionsDescription

-sysdef file/uri

Location for the System Definition XML file(s) used to build the model. Multiple files will be merged according to the normal rules. Can specify multiple times.

-srcvar

The root directory (in the local filesystem) for the system definition. The order of this parameter must match the order of the -sysdef parameter. Can specify multiple times.

-sysdef-prefix

Can specify multiple times.

-sysdef-path path

The directory which the system definition file should be considered to be in when turning unit's relative links into absolute paths. This is only necessary to provide if the result requires the absolute paths to be meaningful. The order of this parameter must match the order of the -sysdef parameter. Can specify multiple times.

-detail item-type

The type of the smallest System Model entity to draw. One of layer, package, collection or component. Defaults to component

-detail-type fixed

If set to fixed, the smallest System Model entity drawn will have a fixed with (rather then sized by their invisible components). This can be used to reduce the size and complexity of the overall model.

-filter-has filter-name

Like -filter, except any filter on an item must be present in this list in order for that item to appear. Include * in the list in order to show items with no filters.
Equivalent to -show-attr filter xxx

-show-attr attr=val

A mechanism of filtering which allows filtering based on component attribute values. If a value is set for that attribute, the component will be shown. Use in conjunction with -hide-attr for fine contol of what is shown. class and filter attribtues are handled specially -- see the documentation for details

-hide-attr attr=val

A mechanism of filtering which allows filtering based on component attribute values. If a value is set for that attribute, the component will not be shown on the model. Use in conjunction with -show-attr for fine contol of what is shown. class and filter attribtues are handled specially -- see the documentation for details

-ignore item

The ID of a model entity to not draw. Any number of these can be used. Can specify multiple times.

-ignore-meta rel

The rel meta value to ignore. Takes the form of "relvalue" or "relvalue:type". Can specify multiple times.

-version-list

Specifies the space-separated list of version numbers, ordered from oldest to newest. This is used to compare version numbers in the VERSION rule function. If not present, the value used are the Symbian Ltd version numbers from ER5 through 9.5 and Symbian Foundation version numbers from ^1 onward. Future is always last.

-placeholder item-type

The type of the smallest empty System Model entity to draw. One of layer, package, collection or component. For example, if set to package empty layers and packages will be drawn, but empty collections will be ignored. If not set, no empty items will be drawn.

-level-detail [show/hide]

Toggles display of level names on packages or layers. A value of show will display level names inside either layers (at layer level of detail only) or packages (at package level of detail only). A value of hide (default) will not show any level names.

-legend-width %

The percent width of the model the legend takes up. This will scale the size of the legend and model title, but not the logo, to fill the specified space. If a logo is included, but no width specified, the legend cannot be scaled since it will not be able to determine the available space.
Note that that -max-legend-scale will further limit the potential width.

-legend-max-scale scale

Specifies the maximum scale factor for resizing the legend. If this is present and -legend-width is not, the legend and title will scale to 100% of the available width. If both are present the scale factor will take precedent. If neither is present, the legend will not resize.

Note that when this is used, the legend can shrink if it would normally be wider than the model.

-title-scale scale

Specifies the scale factor for the size of the title font (the text in the lower right).

Use this instead of CSS to control the size, since the model generator needs to explicitly know how much space to allocate for the title.

-logo file/uri

If present, the logo will be drawn in the lower- left corner of the model. If the logo is an SVG file, -logo-width and -logo-height are optional, otherwise the must both be specified

-logo-height length

Specifies the height of the logo (if any) in mm. Width is scaled along with height unless otherwise specified. Both width and height MUST be specified if a bitmap image is used

-logo-width length

Specifies the width of the logo (if any) in mm. Height is scaled along with width unless otherwise specified. Both width and height MUST be specified if a bitmap image is used

-legend_float boolean

If set, the legend will appear when the mouse hovers over the bottom of the window. The floating legend will span the full width of the window. This may not be readable, depending on the amonent of content in the legend.

-static boolean

If present, the model will not have any mouseover effects (this is overriden when drawing dependencies).

-navctrl boolean

If set, a navigation control widget will appear in the upper left corner of the model. The control might not work on some SVG viewers.

-dpi number

The DPI to use when printing from the Adobe SVG Viewer. If not present, it will print well at A4 size. A value of 300 will look good on A3 size paper

-model_font font

The name of the base font to use to draw the model. This will be overriden by any custom CSS in the Shapes XML

-link-expr expression

The link used on any system model item. Any values within {...} are evaluled as an expression on the item. All xpath locations in the expresion must be set otherwise the link will not be created for the item. Can specify multiple times.

-filter filter-name

The name of a filter to turn on when building the model. All filters on an item must be present in this list in order for that item to appear. Can have any number of these Defaults to java and gt. Can specify multiple times..
DEPRECATED: Only works on 2.0 syntax and older models

-coreos [on/off/new]

Turn on or off Core OS colouring for 9.4 and later models -- For backwards compatibility only! Use on for Symbian OS 9.4 models and new for Symbian OS 9.5 and later models (non- Foundation)

-page-width length

The width of the drawn image (with units). If not specified it will fit the viewer window. Valid units: in, mm, cm, px, pt.
DEPRECATED: Only works on 2.0 syntax and older models