#include <CameraOp.h>

Inheritance diagram for DD::Image::CameraOp:

Public Types
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 Member Functions
	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

Static Public Member Functions
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 Attributes
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 Member Functions
	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 Attributes
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 Attributes inherited from DD::Image::AxisOp
Matrix4 &	const

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

Hash	metaCacheHash

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

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

Detailed Description

Op that defines a 3D camera.

Member Function Documentation

◆ cameraOp() [1/2]

const CameraOp * DD::Image::CameraOp::cameraOp ( ) const

inlineoverridevirtual

Cast to a CameraOp. This is much cheaper and safer than using dynamic_cast.

Reimplemented from DD::Image::Op.

◆ cameraOp() [2/2]

CameraOp * DD::Image::CameraOp::cameraOp ( )

inlineoverridevirtual

Reimplemented from DD::Image::Op.

◆ default_camera()

CameraOp * CameraOp::default_camera ( )

static

Return a default camera that can be used when there is no camera attached to your renderer. This camera is at the origin, looking along -Z, with a perspective projection set to a lens ratio (focal-length / film-width) of 1.

Referenced by DD::Image::Render::_validate(), DD::Image::ViewerContext::addCamera(), DD::Image::RenderScene::build_handles(), and DD::Image::RenderScene::render_camera().

◆ opHints()

OpHints CameraOp::opHints ( ) const

overridevirtual

Return hints to control when and how this op will be evaluated by the top-down system.

Reimplemented from DD::Image::Op.

References DD::Image::eChainable.

◆ node_color()

unsigned DD::Image::CameraOp::node_color ( ) const

inlineoverridevirtual

Reimplemented from DD::Image::AxisOp.

Reimplemented in DD::Image::LightOp.

◆ _validate()

void CameraOp::_validate ( bool for_real )

overridevirtual

Reimplemented from DD::Image::AxisOp.

Reimplemented in DD::Image::ComplexLightOp.

◆ knobs()

void CameraOp::knobs ( Knob_Callback f )

overridevirtual

Default knobs puts the transform controls on the front tab, and the projection, shutter, and lens controls on tab 'Projection'.

Reimplemented from DD::Image::AxisOp.

Reimplemented in DD::Image::LightOp.

References addLensKnobs(), addProjectionKnobs(), addShutterKnobs(), addWindowKnobs(), DD::Image::AxisOp::createAxisOpKnobs(), and DD::Image::Tab_knob().

◆ addExtraFrontPanelKnobs()

void CameraOp::addExtraFrontPanelKnobs ( Knob_Callback f )

overridevirtual

AxisOp::knobs() calls this after addTransformKnobs(), inserting the 'Projection' tab ahead of the 'Display' tab. The 'Projection' tab contains the projection, shutter, and lens controls.

Reimplemented from DD::Image::AxisOp.

References DD::Image::Op::add_knobs(), addLensKnobs(), addProjectionKnobs(), addShutterKnobs(), addWindowKnobs(), DD::Image::BeginGroup(), DD::Image::Divider(), DD::Image::EndGroup(), and DD::Image::Tab_knob().

◆ addDisplayOptionsKnobs()

void CameraOp::addDisplayOptionsKnobs ( Knob_Callback f )

overridevirtual

Adds the frustum visualization controls.

Reimplemented from DD::Image::AxisOp.

References _glWorldSizeIcon, DD::Image::AxisOp::addDisplayOptionsKnobs(), DD::Image::Bool_knob(), DD::Image::Newline(), DD::Image::SetFlags(), DD::Image::Knob::STARTLINE, and DD::Image::Tooltip().

◆ addProjectionKnobs()

void CameraOp::addProjectionKnobs	(	Knob_Callback	f,
		bool	enableDefaultKnobs = `true`
	)

virtual

Adds the default projection controls. If enableDefaultKnobs is false then the standard projection-related knobs that are not needed by the current projection are disabled.

