全球首发WebMax高级函数教程.doc

1、-全球首发 WebMax 高级函数教程在线版1、 简介VGS 是国内第一个完全自主知识产权的网络三维互动软件技术，属国家发明专利。网络三维互动技术是下一代互联网展示技术的核心，是目前互联网技术的换代与升级。WebMax 的成功研发不仅实现了在互联网上以三维立体互动的方式发布和实时高速浏览功能，而且对用户终端电脑的硬件配置没有任何特殊要求。本函数教程完全免费！登记注册用户将第一时间得到最新函数的更新邮件！2、API 说明2.1 三维 API 函数. 8AddFlashCtrl(flashName, FlashFile, alignMode, Left, Top, width, height, L

2、oop) 8DeleteFlashCtrl( flashName ) 8SetFlashRect (flashName, alignMode, left, top, width, height) 9SetFlashCtrlVisibility(flashName, status) 9SetFlashPlayStatus(flashName, status) 102.11 系统回调及相关函数. 11PreloadN3DFile(strN3DFileName, N3DName) 11GotoN3D( N3DName) 11LoadN3DFile(strN3DFileName, N3DName) 1

3、1EnableMouseDownCallback() 11DisableMouseDownCallback() 12EnableMouseUpCallback() 12DisableMouseUpCallback() 12EnableMouseDBClickCallback() 12DisableMouseDBClickCallback() 13-EnableMouseMoveCallback() 13DisableMouseMoveCallback() 132.12 场景函数. 14SetRenderStatus(status) 14ShowDefaultLogo(status) 14Res

4、etScene() 14SetMouseMoveEventTimer(timeStep) 142.13 控制相关函数. 15SetCollisionDistance(distance) 15SetServer(strServer) 15SetControlStatus(status) 15SetEditCtrl_RosAxis(rosHint) 15SetEditCtrl_DollySpeed(dollySpeed) 16SetEditCtrl_DollyDistance(nearDis, farDis) 16SetEditCtrl_AutoParam(PitchSpeedValue,Roun

5、dSpeedValue, RollSpeedValue) 16SetEditCtrl_AutoPitchRoundRoll(status) 16SetEditCtrl_ManualParam(PitchSpeed, RoundSpeed) 17SetFBL(fblValue) 17SetWalkCtrl_ManualParam(moveSpeed, moveAcc, rotateSpeed, rotateAcc, height) 17SetLensFlareVisibility(status) 17SetModelKfrPlayStatus(modelName, bKfrPlay) 18Set

6、AllModelKfrPlayStatus(bKfrPlay) 18-SetModelKfrRepeatCnt(modelName, kfrRepeatCnt) 18SetAllModelKfrRepeatCnt(kfrRepeatCnt) 18PlayModelKfr(modelName, startFrame, endFrame, repeatCnt) 19SetButtonVisibility(btnName, visible) 19SetAntiAliasLevel(level) 19SetNavigaterVisibility(navName, visible) 19AddNavig

7、aterPointer(navigaterName,navPointerName,navPointerType, camOrModelName,navPointerOriImage, navPointerAlphaImage, width, height) 19SetNavigaterPointerVisibility(navigaterName, navPointerName, status) 20DeleteNavigaterPointer(navigaterName, navPointerName) 20SetNavigaterPointerObject(navName, navPoin

8、terName, objType, objName) 20PlayKeyFrame() 20PauseKeyFrame() 21StopKeyFrame() 21SetKeyFrameRepeatCount(repeatCnt) 21GotoFrame(frame) 21SetKeyFramePlaySpeed(fps) 21SetPlayerCanMove(status) 21SetPlayerCanRos(status) 21SetPlayerCanZoom(status) 21SetPlayerCanLift(status) 21PlayerGoForward() 21-PlayerGo

9、Backward() 21PlayerGoLeftward() 22PlayerGoRightward() 22PlayerStop() 22PlayerTurnLeft() 22PlayerTurnRight() 22PlayerTurnUp() 22PlayerTurnDown() 22PlayerGoUp() 22PlayerGoDown() 22PlayerZoomIn() 22PlayerZoomOut() 222.14 相机相关函数. 23MoveCamera(cameraName, x, y, z, stepCnt, coordEnum) 23MoveCurrentCamera(

10、x, y, z, stepCnt, coordEnum) 23SetCurrentCameraByName(camName) 23SetCameraClip(cameraName, nearClip, farClip) 23SetCurrentCameraClip(nearClip, farClip) 24DollyCurrentCamera(value, stepCnt) 24DollyCamera(cameraName, value, stepCnt) 24MoveCurrentCameraTo(from_x, from_y, from_z, at_x, at_y, at_z, frame

11、Cnt, accType) 24MoveCurrentCameraFromTo(x, y, z) 25-MoveCurrentCameraAtTo(x, y, z) 25MoveCurrentCameraFrom(x, y, z) 25MoveCurrentCameraAt(x, y, z) 25SetCurrentCameraByIndex(camIndex) 25RotateCurrentCamera(x, y, z, stepCnt, coordEnum) 25RotateCamera(cameraName, x, y, z, stepCnt, coordEnum) 26FocusCur

