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

    27

from graphics import *

    28

    29

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

    30

#                          Create New Block Dialog

    31

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

    32

    33

[ID_FBDBLOCKDIALOG, ID_FBDBLOCKDIALOGNAME, 

    34

 ID_FBDBLOCKDIALOGTYPETREE, ID_FBDBLOCKDIALOGTYPEDESC, 

    35

 ID_FBDBLOCKDIALOGINPUTS, ID_FBDBLOCKDIALOGPREVIEW, 

    36

 ID_FBDBLOCKDIALOGEXECUTIONORDER, ID_FBDBLOCKDIALOGEXECUTIONCONTROL, 

    37

 ID_FBDBLOCKDIALOGSTATICTEXT1, ID_FBDBLOCKDIALOGSTATICTEXT2, 

    38

 ID_FBDBLOCKDIALOGSTATICTEXT3, ID_FBDBLOCKDIALOGSTATICTEXT4, 

    39

 ID_FBDBLOCKDIALOGSTATICTEXT5, ID_FBDBLOCKDIALOGSTATICTEXT6, 

    40

] = [wx.NewId() for _init_ctrls in range(14)]

    41

    42

[CATEGORY, BLOCK] = range(2)

    43

    44

class FBDBlockDialog(wx.Dialog):

    45

    46

    if wx.VERSION < (2, 6, 0):

    47

        def Bind(self, event, function, id = None):

    48

            if id is not None:

    49

                event(self, id, function)

    50

            else:

    51

                event(self, function)

    52

    53

    def _init_coll_flexGridSizer1_Items(self, parent):

    54

        parent.AddSizer(self.MainSizer, 0, border=20, flag=wx.GROW|wx.TOP|wx.LEFT|wx.RIGHT)

    55

        parent.AddSizer(self.ButtonSizer, 0, border=20, flag=wx.ALIGN_RIGHT|wx.BOTTOM|wx.LEFT|wx.RIGHT)

    56

    57

    def _init_coll_flexGridSizer1_Growables(self, parent):

    58

        parent.AddGrowableCol(0)

    59

        parent.AddGrowableRow(0)

    60

    61

    def _init_coll_MainSizer_Items(self, parent):

    62

        parent.AddSizer(self.LeftBoxSizer, 1, border=5, flag=wx.GROW|wx.RIGHT)

    63

        parent.AddSizer(self.RightGridSizer, 1, border=5, flag=wx.GROW|wx.LEFT)

    64

    65

    def _init_coll_LeftBoxSizer_Items(self, parent):

    66

        parent.AddWindow(self.TypeTree, 3, border=5, flag=wx.GROW|wx.BOTTOM)

    67

        parent.AddWindow(self.TypeDesc, 1, border=0, flag=wx.GROW)

    68

    69

    def _init_coll_RightGridSizer_Items(self, parent):

    70

        parent.AddSizer(self.RightUpGridSizer, 0, border=0, flag=wx.GROW)

    71

        parent.AddWindow(self.staticText6, 0, border=0, flag=wx.GROW)

    72

        parent.AddWindow(self.Preview, 0, border=0, flag=wx.GROW)

    73

    74

    def _init_coll_RightGridSizer_Growables(self, parent):

    75

        parent.AddGrowableCol(0)

    76

        parent.AddGrowableRow(2)

    77

    78

    def _init_coll_RightUpGridSizer_Items(self, parent):

    79

        parent.AddWindow(self.staticText2, 0, border=4, flag=wx.ALIGN_CENTER_VERTICAL|wx.TOP)

    80

        parent.AddWindow(self.BlockName, 0, border=0, flag=wx.GROW)

    81

        parent.AddWindow(self.staticText3, 0, border=4, flag=wx.ALIGN_CENTER_VERTICAL|wx.TOP)

    82

        parent.AddWindow(self.Inputs, 0, border=0, flag=wx.GROW)

    83

        parent.AddWindow(self.staticText4, 0, border=4, flag=wx.ALIGN_CENTER_VERTICAL|wx.TOP)

    84

        parent.AddWindow(self.ExecutionOrder, 0, border=0, flag=wx.GROW)

    85

        parent.AddWindow(self.staticText5, 0, border=4, flag=wx.ALIGN_CENTER_VERTICAL|wx.TOP)

    86

        parent.AddWindow(self.ExecutionControl, 0, border=0, flag=wx.GROW)

    87

    88

    def _init_coll_RightUpGridSizer_Growables(self, parent):

    89

        parent.AddGrowableCol(1)

    90

    91

    def _init_sizers(self):

    92

        self.flexGridSizer1 = wx.FlexGridSizer(cols=1, hgap=0, rows=2, vgap=10)

    93

        self.MainSizer = wx.BoxSizer(wx.HORIZONTAL)

    94

        self.LeftBoxSizer = wx.StaticBoxSizer(self.staticbox1, wx.VERTICAL)

    95

        self.RightGridSizer = wx.FlexGridSizer(cols=1, hgap=0, rows=3, vgap=5)

    96

        self.RightUpGridSizer = wx.FlexGridSizer(cols=2, hgap=5, rows=4, vgap=5)

    97

    98

        self._init_coll_flexGridSizer1_Items(self.flexGridSizer1)

    99

        self._init_coll_flexGridSizer1_Growables(self.flexGridSizer1)

   100

        self._init_coll_MainSizer_Items(self.MainSizer)

   101

        self._init_coll_LeftBoxSizer_Items(self.LeftBoxSizer)

   102

        self._init_coll_RightGridSizer_Items(self.RightGridSizer)

   103

        self._init_coll_RightGridSizer_Growables(self.RightGridSizer)

   104

        self._init_coll_RightUpGridSizer_Items(self.RightUpGridSizer)

   105

        self._init_coll_RightUpGridSizer_Growables(self.RightUpGridSizer)

   106

   107

        self.SetSizer(self.flexGridSizer1)

   108

   109

    def _init_ctrls(self, prnt):

   110

        wx.Dialog.__init__(self, id=ID_FBDBLOCKDIALOG,

   111

              name='FBDBlockDialog', parent=prnt,

   112

              size=wx.Size(600, 400), style=wx.DEFAULT_DIALOG_STYLE|wx.RESIZE_BORDER,

   113

              title=_('Block Properties'))

   114

        self.SetClientSize(wx.Size(600, 400))

   115

   116

        self.staticbox1 = wx.StaticBox(id=ID_FBDBLOCKDIALOGSTATICTEXT1,

   117

              label=_('Type:'), name='staticBox1', parent=self,

   118

              pos=wx.Point(0, 0), size=wx.Size(0, 0), style=0)

   119

   120

        self.staticText2 = wx.StaticText(id=ID_FBDBLOCKDIALOGSTATICTEXT2,

   121

              label=_('Name:'), name='staticText2', parent=self,

   122

              pos=wx.Point(0, 0), size=wx.DefaultSize, style=0)

   123

   124

        self.staticText3 = wx.StaticText(id=ID_FBDBLOCKDIALOGSTATICTEXT2,

   125

              label=_('Inputs:'), name='staticText4', parent=self,

   126

              pos=wx.Point(0, 0), size=wx.DefaultSize, style=0)

   127

   128

        self.staticText4 = wx.StaticText(id=ID_FBDBLOCKDIALOGSTATICTEXT4,

   129

              label=_('Execution Order:'), name='staticText4', parent=self,

   130

              pos=wx.Point(0, 0), size=wx.DefaultSize, style=0)

   131

   132

        self.staticText5 = wx.StaticText(id=ID_FBDBLOCKDIALOGSTATICTEXT5,

   133

              label=_('Execution Control:'), name='staticText5', parent=self,

   134

              pos=wx.Point(0, 0), size=wx.DefaultSize, style=0)

   135

   136

        self.staticText6 = wx.StaticText(id=ID_FBDBLOCKDIALOGSTATICTEXT6,

   137

              label=_('Preview:'), name='staticText6', parent=self,

   138

              pos=wx.Point(0, 0), size=wx.DefaultSize, style=0)

   139

   140

        if wx.Platform == '__WXMSW__':

   141

            treestyle = wx.TR_HAS_BUTTONS|wx.TR_SINGLE|wx.SUNKEN_BORDER

   142

        else:

   143

            treestyle = wx.TR_HAS_BUTTONS|wx.TR_HIDE_ROOT|wx.TR_SINGLE|wx.SUNKEN_BORDER

   144

        self.TypeTree = wx.TreeCtrl(id=ID_FBDBLOCKDIALOGTYPETREE,

   145

              name='TypeTree', parent=self, pos=wx.Point(0, 0),

   146

              size=wx.Size(0, 0), style=treestyle)

   147

        self.Bind(wx.EVT_TREE_SEL_CHANGED, self.OnTypeTreeItemSelected,

   148

              id=ID_FBDBLOCKDIALOGTYPETREE)

   149

   150

        self.TypeDesc = wx.TextCtrl(id=ID_FBDBLOCKDIALOGTYPEDESC,

   151

              name='TypeDesc', parent=self, pos=wx.Point(0, 0),

   152

              size=wx.Size(0, 0), style=wx.TE_READONLY|wx.TE_MULTILINE)

   153

   154

        self.BlockName = wx.TextCtrl(id=ID_FBDBLOCKDIALOGNAME, value='',

   155

              name='BlockName', parent=self, pos=wx.Point(0, 0),

   156

              size=wx.Size(0, 24), style=0)

   157

        self.Bind(wx.EVT_TEXT, self.OnNameChanged, id=ID_FBDBLOCKDIALOGNAME)

   158

   159

        self.Inputs = wx.SpinCtrl(id=ID_FBDBLOCKDIALOGINPUTS,

   160

              name='Inputs', parent=self, pos=wx.Point(0, 0),

   161

              size=wx.Size(0, 24), style=wx.SP_ARROW_KEYS, min=2, max=20)

   162

        self.Bind(wx.EVT_SPINCTRL, self.OnInputsChanged, id=ID_FBDBLOCKDIALOGINPUTS)

   163

   164

        self.ExecutionOrder = wx.SpinCtrl(id=ID_FBDBLOCKDIALOGEXECUTIONORDER,

   165

              name='ExecutionOrder', parent=self, pos=wx.Point(0, 0),

   166

              size=wx.Size(0, 24), style=wx.SP_ARROW_KEYS, min=0)

   167

        self.Bind(wx.EVT_SPINCTRL, self.OnExecutionOrderChanged, id=ID_FBDBLOCKDIALOGEXECUTIONORDER)

   168

   169

        self.ExecutionControl = wx.CheckBox(id=ID_FBDBLOCKDIALOGEXECUTIONCONTROL,

   170

              name='ExecutionControl', parent=self, pos=wx.Point(0, 0),

   171

              size=wx.Size(0, 24), style=0)

   172

        self.Bind(wx.EVT_CHECKBOX, self.OnExecutionOrderChanged, id=ID_FBDBLOCKDIALOGEXECUTIONCONTROL)

   173

   174

        self.Preview = wx.Panel(id=ID_FBDBLOCKDIALOGPREVIEW,

   175

              name='Preview', parent=self, pos=wx.Point(0, 0),

   176

              size=wx.Size(0, 0), style=wx.TAB_TRAVERSAL|wx.SIMPLE_BORDER)

   177

        self.Preview.SetBackgroundColour(wx.Colour(255,255,255))

   178

        setattr(self.Preview, "GetDrawingMode", lambda:FREEDRAWING_MODE)

   179

        setattr(self.Preview, "GetScaling", lambda:None)

   180

        setattr(self.Preview, "GetBlockType", self.Controler.GetBlockType)

   181

        setattr(self.Preview, "IsOfType", self.Controler.IsOfType)

   182

   183

        self.ButtonSizer = self.CreateButtonSizer(wx.OK|wx.CANCEL|wx.CENTRE)

   184

        if wx.VERSION >= (2, 5, 0):

   185

            self.Bind(wx.EVT_BUTTON, self.OnOK, id=self.ButtonSizer.GetAffirmativeButton().GetId())

   186

            self.Preview.Bind(wx.EVT_PAINT, self.OnPaint)

   187

        else:

   188

            self.Bind(wx.EVT_BUTTON, self.OnOK, id=self.ButtonSizer.GetChildren()[0].GetSizer().GetChildren()[0].GetWindow().GetId())

   189

            wx.EVT_PAINT(self.Preview, self.OnPaint)

   190

   191

        self._init_sizers()

   192

   193

    def __init__(self, parent, controler):

   194

        self.Controler = controler

   195

        self._init_ctrls(parent)

   196

        self.BlockName.SetValue("")

   197

        self.BlockName.Enable(False)

   198

        self.Inputs.Enable(False)

   199

        self.Block = None

   200

        self.MinBlockSize = None

   201

        self.First = True

   202

   203

        self.PouNames = []

   204

        self.PouElementNames = []

   205

   206

        self.TypeTree.SetFocus()

   207

   208

    def SetPreviewFont(self, font):

   209

        self.Preview.SetFont(font)

   210

   211

    def FindTreeItem(self, root, name, inputs = None):

   212

        if root.IsOk():

   213

            pydata = self.TypeTree.GetPyData(root)

   214

            type_inputs = pydata.get("inputs", None)

   215

            type_extension = pydata.get("extension", None)

   216

            if inputs is not None and type_inputs is not None:

   217

                if type_extension is not None:

   218

                    same_inputs = type_inputs == inputs[:type_extension]

   219

                else:

   220

                    same_inputs = type_inputs == inputs

   221

            else:

   222

                same_inputs = True

   223

            if self.TypeTree.GetItemText(root) == name and same_inputs:

   224

                return root

   225

            else:

   226

                if wx.VERSION < (2, 6, 0):

   227

                    item, root_cookie = self.TypeTree.GetFirstChild(root, 0)

   228

                else:

   229

                    item, root_cookie = self.TypeTree.GetFirstChild(root)

   230

                while item.IsOk():

   231

                    result = self.FindTreeItem(item, name, inputs)

   232

                    if result:

   233

                        return result

   234

                    item, root_cookie = self.TypeTree.GetNextChild(root, root_cookie)

   235

        return None

   236

   237

    def OnOK(self, event):

   238

        selected = self.TypeTree.GetSelection()

   239

        block_name = self.BlockName.GetValue()

   240

        name_enabled = self.BlockName.IsEnabled()

   241

        if not selected.IsOk() or self.TypeTree.GetItemParent(selected) == self.TypeTree.GetRootItem() or selected == self.TypeTree.GetRootItem():

   242

            message = wx.MessageDialog(self, _("Form isn't complete. Valid block type must be selected!"), _("Error"), wx.OK|wx.ICON_ERROR)

   243

            message.ShowModal()

   244

            message.Destroy()

   245

        elif name_enabled and block_name == "":

   246

            message = wx.MessageDialog(self, _("Form isn't complete. Name must be filled!"), _("Error"), wx.OK|wx.ICON_ERROR)

   247

            message.ShowModal()

   248

            message.Destroy()

   249

        elif name_enabled and not TestIdentifier(block_name):

   250

            message = wx.MessageDialog(self, _("\"%s\" is not a valid identifier!")%block_name, _("Error"), wx.OK|wx.ICON_ERROR)

   251

            message.ShowModal()

   252

            message.Destroy()

   253

        elif name_enabled and block_name.upper() in IEC_KEYWORDS:

   254

            message = wx.MessageDialog(self, _("\"%s\" is a keyword. It can't be used!")%block_name, _("Error"), wx.OK|wx.ICON_ERROR)

   255

            message.ShowModal()

   256

            message.Destroy()

   257

        elif name_enabled and block_name.upper() in self.PouNames:

   258

            message = wx.MessageDialog(self, _("\"%s\" pou already exists!")%block_name, _("Error"), wx.OK|wx.ICON_ERROR)

   259

            message.ShowModal()

   260

            message.Destroy()

   261

        elif name_enabled and block_name.upper() in self.PouElementNames:

   262

            message = wx.MessageDialog(self, _("\"%s\" element for this pou already exists!")%block_name, _("Error"), wx.OK|wx.ICON_ERROR)

   263

            message.ShowModal()

   264

            message.Destroy()

   265

        else:

   266

            self.EndModal(wx.ID_OK)

   267

   268

    def SetBlockList(self, blocktypes):

   269

        if wx.Platform == '__WXMSW__':

   270

            root = self.TypeTree.AddRoot(_("Block Types"))

   271

        else:

   272

            root = self.TypeTree.AddRoot("")

   273

        self.TypeTree.SetPyData(root, {"type" : CATEGORY})

   274

        for category in blocktypes:

   275

            category_name = category["name"]

   276

            category_item = self.TypeTree.AppendItem(root, _(category_name))

   277

            self.TypeTree.SetPyData(category_item, {"type" : CATEGORY})

   278

            for blocktype in category["list"]:

   279

                blocktype_item = self.TypeTree.AppendItem(category_item, blocktype["name"])

   280

                block_data = {"type" : BLOCK, 

   281

                              "inputs" : tuple([type for name, type, modifier in blocktype["inputs"]]),

   282

                              "extension" : None}

   283

                if blocktype["extensible"]:

   284

                    block_data["extension"] = len(blocktype["inputs"])

   285

                self.TypeTree.SetPyData(blocktype_item, block_data)

   286

        if wx.Platform == '__WXMSW__':

   287

            self.TypeTree.Expand(root)

   288

   289

    def SetMinBlockSize(self, size):

   290

        self.MinBlockSize = size

   291

   292

    def SetPouNames(self, pou_names):

   293

        self.PouNames = [pou_name.upper() for pou_name in pou_names]

   294

   295

    def SetPouElementNames(self, element_names):

   296

        self.PouElementNames = [element_name.upper() for element_name in element_names]

   297

   298

    def SetValues(self, values):

   299

        blocktype = values.get("type", None)

   300

        if blocktype is not None:

   301

            inputs = values.get("inputs", None)

   302

            item = self.FindTreeItem(self.TypeTree.GetRootItem(), blocktype, inputs)

   303

            if item:

   304

                self.TypeTree.SelectItem(item)

   305

        for name, value in values.items():

   306

            if name == "name":

   307

                self.BlockName.SetValue(value)

   308

            elif name == "extension":

   309

                self.Inputs.SetValue(value)

   310

            elif name == "executionOrder":

   311

                self.ExecutionOrder.SetValue(value)

   312

            elif name == "executionControl":

   313

                   self.ExecutionControl.SetValue(value)

   314

        self.RefreshPreview()

   315

   316

    def GetValues(self):

   317

        values = {}

   318

        item = self.TypeTree.GetSelection()

   319

        values["type"] = self.TypeTree.GetItemText(item)

   320

        values["inputs"] = self.TypeTree.GetPyData(item)["inputs"]

   321

        if self.BlockName.GetValue() != "":

   322

            values["name"] = self.BlockName.GetValue()

   323

        values["width"], values["height"] = self.Block.GetSize()

   324

        values["extension"] = self.Inputs.GetValue()

   325

        values["executionOrder"] = self.ExecutionOrder.GetValue()

   326

        values["executionControl"] = self.ExecutionControl.GetValue()

   327

        return values

   328

   329

    def OnTypeTreeItemSelected(self, event):

   330

        self.BlockName.SetValue("")

   331

        selected = event.GetItem()

   332

        pydata = self.TypeTree.GetPyData(selected)

   333

        if pydata["type"] != CATEGORY:

   334

            blocktype = self.Controler.GetBlockType(self.TypeTree.GetItemText(selected), pydata["inputs"])

   335

            if blocktype:

   336

                self.Inputs.SetValue(len(blocktype["inputs"]))

   337

                self.Inputs.Enable(blocktype["extensible"])

   338

                self.BlockName.Enable(blocktype["type"] != "function")

   339

                comment = blocktype["comment"]

   340

                self.TypeDesc.SetValue(_(comment) + blocktype.get("usage", ""))

   341

                wx.CallAfter(self.RefreshPreview)

   342

            else:

   343

                self.BlockName.Enable(False)

   344

                self.Inputs.Enable(False)

   345

                self.Inputs.SetValue(2)

   346

                self.TypeDesc.SetValue("")

   347

                wx.CallAfter(self.ErasePreview)

   348

        else:

   349

            self.BlockName.Enable(False)

   350

            self.Inputs.Enable(False)

   351

            self.Inputs.SetValue(2)

   352

            self.TypeDesc.SetValue("")

   353

            wx.CallAfter(self.ErasePreview)

   354

        event.Skip()

   355

   356

    def OnNameChanged(self, event):

   357

        if self.BlockName.IsEnabled():

   358

            self.RefreshPreview()

   359

        event.Skip()

   360

   361

    def OnInputsChanged(self, event):

   362

        if self.Inputs.IsEnabled():

   363

            self.RefreshPreview()

   364

        event.Skip()

   365

   366

    def OnExecutionOrderChanged(self, event):

   367

        self.RefreshPreview()

   368

        event.Skip()

   369

   370

    def OnExecutionControlChanged(self, event):

   371

        self.RefreshPreview()

   372

        event.Skip()

   373

   374

    def ErasePreview(self):

   375

        dc = wx.ClientDC(self.Preview)

   376

        dc.Clear()

   377

        self.Block = None

   378

   379

    def RefreshPreview(self):

   380

        dc = wx.ClientDC(self.Preview)

   381

        dc.SetFont(self.Preview.GetFont())

   382

        dc.Clear()

   383

        item = self.TypeTree.GetSelection()

   384

        if item.IsOk():

   385

            pydata = self.TypeTree.GetPyData(item)

   386

            if pydata["type"] == CATEGORY:

   387

                self.Block = None

   388

            else:

   389

                blocktype = self.TypeTree.GetItemText(item)

   390

                if blocktype:

   391

                    self.Block = FBD_Block(self.Preview, blocktype, 

   392

                            self.BlockName.GetValue(), 

   393

                            extension = self.Inputs.GetValue(), 

   394

                            inputs = pydata["inputs"], 

   395

                            executionControl = self.ExecutionControl.GetValue(), 

   396

                            executionOrder = self.ExecutionOrder.GetValue())

   397

                    width, height = self.MinBlockSize

   398

                    min_width, min_height = self.Block.GetMinSize()

   399

                    width, height = max(min_width, width), max(min_height, height)

   400

                    self.Block.SetSize(width, height)

   401

                    clientsize = self.Preview.GetClientSize()

   402

                    x = (clientsize.width - width) / 2

   403

                    y = (clientsize.height - height) / 2

   404

                    self.Block.SetPosition(x, y)

   405

                    self.Block.Draw(dc)

   406

                else:

   407

                    self.Block = None

   408

   409

    def OnPaint(self, event):

   410

        if self.Block is not None:

   411

            self.RefreshPreview()

   412

        event.Skip()