References _setProjectionFuncPlugin(), DD::Image::BeginGroup(), DD::Image::ClearFlags(), DD::Image::Divider(), DD::Image::Knob::EARLY_STORE, DD::Image::EndGroup(), DD::Image::Enumeration_knob(), DD::Image::Op::error(), DD::Image::Knob::KNOB_CHANGED_ALWAYS, DD::Image::Knob::NO_ANIMATION, DD::Image::Knob::NO_MULTIVIEW, projectionFuncClassName(), DD::Image::Knob::SAVE_MENU, DD::Image::SetFlags(), DD::Image::Knob::SLIDER, DD::Image::Spacer(), DD::Image::Knob::STARTLINE, and DD::Image::Tooltip().

Referenced by addExtraFrontPanelKnobs(), and knobs().

◆ addWindowKnobs()

void CameraOp::addWindowKnobs	(	Knob_Callback	f,
		bool	enableDefaultKnobs = `true`
	)

virtual

Adds the default aperture-window controls. If enableDefaultKnobs is false then the standard projection-related knobs that are not needed by the current projection are disabled.

References DD::Image::Knob::DISABLED, DD::Image::SetFlags(), DD::Image::Tooltip(), and DD::Image::UV_knob().

Referenced by addExtraFrontPanelKnobs(), and knobs().

◆ addLensKnobs()

void CameraOp::addLensKnobs	(	Knob_Callback	f,
		bool	enableDefaultKnobs = `true`
	)

virtual

Adds the default lens controls. If enableDefaultKnobs is false then the standard projection-related knobs that are not needed by the current projection are disabled.

References DD::Image::Bool_knob(), DD::Image::Obsolete_knob(), and DD::Image::Tooltip().

Referenced by addExtraFrontPanelKnobs(), and knobs().

◆ knob_changed()

int CameraOp::knob_changed ( Knob * k )

overridevirtual

Reimplemented from DD::Image::AxisOp.

◆ projectionMode()

ndk::LensProjection CameraOp::projectionMode ( ) const

override

Currently-assigned projection mode enum value. May be one of the pre-defined modes or a custom enum. Note - do not assume this value is within the hardcoded LensProjection set as a subclass may extend or completely replace the enum set!

References _projectionSelection.

◆ setProjection()

bool CameraOp::setProjection ( const char * projectionClassName )

Set the projection mode via a ProjectionFunc class name. If a matching ProjectionFunc plugin exists it will be loaded and an instance created for this camera (retrievable via projectionFunc() after _validate() occurs) and true is returned.

Important note - setting the projection mode via this method does not update _projectionFunc immediately, it is updated during the next _validate() cycle called on this CameraOp. This is to avoid lens shaders from disappearing from renderer visibility until the next Op update cycle.

If any error occurs the default 'Perspective' ProjectionFunc will be used as a fallback and false returned.

References _setProjectionFuncPlugin().

Referenced by setProjectionMode().

◆ setProjectionMode()

void CameraOp::setProjectionMode ( ndk::LensProjection mode )

Same but takes LensProjection enum which is converted to the matching ProjectionFunc class name.

References setProjection().

◆ projectionFuncClassName()

const char * CameraOp::projectionFuncClassName ( ) const

Return the class name of the selected lens projection which is used to find the matching ProjectionFunc plugin. Note that this class name is NOT the plugin name and will have a prefix and suffix added. See ProjectionFunc for more info.

References DD::Image::Enumeration_KnobI::getItemValueString(), and DD::Image::Enumeration_KnobI::getSelectedItemIndex().

Referenced by addProjectionKnobs().

◆ isBaseProjectionLinear()

bool CameraOp::isBaseProjectionLinear ( ) const

override

Returns true if current camera projection can be described linearly with a 4x4 matrix, based on the camera's current settings. This is usually only true for perspective and orthographic modes if no lens distortion is being done.

A subclass should override this method if it's implementing custom projection calculations in projectionModeMatrix().

Default implementation returns projectionFunc()->isLinear().

Referenced by draw_handle().

◆ projectionModeMatrix()

Mat4d CameraOp::projectionModeMatrix ( ndk::LensProjection mode ) const

