Ngôn Ngữ Tô Bóng Mở (Open Shading Language)¶

Open Shading Language (OSL) is a programmable shading system developed for advanced rendering engines. It allows technical artists and developers to write custom shader code using a C-like scripting language.

In Blender, OSL can be used within Cycles to define custom surface, volume, and displacement shaders. This gives users full control over shading behavior, enabling procedural effects, advanced lighting models, and custom geometry-based material logic that may not be possible with built-in shader nodes alone.

Unlike node-based materials, OSL shaders are authored as text scripts using Blender's internal Text Editor or loaded from external .osl or .oso files. These scripts are then compiled and used in the Shader Editor through the Script Node.

Mẹo

OSL is especially useful for generating procedural textures, custom BRDFs, or implementing research prototypes. It also allows sharing shaders across compatible rendering applications that support the OSL standard.

Cách Dùng [Usage]¶

To use Open Shading Language (OSL) in Blender, follow these steps:

Enable OSL Rendering

In the Render Properties enable Open Shading Language.
Add a Script Node

In the Shader Editor add Script Node then in the node's properties:
- Set the Mode to Internal to use a Blender text data-block, or
- Set it to External to load a shader file from disk (either .osl or compiled .oso).
For the internal mode, create a new text data-block in the Text Editor, then write or paste your OSL code there.

Blender will compile the OSL source file automatically. If the source is .osl, it will be compiled into .oso bytecode. Compilation errors will be shown in the system console.
Use Shader Outputs

Once compiled, the node's outputs will reflect the output parameters defined in the OSL code. These outputs can be connected to any part of the material node tree.

Viết các Bộ Tô Bóng (Writing Shaders)¶

For more details on how to write shaders, see the OSL Documentation.

Tại Đây được một đơn giản ví dụ:

shader simple_material(
    color Diffuse_Color = color(0.6, 0.8, 0.6),
    float Noise_Factor = 0.5,
    output closure color BSDF = diffuse(N))
{
    color material_color = Diffuse_Color * mix(1.0, noise(P * 10.0), Noise_Factor);
    BSDF = material_color * diffuse(N);
}

Các Hàm Đóng Kín (Closures)¶

OSL is different from, for example, RSL or GLSL, in that it does not have a light loop. There is no access to lights in the scene, and the material must be built from closures that are implemented in the renderer itself. This is more limited, but also makes it possible for the renderer to do optimizations and ensure all shaders can be importance sampled.

The available closures in Cycles correspond to the shader nodes and their sockets; for more details on what they do and the meaning of the parameters, see the shader nodes manual.

Xem thêm

Documentation on OSL's built-in closures.

Bidirectional Scattering Distribution Function: Hàm Phân Bổ Tán Xạ Hai Chiều¶

diffuse(N)
oren_nayar(N, roughness)
diffuse_ramp(N, colors[8])
phong_ramp(N, exponent, colors[8])
diffuse_toon(N, size, smooth)
glossy_toon(N, size, smooth)
"độ trong mờ"lucent[N])
reflection(N)
refraction(N, ior)
"trong suốt[]"
microfacet_ggx(N, roughness)
microfacet_ggx_aniso(N, T, ax, ay)
microfacet_ggx_refraction(N, roughness, ior)
microfacet_beckmann(N, roughness)
microfacet_beckmann_aniso(N, T, ax, ay)
microfacet_beckmann_refraction(N, roughness, ior)
ashikhmin_shirley(N, T, ax, ay)
ashikhmin_velvet(N, roughness)

Tóc/Lông (Hair)¶

hair_reflection(N, roughnessu, roughnessv, T, offset)
hair_transmission(N, roughnessu, roughnessv, T, offset)
principled_hair(N, absorption, roughness, radial_roughness, coat, offset, IOR)

Bidirectional Scattering Surface Reflectance Distribution Function: Hàm Phân Phối Phản Xạ Bề Mặt Tán Xạ Hai Chiều¶

Được Sử Dụng tới mô phỏng tán xạ dưới bề mặt.

bssrdf(method, N, radius, albedo)¶

Tham số:

method (string) --
Phương pháp kết xuất để mô phỏng tán xạ dưới bề mặt.
- burley: An approximation to physically-based volume scattering. This method is less accurate than random_walk however, in some situations this method will resolve noise faster.
- random_walk_skin: Provides accurate results for thin and curved objects. Random Walk uses true volumetric scattering inside the mesh, which means that it works best for closed meshes. Overlapping faces and holes in the mesh can cause problems.
- random_walk: Behaves similarly to random_walk_skin but modulates the Radius based on the Color, Anisotropy, and IOR. This method thereby attempts to retain greater surface detail and color than random_walk_skin.
N (vector) -- Normal vector of the surface point being shaded.
radius (vector) -- Khoảng cách trung bình mà ánh sáng tán xạ ra dưới bề mặt. Bán kính lớn hơn sẽ cho hiện trạng mềm mại hơn vì ánh sáng xâm nhập vào các vùng tối và đi xuyên qua đối tượng. khoảng cách tán xạ sẽ được xác định riêng biệt cho các kênh RGB, để kết xuất nguyên vật liệu giống như da thịt, cái mà ánh sáng đỏ nguồn phân tán sâu hơn. Các giá trị X, Y và Z được là Ánh Xạ sang các giá trị R, G và B trong cặp đôi tương ứng.
albedo (color) -- Màu sắc của bề mặt, hoặc về vật lý mà nói, ánh sáng được phản xạ trên mỗi bước sóng.

