1

#!/usr/bin/env python

     2

# -*- coding: utf-8 -*-

     3

     4

#This file is part of PLCOpenEditor, a library implementing an IEC 61131-3 editor

     5

#based on the plcopen standard. 

     6

#

     7

#Copyright (C) 2007: Edouard TISSERANT and Laurent BESSARD

     8

#

     9

#See COPYING file for copyrights details.

    10

#

    11

#This library is free software; you can redistribute it and/or

    12

#modify it under the terms of the GNU General Public

    13

#License as published by the Free Software Foundation; either

    14

#version 2.1 of the License, or (at your option) any later version.

    15

#

    16

#This library is distributed in the hope that it will be useful,

    17

#but WITHOUT ANY WARRANTY; without even the implied warranty of

    18

#MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

    19

#General Public License for more details.

    20

#

    21

#You should have received a copy of the GNU General Public

    22

#License along with this library; if not, write to the Free Software

    23

#Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    24

    25

import wx

    26

from types import *

    27

    28

from Viewer import *

    29

    30

def ExtractNextBlocks(block, block_list):

    31

    current_list = [block]

    32

    while len(current_list) > 0:

    33

        next_list = []

    34

        for current in current_list:

    35

            connectors = current.GetConnectors()

    36

            input_connectors = []

    37

            if isinstance(current, LD_PowerRail) and current.GetType() == RIGHTRAIL:

    38

                input_connectors = connectors

    39

            else:

    40

                if "inputs" in connectors:

    41

                    input_connectors = connectors["inputs"]

    42

                if "input" in connectors:

    43

                    input_connectors = [connectors["input"]]

    44

            for connector in input_connectors:

    45

                for wire, handle in connector.GetWires():

    46

                    next = wire.EndConnected.GetParentBlock()

    47

                    if not isinstance(next, LD_PowerRail) and next not in block_list:

    48

                        block_list.append(next)

    49

                        next_list.append(next)

    50

        current_list = next_list

    51

    52

def CalcBranchSize(elements, stops):

    53

    branch_size = 0

    54

    stop_list = stops

    55

    for stop in stops:

    56

        ExtractNextBlocks(stop, stop_list)

    57

    element_tree = {}

    58

    for element in elements:

    59

        if element not in element_tree:

    60

            element_tree[element] = {"parents":["start"], "children":[], "weight":None}

    61

            GenerateTree(element, element_tree, stop_list)

    62

        elif element_tree[element]:

    63

            element_tree[element]["parents"].append("start")

    64

    remove_stops = {"start":[], "stop":[]}

    65

    for element, values in element_tree.items():

    66

        if "stop" in values["children"]:

    67

            removed = []

    68

            for child in values["children"]:

    69

                if child != "stop":

    70

##                    if child in elements:

    71

##                        RemoveElement(child, element_tree)

    72

##                        removed.append(child)

    73

                    if "start" in element_tree[child]["parents"]:

    74

                        if element not in remove_stops["stop"]:

    75

                            remove_stops["stop"].append(element)

    76

                        if child not in remove_stops["start"]:

    77

                            remove_stops["start"].append(child)

    78

            for child in removed:

    79

                values["children"].remove(child)

    80

    for element in remove_stops["start"]:

    81

        element_tree[element]["parents"].remove("start")

    82

    for element in remove_stops["stop"]:

    83

        element_tree[element]["children"].remove("stop")

    84

    for element, values in element_tree.items():

    85

        if values and "stop" in values["children"]:

    86

            CalcWeight(element, element_tree)

    87

            if values["weight"]:

    88

                branch_size += values["weight"]

    89

            else:

    90

                return 1

    91

    #print branch_size

    92

    return branch_size

    93

    94

def RemoveElement(remove, element_tree):

    95

    if remove in element_tree and element_tree[remove]:

    96

        for child in element_tree[remove]["children"]:

    97

            if child != "stop":

    98

                RemoveElement(child, element_tree)

    99

        element_tree.pop(remove)

   100

##        element_tree[remove] = None

   101

   102

def GenerateTree(element, element_tree, stop_list):

   103

    if element in element_tree:

   104

        connectors = element.GetConnectors()

   105

        input_connectors = []

   106

        if isinstance(element, LD_PowerRail) and element.GetType() == RIGHTRAIL:

   107

            input_connectors = connectors

   108

        else:

   109

            if "inputs" in connectors:

   110

                input_connectors = connectors["inputs"]

   111

            if "input" in connectors:

   112

                input_connectors = [connectors["input"]]

   113

        for connector in input_connectors:

   114

            for wire, handle in connector.GetWires():

   115

                next = wire.EndConnected.GetParentBlock()

   116

                if isinstance(next, LD_PowerRail) and next.GetType() == LEFTRAIL or next in stop_list:

   117

