版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

  • pk3d.startPilot(pilotAndDirectionLine, isCycle, shapeName)
    • 功能:让当前相机沿着一个路线、以一定速度漫游,从起始点漫游到结束点
    • 传入参数:
      • pilotAndDirectionLine, 给定的漫游坐标数组,至少需要2个坐标,每个坐标格式为{x,y,z},数组格式:[{x,y,z}]
      • isCycle,是否循环执行漫游
      • shapeName,2D画面中配置的3D控件名称
    • 返回:无
  • pk3d.stopPilot(shapeName)
    • 功能:停止当前漫游,摄像头保留在当前位置
    • 传入参数:
      • shapeName,2D画面中配置的3D控件名称
    • 返回:无


3D动画,包括:移动位置动画、旋转动画、拉伸动画

移动动画

  • pk3d.moveTo(modelName, targetPositionModelName, percent, durationMS, isRepeat)  移动某个模型到指定的位置
    • 功能:移动某个模型到指定的位置
    • 传入参数:
      • modelName,3D模型控件名称
      • targetPositionModelName,目标位置对象。移动模型到另一个模型中心点的位置。沿着画面开始加载时的当前modelName对象的中心点和目标对象位置targetPosObjName的连线,进行移动

      • percent,移动到两点之间连线的距离的百分比,一般应该是0--1之间的一个数值。缺省为undefined,此时表示移动到目标位置,即100%。

      • durationMS,移动到percent位置所需要的耗费的时间,单位毫秒,按照每40毫秒移动一次进行动画移动。缺省为undefined,表示0毫秒,即立即移动到目标位置
      • isRepeat,是否重复移动,true表示一直往复移动,false表示移动一次。缺省为undefined,表示仅移动1次。
    • 返回:无
    • 示例:
      • pk3d.moveTo("Box","Cylinder"),Box模型立即移动到Cylinder对象的位置
      • pk3d.moveTo("Box","Cylinder",0.6),Box模型立即移动到Cylinder对象的之间的距离的60%的位置
      • pk3d.moveTo("Box","Cylinder",0.6,500),Box模型在500毫秒内逐渐移动到Cylinder对象的之间的距离的60%的位置
      • pk3d.moveTo("Box","Cylinder",0.6,500,true),Box模型在500毫秒内逐渐移动到Cylinder对象的之间的距离的60%的位置,并在移动完成后重复移动。
        • 重复运动时,如果想关闭重复移动,可以再调用1次并将isRepeat值为false
  • pk3d.rotateToX(modelName,angle, durationMS, isRepeat)  移动某个模型到指定的位置
    • 功能:模型绕自身中心点围绕X轴旋转到达angle角度
    • 传入参数:
      • modelName,3D模型的名称
      • angle,旋转到达的角度。相对于画面运行时的角度进行旋转,为0-360度之间的一个值

      • durationMS,旋转到angle角度所需要的耗费的时间,单位毫秒,按照每40毫秒间隔逐渐进行一次旋转动作。缺省为undefined,表示0毫秒,即立即旋转到目标角度
      • isRepeat,是否重复旋转,true表示一直往复旋转,false表示旋转一次。缺省为undefined,表示仅旋转1次。
    • 返回:无
    • 示例:
      • pk3d.moveToX("Box",45),Box模型立即移动到Cylinder对象的位置
      • pk3d.moveToX("Box",45,600),Box模型在600毫秒内,绕模型中心点沿X轴方向逐渐旋转到45度角方向
      • pk3d.moveToX("Box","Cylinder",0.6,500),Box模型在600毫秒内,绕模型中心点沿X轴方向逐渐旋转到45度角方向,并在旋转完成后重复旋转。、
        • 重复运动时,如果想关闭重复移动,可以再调用1次并将isRepeat值为false
  • pk3d.rotateToY(modelName,angle, durationMS, isRepeat)  移动某个模型到指定的位置
    • 功能:模型绕自身中心点围绕Y轴旋转到达angle角度
    • 传入参数:
      • modelName,3D模型的名称
      • angle,旋转到达的角度。相对于画面运行时的角度进行旋转,为0-360度之间的一个值

      • durationMS,旋转到angle角度所需要的耗费的时间,单位毫秒,按照每40毫秒间隔逐渐进行一次旋转动作。缺省为undefined,表示0毫秒,即立即旋转到目标角度
      • isRepeat,是否重复旋转,true表示一直往复旋转,false表示旋转一次。缺省为undefined,表示仅旋转1次。
    • 返回:无
    • 示例:
      • pk3d.moveToXrotateToY("Box",45),Box模型立即移动到Cylinder对象的位置
      • pk3d.moveToXrotateToY("Box",45,600),Box模型在600毫秒内,绕模型中心点沿X轴方向逐渐旋转到45度角方向
      • pk3d.moveToXrotateToY("Box","Cylinder",0.6,50045,500,true),Box模型在600毫秒内,绕模型中心点沿Y轴方向逐渐旋转到45度角方向,并在旋转完成后重复旋转。、
        • 重复运动时,如果想关闭重复移动,可以再调用1次并将isRepeat值为false
  • pk3d.rotateToZ(modelName,angle, durationMS, isRepeat)  移动某个模型到指定的位置
    • 功能:模型绕自身中心点围绕Z轴旋转到达angle角度
    • 传入参数:
      • modelName,3D模型的名称
      • angle,旋转到达的角度。相对于画面运行时的角度进行旋转,为0-360度之间的一个值

      • durationMS,旋转到angle角度所需要的耗费的时间,单位毫秒,按照每40毫秒移动一次进行动画旋转动作。缺省为undefined,表示0毫秒,即立即旋转到目标角度
      • isRepeat,是否重复旋转,true表示一直往复旋转,false表示旋转一次。缺省为undefined,表示仅旋转1次。
    • 返回:无
    • 示例:
      • pk3d.moveToXrotateToZ("Box",45),Box模型立即移动到Cylinder对象的位置
      • pk3d.moveToXrotateToZ("Box",45,600),Box模型在600毫秒内,绕模型中心点沿X轴方向逐渐旋转到45度角方向
      • pk3d.moveToXrotateToZ("Box","Cylinder",0.6,500),Box模型在600毫秒内,绕模型中心点沿Z轴方向逐渐旋转到45度角方向,并在旋转完成后重复旋转。、
        • 重复运动时,如果想关闭重复移动,可以再调用1次并将isRepeat值为false 
  • pk3d.rotateTo(modelName,point1ModelName, point2ModelName,angle, durationMS, isRepeat)  移动某个模型到指定的位置
    • 功能:模型绕自身中心点围绕Z轴旋转到达angle角度
    • 传入参数:
      • modelName,3D模型的名称
      • point1ModelName,point2ModelName,沿着指定轴的方向进行旋转,该轴取这两个名称的3D模型的中心点连线
      • angle,旋转到达的角度。相对于画面运行时的角度进行旋转,为0-360度之间的一个值

      • durationMS,旋转到angle角度所需要的耗费的时间,单位毫秒,按照每40毫秒移动一次进行动画旋转动作。缺省为undefined,表示0毫秒,即立即旋转到目标角度
      • isRepeat,是否重复旋转,true表示一直往复旋转,false表示旋转一次。缺省为undefined,表示仅旋转1次。
    • 返回:无
    • 示例:
      • pk3d.moveToXrotateTo("Box","Cylinder",45),Box模型立即移动到Cylinder对象的位置
      • pk3d.moveToXrotateTo("Box","Cylinder",45,600),Box模型在600毫秒内,绕模型中心点沿X轴方向逐渐旋转到45度角方向
      • pk3d.moveToXrotateTo("Box","Cylinder",0.6,500),Box模型在600毫秒内,绕模型中心点沿Z轴方向逐渐旋转到45度角方向,并在旋转完成后重复旋转。、
        • 重复运动时,如果想关闭重复移动,可以再调用1次并将isRepeat值为false

...