12、rentCameraTo(model1Name, model2Name, x, y, z, distance, stepCnt) 26SetPlayerZoomSpeed(speed) 27SetCameraFrom(cameraName, x, y, z) 27SetCameraAt(cameraName, x, y, z) 27SetCameraFov(cameraName, fov) 27SetCurrentCameraFov(fov) 27CreateCamera(name, fromX, fromY, fromZ, atX, atY, atZ, fov, nearClip, farC

13、lip) 28PauseCameraKfr(camName) 28ResumeCameraKfr(cameraName) 28PlayCameraKfr(camName, repeatCnt) 29SetCurrentCameraFrom(x, y, z) 29SetCurrentCameraAt(x, y, z) 29StopCameraKfr(camName) 29SetCanNavigateByPointer(navName, status) 292.15 模型相关函数. 31SetModelVisibility(modelName, visible) 31-SetDynamicUV(m

14、odelName, u, v, speed) 31SetModelClickable(modelName, clickable) 31SetModelOpacity(modelName, opacity) 31HideAllModels() 31ShowAllModels() 31TranslateModel(modelName, x, y, z, coord) 32MoveModel(modelName, x, y, z, coordEnum) 32MoveModelTo(modelName, x, y, z, frameCnt, accType) 32RestoreModelOpacity

15、(modelName) 32RestoreAllModelsOpacity() 33SetModelColor(modelName, red, green, blue, alpha) 33SetModelFBLStatus(modelName, status) 33RestoreModelColor(modelName) 33RestoreAllModelsColor() 33SetZOneModel(BSTR modelName, BOOL status) 33DeleteModel(modelName) 34CreateModelGroup(modelGroupName) 34Delete

16、ModelGroup(name) 34DeleteModelGroupByIndex(index) 34DeleteAllModelGroup() 34AddModelToModelGroup(modelGroupName, modelName) 34DeleteModelFromModelGroup(modelGroupName, modelName) 35-ClearModelGroup(modelGroupName) 35SetModelEventonMouseMove(status) 35SetModelMouseHint(modelName, bFlag) 35SetModelMou

17、seColor(modelName, mouseOver_Red,mouseOver_Green,mouseOver_Blue, mouseOver_Alpha,mouseClick_Red,mouseClick_Green, mouseClick_Blue,mouseClick_Alpha) 35SetModelMouseHintType(modelName, type) 36SetModelPosition(modelName, x, y, z) 36SetModelRotation(modelName, x, y, z) 372.16 材质相关函数. 38SetModelMtrl(mod

18、elName, mtrlName) 38SetMtrlOpacity(mtrlName, opacity) 38SetModelMouseMtrl(modelName, mouseOverMtrl, mouseDownMtrl) 38SetBumpWaterMtrl(mtrlName, bumpWaterName) 38RestoreModelMtrl(modelName) 39RestoreAllModelsMtrl() 39CreateMtrl(mtrlName, red, green, blue, alpha, selfIllu) 39SetMtrlColor(mtrlName, red

19、, green, blue, alpha) 39DeleteMtrl(mtrlName) 39SetMtrlIllumination(mtrlName, illumination) 40SetAlphaTestStatus(mtrlName, status) 40SetMtrlCubeMap(mtrlName, cubeMapName, power) 40SetMovieMtrl(mtrlName, movieTexName) 40-SetSpecularMapMtrl(mtrlName, specularMapName) 40SetMtrlSpecularCubeMap(mtrlName,

20、specularCubeMapName) 41DeleteAllModel() 412.17 灯光相关函数. 42SetLightColor(lightName, red, green, blue) 42SetLightPower(lightName, power) 42SetLightAmbient(lightName, red, green, blue) 42SetLightPosition(lightName, x, y, z) 42SetLightRange(lightName, range) 43SetLightAttenuation(lightName, attenuation0,

21、 attenuation1, attenuation2) 43SetLightStatus(lightName, status) 43SetLightKfrPlayStatus(lightName, bFlag) 43SetAllLightKfrPlayStatus(bFlag) 44SetLightKfrRepeatCnt(lightName, repeatCnt) 44SetAllLightKfrRepeatCnt(repeatCnt) 442.18 三维特效函数. 45CreateBumpWater(bumpWaterName, width, height, xSize, ySize)