##                    for remove in element_tree[element]["children"]:

   118

##                        RemoveElement(remove, element_tree)

   119

##                    element_tree[element]["children"] = ["stop"]

   120

                    element_tree[element]["children"].append("stop")

   121

##                elif element_tree[element]["children"] == ["stop"]:

   122

##                    element_tree[next] = None

   123

                elif next not in element_tree or element_tree[next]:

   124

                    element_tree[element]["children"].append(next)

   125

                    if next in element_tree:

   126

                        element_tree[next]["parents"].append(element)

   127

                    else:

   128

                        element_tree[next] = {"parents":[element], "children":[], "weight":None}

   129

                        GenerateTree(next, element_tree, stop_list)

   130

   131

def CalcWeight(element, element_tree):

   132

    weight = 0

   133

    parts = None

   134

    if element in element_tree:

   135

        for parent in element_tree[element]["parents"]:

   136

            if parent == "start":

   137

                weight += 1

   138

            elif parent in element_tree:

   139

                if not parts:

   140

                    parts = len(element_tree[parent]["children"])

   141

                else:

   142

                    parts = min(parts, len(element_tree[parent]["children"]))

   143

                if not element_tree[parent]["weight"]:

   144

                    CalcWeight(parent, element_tree)

   145

                if element_tree[parent]["weight"]:

   146

                    weight += element_tree[parent]["weight"]

   147

                else:

   148

                    element_tree[element]["weight"] = None

   149

                    return

   150

            else:

   151

                element_tree[element]["weight"] = None

   152

                return

   153

        if not parts:

   154

            parts = 1

   155

        element_tree[element]["weight"] = max(1, weight / parts)

   156

   157

   158

#-------------------------------------------------------------------------------

   159

#                     Ladder Diagram Graphic elements Viewer class

   160

#-------------------------------------------------------------------------------

   161

   162

"""

   163

Class derived from Viewer class that implements a Viewer of Ladder Diagram

   164

"""

   165

   166

class LD_Viewer(Viewer):

   167

   168

    def __init__(self, parent, window, controler):

   169

        Viewer.__init__(self, parent, window, controler)

   170

        self.Rungs = []

   171

        self.RungComments = []

   172

   173

#-------------------------------------------------------------------------------

   174

#                          Refresh functions

   175

#-------------------------------------------------------------------------------

   176

   177

    def RefreshView(self):

   178

        Viewer.RefreshView(self)

   179

        for i, rung in enumerate(self.Rungs):

   180

            bbox = rung.GetBoundingBox()

   181

            if i < len(self.RungComments):

   182

                pos = self.RungComments[i].GetPosition()

   183

                if pos[1] > bbox.y:

   184

                    self.RungComments.insert(i, None)

   185

            else:

   186

                self.RungComments.insert(i, None)

   187

   188

    def loadInstance(self, instance, ids):

   189

        Viewer.loadInstance(self, instance, ids)

   190

        if instance["type"] == "leftPowerRail":

   191

            element = self.FindElementById(instance["id"])

   192

            rung = Graphic_Group(self)

   193

            rung.SelectElement(element)

   194

            self.Rungs.append(rung)

   195

        elif instance["type"] == "rightPowerRail":

   196

            rungs = []

   197

            for connector in instance["connectors"]:

   198

                for link in connector["links"]:

   199

                    connected = self.FindElementById(link["refLocalId"])

   200

                    rung = self.FindRung(connected)

   201

                    if rung not in rungs:

   202

                        rungs.append(rung)

   203

            if len(rungs) > 1:

   204

                raise "ValueError", "Ladder element with id %d is on more than one rung."%instance["id"]

   205

            element = self.FindElementById(instance["id"])

   206

            self.Rungs[rungs[0]].SelectElement(element)

   207

            for connector in element.GetConnectors():

   208

                for wire, num in connector.GetWires():

   209

                    self.Rungs[rungs[0]].SelectElement(wire)

   210

            self.RefreshPosition(element)

   211

        elif instance["type"] in ["contact", "coil"]:

   212

            rungs = []

   213

            for link in instance["connectors"]["input"]["links"]:

   214

                connected = self.FindElementById(link["refLocalId"])

   215

                rung = self.FindRung(connected)

   216

                if rung not in rungs:

   217

                    rungs.append(rung)

   218

            if len(rungs) > 1:

   219

                raise "ValueError", "Ladder element with id %d is on more than one rung."%instance["id"]

   220

            element = self.FindElementById(instance["id"])

   221

            self.Rungs[rungs[0]].SelectElement(element)

   222

            for wire, num in element.GetConnectors()["input"].GetWires():

   223

                self.Rungs[rungs[0]].SelectElement(wire)

   224

            self.RefreshPosition(element)

   225

        elif instance["type"] == "comment":

   226

            element = self.FindElementById(instance["id"])

   227

            pos = element.GetPosition()

   228

            i = 0

   229

            inserted = False

   230

            while i < len(self.RungComments) and not inserted: 

   231

                ipos = self.RungComments[i].GetPosition()

   232

                if pos[1] < ipos[1]:

   233

                    self.RungComments.insert(i, element)

   234

                    inserted = True

   235

                i += 1

   236

            if not inserted:

   237

                self.RungComments.append(element)

   238

   239

