From AdeptersWiki

Answered by: Lynn Hales and Andy Esslinger
Last updated: 2006-09-19

Contents 1 Lynn Hales 1.1 filename 1.2 entity 1.3 horizOffsetAmount 1.4 horizOffsetPercent 1.5 horizScale 1.6 reproDepth 1.7 reproWidth 1.8 scaleToFit 1.9 vertOffsetAmount 1.10 vertOffsetPercent 1.11 vertScale 1.12 notation 1.13 processor 1.14 resolution 2 Additional notes by Andy Esslinger 3 Lynn Hales about graphic coordinates

Lynn Hales

filename

This is one of the two methods Epic uses to locate a graphic. If your DTD/Schema has a CDATA value for your graphic locater attribute (in most CALS DTDs, this is the 'boardno' attribute). In your DCF file, enter the name of the attribute next to filename.

entity

This is the other, and because it was started in the SGML days, probably slightly more prevalent (though IMHO more tedious) method of identifying your graphic locater. Again, it is an attribute in your DTD/schema that is declared as an ENTITY. Same rules for the DCF apply only under the entity value.

horizOffsetAmount

This is a value that when read by the style sheet will move the graphic horizontally the specified amount (what ever it may be).

horizOffsetPercent

This is the same thing as above, only it uses a percentage (am I brilliant or what [Ed don't even go there]) :D

horizScale

This is a value that tells the processor how much to scale a graphic horizontally. For example a value of 50 would reduce the horizontal scaling by 50 percent. Epic will read only the smaller of the values if they are not the same (see help 5122).

reproDepth

This provides a specific area for the graphic to fit into height wise.

reproWidth

This is the width area for your graphic.

scaleToFit

This is a toggle 0 or 1 that is supposed to have the graphic automatically scaled to fit the specified area.

vertOffsetAmount

This is the vertical offset that corresponds to the horizontal above.

vertOffsetPercent

Guess. :)

vertScale

This is a value to scale your graphic vertically. Used with the horizScale.

notation

This is a DTD/schema entry that specifies the type of graphic you are dealing with. See help 5053 for some more info on this. Basically, a graphic is not XML data, so the system has to know how to process this non DATA (NDATA).

processor

Most likely the application that is going to process the graphic, but again, I don't use this one, so this is just a guess.

resolution

Think this one is obvious, but defined in help 707.

The ones you probably will need are the filename or entity (unless you want to locate your graphics both ways), hscale, vscale, reprowidth and reprodepth. Just read your the other help topics so you don't enter conflicting values.

Additional notes by Andy Esslinger

• do not use both horizScale and vertScale
• cropLowerLeftX: name of attribute containing graphic start coordinate
• cropLowerLeftY: name of attribute containing graphic end coordinate
• cropWidth: name of attribute containing right upper coordinate data
• cropHeight: name of attribute containing left lower coordinate date
• do not use both scaleToFit and horizScale/vertScale

Any attribute you don't use can be left out the way I left out "filename" in this DCF:

<Graphic 
 element="graphic" 
 entity="boardno"
 horizScale="hscale" 
 vertScale="hscale" 
 cropLowerLeftX="coordst" 
 cropLowerLeftY="coordend"
 cropWidth="rucordra" 
 cropHeight="llcordra" 
 reproDepth="reprodep" 
 reproWidth="reprowid" 
 scaleToFit="scalefit"/>

Some of these are "boolean" (0 or 1) (scaleToFit) and some require measurements (repoDepth, ReproWidth) in inches or picas or millimeters, etc. and some require a string (filename, element, entity) and some require graphic coordinates of some sort of X-Y axis that I do not understand. (Editor's note by Karl Johan Kleist: see comment by Lynn below... )

<!ENTITY % graphatt
 "id ID #IMPLIED
 boardno ENTITY #REQUIRED
 graphsty NMTOKEN #IMPLIED
 llcordra CDATA #IMPLIED
 rucordra CDATA #IMPLIED
 reprowid NUTOKEN #IMPLIED
 reprodep NUTOKEN #IMPLIED
 hscale NUMBER #IMPLIED
 vscale NUMBER #IMPLIED
 scalefit %yesorno; #IMPLIED
 hplace (left | right | center) #IMPLIED
 vplace (top | middle | bottom) #IMPLIED
 coordst CDATA #IMPLIED
 coordend CDATA #IMPLIED
 color %yesorno; '0'
 icon (yes|no) 'no'
 %chgatt; ">

Lynn Hales about graphic coordinates

Take a look at MIL-HDBK-28001, para 10.11.14.3 which describes on method of coordinate marking. :) If anyone is interested, you can get a copy of it from here:

http://assist.daps.dla.mil/quicksearch/basic_profile.cfm?ident_number=116920

(Editor's comment by Karl Johan Kleist: For the reader's convenience, this very paragraph: )

10.1.14.3 World coordinates. The world coordinate system is used to describe the twodimensional space in which the graphic is defined and placed. The point of origin is the lower left corner of the graphic and has the coordinates (0,0). The upper right corner has the coordinates (10000, 10000).