1

#!/usr/bin/env python

     2

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

     3

     4

# This file is part of Beremiz, a Integrated Development Environment for

     5

# programming IEC 61131-3 automates supporting plcopen standard and CanFestival.

     6

#

     7

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

     8

#

     9

# See COPYING file for copyrights details.

    10

#

    11

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

    12

# modify it under the terms of the GNU General Public License

    13

# as published by the Free Software Foundation; either version 2

    14

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

    15

#

    16

# This program 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

    19

# GNU General Public License for more details.

    20

#

    21

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

    22

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

    23

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

    24

    25

    26

from __future__ import absolute_import

    27

import math

    28

from time import time as gettime

    29

from types import TupleType

    30

from threading import Lock

    31

    32

import wx

    33

    34

from plcopen.structures import *

    35

from PLCControler import ITEM_VAR_LOCAL, ITEM_POU, ITEM_PROGRAM, ITEM_FUNCTIONBLOCK

    36

from graphics.DebugDataConsumer import DebugDataConsumer

    37

    38

from graphics.GraphicCommons import *

    39

from graphics.FBD_Objects import *

    40

from graphics.LD_Objects import *

    41

from graphics.SFC_Objects import *

    42

from graphics.RubberBand import RubberBand

    43

from graphics.DebugDataConsumer import DebugDataConsumer

    44

    45

from dialogs import *

    46

from editors.DebugViewer import DebugViewer, REFRESH_PERIOD

    47

from editors.EditorPanel import EditorPanel

    48

    49

SCROLLBAR_UNIT = 10

    50

WINDOW_BORDER = 10

    51

SCROLL_ZONE = 10

    52

    53

CURSORS = None

    54

SFC_Objects = (SFC_Step, SFC_ActionBlock, SFC_Transition, SFC_Divergence, SFC_Jump)

    55

    56

    57

def ResetCursors():

    58

    global CURSORS

    59

    if CURSORS is None:

    60

        CURSORS = [wx.NullCursor,

    61

                   wx.StockCursor(wx.CURSOR_HAND),

    62

                   wx.StockCursor(wx.CURSOR_SIZENWSE),

    63

                   wx.StockCursor(wx.CURSOR_SIZENESW),

    64

                   wx.StockCursor(wx.CURSOR_SIZEWE),

    65

                   wx.StockCursor(wx.CURSOR_SIZENS)]

    66

    67

    68

def AppendMenu(parent, help, id, kind, text):

    69

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

    70

        parent.Append(help=help, id=id, kind=kind, text=text)

    71

    else:

    72

        parent.Append(helpString=help, id=id, kind=kind, item=text)

    73

    74

    75

if wx.Platform == '__WXMSW__':

    76

    faces = {

    77

        'times': 'Times New Roman',

    78

        'mono':  'Courier New',

    79

        'helv':  'Arial',

    80

        'other': 'Comic Sans MS',

    81

        'size':  10,

    82

    }

    83

else:

    84

    faces = {

    85

        'times': 'Times',

    86

        'mono':  'Courier',

    87

        'helv':  'Helvetica',

    88

        'other': 'new century schoolbook',

    89

        'size':  12,

    90

    }

    91

    92

if wx.Platform == '__WXMSW__':

    93

    MAX_ZOOMIN = 4

    94

else:

    95

    MAX_ZOOMIN = 7

    96

ZOOM_FACTORS = [math.sqrt(2) ** x for x in xrange(-6, MAX_ZOOMIN)]

    97

    98

    99

def GetVariableCreationFunction(variable_type):

   100

    def variableCreationFunction(viewer, id, specific_values):

   101

        return FBD_Variable(viewer,

   102

                            variable_type,

   103

                            specific_values.name,

   104

                            specific_values.value_type,

   105

                            id,

   106

                            specific_values.execution_order)

   107

    return variableCreationFunction

   108

   109

   110

def GetConnectorCreationFunction(connector_type):

   111

    def connectorCreationFunction(viewer, id, specific_values):

   112

        return FBD_Connector(viewer,

   113

                             connector_type,

   114

                             specific_values.name,

   115

                             id)

   116

    return connectorCreationFunction

   117

   118

   119

