bug or wrong documentation ?(setbuffer and camera)

Archives Forums/Blitz3D Bug Reports/bug or wrong documentation ?(setbuffer and camera)

RemiD

(Posted 2016) [#1]

bug or wrong documentation ?(setbuffer and camera)

Firstly the documentation :
http://www.blitzbasic.com/b3ddocs/command.php?name=SetBuffer&ref=2d_a-z
http://www.blitzbasic.com/b3ddocs/command.php?name=CreateCamera&ref=3d_a-z

Secondly, in order to make more friends (and stimulate the discussion :P), i just want to say that many people on these forums have no clue on how to use setbuffer(backbuffer())... ( many put it after Graphics3d() and hope for the best, ;) )

That being said, what is the problem ?

If i use setbuffer(backbuffer()) before creating the camera, then even if i use setbuffer(imagebuffer(ximage)) or setbuffer(texturebuffer(xtexture)), the camera will always render the scene on the backbuffer...

But ! If i use setbuffer(imagebuffer(ximage)) or setbuffer(texturebuffer(xtexture)) (for example when premaking some images/textures that i will use for the game) and then if i create a camera just after, then even if i use setbuffer(backbuffer()) before renderworld() (i want to render the scene on the backbuffer after all...), then the camera seems to render the scene on the last set imagebuffer/texturebuffer (the last buffer set before creating the camera), which is impossible according to the documentation and illogical according to the code (because the use of setbuffer(backbuffer()) before renderworld() which means "render the 3dscene on the backbuffer" (please)... )...

examples :

;use of setbuffer(backbuffer()) before creating the camera, then use of setbuffer(imagebuffer(ximage)) or setbuffer(texturebuffer(xtexture)) -> the 3dscene is rendered on the backbuffer
Graphics3D(1000,625,32,2)
HidePointer()

SeedRnd(MilliSecs())

;Input
Global MX%
Global MY%
Global MXDiff%
Global MYDiff%

;PREMADE FONTS IMAGES MESHES TEXTURES SKELETONS ANIMATIONS SOUNDS
Global Arial15Font = LoadFont("Arial",15,False,False,False)

Global TestImage = CreateImage(100,100)
SetBuffer(ImageBuffer(TestImage))
ClsColor(250,250,250)
Cls()
Color(255,000,000)
Plot(0,0)
Color(000,255,000)
Plot(100-1,0)
Color(000,000,255)
Plot(0,100-1)
Color(255,255,000)
Plot(100-1,100-1)

Global TestMesh = CreateMesh()
Surface = CreateSurface(TestMesh)
AddVertex(Surface, 0.0, 0.0, 1.0, Float(0)/128, Float(0)/128)
AddVertex(Surface, 1.0, 0.0, 1.0, Float(100)/128, Float(0)/128)
AddVertex(Surface, 0.0, 0.0, 0.0, Float(0)/128, Float(100)/128)
AddVertex(Surface, 1.0, 0.0, 0.0, Float(100)/128, Float(100)/128)
AddTriangle(Surface,0,1,2)
AddTriangle(Surface,2,1,3)
UpdateNormals(TestMesh)

Global TestTexture = CreateTexture(128,128)
SetBuffer(TextureBuffer(TestTexture))
ClsColor(125,125,125)
Cls()
Color(255,000,000)
Plot(0,0)
Color(000,255,000)
Plot(100-1,0)
Color(000,000,255)
Plot(0,100-1)
Color(255,255,000)
Plot(100-1,100-1)
TextureBlend(TestTexture,1)

EntityTexture(TestMesh,TestTexture)

;Camera
SetBuffer(BackBuffer())
Global Camera = CreateCamera()
CameraRange(Camera,0.1,100)
CameraClsColor(Camera,000,000,000)

;Origine
Origine = CreateCube()
ScaleMesh(Origine,0.01/2,0.01/2,0.01/2)
EntityColor(Origine,255,000,255)

;DLight
Global DLight = CreateLight(1)
;LightRange(DLight,1000+100)
LightColor(DLight,225,225,225)
PositionEntity(DLight,50,1000,-1000,True)
RotateEntity(DLight,45,0,0,True)

AmbientLight(030,030,030)

;Ghost
Global GhostRoot
Global GhostRootYaw#
Global GhostEyes
Global GhostEyesPitch#
BuildGhost()

PositionEntity(GhostRoot,0,1.65,-3,True)

Global Timer = CreateTimer(30)

Main()

End()