virtual

Return a linear camera projection matrix for the projection mode arg using the CameraOp's current lens values (ie its focal_length, horizontal_aperture, etc.)

Only the predefined LensProjection enums are implemented in the base class implementation, but a subclass can override this method to implement custom projection calculations.

This method should be used in conjunction with isBaseLinearProjection() to determine how to use the returned matrix, as not all projection modes can be supported by a linear matrix. For example uv and spherical, plus perspective/ortho projections become non linear if lens distortion is enabled.

In non-linear cases the matrix returned is normally considered the 'base' projection for the camera based on its current lens settings. In other words although the projection mode may be 'perspective' and the matrix returned is a valid perspective projection, if lens distortion is enabled then the final projection is a combination of both the projection matrix and the distortion.

References DD::Image::Op::nodeName().

Referenced by draw_handle().

◆ toFormat()

void CameraOp::toFormat	(	fdk::Mat4f &	matrix,
		const Format *	format
	)

static

Multiply the passed matrix by the necessary transformation to put x=-1 at the left edge of the format, +1 at the right, and to center it vertically, and compensate for any pixel aspect. The output z and w are left unchanged.

Most Iops will need to do this using their output format to get the actual transformation from input space to output space. You would do this first, then multiply by the projection*local*parent.

References DD::Image::Format::pixel_aspect(), DD::Image::Box::r(), DD::Image::Box::t(), DD::Image::Box::w(), DD::Image::Box::x(), and DD::Image::Box::y().

◆ fromFormat()

void CameraOp::fromFormat	(	fdk::Mat4f &	matrix,
		const Format *	format
	)

static

Opposite transformation of to_format(). Multiplies the passed matrix by a transformation that scales the input format to go from x = -1 to x = 1 and to center it vertically around y = 0, and to remove any pixel aspect ratio. You multiply by this matrix last.

The 3DCard iop scales further so the image covers a range so that if the camera lens and "taking lens" are equal the image fills the field of view.

References DD::Image::Format::pixel_aspect(), DD::Image::Box::r(), DD::Image::Box::t(), DD::Image::Box::w(), DD::Image::Box::x(), and DD::Image::Box::y().

◆ doAnyHandles()

Op::HandlesMode CameraOp::doAnyHandles ( ViewerContext * ctx )

overridevirtual

Reimplemented from DD::Image::AxisOp.

◆ build_handles()

void CameraOp::build_handles ( ViewerContext * ctx )

overridevirtual

Reimplemented from DD::Image::AxisOp.

◆ draw_handle()

void CameraOp::draw_handle ( ViewerContext * ctx )

overridevirtual

Draws a lovely camera, I think it is a Mitchell.

Reimplemented from DD::Image::AxisOp.

Reimplemented in DD::Image::LightOp, and DD::Image::ComplexLightOp.

◆ drawAperture()

void CameraOp::drawAperture	(	const fdk::Vec3d &	P,
		bool	dashed_lines = `false`
	)

Draw the aperture rectangle in millimeters, centered on xyz position P.

Draw the aperture rectangle in millimeters, centered on 'P'.

◆ drawSolidFrustum()

void CameraOp::drawSolidFrustum	(	const fdk::Vec3d &	near_corner,
		const fdk::Vec3d &	far_corner
	)

Draw the camera's frustum.

◆ drawWireFrustum()

void CameraOp::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.

Draw the camera's frustum.

◆ asCameraLoaderOp()

CameraOp * DD::Image::CameraOp::asCameraLoaderOp ( )

inlineoverridevirtual

SceneLoaderOpI: If loader is attached to an AxisOp subclass return 'this'.

Reimplemented from DD::Image::SceneLoaderOpI.

◆ importScenePrim()

int CameraOp::importScenePrim	(	const usg::StageRef &	stage,
		const std::string &	prim_path
	)

overridevirtual

SceneLoaderOpI: Try to import camera prim data from the provided stage. Will return 1(error) if stage is invalid. If prim_path is empty then -1 will be returned indicating no change has occured, otherwise if prim_path is invalid or not present in stage then 1(error) will be returned.