def commentCreationFunction(viewer, id, specific_values):

   120

    return Comment(viewer, specific_values.content, id)

   121

   122

   123

def GetPowerRailCreationFunction(powerrail_type):

   124

    def powerRailCreationFunction(viewer, id, specific_values):

   125

        return LD_PowerRail(viewer,

   126

                            powerrail_type,

   127

                            id,

   128

                            specific_values.connectors)

   129

    return powerRailCreationFunction

   130

   131

   132

def NEGATED_VALUE(x):

   133

    return x if x is not None else False

   134

   135

   136

def MODIFIER_VALUE(x):

   137

    return x if x is not None else 'none'

   138

   139

   140

CONTACT_TYPES = {(True, "none"): CONTACT_REVERSE,

   141

                 (False, "rising"): CONTACT_RISING,

   142

                 (False, "falling"): CONTACT_FALLING}

   143

   144

   145

def contactCreationFunction(viewer, id, specific_values):

   146

    contact_type = CONTACT_TYPES.get((NEGATED_VALUE(specific_values.negated),

   147

                                      MODIFIER_VALUE(specific_values.edge)),

   148

                                     CONTACT_NORMAL)

   149

    return LD_Contact(viewer, contact_type, specific_values.name, id)

   150

   151

   152

COIL_TYPES = {(True, "none", "none"): COIL_REVERSE,

   153

              (False, "none", "set"): COIL_SET,

   154

              (False, "none", "reset"): COIL_RESET,

   155

              (False, "rising", "none"): COIL_RISING,

   156

              (False, "falling", "none"): COIL_FALLING}

   157

   158

   159

def coilCreationFunction(viewer, id, specific_values):

   160

    coil_type = COIL_TYPES.get((NEGATED_VALUE(specific_values.negated),

   161

                                MODIFIER_VALUE(specific_values.edge),

   162

                                MODIFIER_VALUE(specific_values.storage)),

   163

                               COIL_NORMAL)

   164

    return LD_Coil(viewer, coil_type, specific_values.name, id)

   165

   166

   167

def stepCreationFunction(viewer, id, specific_values):

   168

    step = SFC_Step(viewer,

   169

                    specific_values.name,

   170

                    specific_values.initial,

   171

                    id)

   172

    if specific_values.action is not None:

   173

        step.AddAction()

   174

        connector = step.GetActionConnector()

   175

        connector.SetPosition(wx.Point(*specific_values.action.position))

   176

    return step

   177

   178

   179

def transitionCreationFunction(viewer, id, specific_values):

   180

    transition = SFC_Transition(viewer,

   181

                                specific_values.condition_type,

   182

                                specific_values.condition,

   183

                                specific_values.priority,

   184

                                id)

   185

    return transition

   186

   187

   188

divergence_types = [SELECTION_DIVERGENCE,

   189

                    SELECTION_CONVERGENCE, SIMULTANEOUS_DIVERGENCE, SIMULTANEOUS_CONVERGENCE]

   190

   191

   192

def GetDivergenceCreationFunction(divergence_type):

   193

    def divergenceCreationFunction(viewer, id, specific_values):

   194

        return SFC_Divergence(viewer, divergence_type,

   195

                              specific_values.connectors, id)

   196

    return divergenceCreationFunction

   197

   198

   199

def jumpCreationFunction(viewer, id, specific_values):

   200

    return SFC_Jump(viewer, specific_values.target, id)

   201

   202

   203

def actionBlockCreationFunction(viewer, id, specific_values):

   204

    return SFC_ActionBlock(viewer, specific_values.actions, id)

   205

   206

   207