Function Main()

 Repeat

  MX = MouseX()
  MY = MouseY()

  MXDiff = MouseXSpeed()
  MYDiff = MouseYSpeed()

  UpdateGhost()
  PositionRotateEntityLikeOtherEntity(Camera,GhostEyes) 	   

  Wireframe(False)
  If( KeyDown(2)=1 )
   Wireframe(True)
  EndIf

  SetBuffer(BackBuffer())
  RenderWorld()

  DrawImage(TestImage,GraphicsWidth()/2-ImageWidth(TestImage)/2,0)

  SetFont(Arial15Font)
  Color(255,255,255)
  CText("Hello world !",0,0)

  WaitTimer(Timer)
  VWait():Flip(False)

 Until( KeyDown(1)=1 )

End Function

Function CText(TextStr$,PX%,PY%)
 Text(PX,PY,TextStr,False,False)
End Function

Function PositionEntityLikeOtherEntity(Entity,OEntity)
 PositionEntity(Entity,EntityX(OEntity,True),EntityY(OEntity,True),EntityZ(OEntity,True),True)
End Function

Function RotateEntityLikeOtherEntity(Entity,OEntity)
 RotateEntity(Entity,EntityPitch(OEntity,True),EntityYaw(OEntity,True),EntityRoll(OEntity,True),True)
End Function

Function PositionRotateEntityLikeOtherEntity(Entity,OEntity)
 PositionEntity(Entity,EntityX(OEntity,True),EntityY(OEntity,True),EntityZ(OEntity,True),True)
 RotateEntity(Entity,EntityPitch(OEntity,True),EntityYaw(OEntity,True),EntityRoll(OEntity,True),True)
End Function

Function BuildGhost()
 
 GhostRoot = CreatePivot()

 GhostEyes = CreatePivot()
 PositionRotateEntityLikeOtherEntity(GhostEyes,GhostRoot)
 EntityParent(GhostEyes,GhostRoot,True)

End Function

Function InitializeGhost()
 PositionEntity(GhostRoot,0,0,-3,True)
End Function

Function UpdateGhost()

 MoveMouse(GraphicsWidth()/2,GraphicsHeight()/2)
 GhostRootYaw = GhostRootYaw - Float(MXDiff)/10
 RotateEntity(GhostRoot,0,GhostRootYaw,0,False)
 GhostEyesPitch = GhostEyesPitch + Float(MYDiff)/10
 If( GhostEyesPitch < -89 )
  GhostEyesPitch = -89
 Else If( GhostEyesPitch > 89 )
  GhostEyesPitch = 89
 EndIf
 RotateEntity(GhostEyes,GhostEyesPitch,0,0,False)

 If( KeyDown(42) = 0 And KeyDown(29) = 0 )
  Speed# = 0.1
 Else If( KeyDown(42) = 1 And KeyDown(29) = 0 )
  Speed# = 1
 Else If( KeyDown(42) = 0 And KeyDown(29) = 1 )
  Speed# = 0.01
 EndIf

 If( KeyDown(17)=1 Or MouseDown(1)=1 )
  MoveEntity(GhostRoot,0,0,Speed)
 Else If( KeyDown(31)=1 Or MouseDown(2)=1 )
  MoveEntity(GhostRoot,0,0,-Speed)
 EndIf
 If( KeyDown(30)=1 )
  MoveEntity(GhostRoot,-Speed,0,0)
 Else If( KeyDown(32)=1 )
  MoveEntity(GhostRoot,Speed,0,0)
 EndIf
 If( KeyDown(16)=1 )
  MoveEntity(GhostRoot,0,-Speed,0)
 Else If( KeyDown(18)=1 )
  MoveEntity(GhostRoot,0,Speed,0)
 EndIf

End Function

;use of setbuffer(imagebuffer(ximage)) or setbuffer(texturebuffer(xtexture)) before creating the camera  -> the 3dscene is rendered on the last set buffer (imagebuffer or texturebuffer)
Graphics3D(1000,625,32,2)
HidePointer()

SeedRnd(MilliSecs())

;Input
Global MX%
Global MY%
Global MXDiff%
Global MYDiff%

;PREMADE FONTS IMAGES MESHES TEXTURES SKELETONS ANIMATIONS SOUNDS
Global Arial15Font = LoadFont("Arial",15,False,False,False)

Global TestImage = CreateImage(100,100)
SetBuffer(ImageBuffer(TestImage))
ClsColor(250,250,250)
Cls()
Color(255,000,000)
Plot(0,0)
Color(000,255,000)
Plot(100-1,0)
Color(000,000,255)
Plot(0,100-1)
Color(255,255,000)
Plot(100-1,100-1)

