Differences

This shows you the differences between two versions of the page.

--- gamedev:ieslightprofiles [2020/10/27 00:05] – dragonlord
+++ gamedev:ieslightprofiles [2020/11/24 09:57] (current) – [IES Image Module] dragonlord
@@ Line 16: / Line 16: @@
 If you want to access profile data in game scripts you have to reverse the gamma by using "pow(pixel, 2.2)".
+</WRAP>
+<WRAP center 100%>
+<WRAP center box 450px>
+{{youtube>LGBZLfGvm6M?medium}}
+<WRAP centeralign>IES file handling</WRAP>
+</WRAP>
 </WRAP>
@@ Line 26: / Line 33: @@
   <texture name='material'>
     <image property='color.omnidir.equirect'>/shareddata/materials/light/profiles/display.ies</image>
+    <color property='omnidir.rotate.spot' r='0.25'/>
   </texture>
 </skin>
@@ Line 32: / Line 40: @@
 The path to the IES file can be relative (to the directory the *.deskin is located in) or absolute. Using relative path makes skins easy to move between directories or game projects. The name of the texture is not important. Lights always use the first texture defined in a skin file.
-If you want to use IES profiles for spot and projector type light sources you have to rotate the image first. This is required because IES profiles typically have the image shining down the Y-Axis. Spot and projector type light sources on the other hand shine along the Z-Axis. The image has to be rotated by 90° around the X-Axis to line them up. This example modifies the skin from above to work with spot lights. The [[gamedev:textureproperties:omnidir_rotate|omnidir.rotate]] expects values in the range from 0 (0°) to 1 (360°). Hence 0.25 represents a 90° rotation.
+If you want to use IES profiles for spot and projector type light sources you have to rotate the image first. This is required because IES profiles typically have the image shining down the Y-Axis. Spot and projector type light sources on the other hand shine along the Z-Axis. The image has to be rotated by 90° around the X-Axis to line them up. This example above contains such a rotation using [[gamedev:textureproperties:omnidir_rotate_spot|omnidir.rotate.spot]]. The texture property expects values in the range from 0 (0°) to 1 (360°). Hence 0.25 represents a 90° rotation. The components map to axes like this: red -> X-Axis, green -> Y-Axis, blue -> Z-Axis. Not set components are 0 hence no rotation.
-<code xml><?xml version="1.0" encoding="ISO-8859-1"?>
-<skin>
-  <texture name='material'>
-    <image property='color.omnidir.equirect'>/shareddata/materials/light/profiles/display.ies</image>
-    <color property='omnidir.rotate' r='0.25'/>
-  </texture>
-</skin>
-</code>
-Using this modified light skin on point type light sources is not going to work since the rotation would make the light shine now along the Z-Axis which is most likely not what you want to achieve. Hence if you want to use a an IES profile on both point and spot or projector type light sources you have to create two individual skin files.
+As note there exist two rotation properties: [[gamedev:textureproperties:omnidir_rotate|omnidir.rotate]] and [[gamedev:textureproperties:omnidir_rotate_spot|omnidir.rotate.spot]]. The difference is that [[gamedev:textureproperties:omnidir_rotate|omnidir.rotate]] applies to all light sources including point lights whereas [[gamedev:textureproperties:omnidir_rotate_spot|omnidir.rotate.spot]] applies only to spot and projector type light resources. Using this property allows to create light skins which are compatible for all light sources.
 ====== Drag[en]gine IES Pack ======
-The Drag[en]gine ships with a pack of 30 IES profiles ready to be used in your project. This pack is guaranteed to exist on all game engine installation. You do not need to copy them to your project. The IES images can be found at the path <wrap hi>/shareddata/materials/light/profiles</wrap> with their respective skin files found at path <wrap hi>/shareddata/materials/light</wrap>. This is an overview of the included profiles (click for larger image):
+The Drag[en]gine ships with a pack of 30 IES profiles ready to be used in your project. This pack is guaranteed to exist on all game engine installation (as shared DragonScript Module files). You do not need to copy them to your project. The IES images can be found at the in-game path <wrap hi>/shareddata/materials/light/profiles</wrap> with their respective skin files found at in-game path <wrap hi>/shareddata/materials/light</wrap>. This is an overview of the included profiles (click for larger image):
 {{gallery> :gamedev:iesprofiles?0&200x200&lightbox&showname&titlesort }}

Drag[en]gine Wiki

User Tools

Site Tools

Differences

Page Tools