ElementCreationFunctions = {

   208

    "input": GetVariableCreationFunction(INPUT),

   209

    "output": GetVariableCreationFunction(OUTPUT),

   210

    "inout": GetVariableCreationFunction(INOUT),

   211

    "connector": GetConnectorCreationFunction(CONNECTOR),

   212

    "continuation": GetConnectorCreationFunction(CONTINUATION),

   213

    "comment": commentCreationFunction,

   214

    "leftPowerRail": GetPowerRailCreationFunction(LEFTRAIL),

   215

    "rightPowerRail": GetPowerRailCreationFunction(RIGHTRAIL),

   216

    "contact": contactCreationFunction,

   217

    "coil": coilCreationFunction,

   218

    "step": stepCreationFunction,

   219

    "transition": transitionCreationFunction,

   220

    "selectionDivergence": GetDivergenceCreationFunction(SELECTION_DIVERGENCE),

   221

    "selectionConvergence": GetDivergenceCreationFunction(SELECTION_CONVERGENCE),

   222

    "simultaneousDivergence": GetDivergenceCreationFunction(SIMULTANEOUS_DIVERGENCE),

   223

    "simultaneousConvergence": GetDivergenceCreationFunction(SIMULTANEOUS_CONVERGENCE),

   224

    "jump": jumpCreationFunction,

   225

    "actionBlock": actionBlockCreationFunction,

   226

}

   227

   228

   229

def sort_blocks(block_infos1, block_infos2):

   230

    x1, y1 = block_infos1[0].GetPosition()

   231

    x2, y2 = block_infos2[0].GetPosition()

   232

    if y1 == y2:

   233

        return cmp(x1, x2)

   234

    else:

   235

        return cmp(y1, y2)

   236

   237

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

   238

#                       Graphic elements Viewer base class

   239

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

   240

   241

   242

# ID Constants for alignment menu items

   243

[

   244

    ID_VIEWERALIGNMENTMENUITEMS0, ID_VIEWERALIGNMENTMENUITEMS1,

   245

    ID_VIEWERALIGNMENTMENUITEMS2, ID_VIEWERALIGNMENTMENUITEMS4,

   246

    ID_VIEWERALIGNMENTMENUITEMS5, ID_VIEWERALIGNMENTMENUITEMS6,

   247

] = [wx.NewId() for _init_coll_AlignmentMenu_Items in range(6)]

   248

   249

# ID Constants for contextual menu items

   250

[

   251

    ID_VIEWERCONTEXTUALMENUITEMS0, ID_VIEWERCONTEXTUALMENUITEMS1,

   252

    ID_VIEWERCONTEXTUALMENUITEMS2, ID_VIEWERCONTEXTUALMENUITEMS3,

   253

    ID_VIEWERCONTEXTUALMENUITEMS5, ID_VIEWERCONTEXTUALMENUITEMS6,

   254

    ID_VIEWERCONTEXTUALMENUITEMS8, ID_VIEWERCONTEXTUALMENUITEMS9,

   255

    ID_VIEWERCONTEXTUALMENUITEMS11, ID_VIEWERCONTEXTUALMENUITEMS12,

   256

    ID_VIEWERCONTEXTUALMENUITEMS14, ID_VIEWERCONTEXTUALMENUITEMS16,

   257

    ID_VIEWERCONTEXTUALMENUITEMS17,

   258

] = [wx.NewId() for _init_coll_ContextualMenu_Items in range(13)]

   259

   260

   261

