Public Member Functions | Properties

obj2d Class Reference

iworld2d模块——2D对象基类 More...

Inheritance diagram for obj2d:
debug_circle debug_grid debug_rectangle empty2d image2d model2d particle2d sprite2d

List of all members.

Public Member Functions

def rotate
 旋转弧度.
def rotate_to
 旋转到某个弧度.
def flip_x
 绕x轴翻转一定弧度.
def flip_y
 绕y轴翻转一定弧度.
def set_layer
def bring_to_front
def bring_to_back
def show
def hide
def is_hide
def set_pick
def unset_pick
def flush
 作用: 使得逻辑帧里面设置的位置信息能马上生效,从而使得碰撞等也马上生效.
def do_action
 动画接口,执行一个动画操作
def pause_actions
 动画接口,暂停该物体的所有动画操作.
def stop_actions
 动画接口,停止该物体的所有动画操作.
def resume_actions
 动画接口,继续该物体的所有动画操作.
def remove_action
 动画接口,删除该物体的某个动画,该动画将被销毁.
def attach_to_parent
 父子关系接口,将该对象挂到父对象下.
def detach_from_parent
 父子关系接口,将该对象从父对象解除.

Properties

 inherit_type = property(_get_inherit_type, _set_inherit_type)
 继承关系的类型.
 pos = property(_get_pos, _set_pos)
 位置坐标.
 wpos = property(_get_world_pos)
 世界坐标.
 rot = property(_get_rot, _set_rot)
 弧度.
 rot_mat = property(_get_rot_mat, _set_rot_mat)
 旋转矩阵.
 key_point = property(_get_key_point, _set_key_point)
 key点坐标,其中(0,0)点是图片的中心,key点默认是(负半宽,负半高),即图片左上角.
 scale = property(_get_scale, _set_scale)
 相对缩放比例.
 wscale = property(_get_world_scale)
 绝对缩放比例.
 alpha = property(_get_alpha, _set_alpha)
 透明度.
 color = property(_get_color, _set_color)
 颜色值RGB.
 size = property(_get_size, _set_size)
 大小,改变size,图片是从中心进行缩放.
 name = property(_get_name)
 名字.
 rlevel = property(_get_render_level, _set_render_level)
 控制在同一个层次上的渲染顺序.
 layer_id = property(_get_layer_id, _set_layer_id)
 所属的layer_id.

Detailed Description

iworld2d模块——2D对象基类


Member Function Documentation

def rotate (   self,
  rot 
)

旋转弧度.

def rotate_to (   self,
  rot 
)

旋转到某个弧度.

def flip_x (   self,
  rot 
)

绕x轴翻转一定弧度.

旋转轴的原点在key_point处。该函数可以用来实现3D的效果. 注意:如果未obj2d翻转回原来的投影面,obj2d.rot值读取为无效值 提示:自身旋转可利用rotate或rotate_to接口

Parameters:
rot: float 弧度
def flip_y (   self,
  rot 
)

绕y轴翻转一定弧度.

旋转轴的原点在key_point处。该函数可以用来实现3D的效果. 注意:如果未obj2d翻转回原来的投影面,obj2d.rot值读取为无效值 提示:自身旋转可利用rotate或rotate_to接口

Parameters:
rot: float 弧度
def set_layer (   self,
  layer_id 
)
把2D对象挂到某一层上。
此接口不应该频繁调用,否则有效率问题。如果需要动态控制层次关系的,请使用rlevel属性。
        
参数:
        layer	:int	场景某一层

Reimplemented in model2d.

def bring_to_front (   self )
改变2D对象的layer,移到最上层
此接口不应该频繁调用,否则有效率问题。如果需要动态控制层次关系的,请使用rlevel属性。

Reimplemented in model2d.

def bring_to_back (   self )
改变2D对象的layer,移到最底层
此接口不应该频繁调用,否则有效率问题。如果需要动态控制层次关系的,请使用rlevel属性。

Reimplemented in model2d.

def show (   self )
显示2D对象

Reimplemented in model2d.

def hide (   self )
隐藏2D对象
def is_hide (   self )
隐藏2D对象

返回值:
        True:隐藏
        False:显示
def set_pick (   self,
  flag = 1 
)
设置物体是否参与pick/碰撞等检测

参数:
        flag	:int	pick_flag,设置的pick类型,默认为1

Reimplemented in model2d.

def unset_pick (   self )
解除对象被鼠标点中/碰撞

Reimplemented in model2d.

def flush (   self )

