Tell me more about graphic attributes
Answered by: Lynn Hales and Andy Esslinger
Last updated: 2006-09-19
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.
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.
This is a value that when read by the style sheet will move the graphic horizontally the specified amount (what ever it may be).
This is the same thing as above, only it uses a percentage (am I brilliant or what [Ed don't even go there]) :D
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).
This provides a specific area for the graphic to fit into height wise.
This is the width area for your graphic.
This is a toggle 0 or 1 that is supposed to have the graphic automatically scaled to fit the specified area.
This is the vertical offset that corresponds to the horizontal above.
This is a value to scale your graphic vertically. Used with the horizScale.
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).
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.
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:
(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).