This will call AxisOp::importScenePrim() to import the XformablePrim data then import the CameraPrim attributes.

Return codes: -1 - no prim data was loaded and no error, usually due to empty prim path 0 - prim data was loaded with no error 1 - there was an error and no prim data was loaded

Reimplemented from DD::Image::AxisOp.

References DD::Image::SceneLoaderOpI::_importer, DD::Image::Op::debug(), DD::Image::SceneLoaderOpI::getAttribValuesTimeWarped(), DD::Image::AxisOp::importScenePrim(), DD::Image::Op::knob(), DD::Image::Op::outputContext(), and DD::Image::Knob::set().

◆ exportCameraSchemaPrimPath()

usg::Path CameraOp::exportCameraSchemaPrimPath ( ) const

protectedvirtual

Builds a path from AxisOp::exportBasePrimPath(), appending the Node displayName() to use as the camera schema's prim name. The camera schema's type name comes from exportCameraSchemaTypeName().

For example if the Node class name is 'MyFisheyeCamera_v4' we want it to show up in the scenegraph as 'MyFisheyeCamera', while the camera schema name may be 'FisheyeCamera'.

References DD::Image::Op::displayName(), and DD::Image::AxisOp::exportBasePrimPath().

Referenced by _exportScenePrims().

◆ exportCameraSchemaTypeName()

const char * CameraOp::exportCameraSchemaTypeName ( ) const

protectedvirtual

Return the schema type name to use for the prim defined by exportCameraSchemaPrimPath(). Base class returns 'Camera'.

◆ _exportScenePrims()

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

overrideprotectedvirtual

ScenePrimExporterOpI: Subclass portion of exportScenePrims().

Reimplemented from DD::Image::AxisOp.

Reimplemented in DD::Image::LightOp.

References DD::Image::AxisOp::_exportScenePrims(), DD::Image::AxisOp::_exportTransformOps(), DD::Image::AxisOp::axisOp(), DD::Image::ScenePrimExporterOpI::buildParentPrims(), exportCameraSchemaPrimPath(), DD::Image::ScenePrimExporterOpI::exportKnob(), DD::Image::Knob::get(), DD::Image::Op::knob(), DD::Image::Op::parent(), and DD::Image::AxisOp::parentInputOp().

◆ mFnDeprecatedLegacy3DSystemInNuke14()

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

inline

< Standard perspective projection

< Standard orthographic projection

< Replace screen XY with UV coordinate

< 360x180 world spherically projected around camera

< Renderer uses this option

< Camera user projection

◆ _validateCamera()

void CameraOp::_validateCamera ( )

overrideprotected

Subclass implemention of validateCamera() to perform any custom configuration of the camera, called whenever the function has been changed.

References DD::Image::AxisOp::_xformParams, and DD::Image::Op::outputContext().

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ cameraOp() [1/2]

◆ cameraOp() [2/2]

◆ default_camera()

◆ opHints()

◆ node_color()

◆ _validate()

◆ knobs()

◆ addExtraFrontPanelKnobs()

◆ addDisplayOptionsKnobs()

◆ addProjectionKnobs()

◆ addWindowKnobs()

◆ addLensKnobs()

◆ knob_changed()

◆ projectionMode()

◆ setProjection()

◆ setProjectionMode()

◆ projectionFuncClassName()

◆ isBaseProjectionLinear()

◆ projectionModeMatrix()

◆ toFormat()

◆ fromFormat()

◆ doAnyHandles()

◆ build_handles()

◆ draw_handle()

◆ drawAperture()

◆ drawSolidFrustum()

◆ drawWireFrustum()

◆ asCameraLoaderOp()

◆ importScenePrim()

◆ exportCameraSchemaPrimPath()

◆ exportCameraSchemaTypeName()

◆ _exportScenePrims()

◆ mFnDeprecatedLegacy3DSystemInNuke14()

◆ _validateCamera()