#include <ComplexLightOp.h>

Inheritance diagram for DD::Image::ComplexLightOp:

Public Member Functions
	ComplexLightOp (Node *node)

double	hfov () const override
	Horizontal field of view.

int	lightType () const override

bool	is_delta_light () const override
	This light has a delta distribution (a cone in 3D)

void	get_L_vector (LightContext &ltx, const Vector3 &P, const Vector3 &N, Vector3 &L, float &D) const override
	Calculate a normalized direction vector L and distance D to surface point P.

void	get_color (LightContext &ltx, const Vector3 &P, const Vector3 &N, const Vector3 &L, float D, Pixel &out) override
	Returns the amount of light stiking the current surface point from the light.

void	shade_GL (ViewerContext *ctx, int light_num) override
	This will set the OpenGL lighting settings.

void	draw_handle (ViewerContext *ctx) override
	Draws the light handle.

void	_validate (bool for_real) override
	This will validate the light node.

void	knobs (Knob_Callback f) override

Public Member Functions inherited from DD::Image::LightOp
	LightOp (Node *node)

const LightOp *	lightOp () const override
	Cast to a LightOp. This is much cheaper and safer than using dynamic_cast.

LightOp *	lightOp () override

unsigned	node_color () const override
	Set the default color of a light node.

virtual MaterialOpI *	asMaterialOp ()
	Return this LightOp cast to the MaterialOpI interface. Must implement.

std::string	getShaderNodeName (const usg::Token &target_renderer=usg::Token()) override

usg::TokenArray	getAppliedApiSchemas () const override

virtual usg::Path	exportLightSchemaPrimPath () const

const Pixel &	color () const

void	setColor (const Pixel &color)

double	intensity () const

void	setIntensity (double v)

double	exposure () const

void	setExposure (double v)

bool	enableColorTemperature () const

void	setEnableColorTemperature (bool v)

double	colorTemperature () const

void	setColorTemperature (double v)

bool	normalize () const

void	setNormalize (bool v)

double	diffuse () const

void	setDiffuse (double v)

double	specular () const

void	setSpecular (double v)

Channel	shadowMaskChannel () const

void	setShadowMaskChannel (const Channel &channel)

virtual bool	isDeltaLight () const

virtual double	coneAngle () const

virtual double	coneAspectRatio () const
	Horizontal / vertical angle ratio.

void	_validate (bool for_real) override

void	knobs (Knob_Callback) override

void	addColorKnobs (Knob_Callback)
	Adds the standard color/intensity/exposure knobs.

int	knob_changed (Knob *) override

void	build_handles (ViewerContext *) override

void	draw_handle (ViewerContext *) override
	Draws a picture of a point light.

