Tell me more about graphic attributes

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

=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:



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).