#-------------------------------------------------------------------------------

   240

#                          Search Element functions

   241

#-------------------------------------------------------------------------------

   242

   243

    def FindRung(self, element):

   244

        for i, rung in enumerate(self.Rungs):

   245

            if rung.IsElementIn(element):

   246

                return i

   247

        return None

   248

   249

    def FindElement(self, pos):

   250

        if self.GetDrawingMode() == FREEDRAWING_MODE:

   251

            return Viewer.FindElement(self, pos)

   252

   253

        elements = []

   254

        for element in self.GetElements(sort_wires=True):

   255

            if element.HitTest(pos) or element.TestHandle(pos) != (0, 0):

   256

                elements.append(element)

   257

        if len(elements) == 1:

   258

            return elements[0]

   259

        elif len(elements) > 1:

   260

            group = Graphic_Group(self)

   261

            for element in elements:

   262

                if self.IsBlock(element):

   263

                    return element

   264

                group.SelectElement(element)

   265

            return group

   266

        return None

   267

   268

    def SearchElements(self, bbox):

   269

        if self.GetDrawingMode() == FREEDRAWING_MODE:

   270

            return Viewer.SearchElements(self, bbox)

   271

   272

        elements = []

   273

        for element in self.Blocks:

   274

            if element.IsInSelection(bbox):

   275

                elements.append(element)

   276

        return elements

   277

   278

#-------------------------------------------------------------------------------

   279

#                          Mouse event functions

   280

