From 783fa49d80819c1317badac3ccf42256dcd7744a Mon Sep 17 00:00:00 2001 From: Alaska Date: Thu, 6 Jun 2024 17:22:41 +1200 Subject: [PATCH 1/4] Add example images for Ray Portal BSDF --- ...-nodes_ray-portal-bsdf_gateway-example.jpg | 3 ++ ...y-portal-bsdf_portal-to-screen-example.jpg | 3 ++ ...ray-portal-bsdf_portal-to-screen-nodes.jpg | 3 ++ ...ray-portal-bsdf_ray-augmentation-nodes.jpg | 3 ++ ...ay-portal-bsdf_simple-ray-offset-nodes.jpg | 3 ++ .../render/shader_nodes/shader/ray_portal.rst | 46 +++++++++++++++++++ 6 files changed, 61 insertions(+) create mode 100755 manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg create mode 100755 manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg create mode 100755 manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg create mode 100755 manual/images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg create mode 100755 manual/images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg new file mode 100755 index 000000000..e62b92a1c --- /dev/null +++ b/manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:2c4387dedb543f4f1d1cb5f2c0b24ecc1caa9fe3ff2edccef88a531ae0bc2e7a +size 473655 diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg new file mode 100755 index 000000000..35e07d47e --- /dev/null +++ b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:309dce4b69127a48e3d43899d9ffe31017011d8a5be91a0fbd464e401b8d5af5 +size 354353 diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg new file mode 100755 index 000000000..f662390fa --- /dev/null +++ b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e2ce2bea8464ccb65bdc06a68f8d443e8793d958b53e1bc553cee565e744bd04 +size 125202 diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg new file mode 100755 index 000000000..aa93c8798 --- /dev/null +++ b/manual/images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:81782312cfa7eb1821b1aa3e4f3060d95333ef07b138141c562ae066aba31ffb +size 131699 diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg new file mode 100755 index 000000000..a2ab3c8ca --- /dev/null +++ b/manual/images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:571bb66a8461ab3d25d028146c60afa20bf56a242b2b0121846b6130413648fb +size 34519 diff --git a/manual/render/shader_nodes/shader/ray_portal.rst b/manual/render/shader_nodes/shader/ray_portal.rst index 21a79bfc4..cd96aaafb 100644 --- a/manual/render/shader_nodes/shader/ray_portal.rst +++ b/manual/render/shader_nodes/shader/ray_portal.rst @@ -50,3 +50,49 @@ Outputs BSDF Standard shader output. + +Examples +======== + +One use case for the *Ray Portal BSDF* is to connect two spaces together to +create effects like a portal to an alternative dimension, or "impossible spaces" +where something is bigger or smaller on the inside than expected. + +.. figure:: /images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg + :width: 760px + +To setup a *Ray Portal BSDF* for a technique like this, you should argument the +*Position* and *Incoming* outputs of the +:doc:`Geometry node ` to set the exit point +and direction of the ray through the portal. Here is an example node setup: + +.. list-table:: + + * - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg + :width: 320px + + This simple node setup is used for offsetting the ray position. + In this example, the ray 0 units along the X axis, 4 units along + the Y axis, and 5 units along the Z axis. + + - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg + :width: 320px + + In this example, the *Location of Portal Target* and *Rotation of Portal Target* + vectors are obtained from a target portal object using + :doc:`Drivers`. + +Along with augmenting rays, the ray position and ray direction can be replaced, +allowing the creation of effects like a camera feed on a screen. + +.. list-table:: + + * - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg + :width: 320px + + Using Ray Portal BSDF to replicate the effect of a camera feed on a screen. + + - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg + :width: 320px + + Node setup for replicating a camera feed like effect on a screen. -- 2.30.2 From f56fd48c8b76bd346627c32913ad8c6e0ea62409 Mon Sep 17 00:00:00 2001 From: Alaska Date: Thu, 6 Jun 2024 17:52:35 +1200 Subject: [PATCH 2/4] Shift camera closer to TV in example --- ..._shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg index 35e07d47e..18ef0e2f8 100755 --- a/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg +++ b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:309dce4b69127a48e3d43899d9ffe31017011d8a5be91a0fbd464e401b8d5af5 -size 354353 +oid sha256:273f8d51a6b0c43d03f2ac24bbab43d4d1eb123fe7e3cf677671e28f22228eaa +size 383472 -- 2.30.2 From d54c71e3ea8b3e042f4dd288665ebcec22e848d2 Mon Sep 17 00:00:00 2001 From: Alaska Date: Thu, 6 Jun 2024 23:54:20 +1200 Subject: [PATCH 3/4] Address Brecht's spelling and grammar review --- manual/render/shader_nodes/shader/ray_portal.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/manual/render/shader_nodes/shader/ray_portal.rst b/manual/render/shader_nodes/shader/ray_portal.rst index cd96aaafb..2a1c05186 100644 --- a/manual/render/shader_nodes/shader/ray_portal.rst +++ b/manual/render/shader_nodes/shader/ray_portal.rst @@ -61,7 +61,7 @@ where something is bigger or smaller on the inside than expected. .. figure:: /images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg :width: 760px -To setup a *Ray Portal BSDF* for a technique like this, you should argument the +To set up a *Ray Portal BSDF* for a technique like this, augment the *Position* and *Incoming* outputs of the :doc:`Geometry node ` to set the exit point and direction of the ray through the portal. Here is an example node setup: @@ -71,26 +71,26 @@ and direction of the ray through the portal. Here is an example node setup: * - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg :width: 320px - This simple node setup is used for offsetting the ray position. - In this example, the ray 0 units along the X axis, 4 units along - the Y axis, and 5 units along the Z axis. + This simple node setup offsets the ray position. + In this example, the ray is offset 0 units along the X axis, + 4 units along the Y axis, and 5 units along the Z axis. - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg :width: 320px In this example, the *Location of Portal Target* and *Rotation of Portal Target* vectors are obtained from a target portal object using - :doc:`Drivers`. + :doc:`Drivers `. Along with augmenting rays, the ray position and ray direction can be replaced, -allowing the creation of effects like a camera feed on a screen. +For effects like a camera feed on a screen. .. list-table:: * - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg :width: 320px - Using Ray Portal BSDF to replicate the effect of a camera feed on a screen. + Using the Ray Portal BSDF to replicate the effect of a camera feed on a screen. - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg :width: 320px -- 2.30.2 From d80b9a1218f45a9a2b4d3017f163117d7dd5774c Mon Sep 17 00:00:00 2001 From: Alaska Date: Fri, 7 Jun 2024 00:35:43 +1200 Subject: [PATCH 4/4] Adjust images Reduce the visibility of logo on TV example Change sun and camera position in portal example --- ...-nodes_ray-portal-bsdf_gateway-example.jpg | 4 +- ...y-portal-bsdf_portal-to-screen-example.jpg | 4 +- .../render/shader_nodes/shader/ray_portal.rst | 49 ++++++++++--------- 3 files changed, 29 insertions(+), 28 deletions(-) diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg index e62b92a1c..ae24b6405 100755 --- a/manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg +++ b/manual/images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:2c4387dedb543f4f1d1cb5f2c0b24ecc1caa9fe3ff2edccef88a531ae0bc2e7a -size 473655 +oid sha256:67524d9c69328441d4f8df9994c758e4b518abcf142c3158ac4d488066601cbb +size 630290 diff --git a/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg index 18ef0e2f8..5f6dff077 100755 --- a/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg +++ b/manual/images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:273f8d51a6b0c43d03f2ac24bbab43d4d1eb123fe7e3cf677671e28f22228eaa -size 383472 +oid sha256:62c6fb818a12320ce36574ab96e055f3c79962d2f91c4bd7bfba5509ed12fb3b +size 395976 diff --git a/manual/render/shader_nodes/shader/ray_portal.rst b/manual/render/shader_nodes/shader/ray_portal.rst index 2a1c05186..5c094ae6c 100644 --- a/manual/render/shader_nodes/shader/ray_portal.rst +++ b/manual/render/shader_nodes/shader/ray_portal.rst @@ -58,41 +58,42 @@ One use case for the *Ray Portal BSDF* is to connect two spaces together to create effects like a portal to an alternative dimension, or "impossible spaces" where something is bigger or smaller on the inside than expected. -.. figure:: /images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg - :width: 760px - To set up a *Ray Portal BSDF* for a technique like this, augment the *Position* and *Incoming* outputs of the :doc:`Geometry node ` to set the exit point -and direction of the ray through the portal. Here is an example node setup: +and direction of the ray through the portal. Here are some examples: -.. list-table:: +Simple Offset +------------- - * - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg - :width: 320px +.. figure:: /images/render_shader-nodes_ray-portal-bsdf_simple-ray-offset-nodes.jpg - This simple node setup offsets the ray position. - In this example, the ray is offset 0 units along the X axis, - 4 units along the Y axis, and 5 units along the Z axis. - - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg - :width: 320px + This simple node setup offsets the ray position. + In this example, the ray is offset 0 units along the X axis, + 4 units along the Y axis, and 5 units along the Z axis. - In this example, the *Location of Portal Target* and *Rotation of Portal Target* - vectors are obtained from a target portal object using - :doc:`Drivers `. +Portal +------ + +.. figure:: /images/render_shader-nodes_ray-portal-bsdf_gateway-example.jpg + +.. figure:: /images/render_shader-nodes_ray-portal-bsdf_ray-augmentation-nodes.jpg + + In this example, the *Location of Portal Target* and *Rotation of Portal Target* + vectors are obtained from a target portal object using + :doc:`Drivers `. + +Camera Feed +----------- Along with augmenting rays, the ray position and ray direction can be replaced, -For effects like a camera feed on a screen. +for effects like a camera feed on a screen. -.. list-table:: +.. figure:: /images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg - * - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-example.jpg - :width: 320px + Using the Ray Portal BSDF to replicate the effect of a camera feed on a screen. - Using the Ray Portal BSDF to replicate the effect of a camera feed on a screen. +.. figure:: /images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg - - .. figure:: /images/render_shader-nodes_ray-portal-bsdf_portal-to-screen-nodes.jpg - :width: 320px - - Node setup for replicating a camera feed like effect on a screen. + Node setup for replicating a camera feed like effect on a screen. -- 2.30.2