PoolEdit
Contents
1. Paj a e 6 3 Trend Wizard Heading Column Width Heading Row Height Column width Row Height cale Number of Decimals Font attribute Fill attribute cells Line attribute Horizontal justitiation Vertical justification il FA Table Wizard Eaj 32 12 k El 10 x l Heading Row Heading Column Rows mni Columns Ja Offset gl Eaj white T Fill attribute headings silver T 1 T Middle T Middle T Ok Retresh The Trend wizard 1s used to create trend display component out of basic linear bar graph components dan 228 248 158 cl al Feed Eka hal geni width 100 Height 100 EZ Horizontal Mro Bars A EE Min value r Max Value 400 MU Mro Ticks 1 Humbersz Title Feed kaha F Show Title El Trend Wizard l Fill Attribute R x silver T Line Attribute geyi E Grows Lett Down Bar Color Fill Attribute black T grey Line Attribute geyi v L Draw Ticks m Draw Border e Draw Mumbers Font Attribute T OK Refresh 18 6 4 Line Trend Wizard The Line trend wizard is guite similar to the Trend wizard except it uses lines instead of linear bar graphs oH 44 Pressure Lharl width 10 Fill Attribute silver Height 10015 Line Attribute grey Horizontal2. Two links L TAM AT N AttributeCbjects LA FontAttributes L 6 8 root object Simplified Tree View of a pool unnecessary category objects are not shown Picture above shows a pool that has container and font attribute objects in the root level The container has two child objects in it a button and an output string The button has also a string as a child Both output strings link to the same font attributes object 3 3 Obiect Types The ISO 11783 standard speciftes a set of object types The object types are denoted by unigue icons in the Tree view The icons of similar object types have similar colors which makes them easier to recognize Icons for different objects Working set Output string Ml String variable BJ Datamask Output number 118 Font attributes 7 3 Container Rectangle 10 Fill attributes Softkey maakk ib Ellipse B B Inputattributes Softkey b Polygon 122 Object pointer Buton UC gi Meter E Macro E Linear bar graph 54 Auxiliary function Arched bar graph 1 Auxiliary input Picture graphic N E El Inputboolean BB Tnput list Number variable Objects in the root level are grouped by the type e g all containers are under Containers node and these are set under category objects e g WorkingSets DataMasks AlarmMasks and Containers are under TopLevelObjects These catego
3. E Grows Lett Down d L Mro Bars Line attr line black T Fill atir frame rey z Value 200 Line attr frame grey Min i HE A Draw Numbers MH Humbersz E Title Pressure bar Font Attribute blackExe F Show Title OK Fefresh 7 Planned Features Undo Redo Performance improvements especially the Table wizard is very slow when creating large tables In place editing for input and output string objects Navigation macro wizard for creating navigation macros for soft keys Preview function for showing the effects of scaling and color reduction on virtual terminal s display Better macro command support Hierarchical name space compare with Unix style file system with links absolute and relative paths Better validation of object pools many more things should be checked Better error handling Changeable grid spacing and snap to grid features we have the basic grid already Better component libraries and better ways to organize them 19
4. The ISO 11783 standard also known as ISOBUS defines communication network for tractors and agricultural implements PoolEdit is developed in the Automation technology laboratory at Helsinki University of Technology as a part of the Farmix project The editor uses extensible markup language XML for saving and editing graphical user interfaces The collection of graphical user interface objects which makes up the GUI is called an object pool in the standard jargon The PoolEdit XML format is based on the IsoAgLib format with some minor changes XML is also used as an export format The implement control application can read the XML document generate the ISO 11783 binary presentation and load it to the virtual terminal Because the XML file is parsed at runtime when the VT properties are known a smart parser can resize the GUI objects and reduce color depth accordingly Another benefit of the XML format is that it allows the use of symbolic names for referencing the GUI objects where as the binary format relies solely on numeric object IDs Example XML code generated by PoolEdit lt container height 53 name pressuremeter width 64 gt lt ellipse ellipse _type closedsection end_angle 220 height 64 name background pos_x 0 pos_y 0 start_angle 320 width 64 gt lt include_object name black role fill_attributes gt lt include object name greyl role line_attributes gt lt ellipse gt lt outputstring background_col
5. block_font block row 0 name tractorcontainer pos_x 14 pos_y 0 role lt workingset lt datamask background_colour grey namez datamask sinclude object name softkeymask role soft_key_mask gt sinclude_object block_col 0 block_font block name speedmeter pos_x 0 pos_y 0 role f gt sinclude_object block_col 0 block_font block_row 0 namez pressuremeter pos_x 1 pos_y 68 role PoolEdit s basic layout PoolEdit has different views and some other components for managing and editing the object pools 1 Menus Menus are used for issuing file operations running wizards and adjusting various settings 2 Objects New objects are created by dragging them from the object toolbar to the tree model 3 Object View The object view shows how the objects will be rendered on the virtual terminal s display The object view can be zoomed and scrolled and it has various options for precise placement of objects t is also possible to delete resize and move objects in this view 4 Tree View The tree view shows the objects in a single object pool Although object pools are inherently DAGS they can be visualized as trees The tree view shows the types of objects their names and how those objects are related Multiple object pools can be open at the same time Objects can be easily copied between and within the trees 5 XML and Message Views The XML view c
6. that all links are replaced by 16 16 redbar corresponding actual objects SR 16 16 metercomp Voltage 13500 Link ABE 13 56 label 7 whitexe A link is done similarly as copying except that ctrl shift must be pressed throughout 257575 REC 7 23 label2 4 p Hi 19 10 label 5 REE 37 5 label4 8 Move REE 49 9 label5 10 2 Not currently supported as moving objects between documents can be dangerous 11 4 2 2 Drop Menu Right clicking an object in the Tree view opens a drop menu that 1s identical to the drop menu in the Object view See chapter 4 1 2 4 2 3 Attribute and Variable Objects The IsoAgLib XML format denotes attribute and variable references differently than other references Attribute and variable references are specified by XML attributes while other references are described by XML elements lt workingset active mask startMask gt lt include object name logo pos 16 pos 6 lt workingset gt This 1s rather unfortunate as while the included logo reference could be replaced by the actual object the included startMask reference could not The PoolEdit XML format takes a more systematic approach lt workingset gt lt include object name startMask role active_mask gt lt include object name logo pos 16 pos ye 6 5 lt workingset gt All references are denoted by include object elements The same wa
7. PoolEd t User Manual Jouko Kalmar Matti hman 2007 09 14 Table of Contents 1 2 3 7 FOrovonro s edie 3 4 Sucre or m ieeirodola ii e e aa 6 3 1 U10 r e li s 0 a a 6 Sy aka m lar 6 42 ODE 000 0 e e 0 00 SO 8 9 4 1 ODE ENVION bb YAR RE 9 4 1 1 blm alsa 10 4 1 2 TD 652 entiz Balam ala sas Dap bed all daaa aba aaa die 10 4 2 EEE V EW 11 4 2 1 DEE ING IU O eese a bbc 11 4 2 2 Drop M M aaa 0 e o Gem amuda galiya y Sulama 12 4 2 3 AttributeandVarnableObjecis 12 4 2 4 O B Se aa b l aaa deo yaaa qas 12 4 3 ez TAD e e YE b 13 44 14 Creating Loading Saving and Exporting Documents 2222 15 5 1 Creatine New Obicet BOOM alakam EEE a 15 5 kodlu and OVNE an ee a ban al dai 15 5 YL OT b aaa 15 5 3 1 POA Tirlilb ANA E E ndi 15 592 FOOIE dIE al lig ab 15 2 bb N m nasa 15 111 e o o 0 s 0 ei k s 17 6 1 Meter Wizard e eee 17 6 2 WADI Zn ao aaa 18 6 3 APC TVG WY aaa 18 64 Line Trend Wizard a a E 19 Planned bolum aaa 19 1 Foreword PoolEdit is an editor for creating graphical user interfaces GUIs for ISO 11783 compliant virtual terminals
8. an be used for directly editing the generated XML code This is useful for debugging but not needed for normal use The message view not visible in the image is for displaying warning and other messages 6 Attribute Table The attribute table is shows the attributes and the attribute values of the selected object The table has also different editors for editing different attribute types For example the GUI designer can select a colour by picking it from a colour list Object attributes include things like object s width and colour while link attributes specify the position of the object or the role it plays in its parent object Directed acyclic graphs 3 Structure of an Obiect Pool An object pool is a collection of objects Some objects may have other objects inside them PoolEdit has two ways of setting objects inside each other An object can be directly inserted as a child into its parent object Alternatively a special link object can be inserted that points to the actual child object indirectly 3 1 Root Object The root element of the XML document is called objectpool The obyectpool element has the following attributes e The dimension attribute defines the width and height of data and alarm masks The ISO 11783 6 standard specifies the minimum resolution of 200x200 pixels Using this resolution allows the designs to be scaled upwards in the control application before they are loaded to the virtual terminal e The sk wid
9. are replaced must be identical This is great for replacing identical attribute objects Remember that objects can be referenced only if they are located at the root level 10 Bring To Front Moves the object to the front t will be drawn last Bring Forvvard Moves the obfect one step forvvard Send Backvvard Moves the object one step backvvard Send to Back Moves the object to the back t will be drawn first 4 2 Tree View Tree view shows the structure of the object pool as a tree structure Objects that are inside other F library xml X objects are shown as children Links are marked objectpoal with a letter L over the object type icon TopLevelObiecis E WorkingSets 4 2 1 Drag and Drop El workingset datamask The easiest way to copy objects and to create links 14 14 0 tractorcontainer is by dragging and dropping with a mouse 2 DataMasks Objects can be copied within and between datamask documents datamask E datamask C opy Li sottkeymask Uni statuscontainer Copying 1S done by dropping the selected fy 107 27 trendbars object over its new parent object 14 7 27 trendbars Alternat vely the selected object can be mr 116 voltmeter dropped between its new sibling objects I 0 0 background E black Copy is implemented as a deep copy grey l E 15 16 yellowbar which means that all children are copied as 6 16 16 greenbar well and
10. f the Object view that change the visualization of the object pool Zoom in zoom out zooming be also done with mouse wheel m Show hide borders Borders are a thin green dotted line HA Show hide grid The grid is always drawn on the parent of the selected object 2 Show hide tiling Tiling makes zoomed objects look like they would on the virtual terminal when no scaling is done the pixels are magnified 4 1 2 Drop Menu Right clicking an object in the Object view or Tree view opens a drop menu Make Unique Creates a unique object from the link Further changes to this object do not affect the original object The selected object must be a link Make Unique Deep Make Duplicate Deep Make Linkable Normalize Object Make Duplicate Rename Object Creates a copy of the object Objects can also be copied Delete hjeci by dragging and dropping PHARMA Bring to Front Make Linkable Bring Forward Copies the object to the root level and replaces the Send Backward original with a link Send to Back Normalize Object Resizes the object so it is as small as possible This 1s great for resizing string and number fields but it also works for many other object types Rename Object Renames the object and all links pointing to it Delete Object Deletes the object The Del button works as well Optimize Object Recursive search that tries to find objects that could be replaced with links Objects that
11. ibutes map directly to the ISO 11783 standard Some attributes are missing as they are replaced by the Role attribute in a child object There are also some attributes that are specific to the PoolEdit XML format El Attribute Table X ee min alu ooo 578 00 width BD parents 0000000000 Attribute table example The table shows the attributes of the selected Output meter object If a fixed object ID is needed for a certain object it can be set Normally IDs are created when the object pool is exported as an embedded XML file When a link is selected the attribute table shows both the object attributes name color etc and the link attributes name position etc 13 4 4 XML View The XML View can be used to examine and edit the generated XML code The code in the editor is not automatically updated when pool is changed or vice versa Before editing the code it has to be manually updated by pressing the down arrow and when editing is done pressing the up arrow 4 loads the XML code back to the object pool xml version 1 0 encoding UTF 16 objectpool dimensian 200 fiz bitmap path imayez sk hele wworkingset background colour grey name workingset selectable yes lt include object namez datamask role active_mask s gt lt include object block_col 0 block _font block name tractorcontainer pos xz 14 pos lt hworkingset sdatamask background _colour grey name datamas
12. ih and sk height attributes define the width and height of designator areas respectively The standard specifies minimum designator size of 32x60 pixels Using this resolution allows the designs to be scaled upwards e The fix_bitmap_path and std_bitmap_path attributes define paths to image files The fix_bitmap_path is mainly for compatibility with the IsoAgLib format and older virtual terminals An example root element is show below lt objectpool dimension 200 fix_bitmap_path images sk heightz 32 sk_width 60 std_bitmap_path images gt lt objectpool gt 3 2 Linking Linking makes it possible for a single object to have many parent objects A link can be distinguished from a letter L in its logo in the Tree view Links are allowed only inside other objects No standalone link objects may exist The linked objects must be located at the root level of the pool t is not possible to make links that point any deeper in the tree Usually it is a good idea to use attribute objects with links so that many identical objects are not created see chapter 4 1 2 for automatically combining identical objects Linking is based on the object names Therefore there cannot be two objects with the same name at the root level objectpool TOF Toplevelobjects i Containers EE 1 Parent root object ETT 11 23 buttono Childs El Ft 13 8 stringi ZYX L l black6x8 REC 26 9 string YE
13. is set to value both which is basically an error condition Do not use the same objects on both mask and designator areas 16 6 Wizards The PoolEdit wizards are little prewritten programs which generate XML code according to the user s specification All wizards have a dialog screen for collecting user input The user can preview the result by pressing the Refresh button which will generate a new composite object under the selected object To actually see the object the user has to navigate to the new object in the Tree view When the user is sufficiently pleased with the result pressing the Ok button will close the wizard When the wizard is closed the user can fine tune the created objects as if they were created manually 6 1 Meter Wizard The Meter wizard is used to create fancy meters with numeric scales and solid backgrounds EE Meter Wizard El xi Start angle 3205 End angle 22071 i Min value pazl value G al ale 10 Clockwise ri Ticks J Mumbers J Container S ZE 100 Meter size r Background 100 Humhers diz Cut circle Heading kmi Scale Offset uzi Needle color B red Arc and tick L silver Fill attribute black Line attribute grey Osw v ger gt OY Font attribute white Number rete T la OK Retresh 17 6 2 Table VVizard The Table wizard is used to create tables with multiple rows and columns lolo PE a
14. kl gt sinclude object name sottkeymask role sott_key_ mask l sinclude object block_col 0 fort black_roy 0 name speedmeter poz xz _y 0 sinclude object block_col 0 block _font black name pressuremeter pos_x 1 pos_y sinclude object block_col 0 black_font black_roy 0 name etfectmeter pos pos y lt include_object black_col 0 block tort block name directionmeter pos_x 100 lt include object black_col 0 block _font black name clock pos 100 100 ole XML View Example 14 5 Creating Loading Saving and Exporting Documents 5 1 Creating New Object Pool The New menu option creates a new object pool by loading a document template 5 2 Loading and Saving The Load menu option loads an existing document Loading of both PoolEdit and IsoAgLib XML files are supported The Save and Save as menu options use the PoolEdit XML format to save the active document When saving a document make sure you have selected the appropriate document to save 5 3 XML Formats There are three types of XML formats used by PoolEdit PoolEdit XML ef soAgL b XML x x Legacy IsoAgLib format Embedded XML a Self contained export format not well tested 2 3 1 IsoAgLib XML This is the original IsoAgLib XML format on which the other formats are based on We have not used
15. our white height 8 horizontal_justification middle name label0 options transparent 9 pos_y 42 value 0 width 6 gt lt include_object namez white6x8 role font_attributes gt lt OUutpuUtSt ring gt lt container gt PoolEdit is written in the Java programming language and it has been tested on both Windows and Linux operating systems 2 Editor Layout Eh poolEdit SEE SAM E paz izi EE sac s ka iews Colors a y r 2 6 2 m 63 bd 4 I Oblect Vievv ax TopLevelObjects TopLevelObjects KeyObjects 5 ViorkingSets InputFieldObjects El Datahlasks OutputFieldObjects detamask0 ShapeObjects E datamaskt GraphicsObjects El softkeymask bell PictureObiects menukey VariableObiects startkey AttributeObiects 23 Bal stopkey PoirterObiects El 26 14 0 stoped MacroObjects ER AuxiliaryObjects MENU START El El El El El El El El El El El E gokey rightkey leftkey h 6 25 calibtable 24 6 85 calibtable Pu m H black Code X VE messages EA X r nxillun si xml 1 16 1 200 fix bitmap path imagesi sk height 32 sl 5 lt workingset background colour grey namez workingset selectable yes gt latin1 sinclude object namez datamask role active_mask gt i sinclude object block_col 0
16. ry objects are not real objects they are there just for grouping objects The Tree view shows also a couple of object types that are not real ISO 11783 objects Polygon objects have three or more Point objects 2 as children The Point objects are used to denote corners of the polygon The Working set object can have Language code objects EEE which specify the supported languages Command objects BM are used within Macro objects for describing command sequences However there are no special event objects Instead events are specified by the role attribute of the Macro object 4 Editing 4 1 Object View The Object view shows how the object pool will look on a virtual terminal An object can be selected by clicking it with a mouse If there are multiple objects on top of each other the topmost one will be selected If it 1s not possible to select the desired object by using the Object view use the Tree view instead The selected object is surrounded by white squares The object can be resized and moved by dragging these boxes It is possible to move objects so that they have negative coordinates but as the ISO 11783 standard does not currently allow negative coordinates they should be avoided O Object View 2 O HE X MENL START Object view example Pool is zoomed grid is on borderlines are on tiling is off and one object is selected 4 1 1 Obiect Vievv Buttons There are five buttons in the upper left corner o
17. the actual IsoAbLib library and have not done any compatibility testing There are likely to be so minor issues but in principle the conversions should work 5 3 2 PoolEdit XML The native XML format of PoolEdit resembles IsoAglib s format Biggest difference is that include object elements are used to link attributes variables data masks and soft key masks to objects while the IsoAglib format uses XML attributes to do the same job In PoolEdit XML links can only point to objects on the root level 2 3 3 Embedded XML Embedded XML is designed so that it can be transformed to ISO 11783 binary format and send to a virtual terminal It 1s derived from the PoolEdit XML format but there few differences The embedded XML file has picture data embedded to it by using base64 encoding This removes the need for separate picture files In addition all objects have unique IDs This makes it possible to detect ID conflicts earlier and makes the subsequent processing easier 15 In embedded XML files all objects are marked as mask objects or designator objects Mask objects are displayed on either data or alarm masks Designator objects can appear on working set logo soft key masks or auxiliary function and input designators This classification is done to make object scaling easier in the case different scale factors have to be used for mask and designator objects If an object is used on both mask areas and designator areas its use attribute
18. y as the graphical object specifles its position relative to the parent object the non graphical object specifies its role in the parent object For example when a Font attributes object is used it should have a Role attribute set to fontattributes The role attributes are set automatically to their default values by PoolEdit If a non default value is desired the user can change the value from the Attribute table which lists all possible values for the selected object 4 2 4 Macros Macros are command sequences that can be triggered by various events The triggering event is specified by the Role attribute when a macro is used in an object lt macro name changeMask role on_key_press gt lt command_change_active_mask child_id 600 parent_id 1 gt lt macro gt Currently the user has to use object ID in the command objects and fix the appropriate object IDs In a future release we are planning to use symbolic names instead of object IDs However there are some implications that have to be resolved first other objects cannot reference their parents as it would create loops but command objects typically do and it should not be considered a loop Also symbolic names can only point to the root level at least for now but object Ds can point to anywhere but they have to be globally unique 12 4 3 Attribute Table The Attr bute table shows the attributes and the attribute values of the selected object Most of attr
Download Pdf Manuals
Related Search
PoolEdit pool edit gpedit command pool meditation poolleiter pooleit pool mediterran poolside tech poole diving pooled trust pooled t-test pooled trust medicaid pooled trust medicaid ny pooled trust account