docs.unity3d.com
  • Manual
  • Scripting API
  • Changelog
  • License
    Show / Hide Table of Contents
    • Visual Effect Graph
    • Requirements
    • What's new
      • 10 / Unity 2020.​2
      • 11 / Unity 2021.​1
    • Getting Started
      • Visual Effect Graph Assets
      • Visual Effect Graph Window
      • Sample Content
    • Graph Logic & Philosophy
      • Systems
      • Contexts
      • Blocks
      • Operators
      • Properties
      • Events
      • Attributes
      • Subgraph
      • Blackboard
      • Sticky Notes
      • Project Settings
      • Preferences
    • The Visual Effect Component
      • C# Component API
      • Using Visual Effects with Timeline
      • Property Binders
      • Event Binders
      • Output Event Handlers
    • Pipeline Tools
      • Representing Complex Shapes
        • Point Caches
          • Point Cache asset
          • Point Cache Bake Tool
      • Exposed​Property Helper
      • Vector Fields
      • Spawner Callbacks
    • Node Library
      • Block
        • Attribute
          • Curve
          • Derived
            • Calculate Mass from Volume
          • Map
          • Set
        • Collision
          • Collide with AABox
          • Collide with Cylinder
          • Collide with Depth Buffer
          • Collide with Plane
          • Collide with Signed Distance Field
          • Collide with Sphere
        • Flipbook
          • Flipbook Player
        • Force
          • Conform to Signed Distance Field
          • Conform to Sphere
          • Force
          • Gravity
          • Linear Drag
          • Turbulence
          • Vector Force Field
        • GPU Event
          • Trigger Event Always
          • Trigger Event On Die
          • Trigger Event Rate
        • Implicit
          • Integration : Update Position
          • Integration : Update Rotation
        • Kill
          • Kill (AABox.​md)
          • Kill (Sphere.​md)
        • Orientation
          • Connect Target
          • Orient
        • Output
          • Camera Fade
          • Subpixel Anti-Aliasing
        • Position
          • Set Position (Depth.​md)
            • Position (Mesh.​md)
            • Position (Signed Distance Field.​md)
            • Position (Skinned Mesh.​md)
            • Set Position (Sequential : Circle.​md)
            • Set Position (Sequential : Line.​md)
            • Set Position (Sequential : Three​Dimensional.​md)
          • Set Position (Shape : AABox.​md)
          • Set Position (Shape : Circle.​md)
          • Set Position (Shape : Cone.​md)
          • Set Position (Shape : Line.​md)
          • Set Position (Shape : Sphere.​md)
          • Set Position (Sequential.​md)
          • Tile/Warp Positions
        • Size
          • Screen Space Size
        • Spawn
          • Constant Spawn Rate
          • Periodic Burst
          • Single Burst
          • Variable Spawn Rate
          • Attribute
            • Set Spawn Event \<attribute>
          • Custom
            • Increment Strip Index On Start
            • Set Spawn Time
            • Spawn Over Distance
        • Velocity
          • Velocity from Direction & Speed (Change Speed.​md)
          • Velocity from Direction & Speed (New Direction.​md)
          • Velocity from Direction & Speed (Random Direction.​md)
          • Velocity from Direction & Speed (Spherical.​md)
          • Velocity from Direction & Speed (Tangent.​md)
      • Context
        • Event
        • GPU Event
        • Initialize Particle
        • Output Mesh
        • Output Distortion
        • Output Decal
        • Output Line
        • Output Particle Mesh
        • Output Point
        • Output Primitive
        • Shared Output Settings
          • Global Settings
          • Lit Output Settings
        • Spawn
        • Update Particle
      • Operator
        • Attribute
          • Age Over Lifetime
          • Get Attribute: age
          • Get Attribute: alive
          • Get Attribute: alpha
          • Get Attribute: angle
          • Get Attribute: angular​Velocity
          • Get Attribute: axis​X
          • Get Attribute: axis​Y
          • Get Attribute: axis​Z
          • Get Attribute: color
          • Get Attribute: direction
          • Get Attribute: lifetime
          • Get Attribute: mass
          • Get Attribute: old​Position
          • Get Attribute: particle​Count​In​Strip
          • Get Attribute: particle​Id
          • Get Attribute: particle​Index​In​Strip
          • Get Attribute: pivot
          • Get Attribute: position
          • Get Attribute: scale
          • Get Attribute: seed
          • Get Attribute: size
          • Get Attribute: spawn​Index
          • Get Attribute: spawn​Time
          • Get Attribute: strip​Index
          • Get Attribute: target​Position
          • Get Attribute: tex​Index
          • Get Attribute: velocity
          • Get Custom Attribute
        • Bitwise
          • And
          • Complement
          • Left Shift
          • Or
          • Right Shift
          • Xor
        • Builtin
          • Delta Time
          • Frame Index
          • Local to World
          • Main Camera
          • System Seed
          • Total Time
          • World to Local
        • Camera
          • Viewport to World Point
          • World to Viewport Point
        • Color
          • Color Luma
          • HSV to RGB
          • RBG to HSV
        • Inline
          • AABox
          • Animation​Curve
          • Arc​Circle
          • Arc​Cone
          • Arc​Sphere
          • Arc​Torus
          • bool
          • Camera
          • Circle
          • Color
          • Cone
          • Cubemap
          • Cubemap​Array
          • Cylinder
          • Direction
          • Flip​Book
          • float
          • Gradient
          • int
          • Line
          • Matrix4x4
          • Mesh
          • Oriented​Box
          • Plane
          • Position
          • Sphere
          • Terrain​Type
          • Texture2D
          • Texture2DArray
          • Texture3D
          • Torus
          • Transform
          • uint
          • Vector
          • Vector2
          • Vector3
          • Vector4
        • Logic
          • And
          • Branch
          • Compare
          • Nand
          • Nor
          • Not
          • Or
          • Probability Sampling
          • Switch
        • Math
          • Arithmetic
            • Absolute
            • Add
            • Divide
            • Fractional
            • Inverse Lerp
            • Lerp
            • Modulo
            • Multiply
            • Negate
            • One Minus
            • Power
            • Reciprocal
            • Sign
            • Smoothstep
            • Square Root
            • Step
            • Subtract
          • Clamp
            • Ceiling
            • Clamp
            • Discretize
            • Floor
            • Maximum
            • Minimum
            • Round
            • Saturate
          • Constants
            • Epsilon
            • Pi
          • Coordinates
            • Polar to Rectangular
            • Rectangular to Polar
            • Rectangular to Spherical
            • Spherical to Rectangular
          • Exp
            • Exp
          • Geometry
            • Area (Circle.​md)
            • Change Space
            • Distance (Line.​md)
            • Distance (Plane.​md)
            • Distance (Sphere.​md)
            • Invert​TRS (Matrix.​md)
            • Transform (Direction.​md)
            • Transform (Matrix.​md)
            • Transform (Position.​md)
            • Transform (Vector.​md)
            • Transform (Vector4.​md)
            • Transpose (Matrix.​md)
            • Volume (Axis Aligned Box.​md)
            • Volume (Cone.​md)
            • Volume (Cylinder.​md)
            • Volume (Oriented Box.​md)
            • Volume (Sphere.​md)
            • Volume (Torus.​md)
          • Log
            • Log
          • Remap
            • Remap
            • Remap [0..​1] => [-1..​1]
            • Remap [-1..​1] => [0..​1]
          • Trigonometry
            • Acos
            • Asin
            • Atan
            • Atan2
            • Cosine
            • Sine
            • Tangent
          • Vector
            • Append Vector
            • Construct Matrix
            • Cross Product
            • Distance
            • Dot Product
            • Length
            • Look At
            • Normalize
            • Rotate 2D
            • Rotate 3D
            • Sample Bezier
            • Squared Distance
            • Squared Length
            • Swizzle
          • Wave
            • Sawtooth Wave
            • Sine Wave
            • Square Wave
            • Triangle Wave
        • Noise
          • Cellular Curl Noise
          • Cellular Noise
          • Perlin Curl Noise
          • Perlin Noise
          • Value Curl Noise
          • Value Noise
        • Random
          • Random Number
        • Sampling
          • Get Texture Dimensions
          • Mesh Index Count
          • Mesh Vertex Count
          • Load Texture2D
          • Load Texture2DArray
          • Load Texture3D
          • Position (Depth.​md)
          • Sample Curve
          • Sample Gradient
          • Sample Mesh
          • Sample Mesh Index
          • Sample Skinned Mesh
          • Sample Skinned Mesh Renderer Index
          • Sample Signed Distance Field
          • Sample Texture2D
          • Sample Texture2DArray
          • Sample Texture3D
          • Sample Texture​Cube
          • Sample Texture​Cube​Array
          • Skinned Mesh Index Count
          • Skinned Mesh Vertex Count
        • Spawn
          • Spawn State
        • Utility
          • Point Cache
    • Reference
      • Standard Attributes
      • Types
        • AABox
        • Arc​Circle
        • Arc​Cone
        • Arc​Sphere
        • Arc​Torus
        • Camera
        • Circle
        • Cone
        • Cylinder
        • Direction
        • Line
        • Oriented​Box
        • Plane
        • Position
        • Sphere
        • Terrain​Type
        • Torus
        • Transform
        • Vector
    • Manual
    • Node Library
    • Operator
    • Sampling
    • Sample Signed Distance Field

    Sample Signed Distance Field

    Menu Path : Operator > Sampling > Sample Signed Distance Field

    The Sample Signed Distance Field Operator allows you to fetch a distance field stored in a Texture3D.

    A Signed Distance Field (SDF) determines the distance from a point in space to the surface of a shape. By convention, this function is negative for points inside of the shape, and positive outside. The SDF is equal to zero on the surface of the object.

    Operator Properties

    Input Type Description
    texture Texture3D The 3D texture that stores the SDF.
    position Position The position to sample the SDF from.
    orientedBox OrientedBox The oriented box that specifies the transformation to apply to the SDF.
    Level float The mipmap level.
    Output Type Description
    distance float The signed distance from the position to the surface the SDF defines. This value is positive when position is outside of the shape and negative when position is inside the shape.
    direction Vector3 The direction that points to the closest point on the surface the SDF defines.

    Additional notes

    You can set the position, orientation, and scale of the SDF using an OrientedBox. The center of the OrientedBox corresponds to the center of the sdf.

    Limitations

    For this Operator to output correct distances in world coordinates, the dimensions (size) of the OrientedBox must match the dimensions of the box you used to bake the SDF. If you do not set this up correctly, distances from inside and outside of the texture bounds have a different scale, which means the output does not exhibit the expected behavior.

    Also, if you apply a non-uniform scale to the sdf (i.e. not proportional to the dimensions of the box you used to bake it), this results in distorted distances.

    In This Article
    • Operator Properties
    • Additional notes
      • Limitations
    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023