22、45SetBumpWaterSpeed(waterName, speed) 45SetBumpWaterRadius(waterName, radius) 45SetSkyBoxModel(modelName, status) 45CreateFSMotionBlur(blurCount) 46CreateFSGlow(glowLevel) 46-SetFSMotionBlurPower(value) 46SetFSGlowPower (glowPower) 46StartFSGlow() 46EndFSGlow() 46StartFSMotionBlur() 46StopFSMotionBl

23、ur() 46SetCameraKFRFSMotionBlur(cameraName, startFrame, endFrame, power, status) 47SetCameraKfrCallBackFunc(cameraName, frameIndex, funcName) 47CreateLensFlare(x, y, z, coverFlag) 47CreateFog(fogMode, red, green, blue, density, start, end) 47SetFogColor(red, blue, green) 48SetFogMode(mode) 48SetFogD

24、ensity(density) 48SetFogField(start, end) 48SetFogRenderStatus(status) 49SetFilter(overlayName, status, opacity) 49CreateStaticCubeMap(name, frontImage, backImage, leftImage, rightImage, topImage, bottomImage, size) 49CreateMovieTexture(texName, moviePath, movieType, withAudio, mtrlName) 49CreateBac

25、kdropFromImage(backdropName,oriImageName,alphaImageName, alignMode, left, top, width, height) 50CreateSpecularMap(name, imageName, width, height, mipLevel) 51DeleteMovieTexture(mtrlName, movieTexName) 51-CreateSectionMap(sectionMapName, width, height, sliceModelName, leftTopX, leftTopY, leftTopZ, ri

26、ghtTopX, rightTopY, rightTopZ, leftBottomX, leftBottomY, leftBottomZ, rightBottomX, rightBottomY, rightBottomZ, imageName) 51ExecuteSlice(sectionMapName) 52DeleteAudioByName(BSTR name) 52DeleteAudioByIndex(INT index) 52DeleteAllAudio() 53SetAudioFile(BSTR audioName, BSTR audioFile) 53SetAudioRepeatC

27、ount(BSTR audioName, INT repeatCnt) 53PlayAudio(BSTR audioName) 53PauseAudio(BSTR audioName) 53StopAudio(BSTR audioName) 53RewindAudio(BSTR audioName) 542.2 界面 API 函数. 552.21 Overlay(前景图 )相关函数. 55CreateOverlayFromImage(overlayName,oriImageName,alphaImageName, alignMode, left, top, width, height) 55D

28、eleteOverlay(overlayName) 55SetOverlayOpacity(overlayName, opacity) 55SetOverlayWidth(overlayName, width) 55, SetOverlayHeight(overlayName, heig, , ht) 56SetOverlayAlignMode(overlayName, alignMode) 56SetOverlayRect(overlayName, left, top, width, height) 56MoveOverlay(overlayNam, , , e, x, y) 57-SetO

29、verlayVisibility(overlayName, visible) 57SetOverlayFullScreen(overlayName, xFull, yFull) 57PushOverlayFront(overlayName) 57PushOverlayBack(overlayName) 572.22 背景图相关函数. 59SetBackgroundColor(red, green, blue) 592.23 按钮相关函数. 60CreateButtonFromImage(btnName, mouseUpImage, mouseUpImage_alpha, 60mouseOver

30、Image,mouseOverImage_alpha, mouseDownImage,mouseDownImage_alpha, alignMode,x,y,width,height, callBackFunc) 60DeleteButton(btnName) 60SetButtonActive(name, bActive) 60VGS II ActiveX 插件JavaScript 编程接口说明-1、 简介本文档面向使用 VGS II ActiveX 插件制作动态三维虚拟网页的程序开发者，简要介绍了VGS II ActiveX 插件的 JavaScript 编程接口。2、 API 说明* 所

31、有在 3DSMax 中制作的模型名称、材质名称、贴图名、相机名称、灯光名称等，在Javascript 中必须全部用大写字母。-目录2.1 三维 API 函数AddFlashCtrl(flashName, FlashFile, alignMode, Left, Top, width, height, Loop)加载 Flash 控件，显示 Flash 文件，但并不播放。参数： flashName Flash 文件的别名，用于索引该 Flash 文件。 sFlashFile Flash 文件路径与文件名称。 alignMode Flash 显示矩形区域的对齐方式基准位置。 0 绝对坐标 1 左对齐

