Enabling Graphics Support for a Document Type

Graphic elements and their attributes are defined in the document type. However, before graphics can be inserted and manipulated in a document, the graphic elements and their attributes must be configured in the document type configuration file (.dcf file). Review your document type to determine the graphic elements and their attributes since not all graphic settings in the .dcf file are valid for all graphic elements.

Note also that if the document type has an associated .style file, then any graphics elements must be styled in Arbortext Styler before the graphics will appear in the Arbortext Editor window. See the Arbortext Styler Help for more information on styling elements.

Arbortext Styler imports information from a document type's .dcf file when you create a new stylesheet for the document type. However, once a stylesheet is associated with a document type, any changed settings in that stylesheet override the original settings in the document type's .dcf file.

To enable graphics support for a document type:

3. Locate the directory in which the document type whose .dcf file you want to modify is saved, and click Select.

4. Once the document type is loaded, choose Edit > DCF. If the document type has a .dcf file, it displays in the Arbortext ArchitectDCF Editor window. If there is no .dcf file associated with this document type, Arbortext Architect automatically creates one.

5. Locate the Specials element in the DCF Editor. If the file doesn't include a Specials element, add one.

Open the Document Type Viewer (Tools > Document Type Viewer) to view the element hierarchy for the .dcf file. This will help you determine the valid location for the Specials element.

6. Place your cursor next to the Specials element, choose Insert > Markup, and then choose Graphic.

You must have the Force Required Attributes EntryEdit preference selected for this dialog box to open automatically.

8. In the element field, select the element that you want to define as a graphic element.

9. Specify whether the graphic element will use file names or entities to reference graphics. If you specify both an entity attribute and a file name attribute for an element, Arbortext Editor will use the file name.

◦ filename — Enter the name of the attribute that will hold the path and file name of the graphic.

◦ entity — Enter the name of the attribute that will hold the entity name for the graphic file.

◦ cropHeight — Enter the name of the attribute whose value supplies the height dimension when cropping the graphic.

◦ cropLowerLeftX — Enter the name of the attribute whose value supplies the lower left X coordinate to be used as a starting point for cropping.

◦ cropLowerLeftY — Enter the name of the attribute whose value supplies the lower left Y coordinate to be used as a starting point for cropping.

◦ cropWidth — Enter the name of the attribute whose value supplies the width dimension when cropping the graphic.

◦ inline — Enter yes if the element is an inline graphic element. The default is no.

◦ horizOffsetAmount — Enter the name of the attribute whose value supplies the amount of horizontal offset at which the graphic displays.

◦ horizOffsetPercent — Enter the name of the attribute whose value supplies the percentage of the width of the graphic to offset horizontally when displayed.

◦ horizScale — Enter the name of the attribute whose value supplies the percent magnification at which the graphic displays.

This setting is not supported in this release. Arbortext Editor uses the value specified for horizScale for both horizontal and vertical scaling.

◦ notation — Enter the name of the graphic notation attribute. For graphics, the notation would likely correspond to a file format (for example, EPS, TIF, or GIF) within the DTD.

◦ primary — Choose yes if you want the selected element to be the primary graphic element. The default setting is no.

If there are multiple elements with primary set to yes, then the last element in the list is considered the primary graphic element. If no element has primary set to yes, then the first element in the list is considered the primary graphic element.

Arbortext Editor inserts the primary graphic element when users select Insert > Graphic (when set promptgraphictags is set to off).

◦ processor — Enter the name of the attribute whose value specifies the graphic’s processor type.

Use The processor attribute when graphic processor access is supported on the Windows version of Arbortext Editor. This allows users to open a graphics processor from Arbortext Editor.

◦ reproDepth — Enter the name of the attribute whose value supplies the height (depth) dimension when scaling the graphic.

◦ reproWidth — Enter the name of the attribute whose value supplies the width dimension when scaling the graphic.

◦ view — Enter the name of the attribute whose value supplies the initial view to display for an intelligent graphic.

If you use an Arbortext Styler stylesheet (.style file) to control the display in Arbortext Editor, you must also define the view attribute in the Arbortext StylerGraphic Details dialog box. Refer to the Arbortext Styler help for more information about that dialog.

◦ resolution — Enter the name of the attribute whose value supplies the resolution at which the graphic was created.

◦ scaleToFit — Enter the name of the attribute whose value enables the scale-to-fit feature for the graphic.

◦ vertOffsetAmount — Enter the name of the attribute whose value supplies the amount of vertical offset at which the graphic displays.

◦ vertOffsetPercent — Enter the name of the attribute whose value supplies the percentage of the height of the graphic to offset vertically when displayed.

◦ vertScale — Enter the name of the attribute whose value supplies the percent magnification at which the graphic displays.

This setting is not supported in this release. Arbortext Editor uses the value specified for horizScale for both horizontal and vertical scaling.