TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Rose > C++ > Visualize

Visualizing a C++ source file allows the user to view the design aspect of the file as a graphical representation. This command is only available if the Rose product is installed.

The Rose > C++ > Visualize command requires the sienna of the selected source file(s). To generate sienna of a source file, the file needs to be coded with sienna generation (this is a default setting for the Apex C/C++ compiler). For a header file, the corresponding implementation file that includes it should be coded. Please refer to Compile > Code for the details of compilation.

To visualize a set of source file(s) in the view from an Apex directory viewer:

1. . Select the source files for visualization. If the view name is selected, then all the C++ source files in this view will be included in the selection.

2. . Click on Rose > C++ > Visualize.

To visualize all the source files in an Apex editor window, simply click on Rose > C++ > Visualize.

This command completes the following actions:

1. . Checks whether an up-to-date model file already exists for the selected file(s). If it does, then skip to Step 6.

2. . Brings up the Rose Analyzer if it is not already running.

3. . If the project file does not exist, the Rose Analyzer builds it. This project file contains the selected file(s). The newly created project file is stored in the .Rational/Rose_Projects subdirectory of the view. The name of the file is a composition from all the selected source file names.

4. . The Rose Analyzer runs the "Export to Rose" command on all the files listed in the project file to generate a model file. The export option used is an Apex-specific, round-trip engineering option. The model file, of the same name as the project file, is stored in the .Rational/Rose_Models subdirectory of the view.

5. . The property file to be associated with the model file is generated in the same directory as the model file.

6. . The Rose window is raised to display the model file.

When this command is sued from an Apex text editor window, it has a special effect if the name of a class definition is selected or highlighted. Instead of visualizing the source file alone, Rose > C++ > Visualize uses all the source files which contain a base class of the selected class. This allows the visualization of the class hierarchy starting from the class.

If the sienna of the selected source file(s) is not up-to-date, Rose > C++ > Visualize aborts the operation and lists the file(s) that need to be re-coded in a Compile > Code dialog.

The messages for this process are displayed in the Apex Message window and the Log windows of Rose and Rose Analyzer. The model can then be examined from the Rose window. The Rose > C++ > Visualization Summary command can be used to examine the source file(s) used to produce the model.

This product is described in the Rose Developer User's Guide.

Additional Topics

For more information, click on a topic:


Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS