Libs3D Library ShapesV2: Difference between revisions
wip |
wip |
||
| Line 2: | Line 2: | ||
'''<big> | '''<big>This is Shapes Library V2</big>'''💪 | ||
*dimensions where 1 unit is indeed 1 unit | |||
*normal mapping | |||
*a pyramid shape | |||
== I am ready == | == I am ready == | ||
| Line 12: | Line 15: | ||
* some common 3D shapes (plane, cube, ...) | * some common 3D shapes (plane, cube, ...) | ||
* light and shadows | * light and shadows | ||
* extra | |||
* playground | * playground | ||
| Line 31: | Line 35: | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- we position the view (camera) and set its target | -- we position the view (camera) and set its target | ||
view:lookAt(0. | view:lookAt(0.4*8,0.3*8,0.3*8, 0*8,0*8,-0.1*8) -- (eyex,eyey,eyez, targetx,targety,targetz[, upx,upy,upz]) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 45: | Line 49: | ||
-- we will add 3D shapes and models to a scene | -- we will add 3D shapes and models to a scene | ||
local scene = view:getScene() | local scene = view:getScene() | ||
scene:setAutoSort(true) -- enables depth sorting for the children of a Sprite (from farthest to nearest) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== Our first shape: a Plane == | == Our first shape: a Plane == | ||
We are going to use the Plane shape (helper file '' | We are going to use the Plane shape (helper file ''3DShapesV2.lua''), this will be our ground. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- our first shape, a plane for the ground | -- our first shape, a plane for the ground | ||
local ground = D3. | local ground = D3.PlaneV2.new(1.2*8, 1.2*8) -- (width,depth) | ||
-- a color | -- a color | ||
ground:mapColor( | ground:mapColor(0x55ffff) -- (color,[alpha=1]) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Let's texture our plane, I picked this one: https://polyhaven.com/a/forrest_ground_01, '''Diffuse''', '''1K''', '''JPG''' | Let's texture our plane, I picked this one: https://polyhaven.com/a/forrest_ground_01, '''Diffuse''' + '''Normal (GL)''', '''1K''', '''JPG''' | ||
[[File:3d_plane_polyhaven_forrest_ground.png|480px]] | [[File:3d_plane_polyhaven_forrest_ground.png|480px]] | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- | -- texture (diffuse) and normal map | ||
local tex = Texture.new("textures/forrest_ground_01_diff_1k.jpg", nil, { wrap=Texture.REPEAT, } ) | local tex = Texture.new("textures/forrest_ground_01_diff_1k.jpg", nil, { wrap=Texture.REPEAT, } ) | ||
local texsx, texsy = 0. | local normal = Texture.new("textures/forrest_ground_01_nor_gl_1k.jpg", nil, { wrap=Texture.REPEAT, } ) | ||
ground:mapTexture(tex, texsx, texsy | local texsx, texsy = 0.09*8, 0.09*8 -- texture scaling | ||
ground:mapTexture(tex, texsx, texsy, normal) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 80: | Line 86: | ||
== More shapes == | == More shapes == | ||
The Mesh3D class (''3DShapes.lua'') has other shapes you can use: '''D3. | The Mesh3D class (''3DShapes.lua'') has other shapes you can use: '''D3.CubeV2''', '''D3.SphereV2''', '''D3.CylinderV2''', '''D3.PyramidV2'''. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- more shapes | -- more shapes | ||
local cube = D3. | local cube = D3.CubeV2.new(0.1*8, 0.2*8, 0.1*8) -- (w,h,d) | ||
cube:mapColor( | cube:mapColor(0xffff00) -- (color,[alpha=1]) | ||
texsx, texsy = 0. | texsx, texsy = 0.007*8, 0.007*8 -- texture scaling | ||
cube:mapTexture(tex, texsx, texsy | cube:mapTexture(tex, texsx, texsy, normal) | ||
cube:setPosition(-0. | cube:setPosition(-0.1*8, cube.dims.h/2, 0.0*8) | ||
cube:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW) | cube:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW) | ||
scene:addChild(cube) | scene:addChild(cube) | ||
local sphere = D3. | local sphere = D3.SphereV2.new(2*8, 0.2*8) -- (steps,diameter) | ||
sphere:mapColor(0x55ff00) -- (color,[alpha=1]) | sphere:mapColor(0x55ff00) -- (color,[alpha=1]) | ||
texsx, texsy = 0.01*8, 0.01*8 -- texture scaling | texsx, texsy = 0.01*8, 0.01*8 -- texture scaling | ||
sphere:mapTexture(tex, texsx, texsy) | sphere:mapTexture(tex, texsx, texsy, normal) | ||
sphere:setPosition(0. | sphere:setPosition(-0.3*8, sphere.dims.r, 0.0*8) | ||
sphere:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW) | sphere:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW) | ||
scene:addChild(sphere) | scene:addChild(sphere) | ||
local cylinder = D3. | local cylinder = D3.CylinderV2.new(2*8, 0.2*8, 0.2*8) -- (steps,diameter,height) | ||
cylinder:mapColor(0xffaa00) -- (color,[alpha=1]) | cylinder:mapColor(0xffaa00) -- (color,[alpha=1]) | ||
texsx, texsy = 0. | texsx, texsy = 0.025*8, 0.025*8 -- texture scaling | ||
cylinder:mapTexture(tex, texsx, texsy) | cylinder:mapTexture(tex, texsx, texsy, normal) | ||
cylinder:setPosition(0. | cylinder:setPosition(0.1*8, cylinder.dims.h/2, 0.0*8) | ||
cylinder:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW) | cylinder:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW) | ||
scene:addChild(cylinder) | scene:addChild(cylinder) | ||
local pyramid = D3.PyramidV2.new(0.15*8, 0.2*8) -- (diameter,height) | |||
pyramid:mapColor(0xff5500) -- (color,[alpha=1]) | |||
texsx, texsy = 0.01*8, 0.01*8 -- texture scaling | |||
pyramid:mapTexture(tex, texsx, texsy, normal) | |||
pyramid:setPosition(0.3*8, pyramid.dims.h/2, 0.0*8) | |||
pyramid:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW) | |||
scene:addChild(pyramid) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 121: | Line 135: | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- light setup | -- light setup | ||
local lsx, lsy, lsz = 0. | local lsx, lsy, lsz = 0.5*8, 0.55*8, 0.2*8 -- light source position | ||
Lighting.setLight(lsx,lsy,lsz, 0. | Lighting.setLight(lsx,lsy,lsz, 0.3) -- (x,y,z, ambient) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 128: | Line 142: | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
local ltx, lty, ltz = 0.0*8, 0.0*8, 0.0*8 -- light target position | local ltx, lty, ltz = 0.0*8, 0.0*8, 0.0*8 -- light target position | ||
local pd, fov = | local pd, fov = 4*8, 7*8 | ||
Lighting.setLightTarget(ltx,lty,ltz, pd,fov) -- (x,y,z, projection distance,fov) | Lighting.setLightTarget(ltx,lty,ltz, pd,fov) -- (x,y,z, projection distance,fov) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 139: | Line 153: | ||
'''And voilà'''! | '''And voilà'''! | ||
[[File: | [[File:ss_3DShapesV2.png]] | ||
== Playground == | == Playground == | ||
'''The full code''' | '''The full code''' | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== I am out 2 == | == I am out 2 == | ||
You are strongly encouraged to mess with the code. | You are strongly encouraged to mess with the code. | ||
Revision as of 03:25, 2 August 2026
This is Shapes Library V2💪
- dimensions where 1 unit is indeed 1 unit
- normal mapping
- a pyramid shape
I am ready
As we have seen, to make more advanced 3D, Gideros has a bunch of helper files packed in the Library folder.
Here is the plan:
- start with a camera
- a world to populate (scene)
- some common 3D shapes (plane, cube, ...)
- light and shadows
- extra
- playground
Copy the following two Library folders in your project assets folder:
- 3dbase
- luashader
The Camera
The camera is a Viewport with a perspective projection Matrix (helper file 3DView.lua). Let's add one:
application:setBackgroundColor(0x454545)
-- we set up a fullscreen 3D viewport (fov: consoles 60, pc 90)
local sw, sh = application:getContentWidth(), application:getContentHeight()
local view = D3.View.new(sw,sh, 90, 0.1,1*1024) -- (screen w,screen h, fov, near plane,far plane)
You can position the view (camera) and set its target using the Viewport:lookAt function.
-- we position the view (camera) and set its target
view:lookAt(0.4*8,0.3*8,0.3*8, 0*8,0*8,-0.1*8) -- (eyex,eyey,eyez, targetx,targety,targetz[, upx,upy,upz])
In order to display the content of the Viewport (camera) to the screen, we add it to Gideros stage.
-- we add the view (camera) to Gideros stage
stage:addChild(view)
The World (scene)
We will add all our 3D models to a scene. The scene is a simple Sprite and is part of the camera.
-- we will add 3D shapes and models to a scene
local scene = view:getScene()
scene:setAutoSort(true) -- enables depth sorting for the children of a Sprite (from farthest to nearest)
Our first shape: a Plane
We are going to use the Plane shape (helper file 3DShapesV2.lua), this will be our ground.
-- our first shape, a plane for the ground
local ground = D3.PlaneV2.new(1.2*8, 1.2*8) -- (width,depth)
-- a color
ground:mapColor(0x55ffff) -- (color,[alpha=1])
Let's texture our plane, I picked this one: https://polyhaven.com/a/forrest_ground_01, Diffuse + Normal (GL), 1K, JPG
-- texture (diffuse) and normal map
local tex = Texture.new("textures/forrest_ground_01_diff_1k.jpg", nil, { wrap=Texture.REPEAT, } )
local normal = Texture.new("textures/forrest_ground_01_nor_gl_1k.jpg", nil, { wrap=Texture.REPEAT, } )
local texsx, texsy = 0.09*8, 0.09*8 -- texture scaling
ground:mapTexture(tex, texsx, texsy, normal)
We tell the shape to receive light and shadows.
-- we tell the shape to receive light and shadows
ground:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW)
And we add the ground to the world (scene).
-- we add the shape to the scene (world)
scene:addChild(ground)
More shapes
The Mesh3D class (3DShapes.lua) has other shapes you can use: D3.CubeV2, D3.SphereV2, D3.CylinderV2, D3.PyramidV2.
-- more shapes
local cube = D3.CubeV2.new(0.1*8, 0.2*8, 0.1*8) -- (w,h,d)
cube:mapColor(0xffff00) -- (color,[alpha=1])
texsx, texsy = 0.007*8, 0.007*8 -- texture scaling
cube:mapTexture(tex, texsx, texsy, normal)
cube:setPosition(-0.1*8, cube.dims.h/2, 0.0*8)
cube:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW)
scene:addChild(cube)
local sphere = D3.SphereV2.new(2*8, 0.2*8) -- (steps,diameter)
sphere:mapColor(0x55ff00) -- (color,[alpha=1])
texsx, texsy = 0.01*8, 0.01*8 -- texture scaling
sphere:mapTexture(tex, texsx, texsy, normal)
sphere:setPosition(-0.3*8, sphere.dims.r, 0.0*8)
sphere:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW)
scene:addChild(sphere)
local cylinder = D3.CylinderV2.new(2*8, 0.2*8, 0.2*8) -- (steps,diameter,height)
cylinder:mapColor(0xffaa00) -- (color,[alpha=1])
texsx, texsy = 0.025*8, 0.025*8 -- texture scaling
cylinder:mapTexture(tex, texsx, texsy, normal)
cylinder:setPosition(0.1*8, cylinder.dims.h/2, 0.0*8)
cylinder:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW)
scene:addChild(cylinder)
local pyramid = D3.PyramidV2.new(0.15*8, 0.2*8) -- (diameter,height)
pyramid:mapColor(0xff5500) -- (color,[alpha=1])
texsx, texsy = 0.01*8, 0.01*8 -- texture scaling
pyramid:mapTexture(tex, texsx, texsy, normal)
pyramid:setPosition(0.3*8, pyramid.dims.h/2, 0.0*8)
pyramid:updateMode(D3.Mesh.MODE_LIGHTING + D3.Mesh.MODE_SHADOW)
scene:addChild(pyramid)
Lighting
The final touch is lighting (3DLighting.lua).
About lighting:
- Lighting.setLight(x,y,z,a) sets the position of the light source (spotlight) and the amount of ambient light
- Lighting.setLightTarget(x,y,z,d,f) sets the target of the light source. x,y,z is the position where the light is pointing at, d determines the projection distance when computing shadows (d gives the far plane, and the near plane is computed as d/16 internally). f is the FoV angle (actually the half angle), it determines the opening of your spotlight cone, and has a consequence on the shadow precision
- Only objects between d and d/16 in the light cone will cast shadows
- Select d wisely as it has an impact on shadow precision
- the lib uses a 1024x1024 shadow map
The light source position and ambient light.
-- light setup
local lsx, lsy, lsz = 0.5*8, 0.55*8, 0.2*8 -- light source position
Lighting.setLight(lsx,lsy,lsz, 0.3) -- (x,y,z, ambient)
The light target has a position and a projection distance plus a field of view (fov) angle.
local ltx, lty, ltz = 0.0*8, 0.0*8, 0.0*8 -- light target position
local pd, fov = 4*8, 7*8
Lighting.setLightTarget(ltx,lty,ltz, pd,fov) -- (x,y,z, projection distance,fov)
When we added the shapes to the world, we gave the shapes the ability to receive light and shadows: D3.Mesh.MODE_LIGHTING, D3.Mesh.MODE_SHADOW. We need to compute the shadow map.
Lighting.computeShadows(scene)
And voilà!
Playground
The full code
I am out 2
You are strongly encouraged to mess with the code.
Bye for now!
