python制作galgame引擎（三）

  正如上一篇所见，试验代码相当丑陋，效果也极度不堪……而且内部代码全部暴露，甚至没有一个接口，增添功能时也必然是伤筋动骨。于是，这一篇的目标是：

  1.对代码进行封装，并且代码中不能出现常量或常量字符。

  2.增加异常的处理----主要是pygame的异常

   

  说起来，对异常貌似有一个讨论，出自joel？不太记得了，大意是异常不是必要的编程元素。对于这一点，我持保留态度，个人认为引入异常能使得错误更容易被定位，给用户的提示也更加友好，还可以通过引入各种异常来提供某些特定的功能。请大家也仁者见仁。说到joel，那本《More Joel on Software》还是相当不错的一本书，适合吃饭后读着玩，因为其相当易读。Joel的话，这里有一篇他的文章，真的推荐看看：我的七个建议。

  貌似我总是习惯性离题？

  恩恩，封装的话，得先明确封装那些元素。对galgame来说，这倒是一个易于回答的问题，而就目前的进度而言，更是一个易于回答的问题：需要封装的元素是 背景图片，背景音乐，剧情文本。

  Ok，那开始吧。

  首先，为这个封装类起一个恰当的名字？我是随手用了NodeItem这个名字----估计是Sakia的影响……说到Sakia，guochaoer君在定义的时候，把文本，图片，音乐都各自用一个类来封装起来，并且都继承自pygame.Sprite.sprite。这当然是一种不错的思路，很清晰。但是我觉得，事实上文本，图片和音乐都只是字符串，大可以简单地处理处理完事。而且，通常来说galgame都是静态的，继承Sprite类也没什么益处。所以我是直接使用object这个超类的。嘛，总之，各有各的想法。我这边的话，直接写代码，就是这样：

   

# -*- coding: utf-8 -*-
import pygame
from pygame.locals import *
import os

## 这些都是需要使用到的一些常数，具体的意思，看看就明白了
SCREENWIDTH = 800
SCREENHEIGHT = 600
TEXTRECTHEIGHT = 160
LINENUMBER = 35 
OFFY = 10
OFFX = 35
VSIZE = 30
ALPHA = 180