Âm Lượng/Thể Tích (Volume)¶

henyey_greenstein(g)
"độ hấp thụ[]"

Cái Khác (Other)¶

"phát xạ[]"
ambient_occlusion()
"giữ chỗ[]"
"nền sau[]"

Thuộc Tính (Attributes)¶

Geometry attributes can be read through the getattribute() function. This includes UV maps, color attributes and any attributes output from geometry nodes.

The following built-in attributes are available through getattribute() as well.

geom:generated: Automatically generated texture coordinates, from non-deformed mesh.
geom:uv: Default render UV map.
geom:tangent: Default tangent vector along surface, in object space.
geom:undisplaced: Position before displacement, in object space.
geom:dupli_generated: For instances, generated coordinate from instancer object.
geom:dupli_uv: For instances, UV coordinate from instancer object.
geom:trianglevertices: Three vertex coordinates of the triangle.
geom:numpolyvertices: Number of vertices in the polygon (always returns three currently).
geom:polyvertices: Vertex coordinates array of the polygon (always three vertices currently).
geom:name: Name of the object.
geom:is_smooth: Is mesh face smooth or flat shaded.
geom:is_curve: Is object a curve or not.
geom:curve_intercept: 0..1 coordinate for point along the curve, from root to tip.
geom:curve_thickness: Độ Dày của đường cong vào/trong không gian đối tượng.
geom:curve_length: Chiều Dài của đường cong vào/trong không gian đối tượng.
geom:curve_tangent_normal: Pháp Tiếp Tuyến của sợi.
"geom:is_point": Được điểm trong đám mây điểm hoặc không/không phải/nghịch/phủ định (not).
"geom:point_radius": Bán Kính của điểm/chấm vào/trong mây điểm chấm.
"geom:point_position": Trung Tâm vị trí của điểm/chấm vào/trong mây điểm chấm.
geom:point_random: Random number, different for every point in point cloud.
path:ray_length: Ray distance since last hit.
object:random: Ngẫu Nhiên số/lượng, different cho/đối với every đối tượng thực thể.
object:index: Đối Tượng duy nhất chỉ số thực thể.
object:location: Vị Trí của Đối Tượng.
material:index: Nguyên Vật Liệu duy nhất chỉ số số/lượng.
particle:index: Hạt duy nhất thực thể số/lượng.
particle:age: Tuổi thọ của hạt trong số khung hình.
particle:lifetime: Total lifespan of particle in frames.
particle:location: Vị trí của hạt.
particle:size: Kích thước của hạt.
particle:velocity: Vận tốc của hạt.
particle:angular_velocity: Vận tốc góc của hạt.

Dò Tia (Trace)¶

Duy CPU (CPU Only)

We support the trace(point pos, vector dir, ...) function, to trace rays from the OSL shader. The "shade" parameter is not supported currently, but attributes can be retrieved from the object that was hit using the getmessage("trace", ..) function. See the OSL specification for details on how to use this.

This function cannot be used instead of lighting; the main purpose is to allow shaders to "probe" nearby geometry, for example to apply a projected texture that can be blocked by geometry, apply more "wear" to exposed geometry, or make other ambient occlusion-like effects.

Siêu Dữ Liệu (Metadata)¶

Metadata on parameters controls how they are displayed in the user interface. The following metadata entries are supported:

[[ string label = "My Label" ]]: Custom display name of the parameter in the user interface.
[[ string widget = "null" ]]: Hides the parameter from the user interface.
[[ string widget = "boolean" ]] or [[ string widget = "checkbox" ]]: Displays an integer parameter as a boolean checkbox.
[[ string widget = "filename" ]]: Displays the parameter as a file path selector.
[[ string widget = "mapper", string options = "left:0|right:1" ]]: Displays an integer parameter as an enumerated menu. The options string defines a list of label-value pairs separated by |.
[[ string vecsemantics = "POINT" ]]: Marks a vector parameter as a translation input (position vector).
[[ string vecsemantics = "NORMAL" ]]: Marks a vector parameter as a normal input (direction vector).
[[ string unit = "radians" ]]: Marks a float parameter as an angle input, displayed in radians.
[[ string unit = "m" ]]: Marks a float parameter as a distance input, displayed in meters.
[[ string unit = "mm" ]]: Marks a float parameter as a distance input, displayed in millimeters.
[[ string unit = "s" ]] or [[ string unit = "sec" ]]: Marks a float parameter as a time input, displayed in seconds.

Những Giới Hạn (Limitations)¶

Quan trọng

OSL is not supported with GPU rendering unless using the OptiX backend.

Some OSL features are not available when using the OptiX backend. Examples include:

Texture lookups require OSL to be able to determine a constant image file path for each
texture call.
Some noise functions are not available. Examples include Cell, Simplex, and Gabor.
The trace function is not functional. As a result of this, the Ambient Occlusion and Bevel nodes do not work.