class ViewerDropTarget(wx.TextDropTarget):

   262

   263

    def __init__(self, parent):

   264

        wx.TextDropTarget.__init__(self)

   265

        self.ParentWindow = parent

   266

   267

    def OnDropText(self, x, y, data):

   268

        self.ParentWindow.Select()

   269

        tagname = self.ParentWindow.GetTagName()

   270

        pou_name, pou_type = self.ParentWindow.Controler.GetEditedElementType(tagname, self.ParentWindow.Debug)

   271

        x, y = self.ParentWindow.CalcUnscrolledPosition(x, y)

   272

        x = int(x / self.ParentWindow.ViewScale[0])

   273

        y = int(y / self.ParentWindow.ViewScale[1])

   274

        scaling = self.ParentWindow.Scaling

   275

        message = None

   276

        try:

   277

            values = eval(data)

   278

        except Exception:

   279

            message = _("Invalid value \"%s\" for viewer block") % data

   280

            values = None

   281

        if not isinstance(values, TupleType):

   282

            message = _("Invalid value \"%s\" for viewer block") % data

   283

            values = None

   284

        if values is not None:

   285

            if values[1] == "debug":

   286

                pass

   287

            elif values[1] == "program":

   288

                message = _("Programs can't be used by other POUs!")

   289

            elif values[1] in ["function", "functionBlock"]:

   290

                if pou_name == values[0]:

   291

                    message = _("\"%s\" can't use itself!") % pou_name

   292

                elif pou_type == "function" and values[1] != "function":

   293

                    message = _("Function Blocks can't be used in Functions!")

   294

                elif self.ParentWindow.Controler.PouIsUsedBy(pou_name, values[0], self.ParentWindow.Debug):

   295

                    message = _("\"{a1}\" is already used by \"{a2}\"!").format(a1=pou_name, a2=values[0])

   296

                else:

   297

                    blockname = values[2]

   298

                    if len(values) > 3:

   299

                        blockinputs = values[3]

   300

                    else:

   301

                        blockinputs = None

   302

                    if values[1] != "function" and blockname == "":

   303

                        blockname = self.ParentWindow.GenerateNewName(blocktype=values[0])

   304

                    if blockname.upper() in [name.upper() for name in self.ParentWindow.Controler.GetProjectPouNames(self.ParentWindow.Debug)]:

   305

                        message = _("\"%s\" pou already exists!") % blockname

   306

                    elif blockname.upper() in [name.upper() for name in self.ParentWindow.Controler.GetEditedElementVariables(tagname, self.ParentWindow.Debug)]:

   307

                        message = _("\"%s\" element for this pou already exists!") % blockname

   308

                    else:

   309

                        id = self.ParentWindow.GetNewId()

   310

                        block = FBD_Block(self.ParentWindow, values[0], blockname, id, inputs=blockinputs)

   311

                        width, height = block.GetMinSize()

   312

                        if scaling is not None:

   313

                            x = round(float(x) / float(scaling[0])) * scaling[0]

   314

                            y = round(float(y) / float(scaling[1])) * scaling[1]

   315

                            width = round(float(width) / float(scaling[0]) + 0.5) * scaling[0]

   316

                            height = round(float(height) / float(scaling[1]) + 0.5) * scaling[1]

   317

                        block.SetPosition(x, y)

   318

                        block.SetSize(width, height)

   319

                        self.ParentWindow.AddBlock(block)

   320

                        self.ParentWindow.Controler.AddEditedElementBlock(tagname, id, values[0], blockname)

   321

                        self.ParentWindow.RefreshBlockModel(block)

   322

                        self.ParentWindow.RefreshBuffer()

   323

                        self.ParentWindow.RefreshScrollBars()

   324

                        self.ParentWindow.RefreshVisibleElements()

   325

                        self.ParentWindow.RefreshVariablePanel()

   326

                        self.ParentWindow.ParentWindow.RefreshPouInstanceVariablesPanel()

   327

                        self.ParentWindow.Refresh(False)

   328

            elif values[1] == "location":

   329

                if pou_type == "program":

   330

                    location = values[0]

   331

                    if not location.startswith("%"):

   332

                        dialog = wx.SingleChoiceDialog(

   333

                            self.ParentWindow.ParentWindow,

   334

                            _("Select a variable class:"),

   335

                            _("Variable class"),

   336

                            [_("Input"), _("Output"), _("Memory")],

   337

                            wx.DEFAULT_DIALOG_STYLE | wx.OK | wx.CANCEL)

   338

                        if dialog.ShowModal() == wx.ID_OK:

   339

                            selected = dialog.GetSelection()

   340

                        else:

   341

                            selected = None

   342

                        dialog.Destroy()

   343

                        if selected is None:

   344

                            return

   345

                        if selected == 0:

   346

                            location = "%I" + location

   347

                        elif selected == 1:

   348

                            location = "%Q" + location

   349

                        else:

   350

                            location = "%M" + location

   351

                    var_name = values[3]

   352

                    dlg = wx.TextEntryDialog(

   353

                        self.ParentWindow.ParentWindow,

   354

                        _("Confirm or change variable name"),

   355

                        _('Variable Drop'), var_name)

   356

                    dlg.SetValue(var_name)

   357

                    var_name = dlg.GetValue() if dlg.ShowModal() == wx.ID_OK else None

   358

                    dlg.Destroy()

   359

                    if var_name is None:

   360

                        return

   361

                    elif var_name.upper() in [name.upper() for name in self.ParentWindow.Controler.GetProjectPouNames(self.ParentWindow.Debug)]:

   362

                        message = _("\"%s\" pou already exists!") % var_name

   363

                    elif not var_name.upper() in [name.upper() for name in self.ParentWindow.Controler.GetEditedElementVariables(tagname, self.ParentWindow.Debug)]:

   364

                        if location[1] == "Q":

   365

                            var_class = OUTPUT

   366

                        else:

   367

                            var_class = INPUT

   368

                        if values[2] is not None:

   369

                            var_type = values[2]

   370

                        else:

   371

                            var_type = LOCATIONDATATYPES.get(location[2], ["BOOL"])[0]

   372

                        self.ParentWindow.Controler.AddEditedElementPouVar(tagname, var_type, var_name, location=location, description=values[4])

   373

                        self.ParentWindow.RefreshVariablePanel()

   374

                        self.ParentWindow.ParentWindow.RefreshPouInstanceVariablesPanel()

   375

                        self.ParentWindow.AddVariableBlock(x, y, scaling, var_class, var_name, var_type)

   376

                    else:

   377

                        message = _("\"%s\" element for this pou already exists!") % var_name

   378

            elif values[1] == "NamedConstant":

   379

                if pou_type == "program":

   380

                    initval = values[0]

   381

                    var_name = values[3]

   382

                    dlg = wx.TextEntryDialog(

   383

                        self.ParentWindow.ParentWindow,

   384

                        _("Confirm or change variable name"),

   385

                        _('Variable Drop'), var_name)

   386

                    dlg.SetValue(var_name)

   387

                    var_name = dlg.GetValue() if dlg.ShowModal() == wx.ID_OK else None

   388

                    dlg.Destroy()

   389

                    if var_name is None:

   390

                        return

   391

                    elif var_name.upper() in [name.upper() for name in self.ParentWindow.Controler.GetProjectPouNames(self.ParentWindow.Debug)]:

   392

                        message = _("\"%s\" pou already exists!") % var_name

   393

                    elif not var_name.upper() in [name.upper() for name in self.ParentWindow.Controler.GetEditedElementVariables(tagname, self.ParentWindow.Debug)]:

   394

                        var_class = INPUT

   395

                        var_type = values[2]

   396

                        self.ParentWindow.Controler.AddEditedElementPouVar(tagname, var_type, var_name, description=values[4], initval=initval)

   397

                        self.ParentWindow.RefreshVariablePanel()

   398

                        self.ParentWindow.ParentWindow.RefreshPouInstanceVariablesPanel()

   399

                        self.ParentWindow.AddVariableBlock(x, y, scaling, var_class, var_name, var_type)

   400

                    else:

   401

                        message = _("\"%s\" element for this pou already exists!") % var_name

   402

            elif values[1] == "Global":

   403

                var_name = values[0]

   404

                dlg = wx.TextEntryDialog(

   405

                    self.ParentWindow.ParentWindow,

   406

                    _("Confirm or change variable name"),

   407

                    _('Variable Drop'), var_name)

   408

                dlg.SetValue(var_name)

   409

                var_name = dlg.GetValue() if dlg.ShowModal() == wx.ID_OK else None

   410

                dlg.Destroy()

   411

                if var_name is None:

   412

                    return

   413

                elif var_name.upper() in [name.upper() for name in self.ParentWindow.Controler.GetProjectPouNames(self.ParentWindow.Debug)]:

   414

                    message = _("\"%s\" pou already exists!") % var_name

   415

                elif not var_name.upper() in [name.upper() for name in self.ParentWindow.Controler.GetEditedElementVariables(tagname, self.ParentWindow.Debug)]:

   416

                    self.ParentWindow.Controler.AddEditedElementPouExternalVar(tagname, values[2], var_name)

   417

                    self.ParentWindow.RefreshVariablePanel()

   418

                    self.ParentWindow.ParentWindow.RefreshPouInstanceVariablesPanel()

   419

                    self.ParentWindow.AddVariableBlock(x, y, scaling, INPUT, var_name, values[2])

   420

                else:

   421

                    message = _("\"%s\" element for this pou already exists!") % var_name

   422

            elif values[1] == "Constant":

   423

                self.ParentWindow.AddVariableBlock(x, y, scaling, INPUT, values[0], None)

   424

            elif values[3] == tagname:

   425

                if values[1] == "Output":

   426

                    var_class = OUTPUT

   427

                elif values[1] == "InOut":

   428

                    var_class = INPUT

   429

                else:

   430

                    var_class = INPUT

   431

                tree = dict([(var.Name, var.Tree) for var in self.ParentWindow.Controler.GetEditedElementInterfaceVars(tagname, True, self.ParentWindow.Debug)]).get(values[0], None)

   432

                if tree is not None:

   433

                    if len(tree[0]) > 0:

   434

                        menu = wx.Menu(title='')

   435

                        self.GenerateTreeMenu(x, y, scaling, menu, "", var_class, [(values[0], values[2], tree)])

   436

                        self.ParentWindow.PopupMenuXY(menu)

   437

                    else:

   438

                        self.ParentWindow.AddVariableBlock(x, y, scaling, var_class, values[0], values[2])

   439

                else:

   440

                    message = _("Unknown variable \"%s\" for this POU!") % values[0]

   441

            else:

   442

                message = _("Variable don't belong to this POU!")

   443

        if message is not None:

   444

            wx.CallAfter(self.ShowMessage, message)

   445

   446

    def GenerateTreeMenu(self, x, y, scaling, menu, base_path, var_class, tree):

   447

        for child_name, child_type, (child_tree, child_dimensions) in tree:

   448

            if base_path:

   449

                child_path = "%s.%s" % (base_path, child_name)

   450

            else:

   451

                child_path = child_name

   452

            if len(child_dimensions) > 0:

   453

                child_path += "[%s]" % ",".join([str(dimension[0]) for dimension in child_dimensions])

   454

                child_name += "[]"

   455

            new_id = wx.NewId()

   456

            AppendMenu(menu, help='', id=new_id, kind=wx.ITEM_NORMAL, text=child_name)

   457

            self.ParentWindow.Bind(wx.EVT_MENU, self.GetAddVariableBlockFunction(x, y, scaling, var_class, child_path, child_type), id=new_id)

   458

            if len(child_tree) > 0:

   459

                new_id = wx.NewId()

   460

                child_menu = wx.Menu(title='')

   461

                self.GenerateTreeMenu(x, y, scaling, child_menu, child_path, var_class, child_tree)

   462

                menu.AppendMenu(new_id, "%s." % child_name, child_menu)

   463

   464

    def GetAddVariableBlockFunction(self, x, y, scaling, var_class, var_name, var_type):

   465

        def AddVariableFunction(event):

   466

            self.ParentWindow.AddVariableBlock(x, y, scaling, var_class, var_name, var_type)

   467

        return AddVariableFunction

   468

   469

    def ShowMessage(self, message):

   470

        message = wx.MessageDialog(self.ParentWindow, message, _("Error"), wx.OK | wx.ICON_ERROR)

   471

        message.ShowModal()

   472

        message.Destroy()

   473

   474

   475

class DebugInstanceName(DebugDataConsumer):

   476

    VALUE_TRANSLATION = {True: _("Active"), False: _("Inactive")}

   477

   478

    def __init__(self, parent):

   479

        DebugDataConsumer.__init__(self)

   480

        self.Parent = parent

   481

        self.ActionLastState = None

   482

        self.ActionState = None

   483

        self.x_offset = 2

   484

        self.y_offset = 2

   485

   486

    def SetValue(self, value):

   487

        self.ActionState = value

   488

        if self.ActionState != self.ActionLastState:

   489

            self.ActionLastState = self.ActionState

   490

            wx.CallAfter(self.Parent.ElementNeedRefresh, self)

   491

   492

    def GetInstanceName(self):

   493

        return _("Debug: %s") % self.Parent.InstancePath

   494

   495

    def GetRedrawRect(self):

   496

        x, y = self.Parent.CalcUnscrolledPosition(self.x_offset, self.y_offset)

   497

        dc = self.Parent.GetLogicalDC()

   498

        ipw, _iph = dc.GetTextExtent(self.GetInstanceName())

   499

        vw, vh = 0, 0

   500

        for value in self.VALUE_TRANSLATION.itervalues():