Python版的cocos2d库:一个2D游戏开发GUI框架的入门详解

1 说明:

=====

1.1 cocos2d是一个基于MIT协议的开源框架,用于构建游戏、应用程序和其他图形界面交互应用。

1.2 不逊色于pygame,但是其实Python版的cocos2d库是基于pygame和pyglet的,也就是集大成者

1.3 中文教程少的可怜,所以写一个入门教程,把坑填了,亲测过,注释里有讲解。

1.4 A 2D framework for games and multimedia===一个游戏和多媒体的2D框架。

1.5 环境:

华为笔记本电脑、深度deepin-linux操作系统、python3.8和微软vscode编辑器。

2 安装:

=====

pip install cocos2d
#本机安装
#sudo pip3.8 install cocos2d  #太慢了
#sudo pip3.8 install -i https://mirrors.aliyun.com/pypi/simple cocos2d  #超快,推荐国内源安装

3 官网:

=====

https://github.com/los-cocos/cocos
https://pypi.org/project/cocos2d/
http://python.cocos2d.org/doc/programming_guide/quickstart.html

4 Helloworld.py:

===========

4.1 说明:很简单,但很重要;解决中文字体问题、解决窗口大小和名称问题。

4.2 代码:

#注意导出模块是cocos,不是cocos2
#但是安装是pip install cocos2d
import cocos

class HelloWorld(cocos.layer.Layer):
    def __init__(self):
        super(HelloWorld, self).__init__()
        label = cocos.text.Label(
            #'Hello World!',
            '你好,世界!',
            #font_name='Times New Roman', #本身不支持中文,改为下面
            font_name='微软雅黑',  #微软雅黑是支持中文的字体
            font_size=32,
            anchor_x='center', anchor_y='center')
        #label.position = 320, 240  #默认窗口大小的一半,就是中心位置
        # 获得主窗口的宽度和高度,是一个二元组
        width, height = cocos.director.director.get_window_size()
        # 设置标签的位置
        label.position = width // 2, height // 2  #    //整数除法 去掉小数部分
        self.add(label)

if __name__ == "__main__":
    #cocos.director.director.init() #默认窗口大小
    #cocos.director.director.init(width=640,height=480,caption="hello world")  
    #自定义窗口大小和标题
    cocos.director.director.init(width=1200,height=800,caption="你好,世界!")  #本身就是支持中文
    hello_layer = HelloWorld()
    main_scene = cocos.scene.Scene(hello_layer)
    cocos.director.director.run(main_scene)

4.3 效果图:

4.4 定义main函数问题,采用默认设置,代码如下:

import cocos
class HelloWorld(cocos.layer.Layer):
    def __init__(self):
        super(HelloWorld, self).__init__()
        label = cocos.text.Label(\
            'Hello, world',\
            font_name='Times New Roman',\
            font_size=32,\
            anchor_x='center', anchor_y='center')
        label.position = 320, 240
        self.add(label)
#定义main函数问题
def main():
    cocos.director.director.init()
    hello_layer = HelloWorld()
    main_scene = cocos.scene.Scene (hello_layer)
    cocos.director.director.run(main_scene)

if __name__ == '__main__':
    main()

5 图片显示和音乐播放:

=================

5.1 说明:对图片格式进行测试和播放音乐格式进行测试,注释里有。

5.2 代码一:

import cocos
#下面2个模块必须导出
from cocos.scenes.transitions import *
from cocos.audio.pygame import music
#背景层
class Game_BG(cocos.layer.Layer):
    def __init__(self):
        super(Game_BG,self).__init__()
        d_width, d_height = cocos.director.director.get_window_size()
        # 创建背景精灵,图片格式,images文件夹与本代码在同一个目录下
        #background = cocos.sprite.Sprite('images/bg.jpg')
        #background = cocos.sprite.Sprite('images/help-up.png') 
        #background = cocos.sprite.Sprite('images/2.jpeg')
        background = cocos.sprite.Sprite('images/1.ico')
        #background = cocos.sprite.Sprite('images/fruit.svg')  #报错
        #background = cocos.sprite.Sprite('images/yytd.gif')   #报错
        background.position = d_width // 2, d_height // 2
        self.add(background)
 
if __name__=='__main__':
    #指定背景音乐后台 sdl,很重要!!否则背景音乐不能播放
    cocos.director.director.init(width=640,height=480,caption="picture&music",audio_backend='sdl')
    bg=Game_BG()
    main_scence=cocos.scene.Scene(bg)
    #播放背景音乐
    #music.load('sound/sn.mp3'.encode())#报错,还有指定路径,这与图片默认路径不一样 
    music.load('/home/xgj/Desktop/Cocos2d/coex/sound/sn.mp3'.encode())
    music.play(loops=-1)  #播放 循环次数
    music.set_volume(1)#声音大小
    cocos.director.director.run(main_scence)

5.2 代码二:高级一些,文字label和图片sprite缩放和旋转,加上背景音乐。

import cocos
from cocos.actions import *

class Hello_world(cocos.layer.ColorLayer):
    def __init__(self):
        #设置背景属性
        super(Hello_world, self).__init__(64,64,224,255)
        #设置标签属性
        label = cocos.text.Label('hello world',
        font_name = 'Times New Roman',font_size = 32,
        anchor_x = 'center',anchor_y = 'center')
        #设置标签位置
        label.position = 600,200  #建议窗口大小的一半,是居中
        #添加标签到层 
        self.add(label)
        #创建精灵,并配置精灵属性,图片的文件夹images与代码在同一个目录下
        man_sprite = cocos.sprite.Sprite("images/bg.jpeg")
        man_sprite.position = 600,500
        #设置精灵显示大小
        man_sprite.scale =0.8
        #添加精灵到层中
        self.add(man_sprite,z = 1,name='man')
        #使用动作方法函数,在3秒钟里缩放3次
        scale = ScaleBy(3,duration=3)
        #标签重复以上动作+旋转
        label.do(Repeat(scale+Reverse(scale)))
        #精灵重复 旋转+缩放动作
        man_sprite.do(Repeat(Reverse(scale)+scale))