Global TestMesh = CreateMesh()
Surface = CreateSurface(TestMesh)
AddVertex(Surface, 0.0, 0.0, 1.0, Float(0)/128, Float(0)/128)
AddVertex(Surface, 1.0, 0.0, 1.0, Float(100)/128, Float(0)/128)
AddVertex(Surface, 0.0, 0.0, 0.0, Float(0)/128, Float(100)/128)
AddVertex(Surface, 1.0, 0.0, 0.0, Float(100)/128, Float(100)/128)
AddTriangle(Surface,0,1,2)
AddTriangle(Surface,2,1,3)
UpdateNormals(TestMesh)

Global TestTexture = CreateTexture(128,128)
SetBuffer(TextureBuffer(TestTexture))
ClsColor(125,125,125)
Cls()
Color(255,000,000)
Plot(0,0)
Color(000,255,000)
Plot(100-1,0)
Color(000,000,255)
Plot(0,100-1)
Color(255,255,000)
Plot(100-1,100-1)
TextureBlend(TestTexture,1)

EntityTexture(TestMesh,TestTexture)

;Camera
;SetBuffer(BackBuffer())
Global Camera = CreateCamera()
CameraRange(Camera,0.1,100)
CameraClsColor(Camera,000,000,000)

;Origine
Origine = CreateCube()
ScaleMesh(Origine,0.01/2,0.01/2,0.01/2)
EntityColor(Origine,255,000,255)

;DLight
Global DLight = CreateLight(1)
;LightRange(DLight,1000+100)
LightColor(DLight,225,225,225)
PositionEntity(DLight,50,1000,-1000,True)
RotateEntity(DLight,45,0,0,True)

AmbientLight(030,030,030)

;Ghost
Global GhostRoot
Global GhostRootYaw#
Global GhostEyes
Global GhostEyesPitch#
BuildGhost()

PositionEntity(GhostRoot,0,1.65,-3,True)

Global Timer = CreateTimer(30)

Main()

End()

Function Main()

 Repeat

  MX = MouseX()
  MY = MouseY()

  MXDiff = MouseXSpeed()
  MYDiff = MouseYSpeed()

  UpdateGhost()
  PositionRotateEntityLikeOtherEntity(Camera,GhostEyes) 	   

  Wireframe(False)
  If( KeyDown(2)=1 )
   Wireframe(True)
  EndIf

  SetBuffer(BackBuffer())
  RenderWorld()

  DrawImage(TestImage,GraphicsWidth()/2-ImageWidth(TestImage)/2,0)

  SetFont(Arial15Font)
  Color(255,255,255)
  CText("Hello world !",0,0)

  WaitTimer(Timer)
  VWait():Flip(False)

 Until( KeyDown(1)=1 )

End Function

Function CText(TextStr$,PX%,PY%)
 Text(PX,PY,TextStr,False,False)
End Function

Function PositionEntityLikeOtherEntity(Entity,OEntity)
 PositionEntity(Entity,EntityX(OEntity,True),EntityY(OEntity,True),EntityZ(OEntity,True),True)
End Function

Function RotateEntityLikeOtherEntity(Entity,OEntity)
 RotateEntity(Entity,EntityPitch(OEntity,True),EntityYaw(OEntity,True),EntityRoll(OEntity,True),True)
End Function

Function PositionRotateEntityLikeOtherEntity(Entity,OEntity)
 PositionEntity(Entity,EntityX(OEntity,True),EntityY(OEntity,True),EntityZ(OEntity,True),True)
 RotateEntity(Entity,EntityPitch(OEntity,True),EntityYaw(OEntity,True),EntityRoll(OEntity,True),True)
End Function

Function BuildGhost()
 
 GhostRoot = CreatePivot()

 GhostEyes = CreatePivot()
 PositionRotateEntityLikeOtherEntity(GhostEyes,GhostRoot)
 EntityParent(GhostEyes,GhostRoot,True)

End Function

Function InitializeGhost()
 PositionEntity(GhostRoot,0,0,-3,True)
End Function