virtual void	shade_GL (ViewerContext *, int light_num)
	Point light OpenGL settings.

	mFnDeprecatedLegacy3DSystemInNuke14 ("request() has been deprecated, use requestTextures().") virtual void request(ChannelMask

	mFnDeprecatedLegacy3DSystemInNuke14 ("color_knobs() has been deprecated, use addColorKnobs() instead.") void color_knobs(Knob_Callback)

	mFnDeprecatedLegacy3DSystemInNuke14 ("attenuation_knobs() has been deprecated.") void attenuation_knobs(Knob_Callback)

	mFnDeprecatedLegacy3DSystemInNuke14 ("shadow_knobs() has been deprecated, use addShadowKnobs() instead.") void shadow_knobs(Knob_Callback)

	mFnDeprecatedLegacy3DSystemInNuke14 ("color(Pixel) has been deprecated, use setColor() instead.") void color(const Pixel &v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("set_intensity has been deprecated, use setIntensity() instead.") void set_intensity(float v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("falloff() has been deprecated.") bool falloff() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("falloffType() has been deprecated.") int falloffType() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("set_falloffType() has been deprecated.") void set_falloffType(int b)

	mFnDeprecatedLegacy3DSystemInNuke14 ("samples() has been deprecated.") int samples() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("set_samples() has been deprecated.") void set_samples(int n)

	mFnDeprecatedLegacy3DSystemInNuke14 ("sample_width() has been deprecated.") float sample_width() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("set_sample_width() has been deprecated.") void set_sample_width(float width)

	mFnDeprecatedLegacy3DSystemInNuke14 ("Falloff enums have been deprecated.") enum

	mFnDeprecatedLegacy3DSystemInNuke14 ("LightType enums have been deprecated.") enum LightType

	mFnDeprecatedLegacy3DSystemInNuke14 ("ShadowMode enums have been deprecated.") enum ShadowMode

	mFnDeprecatedLegacy3DSystemInNuke14 ("cast_shadows() has been deprecated, use castShadows() instead.") bool cast_shadows() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("set_cast_shadows() has been deprecated, use setCastShadows() instead.") void set_cast_shadows(bool b)

	mFnDeprecatedLegacy3DSystemInNuke14 ("shadows_mode() has been deprecated, use instead.") int shadows_mode() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("alpha_threshold() has been deprecated, use instead.") float alpha_threshold() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("shadow_filter() has been deprecated, use instead.") TextureFilter *shadow_filter()

	mFnDeprecatedLegacy3DSystemInNuke14 ("depthmap_bias() has been deprecated, use instead.") float depthmap_bias() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("set_depthmap_bias() has been deprecated, use instead.") void set_depthmap_bias(float v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("shadow_jitter_scale() has been deprecated, use instead.") float shadow_jitter_scale() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("set_shadow_jitter_scale() has been deprecated, use instead.") void set_shadow_jitter_scale(float v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("depthmap_width() has been deprecated, use instead.") int depthmap_width() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("set_depthmap_width() has been deprecated, use instead.") void set_depthmap_width(int n)

	mFnDeprecatedLegacy3DSystemInNuke14 ("getShadowMaskChannel() has been deprecated, use shadowMaskChannel() instead.") Channel getShadowMaskChannel() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("Class() has been deprecated, implement on subclass plugin instead.") const char *Class() const override

	mFnDeprecatedLegacy3DSystemInNuke14 ("node_help() has been deprecated, implement on subclass plugin instead.") const char *node_help() const override

	mFnDeprecatedLegacy3DSystemInNuke14 ("displayName() has been deprecated, implement on subclass plugin instead.") const char *displayName() const override

	mFnDeprecatedLegacy3DSystemInNuke14 ("is_delta_light() has been deprecated, use isDeltaLight() instead.") virtual bool is_delta_light() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("hfov() has been deprecated, use coneAngle() and coneAspectRatio() instead.") virtual double hfov() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("vfov() has been deprecated, use coneAngle() and coneAspectRatio() instead.") virtual double vfov() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("aspect() has been deprecated, use coneAspectRatio() instead.") virtual double aspect() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lightType() has been deprecated, implement on subclass plugin instead.") virtual int lightType() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("get_L_vector() has been deprecated.") virtual void get_L_vector(LightContext &ltx

	mFnDeprecatedLegacy3DSystemInNuke14 ("get_color() has been deprecated.") virtual void get_color(LightContext &ltx

	mFnDeprecatedLegacy3DSystemInNuke14 ("get_shadowing() has been deprecated.") virtual float get_shadowing(const LightContext &ltx

Public Member Functions inherited from DD::Image::CameraOp
	CameraOp (Node *node)

const CameraOp *	cameraOp () const override
	Cast to a CameraOp. This is much cheaper and safer than using dynamic_cast.

CameraOp *	cameraOp () override

OpHints	opHints () const override
	Return hints to control when and how this op will be evaluated by the top-down system.

unsigned	node_color () const override

void	_validate (bool for_real) override

void	knobs (Knob_Callback) override

void	addExtraFrontPanelKnobs (Knob_Callback f) override

void	addDisplayOptionsKnobs (Knob_Callback f) override
	Adds the frustum visualization controls.

virtual void	addShutterKnobs (Knob_Callback)
	Adds the default shutter controls.

virtual void	addProjectionKnobs (Knob_Callback f, bool enableDefaultKnobs=true)

virtual void	addWindowKnobs (Knob_Callback f, bool enableDefaultKnobs=true)

virtual void	addLensKnobs (Knob_Callback f, bool enableDefaultKnobs=true)

int	knob_changed (Knob *) override

virtual ProjectionFunc *	projectionPlugin () const
	The currently-assigned projection plugin.

ndk::LensProjection	projectionMode () const override

bool	setProjection (const char *projectionClassName)

void	setProjectionMode (ndk::LensProjection mode)

const char *	projectionFuncClassName () const

bool	isBaseProjectionLinear () const override

virtual fdk::Mat4d	projectionModeMatrix (ndk::LensProjection mode) const

virtual fdk::Mat4d	projectionModeMatrixAt (ndk::LensProjection mode, const OutputContext &context) const
	Same as projectionMatrix() except it evaluates the matrix at an arbitrary OutputContext.

HandlesMode	doAnyHandles (ViewerContext *ctx) override

void	build_handles (ViewerContext *) override

void	draw_handle (ViewerContext *) override
	Draws a lovely camera, I think it is a Mitchell.

virtual void	drawCameraIcon (bool solid, bool dashed_lines=false)
	Draw the camera's frustum outline solid or wireframe, dashed if 'dashed_lines'=true.

void	drawNodeName (const char *subcam_name="")
	Draw the node name at position 0,0,0 which will be the local center.

void	drawNodeName (const fdk::Vec3d &P, const char *subcam_name="")
	Draw the node name at an xyz position P relative to the local center.

void	drawAperture (const fdk::Vec3d &P, bool dashed_lines=false)
	Draw the aperture rectangle in millimeters, centered on xyz position P.

void	drawSolidFrustum (const fdk::Vec3d &near_corner, const fdk::Vec3d &far_corner)
	Draw the camera's frustum.

void	drawWireFrustum (const fdk::Vec3d &near_corner, const fdk::Vec3d &far_corner, bool dashed_lines=false)
	Draw the camera's frustum outline, dashed if 'dashed_lines'=true.

CameraOp *	asCameraLoaderOp () override
	SceneLoaderOpI: If loader is attached to an AxisOp subclass return 'this'.

int32_t	importScenePrim (const usg::StageRef &stage, const std::string &prim_path) override

enum	mFnDeprecatedLegacy3DSystemInNuke14 ("Enumeration deprecated, use enum class ndk::LensProjection instead.")

	mFnDeprecatedLegacy3DSystemInNuke14 ("Class() has been deprecated, implement on subclass plugin instead.") const char *Class() const override

	mFnDeprecatedLegacy3DSystemInNuke14 ("node_help() has been deprecated, implement on subclass plugin instead.") const char *node_help() const override

	mFnDeprecatedLegacy3DSystemInNuke14 ("projection_knobs() has been deprecated, use addProjectionKnobs() instead.") virtual void projection_knobs(Knob_Callback f)

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_knobs() has been deprecated, use addDistortionKnobs() instead.") virtual void lens_knobs(Knob_Callback f)

	mFnDeprecatedLegacy3DSystemInNuke14 ("projection() has been deprecated, use projectionMatrix() instead") const Matrix4 &projection() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("hfov(double) has been deprecated, use setHorizontalFov() instead") void hfov(double v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("film_width() has been deprecated, use horizontalAperture() instead") double film_width() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("film_height() has been deprecated, use verticalAperture() instead") double film_height() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("focal_length() has been deprecated, use focalLength() instead") double focal_length() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("Near() has been deprecated, use nearPlaneDistance() instead") double Near() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("Far() has been deprecated, use farPlaneDistance() instead") double Far() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("focal_point() has been deprecated, use focusDistance() instead") double focal_point() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("fstop() has been deprecated, use fStop() instead") double fstop() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("film_width(double) has been deprecated, use setHorizontalAperture() instead") void film_width(double v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("film_height(double) has been deprecated, use setVerticalAperture() instead") void film_height(double v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("focal_length(double) has been deprecated, use setFocalLength() instead") void focal_length(double v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("Near(double) has been deprecated, use setNearPlaneDistance() instead") void Near(double v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("Far(double) has been deprecated, use setFarPlaneDistance() instead") void Far(double v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("focal_point(double) has been deprecated, use setFocusDistance() instead") void focal_point(double v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("fstop(double) has been deprecated, use setfStop() instead") void fstop(double v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("win_translate() has been deprecated, use windowTranslate() instead") const Vector2 &win_translate() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("win_scale() has been deprecated, use windowScale() instead") const Vector2 &win_scale() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("win_roll() has been deprecated, use windowRotateZ() instead") double win_roll() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("projection_mode() has been deprecated, use projectionMode() instead") int projection_mode() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("projection_mode(int) has been deprecated, use setProjectionMode() instead") void projection_mode(int i)

	mFnDeprecatedLegacy3DSystemInNuke14 ("projection_is_linear(int) has been deprecated, use isProjectionModeLinear(ndk::LensProjection) instead") virtual bool projection_is_linear(int mode) const

	mFnDeprecatedLegacy3DSystemInNuke14 ("projection(int) has been deprecated, use projectionModeMatrix(ndk::LensProjection) instead") virtual Matrix4 projection(int mode) const

	mFnDeprecatedLegacy3DSystemInNuke14 ("projectionAt(OutputContext) has been deprecated, use projectionModeMatrixAt(ndk::LensProjection, OutputContext) instead") virtual Matrix4 projectionAt(const OutputContext &)

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distort_a() has been deprecated, use distortA() instead") double lens_distort_a() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distort_b() has been deprecated, use distortB() instead") double lens_distort_b() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distort_c() has been deprecated, use distortC() instead") double lens_distort_c() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distort_D() has been deprecated") double lens_distort_D() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distortion() has been deprecated") double lens_distortion() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_power() has been deprecated") double lens_power() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distort_enabled() has been deprecated") bool lens_distort_enabled() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_function(int mode) has been deprecated.") virtual LensFunc *lens_function(int mode) const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lensNfunction(int mode) has been deprecated.") virtual LensNFunc *lensNfunction(int mode) const

	mFnDeprecatedLegacy3DSystemInNuke14 ("to_format has been deprecated, use toFormat instead.") static void to_format(Matrix4 &

const Format *	mFnDeprecatedLegacy3DSystemInNuke14 ("from_format has been deprecated, use fromFormat instead.") static void from_format(Matrix4 &

void	addProjectionFuncCustomKnobs (Knob_Callback)
	For internal use only - called in addProjectionKnobs() to add ProjectionFunc dynamic knobs.

Public Member Functions inherited from DD::Image::AxisOp
	AxisOp (Node *node, int defaultLookAtAxis=LookAt::kAxisZPlus)

const AxisOp *	axisOp () const override
	Cast this Op to an AxisOp. This is much cheaper and safer than using dynamic_cast.

AxisOp *	axisOp () override

AxisOp *	parentInputOp () const
	Convenience that casts parent input 0 to an AxisOp.

int32_t	parentInput () const
	Return the node input to use for the parent axis source. Always defaults to input 0.

bool	can_link () const override

const char *	node_shape () const override
	Draw a circular node shape.

unsigned	node_color () const override

int	minimum_inputs () const override
	Default is 2: axis and scene(optional)

int	maximum_inputs () const override
	Default is 2: axis and scene(optional)

int	optional_input () const override
	Optional input index is the scene-importer input. This returns (maximum_inputs()-1).

bool	test_input (int node_input, Op *op) const override
	AxisOp and null works on 0, and GeomOp or null on input 1.

Op *	default_input (int node_input) const override
	Returns null for all inputs. Override this so Op::test_input() doesn't produce warnings.

const char *	input_label (int node_input, char *) const override

	mFnDeprecatedLegacy3DSystemInNuke14 ("isLegacyAxisOp() has been deprecated, port AxisOp sublass to new Nuke 14 api.") bool isLegacyAxisOp() const

Op *	getSceneLoaderOp () override
	SceneLoaderOpI: Return the Op the interface is attached to.

AxisOp *	asAxisLoaderOp () override
	SceneLoaderOpI: If loader is attached to an AxisOp subclass return 'this'.

int32_t	sceneLoaderSourceInput () const override
	SceneLoaderOpI: Return the node input to use for the scene importer. Default returns optional_input().

GeomOp *	sceneInputOp () const
	Convenience that casts input sceneImporterInput() to a GeomOp.

int32_t	importScenePrim (const usg::StageRef &stage, const std::string &primPath) override

Op *	getGeometryProviderOp () override
	GeometryProviderI: Return the Op the interface is attached to.

GeometryProviderI *	asGeometryProvider () override
	GeometryProviderI: Allow subclasses to gain access to sibling functions.

GeometryProviderI *	geometryProvider () override
	Cast to a GeometryProviderI interface. This is much cheaper and safer than using dynamic_cast.

const GeometryProviderI *	geometryProvider () const override

Op *	getScenePrimExporterOp () override
	ScenePrimExporterOpI: Return the Op the interface is attached to.

ScenePrimExporterOpI *	asScenePrimExporter () override
	ScenePrimExporterOpI: Allow subclasses to gain access to sibling functions.

ScenePrimExporterOpI *	scenePrimExporterOpI () override
	Cast to a ScenePrimExporterOpI interface. This is much cheaper and safer than using dynamic_cast.

const ScenePrimExporterOpI *	scenePrimExporterOpI () const override

usg::Path	exportBasePrimPath () const override
	ScenePrimExporterOpI: Prepends the parent connection if there is one.

int32_t	exportBasePrimType () const override

void	knobs (Knob_Callback f) override

void	createAxisOpKnobs (Knob_Callback f, bool openImportGroup, bool openExportGroup, const std::string &primFilters="")
	Create the Axis Op Knobs and set a custom prim filter to use on the import popup.

int	knob_changed (Knob *k) override

virtual void	addDisplayOptionsKnobs (Knob_Callback f)
	Adds the OpenGL display option controls.

virtual void	addLocalParentingKnobs (Knob_Callback f, bool addSyncOptions=true)

virtual void	addLocalXformKnobs (Knob_Callback f, bool addSyncOptions=true)

virtual void	addTransformKnobs (Knob_Callback f, bool addSyncOptions=true)

virtual void	addImportOptionsKnobs (Knob_Callback f, const std::string &primFilters="")

void	addExportOptionsKnobs (Knob_Callback f) override
	Adds the prim export option knobs.

virtual void	addExtraFrontPanelKnobs (Knob_Callback f)
	Adds addl front-panel knobs. Called after addTransformKnobs(). Base class adds nothing.

Axis_KnobI *	getAxis ()
	Return internal 'transform' Axis_Knob for set/get internal transformation.

void	enableAxisKnobs (bool on)

void	enableKnobs (const std::vector< std::string > &knobNames, bool on)

void	enableSceneLoaderKnobs (bool importEnabled) override
	SceneLoaderOpI: Enable/disable knobs filled in by the scene importer.

void	enableSceneLoaderExtraKnobs (bool importEnabled) override

void	enableXformExtractKnobs (bool xformExtractEnabled) override
	SceneLoaderOpI: Enable/disable knobs filled in by the xform decomposer.

void	enableExportOptionsKnobs (bool exportEnabled) override
	ScenePrimExporterOpI: Enable/disable knobs filled in by the scene prim exporter.

void	_validate (bool for_real) override

const fdk::Mat4d &	inputParentTransform () const

const fdk::Mat4d &	localParentTransform () const
	Result of the local-parent TRS knobs, if enabled. Calculated in _validate().

const fdk::Mat4d &	localAxisTransform () const
	Result of the local-axis TRS Axis_Knob (without lookat rotations.) Calculated in knobs().

const fdk::Mat4d &	parentTransform () const
	Parent transform containing the input-parent and local-parent. Calculated in _validate().

const fdk::Mat4d &	localTransform () const
	Local object transform containing the local-axis TRS Axis_Knob with lookat rotations. Calculated in _validate().

const fdk::Mat4d &	worldTransform () const
	World transform containing the input-parent, local-parent, local-axis, and lookat. Calculated in _validate().

const fdk::Mat4d &	invWorldTransform ()

virtual fdk::Mat4d	worldTransformAt (const OutputContext &context) const

void	setWorldTransform (const fdk::Mat4d &)

int	display3d () const

int	display3d ()

void	setDisplay3d (int mode)

bool	selectable () const

void	setSelectable (bool v)

bool	editable () const

void	setEditable (bool v)

virtual bool	isGuiInteractive (Axis_KnobI::Transformation knob) const
	Return true if a particular knob transformation is modifiable by user interaction in gui.

HandlesMode	doAnyHandles (ViewerContext *) override

void	build_handles (ViewerContext *) override

void	draw_handle (ViewerContext *) override

	mFnDeprecatedLegacy3DSystemInNuke14 ("Class() has been deprecated, implement on subclass plugin instead.") const char *Class() const override

	mFnDeprecatedLegacy3DSystemInNuke14 ("node_help() has been deprecated, implement on subclass plugin instead.") const char *node_help() const override

	mFnDeprecatedLegacy3DSystemInNuke14 ("selectable(bool mode) has been deprecated, use setSelectable() instead.") void selectable(bool v)

	mFnDeprecatedLegacy3DSystemInNuke14 ("display3d(int mode) has been deprecated, use setDisplay3d() instead.") void display3d(int mode)

	mFnDeprecatedLegacy3DSystemInNuke14 ("input0() has been deprecated, use parentInput() instead.") AxisOp *input0() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lookAtEnabled() has been deprecated") virtual bool lookAtEnabled() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("lookat_input() has been deprecated") Op *lookat_input() const override

	mFnDeprecatedLegacy3DSystemInNuke14 ("matrix(const Matrix4&) has been deprecated, use setWorldTransform() instead.") void matrix(const Matrix4 &)

	mFnDeprecatedLegacy3DSystemInNuke14 ("local() has been deprecated, use localTransform() instead.") const Matrix4 &local() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("matrix() has been deprecated, use worldTransform() instead.") const Matrix4 &matrix() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("imatrix() has been deprecated, use invWorldTransform() instead.") const Matrix4 &imatrix()

	mFnDeprecatedLegacy3DSystemInNuke14 ("matrixAt() has been deprecated, use worldTransformAt() instead.") virtual void matrixAt(const OutputContext &

Public Member Functions inherited from DD::Image::Op
PrevalidateResult	preValidate (ViewerContext ctx=nullptr, PreValidateContext =nullptr)

Op *	rootOp () const

bool	preValidateAborted (int treeStartingVersion, PrevalidateResult &result) const

const OutputSet &	getOutputs () const
	return all the outputs of this node

virtual void	setInputsValid (bool nowValid)
	set whether the input ops are valid (are for the right context)

bool	inputsValid () const
	return whether the input ops are valid (are for the right context)

virtual bool	can_clone () const
	returns whether or not an op can be cloned in the dag

virtual bool	can_link () const
	returns whether or not an op can be linked in the dag

bool	haveHash () const
	return true if the hash() value is meaningful and globally unique

bool	varyingOutputHash () const

void	setVaryingOutputHash (bool varyingHashes)
	Set the varyingOutputHash indicator to a specific state.

void	enableVaryingOutputHash ()
	Enable the varyingOutputHash indicator.

virtual Hash	editState () const

virtual void	setEditState (const Hash &h)

virtual std::vector< DD::Image::OutputContext >	getPrevVersionsWanted () const

virtual const MetaData::Bundle &	_fetchMetaData (const char *keyname)

const MetaData::Bundle &	fetchMetaData (const char *keyname)

Node *	node () const

DD::Image::NodeI *	getNode () const

void	node (Node *v)

const char *	nodeName () const
	Return NodeI::name() which is the Node's local name with no parent path.

std::string	nodeFullPath (char separator='.') const

Hash	nodeTopologyHash () const

Op *	firstOp () const

void	firstOp (Op *v)

Op *	parent () const

void	parent (Op *lpOp)

virtual void	detach ()
	node has been deleted in DAG

virtual void	attach ()
	node has been created in DAG

virtual void	pre_write_knobs ()

void	knobStorePrep (const OutputContext &opStoreContext)

virtual void	knobs (Knob_Callback)

void	knobStorePost (const OutputContext &opStoreContext, Hash &opHash)

int	replace_knobs (Knob afterthis, int n, void(f)(void , Knob_Callback), void , const char *fileExt=nullptr)

int	add_knobs (void(f)(void , Knob_Callback), void *, Knob_Callback)

void	set_unlicensed ()

Knob *	knob (const char *name) const

Knob *	knob (int) const

bool	pushed () const

bool	panel_visible () const

bool	node_disabled () const

bool	node_selected () const

unsigned	node_gl_color () const

void *	field (const char *name)

void *	field (const char *name, int &type)

void *	set_field (const char name, const void source, int size)

void *	get_field (const char name, void dest, int size)

void	beginHandle (HandleType command, ViewerContext ctx, EventCallback cb, int index, float x=0, float y=0, float z=0, ViewerContext::Cursor cursor=ViewerContext::kNoCursor)

void	endHandle (ViewerContext *ctx)

virtual int	knob_changed (Knob *)

virtual int	knob_change_finished (Knob *knob, bool changedByUser=true)

void	addTime (OpTimer::Category category, long long microsecondsCPU, long long microsecondsWall, bool isTopLevel=true)

void	getPerformanceInfo (OpTimer::Category category, OpTimer::PerformanceInfo &info) const
	return the amount of CPU time taken by this op

virtual bool	inputs_clockwise () const
	whether unconnected inputs on the DAG should be arranged clockwise or anticlockwise (default)

virtual std::vector< int >	input_order () const

virtual int	inputArrows (int nodeInputs) const

bool	script_command (const char *command, bool py=true, bool eval=true) const

bool	script_expand (const char *str) const

HandlesMode	anyHandles (ViewerContext *ctx)

virtual void	build_handles (ViewerContext *)

void	add_draw_handle (ViewerContext *)

virtual void	draw_handle (ViewerContext *)

virtual void	add_input_handle (int input, ViewerContext *)

void	add_op_handle (ViewerContext *ctx)

void	add_knob_handle (Knob , ViewerContext )

virtual int	getViewableModes () const

virtual int	optional_input () const

virtual int	minimum_inputs () const

virtual int	maximum_inputs () const

virtual bool	test_input (int, Op *) const

int	inputs () const

int	node_inputs () const

Op *	node_input (int, GenerateType=OUTPUT_OP) const

Op *	node_input (int, GenerateType, const DD::Image::OutputContext *outputContext) const

Op *	input_op (int n=0) const

virtual void	inputs (int n)

Op *	input (int) const

int	inputNumber (int input, int offset) const

Op *	input (int input, int offset) const

Op *	input0 () const
	return the primary input

Op *	input1 () const
	return the second input, if it exists

const std::vector< Op * > &	getInputs () const

const std::vector< Op * > &	getChildren () const

virtual void	set_input (int i, Op *op, int input, int offset)

void	set_input0 (Op *op)

void	set_input (int i, Op *op)

void	set_input (int i, Op &op)

void	set_input (int input, int offset, Op *op)

const OutputContext &	outputContext () const

virtual void	setOutputContext (const OutputContext &c)

virtual void	append (Hash &)

virtual float	uses_input (int) const

virtual void	build_splits ()

virtual int	split_input (int) const

virtual const OutputContext &	inputContext (int n, int offset, OutputContext &) const

virtual const OutputContext *	inputUIContext (int n, OutputContext &) const

virtual Op *	default_input (int) const

const Hash &	hash () const

virtual bool	frameTransformImplemented () const

virtual bool	frameTransformDownstream (const OutputContext &context, unsigned int input, float inFrame, float &outFrame) const

virtual bool	frameTransformUpstream (const OutputContext &context, unsigned int input, float outFrame, float &inFrame) const

virtual DopeItemFlags::Mask	getDopeItemFlags () const

virtual bool	shouldHideInDopeSheet (Knob *knob) const

virtual DD::Image::Knob *	getDopeItemKnob () const

virtual ViewSet	viewsProduced () const

virtual ViewSet	viewsWantOn (int i) const

virtual ViewSet	splitForViews () const

bool	requested () const

void	setRequested ()

void	forgetRequestShallow ()

void	forget_request ()

void	forget_request (OpSet &forgotten)

virtual const char *	node_shape () const

DD::Image::Hash	curveHash () const

bool	opCurrent () const

virtual unsigned	node_color () const

virtual const char *	node_help () const =0

virtual const char *	input_label (int, char *) const

virtual std::string	input_longlabel (int) const

void	node_redraw ()

void	print_name (std::ostream &o) const

NodeContext	nodeContext () const

std::string	node_name () const
	Returns the same string as printed by print_name(ostream).

void	invalidateSameHash ()

bool	invalidate ()

bool	invalidate (const Hash &hash)

bool	update (const Box *=nullptr)

void	asapUpdate ()

void	asapUpdate (const Box &box, int direction=0)

void	validate (bool for_real=true)

virtual void	force_validate (bool for_real=true)

void	update_handles () const

bool	valid () const
	Returns true if it has been validated - including if there was an error.

bool	real_valid () const
	Returns true if it has been real-validated - including if there was an error.

bool	inErrorState () const

bool	inInvalidState () const

bool	opened () const

void	open ()

void	unopen ()

bool	running () const

void	running (bool v)

bool	not_closed () const

void	close ()

void	callCloseAfter (double seconds)

void	copyState (Op *input)

bool	cached () const

void	cached (bool b)

virtual bool	inUse () const

virtual Executable *	executable ()

void	setKnobsToContext (const OutputContext &, bool force=false)

void	gotoContext (const OutputContext &, bool update)

void	progressFraction (double fraction, StatusFlags flags=StatusNone)

void	progressFraction (int a, int b, StatusFlags flags=StatusNone)

void	progressMessage (const char *fmt,...)

void	progressModalMessage (const char *fmt,...)

void	progressDismiss ()

int	slowness () const

void	slowness (int newval)

virtual bool	firstEngineRendersWholeRequest () const

virtual bool	updateUI (const OutputContext &context)

const Format &	input_format () const

const OutputContext &	uiContext () const

void	error (const char *fmt,...)

void	warning (const char *fmt,...)

void	critical (const char *fmt,...)

void	debug (const char *fmt,...)

void	abort () const
	Abort all trees the op is in.

bool	aborted () const
	True if one of the trees the op is in was aborted; ops should check this while processing and return quickly when true.

void	cancel () const
	Cancel all trees the op is in. Make sure you also call abort() to stop processing.

bool	cancelled () const
	True if one of the trees the op is in was cancelled (by user interaction)

bool	addToTree (OpTree *lpTree)
	Returns true if the op was added to the tree, or false if its reference count increased.

bool	removeFromTree (OpTree *lpTree)
	Returns false if the op was removed from the tree, or true if its reference count decreased.

bool	isInTree (OpTree *lpTree) const
	Checks if an op is in a particular tree, for debugging purposes.

bool	isInAnyTree () const
	Checks if an op is in any tree at all.

OpTreeHandler *	getTreeHandler () const
	Returns the treeHandler for a given Op.

bool	hasError () const

bool	opOrChildHasError () const

const Op *	getErroredOp () const

void	setPopUpScheme (PopUpScheme lScheme)

PopUpScheme	getPopUpScheme () const

bool	arePopUpsEnabled ()
	Returns whether a pop-up should be enabled for the next message, modifying internal data when necessary.

OpMessageHandler &	getMsgHandler ()

const OpMessageHandler &	getMsgHandler () const

std::string	getDebugInfo () const
	Returns a string of debug information about the op. For internal use.

std::string	getDetailedDebugInfo () const

bool	tryValidate (bool for_real=true)

virtual Iop *	iop ()
	Cast to an Iop. This is much cheaper and safer than using dynamic_cast.

virtual const Iop *	iop () const

virtual ParticleOp *	particleOp ()
	Cast to a ParticleOp. This is much cheaper and safer than using dynamic_cast.

virtual const ParticleOp *	particleOp () const

virtual DeepOnlyOp *	deepOnlyOp ()
	Cast to a DeepOnlyOp. This is much cheaper and safer than using dynamic_cast.

virtual const DeepOnlyOp *	deepOnlyOp () const

virtual AxisOp *	axisOp ()
	Cast to an AxisOp. This is much cheaper and safer than using dynamic_cast.

virtual const AxisOp *	axisOp () const

virtual CameraOp *	cameraOp ()
	Cast to an CameraOp. This is much cheaper and safer than using dynamic_cast.

virtual const CameraOp *	cameraOp () const

virtual LightOp *	lightOp ()
	Cast to an LightOp. This is much cheaper and safer than using dynamic_cast.

virtual const LightOp *	lightOp () const

virtual GeometryProviderI *	geometryProvider ()
	Cast to a GeometryProviderI, if Op has that interface.

virtual const GeometryProviderI *	geometryProvider () const

virtual GeoOp *	geoOp ()
	Cast to a GeoOp. This is much cheaper and safer than using dynamic_cast.

virtual const GeoOp *	geoOp () const

virtual GeomOp *	geomOp ()
	Cast to a GeomOp. This is much cheaper and safer than using dynamic_cast.

virtual const GeomOp *	geomOp () const

virtual ScenePrimExporterOpI *	scenePrimExporterOpI ()
	Cast to a ScenePrimExporterOpI, if Op has that interface.

virtual const ScenePrimExporterOpI *	scenePrimExporterOpI () const

virtual std::string	getLibraryName () const
	Return a label and version string to display library version info for the Node.

virtual VersionInfo	getLibraryVersion () const

virtual OpHints	opHints () const
	Return hints to control when and how this op will be evaluated by the top-down system.

virtual bool	resolveKnobAsset (Knob *knob, const std::string &assetPath, std::string &resolvedAssetPath)

virtual bool	updateKnobsFromAsset (Knob *knob)

virtual void	_updateKnobsFromAsset (Knob *assetKnob, const ndk::asset::AssetData &assetData)

virtual const char *	Class () const =0

const std::string	libraryDisplayName () const

virtual const char *	displayName () const

virtual std::string	docsPath () const

virtual bool	onAction (const ViewerContext c, const DD::Image::Flags f, void d)

Op *	get (const Description *description)

Public Member Functions inherited from DD::Image::SceneLoaderOpI
	SceneLoaderOpI (bool importEnabled=false)

virtual Op *	getSceneLoaderOp ()=0
	Return the Op the interface is attached to. Should return 'this'. Must implement.

virtual SceneLoaderOpI *	asSceneLoader ()
	Allow subclasses to gain access to sibling functions.

virtual bool	isSceneLoaderEnabled ()
	Is loader enabled? Base class returns the state of the 'import_enabled' knob.

virtual int32_t	sceneLoaderSourceInput () const

virtual const char *	defaultSceneLoaderPrimType ()
	Return the scene prim type to use when searching for a default to load - ie 'Camera', 'Xform', etc.

virtual AxisOp *	asAxisLoaderOp ()
	If loader is attached to an AxisOp subclass return 'this'. Default returns nullptr.

virtual CameraOp *	asCameraLoaderOp ()
	If loader is attached to a CameraOp subclass return 'this'. Default returns nullptr.

virtual LightOp *	asLightLoaderOp ()
	If loader is attached to a LightOp subclass return 'this'. Default returns nullptr.

virtual Iop *	asGeomLoaderIop ()
	If loader is attached to an Iop subclass return 'this'. Default returns nullptr.

virtual void	addSceneLoaderKnobs (Knob_Callback f, const std::string &filters, bool addTimeOption, bool addXformOptions=false)

virtual void	addSceneLoaderTimeOptionKnobs (Knob_Callback f)
	Add time control knobs.

virtual void	addSceneLoaderXformOptionKnobs (Knob_Callback f)
	Add xform decomposition control knobs.

virtual void	enableSceneLoaderKnobs (bool importEnabled)
	Enable/disable knobs filled in by the scene importer.

virtual void	enableSceneLoaderExtraKnobs (bool importEnabled)

virtual void	enableXformExtractKnobs (bool xformExtractEnabled)
	Enable/disable knobs filled in by the xform decomposer.

int32_t	updateScenePrim (bool force=false)

virtual int32_t	importScenePrim (const usg::StageRef &stage, const std::string &primPath)=0

template<typename T >
size_t	getAttribValuesTimeWarped (const usg::Attribute &attr, double attr_fps, fdk::TimeValueList &times, std::vector< T > &values) const

template<typename T >
bool	copyAttribToKnobTimeWarped (const usg::Attribute &attr, double attr_fps, Knob *knob, bool force_keys, int32_t channel_start_offset, int32_t view) const

fdk::TimeValueList	getOutputSampleTimes (const fdk::TimeValueList &input_times, double input_fps=0.0) const

Public Member Functions inherited from DD::Image::ScenePrimExporterOpI
	ScenePrimExporterOpI ()
	Sets parent fill type to Xform(0).

virtual Op *	getScenePrimExporterOp ()=0
	Return the Op the interface is attached to. Should return 'this'. Must implement.

Op *	getScenePrimExporterOp () const

virtual ScenePrimExporterOpI *	asScenePrimExporter ()
	Allow subclasses to gain access to sibling functions.

virtual void	addExportOptionsKnobs (Knob_Callback f)

virtual void	enableExportOptionsKnobs (bool exportEnabled)

std::string	exportPrimPath () const
	Return the value of the 'prim_path' knob.

int32_t	exportParentPrimMode () const
	Return the mode value of the 'parent_prim_type' knob.

virtual usg::Path	exportBasePrimPath () const =0

virtual int32_t	exportBasePrimType () const =0

void	buildParentPrims (usg::LayerRef &exportLayer) const

usg::LayerRef	exportScenePrims (int32_t exportMode, const fdk::TimeValueSet &additionalTimes=fdk::TimeValueSet(), bool force=false)

void	exportScenePrimsToLayer (usg::LayerRef &exportLayer, int32_t exportMode, const fdk::FrameValueSet &sampleFrames)

void	KnobDefinesExportedGeometry (const Knob_Closure &f)

void	KnobModifiesExportedAttribValues (const Knob_Closure &f)

virtual void	appendExporterGeomState (DD::Image::Hash &opStoreHash)

Op *	getGeometryProviderOp () override
	GeometryProviderI: Return the Op the interface is attached to.

GeometryProviderI *	asGeometryProvider () override
	GeometryProviderI: Allow subclasses to gain access to sibling functions.

fdk::Hash	geometryComposeState () const override
	Returns the compose state of the exportLayer.

fdk::Hash	geometryEditState () const override
	Returns the edit state of the exportLayer.

bool	geometryStateVaries () const override
	Returns the animating state of the exportLayer.

usg::LayerRef	getGeometryLayer (const fdk::TimeValueSet &sampleTimes=fdk::TimeValueSet()) override

bool	canProvideGeometryStage () const override
	Provides a fully constructed usg::Stage via buildGeometryStage().

void	buildGeometryStage (usg::StageRef &stage, const usg::ArgSet &requestArgs, const fdk::TimeValueSet &sampleTimes=fdk::TimeValueSet()) override

Public Member Functions inherited from DD::Image::GeometryProviderI
virtual GeometryProviderI *	asGeometryProvider ()=0

virtual Op *	getGeometryProviderOp ()=0

Op *	getGeometryProviderOp () const
	Same as getGeometryProviderOp() but const.

virtual fdk::Hash	geometryComposeState () const =0

virtual fdk::Hash	geometryEditState () const =0

virtual bool	geometryStateVaries () const =0

virtual usg::LayerRef	buildGeometryLayer (bool appendTo=false, const fdk::TimeValueSet &sampleTimes=fdk::TimeValueSet())=0

virtual usg::LayerRef	getGeometryLayer (const fdk::TimeValueSet &sampleTimes=fdk::TimeValueSet())

virtual bool	canProvideGeometryStage () const

virtual void	buildGeometryStage (usg::StageRef &stage, const usg::ArgSet &requestArgs, const fdk::TimeValueSet &sampleTimes=fdk::TimeValueSet())

virtual usg::StageRef	getGeometryStage (const fdk::TimeValueSet &sampleTimes=fdk::TimeValueSet())

Public Member Functions inherited from DD::Image::LookAt
	LookAt (int defaultLookAxis=kAxisZPlus)

virtual Op *	lookat_input () const =0
	The lookat input op.

void	knobs (Knob_Callback f)
	Adds the 'Look' tab and knobs for all the look at options.

int	knobChanged (Op parent, Knob k)
	disables the look at input is not present

void	lookAt (Matrix4 &matrix)
	performs the look at on the incoming matrix

void	lookMatrixAt (const OutputContext &oc, Matrix4 &concatMatrix)
	performs the look at on the incoming matrix for a given context

Public Member Functions inherited from DD::Image::MaterialOpI
virtual Op *	getOp ()
	Return the Op this interface is attached to. Should return 'this'.

virtual void	setOverrideOp (Op *)

virtual void	clearOverrideOp ()
	Disable any assigned override Op.

virtual Op *	getOverrideOp () const
	Return the override Op used for shader property value updating.

virtual usg::TokenArray	getAppliedApiSchemas () const
	Returns a list of API's this output shader must implement.

virtual const char *	getOutputSchema () const

virtual int32_t	getOutputType () const

bool	isCoShader () const
	Convenience to check output type.

bool	isSurfaceShader () const

bool	isLightShader () const

bool	isVolumeShader () const

virtual std::string	getShaderNodeName (const usg::Token &target_renderer=usg::Token())

virtual int32_t	connectionTypeForNodeInput (int32_t node_input) const

virtual usg::ShaderDesc *	createShaderGraph (int32_t output_type, const MaterialContext &rtx, usg::ShaderDescGroup &shader_group)

virtual usg::ShaderDesc *	createShaderGraphFromOp (Op *input_op, const MaterialContext &rtx, usg::ShaderDescGroup &shader_group)

virtual void	updateShaderGraphOverrides (int32_t output_type, const MaterialContext &rtx, usg::ShaderDescGroup &shader_group)

virtual void	updateShaderGraphFromOp (Op *input_op, const MaterialContext &rtx, usg::ShaderDescGroup &shader_group)

Protected Attributes
double	_coneAngleNotClamp

double	_conePenumbraAngleNotClamp

double	_coneFalloffNotClamp

float	_coneAngle

float	_conePenumbraAngle

float	_coneFalloff

float	_coneOuterCos

float	_iconeCos

float	_coneInnerCos

int	_lightType

double	_intensityScale

Protected Attributes inherited from DD::Image::LightOp
union {
Pixel _color
	Color of the light (can be >3 channels!)

};

union {
double _intensity
	Global intensity.

};

union {
bool _castShadows
	Whether light casts shadows.

};

bool	_enableColorTemperature
	Enables color temperature.

double	_colorTemperature
	Color temperature in Kelvin.

double	_exposure
	Power multiplier for the light (2^exposure_ * power)

bool	_normalize
	Disable area gain compensation.

double	_diffuse
	Difuse multiplier.

double	_specular
	Specular multiplier.

Channel	_shadowMaskChannel
	Output the shadow mask to this channel.

Protected Attributes inherited from DD::Image::CameraOp
int32_t	_projectionSelection
	Projection menu knob index.

ShutterControls	_shutter
	Shutter controls which may be referenced by a renderer.

double	_shutterBias
	Weights the shutter samples towards shutter close with a power function.

bool	_glWorldSizeIcon
	Always draw the camera icon at the 'real' world size (defined by worldToLens factor)

bool	_glSolidFrustum
	Draw the camera frustum as solid.

bool	_glInsideFrustum
	Indicated whether to draw the frustum as an inside or outside box.

Protected Attributes inherited from DD::Image::AxisOp
bool	_parentExtractEnable
	Split the parent xform out from the local.

bool	_syncLocalParent
	Local-parent read lock.

bool	_syncLocalAxis
	Local-axis read lock.

fdk::Vec3d	_localParentTranslate
	Local-parent translation knob value.

fdk::Vec3d	_localParentRotate
	Local-parent rotate knob value.

fdk::Vec3d	_localParentScale
	Local-parent scale knob value.

fdk::Mat4d	_localParentMatrix
	Parent transform derived from local parent TRS knobs.

fdk::Mat4d	_localAxisMatrix
	Local matrix that Axis_Knob fills in (no lookat rotations)

ndk::XformParameters	_xformParams
	Axis xform params.

DD::Image::Hash	_parentHash
	Does parent path or transform need to be updated?

union {
bool _xformInversionValid
	Is _xformParams.w2l valid?

};

union {
Axis_KnobI * _axisKnob
	Reference to the node Axis_Knob.

};

WorldMatrixProvider *	_worldMatrixProvider
	'world_matrix' output knob

Knob *	_localParentTranslateKnob
	If not null apply parent_translate.

Knob *	_localParentRotateKnob
	If not null apply parent_rotate.

Knob *	_localParentScaleKnob
	If not null apply parent_scale.

int	display3d_
	GUI display setting - deprecate or translate to new system?

bool	selectable_
	GUI selectable checkmark - deprecate or translate to new system?

bool	_editable
	Can the user change the knobs? (i.e. knobs not disabled)

SnapKnobs	_snapKnobs

Protected Attributes inherited from DD::Image::Op
bool	_haveHash
	whether the _hash actually has been set by a call to invalidate(Hash) ever.

bool	_varyingOutputHash
	whether the hash value will animate over time

Hash	_editState
	Op's current edit state, usually the combination of input & knob edit states.

Protected Attributes inherited from DD::Image::SceneLoaderOpI
ImporterControls	_importer
	Scene prim importer controls & state.

bool	_importerEnabled
	If true importer will extract prim attributes from scene source.

bool	_importerInvalid
	If true any knobs set by the importer need to be re-stored.

Protected Attributes inherited from DD::Image::ScenePrimExporterOpI
std::unique_ptr< Impl >	_pImpl

Protected Attributes inherited from DD::Image::LookAt
Matrix4	lookat_matrix_
	Matrix for rotating to look at the look input.

Matrix4	my_local
	For the Axis_Knob to store into.

bool	my_transform_normals

int	my_lookat_axis

bool	my_rotate_x

bool	my_rotate_y

bool	my_rotate_z

bool	my_lookat_use_quat

double	my_lookat_strength

Additional Inherited Members
Public Types inherited from DD::Image::CameraOp
typedef void()	LensFunc(Scene , CameraOp , MatrixArray transforms, const VArray &v, Vector4 &out, void data)

typedef void()	LensNFunc(Scene , CameraOp , MatrixArray transforms, VArray vert_array, int n, void *data)

Public Types inherited from DD::Image::Op
enum	HandlesMode { eNoHandles , eHandlesUncooked , eHandlesCooked , eHandlesMax }

enum	PrevalidateResult { eFinished , eCancelled , eAbandoned }
	This is a tribool return value. Do not extend.

enum	HandleType { eNone , eMouseLeftClick , eMouseRightClick , eMouseMove , eMouseDrag , eMouseRelease , eSelectionChanged , eSelectionChangeFinished , eHandleDragTranslate , eHandleDragRotate , eHandleDragScale , eHandleDragPivot , eAllHandles }

enum	ViewableModes { eViewableMode2D , eViewableMode3D , eViewableMode3D_2DReference }

enum	GenerateType { OUTPUT_OP , ANY_CONTEXT , INPUT_OP , INPUT_OP_PEEK , EXECUTABLE , EXECUTABLE_SKIP , EXECUTABLE_INPUT , UICONTEXT_ONLY }

enum	NodeContext { eNodeGraph , eTimeline , eOpGraph }

enum	StatusFlags { StatusNone , StatusModal , StatusUseCallback }

enum	PopUpScheme { ePU_Never , ePU_Done , ePU_Once , ePU_Default , ePU_Always }
	Pop-up schemes determine when pop-up messages are displayed for op errors. More...

enum	VersionComponents { eMajor , eMinor , ePoint , eRevision }
	Enum to help get the desired version component from the VersionInfo tuple.

typedef std::pair< int, DD::Image::Op * >	Output
	Combination of input number and pointer to Op.

typedef std::set< Output >	OutputSet
	Set of all outputs from this Op.

typedef std::map< Hash, std::vector< unsigned int > >	ItemSelectionList

typedef bool()	EventCallback(Op *op, EventContext eventCtx)

using	VersionInfo = std::tuple< int, int, int, int >
	Contains version components with each index defined by the VersionComponents enum.

Public Types inherited from DD::Image::ScenePrimExporterOpI
enum	{ EXPORT_SAMPLE_ALL_SCRIPT_FRAMES , EXPORT_ADDL_TIMES , EXPORT_SAMPLE_KEYFRAMES }
	Export sampling modes. More...

enum	{ EXPORT_PARENT_XFORM , EXPORT_PARENT_SCOPE , EXPORT_PARENT_PLACEHOLDER_OVERRIDE , EXPORT_PARENT_IGNORE }
	Modes for building additional parent prims specified in 'prim_path'.

Public Types inherited from DD::Image::MaterialOpI
enum	{ INPUT_TYPE_NONE , INPUT_TYPE_OP , INPUT_TYPE_MATERIALOP , INPUT_TYPE_COSHADEROP , INPUT_TYPE_TEXTUREOP , INPUT_TYPE_AXISOP , INPUT_TYPE_CAMERAOP , INPUT_TYPE_LIGHTOP }

enum	{ OUTPUT_TYPE_NONE , OUTPUT_TYPE_COSHADER , OUTPUT_TYPE_SURFACESHADER , OUTPUT_TYPE_LIGHTSHADER , OUTPUT_TYPE_VOLUMESHADER }

Static Public Member Functions inherited from DD::Image::CameraOp
static CameraOp *	default_camera ()

static void	toFormat (fdk::Mat4f &, const Format *)

static void	fromFormat (fdk::Mat4f &, const Format *)

Static Public Member Functions inherited from DD::Image::Op
static int	treeVersion ()

static bool	nukeBusy ()
	is nuke processing something on a parallel thread?

static Op *	create (Node node, const char name, Op *p_op)

static Op *	create (const char name, Op p_op)

static void	resetTimers ()
	reset all the performance timers

static void	setTimingEnabled (bool enabled)
	turn performance timing on or off

static bool	isTimingEnabled ()
	return whether performance timing is on or not

static const char *	script_result (bool py=false)

static void	script_unlock ()

static Op *	retrieveOp (const char node_path, GenerateType generate_op_type, const OutputContext generate_op_context=nullptr)

static Op *	retrieveOp (const char *node_path, const Hash &op_hash, int tree_version)

static void	all_forget_request ()

static void	new_request_pass ()

static double	callPendingClose (double seconds)

static void	clearPendingClose ()

static Op *	error_op ()

static const char *	error_message ()

static void	clearAbortAndError ()
	To be removed.

static void	SetDefaultPopUpEnable (bool lEnable)
	This is used by Nuke to indicate when ops using the default pop-up scheme should show pop-ups. Not recommended for customisation.

static std::string	getVersionInfoStr (const VersionInfo &versionInfo)
	Helper function to convert a VersionInfo tuple into a string.

static const Description *	find_description (const char name, const Op op_)

static int	message_f (char t, const char *,...)

static int	message_vf (char t, const char *, va_list)

static void	add_timeout (float t, TimeoutHandler, void *v=nullptr)

static void	repeat_timeout (float t, TimeoutHandler, void *=nullptr)

static bool	has_timeout (TimeoutHandler, void *=nullptr)

static void	remove_timeout (TimeoutHandler, void *=nullptr)

Static Public Member Functions inherited from DD::Image::GeometryProviderI
static void	buildStage (usg::StageRef &stage, const usg::ArgSet &requestArgs, const OpSet &ops, const fdk::TimeValueSet *additionalTimes=nullptr)

static void	buildStage (usg::StageRef &stage, const usg::ArgSet &requestArgs, Op geometryProviderOp, const fdk::TimeValueSet additionalTimes=nullptr)

Static Public Member Functions inherited from DD::Image::MaterialOpI
static std::string	getNodeInstanceSuffix (DD::Image::Op *op)

static std::string	buildName (const std::string &node_name, const char *schema_name)
	Convenience function builds a standard shader name with '<node_name>_<schema_name>'.

static std::string	buildName (const usg::Token &target_renderer, const std::string &node_name, const char *schema_name)
	Convenience function builds a standard shader name with '<target_renderer>_<node_name>_<schema_name>'.

static int32_t	getShaderTypeFromOp (Op *op)

static std::string	getShaderNodeNameFromOp (const usg::Token &target_renderer, Op *op)

static const char *	inputShaderTypeName (int32_t op_type)

static const char *	removePrefix (const char *property_name)

static usg::ShaderDesc *	createOpInterfaceShaderDesc (int32_t op_type, Op *op)

static usg::ShaderDesc *	createOpInterfaceShaderDesc (Op *op)

static std::string	buildAssetPath (Op *input_op)

static bool	parseAssetPath (const std::string &path, std::string &nodePath, OutputContext &outputContext)

static Op *	retrieveOpFromAssetPath (const std::string &path, OutputContext *outputContext=nullptr)

Public Attributes inherited from DD::Image::LightOp
int	count

const Vector3 &	surfP

const Vector3 const Vector3 &	lobeN

const Vector3 const Vector3 Vector3 &	L

const Vector3 const Vector3 Vector3 float &D	const

const Vector3 const Vector3 const Vector3 &	L

const Vector3 const Vector3 const Vector3 float	D

const Vector3 const Vector3 const Vector3 float Pixel &	out

const VertexContext &	vtx

const VertexContext const Vector3 &	surfP

const VertexContext const Vector3 Pixel &	out

Public Attributes inherited from DD::Image::AxisOp
Matrix4 &	const

Public Attributes inherited from DD::Image::Op
const MetaData::Bundle *	metaCache

Hash	metaCacheHash

Static Public Attributes inherited from DD::Image::CameraOp
static const char *	projection_modes []

static const char *	projection_modes_renderer []

Static Public Attributes inherited from DD::Image::Op
static unsigned	current_request_pass

static void(*	node_redraw_cb )(const Op *)

static void(*	print_name_cb )(std::ostream &, const Op *)

static void(*	status_callback )(const Op , float, float, const char , StatusFlags)

static const int	kInvalidVersion

static const VersionInfo	kUnsetVersion

Protected Types inherited from DD::Image::LookAt
enum	{ kAxisZPlus , kAxisZMinus , kAxisYPlus , kAxisYMinus , kAxisXPlus , kAxisXMinus }

Protected Member Functions inherited from DD::Image::LightOp
	mFnDeprecatedLegacy3DSystemInNuke14 ("falloff_ has been deprecated.") bool falloff_
	Whether to factor in physical falloff.

	mFnDeprecatedLegacy3DSystemInNuke14 ("falloffType_ has been deprecated.") int falloffType_
	falloff type

	mFnDeprecatedLegacy3DSystemInNuke14 ("samples_ has been deprecated.") int samples_
	The number of samples (for area testing)

	mFnDeprecatedLegacy3DSystemInNuke14 ("sample_width_ has been deprecated.") float sample_width_
	sample width (for shadowing)

	mFnDeprecatedLegacy3DSystemInNuke14 ("shadows_mode_ has been deprecated.") int shadows_mode_
	Shadow casting mode.

	mFnDeprecatedLegacy3DSystemInNuke14 ("shadows_mode_ has been deprecated.") TextureFilter shadow_filter_
	Default filter to use in shadow texture sampling.

	mFnDeprecatedLegacy3DSystemInNuke14 ("scene_epsilon_ has been deprecated.") float scene_epsilon_
	Scene epsilon for shadow comparison.

	mFnDeprecatedLegacy3DSystemInNuke14 ("depthmap_bias_ has been deprecated.") float depthmap_bias_
	Offset in Z of shadow buffer.

	mFnDeprecatedLegacy3DSystemInNuke14 ("depthmap_slope_bias_ has been deprecated.") float depthmap_slope_bias_
	Offset in Z to be scale in proportion of the local gradient.

	mFnDeprecatedLegacy3DSystemInNuke14 ("alpha_threshold_ has been deprecated.") float alpha_threshold_
	Alpha threshold for transparent shadow map mode.

	mFnDeprecatedLegacy3DSystemInNuke14 ("shadow_jitter_scale_ has been deprecated.") float shadow_jitter_scale_
	Size of shadow jitter.

	mFnDeprecatedLegacy3DSystemInNuke14 ("depthmap_width_ has been deprecated.") int depthmap_width_
	Size in pixels of shadow buffer.

void	_exportScenePrims (usg::LayerRef &exportLayer, int32_t exportMode, const fdk::FrameValueSet &sampleFrames=fdk::FrameValueSet()) const override
	ScenePrimExporterOpI: Subclass portion of exportScenePrims().

Protected Member Functions inherited from DD::Image::CameraOp
	mFnDeprecatedLegacy3DSystemInNuke14 ("focal_length_ has been deprecated, use _params.optics.focalLength instead.") double focal_length_
	Deprecated, use _params.optics.focalLength instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("haperture_ has been deprecated, use _params.sensor.apertureSize.x instead.") double haperture_
	Deprecated, use _params.sensor.apertureSize.x instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("vaperture_ has been deprecated, use _params.sensor.apertureSize.y instead.") double vaperture_
	Deprecated, use _params.sensor.apertureSize.y instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("fstop_ has been deprecated, use _params.lensAperture.fStop instead.") double fstop_
	Deprecated, use _params.lensAperture.fStop instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("near_ has been deprecated, use _params.lensAperture.clipNearDistance instead.") double near_
	Deprecated, use _params.lensAperture.clipNearDistance instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("far_ has been deprecated, use _params.lensAperture.clipFarDistance instead.") double far_
	Deprecated, use _params.lensAperture.clipFarDistance instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("projection_mode_ has been deprecated, use projectionMode() instead.") int projection_mode_
	Deprecated, use MultiProjectionCamera::projectionMode() instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("focal_point_ has been deprecated, use _params.optics.focusDistance instead.") double focal_point_
	Deprecated, use _params.optics.focusDistance instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("win_translate_ has been deprecated, use _params.sensor.apertureTranslate instead.") Vector2 win_translate_
	Deprecated, use _params.sensor.apertureTranslate instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("win_scale_ has been deprecated, use _params.sensor.apertureScale instead.") Vector2 win_scale_
	Deprecated, use _params.sensor.apertureScale instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("win_roll_ has been deprecated, use _params.sensor.apertureRotate instead.") double win_roll_
	Deprecated, use _params.sensor.apertureRotate instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distort_a_, use _params.optics.opticalDistortionA instead.") double lens_distort_a_
	Deprecated, use, use _params.optics.opticalDistortionA instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distort_b_, use _params.optics.opticalDistortionB instead.") double lens_distort_b_
	Deprecated, use, use _params.optics.opticalDistortionB instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distort_c_, use _params.optics.opticalDistortionC instead.") double lens_distort_c_
	Deprecated, use, use _params.optics.opticalDistortionC instead.

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distort_D_ has been deprecated") double lens_distort_D_
	Deprecated.

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distortion_ has been deprecated") double lens_distortion_
	Deprecated.

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_power_ has been deprecated") double lens_power_
	Deprecated.

	mFnDeprecatedLegacy3DSystemInNuke14 ("lens_distort_enabled_ has been deprecated") bool lens_distort_enabled_

	mFnDeprecatedLegacy3DSystemInNuke14 ("use_vertical_lock_ has been deprecated") bool use_vertical_lock_
	Deprecated.

virtual usg::Path	exportCameraSchemaPrimPath () const

virtual const char *	exportCameraSchemaTypeName () const

void	_exportScenePrims (usg::LayerRef &exportLayer, int32_t exportMode, const fdk::FrameValueSet &sampleFrames=fdk::FrameValueSet()) const override
	ScenePrimExporterOpI: Subclass portion of exportScenePrims().

	mFnDeprecatedLegacy3DSystemInNuke14 ("projection_ has been deprecated, use Mat4d _projectionMatrix instead.") Matrix4 projection_
	Camera's projection matrix - deprecated.

void	_validateCamera () override

int	_doProjectionFuncKnobChanged (Knob *, int callAgain)
	Called from knob_changed when projection selection is changed via knob interaction.

bool	_setProjectionFuncPlugin (const char *projectionClassName)
	Sets _newProjectionPlugin. _projectionPlugin gets updated in _validate().

Protected Member Functions inherited from DD::Image::AxisOp
void	_updateScenePrim (fdk::Hash &importHash) override
	SceneLoaderOpI: Change the import hash with local vars.

void	_knobStorePrep (const OutputContext &opStoreContext) override

void	_knobStorePost (const OutputContext &opStoreContext, Hash &opHash) override

fdk::Hash	_buildScenePrimExporterState (const fdk::Hash &hash) override
	ScenePrimExporterOpI: If parent is connected include its hashes in the export state.

void	_exportScenePrims (usg::LayerRef &exportLayer, int32_t exportMode, const fdk::FrameValueSet &sampleFrames=fdk::FrameValueSet()) const override
	ScenePrimExporterOpI: Subclass portion of exportScenePrims().

virtual void	_exportTransformOps (usg::XformablePrim &xformable, int32_t exportMode, const fdk::FrameValueSet &sampleFrames=fdk::FrameValueSet()) const

	mFnDeprecatedLegacy3DSystemInNuke14 ("isLegacyAxisOp() has been deprecated, port AxisOp sublass to new Nuke 14 api.") virtual bool _isLegacyAxisOp() const

	mFnDeprecatedLegacy3DSystemInNuke14 ("localtransform_ has been deprecated, use Mat4d _localTransform instead.") Matrix4 localtransform_
	Local 'axis' matrix that Axis_Knob fills in - deprecated.

	mFnDeprecatedLegacy3DSystemInNuke14 ("local_ has been deprecated, use Mat4d _localAxisMatrix instead.") Matrix4 local_
	Local matrix after look at performed - deprecated.

	mFnDeprecatedLegacy3DSystemInNuke14 ("matrix_ has been deprecated, use Mat4d _xformParams.l2w instead.") Matrix4 matrix_
	Object matrix - local&parent - deprecated.

	mFnDeprecatedLegacy3DSystemInNuke14 ("imatrix_ has been deprecated, use Mat4d _xformParams.w2l instead.") Matrix4 imatrix_
	Inverse object matrix - deprecated.

Protected Member Functions inherited from DD::Image::Op
	Op (Node *node)
	The constructor is protected so only subclasses can create the base class.

virtual void	_knobStorePrep (const OutputContext &opStoreContext)
	The subclass-specific portion of knobStorePrep(). See that method for more info.

virtual void	_knobStorePost (const OutputContext &opStoreContext, Hash &opHash)
	The subclass-specific portion of knobStorePost(). See that method for more info.

virtual void	_invalidate ()

virtual void	_validate (bool for_real)

virtual void	_open ()

virtual void	_close ()

Op *	create (Node node, const char name)

Op *	create (const char *name)

HandlesMode	anyInputHandles (ViewerContext *)
	return if any of the inputs (recursively) wish to draw handles

HandlesMode	anyKnobHandles (ViewerContext *)
	return if any of the knobs on this node wish to draw handles

void	build_input_handles (ViewerContext *)

void	build_knob_handles (ViewerContext *)

void	disallowNoTrees ()
	Call this to tell the op that it should always have op trees for normal behaviour (for internal use)

virtual HandlesMode	doAnyHandles (ViewerContext *ctx)

virtual PrevalidateResult	doPreValidate (ViewerContext ctx=nullptr, PreValidateContext =nullptr)

Protected Member Functions inherited from DD::Image::SceneLoaderOpI
virtual void	_loadSceneData (const OutputContext &storeContext, Hash &hash)

virtual int32_t	_sceneLoaderKnobChanged (Knob *k, int32_t callAgain=0)

virtual void	_validateSceneLoader (bool for_real)

virtual void	_updateScenePrim (fdk::Hash &importHash)

Protected Member Functions inherited from DD::Image::ScenePrimExporterOpI
void	_exporterResetScenePrimState (const OutputContext &opStoreContext)

void	_exporterUpdateScenePrimState (const OutputContext &opStoreContext, const DD::Image::Hash &opStoreHash)

virtual fdk::Hash	_buildScenePrimExporterState (const fdk::Hash &hash)

int32_t	_exportScenePrimsKnobChanged (Knob *k, int32_t callAgain)

virtual void	_validateScenePrimExporter (bool for_real)

virtual void	_exportScenePrims (usg::LayerRef &exportLayer, int32_t exportMode, const fdk::FrameValueSet &sampleFrames=fdk::FrameValueSet()) const =0

bool	exportKnob (const char knobName, int32_t exportMode, const fdk::FrameValueSet &sampleFrames, usg::Prim &outputPrim, const char targetPropertyName, usg::Value::Type targetPropertyTypeHint=usg::Value::Type::InvalidType) const

bool	exportKnob (const char knobName, bool ignoreDefaultTest, int32_t exportMode, const fdk::FrameValueSet &sampleFrames, usg::Prim &outputPrim, const char targetPropertyName, usg::Value::Type targetPropertyTypeHint=usg::Value::Type::InvalidType) const

bool	exportInputOpAsAssetPath (int32_t input, int32_t exportMode, const fdk::FrameValueSet &sampleFrames, usg::Prim &outputPrim, const char *targetPropertyName) const
	Export an input Op connection as an asset path, usually for textures.

Impl &	_nodeExporterData () const
	For internal use only - returns the _pImpl from the firstOp which is unique per Node.

usg::ShaderDescGroupPtrMap &	_shaderDescGroups ()
	Groups of locally-created ShaderDescs.

usg::LayerRef	buildGeometryLayer (bool appendTo, const fdk::TimeValueSet &sampleTimes) override
	Calls exportScenePrims() with the appropriate mode.

Protected Member Functions inherited from DD::Image::LookAt
void	perform_lookat (Matrix4 &concatMatrix, const Matrix4 &axisMatrix)

Protected Member Functions inherited from DD::Image::MaterialOpI
virtual bool	overrideShaderDescInput (const char knob_name, const MaterialContext &rtx, usg::ShaderDesc &shader_desc, const char target_property_name, usg::Value::Type target_property_type_hint=usg::Value::Type::InvalidType)

virtual bool	overrideShaderDescInput (const Channel &chan, const MaterialContext &rtx, usg::ShaderDesc &shader_desc, const char *target_property_name)

virtual bool	overrideShaderDescInput (const Channel chan_array, uint32_t num_channels, const MaterialContext &rtx, usg::ShaderDesc &shader_desc, const char target_property_name)

virtual bool	overrideShaderDescInput (const ChannelSet &channels, const MaterialContext &rtx, usg::ShaderDesc &shader_desc, const char *target_property_name)

Static Protected Member Functions inherited from DD::Image::MaterialOpI
static usg::Value	sampleKnobValue (Knob *knob, const fdk::FrameValue &frame, int32_t view, usg::Value::Type value_type_hint)

Static Protected Attributes inherited from DD::Image::LookAt
static const char *const	ms_lookat_axis_choices []

Detailed Description

Light source base class that provides either a point source with falloff (as per LightOp), but also adds the options of a directional light and a spotlight

Member Function Documentation

◆ shade_GL()

void ComplexLightOp::shade_GL	(	ViewerContext *	ctx,
		int	light_num
	)

overridevirtual

This will set the OpenGL lighting settings.

Reimplemented from DD::Image::LightOp.

References DD::Image::Vector3::array(), DD::Image::Vector4::array(), DD::Image::Op::node_disabled(), DD::Image::Vector3::normalize(), DD::Image::Vector4::set(), and DD::Image::Matrix4::transform().

◆ draw_handle()

void ComplexLightOp::draw_handle ( ViewerContext * ctx )

overridevirtual

Draws the light handle.

Reimplemented from DD::Image::CameraOp.

References DD::Image::Matrix4::array(), DD::Image::ViewerContext::draw_knobs(), DD::Image::ViewerContext::fg_color(), DD::Image::gl_sphere(), DD::Image::gl_text(), DD::Image::glColor(), DD::Image::ViewerContext::hit_detect(), DD::Image::ViewerContext::icon_size(), DD::Image::ViewerContext::modelmatrix, DD::Image::ViewerContext::node_color(), DD::Image::Op::node_disabled(), DD::Image::Op::node_selected(), and DD::Image::Op::print_name().

◆ _validate()

void ComplexLightOp::_validate ( bool for_real )

overridevirtual

This will validate the light node.

Reimplemented from DD::Image::CameraOp.

References clamp(), and radians().

◆ knobs()

void ComplexLightOp::knobs ( Knob_Callback f )

overridevirtual

Reimplemented from DD::Image::CameraOp.

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ shade_GL()

◆ draw_handle()

◆ _validate()

◆ knobs()