作用: 使得逻辑帧里面设置的位置信息能马上生效,从而使得碰撞等也马上生效.

Reimplemented in model2d.

def do_action (   self,
  action 
)

动画接口,执行一个动画操作

Parameters:
action: iaction2d.action 动画对象
Return values:
:int 返回该动作的id
def pause_actions (   self )

动画接口,暂停该物体的所有动画操作.

def stop_actions (   self )

动画接口,停止该物体的所有动画操作.

动画停止后,动画会被销毁.

def resume_actions (   self )

动画接口,继续该物体的所有动画操作.

def remove_action (   self,
  i 
)

动画接口,删除该物体的某个动画,该动画将被销毁.

Parameters:
i: int 动作的id
def attach_to_parent (   self,
  parent 
)

父子关系接口,将该对象挂到父对象下.

说明:1 该接口对所有的 obj2d 对象均有效,如empty2d可通过此方法充当容器的使用.
2 子对象将会默认继承父对象的旋转,缩放,位移,颜色, 透明度和可见性.
3 子对象挂到父对象后,对父对象的颜色, 透明度和可见性进行设置会影响子对象.未挂接之前这些属性的改变不会对子节点生效.
4 子对象挂到父对象后,其旋转,缩放,位移属性均为相对值(相对于父对象).
5 子对象 layer_id 会更新为父对象的 layer_id.

Parameters:
parent: iworld2d.obj2d 挂接到的父对象.
def detach_from_parent (   self )

父子关系接口,将该对象从父对象解除.

说明: 1 子对象解除于父对象的绑定后,其旋转,缩放,位移属性恢复为绝对值. 2 子对象解除于父对象的绑定后,子对象的颜色, 透明度和可见性保持解除绑定前的数值.


Property Documentation

inherit_type = property(_get_inherit_type, _set_inherit_type) [static]

继承关系的类型.

继承类型 :不继承. iworld2d.OBJ_INHERIT_NONE
继承类型 :继承位移. iworld2d.OBJ_INHERIT_POS
继承类型 :继承旋转. iworld2d.OBJ_INHERIT_ROT
继承类型 :继承大小. iworld2d.OBJ_INHERIT_SCALE
继承类型 :继承可见性. iworld2d.OBJ_INHERIT_VISIBLE
继承类型 :继承颜色(包括透明度). iworld2d.OBJ_INHERIT_COLOR
默认全部继承. 可用+运算符进行相加.如继承位移和旋转:obj.inherit_type = iworld2d.OBJ_INHERIT_POS + iworld2d.OBJ_INHERIT_ROT. 请在 attach_to_parent 后对 inherit_type 修改以指定其继承关系.

pos = property(_get_pos, _set_pos) [static]

位置坐标.

(x, y) 读写.

Reimplemented in image2d.

wpos = property(_get_world_pos) [static]

世界坐标.

(x, y) 只读.

rot = property(_get_rot, _set_rot) [static]

弧度.

float 读写.

Reimplemented in image2d.

rot_mat = property(_get_rot_mat, _set_rot_mat) [static]

旋转矩阵.

math3d.matrix 读写.

key_point = property(_get_key_point, _set_key_point) [static]

key点坐标,其中(0,0)点是图片的中心,key点默认是(负半宽,负半高),即图片左上角.

(x, y) 读写.

Reimplemented in image2d, sprite2d, and particle2d.

scale = property(_get_scale, _set_scale) [static]

相对缩放比例.

(x, y) 读写.

wscale = property(_get_world_scale) [static]

绝对缩放比例.

(x, y) 只读.

alpha = property(_get_alpha, _set_alpha) [static]

透明度.

int 读写 0-255.

Reimplemented in image2d, and model2d.

color = property(_get_color, _set_color) [static]

颜色值RGB.

int 读写 rgb范围0x000000 -- 0xFFFFFF. 0x000000为黑色,0xFFFFFF为白色.

Reimplemented in image2d, and model2d.

size = property(_get_size, _set_size) [static]

大小,改变size,图片是从中心进行缩放.

(x, y) 读写.

Reimplemented in image2d, particle2d, and model2d.

name = property(_get_name) [static]

名字.

string 只读.

Reimplemented in model2d.

rlevel = property(_get_render_level, _set_render_level) [static]

控制在同一个层次上的渲染顺序.

int 读写0-65535.

layer_id = property(_get_layer_id, _set_layer_id) [static]

所属的layer_id.

int 只读,写入并不会真正修改层次.

Reimplemented in model2d.

 All Classes Namespaces Functions Variables Properties