Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
The origin (0,0) of the label is the top left corner. The x coordinate increases left to righ
t while the y coordinate increase
s top
to bottom. There are no limits to how large a label you can create.
X
(0,0)
Y
Coordinates can be specified in inches, mm, or cm. All coordinates are by default absolute positions unless the
position=relative attribute is used which makes the value interpreted as relative to the last item in the normal flow. This
applies to the following elements: X, Y, left, right, top, bottom.
For example:
<x>1.5</x>
<x position=relative>1.5</x>
Conditional Fields
EasyPower has the ability to set condition s on label items. For example, you ma y want to use a different color for
different PPE levels or differ ent text or images based on equipment kV.
Adding a condition to label items allows
you to customize a label for a specific condition. Condition s are specified as an attribut e of the item you want to
modify as follows:
<tag condition=variable.OP.value>
where
variable
OP
value
Type
Integer
Boundary
IncidentEnergy
HazardDistance
kV
Volts
BoltedFaultAmps
BoltedFaultKA
FedBy
EquipName
Float
Float
Float
Float
Float
Float
Float
String
String
Description
PPE level starting with 0 for lowest value, maximum value is
determined by the number of entries in the device library.
Arc flash boundary
Incident energy
Working distance (in current units)
Bus voltage in kV
Bus voltage in volts
Bolted fault in amps
Bolted fault in kA
Equipment name of fed by equipment
Equipment name
Description
Equals
Not Equal
Less Than
Greater Than
Less than or Equal
Greater than or Equal
Checks if string is contained in variable
Checks if variable starts with specified string
Valid for
Integers, Floats, Strings
Integers, Floats, Strings
Integers, Floats
Integers, Floats
Integers, Floats
Integers, Floats
Strings
Strings
Examples
<Color condition=PPE.EQ.4>#ff0000</Color>
<Color condition=PPE.LT.4>#00ff00</Color>
<Color>#000000</Color>
In this example, label text will only print if the equipment name starts with BUS
<Label condition=EquipName.STARTSWITH.BUS>Main Bus</Label>
In this example, font size will be set to 12pt if the bus voltage is greater than 480.25 volts.
<PointSize condition=Volts.GT.480.25>12</PointSize>
In this example, the entire item will be printed on when bolted fault amps is greater than 100 amps.
<Text condition=BoltedFaultAmps.GT.100.0>
other properties go here
</Text>
Properties
The Properties section allows you to specify informati
the following options.
Field
Author
Organization
Created
Title
Language
Required
No
No
No
Yes
No
Default
English
on about this document for the Arc Flash label and can have
Description
Authors name
Organization
Date created(format: yyyy-mm-ddThh:mm:ssZ)
Template title (this will show in EasyPower Print Options dialog)
Language (this will show in EasyPower Print Options dialog). This
will also be used for the %Month% variable.
Settings
The Settings section allows you to specify certain settings for the Arc Flash label and can have the following
options.
Field
Units
Required
No
Default
inches
LabelsPerPage
No
1x1
FontName
PointSize
Escapement
No
No
No
Arial
9
0
Bold
No
Italic
No
Color
No
#000000
(black)
Description
Units for Arc Flash label elements. Valid values are:
inches
mm
cm
Number of labels per page. Valid values are:
1x1 - single label per page
2x1 - 2 rows by 1 column per page
2x2 - 2 rows by 2 columns per page
Default font name
Default font point size
Default font escapement specifi
ed in 1/10 of an angle. So for 90
degree text you would specify 900.
Default bold font
0 = normal
1 = bold
Default italic font
0 = normal
1 = italic
RGB value of color of the default font, format #rrggbb
Sample:
<Properties>
<Author>John X. Programmer</Author>
<Created>2006-05-16T10:12:00Z</Created >
<Title>Standard Label (4x6 inches)</Title >
<Language>English</Language >
</Properties>
<Settings >
<Units>inches</Units>
<LabelsPerPage>2x2</LabelsPerPage >
</Settings>
Rectangles:
Field
left
top
right
bottom
LineWidth
Color
Required
Yes
Yes
Yes
Yes
No
No
FillColor
No
Default
2
#000000
(black)
#ffffff
(white)
Description
Left coordinate of rectangle in specified units
Top coordinate of rectangle in specified units
Right coordinate of rectangle in specified units
Bottom coordinate of rectangle in specified units
Width of the line around the rectangle
RGB value of color of the rectangle line, format #rrggbb
RGB value of fill color of the rectangle, format #rrggbb
Sample:
<Rect>
<left>0</left>
<top>0</top>
<right>7.25</right>
<bottom position=relative>0.75</bottom>
<LineWidth>2</LineWidth>
<Color>#ff0000</Color>
<FillColor>#ff00ff</FillColor>
</Rect>
Lines:
Field
X1
Y1
X2
Y2
LineWidth
LineStyle
Required
Yes
Yes
Yes
Yes
No
No
Color
No
Default
2
0
#000000
(black)
Description
Starting x value in specified units
Starting y value in specified units
Ending x value in specified units
Ending y value in specified units
Width of the line
Style of the line
0 = Solid
1 = Dash
2 = Dot
3 = Dash Dot
4 = Dash Dot Dot
RGB value of color of the rectangle line, format #rrggbb
Sample:
<Line>
<X1>0</X1>
<Y1>0</Y1>
<X2>7.25</X2>
<Y2>0.75</Y2>
<LineWidth>2</LineWidth>
<LineStyle>0</LineStyle >
<Color>#ff0000</Color>
</Line>
Required
Yes
Default
Description
Static text to display. The following variables are also available:
Variable
%Boundary%
%BoundaryValue%
%IncidentEnergy%
%HazardUnit%
%HazardDistance%
%HazardDistanceValue%
%PPE%
%Clothing%
%kV%
%Volts%
%LimitedDistance%
%LimitedDistanceValue%
%RestrictedDistance%
%RestrictedDistanceValue%
%ProhibitedDistance%
%ProhibitedDistanceValue%
%EquipName%
%FedBy%
%Month%
%Mon%
%MonthValue%
%Day%
%Year%
%Comments%
%CalcMethod%
%Gloves%
%BoltedFaultA%
%BoltedFaultkA%
%FileName%
%BusComments%
%ProjectName%
%ProjectCode%
%Company%
Precision
Units
Y
Y
Y
Y
Y
Field
X
VAlign
Required Default
Yes for
single line
text
Yes for
single line
text
Yes for
multi-line
text
Yes for
multi-line
text
Yes for
multi-line
text
Yes for
multi-line
text
No
top
HAlign
No
left
FontName
PointSize
Escapement
No
No
No
Arial
9
0
Bold
No
Italic
No
Color
No
#000000
(black)
Y
left
top
right
bottom
Description
Starting x value in specified units
Starting y value in specified units
Left coordinate of text in specified units
Top coordinate of text in specified units
Right coordinate of text in specified units if absolute, or width if
relative
Minimum bottom coordinate of text in specified units if absolute, or
height if relative
Vertical alignment of text. Must be one of the following values:
top
bottom
baseline
Horizontal alignment of text. Must be one of the following values:
left
right
center
Font name
Font point size
Font escapement specified in 1/
10 of an angle. So for 90 degree text
you would specify 900.
Bold font
0 = normal
1 = bold
Italic font
0 = normal
1 = italic
RGB value of color of the font, format #rrggbb
Sample:
<Text condition=IncidentEnergy.NE.NULL>
<X>3.625</X>
<Y position=relative>.25</Y>
<VAlign>baseline</VAlign>
<HAlign>center</HAlign>
<Color>#000000</Color>
<Label>%HazardUnit% Flash Hazard at %HazardDistance%</Label>
<FontName>Arial</FontName>
<PointSize>10</PointSize>
<Escapement>0</Escapement>
<Bold>0</Bold>
<Italic>0</Italic>
</Text>
Image: Images are pictures and can have the following attributes . Images will automatically be resized to fit the
given rectangle while preserving the or iginal aspect ratio of the image.
Field
left
top
right
Required
Yes
Yes
Yes
bottom
Yes
ImageFile
Yes
Default
%Warning%
Description
Left coordinate of rectangle in specified units
Top coordinate of rectangle in specified units
Right coordinate of rectangle in specified units if absolute, or width if
relative
Bottom coordinate of rectangle in specified units if absolute, or height
if relative
Path of the graphics file. Supported files types are BMP, JPG, GIF,
TIFF, PNG, ICO, WMF, EMF. Can also be a predefined symbol by
using one of the following variables:
%Warning%
%DangerY%
%WarningW%
Sample:
<Image>
<left>0</left>
<top>0</top>
<right>7.25</right>
<bottom>0.75</bottom>
<ImageFile>d:\pictures\logo.jpg</ImageFile >
</Image>
%Danger%
%BlastY%