Справка Houdini на русском VEX VEX contexts

light VEX context

Define a light shader with a program called from surface or fog shaders to calculate the illumination of a surface.

On this page

Note

Unless you want to implement your own non-realistic lighting model, you do not need to write your own light shader.

In non-PBR rendering, light shaders are called from surface or fog shaders to compute the illumination from a light source. The light shader would be invoked in an illuminance loop or using the standard diffuse(), specular(), etc. functions.

Globals

vector P Read only

Position of the point on the surface being shaded. In light or shadow shaders, the P variable contains the point on the light source.

vector I Read only

Direction from the eye to the point being shaded. This may or may not be a normalized vector.

vector dPds Read only

Change in position with respect to the parametric s.

vector dPdt Read only

Change in position with respect to the parametric t.

vector N Read only

Shading normal for the surface.

vector Ng Read only

Geometric normal for the surface. This normal represents the "true" normal of the surface being shaded. For example, with Phong shading, the N variable represents the interpolated normal, while the Ng variable represents the true polygon normal.

vector Cl

Light color.

vector L

Vector from the point on the surface to the light source. The length of this vector represents the distance to the light source.

vector Ps Read only

Position of the point on the surface being illuminated.

vector Eye Read only

Position of the eye.

float s Read only

Parametric s (sometimes called u) coordinate of the surface being shaded.

float t Read only

Parametric t (sometimes called v) coordinate of the surface being shaded.

float Time Read only

The time at which the shading occurs, as a number from 0 (shutter open) to 1 (shutter close).

float dPdz Read only

Floating point step size for volume rendering.

vector Lz Read only

Z-axis in the space of the light. This is a unit vector.

int SID Read only

Sample identifier for the current shading sample.