32、 2 右对齐 3 底部对齐 4 顶部对齐 5 对齐至左上角 6 顶部居中对齐 7 对齐至右上角 8 对齐至左下角 9 底部居中对齐 10 对齐至右下角 11 居中对齐 Left Flash 显示矩形区域左边的坐标值。- Top Flash 显示矩形区域顶边的坐标值。 width Flash 显示矩形区域右边的坐标值。 height Flash 显示矩形区域底部的坐标值。 Loop Flash 文件是否循环播放例：/ 加载自定义的 Flash 文件作为 logoVGS2.AddFlashCtrl(”LOGO”, ”load.swf”, 11, 0, 0, 400, 400, 1);DeleteF

33、lashCtrl( flashName )删除场景中的 Flash 控件。参数： flashName Flash 文件的别名，用于索引该 Flash 文件。例：/删除自定义的 Flash 文件VGS2.DeleteFlashCtrl(“LOGO“);SetFlashRect (flashName, alignMode, left, top, width, height)设置 Flash 的 Rect。参数： flashName Flash 文件的别名，用于索引该 Flash 文件。 alignMode Flash 显示矩形区域的对齐方式基准位置。 0 绝对坐标 1 左对齐 2 右对齐 3 底部

34、对齐- 4 顶部对齐 5 对齐至左上角 6 顶部居中对齐 7 对齐至右上角 8 对齐至左下角 9 底部居中对齐 10 对齐至右下角 11 居中对齐 Left Flash 显示矩形区域左边的坐标值。 Top Flash 显示矩形区域顶边的坐标值。 width Flash 显示矩形区域右边的坐标值。 height Flash 显示矩形区域底部的坐标值。例：/设置 Flash 的窗体VGS2.SetFlashRect(”LOGO”, 11, 0, 0, 400, 400);SetFlashCtrlVisibility(flashName, status)设置 Flash 是否可见。参数： flash

35、Name Flash 文件的别名，用于索引该 Flash 文件。 status 是否可见。true 为可见，false 位隐藏。例：/设置 Flash 可见。-VGAS2.SetFlashCtrlVisibility(“LOGO“, true);SetFlashPlayStatus(flashName, status)设置 Flash 播放状态。参数： flashName Flash 文件的别名，用于索引该 Flash 文件。 status 播放状态。 0 暂停播放 1 从暂停点开始播放 2 停止并跳转到第一帧例：/设置 Flash 暂停播放VGS2.SetFlashPlayStatus(“L

36、OGO“, 0);SetFlashCurrentFrame(flashName, frameIndex)跳转 Flash 到指定的帧。参数： flashName Flash 对象名称。 frameIndex 帧编号。例：VGS2.SetFlashCurrentFrame(”FLASH01”, 10); -2.11 系统回调及相关函数PreloadN3DFile(strN3DFileName, N3DName)把网络上指定的 N3D 文件先下载到内存，但加载到场景。这样可以在播放上一个场景时在后台下载其他场景。参数： strN3DFileName 网络上的 N3D 文件名称。 N3DName N

37、3D 文件的代名词。例：/下载下一个 N3D 文件VGS2.PreloadN3Dfile(“Xiaonei.N3D“, “Xiaonei“);GotoN3D( N3DName)跳到后台正在加载或者已经加载的 N3D 场景。加载新的场景之前会释放当前场景的内存。参数：- N3DName N3D 文件的代名词。例：/跳到下一个场景VGS2.GotoN3D(“Xiaonei“);LoadN3DFile(strN3DFileName, N3DName)LoadN3D 文件到场景。参数： strN3DFileName 网络上的 N3D 文件名称。 N3DName N3D 文件的代名词。例：/加载 N3D

38、 文件VGS2.LoadN3DFile(“XIZUN.N3D“, “XIZUN“);EnableMouseDownCallback()启用鼠标左键按下事件回调函数。默认为禁用。对应的回调函数签名为：function VGSMouseDown(LocH, LocV, type, modelUnderLoc);例：VGS2.EnableMouseDownCallback();DisableMouseDownCallback()禁用鼠标左键按下事件回调函数。默认为禁用。对应的回调函数签名为：function VGSMouseDown(LocH, LocV, type, modelUnderLoc);

