SpotLight
SpotLight is a light source that illuminates geometry within a conical beam. Light illuminates all geometry and is normally scoped to illuminate peers and children nodes within the scene graph hierarchy Lights have no visible shape themselves and shine through occluding geometry.
The SpotLight node belongs to the Lighting component and its container field is children. It is available since X3D version 3.0 or later.
Fields
SFNode [in, out] metadata NULL [X3DMetadataObject]
Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
SFBool [in, out] global TRUE
Global lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
SFBool [in, out] on TRUE
Enables/disables this light source.
SFColor [in, out] color 1 1 1 [0,1]
Color of light, applied to colors of objects.
See Also
SFFloat [in, out] intensity 1 [0,1]
Brightness of direct emission from the light.
SFFloat [in, out] ambientIntensity [0,1]
Brightness of ambient (nondirectional background) emission from the light.
SFVec3f [in, out] attenuation 1 0 0 [0,∞)
Constant, linear-distance and squared-distance dropoff factors.
SFVec3f [in, out] location 0 0 0 (-∞,∞)
Position of light relative to local coordinate system.
SFVec3f [in, out] direction 0 0 -1 (-∞,∞)
Orientation vector of light relative to local coordinate system.
SFFloat [in, out] radius 100 [0,∞)
Maximum effective distance of light relative to local light position, affected by ancestor scaling.
SFFloat [in, out] beamWidth 0.7854 (0,π/2]
Inner conical solid angle (in radians) where light source has uniform full intensity.
Hint
BeamWidth is inner angle of full intensity, cutOffAngle is outer angle of zero intensity. Therefore set beamWidth <= cutOffAngle.
Warning
If beamWidth > cutOffAngle, then beamWidth reset to equal cutOffAngle.
SFFloat [in, out] cutOffAngle 1.5708 (0,π/2]
Outer conical solid angle (in radians) where light source intensity becomes zero.
Hint
BeamWidth is inner angle of full intensity, cutOffAngle is outer angle of zero intensity. Therefore set beamWidth <= cutOffAngle.
Warning
If beamWidth > cutOffAngle, then beamWidth reset to equal cutOffAngle.
SFColor [in, out] shadowColor 0 0 0 [0,1]
Color of shadow, applied to colors of objects.
See Also
SFFloat [in, out] shadowIntensity 0 [0,1]
Intensity of shadow.
SFFloat [in, out] shadowBias 0.005 [0,1]
The shadowBias value controls the visibility of shadow acne.
SFInt32 [ ] shadowMapSize 1024 [0,∞)
Size of the shadow map in pixels, must be power of two.
Example
XML Encoding
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 |
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE X3D PUBLIC "ISO//Web3D//DTD X3D 3.3//EN" "http://www.web3d.org/specifications/x3d-3.3.dtd"> <X3D profile='Full' version='3.3' xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='http://www.web3d.org/specifications/x3d-3.3.xsd'> <head> <meta name='comment' content='World of Titania'/> <meta name='created' content='Mon, 05 Feb 2018 07:19:25 GMT'/> <meta name='created' content='Sat, 10 Feb 2018 02:42:59 GMT'/> <meta name='creator' content='Holger Seelig'/> <meta name='creator' content='Holger Seelig'/> <meta name='generator' content='Titania V4.3.0, http://titania.create3000.de'/> <meta name='identifier' content='file:///home/holger/Schreibtisch/SpotLight/SpotLight.O.x3d'/> <meta name='modified' content='Mon, 04 Jun 2018 10:54:48 GMT'/> </head> <Scene> <WorldInfo title='scene' info='"version: 2.0", "generator: Sketchfab-3.19.3"'/> <NavigationInfo type='"EXAMINE"' headlight='false'/> <Viewpoint description='Initial View' position='0.949704 2.95092 2.749' orientation='-0.847972220594469 0.505991626676289 0.157846719426057 0.705034434450008' centerOfRotation='-0.012644 1.74348 -0.0051609'/> <Transform DEF='Lights'> <SpotLight color='1 0.973554 0.857401' ambientIntensity='0.53202' attenuation='1 0.05 0' location='2 3 0' direction='-0.800235 -0.458164 -0.386923' beamWidth='0.262209' cutOffAngle='0.58252' shadowIntensity='1'/> <SpotLight color='1 0.963875 0.839015' attenuation='1 0.04 0' location='-1 3 2' direction='0.223661 -0.225644 -0.948188' beamWidth='0.368243' cutOffAngle='0.678938' shadowIntensity='1'/> </Transform> <Inline DEF='Models' url='"models.x3d", "file:///home/holger/Schreibtisch/SpotLight/models.x3d"'/> </Scene> </X3D> |
Classic Encoding
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 |
#X3D V3.3 utf8 Titania V4.3.0 PROFILE Full META "comment" "World of Titania" META "created" "Mon, 05 Feb 2018 07:19:25 GMT" META "created" "Sat, 10 Feb 2018 02:42:59 GMT" META "creator" "Holger Seelig" META "creator" "Holger Seelig" META "generator" "Titania V4.3.0, http://titania.create3000.de" META "identifier" "file:///home/holger/Schreibtisch/SpotLight/SpotLight.O.x3d" META "modified" "Mon, 04 Jun 2018 10:54:48 GMT" WorldInfo { title "scene" info [ "version: 2.0", "generator: Sketchfab-3.19.3" ] } NavigationInfo { type "EXAMINE" headlight FALSE } Viewpoint { description "Initial View" position 0.949704 2.95092 2.749 orientation -0.847972220594469 0.505991626676289 0.157846719426057 0.705034434450008 centerOfRotation -0.012644 1.74348 -0.0051609 } DEF Lights Transform { children [ SpotLight { color 1 0.973554 0.857401 ambientIntensity 0.53202 attenuation 1 0.05 0 location 2 3 0 direction -0.800235 -0.458164 -0.386923 beamWidth 0.262209 cutOffAngle 0.58252 shadowIntensity 1 } SpotLight { color 1 0.963875 0.839015 attenuation 1 0.04 0 location -1 3 2 direction 0.223661 -0.225644 -0.948188 beamWidth 0.368243 cutOffAngle 0.678938 shadowIntensity 1 } ] } DEF Models Inline { url [ "models.x3d", "file:///home/holger/Schreibtisch/SpotLight/models.x3d" ] } |
JSON Encoding
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 |
{ "X3D": { "encoding": "UTF-8", "@profile": "Full", "@version": "3.3", "@xsd:noNamespaceSchemaLocation": "http://www.web3d.org/specifications/x3d-3.3.xsd", "JSON schema": "http://www.web3d.org/specifications/x3d-3.3-JSONSchema.json", "head": { "meta": [ { "@name": "comment", "@content": "World of Titania" }, { "@name": "created", "@content": "Mon, 05 Feb 2018 07:19:25 GMT" }, { "@name": "created", "@content": "Sat, 10 Feb 2018 02:42:59 GMT" }, { "@name": "creator", "@content": "Holger Seelig" }, { "@name": "creator", "@content": "Holger Seelig" }, { "@name": "generator", "@content": "Titania V4.3.0, http://titania.create3000.de" }, { "@name": "identifier", "@content": "file:///home/holger/Schreibtisch/SpotLight/SpotLight.O.x3d" }, { "@name": "modified", "@content": "Mon, 04 Jun 2018 10:54:48 GMT" } ] }, "Scene": { "-children": [ { "WorldInfo": { "@title": "scene", "@info": [ "version: 2.0", "generator: Sketchfab-3.19.3" ] } }, { "NavigationInfo": { "@type": [ "EXAMINE" ], "@headlight": false } }, { "Viewpoint": { "@description": "Initial View", "@position": [ 0.949704, 2.95092, 2.749 ], "@orientation": [ -0.847972220594469, 0.505991626676289, 0.157846719426057, 0.705034434450008 ], "@centerOfRotation": [ -0.012644, 1.74348, -0.0051609 ] } }, { "Transform": { "@DEF": "Lights", "-children": [ { "SpotLight": { "@color": [ 1, 0.973554, 0.857401 ], "@ambientIntensity": 0.53202, "@attenuation": [ 1, 0.05, 0 ], "@location": [ 2, 3, 0 ], "@direction": [ -0.800235, -0.458164, -0.386923 ], "@beamWidth": 0.262209, "@cutOffAngle": 0.58252, "@shadowIntensity": 1 } }, { "SpotLight": { "@color": [ 1, 0.963875, 0.839015 ], "@attenuation": [ 1, 0.04, 0 ], "@location": [ -1, 3, 2 ], "@direction": [ 0.223661, -0.225644, -0.948188 ], "@beamWidth": 0.368243, "@cutOffAngle": 0.678938, "@shadowIntensity": 1 } } ] } }, { "Inline": { "@DEF": "Models", "@url": [ "models.x3d", "file:///home/holger/Schreibtisch/SpotLight/models.x3d" ] } } ] } } } |
Titania
X_ITE