#-------------------------------------------------------------------------------

   281

   282

    def OnViewerLeftDown(self, event):

   283

        if self.GetDrawingMode() == FREEDRAWING_MODE:

   284

            Viewer.OnViewerLeftDown(self, event)

   285

        elif self.Mode == MODE_SELECTION:

   286

            dc = self.GetLogicalDC()

   287

            pos = event.GetLogicalPosition(dc)

   288

            element = self.FindElement(pos)

   289

            if self.SelectedElement:

   290

                if not isinstance(self.SelectedElement, Graphic_Group):

   291

                    if self.SelectedElement != element:

   292

                        if self.IsWire(self.SelectedElement):

   293

                            self.SelectedElement.SetSelectedSegment(None)

   294

                        else:

   295

                            self.SelectedElement.SetSelected(False)

   296

                    else:

   297

                        self.SelectedElement = None

   298

                elif element and isinstance(element, Graphic_Group):

   299

                    if self.SelectedElement.GetElements() != element.GetElements():

   300

                        for elt in self.SelectedElement.GetElements():

   301

                            if self.IsWire(elt):

   302

                                elt.SetSelectedSegment(None)

   303

                        self.SelectedElement.SetSelected(False)

   304

                        self.SelectedElement = None

   305

                else:

   306

                    for elt in self.SelectedElement.GetElements():

   307

                        if self.IsWire(elt):

   308

                            elt.SetSelectedSegment(None)

   309

                    self.SelectedElement.SetSelected(False)

   310

                    self.SelectedElement = None

   311

                self.Refresh()

   312

            if element:

   313

                self.SelectedElement = element

   314

                self.SelectedElement.OnLeftDown(event, dc, self.Scaling)

   315

                self.Refresh()

   316

            else:

   317

                self.rubberBand.Reset()

   318

                self.rubberBand.OnLeftDown(event, dc, self.Scaling)

   319

        event.Skip()

   320

   321

    def OnViewerLeftUp(self, event):

   322

        if self.GetDrawingMode() == FREEDRAWING_MODE:

   323

            Viewer.OnViewerLeftUp(self, event)

   324

        elif self.rubberBand.IsShown():

   325

            if self.Mode == MODE_SELECTION:

   326

                elements = self.SearchElements(self.rubberBand.GetCurrentExtent())

   327

                self.rubberBand.OnLeftUp(event, self.GetLogicalDC(), self.Scaling)

   328

                if len(elements) > 0:

   329

                    self.SelectedElement = Graphic_Group(self)

   330

                    self.SelectedElement.SetElements(elements)

   331

                    self.SelectedElement.SetSelected(True)

   332

                    self.Refresh()

   333

        elif self.Mode == MODE_SELECTION and self.SelectedElement:

   334

            dc = self.GetLogicalDC() 

   335

            if not isinstance(self.SelectedElement, Graphic_Group):

   336

                if self.IsWire(self.SelectedElement):

   337

                    result = self.SelectedElement.TestSegment(event.GetLogicalPosition(dc), True)

   338

                    if result and result[1] in [EAST, WEST]:

   339

                        self.SelectedElement.SetSelectedSegment(result[0])

   340

                else:

   341

                    self.SelectedElement.OnLeftUp(event, dc, self.Scaling)

   342

            else:

   343

                for element in self.SelectedElement.GetElements():

   344

                    if self.IsWire(element):

   345

                        result = element.TestSegment(event.GetLogicalPosition(dc), True)

   346

                        if result and result[1] in [EAST, WEST]:

   347

                            element.SetSelectedSegment(result[0])

   348

                    else:

   349

                        element.OnLeftUp(event, dc, self.Scaling)

   351

            self.ReleaseMouse()

   352

            self.Refresh()

   353

        event.Skip()

   354

   355

    def OnViewerRightUp(self, event):

   356

        if self.GetDrawingMode() == FREEDRAWING_MODE:

   357

            Viewer.OnViewerRightUp(self, event)

   358

        else:

   359

            dc = self.GetLogicalDC()

   360

            pos = event.GetLogicalPosition(dc)

   361

            element = self.FindElement(pos)

   362

            if element:

   363

                if self.SelectedElement and self.SelectedElement != element:

   364

                    self.SelectedElement.SetSelected(False)

   365

                self.SelectedElement = element

   366

                if self.IsWire(self.SelectedElement):

   367

                    self.SelectedElement.SetSelectedSegment(0)

   368

                else:

   369

                    self.SelectedElement.SetSelected(True)

   370

                    self.SelectedElement.OnRightUp(event, dc, self.Scaling)

   372

                self.ReleaseMouse()

   373

                self.Refresh()

   374

        event.Skip()

   375

   376

    def OnViewerLeftDClick(self, event):

   377

        if self.GetDrawingMode() == FREEDRAWING_MODE:

   378

            Viewer.OnViewerLeftDClick(self, event)

   379

        elif self.Mode == MODE_SELECTION and self.SelectedElement:

   380

            self.SelectedElement.OnLeftDClick(event, self.GetLogicalDC(), self.Scaling)

   381

            self.Refresh()

   382

        event.Skip()

   383

   384

    def OnViewerMotion(self, event):

   385

        if self.GetDrawingMode() == FREEDRAWING_MODE:

   386

            Viewer.OnViewerMotion(self, event)

   387

        elif self.rubberBand.IsShown():

   388

            self.rubberBand.OnMotion(event, self.GetLogicalDC(), self.Scaling)

   389

        event.Skip()

   390

   391

#-------------------------------------------------------------------------------

   392

#                          Keyboard event functions

   393

#-------------------------------------------------------------------------------

   394

   395

    def OnChar(self, event):

   396

        if self.GetDrawingMode() == FREEDRAWING_MODE:

   397

            Viewer.OnChar(self, event)

   398

        else:

   402

            keycode = event.GetKeyCode()

   404

                if self.IsBlock(self.SelectedElement):

   405

                    self.SelectedElement.Delete()

   406

                elif self.IsWire(self.SelectedElement):

   407

                    self.DeleteWire(self.SelectedElement)

   408

                elif isinstance(self.SelectedElement, Graphic_Group):

   409

                    all_wires = True

   410

                    for element in self.SelectedElement.GetElements():

   411

                        all_wires &= self.IsWire(element)

   412

                    if all_wires:

   413

                        self.DeleteWire(self.SelectedElement)

   414

                    else:

   415

                        self.SelectedElement.Delete()

   416

                self.RefreshBuffer()

   417

                self.RefreshScrollBars()

   418

                self.Refresh()

   420

                if event.ControlDown() and event.ShiftDown():

   421

                    self.Scroll(0, ypos)

   422

                elif event.ControlDown():

   423

                    self.Scroll(max(0, xpos - 1), ypos)

   425

                if event.ControlDown() and event.ShiftDown():

   426

                    self.Scroll(xmax, ypos)

   427

                elif event.ControlDown():

   428

                    self.Scroll(min(xpos + 1, xmax), ypos)

   430

                if event.ControlDown() and event.ShiftDown():

   431

                    self.Scroll(xpos, 0)

   432

                elif event.ControlDown():

   433

                    self.Scroll(xpos, max(0, ypos - 1))

   435

                if event.ControlDown() and event.ShiftDown():

   436

                    self.Scroll(xpos, ymax)

   437

                elif event.ControlDown():

   438

                    self.Scroll(xpos, min(ypos + 1, ymax))

   439

        event.Skip()

   440

   441