class NodeItem(object):

    ## 因为得最后绑定到游戏屏幕上，所以类初始化的时候，
    ## 就可以传入一个对screen这个surface的引用
    ## 就我试验的结果的话，python传递类是实参传递，所以大可放心
    ## 之所以初始化这些变量，是为了能保存值，毕竟传来的某项是有
    ## None的可能性的，当该项为None是，意味着使用以前的值
    ## 就是这样。这种方式免去了每次书写相同BG或BGM的麻烦
    def __init__(self,surface):
        self.BGName = ''
        self.BGMName = ''
        self.Text = ''
        
        
        ## 这下面几行都和文本显示有关。TextBox是文本显示的容器
        ## 就galgame效果来说，就是文本显示时那个半透明的文本框
        ## TextBox其实因为有半透明这个原因，我是单独放到一个函数
        ## 里面去实现的。
        ## Font的话，其实也需要考虑很多东西，还要考虑异常。所以
        ## 我也是单独用一个函数去实现。
        ## 顺便一说，python函数的代价其实挺高的，但是考虑到这个
        ## 程序计算不密集，资源消耗也不严重，所以放心使用就好。
        ## TextBoxRect是TextBox的区域，TextBoxPos当然是位置
        ## 当然，是TextBox左上角的坐标。貌似一般都是
        ## fgColor是控制文字的颜色，bgColor是文本框的颜色
        
        self.TextBox , self.TextBoxRect = self.__initTextRect()
        self.TextBoxPos = (0,SCREENHEIGHT-TEXTRECTHEIGHT)
        self.Font = self.__initFont()
        self.bgColor = ((0x00,0x00,0x00))
        self.fgColor = ((0xFF,0xFF,0xFF))
        
        ## 绑定传入的surface
        self.Surface = surface
       
    ## 对TextBox的初始化
    def __initTextRect(self,colorkey = ALPHA):
        size = (SCREENWIDTH,TEXTRECTHEIGHT)
        TextRect = pygame.Surface(size)
        
        ## 文本框的底色……我一般习惯黑色为底，这样设置
        ## 透明之后很好看，你喜欢的话，可以设置成其他的
        TextRect.fill(self.bgColor)
        
        ## 这里设置文本框的透明度
        ## 180这是我觉得比较合适的值，可以自己多试试，
        ## 如果传入None的话，就是只有底色，恩，有人
        ## 会喜欢吧？
        if colorkey is not None:
            TextRect.set_alpha(colorkey)
        return TextRect , TextRect.get_rect()   
        
    ## 字体的初始化，考虑的问题是传入的字体并不存在，这样的
    ## 话会跳出一个异常。当然，为了便于字体的管理，放在FONT
    ## 这样的文件夹也是理所应当的。 
    def __initFont(self,name = 'hksn.ttf',size = 20):
        fullname = os.path.join('FONT',name)
        try:
            font = pygame.font.Font(fullname,size)
        except pygame.error,message:
            print 'Cannot load font:',name
            raise SystemExit,message
        return font  
        
     ###############以上是初始化工作###################
     
    ## 提供update方法，该方法作用为接受解析器，并把解析器中内容
    ## 渲染到屏幕上，该方法为一个关键方法
    ## 为了不使得这个函数太臃肿，把这玩意分解成了多个子方法
    ## 并且这一行为也利于扩展，当需要增加方法时，添加一个方法
    ## 就可以了。
    def update(self,parser):
        self.__updateBGM(parser.getBGM())
        self.__updateBackground(parser.getBackground())
        self.__updateText(parser.getName(),parser.getText())

        self.Surface.blit(self.Background,(0,0))
        self.Surface.blit(self.TextBox,self.TextBoxPos)
        
    ## 更新背景图片，为了为透明背景提供支持（恩？有这个可能性？）
    ## 顺便一提，背景图片也是需要转换大小的，嘛，显然的。
    ## 这个函数借鉴了pygame官网上某个打大猩猩（……）游戏的教程
    def __updateBackground(self,name,colorkey=None):
        fullname = os.path.join('BG',name)
        try:
            image = pygame.image.load(fullname)
        except pygame.error,message:
            print 'Cannot load image:',name
            raise SystemExit, message
        self.BGName = fullname
        image = image.convert_alpha()
        if colorkey is not None:
            if colorkey is -1:
                colorkey = image.get_at((0,0))
            image.set_colorkey(colorkey, RLEACCEL)
        image = pygame.transform.scale(image,(SCREENWIDTH,SCREENHEIGHT))
        self.Background = image

    ## 同样借鉴了打大猩猩游戏的代码，个人觉得写得很妙
    ## 特别是定义一个小类来充当哑值这一点，从来没遇见过……
    def __updateBGM(self,name):
        class NoneSound:
            def play(self):pass
        if not pygame.mixer:
            return NoneSound()
        fullname = os.path.join('BGM',name)
        if self.BGMName == fullname:
            return 
        try:
            pygame.mixer.music.load(fullname)
        except pygame.error, message:
            print 'Cannot load sound:',fullname
            raise SystemExit,message
        self.BGMName = fullname
        self.play()
    
    ##播放函数，没啥好说的
    def play(self):
        pygame.mixer.music.play(-1,0.0)
    
    ## 这个函数其实挺麻烦的……
    def __updateText(self,name,text):
        ## 刷新文本框。
        self.TextBox.fill(self.bgColor)
        
        ## 这里是控制字符编码的部分，兼实现了跨平台
        ## 这个程序开始是在Linux下开发的，所以我先
        ## 说一下。中文的显示，必须把字符编码转成
        ## utf8，否则全是乱码。这部分我以后还会详述
        ## 暂且就这样
        if WINDOWS:
                name = name.decode('gb18030')
                text = text.decode('gb18030')
        else:
                name = name.decode('utf8')
                text = text.decode('utf8')        
        
        ## 把长字符串分隔开，每35个字为一个列表，再分别render
        ## 之所以这样写，是因为render函数只支持单行……所以得用一个
        ## 循环来处理。分割成列表这个列表推导式，出自felinx，我觉得
        ## 很好玩。注意的是，字符必须是统一的编码，不然就悲剧了
        textLines = [text[i:i+LINENUMBER] for i in range(len(text)) if i % LINENUMBER == 0]
        
        ## 这个是名字，指名当前文本的说话人，都见过吧？
        ## 这个值可能为None，也可能有，如果有的话，把它放第一行显示
        if name != '':
            name += ' :'
        textLines.insert(0,name)
        
        vSize = VSIZE

        ## render显示文字的话，把坐标一定要算对，不然不好看
        ## 我这里是左对齐的算法，中对齐的话是注释掉的那个
        ## Sakia用的是中对齐，个人觉得不好看……
        ## 这里用到的常量全是试验出来的……
        for lineNum in range(len(textLines)):
            currentLine = textLines[lineNum]
            fontSurface = self.Font.render(currentLine,True,self.fgColor,self.bgColor)
            ##xPos = (SCREENWIDTH- fontSurface.get_width())/2
            xPos = OFFX
            yPos = OFFY + lineNum * vSize
            self.TextBox.blit(fontSurface,(xPos,yPos))

 

  上面就是一个封装好的类，事实上，工作得很好，当然也能看出来，其实和上一篇博文涉及的代码差不多，恩恩，就是分量增加了不少～～～我的注释很详细，有兴趣的话，请稍微仔细点阅读，谢谢了～～

  不过说起来，文本显示有一个地方我没解决。我这里是35个字符为一行显示，问题是，当字符中有英文，日文或者空格的时候，因为字符宽度比中文字符宽度窄，结果就会出现上下行宽度不均匀的情况……个人觉得不太好看。有高人能提出点简单的点子么？