#cocos.director.director.init()  #默认的
#---add,加背景音乐的设置如下---
cocos.director.director.init(width=1200,height=800,audio_backend='sdl')
from cocos.scenes.transitions import *  #包在此处导入,是便于学习
from cocos.audio.pygame import music  #一般包是放在第一步
music.load('/home/xgj/Desktop/Cocos2d/coex/sound/sn.mp3'.encode()) #背景音乐文件需要指定路径,区别
music.play(loops=-1)  #播放 循环次数
music.set_volume(1)#声音大小
#---add,加背景音乐如上---
main_layer = Hello_world()
#该图层在10秒钟内旋转360度
main_layer.do(RotateBy(360,duration=10))
main_scene = cocos.scene.Scene(main_layer)
cocos.director.director.run(main_scene)

5.3 效果图:

6 按钮放大和缩小,播放wav文件:

6.1 代码:

import cocos
from cocos.scenes.transitions import * #播放音乐包一
from cocos.audio.pygame import music  #播放音乐包二
from cocos.audio.effect import Effect

#背景层
class Game_BG(cocos.layer.Layer):
    def __init__(self):
        super(Game_BG,self).__init__()
        d_width, d_height = cocos.director.director.get_window_size()
        # 创建背景精灵
        background = cocos.sprite.Sprite('images/bg.jpeg')
        background.position = d_width // 2, d_height // 2
        self.add(background)

#自定义菜单类
class main_menu(cocos.menu.Menu):
    def __init__(self):
        super(main_menu, self).__init__()
        # 也可以改变图片项的大小
        # 改变字体
        self.font_item['font_size'] = 66
        # 选中时
        self.font_item_selected['font_size'] = 66
        #改变颜色 rgba
        self.font_item['color'] = (255,255,255,25)
        # 选中时
        self.font_item_selected['color'] = (215,255,255,255)
 
        menu_start=cocos.menu.ImageMenuItem('images/start-up.png',self.menu_start_callback)
        menu_setting= cocos.menu.ImageMenuItem('images/setting-up.png', self.menu_setting_callback)
        help_setting = cocos.menu.ImageMenuItem('images/help-up.png', self.menu_help_callback)
        #创建菜单(添加项的列表,自定义布局位置)
        self.create_menu([menu_start,menu_setting,help_setting],
                         layout_strategy=cocos.menu.fixedPositionMenuLayout([(500,339),(500,220),(500,100)]),
                         selected_effect=cocos.menu.zoom_in(),
                         unselected_effect=cocos.menu.zoom_out())
 
    #定义播放按钮功能设置
    def menu_start_callback(self):
        #注意播放wav与mp3一样,需要指定具体路径和目录,否则报错
        yinxiao=Effect('/home/xgj/Desktop/Cocos2d/coex/sound/dd.wav') #音效
        #yinxiao=Effect('sound/dd.wav') # 报错
        yinxiao.play()
    def menu_help_callback(self):
        pass
    def menu_setting_callback(self):
        pass
 
if __name__=='__main__':
    #初始化导演
    cocos.director.director.init(width=640,height=480,caption="png按钮放大",audio_backend='sdl')
    #将背景层  添加到场景
    bg=Game_BG()
    main_scence=cocos.scene.Scene(bg)
    #添加菜单
    mainmenu=main_menu()
    main_scence.add(mainmenu)
    # 播放背景音乐
    music.load('/home/xgj/Desktop/Cocos2d/coex/sound/sn.mp3'.encode())
    music.play(loops=-1)  # 播放 循环次数
    music.set_volume(1)  # 声音大小
    #启动场景
    cocos.director.director.run(main_scence)

6.2 效果图:

在这基础上去做一个音乐播放器是很有动感的!!

7 圆形球动感:

===========

7.1 代码:

import pyglet
from cocos.director import director
from cocos.scene import Scene
from cocos.layer import Layer
from cocos.actions import JumpBy, Lens3D, Reverse

class BackgroundLayer(Layer):
    def __init__(self):
        super(BackgroundLayer, self).__init__()
        #导入图片image需要导入pyglet包,注意图片与代码文件在一个目录下即可
        self.image = pyglet.resource.image('flag.png')
        #self.image = pyglet.resource.image('yytd.gif') #虽然能显示,但是不是gif那样的动感

    def draw(self):
        self.image.blit(0, 0)

if __name__ == "__main__":
    #主窗口可调节大小
    director.init(resizable=True)
    director.set_depth_test()
    scene = Scene(BackgroundLayer())
    lens = Lens3D(radius=150, lens_effect=0.7, center=(150, 150), grid=(20, 16), duration=50)
    jump = JumpBy((360, 0), 170, 3, 4)
    action = scene.do(lens)
    scene.do((jump + Reverse(jump)) * 5, target=action)
    director.run(scene)

7.2 效果图:

8 官网代码效果图,代码省略。

===是不是入门了,很简单===

喜欢就点赞、关注、转发和收藏。

中文文档太少了,做一点贡献。

举报
评论 0