39、例：-VGS2.DisableMouseDownCallback();EnableMouseUpCallback()启用鼠标左键抬起事件回调函数。默认为启用。对应的回调函数签名为：function VGSMouseUp(LocH, LocV, type, modelUnderLoc);例：VGS2.EnableMouseUpCallback();DisableMouseUpCallback()禁用鼠标左键抬起事件回调函数。默认为启用。对应的回调函数签名为：function VGSMouseUp(LocH, LocV, type, modelUnderLoc);例：VGS2.DisableMou

40、seUpCallback();EnableMouseDBClickCallback()启用鼠标双击事件回调函数。默认为禁用。对应的回调函数签名为：function VGSMouseDBClick(LocH, LocV, type, modelUnderLoc);例：VGS2.EnableMouseDBClickCallback(); DisableMouseDBClickCallback()禁用鼠标双击事件回调函数。默认为禁用。对应的回调函数签名为：function VGSMouseDBClick(LocH, LocV, type, modelUnderLoc);例：-VGS2.Disable

41、MouseDBClickCallback();EnableMouseMoveCallback()启用鼠标移动事件回调函数。默认为禁用。对应的回调函数签名为：function VGSMouseMove(LocH, LocV, type, modelUnderLoc);例：VGS2.EnableMouseMoveCallback(); DisableMouseMoveCallback()禁用鼠标移动事件回调函数。默认为禁用。对应的回调函数签名为：function VGSMouseMove(LocH, LocV, type, modelUnderLoc);例：VGS2.DisableMouseMov

42、eCallback(); -2.12 场景函数SetRenderStatus(status)设置场景是否渲染。参数： status 场景的渲染状态。True 为渲染，false 为不渲染。例：/设置场景渲染VGS2.SetRenderStatus(true);ShowDefaultLogo(status)是否显示默认的 Logo。参数： status 是否显示。true 为显示，false 为隐藏。例：/显示默认的 LogoVGS2.ShowDefaultLogo(true);ResetScene()释放场景。例：VGS2. ResetScene ();SetMouseMoveEventTim

43、er(timeStep)设置鼠标移动响应时间间隔。参数： timeStep 毫秒间隔。例：VGS2.SetMouseMoveEventTimer(300)-2.13 控制相关函数SetCollisionDistance(distance)设置碰撞发生的距离。参数： distance 有效距离。例：/设置碰撞的有效距离VGS2. SetCollisionDistance (600);SetServer(strServer)设置服务器路径。插件将该路径设置为根路径。参数： sWebServer 服务器路径。例：/设置当前页面路径为服务器路径VGS2.SetServer(location.href)

44、;SetControlStatus(status)设置控制状态。参数： status 控制状态。 0 Walk 模式 1 Eidt 模式- 2 Fly 模式 3 None 模式例：/设置为编辑模式VGS2.SetControlStatus(1);SetEditCtrl_RosAxis(rosHint)设置旋转轴，EDIT 模式有效，设置鼠标拖拽时的旋转轴。参数： rosHint 旋转中心轴标示。 0 即可绕 x 轴又能绕 y 轴旋转 1 只可绕 x 轴旋转 2 只可绕 y 轴旋转例：/设置旋转轴VGS2.SetEditCtrl_RosAxis(0);SetEditCtrl_DollySpeed

45、(dollySpeed)推进拉远相机的速度，EDIT 模式有效。参数： dollySpeed 推拉的速度。例：/设置最远和最近鼠标滚轮 Dolly 距离VGS2.SetEditCtrl_DollySpeed(5);SetEditCtrl_DollyDistance(nearDis, farDis)-设置鼠标滚轮推拉镜头的最近和最远距离，EDIT 模式下有效。参数： nearDis 最近距离。 farDis 最远距离。例：/设置最远最近鼠标滚轮 Dolly 距离VGS2.SetEditCtrl_DollyDistance(20, 1000);SetEditCtrl_AutoParam(Pitch

46、SpeedValue,RoundSpeedValue, RollSpeedValue)设置当前相机自动 Round 速度。参数： PitchSpeedValue 相机绕 x 轴旋转速度。 RoundSpeedValue 相机绕 y 轴旋转速度。 RollSpeedValue 相机绕 z 轴旋转速度。例：/设置港开始相机自动 Round 速度VGS2.SetEditCtrl_AutoParam(0, 0.01, 0);SetEditCtrl_AutoPitchRoundRoll(status)设置镜头是否自动旋转和翻滚，EDIT 模式下有效。参数： status 1 为自动旋转翻滚，0 为静止。例：/设置相机自动旋转VGS2.SetE