#-------------------------------------------------------------------------------

   442

#                          Adding element functions

   443

#-------------------------------------------------------------------------------

   444

   445

    def AddLadderRung(self):

   446

        dialog = LDElementDialog(self.Parent, "coil")

   447

        varlist = []

   448

        vars = self.Controler.GetCurrentElementEditingInterfaceVars()

   449

        if vars:

   450

            for var in vars:

   451

                if var["Class"] != "Input" and var["Type"] == "BOOL":

   452

                    varlist.append(var["Name"])

   453

        returntype = self.Controler.GetCurrentElementEditingInterfaceReturnType()

   454

        if returntype == "BOOL":

   455

            varlist.append(self.Controler.GetCurrentElementEditingName())

   456

        dialog.SetVariables(varlist)

   457

        dialog.SetValues({"name":"","type":COIL_NORMAL})

   459

            values = dialog.GetValues()

   460

            startx, starty = LD_OFFSET[0], 0

   461

            if len(self.Rungs) > 0:

   462

                bbox = self.Rungs[-1].GetBoundingBox()

   463

                starty = bbox.y + bbox.height

   464

            starty += LD_OFFSET[1]

   465

            rung = Graphic_Group(self)

   466

            # Create comment

   467

            id = self.GetNewId()

   468

            comment = Comment(self, "Commentaire", id)

   469

            comment.SetPosition(startx, starty)

   470

            comment.SetSize(LD_COMMENT_DEFAULTSIZE[0], LD_COMMENT_DEFAULTSIZE[1])

   471

            self.AddComment(comment)

   472

            self.RungComments.append(comment)

   473

            self.Controler.AddCurrentElementEditingComment(id)

   474

            self.RefreshCommentModel(comment)

   475

            starty += LD_COMMENT_DEFAULTSIZE[1] + LD_OFFSET[1]

   476

            # Create LeftPowerRail

   477

            id = self.GetNewId()

   478

            leftpowerrail = LD_PowerRail(self, LEFTRAIL, id)

   479

            leftpowerrail.SetPosition(startx, starty)

   480

            self.AddBlock(leftpowerrail)

   481

            rung.SelectElement(leftpowerrail)

   482

            self.Controler.AddCurrentElementEditingPowerRail(id, LEFTRAIL)

   483

            self.RefreshPowerRailModel(leftpowerrail)

   484

            # Create Coil

   485

            id = self.GetNewId()

   486

            coil = LD_Coil(self, values["type"], values["name"], id)

   487

            coil.SetPosition(startx, starty + (LD_LINE_SIZE - LD_ELEMENT_SIZE[1]) / 2)

   488

            self.AddBlock(coil)

   489

            rung.SelectElement(coil)

   490

            self.Controler.AddCurrentElementEditingCoil(id)

   491

            # Create Wire between LeftPowerRail and Coil

   492

            wire = Wire(self)

   493

            start_connector = coil.GetConnectors()["input"]

   494

            end_connector = leftpowerrail.GetConnectors()[0]

   495

            start_connector.Connect((wire, 0), False)

   496

            end_connector.Connect((wire, -1), False)

   497

            wire.ConnectStartPoint(None, start_connector)

   498

            wire.ConnectEndPoint(None, end_connector)

   499

            self.AddWire(wire)

   500

            rung.SelectElement(wire)

   501

            # Create RightPowerRail

   502

            id = self.GetNewId()

   503

            rightpowerrail = LD_PowerRail(self, RIGHTRAIL, id)

   504

            rightpowerrail.SetPosition(startx, starty)

   505

            self.AddBlock(rightpowerrail)

   506

            rung.SelectElement(rightpowerrail)

   507

            self.Controler.AddCurrentElementEditingPowerRail(id, RIGHTRAIL)

   508

            # Create Wire between LeftPowerRail and Coil

   509

            wire = Wire(self)

   510