Function UpdateGhost()

 MoveMouse(GraphicsWidth()/2,GraphicsHeight()/2)
 GhostRootYaw = GhostRootYaw - Float(MXDiff)/10
 RotateEntity(GhostRoot,0,GhostRootYaw,0,False)
 GhostEyesPitch = GhostEyesPitch + Float(MYDiff)/10
 If( GhostEyesPitch < -89 )
  GhostEyesPitch = -89
 Else If( GhostEyesPitch > 89 )
  GhostEyesPitch = 89
 EndIf
 RotateEntity(GhostEyes,GhostEyesPitch,0,0,False)

 If( KeyDown(42) = 0 And KeyDown(29) = 0 )
  Speed# = 0.1
 Else If( KeyDown(42) = 1 And KeyDown(29) = 0 )
  Speed# = 1
 Else If( KeyDown(42) = 0 And KeyDown(29) = 1 )
  Speed# = 0.01
 EndIf

 If( KeyDown(17)=1 Or MouseDown(1)=1 )
  MoveEntity(GhostRoot,0,0,Speed)
 Else If( KeyDown(31)=1 Or MouseDown(2)=1 )
  MoveEntity(GhostRoot,0,0,-Speed)
 EndIf
 If( KeyDown(30)=1 )
  MoveEntity(GhostRoot,-Speed,0,0)
 Else If( KeyDown(32)=1 )
  MoveEntity(GhostRoot,Speed,0,0)
 EndIf
 If( KeyDown(16)=1 )
  MoveEntity(GhostRoot,0,-Speed,0)
 Else If( KeyDown(18)=1 )
  MoveEntity(GhostRoot,0,Speed,0)
 EndIf

End Function

This bug or undocumented functionality has made me gave up a code in the past because i had not managed to determine the source of the problem, but this time i have found the source of the problem ! It can happen if you create some images/textures procedurally before creating the camera ! (in my case i created a reticle image of 2x2 pixels so it was impossible to see that the camera rendered the 3dscene on this image !)

To fix/prevent the problem : use setbuffer(backbuffer()) before createcamera(), then use setbuffer(backbuffer()) before renderworld() (apparently useless but nonetheless cool).

RemiD

(Posted 2016) [#2]

To be more precise, it seems that the cameraviewport width height are modified by the last set buffer width height, but the camera seems to render on the backbuffer, not on the last set imagebuffer/texturebuffer as i thought...

RemiD

(Posted 2016) [#3]

So the solution is either what i have mentionned previously :

use setbuffer(backbuffer()) before createcamera(), then use setbuffer(backbuffer()) before renderworld()

Or as an alternative, don't use setbuffer(backbuffer()) before createcamera() but use CameraViewport(Camera,0,0,GraphicsWidth(),GraphicsHeight()) after having created the camera, then use setbuffer(backbuffer()) before renderworld().

(setbuffer(backbuffer()) before renderworld() is to be able to draw images and textes on the backbuffer after the 3dscene has been rendered on the backbuffer...)

Floyd

(Posted 2016) [#4]

As far as I know RenderWorld can only draw to the back buffer.

After SetBuffer FrontBuffer() it appears to draw to the front buffer, but this is being faked. It is still rendering to the back buffer, which is then copied to the front buffer.

SetBuffer can be used with Back,Front,Image,Texture buffers. This will change the buffer used for 2D commands.
In fact, you will notice that the documentation page is located at Blitz3D Docs -> 2D etc.

It looks like the description of SetBuffer() was simply copied from the old 2D Blitz Basic docs.

EDIT: I just thought to check the docs for TextureBuffer() http://www.blitzbasic.com/b3ddocs/command.php?name=TextureBuffer&ref=3d_a-z
It does mention that rendering is always to the back buffer.

Graphics3D 800, 600, 0, 2  ; renders to back buffer
AmbientLight 255, 255, 255

cam = CreateCamera()
PositionEntity cam, 0, 0, -2

sph = CreateSphere()
tex = CreateTexture( 512, 512 )
EntityTexture sph, tex

; Some random dots.

SetBuffer TextureBuffer( tex )
For n = 1 To 5000
	WritePixel Rand(511), Rand(511), Rand(16777215)
Next

; At this point the graphics buffer is still the texture buffer.
; But RenderWorld draws to the back buffer, as always.

Repeat
	TurnEntity sph, 0, 0.1, 0
	RenderWorld
	Flip
Until KeyDown(1)

RemiD

(Posted 2016) [#5]

Yes, my conclusions in post#1 were wrong, but what i have posted in post#2 post#3 seem correct (the last set buffer before creating a camera, changes the cameraviewport width height, so it seems to be a bug...)

RemiD

(Posted 2016) [#6]

So am i the only one to have noticed this bug ? Strange...

Floyd

(Posted 2016) [#7]

I think I noticed this when Biltz3D was new ( 2001? ) but had forgotten about it.

My programs typically begin with things common to all my 3D projects: set Graphics3D, create and position camera etc.

After that are program specific tasks like loading assets and setting buffers and drawing to them.

I can't remember the last time I created a camera after a SetBuffer(). If I did do that it probably had this form:

SetBuffer ImageBuffer( something )
Operate on the image
SetBuffer BackBuffer()
; continue with program

If a CreateCamera() appears after this the viewport issue never arises.