Functions

  • Du

    Returns the derivative of the given value with respect to U.

  • Dv

    Returns the derivative of the given value with respect to V.

  • Dw

    Returns the derivative of the given value with respect to the 3rd axis (for volume rendering).

  • abs

    Возвращает абсолютное значение аргумента.

  • acos

    Возвращает арккосинус аргумента.

  • addattrib

    Добавляет атрибут к геометрии.

  • adddetailattrib

    Добавляет атрибут класса detail к геометрии.

  • addpoint

    Добавляет точку в геометрию.

  • addpointattrib

    Добавляет атрибут класса point к геометрии.

  • addprim

    Добавляет примитив в геометрию.

  • addprimattrib

    Добавляет атрибут класса primitive к геометрии.

  • addvariablename

    Добавляет соответствие атрибута локальной переменной.

  • addvertex

    Добавляет вершину к примитиву в геометрии.

  • addvertexattrib

    Добавляет атрибут класса vertex к геометрии.

  • addvisualizer

    Appends to a geometry’s visualizer detail attribute.

  • agentaddclip

    Add a clip into an agent’s definition.

  • agentclipcatalog

    Returns all of the animation clips that have been loaded for an agent primitive.

  • agentclipchannel

    Finds the index of a channel in an agent’s animation clip.

  • agentcliplength

    Returns the length (in seconds) of an agent’s animation clip.

  • agentclipnames

    Returns an agent primitive’s current animation clips.

  • agentclipsample

    Samples a channel of an agent’s clip at a specific time.

  • agentclipsamplelocal

    Samples an agent’s animation clip at a specific time.

  • agentclipsamplerate

    Returns the sample rate of an agent’s animation clip.

  • agentclipsampleworld

    Samples an agent’s animation clip at a specific time.

  • agentcliptimes

    Returns the current times for an agent primitive’s animation clips.

  • agentcliptransformgroups

    Returns the transform groups for an agent primitive’s current animation clips.

  • agentclipweights

    Returns the blend weights for an agent primitive’s animation clips.

  • agentcollisionlayer

    Returns the name of the collision layer of an agent primitive.

  • agentcurrentlayer

    Returns the name of the current layer of an agent primitive.

  • agentfindtransformgroup

    Finds the index of a transform group in an agent’s definition.

  • agentlayerbindings

    Returns the transform that each shape in an agent’s layer is bound to.

  • agentlayers

    Returns all of the layers that have been loaded for an agent primitive.

  • agentlayershapes

    Returns the names of the shapes referenced by an agent primitive’s layer.

  • agentlocaltransform

    Returns the current local space transform of an agent primitive’s bone.

  • agentlocaltransforms

    Returns the current local space transforms of an agent primitive.

  • agentrigchildren

    Returns the child transforms of a transform in an agent primitive’s rig.

  • agentrigfind

    Finds the index of a transform in an agent primitive’s rig.

  • agentrigparent

    Returns the parent transform of a transform in an agent primitive’s rig.

  • agenttransformcount

    Returns the number of transforms in an agent primitive’s rig.

  • agenttransformgroupmember

    Returns whether a transform is a member of the specified transform group.

  • agenttransformgroups

    Returns the names of the transform groups in an agent’s definition.

  • agenttransformgroupweight

    Returns the weight of a member of the specified transform group.

  • agenttransformnames

    Returns the name of each transform in an agent primitive’s rig.

  • agenttransformtolocal

    Converts transforms from world space to local space for an agent primitive.

  • agenttransformtoworld

    Converts transforms from local space to world space for an agent primitive.

  • agentworldtransform

    Returns the current world space transform of an agent primitive’s bone.

  • agentworldtransforms

    Returns the current world space transforms of an agent primitive.

  • albedo

    Returns the albedo (percentage of reflected light) for a bsdf given the outgoing light direction.

  • anoise

    Generates "alligator" noise.

  • append

    Добавляет элемент в массив или строку.

  • area

    Returns the area of the micropolygon containing a variable such as P.

  • argsort

    Возвращает индексы отсортированной версии массива.

  • array

    Эффективно создает массив из своих аргументов.

  • ashikhmin

    Returns a specular BSDF using the Ashikhmin shading model.

  • asin

    Возвращает арксинус аргумента.

  • assert_enabled

    Returns 1 if the VEX assertions are enabled (see HOUDINI_VEX_ASSERT) or 0 if assertions are disabled. Used the implement the assert macro.

  • assign

    Эффективный способ извлечения компонентов вектора или матрицы в переменные типа float.

  • atan

    Возвращает арктангенс аргумента.

  • atan2

    Возвращает арктангенс y/x.

  • atof

    Преобразует string во float.

  • atoi

    Преобразует string в integer.

  • atten

    Computes attenuated falloff.

  • attrib

    Читает значение атрибута из геометрии.

  • attribclass

    Возвращает класс атрибута геометрии.

  • attribsize

    Возвращает размер атрибута геометрии.

  • attribtype

    Возвращает тип атрибута геометрии.

  • attribtypeinfo

    Returns the transformation metadata of a geometry attribute.

  • avg

    Возвращает среднее значение.

  • blackbody

    Compute the color value of an incandescent black body.

  • blinn

    Returns a Blinn BSDF or computes Blinn shading.

  • blinnBRDF

  • bouncelabel

  • bouncemask

  • cbrt

    Возвращает кубический корень аргумента.

  • ceil

    Возвращает наименьшее целое число, большее или равное аргументу.

  • ch

    Вычисляет канал (или параметр) и возвращает его значение.

  • ch2

    Вычисляет канал (или параметр) и возвращает его значение.

  • ch3

    Вычисляет канал (или параметр) и возвращает его значение.

  • ch4

    Вычисляет канал (или параметр) и возвращает его значение.

  • chexpr

    Вычисляет канал с новым выражением сегмента.

  • chexprf

    Вычисляет канал с новым выражением сегмента в заданном кадре.

  • chexprt

    Вычисляет канал с новым выражением сегмента в заданный момент времени.

  • chf

    Вычисляет канал (или параметр) и возвращает его значение.

  • chi

    Вычисляет канал (или параметр) и возвращает его значение.

  • chp

    Вычисляет канал (или параметр) и возвращает его значение.

  • chr

    Converts an unicode codepoint to a UTF8 string.

  • chramp

    Вычисляет ramp параметр и возвращает его значение.

  • chs

    Вычисляет канал (или параметр) и возвращает его значение.

  • chsraw

    Возвращает необработанное значение канала (или параметра).

  • chu

    Вычисляет канал (или параметр) и возвращает его значение.

  • chv

    Вычисляет канал (или параметр) и возвращает его значение.

  • ckspline

    Samples a Catmull-Rom (Cardinal) spline defined by position/value keys.

  • clamp

    Возвращает значение ограниченное минимумом и максимумом.

  • clip

    Clip the line segment between p0 and p1.

  • colormap

    Looks up a (filtered) color from a texture file.

  • computenormal

    In shading contexts, computes a normal. In the SOP contexts, sets how/whether to recompute normals.

  • concat

    Объединяет все указанные строки в одну строку.

  • cone

    Returns a cone reflection BSDF.

  • cos

    Возвращает косинус аргумента.

  • cosh

    Возвращает гиперболический косинус аргумента.

  • cracktransform

    Depending on the value of c, returns the translate (c=0), rotate (c=1), scale (c=2), or shears (c=3) component of the transform (xform).

  • create_cdf

    Creates a CDF from an array of input PDF values.

  • create_pdf

    Creates a PDF from an array of input values.

  • cross

    Возвращает результат вычисления векторного произведения между двумя векторами.

  • cspline

    Samples a Catmull-Rom (Cardinal) spline defined by uniformly spaced keys.

  • ctransform

    Transforms between color spaces.

  • curlnoise

    Computes divergence free noise based on Perlin noise.

  • curlnoise2d

    Computes 2d divergence free noise based on Perlin noise.

  • curlxnoise

    Computes divergence free noise based on Simplex noise.

  • curlxnoise2d

    Computes 2d divergence free noise based on simplex noise.

  • cvex_bsdf

    Creates a bsdf object from two CVEX shader strings.

  • cwnoise

    Generates Worley (cellular) noise using a Chebyshev distance metric.

  • degrees

    Преобразует аргумент из радиан в градусы.

  • depthmap

    The depthmap functions work on an image which was rendered as a z-depth image from mantra.

  • detail

    Читает значение атрибута класса detail из геометрии.

  • detailattrib

    Читает значение атрибута класса detail из геометрии и выводит флаг успеха/неудачи операции чтения.

  • detailattribsize

    Возвращает размер атрибута класса detail.

  • detailattribtype

    Возвращает тип атрибута класса detail.

  • detailattribtypeinfo

    Returns the type info of a geometry attribute.

  • detailintrinsic

    Читает значение встроенной функции атрибута класса detail из геометрии.

  • determinant

    Вычисляет детерминант (определитель) матрицы.

  • diffuse

    Returns a diffuse BSDF or computes diffuse shading.

  • diffuseBRDF

  • dihedral

    Computes the rotation matrix or quaternion which rotates the vector a onto the vector b.

  • dimport

    Reads a variable from the displacement shader for the surface.

  • distance

    Возвращает расстояние между двумя точками.

  • distance2

    Возвращает квадратное расстояние между двумя точками.

  • dot

    Возвращает результат вычисления скалярного произведения между двумя векторами.

  • dsmpixel

    Reads the z-records stored in a pixel of a deep shadow map or deep camera map.

  • efit

    Принимает значение в одном диапазоне и меняет его на соответствующее значение в новом диапазоне.

  • eigenvalues

    Computes the eigenvalues of a 3×3 matrix.

  • endswith

    Возвращает 1, если строка оканчивается указанной строкой.

  • environment

    Returns the color of the environment texture.

  • erf

    Gauss error function.

  • erf_inv

    Inverse Gauss error function.

  • erfc

    Gauss error function’s complement.

  • error

    Reports a custom runtime VEX error.

  • eulertoquaternion

    Creates a vector4 representing a quaternion from euler angles.

  • eval_bsdf

    Evaluates a bsdf given two vectors.

  • exp

    Returns the exponential function of the argument.

  • expand_udim

    Perform UDIM or UVTILE texture filename expansion.

  • expandedgegroup

    Возвращает список пар точек рёбер указанной группы.

  • expandpointgroup

    Возвращает список точек указанной группы.

  • expandprimgroup

    Возвращает список примитивов указанной группы.

  • fastshadow

    Sends a ray from the position P along the direction specified by the direction D.

  • filamentsample

    Samples the velocity field defined by a set of vortex filaments.

  • file_stat

    Returns file system status for a given file.

  • filtershadow

    Sends a ray from the position P along direction D.

  • filterstep

    Returns the anti-aliased weight of the step function.

  • find

    Finds an item in an array or string.

  • findattribval

    Находит примитив/точку/вершину, которая имеет определенное значение атрибута.

  • findattribvalcount

    Возвращает число элементов, в которых целочисленный или строковый атрибут имеет определенное значение.

  • fit

    Принимает значение в одном диапазоне и меняет его на соответствующее значение в новом диапазоне.

  • fit01

    Принимает значение в диапазоне (0, 1) и меняет его на соответствующее значение в новом диапазоне.

  • fit10

    Принимает значение в диапазоне (1, 0) и меняет его на соответствующее значение в новом диапазоне.

  • fit11

    Принимает значение в диапазоне (-1, 1) и меняет его на соответствующее значение в новом диапазоне.

  • floor

    Возвращает наибольшее целое число, меньшее или равное аргументу.

  • flownoise

    Generates 1D and 3D Perlin Flow Noise from 3D and 4D data.

  • flowpnoise

    There are two forms of Perlin-style noise: a non-periodic noise which changes randomly throughout N-dimensional space, and a periodic form which repeats over a given range of space.

  • frac

    Возвращает дробную часть числа с плавающей запятой.

  • fresnel

    Computes the fresnel reflection/refraction contributions given an incoming vector, surface normal (both normalized), and an index of refraction (eta).

  • fromNDC

    Transforms a position from normal device coordinates to the coordinates in the appropriate space.

  • frontface

    If dot(I, Nref) is less than zero, N will be negated.

  • fuzzify

  • fuzzy_and

  • fuzzy_defuzz_centroid

  • fuzzy_nand

  • fuzzy_nor

  • fuzzy_not

  • fuzzy_nxor

  • fuzzy_or

  • fuzzy_xor

  • geoself

    Возвращает дескриптор текущей геометрии.

  • geounwrap

    Returns an oppath: string to unwrap the geometry in-place.

  • getattrib

    Читает значение атрибута из геометрии и выводит флаг успеха/неудачи операции чтения.

  • getattribute

    Copies the value of a geometry attribute into a variable and returns a success flag.

  • getbbox

    Устанавливает два вектора в минимальный и максимальный углы ограничивающего бокса геометрии.

  • getbbox_center

    Возвращает центр ограничивающего бокса геометрии.

  • getbbox_max

    Возвращает максимум ограничивающего бокса геометрии.

  • getbbox_min

    Возвращает минимум ограничивающего бокса геометрии.

  • getbbox_size

    Возвращает размер ограничивающего бокса геометрии.

  • getblurP

    Returns the blurred point position (P) vector at a fractional time within the motion blur exposure.

  • getbounces

  • getbounds

    Возвращает ограничивающий бокс геометрии заданного файла.

  • getcomp

    Извлекает один компонент из вектора, матрицы, массива или строки.

  • getcomponents

  • getderiv

    Evaluates surface derivatives of an attribute.

  • getglobalraylevel

    Returns the depth of the ray tree for computing global illumination.

  • getlight

    Returns a light struct for the specified light identifier.

  • getlights

    Returns an array of light identifiers for the currently shaded surface.

  • getlightscope

    Returns a selection of lights that illuminate a given material.

  • getmaterial

    Returns a material struct for the current surface.

  • getobjectid

    Returns the object id for the current shading context.

  • getphotonlight

    Returns the integer ID of the light being used for photon shading.

  • getpointbbox

    Устанавливает два вектора в минимальный и максимальный углы ограничивающего бокса геометрии.

  • getpointbbox_center

    Возвращает центр ограничивающего бокса геометрии.

  • getpointbbox_max

    Возвращает максимум ограничивающего бокса геометрии.

  • getpointbbox_min

    Возвращает минимум ограничивающего бокса геометрии.

  • getpointbbox_size

    Возвращает размер ограничивающего бокса геометрии.

  • getscope

    Returns a selection of objects visible to rays for a given material.

  • getspace

    Returns a transform from one space to another.

  • getuvtangents

    Evaluates UV tangents at a point on an arbitrary object.

  • gradient

    Returns the gradient of a field.

  • hair

    Returns a BSDF for shading hair.

  • hasattrib

    Проверяет, существует ли атрибут геометрии.

  • hasdetailattrib

    Проверяет, существует ли указанный атрибут класса detail.

  • haslight

    Returns whether a light illuminates the given material.

  • haspointattrib

    Проверяет, существует ли указанный атрибут класса point.

  • hasprimattrib

    Проверяет, существует ли указанный атрибут класса prim.

  • hasvertexattrib

    Проверяет, существует ли указанный атрибут класса vertex.

  • hedge_dstpoint

    Возвращает конечную точку полуребра.

  • hedge_dstvertex

    Возвращает конечную вершину полуребра.

  • hedge_equivcount

    Возвращает количество полуребер, эквивалентных заданному полеребру.

  • hedge_isequiv

    Определяет, являются ли два полуребра эквивалентными (представлены одним и тем же ребром).

  • hedge_isprimary

    Определяет, соответствует номер полуребра первичному полуребру.

  • hedge_isvalid

    Определяет, соответствует ли номер полуребра действительному полуребру.

  • hedge_next

    Возвращает полуребро, которое следует за заданным полуребром в его примитиве.

  • hedge_nextequiv

    Возвращает следующие полуребра, эквивалентные заданному полуребру.

  • hedge_postdstpoint

    Возвращает точку, в которую подключена вершина, следующая за конечной вершиной полуребра в его примитиве.

  • hedge_postdstvertex

    Возвращает вершину, следующую за конечной вершиной заданного полуребра в его примитиве.

  • hedge_presrcpoint

    Возвращает точку, в которую подключена вершина, предшествущая начальной вершине полуребра в его примитиве.

  • hedge_presrcvertex

    Возвращает вершину, которая предшествует начальной вершине заданного полуребра в его примитиве.

  • hedge_prev

    Возвращает полуребро, которое предшествует заданному полуребру в том же примитиве.

  • hedge_prim

    Возвращает примитив, содержащий полуребро.

  • hedge_primary

    Возвращает первичное полуребро эквивалентное заданному полуребру.

  • hedge_srcpoint

    Возвращает начальную точку полуребра.

  • hedge_srcvertex

    Возвращает начальную вершину полуребра.

  • henyeygreenstein

    Returns an anisotropic volumetric BSDF, which can scatter light forward or backward.

  • hscript_noise

    Generates noise matching the output of the Hscript noise() expression function.

  • hscript_rand

    Produces the exact same results as the Houdini expression function of the same name.

  • hscript_snoise

  • hscript_sturb

  • hscript_turb

    Generates turbulence matching the output of the HScript turb() expression function.

  • hsvtorgb

    Преобразование цветового пространства HSV в цветовое пространство RGB.

  • ident

    Возвращает единичную матрицу.

  • idtopoint

    Находит точку по атрибуту id.

  • idtoprim

    Находит примитив по атрибуту id.

  • inedgegroup

    Возвращает 1, если ребро, указанное парой точек, входит в группу, указанную строкой.

  • inpointgroup

    Возвращает 1, если точка, указанная номером точки, входит в группу, указанную строкой.

  • inprimgroup

    Возвращает 1, если примитив, указанный номером примитива, входит в группу, указанную строкой.

  • insert

    Вставляет элемент, массив или строку в массив или строку.

  • instance

    Creates an instance transform matrix.

  • interpolate

    Interpolates a value across the currently shaded micropolygon.

  • intersect

    This function computes the first intersection of a ray with geometry.

  • intersect_all

    Computes all intersections of the specified ray with geometry.

  • invert

    Возвращает обратную матрицу.

  • invertexgroup

    Возвращает 1, если вершина, указанная номером вершины, входит в группу, указанную строкой.

  • isalpha

    Возвращает 1, если все символы в строке являются буквами.

  • isbound

    Parameters in VEX can be overridden by geometry attributes (if the attributes exist on the surface being rendered).

  • isdigit

    Возвращает 1, если все символы в строке являются цифрами.

  • isfinite

    Проверяет, является ли значение нормальным конечным числом.

  • isfogray

    Returns 1 if the shader is being called to evaluate illumination for fog objects, or 0 if the light or shadow shader is being called to evaluate surface illumination.

  • isnan

    Проверяет, что значение является не числом.

  • isotropic

    Returns an isotropic BSDF, which scatters light equally in all directions.

  • isuvrendering

    Indicats whether the shader is being evaulated while doing UV rendering (e.g. texture unwrapping)

  • isvalidindex

    Проверяет, является ли заданный индекс действительным для массива или строки.

  • isvarying

    Check whether a VEX variable is varying or uniform.

  • itoa

    Преобразует integer в string.

  • join

    Объединяет все строки массива через общий разделитель.

  • kspline

    Returns an interpolated value along a curve defined by a basis and key/position pairs.

  • len

    Возвращает длину массива.

  • length

    Возвращает длину вектора.

  • length2

    Возвращает квадрат длины вектора.

  • lerp

    Выполняет билинейную интерполяцию между значениями.

  • limit_sample_space

    Limits a unit value in a way that maintains uniformity and in-range consistency.

  • lkspline

    Samples a polyline between the key points.

  • log

    Возвращает натуральный логарифм аргумента.

  • log10

    Возвращает десятичный логарифм (по основанию 10) аргумента.

  • lookat

    Computes a rotation matrix or angles to orient the z-axis along the vector (to-from) under the transformation.

  • lspline

    Samples a polyline defined by linearly spaced values.

  • lstrip

    Удаляет символы с начала строки.

  • luminance

    Вычисляет яркость цвета RGB, заданного параметрами.

  • makebasis

    Creates an orthonormal basis given a z-axis vector.

  • maketransform

    Builds a 3×3 or 4×4 transform matrix.

  • mask_bsdf

    Returns new BSDF that only includes the components specified by the mask.

  • match

    This function returns 1 if the subject matches the pattern specified, or 0 if the subject doesn’t match.

  • matchvex_blinn

    Returns a BSDF that matches the output of the traditional VEX blinn function.

  • matchvex_specular

    Returns a BSDF that matches the output of the traditional VEX specular function.

  • max

    Возвращает наибольшее значение.

  • metaimport

    Once you get a handle to a metaball using metastart and metanext, you can query attributes of the metaball with metaimport.

  • metamarch

    Takes the ray defined by p0 and p1 and partitions it into zero or more sub-intervals where each interval intersects a cluster of metaballs from filename.

  • metanext

    Iterate to the next metaball in the list of metaballs returned by the metastart() function.

  • metastart

    Open a geometry file and return a "handle" for the metaballs of interest, at the position p.

  • metaweight

    Returns the metaweight of the geometry at position p.

  • min

    Возвращает наименьшее значение.

  • minpos

    Finds the closest position on the surface of a geometry.

  • mwnoise

    Generates Worley (cellular) noise using a Manhattan distance metric.

  • nametopoint

    Находит точку по атрибуту name.

  • nametoprim

    Находит примитив по атрибуту name.

  • nbouncetypes

  • nearpoint

    Finds the closest point in a geometry.

  • nearpoints

    Finds the all the closest point in a geometry.

  • nedgesgroup

    Returns the number of edges in the group.

  • neighbour

    Возвращает номер следующей точки подключенной к данной.

  • neighbourcount

    Возвращает количество точек, подключенных к указанной точке.

  • neighbours

    Возвращает массив номеров точек соединенных с данной.

  • newsampler

    Initializes a sampling sequence for the nextsample function.

  • nextsample

  • noise

    There are two forms of Perlin-style noise: a non-periodic noise which changes randomly throughout N-dimensional space, and a periodic form which repeats over a given range of space.

  • noised

    Derivatives of Perlin Noise.

  • normal_bsdf

    Returns the normal for the diffuse component of a BSDF.

  • normalize

    Возвращает нормализованный вектор.

  • npoints

    Возвращает количество точек на входе или в файле геометрии.

  • npointsgroup

    Возвращает количество точек в группе.

  • nprimitives

    Возвращает количество примитивов на входе или в файле геометрии.

  • nprimitivesgroup

    Возвращает количество примитивов в группе.

  • nrandom

    Non-deterministic random number generation function.

  • ntransform

    Transforms a normal vector.

  • nuniqueval

    Возвращает количество уникальных значений из целочисленного или строкового атрибута.

  • nvertices

    Возвращает количество вершин на входе или в файле геометрии.

  • nverticesgroup

    Возвращает количество вершин в группе.

  • ocean_sample

    Evaluates an ocean spectrum and samples the result at a given time and location.

  • ocio_activedisplays

    Returns the names of active displays supported in Open Color IO

  • ocio_activeviews

    Returns the names of active views supported in Open Color IO

  • ocio_import

    Imports attributes from OpenColorIO spaces.

  • ocio_roles

    Returns the names of roles supported in Open Color IO

  • ocio_spaces

    Returns the names of color spaces supported in Open Color IO.

  • ocio_transform

    Transform colors using Open Color IO

  • onoise

    These functions are similar to wnoise and vnoise.

  • opdigits

    Returns the integer value of the last sequence of digits of a string

  • opfullpath

    Возвращает полный путь для заданного относительного пути

  • opparentbonetransform

    Returns the parent bone transform associated with an OP.

  • opparenttransform

    Returns the parent transform associated with an OP.

  • opparmtransform

    Returns the parm transform associated with an OP.

  • oppreconstrainttransform

    Returns the preconstraint transform associated with an OP.

  • oppretransform

    Returns the pretransform associated with an OP.

  • optransform

    Returns the transform associated with an OP.

  • ord

    Converts an UTF8 string into a codepoint.

  • osd_facecount

  • osd_firstpatch

  • osd_limitsurface

    Evaluates an attribute at the subdivision limit surface using Open Subdiv.

  • osd_limitsurfacevertex

  • osd_lookupface

    Outputs the Houdini face and UV coordinates corresponding to the given coordinates on an OSD patch.

  • osd_lookuppatch

    Outputs the OSD patch and UV coordinates corresponding to the given coordinates on a Houdini polygon face.

  • osd_patchcount

  • osd_patches

    Returns a list of patch IDs for the patches in a subdivision hull.

  • outerproduct

    Возвращает внешнее произведение между аргументами.

  • ow_nspace

    Преобразует вектор нормали из пространства объекта (Object space) в мировое пространство (World space).

  • ow_space

    Transforms a position value from Object to World space.

  • ow_vspace

    Преобразует вектор направления из пространства объекта (Object space) в мировое пространство (World space).

  • pack_inttosafefloat

    Reversibly packs an integer into a finite, non-denormal float.

  • pcclose

    This function closes the handle associated with a pcopen function.

  • pcconvex

  • pcexport

    Writes data to a point cloud inside a pciterate or a pcunshaded loop.

  • pcfarthest

    Returns the distance to the farthest point found in the search performed by pcopen.

  • pcfilter

    Filters points found by pcopen using a simple reconstruction filter.

  • pcfind

    Returns a list of closest points from a file.

  • pcfind_radius

    Returns a list of closest points from a file taking into account their radii.

  • pcgenerate

    Generates a point cloud.

  • pcimport

    Imports channel data from a point cloud inside a pciterate or a pcunshaded loop.

  • pcimportbyidx3

    Imports channel data from a point cloud outside a pciterate or a pcunshaded loop.

  • pcimportbyidx4

    Imports channel data from a point cloud outside a pciterate or a pcunshaded loop.

  • pcimportbyidxf

    Imports channel data from a point cloud outside a pciterate or a pcunshaded loop.

  • pcimportbyidxi

    Imports channel data from a point cloud outside a pciterate or a pcunshaded loop.

  • pcimportbyidxp

    Imports channel data from a point cloud outside a pciterate or a pcunshaded loop.

  • pcimportbyidxs

    Imports channel data from a point cloud outside a pciterate or a pcunshaded loop.

  • pcimportbyidxv

    Imports channel data from a point cloud outside a pciterate or a pcunshaded loop.

  • pciterate

    This function can be used to iterate over all the points which were found in the pcopen query.

  • pcnumfound

    This node returns the number of points found by pcopen.

  • pcopen

    Returns a handle to a point cloud file.

  • pcopenlod

    Returns a handle to a point cloud file.

  • pcsampleleaf

    Changes the current iteration point to a leaf descendant of the current aggregate point.

  • pcsize

  • pcunshaded

    Iterate over all of the points of a read-write channel which haven’t had any data written to the channel yet.

  • pcwrite

    Writes data to a point cloud file.

  • pgfind

    Returns a list of closest points from a file.

  • phongBRDF

  • phonglobe

  • photonmap

    Samples a color from a photon map.

  • planepointdistance

    Computes the distance and closest point of a point to an infinite plane.

  • planesphereintersect

    Computes the intersection of a 3D sphere and an infinite 3D plane.

  • pluralize

    Converts an English noun to its plural.

  • pnoise

    There are two forms of Perlin-style noise: a non-periodic noise which changes randomly throughout N-dimensional space, and a periodic form which repeats over a given range of space.

  • point

    Читает значение атрибута класса point из геометрии.

  • pointattrib

    Читает значение атрибута класса point из геометрии и выводит флаг успеха/неудачи операции чтения.

  • pointattribsize

    Возвращает размер атрибута класса point.

  • pointattribtype

    Возвращает тип атрибута класса point.

  • pointattribtypeinfo

    Returns the type info of a geometry attribute.

  • pointedge

    Находит и возвращает полуребро с заданными конечными точками.

  • pointhedge

    Находит и возвращает полуребро с заданной начальной точкой или с заданными начальной и конечной точками.

  • pointhedgenext

    Возвращает следующее полуребро с той же начальной точкой, что и у заданного полуребра.

  • pointprims

    Возвращает список примитивов, содержащих точку.

  • pointvertex

    Возвращает линейный номер вершины указанной точки.

  • pointvertices

    Возвращает список вершин, связанных с точкой.

  • polardecomp

    Computes the polar decomposition of a matrix.

  • pop

    Удаляет последний элемент массива и возвращает его.

  • pow

    Возвращает результат возведения первого аргумента в степень второго аргумента.

  • predicate_incircle

    Determines if a point is inside or outside a triangle circumcircle.

  • predicate_insphere

    Determines if a point is inside or outside a tetrahedron circumsphere.

  • predicate_orient2d

    Determines the orientation of a point with respect to a line.

  • predicate_orient3d

    Determines the orientation of a point with respect to a plane.

  • prim

    Читает значение атрибута класса primitive из геометрии.

  • prim_attribute

    Interpolates the value of an attribute at a certain parametric (u, v) position and copies it into a variable.

  • prim_normal

    Returns the normal of the primitive (prim_number) at parametric location u, v.

  • primarclen

    Evaluates the length of an arc on a primitive using parametric uv coordinates.

  • primattrib

    Читает значение атрибута класса primitive из геометрии и выводит флаг успеха/неудачи операции чтения.

  • primattribsize

    Возвращает размер атрибута класса primitive.

  • primattribtype

    Возвращает тип атрибута класса primitive.

  • primattribtypeinfo

    Returns the type info of a geometry attribute.

  • primduv

    Returns position derivative on a primitive at a certain parametric (u, v) position.

  • primfind

    Returns a list of primitives potentially intersecting a given bounding box.

  • primhedge

    Возвращает одно из полуребер, содержащихся в примитиве.

  • primintrinsic

    Читает значение встроенной функции атрибута класса primitive из геометрии.

  • primpoint

    Преобразует пару примитив/вершина в номер точки.

  • primpoints

    Возвращает список точек, принадлежащих примитиву.

  • primuv

    Interpolates the value of an attribute at a certain parametric (uvw) position.

  • primuvconvert

    Convert parametric UV locations on curve primitives between different spaces.

  • primvertex

    Преобразует пару номер примитива/вершины в линейный номер вершины.

  • primvertexcount

    Возвращает количество вершин в примитиве.

  • primvertices

    Возвращает список вершин в примитиве.

  • print_once

    Prints a message only once, even in a loop.

  • printf

    Prints values to the console which started the VEX program.

  • product

    Возвращает произведение списка чисел.

  • ptexture

    Computes a filtered sample from a ptex texture map. Use texture instead.

  • ptlined

    This function returns the closest distance between the point Q and a finite line segment between points P0 and P1.

  • ptransform

    Transforms a vector from one space to another.

  • push

    Добавляет элемент в массив.

  • qconvert

    Converts a quaternion represented by a vector4 to a matrix3 representation.

  • qdistance

    Finds distance between two quaternions.

  • qinvert

    Inverts a quaternion rotation.

  • qmultiply

    Перемножает два кватерниона и возвращает результат.

  • qrotate

    Rotates a vector by a quaternion.

  • quaternion

    Creates a vector4 representing a quaternion.

  • radians

    Преобразует аргумент из градусов в радианы.

  • rand

    Creates a random number between 0 and 1 from a seed.

  • random

    Generate a random number based on the position in 1-4D space.

  • random_fhash

    Hashes floating point numbers to integers.

  • random_ihash

    Hashes integer numbers to integers.

  • random_shash

    Hashes a string to an integer.

  • random_sobol

    Generate a uniformly distributed random number.

  • rawcolormap

    Looks up an unfiltered color from a texture file.

  • rayhittest

    Sends a ray from the position P along the direction D.

  • rayimport

    Imports a value sent by a shader in a gather loop.

  • re_find

    Matches a regular expression in a string

  • re_findall

    Finds all instances of the given regular expression in the string

  • re_match

    Returns 1 if the entire input string matches the expression

  • re_replace

    Replaces instances of regex_find with regex_replace

  • re_split

    Splits the given string based on regex match.

  • reflect

    Returns the vector representing the reflection of the direction against the normal.

  • refract

    Returns the refraction ray given an incoming direction, the normalized normal and an index of refraction.

  • relativepath

    Computes the relative path for two full paths.

  • relbbox

    Возвращает относительное положение точки, заданной относительно ограничивающего бокса геометрии.

  • relpointbbox

    Возвращает относительное положение точки, заданной относительно ограничивающего бокса геометрии.

  • removeindex

    Удаляет из массива элемент с заданным индексом.

  • removepoint

    Удаляет точку из геометрии.

  • removeprim

    Удаляет примитив из геометрии.

  • removevalue

    Удаляет элемент из массива.

  • reorder

    Переупорядочивает элементы в массиве или строке.

  • resample_linear

  • resize

    Устанавливает длину массива.

  • reverse

    Возвращает массив или строку в обратном порядке.

  • rgbtohsv

    Преобразование цветового пространства RGB в цветовое пространство HSV.

  • rgbtoxyz

    Convert a linear sRGB triplet to CIE XYZ tristimulus values.

  • rint

    Округляет число до ближайшего целого.

  • rotate

    Применяет поворот к заданной матрице.

  • rotate_x_to

    Rotates a vector by a rotation that would bring the x-axis to a given direction.

  • rstrip

    Удаляет символы с конца строки.

  • sample_bsdf

    Samples a BSDF.

  • sample_cauchy

    Samples the Cauchy (Lorentz) distribution.

  • sample_cdf

    Samples a CDF.

  • sample_circle_arc

    Generates a uniform unit vector2, within maxangle of center, given a uniform number between 0 and 1.

  • sample_circle_edge_uniform

    Generates a uniform unit vector2, given a uniform number between 0 and 1.

  • sample_circle_slice

    Generates a uniform vector2 with length < 1, within maxangle of center, given a vector2 of uniform numbers between 0 and 1.

  • sample_circle_uniform

    Generates a uniform vector2 with length < 1, given a vector2 of uniform numbers between 0 and 1.

  • sample_direction_cone

    Generates a uniform unit vector, within maxangle of center, given a vector2 of uniform numbers between 0 and 1.

  • sample_direction_uniform

    Generates a uniform unit vector, given a vector2 of uniform numbers between 0 and 1.

  • sample_discrete

    Returns an integer, either uniform or weighted, given a uniform number between 0 and 1.

  • sample_exponential

    Samples the exponential distribution.

  • sample_geometry

    Samples geometry in the scene and returns information from the shaders of surfaces that were sampled.

  • sample_hemisphere

    Generates a unit vector, optionally biased, within a hemisphere, given a vector2 of uniform numbers between 0 and 1.

  • sample_hypersphere_cone

    Generates a uniform vector4 with length < 1, within maxangle of center, given a vector4 of uniform numbers between 0 and 1.

  • sample_hypersphere_uniform

    Generates a uniform vector4 with length < 1, given a vector4 of uniform numbers between 0 and 1.

  • sample_lognormal

    Samples the log-normal distribution based on parameters of the underlying normal distribution.

  • sample_lognormal_by_median

    Samples the log-normal distribution based on median and standard deviation.

  • sample_normal

    Samples the normal (Gaussian) distribution.

  • sample_orientation_cone

    Generates a uniform unit vector4, within maxangle of center, given a vector of uniform numbers between 0 and 1.

  • sample_orientation_uniform

    Generates a uniform unit vector4, given a vector of uniform numbers between 0 and 1.

  • sample_photon

    Samples a 3D position on a light source and runs the light shader at that point.

  • sample_sphere_cone

    Generates a uniform vector with length < 1, within maxangle of center, given a vector of uniform numbers between 0 and 1.

  • sample_sphere_uniform

    Generates a uniform vector with length < 1, given a vector of uniform numbers between 0 and 1.

  • sampledisk

    Warps uniform random samples to a disk.

  • scale

    Масштабирует заданную матрицу в трёх направлениях одновременно (X, Y, Z - задаются компонентами scale_vector).

  • scatter

    Evaluates a scattering event through the domain of a geometric object.

  • select

    Returns one of two parameters based on a conditional.

  • sensor_panorama_create

    Sensor function to render GL scene and query the result.

  • sensor_panorama_getcolor

    Sensor function query a rendered GL scene.

  • sensor_panorama_getcone

    Sensor function to query average values from rendered GL scene.

  • sensor_panorama_getdepth

    Sensor function query a rendered GL scene.

  • sensor_save

    Sensor function to save a rendered GL scene.

  • serialize

    Flattens an array of vector or matrix types into an array of floats.

  • set

    Создает новое значение, основанное на аргументах, например, создание вектора из компонентов.

  • setagentclipnames

    Sets the current animation clips for an agent primitive.

  • setagentclips

    Sets the animation clips that an agent should use to compute its transforms.

  • setagentcliptimes

    Sets the current times for an agent primitive’s animation clips.

  • setagentclipweights

    Sets the blend weights for an agent primitive’s animation clips.

  • setagentcollisionlayer

    Sets the collision layer of an agent primitive.

  • setagentcurrentlayer

    Sets the current layer of an agent primitive.

  • setagentlocaltransform

    Overrides the local space transform of an agent primitive’s bone.

  • setagentlocaltransforms

    Overrides the local space transforms of an agent primitive.

  • setagentworldtransform

    Overrides the world space transform of an agent primitive’s bone.

  • setagentworldtransforms

    Overrides the world space transforms of an agent primitive.

  • setattrib

    Записывает значение атрибута в геометрию.

  • setattribtypeinfo

    Sets the meaning of an attribute in geometry.

  • setcomp

    Задает один компонент вектора, матрицы или элемент в массиве.

  • setdetailattrib

    Записывает значение атрибута класса detail в геометрию.

  • setedgegroup

    Sets edge group membership in a geometry.

  • setpointattrib

    Записывает значение атрибута класса point в геометрию.

  • setpointgroup

    Добавляет или удаляет точку в/из группы в геометрии.

  • setprimattrib

    Записывает значение атрибута класса primitive в геометрию.

  • setprimgroup

    Добавляет или удаляет примитив в/из группы в геометрии.

  • setprimintrinsic

    Записывает значение записываемой встроенной функции атрибута класса primitive.

  • setprimvertex

    Rewires a vertex in the geometry to a different point.

  • setvertexattrib

    Записывает значение атрибута класса vertex в геометрию.

  • setvertexgroup

    Добавляет или удаляет вершину в/из группы в геометрии.

  • setvertexpoint

    Rewires a vertex in the geometry to a different point.

  • shadowmap

    The shadowmap function will treat the shadow map as if the image were rendered from a light source.

  • shl

    Битовый сдвиг целого числа влево.

  • shr

    Арифметический битовый сдвиг целого числа вправо.

  • shrz

    Логический битовый сдвиг целого числа вправо.

  • sign

    Возвращает -1, 0, или 1 в зависимости от знака аргумента.

  • simport

    Imports a variable sent by a surface shader in an illuminance loop.

  • sin

    Возвращает синус аргумента.

  • sinh

    Возвращает гиперболический синус аргумента.

  • sleep

    Уступает обработку на определенное количество миллисекунд.

  • slerp

    Quaternion blend between q1 and q2 based on the bias.

  • slice

    Вырезает подстроку или подмассив из строки или массива.

  • slideframe

    Finds the normal component of frame slid along a curve.

  • smooth

    Computes ease in/out interpolation between values.

  • smoothrotation

    Returns the closest equivalent Euler rotations to a reference rotation.

  • snoise

    These functions are similar to wnoise.

  • solid_angle

    Computes the solid angle (in steradians) a BSDF function subtends.

  • solvecubic

    Solves a cubic function returning the number of real roots.

  • solvepoly

    Finds the real roots of a polynomial.

  • solvequadratic

    Solves a quadratic function returning the number of real roots.

  • sort

    Возвращает массив отсортированный в порядке возрастания.

  • specular

    Returns a specular BSDF or computes specular shading.

  • specularBRDF

    Returns the computed BRDFs for the different lighting models used in VEX shading.

  • spline

    Samples a value along a polyline or spline curve.

  • split

    Splits a string into tokens.

  • split_bsdf

    Splits a bsdf into its component lobes.

  • splitpath

    Splits a file path into the directory and name parts.

  • sprintf

    Formats a string like printf but returns the result as a string instead of printing it.

  • sqrt

    Возвращает квадратный корень аргумента.

  • sssapprox

    Creates an approximate SSS BSDF.

  • startswith

    Возвращает 1, если строка начинается с указанной строки.

  • strip

    Удаляет символы с начала и конца строки.

  • strlen

    Возвращает длину строки.

  • sum

    Возвращает сумму списка чисел.

  • switch

    Use a different bsdf for direct or indirect lighting.

  • swizzle

    Rearranges the components of a vector.

  • tan

    Возвращает тригонометрический тангенс аргумента

  • tanh

    Возвращает гиперболический тангенс аргумента.

  • tet_adjacent

    Returns primitive number of an adjacent tetrahedron.

  • tet_faceindex

    Returns vertex indices of each face of a tetrahedron.

  • teximport

    Imports attributes from texture files.

  • texprintf

    Similar to sprintf, but does expansion of UDIM or UVTILE texture filename expansion.

  • texture

    Computes a filtered sample of the texture map specified.

  • texture3d

    Returns the value of the 3d image at the position specified by P.

  • texture3dBox

    This function queries the 3D texture map specified and returns the bounding box information of the file.

  • titlecase

    Возвращает строку, в которой первые буквы заглавные, а остальные строчные.

  • toNDC

    Transforms a position into normal device coordinates.

  • tolower

    Преобразует все символы строки к нижнему регистру.

  • toupper

    Преобразует все символы строки к верхнему регистру.

  • translate

    Перемещает матрицу по вектору.

  • translucent

    Returns a Lambertian translucence BSDF.

  • transpose

    Транспонирует заданную матрицу.

  • trunc

    Удаляет дробную часть числа с плавающей запятой.

  • tw_nspace

    Преобразует вектор нормали из текстурного пространства (Texture space) в мировое пространство (World space).

  • tw_space

    Transforms a position value from Texture to World space.

  • tw_vspace

    Transforms a direction vector from Texture to World space.

  • uniqueval

    Возвращает одно из множества уникальных значений целочисленного или строкового атрибута.

  • unpack_intfromsafefloat

    Reverses the packing of pack_inttosafefloat to get back the original integer.

  • unserialize

    Turns a flat array of floats into an array of vectors or matrices.

  • upush

    Добавляет единый атрибут в массив.

  • uvdist

    Определяет расстояние от uv координаты до геометрии в uv пространстве.

  • uvintersect

    This function computes the intersection of the specified ray with the geometry in uv space.

  • uvsample

    Interpolates the value of an attribute at certain UV coordinates using a UV attribute.

  • uvunwrap

    Computes the position and normal at given (u, v) coordinates.

  • variance

    Computes the mean value and variance for a value.

  • vertex

    Читает значение атрибута класса vertex из геометрии.

  • vertexattrib

    Читает значение атрибута класса vertex из геометрии и выводит флаг успеха/неудачи операции чтения.

  • vertexattribsize

    Возвращает размер атрибута класса vertex.

  • vertexattribtype

    Возвращает тип атрибута класса vertex.

  • vertexattribtypeinfo

    Returns the type info of a geometry attribute.

  • vertexhedge

    Возвращает полуребро с заданной начальной вершиной.

  • vertexindex

    Преобразует пару примитив/вершина в линейный индекс вершины.

  • vertexnext

    Returns the linear vertex number of the next vertex sharing a point with a given vertex.

  • vertexpoint

    Возвращает номер точки указанной линейной вершины.

  • vertexprev

    Returns the linear vertex number of the previous vertex sharing a point with a given vertex.

  • vertexprim

    Возвращает номер примитива, содержащего заданную вершину.

  • vertexprimindex

    Преобразует линейный индекс вершины в номер вершины в содержащем её примитиве.

  • vnoise

    Generates Voronoi (cellular) noise.

  • volume

    Returns the volume of the microvoxel containing a variable such as P.

  • volumegradient

    Вычисляет градиент volume примитива.

  • volumeindex

    Возвращает значение определенного вокселя.

  • volumeindexorigin

    Возвращает индекс нижней левой части volume примитива.

  • volumeindextopos

    Преобразует индекс вокселя volume примитива в позицию.

  • volumeindexv

    Возвращает векторное значение определенного вокселя.

  • volumepostoindex

    Преобразует позицию в индекс вокселя volume примитива.

  • volumeres

    Возвращает разрешение volume примитива.

  • volumesample

    Вычисляет (сэмплирует) значение volume примитива в заданной позиции.

  • volumesamplev

    Вычисляет (сэмплирует) векторное значение volume примитива в заданной позиции.

  • volumevoxeldiameter

    Вычисляет приблизительный диаметр вокселя.

  • vtransform

    Transforms a directional vector.

  • warning

    Reports a custom runtime VEX warning.

  • wireblinn

  • wirediffuse

  • wnoise

    Generates Worley (cellular) noise.

  • wo_nspace

    Преобразует вектор нормали из мирового пространства (World space) в пространство объекта (Object space).

  • wo_space

    Transforms a position value from World to Object space.

  • wo_vspace

    Преобразует вектор направления из мирового пространства (World space) в пространство объекта (Object space).

  • wt_nspace

    Преобразует вектор нормали из мирового пространства (World space) в текстурное пространство (Texture space).

  • wt_space

    Transforms a position value from World to Texture space.

  • wt_vspace

    Transforms a direction vector from World to Texture space.

  • xnoise

    Simplex noise is very close to Perlin noise, except with the samples on a simplex mesh rather than a grid. This results in less grid artifacts. It also uses a higher order bspline to provide better derivatives.

  • xnoised

    Derivatives of Simplex Noise.

  • xyzdist

    Определяет расстояние от точки до геометрии.

  • xyztorgb

    Convert CIE XYZ tristimulus values to a linear sRGB triplet.

VEX contexts

Shading contexts

See common shading context features for information specific to the shading contexts.

  • displace

    Define a displacement shader with a program that moves a point on a surface before the surface is rendered.

  • fog

    Deprecated. Define a fog shader with a program that modifies the Cf, Of, or Af values to simulate atmospheric effects.

  • light

    Define a light shader with a program called from surface or fog shaders to calculate the illumination of a surface.

  • shadow

    Define a shadow shader by defining a program that’s called from surface or fog shaders to calculate the occlusion on a surface from a light source.

  • surface

    Define a surface shader with a program that sets the final color, opacity, and alpha of a surface being rendered.

Other contexts

  • cvex

  • chop

    Define a custom CHOP operator with a program that edits channel values.

  • cop2

    Define a custom COP operator with a program that sets RGBA or Cr,Cg,Cb,C4 values in an image.

Obsolete contexts

  • image3d

    Obsolete. Write a program for use with the i3dgen program to generate 3D textures.

  • pop

    Obsolete. Define a custom POP operator with a program that edits particle attributes.

  • sop

    Obsolete. Define a custom SOP operator with a program that edits geometry point attributes.