REFERENCE GUIDE VERSION 2.
Katana™ Reference Guide. Copyright © 2012 The Foundry Visionmongers Ltd. All Rights Reserved. Use of this document and the Katana software is subject to an End User License Agreement (the "EULA"), the terms of which are incorporated herein by reference. This document and the Katana software may be used or copied only in accordance with the terms of the EULA.
Contents 1 Preface About this Manual 10 Getting Help 10 10 11 Viewing Additional Help Contacting Customer Support 2 Nodes A-C 12 AimConstraint 12 Alembic_In 13 ArnoldGlobalSettings 16 ArnoldObjectSettings 27 ArnoldOutputChannelDefine 31 ArnoldShadingNode 38 AttributeCopy 72 AttributeEditor 74 AttributeFile_In 77 AttributeModifierDefine 79 AttributeModifierResolve 81 AttributeScript 81 AttributeSet 87 AttributeUpgrade 90 BillboardConstraint 92 BoundsAdjust 93 CameraClipp
ClippingConstraint 102 CollectionCreate 103 ConstraintListEdit 103 ConstraintResolve 104 CoordinateSystemDefine 104 3 Nodes D-H 106 DependencyMerge 106 DollyConstraint 106 Dot 107 FaceSetCreate 108 Fork3D 109 FOVConstraint 109 Gaffer 110 GafferThree 113 GenericOp 123 Group 131 GroupMerge 131 GroupStack 133 HierarchyCopy 134 4 Nodes I-K 135 ImageAddMix 135 ImageAtop 136 ImageAverage 140 ImageBackgroundColor 144 ImageBlack 145 ImageBlur 146
ImageBrightness 149 ImageChannels 150 ImageCheckerboard 153 ImageClamp 154 ImageColor 156 ImageContrast 158 ImageCoordinate 160 ImageCrop 161 ImageDifference 162 ImageDistort 166 ImageDivide 169 ImageExclusion 173 ImageExposure 177 ImageFade 179 ImageFrom 180 ImageGain 184 ImageGamma 186 ImageGeometric 188 ImageHypot 192 ImageIn 196 ImageInvert 200 ImageLevels 201 ImageMatte 203 ImageMatteMix 207 ImageMax 209 ImageMin 213 ImageMinus 217 ImageMix 221 Im
ImageOrient 226 ImageOut 227 ImageOver 231 ImagePlus 235 ImagePosition 239 ImagePremultiply 240 ImageRamp 242 ImageRead 243 ImageReformat 247 ImageSaturation 250 ImageScreen 252 ImageText 256 ImageThreshold 260 ImageTransform2D 263 ImageUnder 268 ImageUnpremultiply 272 ImageWhite 273 ImageWrite 275 Importomatic 284 285 Right-Click Menu InfoCreate 285 InteractiveRenderFilters 286 Isolate 286 5 Nodes L-Q LightCreate 289 LightLink 292 LightListEdit 294 LiveGro
LocationCreate 297 LodGroupCreate 298 LodSelect 299 LodValuesAssign 300 LookFileAssign 302 LookFileBake 302 LookFileGlobalsAssign 303 LookFileLightAndConstraintActivator 304 LookFileManager 305 LookFileMaterialsIn 305 LookFileMaterialsOut 306 LookFileMultiBake 306 LookFileOverrideEnable 308 LookFileResolve 308 Material 309 MaterialAssign 312 MaterialResolve 312 MaterialStack 312 Merge 312 NetworkMaterial 314 NetworkMaterialInterfaceControls 316 NetworkMaterialParame
OCIOLookTransform 324 OpResolve 324 OpScript 325 OrientConstraint 331 ParentChildConstraint 331 PointConstraint 332 PrimitiveCreate 333 PrmanGlobalSettings 334 PrmanObjectSettings 337 PrmanOutputChannelDefine 350 PrmanShadingNode 351 Prune 351 6 Nodes R-Z ReflectionConstraint 353 Rename 353 Render 354 RenderOutputDefine 356 RenderScript 360 RenderSettings 363 ScaleConstraint 364 ScenegraphGeneratorResolve 365 ScenegraphGeneratorSetup 365 ScenegraphXml_In 365 Scree
Transform3D 371 VariableDelete 372 VariableEnabledGroup 372 VariableSet 373 VariableSwitch 373 VelocityApply 374 ViewerObjectSettings 374 VisibilityAssign 376 ZoomToRect 377
1 Preface Katana is a 3D application specifically designed for the needs of look development and lighting in an asset based pipeline. Originally developed at Sony Pictures Imageworks, Katana has been their core tool for look development and lighting for all their productions since "Spider-Man 3", "Beowulf", and "Surf's Up!". Katana provides a very general framework for efficient look development and lighting, with the goals of scalability, flexibility, and supporting an asset based pipeline.
1 PREFACE | • Finally, you can click the Help menu to access the following: • User Guide - the Katana user guide, which is aimed at users of all levels and covers most operations inside Katana. • Technical Guide - a more technical overview of Katana, aimed at those with a more technical role such as pipeline engineers. • Reference Guide - a reference list of the nodes, their parameters, and how to use them.
2 Nodes A-C AimConstraint Applies an aim constraint to an object in the Scene Graph. Control (UI) Default Value Function basePath None Describes the Scene Graph location of the object to constrain. The basePath parameter options are available in either the scene graph widget or dropdown menu to the right of the parameter. For more information on the basePath widget parameters, see Common Node Widgets on page 1.
2 NODES A-C | ALEMBIC_IN Control (UI) Default Value Function baseAimAxis 0.0, 0.0, -1.0 The axis of the base object that is pointed at the target. Adjusting these values changes the axis of the object that is aimed at the target. baseUpAxis 0.0, 1.0, 0.0 The axis of the base object that is pointed upwards relative to the target. Adjusting these values changes the rotation of the base object, while keeping the aim constant. targetUpAxis 0.0, 1.0, 0.
2 NODES A-C | ALEMBIC_IN Alembic caches are retrieved with reference to time, not a particular frame; because of this, Katana needs to know what frame rate to use when querying the alembic file. Control (UI) Default Value Function name /root/world/geo/asset Specifies the Scene Graph location where the Alembic asset is to be placed. name Parent to Scene Graph Selection N/A Sets the parent location of the Alembic asset to be the current Scene Graph selection. Parent to N/A /root/world/geo/...
2 NODES A-C | ALEMBIC_IN Control (UI) Default Value addBounds Function Specifies where the overall bounds should be placed: the root location, its direct children, both or none of these. Adding the bounds to the root has the disadvantage of producing the wrong bounds when the same root location is used by several Alembic_IN nodes (the last one being loaded will overwrite the bounds added by the other ones).
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Function mode Current Frame Sets the timing mode to apply to the asset: • Current Frame - uses the current frame to access the Alembic asset. • Hold Frame - uses the frame specified by holdTime to access the Alembic asset. • Clamp Range - forces Katana to only retrieve geometry from between the inTime and outTime frames. The frames specified by inTime and outTime are used for frames before and after the clamp range respectively.
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Function 1 Sets the number of anti-aliasing samples Arnold fires. Anti-aliasing Settings AA_samples The number fired is the AA_samples value squared, camera rays per pixel. AA_samples_progressive_begin 1 A negative value sets a single camera ray per block of pixels. For example, a value of -5 sets one camera ray for every 25 pixels. AA_samples_progressive_step 2 Sets the step size for progressive sampling.
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Function 10 Sets the ultimate limit on ray depth, regardless of ray Lighting > Ray Depth GI_total_depth type. GI_diffuse_depth 0 Sets the number of bounces considered for global illumination (0 = Off). Note: Expect substantial increases in render times with each incremental rise in the value of GI_diffuse_depth. GI_glossy_depth 0 For glossy reflections, sets the number of times a ray can bounce off a glossy surface (0 = Off).
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Function AI_RAY_REFRACTED On Toggle refraction rays on or off. AI_RAY_DIFFUSE Off Toggle diffuse global illumination rays on or off. AI_RAY_GLOSSY Off Toggle blurred reflection rays on or off. Lighting > Environment (Cont.) atmosphere none Sets the path to an atmosphere material if one is defined or inherited. skip_background_atmosphere Off Toggle the use of an atmosphere material on or off.
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Function from_camera_ Sets the type of camera used. Camera camera_type location filtermap N/A Sets which shader - if any - is used for effects such as vignettes. Where the chosen shader returns black pixels, the ray isn’t traced, otherwise rays are multiplied by the result of the shader specified in filtermap. Camera > Motion Blur shutter_type box Sets the filter used by the shutter.
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Function flip_t none Sets whether an objects T coordinates are inverted or not. CCW_points Off Sets whether points are processed counterclockwise or not. Scene Generation forceExpand Off If enabled, geometry is looked at procedurally, but horizontally expanded and inserted as a flat object into the scene. checkpointRender Off For EXR renders only, including VSHADs.
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Disable logging when On Function rerendering max_warnings 5 Sets the maximum number of warnings in the RenderLog tab. At the end of the output, a list of the different types of messages, and the number of occurrences of each is also given. Error Settings abort_on_error On When set to On, rendering aborts as soon as an error is detected.
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Function Debug Settings > Disable Features ignore_textures Off ignore_shaders Off When set to On, Arnold renders with a simple N dot eye shader.
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Function bucket_scanning top Sets the order of bucket scanning. threads 1 Specifies the number of threads used for rendering. If set to 0, thread assignment is automatic, using the optimal number of threads with respect to the number of sockets, physical , and logical cores.
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Function pin_threads auto Set to auto by default, in which case thread pinning is only enabled if more than half the logical cores are being used. Can also be manually set to always on or off by setting the new global option options.pin_threads to on, off, or auto.
2 NODES A-C | ARNOLDGLOBALSETTINGS Control (UI) Default Value Function texture_glossy_blur 0.01563 Specifies the amount of blur in texture lookups for glossy rays. If using the Cook-Torrance BRDF, textures are automatically blurred, and this parameter is ignored. texture_sss_blur texture_max_memory_MB 500 Specifies the maximum amount of memory available for texture caching. texture_max_open_files 2000 Specifies the maximum number of files the texture system can have open at any one time.
2 NODES A-C | ARNOLDOBJECTSETTINGS ArnoldObjectSettings The ArnoldObjectSettings node is populated by the XML files located at ${KATANA_ROOT} /plugins/Resources/Arnold4.1/GenericAssign. These parameter names and defaults can change between Arnold versions and, as such, they are provided for you to change. In Katana 2.0v1 the available options as shipped are: Control (UI) Default Value Function invert_normals Off Flips normal direction. smoothing Off Controls normal interpolation between polygons.
2 NODES A-C | ARNOLDOBJECTSETTINGS Control (UI) Default Value Function pixel_error 0 Sets the acceptable tessellation error, in pixels, as seen from the camera. If there’s no displacement, pixel_error represents the distance from the subdivided mesh to the true or limit surface. The smaller the error, the closer to the limit surface a mesh is (with less inter-frame popping when the subdivision level jumps).
2 NODES A-C | ARNOLDOBJECTSETTINGS Control (UI) Default Value Function curve_mode ribbon Sets curve display to ribbon, thick, or oriented. Ribbon renders curves with costant orientation (perpendicular to the camera), thick renders curves as a pil, and oriented renders curves with variable orientation. All curve types respect the following attributes, set on the curve geometry Scene Graph location: • geometry.
2 NODES A-C | ARNOLDOBJECTSETTINGS Control (UI) Default Value Function disp_height 1 Sets the displacement scale. If disp_height is set without setting disp_padding, there could be clipping of the resulting displaced mesh. autobump Off Autobump puts the high frequencies of a displacement map into a bump attribute, so fewer subdivision iteration values are needed.
2 NODES A-C | ARNOLDOUTPUTCHANNELDEFINE Control (UI) Default Value Function AI_RAY_DIFFUSE On Enable or disable double-sided visibility for global illumination diffuse rays. AI_RAY_GLOSSY On Ray Flags > visibility AI_RAY_CAMERA On Enable or disable visibility of the object to the camera. AI_RAY_SHADOW On Enables or disables inclusion of the object when calculating shadow rays. AI_RAY_REFLECTED On Enables or disables reflection rays.
2 NODES A-C | ARNOLDOUTPUTCHANNELDEFINE Control (UI) Default Value Function name none The name used by the RenderOutputDefine node for these output channel settings. This parameter usually matches the channel name. By allowing a different name to be sent to the RenderOutputDefine node different filter and file types can be used for the same output variable. driver driver driver_exr Sets the output channel driver to use.
2 NODES A-C | ARNOLDOUTPUTCHANNELDEFINE Control (UI) Default Value Function filter gaussian_filter Sets the output channel filter.
2 NODES A-C | ARNOLDOUTPUTCHANNELDEFINE Control (UI) Default Value alpha_half_precision Off depth_half_precision Off Function driverParameters when driver: driver_display callback N/A callback_data N/A gamma 1 dither 0 rgba_packing On driverParameters when driver: driver_exr filename output.exr The path name of the output file.
2 NODES A-C | ARNOLDOUTPUTCHANNELDEFINE Control (UI) Default Value Function append Off When enabled, Arnold preserves previously rendered tiles, and only processes missing tiles, appending them to the output files. Note: If no previously rendered tiles are present, the render proceeds as normal, creating a new image. If previously rendered tiles are present, but image specifications do not match, the render is aborted. driverParameters when driver: driver_jpeg filename output.
2 NODES A-C | ARNOLDOUTPUTCHANNELDEFINE Control (UI) Default Value dither 1 unpremult_alpha Off skip_alpha Off append Off Function When enabled, Arnold preserves previously rendered tiles, and only processes missing tiles, appending them to the output files. Note: If no previously rendered tiles are present, the render proceeds as normal, creating a new image. If previously rendered tiles are present, but image specifications do not match, the render is aborted.
2 NODES A-C | ARNOLDOUTPUTCHANNELDEFINE Control (UI) Default Value Function filterParameters when filter: cubic_filter N/A filterParameters when filter: disc_filter width 2 filterParameters when filter: farthest_filter domain first_hit filterParameters when filter: gaussian_filter width 2 filterParameters when filter: heatmap_filter minimum 0 maximum 1 filterParameters when filter: mitnet_filter N/A filterParameters when filter: sinc_filter width 6 filterParameters when filter: triangle_filt
2 NODES A-C | ARNOLDSHADINGNODE ArnoldShadingNode Control (UI) Default Value name ArnoldShadingNode nodeType none Function Dropdown box to choose available shaders. Once a shader has been selected, access to the filter is available. The filter available will vary due to shader. > Browse... parameters when nodeType: ambient_occlusion samples 3 spread 1 near_clip 0 far_clip 100 falloff 0 black 0.0000, 0.0000, 0.0000 white 1.0000, 1.0000, 1.0000 invert_normals Off opacity 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value barndoor_right_ 1 Function bottom barndoor_right_edge 0 barndoor_bottom_ 1 left barndoor_bottom_ 1 right barndoor_bottom_ 0 edge barndoor_left_top 0 barndoor_left_ 0 bottom barndoor_left_edge 0 parameters when nodeType: bump2d bump_map 0 bump_height 0 shader 0.0000, 0.0000, 0.0000, 0.0000 parameters > shader RGB HSL HSV parameters when nodeType: bump3d bump_map 0 bump_height 1 epsilon 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value shader 0.0000, 0.0000, Function 0.0000, 0.0000 parameters > shader RGB HSL HSV parameters when nodeType: cylinder_light bottom > Add > New 0.0, -1.0, 0.0 Entry top > Add > New 0.0, 1.0, 0.0 Entry radius 1 decay_type quadratic matrix > Add > color 1.0000 1.0000 1.0000 parameters > color RGB HSL HSV parameters when nodeType: cylinder_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value shadow_density On shadow_color 0.0000 0.0000 0.0000 Function parameters > shadow_color RGB HSL HSV parameters when nodeType: cylinder_light (Cont.) samples 1 normalize On affect_diffuse On affect_specular On affect_volumetrics On diffuse 1 specular 1 sss 1 indirect 1 max_bounces 999 volume_density N/A parameters when nodeType: cylinder_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value postion > Add > New 0.0, 0.0, 0.0 Function Entry direction > Add > New 0.0, 0.0, -1.0 Entry radius 0.5 decay_type quadratic matrix > Add > New Entry color 1.0000 1.0000 1.0000 parameters > color RGB HSL HSV parameters when nodeType: disc_light (Cont.) intensity 1 exposure 0 cast_shadows On cast_volumetric_ On shadows shadow_density On shadow_color 0.0000 0.0000 0.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function parameters when nodeType: disc_light (Cont.) samples 1 normalize On affect_diffuse On affect_specular On affect_volumetrics On diffuse 1 specular 1 sss 1 indirect 1 max_bounces 999 volume_density N/A time_samples > Add > New Entry volume_samples 2 parameters when nodeType: distant_light direction 0.0, 0.0, -1.0 angle 0 matrix > Add > New UNIMPLEMENTED Entry PARAM TYPE: 13 color 1.0000, 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function HSV parameters when nodeType: distant_light (Cont.) intensity 1 exposure 0 cast_shadows enabled cast_volumetric_ enabled shadows shadow_density 1 shadow_color 0.0000, 0.0000, 0.0000 parameters > shadow_color RGB HSL HSV parameters when nodeType: distant_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value max_bounces 999 volume_density N/A Function time_samples > Add > New Entry volume_samples 2 parameters when nodeType: flat color 1.0000, 1.0000, 1.0000 parameters > color RGB HSL HSV parameters when nodeType: flat (Cont.) opacity 1.0000, 1.0000, 1.0000 parameters > opacity RGB HSL HSV parameters when nodeType: fog distance 0.02 height 5 color 1.0000, 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function RGB HSL HSV parameters when nodeType: fog (Cont.) ground_point 0.0, 0.0, 0.0 ground_normal 0.0, 0.0, 1.0 parameters when nodeType: gobo slidemap 1.0000, 1.0000, slidemap 1.0000 parameters > slidemap RGB HSL HSV parameters when nodeType: gobo (Cont.) rotate > Add > New 0 Entry offset 0.0, 0.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value rootcolor 0.1000, 0.1000, Function 0.1000 parameters > rootcolor RGB HSL HSV parameters when nodeType: hair (Cont.) tipcolor 0.5000, 0.5000, 0.5000 parameters > tipcolor RGB HSL HSV parameters when nodeType: hair (Cont.) opacity 1.0000, 1.0000, 1.0000 parameters > opacity RGB HSL HSV parameters when nodeType: hair (Cont.) ambdiff 0.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function RGB HSL HSV parameters when nodeType: hair (Cont.) spec_shift 0 gloss 10 spec2 0 spec2_color 1.0000, 0.4000, 0.1000 parameters > spec2_color RGB HSL HSV parameters when nodeType: hair (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value filename N/A filter smart_bicubic mipmap_bias 0 single_channel disabled start_channel 0 swrap periodic twrap periodic sscale 1 tscale 1 sflip disabled tflip disabled swap_st disabled Function uvcoords uvset N/A multiply 1.0000, 1.0000, 1.0000 parameters > multiply RGB HSL HSV parameters when nodeType: image (Cont.) offset 0.0000, 0.0000, 0.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function RGB HSL HSV parameters when nodeType: image (Cont.) cache_texture_ enabled handles parameters when nodeType: lambert Kd 0.7 Kd_color 1.0000, 1.0000, 1.0000 parameters > Kd_color RGB HSL HSV parameters when nodeType: lambert (Cont.) opacity 1.0000, 1.0000, 1.0000 parameters > opacity RGB HSL HSV parameters when nodeType: lambert (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value geometry_type box geometry_matrix default matrix density 0 roundness 0 width_edge 0 height_edge 0 ramp 0 ramp_axis x Function parameters when nodeType: light_decay use_near_atten disabled use_far_atten disabled near_start 0 near_end 0 far_start 0 far_end 0 parameters when nodeType: mesh_light mesh N/A decay_type quadratic matrix > Add > New Entry color 1.0000, 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function HSL HSV parameters when nodeType: mesh_light (Cont.) intensity 1 exposure 0 cast_shadows enabled cast_volumetrics enabled shadow_density 1 shadow_color 0.0000, 0.0000, 0.0000 parameters > shadow_color RGB HSL HSV parameters when nodeType: mesh_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value max_bounces 999 volume_density N/A Function time_samples > Add > New Entry volume_samples 2 parameters when nodeType: motion_vector raw disabled time0 0 time1 1 max_displace 0 parameters when nodeType: noise octaves 1 distortion 0 lacunarity 1.92 amplitude 1 scale 1.0, 1.0, 1.0 offset 0.0, 0.0, 0.0 coord_space object parameters when nodeType: photometric_light filename N/A matrix > Add > New Entry color 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function RGB HSL HSV parameters when nodeType: photometric_light (Cont.) intensity 1 exposure 0 cast_shadows enabled cast_volumetric_ enabled shadows shadow_density 1 shadow_color 0.0000, 0.0000, 0.0000 parameters > shadow_color RGB HSL HSV parameters when nodeType: photometric_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value sss 1 indirect 1 max_bounces 999 volume_density N/A Function time_samples > Add > New Entry volume_samples 2 parameters when nodeType: physical_sky turbidity 3 ground_albedo 0.1000, 0.1000, 0.1000 parameters > ground_albedo RGB HSL HSV parameters when nodeType: physical_sky (Cont.) use_degrees enabled elevation 45 azimuth 90 sun_direction enable_sun enabled sun_size 0.51 sun_tint 1.0000, 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function RGB HSL HSV parameters when nodeType: physical_sky (Cont.) sky_tint 1.0000, 1.0000, 1.0000 parameters > sky_tint RGB HSL HSV parameters when nodeType: physical_sky (Cont.) intensity 1 x y z parameters when nodeType: point_light position > Add > New Entry radius 0 decay_type quadratic matrix default matrix color 1.0000, 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function HSL HSV parameters when nodeType: point_light (Cont.) intensity 1 exposure 0 cast_shadows enabled cast_volumetric_ enabled shadows shadow_density 1 shadow_color 0.0000, 0.0000, 0.0000 parameters > shadow_color RGB HSL HSV parameters when nodeType: point_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value indirect 1 max_bounces 999 volume_density N/A Function time_samples > Add > New Entry volume_samples 2 parameters when nodeType: quad_light vertices > Add > New Entry decay_type quadratic resolution 512 solid_angle enabled matrix > Add > New default matrix Entry color 1.0000, 1.0000, 1.0000 parameters > color RGB HSL HSV parameters when nodeType: quad_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value cast_volumetric_ enabled Function shadows shadow_density 1 shadow_color 0.0000, 0.0000, 0.0000 parameters > shadow_color RGB HSL HSV parameters when nodeType: quad_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value camera 1.0000, 1.0000, Function 1.0000, 1.0000 parameters > camera RGB HSL HSV parameters when nodeType: ray_switch (Cont.) shadow 1.0000, 1.0000, 1.0000, 1.0000 parameters > shadow RGB HSL HSV parameters when nodeType: ray_switch (Cont.) reflection 1.0000, 1.0000, 1.0000, 1.0000 parameters > reflection RGB HSL HSV parameters when nodeType: ray_switch (Cont.) refraction 1.0000, 1.0000, 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function HSL HSV parameters when nodeType: ray_switch (Cont.) diffuse 1.0000, 1.0000, 1.0000, 1.0000 parameters > diffuse RGB HSL HSV parameters when nodeType: ray_switch (Cont.) glossy 1.0000, 1.0000, 1.0000, 1.0000 parameters > glossy RGB HSL HSV parameters when nodeType: sky color 1.0000, 1.0000, 1.0000 parameters > color RGB HSL HSV parameters when nodeType: sky (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value visibility 65535 opaque_alpha enabled format angular X_angle 0 Y_angle 0 Z_angle 0 X 1.0, 0.0, 0.0 Y 0.0, 1.0, 0.0 Z 0.0, 0.0, 1.0 Function parameters when nodeType: skydome_light resolution 1000 format angular matrix default matrix color 1.0000, 1.0000, 1.0000 parameters > color RGB HSL HSV parameters when nodeType: skydome_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value cast_columetric_ enabled Function shadows shadow_density 1 shadow_color 0.0000, 0.0000, 0.0000 parameters > shadow_color RGB HSL HSV parameters when nodeType: skydome_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function position > Add > New Entry look_at > Add > New Entry up > Add > New Entry radius 0 lens_radius 0 cone_angle 65 penumbra_angle 0 cosine_power 0 aspect_ratio 1 decay_type quadratic matrix > Add > New default matrix Entry color 1.0000, 1.0000, 1.0000 parameters > color RGB HSL HSV parameters when nodeType: spot_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value cast_volumetric_ enabled Function shadows shadow_density 1 shadow_color 0.0000, 0.0000, 0.0000 parameters > shadow_color RGB HSL HSV parameters when nodeType: spot_light (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Kd 0.7 Kd_color 1.0000, 1.0000, Function 1.0000 parameters > color RGB HSL HSV parameters when nodeType: standard (Cont.) diffuse_roughness 0 Ks 0 Ks_color 1.0000, 1.0000, 1.0000 parameters > Ks_color RGB HSL HSV parameters when nodeType: standard (Cont.) specular_brdf cook_torrance specular_roughness 0.4669 specular_anisotropy 0.5 specular_rotation 0 Kr 0 Kr_color 1.0000, 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function RGB HSL HSV parameters when nodeType: standard (Cont.) reflection_exit_color 0.0000, 0.0000, 0.0000 parameters > Kr_color RGB HSL HSV parameters when nodeType: standard (Cont.) reflection_exit_use_ disabled environment Kt 0 Kt_color 1.0000, 1.0000, 1.0000 parameters > Kt_color RGB HSL HSV parameters when nodeType: standard (Cont.) transmittance 1.0000, 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function HSL HSV parameters when nodeType: standard (Cont.) refraction_roughness 0 refraction_exit color 0.0000, 0.0000, 0.0000 parameters > refraction_exit color RGB HSL HSV parameters when nodeType: standard (Cont.) refraction_exit_use_ disabled environment IOR 1 Kb 0 Fresnel disabled Km 0 specular_Fresnel disabled Ksn 0 Fresnel_use_IOR disabled Fresnel_affect_diff enabled emission 0 emission_color 1.0000, 1.0000, 1.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function RGB HSL HSV parameters when nodeType: standard (Cont.) direct_specular 1 indirect_specular 1 direct_diffuse 1 indirect_diffuse 1 enable_glossy_ disabled caustics enable_reflective_ disabled caustics enable_refractive_ disabled caustics enable_internal_ enabled reflections Ksss 0 Ksss_color 1.0000, 1.0000, 1.0000 parameters > Ksss_color RGB HSL HSV parameters when nodeType: standard (Cont.) sss_radius 0.1000, 0.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value bounce_factor 1 opacity 1.0000, 1.0000, Function 1.0000 parameters > opacity RGB HSL HSV parameters when nodeType: standard (Cont.
2 NODES A-C | ARNOLDSHADINGNODE Control (UI) Default Value Function HSL HSV parameters when nodeType: utility (Cont.) opacity 1 parameters when nodeType: volume_scattering density 0 samples 5 eccentricity 0 attenuation 0 affect_camera 1 affect_diffuse 0 affect_reflection 1 importance_sampling enabled rgb_density 1.0000, 1.0000, 1.0000 parameters > rgb_density RGB HSL HSV parameters when nodeType: volume_scattering (Cont.) rgb_attenuation 1.0000, 1.0000, 1.
2 NODES A-C | ATTRIBUTECOPY Control (UI) Default Value Function HSL HSV parameters when nodeType: wireframe line_width 1 fill_color 1.0000, 1.0000, 1.0000 parameters > fill_color RGB HSL HSV parameters when nodeType: wireframe (Cont.) line_color 0.0000, 0.0000, 0.0000 parameters > fill_color RGB HSL HSV parameters when nodeType: wireframe (Cont.) raster_space enabled edge_type triangles AttributeCopy Copies an attribute from location(s) in the copyFrom scene to location(s) in the input scene.
2 NODES A-C | ATTRIBUTECOPY This node traverses the copyFrom scene at location fromRoot, and the input scene at location toRoot. From these locations on, it expects to find identical hierarchy and location names. For each location, if the copyFrom location has the attribute specified by fromAttr (e.g. geometry.point.P), the attribute is copied to the location specified by toAttr (e.g. geometry.point.Pref) on the input location. The optional toCEL parameter allows you to filter the evaluation of this node.
2 NODES A-C | ATTRIBUTEEDITOR Control (UI) Default Value Function toCEL none Allows you to filter the evaluation of this node. Only locations in the destination scene that match toCEL are evaluated. If toCEL is empty, all locations in the destination scene are evaluated. Specifies Scene Graph locations on which the operation or assignment acts. The Scene Graph locations are specified using the Collection Expression Language (CEL). The toCEL parameter options are available by clicking Add Statements.
2 NODES A-C | ATTRIBUTEEDITOR Control (UI) Default Value Function Append Scenegraph N/A Adds a Paths list to this CEL parameter and places selected Selection Replace With Scene Graph locations in the new list. N/A Scenegraph Selection Removes any parameters within this CEL parameter and creates a new Paths list and populates it with any selected Scene Graph locations. Copy CEL Statement N/A Copies this CEL statement to the clipboard.
2 NODES A-C | ATTRIBUTEEDITOR Control (UI) Default Value Function Add Scene Root N/A Brings up a dialog box populated with the collections currently Collections... on /root. You can then select from these collections to add them to this list. Remove Selected N/A Removes the selected collection(s) from this list. Select All N/A Selects all the collections in this list.
2 NODES A-C | ATTRIBUTEFILE_IN Control (UI) Default Value Function Copy Overrides To N/A Copies the override to the Scene Graph location currently Selected Scenegraph selected. Location... Delete Overrides N/A Deletes the override. Drop Attributes Here N/A Middle-click and drag attributes from the Attributes tab to this hotspot to use that attribute.
2 NODES A-C | ATTRIBUTEFILE_IN Control (UI) Default Value Function Custom File Parser none Specifies the .so file with the Attributes File parser. Leave it empty to use the default one. Browse... N/A Brings up the file browser or your studio's asset management browser and enables you to select the asset to use. Set Node Name From N/A Path Attribute Group Changes the name of the node to match the filename but without the path or extension.
2 NODES A-C | ATTRIBUTEMODIFIERDEFINE Control (UI) Default Value Function mode Current Frame Sets the timing mode to apply to the asset: • Current Frame - uses the current frame to access the attribute file. • Hold Frame - uses the frame specified by holdTime to access the attribute file. • Clamp Range - forces Katana to only apply the attributes stored in the attributes file between the inTime and outTime frames.
2 NODES A-C | ATTRIBUTEMODIFIERDEFINE Control (UI) Default Value Function CEL none Specifies Scene Graph locations on which the operation or assignment acts. The Scene Graph locations are specified using the Collection Expression Language (CEL). The CEL parameter options are available by clicking Add Statements. For more information, see the CEL Reference document found on the documentation HTML page (accessed through Help > Documentation) or the CEL widget parameters in Common Node Widgets on page 1.
2 NODES A-C | ATTRIBUTEMODIFIERRESOLVE Control (UI) Default Value Function groupAttr none Describes the group name where the attribute file modifications are placed. args: GeoScaler scale 0.5 Sets the scaling factor for the GeoScaler AMP plug-in. 2 Sets the maximum amount the geometry is displaced using the args: Messer displacement Messer AMP plug-in. AttributeModifierResolve This node resolves Attribute Modifier Plug-ins (AMPs).
2 NODES A-C | ATTRIBUTESCRIPT • GetArguments([asOpArgs=False, asFnAttribute=False]) - returns a list of arguments to the attribute script. If the asOpArgs parameter is set to True returns the new style Op arguments to the AttributeScript Op. If False, it returns the old style AMP arguments. The arguments include CEL expressions, the name of the node, and similar. If asFnAttribute is True, return the results as an asFnAttribute object, otherwise use the older ScenegraphAttr class.
2 NODES A-C | ATTRIBUTESCRIPT • GetXform([worldSpace=False, atLocation=None, asAttr=False, atSamples=None, asFnAttribute=False]) - returns the local or worldspace transformation as a 16-element list of float values representing a 4x4 transform matrix. If the atSamples parameter is specified it should be a sequence of time samples at which to return the xform. • Util.AssetResolve(assetID) - given an asset ID, Util.AssetResolve returns a file path.
2 NODES A-C | ATTRIBUTESCRIPT Control (UI) Default Value Function toCEL > Add N/A • Paths - Adds a Paths list to this CEL parameter. Statements • Collections - Adds a Collections list to this CEL parameter. • Custom - Adds a Custom parameter to this CEL parameter. • Append Scene Graph Selection - Adds a Paths list to this CEL parameter and places selected Scene Graph locations in the new list.
2 NODES A-C | ATTRIBUTESCRIPT Control (UI) Default Value Function Add Collections From N/A Brings up a dialog box with a list of the collections from the Scenegraph currently selected Scene Graph locations. You can then select Selection... from these collections to add them to this list. Add Scene Root N/A Collections... Brings up a dialog box populated with the collections currently on /root. You can then select from these collections to add them to this list.
2 NODES A-C | ATTRIBUTESCRIPT Control (UI) Default Value Function applyWhen immediate Determines when the script is run: • immediate - the script runs at the locations specified by the CEL statement as they are evaluated at this node's point in the graph. • during attribute modifier plugin resolve - the script and its arguments are added as attributes under the Scene GraphLocationModifers group attribute and run later by the implicit ScenegraphLocationModifierResolve filter added at render time.
2 NODES A-C | ATTRIBUTESET Control (UI) Default Value Function initializationScript: Yes setup none Contains a Python script to run once before the script parameter is run for each location. It is used to run scripts that are computationally or resource heavy and have the same result for each location, for instance file reads. To store persistent data from this script to the script parameter script, use the user module. script none Contains the Python scripts to run.
2 NODES A-C | ATTRIBUTESET Control (UI) Default Value Function Replace with N/A Removes all existing paths and replaces them with a path for Nodegraph Node each selected Node Graph node and links the Scene Graph Locations location created by that node to the path. Clear All N/A Removes all paths from this parameter. none Sets the attribute location to be overridden. mode: CEL celSelection mode: CEL: celSelection > Add Statements Paths N/A Adds a Paths list to this CEL parameter.
2 NODES A-C | ATTRIBUTESET Control (UI) Default Value Function Select All N/A Selects all the paths in this list. Select Selected Paths N/A Selects the Scene Graph locations of the selected paths in this In Scenegraph Copy Selected Paths list. N/A Copies the selected paths from this list to the clipboard. N/A Brings up a dialog with the contents of this Paths list. to Clipboard Show Extended View...
2 NODES A-C | ATTRIBUTEUPGRADE Control (UI) Default Value Function attributeType double The type of the attribute that is overridden: • integer • double • float • string • group groupInherit Yes Decides whether or not implicitly-created groups are inherited lower in the Scene Graph hierarchy. For instance, creating foo.bar implicitly creates the group foo. This group is either inherited or not, depending on this parameter.
2 NODES A-C | ATTRIBUTEUPGRADE | | |-- expr = 'print "hi"' | | `-- historyName = 'AttributeScript' | `-- resolveIds = 'test' `-- type = 'group' AttributeUpgrade is useful when loading saved or serialized attributes that are in this form into Katana post-2.0 ops. Simply loading a 1.x file that contains an AttributeScript node in 2.0 prompts Katana to run through standard upgrade mechanisms, which means this AttributeUpgrade node isn't necessary in that case.
2 NODES A-C | BILLBOARDCONSTRAINT Control (UI) Default Value Function celSelection > Add N/A • Paths - Adds a Paths list to this CEL parameter. Statements • Collections - Adds a Collections list to this CEL parameter. • Custom - Adds a Custom parameter to this CEL parameter. • Append Scene Graph Selection - Adds a Paths list to this CEL parameter and places selected Scene Graph locations in the new list.
2 NODES A-C | BOUNDSADJUST Control (UI) Default Value Function targetPath none Describes the object(s) location to which the basePath object is constrained. The targetPath parameter options are available by clicking Add Locations. For more information on the targetPath widget parameters, see Common Node Widgets on page 1. targetOrigin object Sets how the center of the target object is calculated: • object - uses the local origin of the object as the target.
2 NODES A-C | CAMERACLIPPINGPLANEEDIT Control (UI) Default Value Function targetPath none Describes the location of the geometry who's bounding box is being adjusted. The targetPath parameter options are available by clicking Add Locations. For more information on the targetPath widget parameters, see Common Node Widgets on page 1. action Strip Bounds Sets the type of bounding adjustment to apply: • Strip Bounds - removes the bounding box from the geometry entirely.
2 NODES A-C | CAMERACREATE NOTE: The default values change when initially connected to a camera. Control (UI) Default Value Function cameraLocation /root/world/cam/camera Describes the location of the camera. N/A The currently selected Scene Graph location is used to cameraLocation Adopt populate the parameter.
2 NODES A-C | CAMERACREATE Control (UI) Default Value Function name /root/world/cam/camera This is the Scene Graph location where the camera is created. For example, the default value of /root/world/cam/camera creates a camera at the location /root/world/cam/camera. name Parent to Scenegraph N/A Selection Parent to Scene Graph selection. N/A /root/world/geo/... Parent to N/A N/A Sets the parent location of the object created to be /root/world/cam.
2 NODES A-C | CAMERACREATE Control (UI) Default Value Function orthographicWidth 30 Sets the orthographic projection width. includeInCameraList Yes When enabled, the camera is visible in the camera list on the /root/world location, under globals. transform interface SRT Values Sets the transform control layout: • SRT Values - exposes the scale, rotation, and translation controls. • Transform Matrix - exposes a matrix to control transformations.
2 NODES A-C | CAMERAIMAGEPLANECREATE Control (UI) Default Value Function matrix 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, Controls transformations using a matrix in place of individual 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, SRT controls. 1.0, 0.0, 0.0, 0.0, 0.0, 1.0 makeInteractive Yes When set to Yes, you can drag objects in the Viewer and Katana writes the changes made to this object in this node. CameraImagePlaneCreate Creates attributes on a camera that describe an image plane.
2 NODES A-C | CAMERAIMAGEPLANECREATE Control (UI) Default Value Function imagePath none Sets the filepath of the image or sequence to display in the image plane. Supported file formats include .cin, .dpx, .rla, .iff, .tif, .jpg, .tga, .rgb, and .tga. Floating point data (.exr, .tif, .zfile) is not currently supported. Note: Image sequences must contain a padded frame number. imagePath Browse...
2 NODES A-C | CAMERAIMAGEPLANECREATE Control (UI) Default Value Function fit Best Controls how the image file fits into the image plane if there is a mismatch between aspect ratios: • Fill - the image is scaled as required to fill the plane, without being squashed or stretched. Any excess is cropped. • Best - the image is scaled as required to display it entirely within the plane, without being squashed, stretched or cropped.
2 NODES A-C | CAMERASCREENWINDOWCONSTRAINT Control (UI) Default Value y 0 Function manualPlacementSettings: Yes rotate 0 CameraScreenWindowConstraint This node is used to orient, scale, and position the base Scene Graph location so that it sits at a specified distance from the camera and fits the camera screen window exactly. Control (UI) Default Value Function basePath none Describes the Scene Graph location of the object to constrain. This should be plane geometry.
2 NODES A-C | CLIPPINGCONSTRAINT ClippingConstraint This node adjusts the camera's near and far clipping planes to fit just in front of and behind the target (along the axis from the camera). You can view the results of the ClippingConstraint node by turning on Scenegraph Implicit Resolvers at the top. Control (UI) Default Value Function basePath none Describes the Scene Graph location of the object to constrain.
2 NODES A-C | COLLECTIONCREATE CollectionCreate Collections are used to store a CEL statement. They are stored as attributes at /root. As they are simply attributes within the Scene Graph, Collections can be included within Katana Look Files. Control (UI) Default Value Function name none Sets the name of the collection. CEL none Specifies Scene Graph locations to store as part of this collection. The Scene Graph locations are specified using the Collection Expression Language (CEL).
2 NODES A-C | CONSTRAINTRESOLVE ConstraintResolve This node resolves all constraints stored on the locations referenced in globals.constraintList at /root/world. CoordinateSystemDefine Creates a named coordinate system accessed by PRMan shaders. The list of all global named coordinate systems can be found in /root/world, globals.coordinateSystems. Control (UI) Default Value Function scope global Specifies how the coordinate system is defined.
2 NODES A-C | COORDINATESYSTEMDEFINE Control (UI) Adopt Selected Nodegraph Node Default Value Function N/A Creates an expression from the currently selected Node Graph node linking the Scene Graph location created by that node to this parameter.
3 Nodes D-H DependencyMerge The DependencyMerge node takes any number of Render dependencies as inputs and consolidates them into a single link that you can wire into your dependent Render node. NOTE: Add as many ports as necessary by clicking the arrow at the top of the node in the Node Graph. Dependencies between Render nodes are represented by links between the nodes.
3 NODES D-H | DOT Control (UI) Default Value Function basePath none Describes the Scene Graph location of the camera or light to dolly. The basePath parameter options are available in either the scene graph widget or dropdown menu to the right of the parameter. For more information on the basePath widget parameters, see Common Node Widgets on page 1. targetPath none Sets the location of the object(s) to fit within the field of view.
3 NODES D-H | FACESETCREATE FaceSetCreate This node creates a set (or group) of faces in an existing mesh. This is useful in order to more easily re-select them later when making shader, attribute, and visibility assignments to a subset of faces on a single mesh. NOTE: Face sets are only applicable with subdivision meshes. Control (UI) Default Value Function meshLocation none Describes the location of the mesh for which the set is created. This is only applicable with subdivision meshes.
3 NODES D-H | FORK3D Fork3D Fork3D creates multiple instances of the upstream Scene Graph when the value of a fork variable is evaluated. The evaluation of upstream parameters varies depending on which branch of the fork node has been evaluated for a particular variable. Fork3D should be treated as an advanced function and used with care, particularly nested Fork3D nodes, as they can result in performance issues.
3 NODES D-H | GAFFER Control (UI) Default Value Function basePath none Describes the Scene Graph location of the object to constrain. The basePath parameter options are available in either the scene graph widget or dropdown menu to the right of the parameter. For more information on the basePath widget parameters, see Common Node Widgets on page 1. targetPath none Describes the object(s) location to which the basePath object is constrained.
3 NODES D-H | GAFFER NOTE: Some of the controls listed may not be available due to the extensive customizability of Katana. Some of the Gaffer node's menu options are created using profiles, which can result in different light creation menu options. Control (UI) Default Value Function profile prman Sets the basic render profile used by the Gaffer node.
3 NODES D-H | GAFFER Control (UI) Default Value Function [Gaffer object table] gaffer Displays a list of all objects controlled by this Gaffer node. The object table contains the following information: • Name - the name of the object. • M - click to mute the object so that it is omitted from renders. • S - click to solo the object so that everything not soloed is omitted from interactive renders. • Shader - displays the shader associated with the object.
3 NODES D-H | GAFFERTHREE Control (UI) Default Value Function Delete N/A Deletes the entry in the Gaffer object table selected. Lock N/A Locks the entry to prevent transformation. Materials are still editable. Duplicate N/A Creates a copy of the currently selected entry. Export Rig... N/A Exports the currently selected item as a GPRIG file. Object, Material and Linking tabs - display parameters dependent on what is selected in the Gaffer object table.
3 NODES D-H | GAFFERTHREE Control (UI) Select In Default Value Function N/A Selects the location specified by this parameter in the Scene Graph tab. Scenegraph Add > Light N/A Adds a light to the gaffer table. Add > Rig N/A Adds a rig to the gaffer table. Add > Master N/A Adds a master material to the gaffer table. The master material is assigned to lights, providing the same material for multiple lights.
3 NODES D-H | GAFFERTHREE Control (UI) Default Value Function [Gaffer object table] N/A Displays a list of all objects controlled by this Gaffer node. The object table contains the following information: • Name - the name of the object. • M - click to mute the object so that it is omitted from renders. • S - click to solo the object so that everything not soloed is omitted from interactive renders. • Shader - displays the shader associated with the object.
3 NODES D-H | GAFFERTHREE Control (UI) Default Value Function Duplicate N/A Creates a copy of the currently selected entry. Export Rig... N/A Exports the currently selected item as a RIG file. Object, Material and Linking tabs - display parameters dependent on what is selected in the Gaffer object table. Object list: light Object Tab geometry radius 1 Sets the radius of the light. fov 70 Sets the field of view angle. centerOfInterest 20 Sets the center of interest. near 0.
3 NODES D-H | GAFFERTHREE Control (UI) Default Value Function rotationOrder XYZ Sets the order in which rotation is applied: • XYZ • XZY • YXZ • YZX • ZXY • ZYX interface: SRT Values translate 0.0, 0.0, 0.0 Controls light translation on the xyz axes. rotate 0.0, 0.0, 0.0 Controls light rotation on the xyz axes. scale 1.0, 1.0, 1.0 Controls light scale on the xyz axes. interface: Transform Matrix matrix 1.0, 0.0, 0.0, 0.0, 0.
3 NODES D-H | GAFFERTHREE Control (UI) Default Value Function baseAimAxis 0.0, 0.0, -1.0 The axis of the base object that is pointed at the target. Adjusting these values changes the side of the object that is aimed at the target. baseUpAxis 0.0, 1.0, 0.0 The axis of the base object that is pointed upwards relative to the target. Adjusting these values changes the rotation of the base object, while keeping the aim constant. targetUpAxis 0.0, 1.0, 0.
3 NODES D-H | GAFFERTHREE Control (UI) Default Value Function enable exceptions Enabled When enabled, enter Scene Graph object locations to create an exception list. enabled exceptions: enabled: objects > Add Statements Paths N/A Adds a Paths list to this CEL parameter. Collections N/A Adds a Collections list to this CEL parameter. Custom N/A Adds a Custom parameter to this CEL parameter.
3 NODES D-H | GAFFERTHREE Control (UI) Default Value Function Custom N/A Adds a Custom parameter to this CEL parameter. Append Scene Graph N/A Adds a Paths list to this CEL parameter and places selected Scene Selection Replace With Scene Graph locations in the new list. N/A Graph Selection Removes any parameters within this CEL parameter and creates a new Paths list and populates it with any selected Scene Graph locations. Copy CEL Statement N/A Copies this CEL statement to the clipboard.
3 NODES D-H | GAFFERTHREE Control (UI) Default Value Function rotationOrder XYZ Sets the order in which rotation is applied: • XYZ • XZY • YXZ • YZX • ZXY • ZYX interface: SRT Values translate 0.0, 0.0, 0.0 Controls rig translation on the xyz axes. rotate 0.0, 0.0, 0.0 Controls rig rotation on the xyz axes. scale 1.0, 1.0, 1.0 Controls rig scale on the xyz axes. interface: Transform Matrix matrix 1.0, 0.0, 0.0, 0.0, 0.
3 NODES D-H | GAFFERTHREE Control (UI) Default Value Function baseOrigin Object Sets how the center of the base object is calculated: • Object - uses the local origin of the object as the target. • BoundingBox - uses the center of the object’s bounding box as the target. targetOrigin Object Sets how the center of the target object is calculated: • Object - uses the local origin of the object as the target. • BoundingBox - uses the center of the object’s bounding box as the target.
3 NODES D-H | GENERICOP Control (UI) Default Value Function useLookFileMaterial Disabled When enabled, the material from an associated LookFile is used. Add shader N/A Click to add a shader from the dropdown list. The Material Tab Material Tab is populated with controls appropriate to the shader selected. GenericOp The GenericOp node allows you to run a named specific Op.
3 NODES D-H | GENERICOP Control (UI) Default Value Function addSystemOpArgs No If enabled, adds a 'system' opArg containing information from the graph state time slice, such as frame and shutter timings. This is only necessary for some Ops. executionMode immediate Determines when the Op is run: • immediate - the script is run at the locations specified in the applyWhere parameter as it is evaluated at this node's point in the node graph.
3 NODES D-H | GENERICOP Control (UI) Default Value Function inputBehavior only valid Controls how input ports on the node are mapped onto the inputs of the underlying Op. This parameter is only meaningful when the node has one or more invalid input ports - a port that is not connected to an output port or is connected to an output port that doesn't provide data. When set to only valid, any valid input ports of then ode are skipped when determining which inputs to pass to the underlying Op.
3 NODES D-H | GENERICOP Control (UI) Default Value Function CEL > Add Statements N/A • Paths - adds a Paths list to this CEL parameter. • Collections - adds a Collections list to this CEL parameter. • Custom - adds a Custom parameter to this CEL parameter. • Append Scenegraph Selection - adds a Paths list to this CEL parameter and places selected Scene Graph locations in the new list.
3 NODES D-H | GENERICOP Control (UI) Default Value Function applyWhen during op resolve Determines when the script is run: • during op resolve - the script and its arguments are added as attributes to be executed later by an OpResolve node. If the Op isn't run by an explicit OpResolve node placed in the node graph, it is automatically run at render time by the implicit resolvers. • during material resolve - the script and its arguments are added as attributes under the material.
3 NODES D-H | GENERICOP Control (UI) Default Value Function CEL > Add Statements N/A • Paths - adds a Paths list to this CEL parameter. • Collections - adds a Collections list to this CEL parameter. • Custom - adds a Custom parameter to this CEL parameter. • Append Scenegraph Selection - adds a Paths list to this CEL parameter and places selected Scene Graph locations in the new list.
3 NODES D-H | GENERICOP Control (UI) Default Value Function recursiveEnable No When applying in a non-immediate state, enabling this results in the Op running at every location beneath the assigned locations. In general this is more efficient than using an equivalent recursive CEL statement. You can also override the ops.*.recursiveEnable attribute anywhere deeper in the tree to exclude evaluation at those locations. This is similar to the behavior of the visible or light linking attributes.
3 NODES D-H | GENERICOP Control (UI) Default Value Function resolveIds N/A When applyWhen is set to during op resolve, you may specify a space-delimited list of strings to indicate that this Op should only be resolved by Op resolvers that contain at least one matching "resolveId." This is an advanced feature for greater control over order of evaluation.
3 NODES D-H | GROUP Control (UI) Default Value Function disableAt N/A Execution is disabled for locations at or below this CEL statement. For large scene hierarchies, this is often less expensive than enabling evaluation at a larger number of leaf locations to avoid applying it to a smaller subset. Add Statements include: • Paths - adds a Paths list to this CEL parameter. • Collections - adds a Collections list to this CEL parameter. • Custom - adds a Custom parameter to this CEL parameter.
3 NODES D-H | GROUPMERGE This node is most often used to group nodes that have no input, but provide a Scene Graph location as an output. For example, the GroupMerge node could be used to manage multiple PrimitiveCreate nodes, and the output Scene Graph is all of the primitives merged together. NOTE: When the GroupMerge node is first created, its type is not defined.
3 NODES D-H | GROUPSTACK GroupStack The GroupStack node is a SuperTool that creates a convenient interface for managing a list of nodes of the same type. Within the GroupStack interface, you can create any number of nodes of the same type, and these nodes are linked together, providing a single output by connecting them one after the other in serial, in the order in which they appear in the stack.
3 NODES D-H | HIERARCHYCOPY Control (UI) Default Value Function Copy Selected Entries N/A Copies the selected node to the clipboard. Paste N/A Paste the current clipboard node into this list. Tearoff Parameters N/A Create a new floating window with the parameters of this node Of Selected Entries... on a tab inside. HierarchyCopy The HierarchyCopy node takes a Scene Graph location - or locations - and copies to a given destination location or locations.
4 Nodes I-K ImageAddMix This node performs a typical over operation using a curve LUT on the foreground input alpha, then computes the result to pass down the node tree. Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image. B enabled When enabled, affect the blue channel of the image. A enabled When enabled, affect the alpha channel of the image.
4 NODES I-K | IMAGEATOP Control (UI) Default Value Function premultiplied disabled When enabled, treat the fg colors as being premultiplied by the original alpha, before applying the new alpha adjustment. curves [bg and fg curves] N/A Adjusts the background and foreground values. X 0 Displays the currently selected X point position on the active curve. You can also adjust the selected X point by entering positional Y 1 Displays the currently selected Y point position on the active curve.
4 NODES I-K | IMAGEATOP Control (UI) Default Value Function G enabled When enabled, affect the green channel of the image. B enabled When enabled, affect the blue channel of the image. A enabled When enabled, affect the alpha channel of the image. mix 1 Dissolves between the bg image at 0 and the full merge effect at 1. Mask channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask.
4 NODES I-K | IMAGEATOP Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEATOP Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEAVERAGE Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEAVERAGE Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEAVERAGE Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEAVERAGE Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEBACKGROUNDCOLOR Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes.
4 NODES I-K | IMAGEBLACK Control (UI) Default Value Function lightness 0 Sets the lightness of the background. alpha 0 Sets the alpha value of the background. hue 0 Sets the hue of the background. saturation 0 Sets the saturation of the background. value 0 Sets the value of the background. alpha 0 Sets the alpha value of the background. color > HSV ImageBlack Generates an image where every pixel is black.
4 NODES I-K | IMAGEBLUR Control (UI) Default Value Function infiniteExtent Disabled When enabled, the color extends beyond the bounds. 0.0, 0.0, 0.0, 1.0 The color (RGBA values) of every pixel in the image. You can also color color use the below RGB, HSL, or HSV controls to set the color. color > RGB red 0 Sets the red value of the pixels. green 0 Sets the green value of the pixels. blue 0 Sets the blue value of the pixels. alpha 1 Sets the alpha value of the pixels.
4 NODES I-K | IMAGEBLUR Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image. B enabled When enabled, affect the blue channel of the image. A enabled When enabled, affect the alpha channel of the image. A The channel from the out_mask input to use as a Mask channel mask: • R - use the red channel as the mask. • G - use the green channel as the mask.
4 NODES I-K | IMAGEBLUR Control (UI) Default Value Function filter Gaussian Select the filtering algorithm to use: • Box • Triangle • Gaussian • Bell • BSpline • Mitchell borderExtend Clamp Select the border extend method for pixels required beyond the image borders: • Mirror • Clamp • Background useOverscan globals.compDefaults.useOverscan Sets whether to use upstream overscan (if available) during the border extension process.
4 NODES I-K | IMAGEBRIGHTNESS Control (UI) Default Value Function blue 1 Applies a multiplier to the blur amount for the blue channel. alpha 1 Applies a multiplier to the blur amount for the alpha channel. ImageBrightness This node multiplies the image's channels to increase or decrease brightness. Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image.
4 NODES I-K | IMAGECHANNELS Control (UI) Default Value Function fringe disabled When enabled, the mask is modified so that by default the brightness effect is limited to the fringe (semi-transparent areas). brightness 1 Adjusts the brightness of the rgb channels in the image. alpha 1 Adjusts the brightness of the alpha channel in the image. ImageChannels This node lets you: • rearrange up to 4 channels from a single image (one input) • combine channels from several inputs into one output.
4 NODES I-K | IMAGECHANNELS Control (UI) Default Value Function greenChannel G Select what to use as the green channel: • R - use the red channel from greenSource. • G - use the green channel from greenSource. • B - use the blue channel from greenSource. • A - use the alpha channel from greenSource. • Lum - use the luminance from greenSource. • 1 - set the green channel to white. • 0 - set the green channel to black. • Const - set the green channel to any constant color.
4 NODES I-K | IMAGECHANNELS Control (UI) Default Value Function alphaChannel A Select what to use as the alpha channel: • R - use the red channel from alphaSource. • G - use the green channel from alphaSource. • B - use the blue channel from alphaSource. • A - use the alpha channel from alphaSource. • Lum - use the luminance from alphaSource. • 1 - set the alpha channel to white. • 0 - set the alpha channel to black. • Const - set the alpha channel to any constant color.
4 NODES I-K | IMAGECHECKERBOARD Control (UI) Default Value Function alpha 1 Sets the alpha value of the pixels in any channels that you have set to Const. constantColor > HSV hue 0 Sets the hue of the pixels in any channels that you have set to Const. saturation 0 Sets the saturation of the pixels for any channels that you have set to Const. value 0 Sets the value of the pixels for any channels that you have set to Const.
4 NODES I-K | IMAGECLAMP Control (UI) Default Value Average Enabled Min Disabled Max Disabled Front Enabled Back Disabled Auto-Disable Upon Enabled Function Release color2 0.5000, 0.5000, 0.5000, 1.000 color2 Average Enabled Min Disabled Max Disabled Front Enabled Back Disabled Auto-Disable Upon Enabled Release checkerSize 64.0, 64.0 ImageClamp This node constrains, or clamps, values in the selected channels to a specified minimum and/or maximum range.
4 NODES I-K | IMAGECLAMP Control (UI) Default Value Function process rgba The channels to clamp. mix 1 Dissolves between the original image at 0 and the full clamp common effect at 1. common > mask channel a The channel from the out_mask input to use as a mask: • r - use the red channel as the mask. • g - use the green channel as the mask. • b - use the blue channel as the mask. • a - use the alpha channel as the mask. By default, the clamp effect is limited to the non-black areas of the mask.
4 NODES I-K | IMAGECOLOR Control (UI) Default Value Function red 16 Sets the maximum values at which the rgba channels are green 16 blue 16 alpha 1 inputs Unpremultiplied clamped. Select whether you are using a premultiplied or unpremultiplied input image: • Premultiplied - the ImageClamp node unpremultiplies the input, applies the clamp effect, and premultiplies the input again.
4 NODES I-K | IMAGECOLOR Control (UI) Default Value Function height globals.height The height of the image in pixels. The default setting, globals.height, resizes the image to the height of the resolution indicated on the Project Settings tab. infiniteExtent Disabled When enabled, the color extends beyond the bounds. 1.0, 1.0, 1.0, 1.0 The color (RGBA values) of every pixel in the image. You can also color color use the below RGB, HSL, or HSV controls to set the color.
4 NODES I-K | IMAGECONTRAST ImageContrast This adjusts the input image's contrast around a fixed color point. Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image. B enabled When enabled, affect the blue channel of the image. A enabled When enabled, affect the alpha channel of the image. mix 1 Dissolves between the original image at 0 and the full contrast effect at 1.
4 NODES I-K | IMAGECONTRAST Control (UI) Default Value Function r 1 Adjusts the image contrast in the red channel only. g 1 Adjusts the image contrast in the green channel only. b 1 Adjusts the image contrast in the blue channel only. a 1 Adjusts the image contrast in the alpha channel only. 0.1800, 0.1800, The point from which to influence the contrast. When contrast 0.1800, 0.
4 NODES I-K | IMAGECOORDINATE Control (UI) Default Value Function contrastFunction Power Select the contrast function to use: • Power • Linear inputs Unpremultiplied Select whether you are using a premultiplied or unpremultiplied input image: • Premultiplied - the ImageContrast node unpremultiplies the input, applies the contrast change, and premultiplies the input again.
4 NODES I-K | IMAGECROP ImageCrop This node removes, or crops, image information outside a defined area, though Katana has both a data window and a display window (to use the EXR terminology). • The display window is the image frame. • The data window is the area that actually contains pixels. NOTE: The data window may be larger or smaller than the display window. If it is larger, image data exists that can be pulled into the frame by downstream operations.
4 NODES I-K | IMAGEDIFFERENCE ImageDifference This node layers images together using the Difference compositing algorithm: abs(F-B). It shows how much the pixels differ and is useful for comparing two very similar images. You can also specify a different compositing algorithm using the operation control. NOTE: ImageDifference outputs the absolute value of F-B, whereas ImageMinus outputs exactly F-B. For the standard "difference matte" situation, you want ImageDifference.
4 NODES I-K | IMAGEDIFFERENCE Control (UI) Default Value Function operation ImageDifference If you don't want layer the images together using the ImageDifference compositing operation, select the operation to use instead. The following conventions apply to the below operation descriptions: • F refers to the fg input. • f refers to the fg input's alpha channel. • B refers to the bg input. • b refers to the bg input's alpha channel.
4 NODES I-K | IMAGEDIFFERENCE Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEDIFFERENCE Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEDISTORT Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEDISTORT Control (UI) Default Value Function A The channel from out_mask input to use as a Mask channel mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the distortion effect is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the distortion effect is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEDISTORT Control (UI) Default Value Function useOverscan globals.compDefaults.useOverscan When enabled, use upstream overscan (if available) during the border extension process. If overscan is available (and of usable quality), this typically yields superior results around frame edges. However, if you are unsure of this procedure or the integrity of overscanned areas is unknown, it's safer to leave this disabled.
4 NODES I-K | IMAGEDIVIDE Control (UI) Default Value Function highlightCompensation enabled When enabled, Katana adaptively compresses pixel values prior to transform filtering and reexpands them afterwards. This helps to reduce the ringing in high-contrast areas that can be a problem in linear floating point images (as we have in Katana). clampOutput enabled Filtering can introduce negative values and send values above 1.0.
4 NODES I-K | IMAGEDIVIDE Control (UI) Default Value Function A enabled When enabled, affect the alpha channel of the image. mix 1 Dissolves between the bg image at 0 and the full merge effect at 1. Mask channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask.
4 NODES I-K | IMAGEDIVIDE Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEDIVIDE Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEEXCLUSION Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEEXCLUSION Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEEXCLUSION Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEEXCLUSION Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEEXPOSURE Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEEXPOSURE Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the exposure change is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the exposure change is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEFADE Control (UI) Default Value Function units F-Stops Select the units in which the exposure is altered: • F-Stops - use the fsColor controls to adjust exposure. • Gain - use the gColor controls to adjust exposure. ImageFade This node fades the input image to a color of your choosing. By default, the image is faded to black. Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image.
4 NODES I-K | IMAGEFROM Control (UI) Default Value Function fringe disabled When enabled, the mask is modified so that by default the fade effect is limited to the fringe (semi-transparent areas). fadeToColor fadeToColor 0.0000, 0.0000, The color (RGBA values) of the fade color. You can also use the 0.0000, 0.0000 below RGB, HSL, or HSV controls to set the color. red 0 Sets the red value of the fade color. green 0 Sets the green value of the fade color.
4 NODES I-K | IMAGEFROM Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image. B enabled When enabled, affect the blue channel of the image. A enabled When enabled, affect the alpha channel of the image. mix 1 Dissolves between the bg image at 0 and the full merge effect at 1. Mask channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask.
4 NODES I-K | IMAGEFROM Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEFROM Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEGAIN Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEGAIN Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the gain adjustment is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the gain adjustment is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEGAMMA Control (UI) Default Value Function units F-Stops Select the units in which the gain is altered: • F-Stops - use the fsColor controls to adjust gain. • Gain - use the gColor controls to adjust gain. ImageGamma Applies a constant gamma value to the selected channels. This lightens or darkens the mid-tones. Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image.
4 NODES I-K | IMAGEGAMMA Control (UI) Default Value Function rgb 1 Adjusts gamma in the red, green, and blue channels. r 1 Adjusts gamma in the red channel. g 1 Adjusts gamma in the green channel. b 1 Adjusts gamma in the blue channel. a 1 Adjusts gamma in the alpha channel. 1.0000, 1.0000, The color (RGBA values). You can also use the below RGB, HSL, 1.0000, 1.0000 or HSV controls to set the color.
4 NODES I-K | IMAGEGEOMETRIC Control (UI) Default Value Function inputs Unpremultiplied Select whether you are using a premultiplied or unpremultiplied input image: • Premultiplied - the ImageGamma node unpremultiplies the input, applies the gamma change, and premultiplies the input again. This simulates applying the gamma change before the premultiplication was done, as color corrections are typically applied on unpremultiplied images.
4 NODES I-K | IMAGEGEOMETRIC Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEGEOMETRIC Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEGEOMETRIC Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEHYPOT Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEHYPOT Control (UI) Default Value Function A The channel from the out_mask input to use as a mask: Mask channel • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEHYPOT Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEHYPOT Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEIN Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEIN Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEIN Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEIN Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEINVERT Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGELEVELS Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the inversion is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the inversion is limited to the non-white areas of the mask.
4 NODES I-K | IMAGELEVELS Control (UI) Default Value Function channel a The channel from the out_mask input to use as a mask: • r - use the red channel as the mask. • g - use the green channel as the mask. • b - use the blue channel as the mask. • a - use the alpha channel as the mask. By default, the levels adjustment is limited to the non-black areas of the mask.
4 NODES I-K | IMAGEMATTE Control (UI) Default Value Function blue 1 Sets the gamma level for the blue channel. alpha 1 Sets the gamma level for the alpha channel. red 0 Sets the minimum output level for the red channel. green 0 Sets the minimum output level for the green channel. blue 0 Sets the minimum output level for the blue channel. alpha 0 Sets the minimum output level for the alpha channel. red 1 Sets the maximum output level for the red channel.
4 NODES I-K | IMAGEMATTE Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image. B enabled When enabled, affect the blue channel of the image. A enabled When enabled, affect the alpha channel of the image. mix 1 Dissolves between the bg image at 0 and the full merge effect at 1. Mask channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask.
4 NODES I-K | IMAGEMATTE Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEMATTE Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEMATTEMIX Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEMATTEMIX Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the mix effect is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the mix effect is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEMAX ImageMax This node layers images together using the Max compositing algorithm: max(F,B). It takes the maximum values of both images. This is a good way to combine mattes and useful for bringing aspects like bright hair detail through. You can also specify a different compositing algorithm using the operation control. Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image.
4 NODES I-K | IMAGEMAX Control (UI) Default Value Function operation ImageMax If you don't want layer the images together using the ImageMax compositing operation, select the operation to use instead. The following conventions apply to the below operation descriptions: • F refers to the fg input. • f refers to the fg input's alpha channel. • B refers to the bg input. • b refers to the bg input's alpha channel.
4 NODES I-K | IMAGEMAX Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEMAX Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEMIN Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEMIN Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEMIN Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEMIN Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEMINUS Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEMINUS Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEMINUS Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEMINUS Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEMIX Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEMULTIPLY Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEMULTIPLY Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEMULTIPLY Control (UI) Default Value Function operation ImageMultiply If you don't want layer the images together using the ImageMultiply compositing operation, select the operation to use instead. The following conventions apply to the below operation descriptions: • F refers to the fg input. • f refers to the fg input's alpha channel. • B refers to the bg input. • b refers to the bg input's alpha channel.
4 NODES I-K | IMAGEMULTIPLY Control (UI) Default Value operation (continued) Function • ImageIn - Bf. This only shows the areas of the background that overlap with the alpha of the foreground. It can be useful for combining mattes. • ImageMatte - Ff*B(1-f). This is a premultiplied ImageOver. Use unpremultiplied images with this operation. • ImageMax - max(F,B). This takes the maximum values of both images.
4 NODES I-K | IMAGEORIENT Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEOUT Control (UI) Default Value Function channel A The channel from out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the rotation effect is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the rotation effect is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEOUT Control (UI) Default Value Function G enabled When enabled, affect the green channel of the image. B enabled When enabled, affect the blue channel of the image. A enabled When enabled, affect the alpha channel of the image. mix 1 Dissolves between the bg image at 0 and the full merge effect at 1. Mask channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask.
4 NODES I-K | IMAGEOUT Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEOUT Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEOVER Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEOVER Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEOVER Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEOVER Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEPLUS Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEPLUS Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEPLUS Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEPLUS Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEPOSITION Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEPREMULTIPLY Control (UI) Default Value Function channel A The channel from out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the offset effect is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the offset effect is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEPREMULTIPLY Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image. B enabled When enabled, affect the blue channel of the image. A enabled When enabled, affect the alpha channel of the image. mix 1 Dissolves between the original image at 0 and the full premultiplication effect at 1.
4 NODES I-K | IMAGERAMP ImageRamp Control (UI) Default Value Function Dependent on Project Sets the size of the display window using the dropdown Settings menu. bounds [resolution] bounds Copy from Monitor ROI N/A Copy to Monitor ROI N/A type Horizontal interpolationColorspaces linear start color 1.0000, 1.0000, 1.0000, 1.0000 color Average Enabled Min Disabled Max Disabled Front Enabled Back Disabled Auto-Disable Upon Enabled Release end color 0.0000, 0.0000, 0.0000, 0.
4 NODES I-K | IMAGEREAD Control (UI) Default Value Average Enabled Min Disabled Max Disabled Front Enabled Back Disabled Auto-Disable Upon Enabled Function Release ImageRead This node loads images from disk, using the native resolution and the frame range for the sequence. It converts all imported sequences to Katana's linear colorspace automatically, but there are options to control this.
4 NODES I-K | IMAGEREAD Control (UI) Default Value Function image > rawData: disabled colorspace auto Select the colorspace for the file on disk. Upon load, the image sequence is converted from this colorspace to Katana's native floating-point linear colorspace. The default value, auto, means Katana tries to determine the bit depth from the file header and the colorspace from the file name.
4 NODES I-K | IMAGEREAD Control (UI) Default Value Function frame frame Sets the frame number actually read from disk prior to applying the inMode, outMode, firstFrame, and lastFrame settings. When a downstream node requests an image from an ImageRead node, ImageRead evaluates this control to determine the frame number to read from disk (by default this is the current time).
4 NODES I-K | IMAGEREAD Control (UI) Default Value Function firstFrame globals.inTime Sets the first valid frame of the sequence of images on disk. If a frame prior to firstFrame is required, its contents are determined based on inMode. If the file control has frame range values in it and this control is left at its default value, the value in the file control is obeyed. lastFrame globals.outTime Sets the last valid frame of the sequence of images on disk.
4 NODES I-K | IMAGEREFORMAT Control (UI) Default Value Function includeInErrorChecking enabled When enabled, Katana includes this node when it automatically checks ImageRead nodes for errors. When disabled, Katana excludes this node when it automatically checks ImageRead nodes for errors. ImageReformat Reformat lets you resize your image sequence width and height using the incoming displayWindow to determine the scale factor.
4 NODES I-K | IMAGEREFORMAT Control (UI) Default Value Function channel A The channel from out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the reformat effect is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the reformat effect is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEREFORMAT Control (UI) Default Value Function allowOverscan disabled This allows the node to generate overscan (if possible). Overscan refers to image pixel data outside of the displayWindow and can be inspected using options in the Monitor.
4 NODES I-K | IMAGESATURATION Control (UI) Default Value Function upFilter Mitchell The filter kernel to use for upsampling: • Gaussian • Triangle • Box • Bell • BSpline • Sinc • Lanczos2 • Lanczos3 • Lanczos5 • Mitchell • Bilinear • Bicubic • Nearest highlightCompensation enabled When enabled, Katana adaptively compresses pixel values prior to transform filtering and re-expands them afterwards.
4 NODES I-K | IMAGESATURATION Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image. B enabled When enabled, affect the blue channel of the image. A enabled When enabled, affect the alpha channel of the image. mix 1 Dissolves between the original image at 0 and the full saturation adjustment at 1.
4 NODES I-K | IMAGESCREEN ImageScreen This node layers images together using the Screen compositing algorithm: F+B-FB. It's similar to ImageHypot, but clamps pixel values to 1.0. This is mostly useful for combining mattes. NOTE: ImageScreen math assumes image values are between 0 and 1. If your highlights go above 1.0, ImageScreen may produce unexpected results. Also see ImageHypot on page 192. Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image.
4 NODES I-K | IMAGESCREEN Control (UI) Default Value Function operation ImageScreen If you don't want layer the images together using the ImageScreen compositing operation, select the operation to use instead. The following conventions apply to the below operation descriptions: • F refers to the fg input. • f refers to the fg input's alpha channel. • B refers to the bg input. • b refers to the bg input's alpha channel.
4 NODES I-K | IMAGESCREEN Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGESCREEN Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGETEXT Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGETEXT Control (UI) Default Value Function height globals.height The height of the text frame in pixels. The default setting, globals.height, resizes the text frame to the height of the resolution indicated on the Project Settings tab. Note: You can only edit this field when the initial resolution is modified. text none Enter the text you want to display here.
4 NODES I-K | IMAGETEXT Control (UI) Default Value Function fontFile none Lets you select a font for the text when fontSource is set to File. size 18.0, size[0] Sets the pixel size of the font. Note that because of the way fonts are generated from control splines that vary in size, you rarely get a character that is exactly this size. No character ever renders larger than this size. position getDisplayWindow The pixel position at which the justified text is placed. ().
4 NODES I-K | IMAGETEXT Control (UI) Default Value Function vjustify Center Sets how to align the text vertically: • Top - align the text along the top edge of the text frame, placing the top baseline of the text block at the location defined by position. • Center - align the text from the center of the text frame, placing the center baseline of the text block at the location defined by position.
4 NODES I-K | IMAGETHRESHOLD Control (UI) Default Value Function red 1 Sets the red value of the rendered text. green 1 Sets the green value of the rendered text. blue 1 Sets the blue value of the rendered text. alpha 1 Sets the alpha value of the rendered text. hue 0 Sets the hue of the rendered text. saturation 0 Sets the saturation of the rendered text. lightness 1 Sets the lightness of the rendered text. alpha 1 Sets the alpha value of the rendered text.
4 NODES I-K | IMAGETHRESHOLD Control (UI) Default Value Enable All N/A main N/A left N/A right N/A Function N/A mix 1 mask channel Alpha invert Disabled fringe Disabled This is common alpha treatment, which modifies a normal mask such that it only affects the fringe (semi-transparent) areas. 0.0 -> 0.0 0.5 -> 1.0 1.0 -> 0.0 out = 4a*(1-a) level 0.5000, 0.5000, 0.5000, 0.
4 NODES I-K | IMAGETHRESHOLD Control (UI) Default Value Auto-Disable Upon Enabled Function Release enableLow Enabled If enabled, any channel values below their corresponding level will be set to the corresponding low value. low 0.0000, 0.0000, The output low value. 0.0000, 0.
4 NODES I-K | IMAGETRANSFORM2D ImageTransform2D ImageTransform2D lets you not only translate elements, but also rotate, scale, and shear them. Control (UI) Default Value Function R enabled When enabled, affect the red channel of the image. G enabled When enabled, affect the green channel of the image. B enabled When enabled, affect the blue channel of the image. A enabled When enabled, affect the alpha channel of the image.
4 NODES I-K | IMAGETRANSFORM2D order trsx Sets the operation order for translate (t), rotate (r), scale (s), and shear (x). translate x, y 0, 0 Translates the image along the x and y axes. rotate 0 Rotates the image around the pivot x y coordinates. aspectRatio 1 Sets the pixel aspect ratio. This allows you to maintain aspect ratio when rotating anamorphic images. scale x, y 1, 1 Scales the image width and height around the pivot x y coordinates.
4 NODES I-K | IMAGETRANSFORM2D downFilter Lanczos3 The filter kernel to use for downsampling: • Gaussian • Triangle • Box • Bell • BSpline • Sinc • Lanczos2 • Lanczos3 • Lanczos5 • Mitchell - remapped pixels receive some smoothing, plus blurring to hide pixelation. • Bilinear - gives good results, but can produce square artifacts at extreme zoom. • Bicubic - provides more rounded results, slightly blurrier but without the square artifacts.
4 NODES I-K | IMAGETRANSFORM2D upFilter Lanczos3 The filter kernel to use for upsampling: • Gaussian • Triangle • Box • Bell • BSpline • Sinc • Lanczos2 • Lanczos3 • Lanczos5 • Mitchell - remapped pixels receive some smoothing, plus blurring to hide pixelation. • Bilinear - gives good results, but can produce square artifacts at extreme zoom. • Bicubic - provides more rounded results, slightly blurrier but without the square artifacts. • Nearest - preserves edge detail, but gives quite "blocky" textures.
4 NODES I-K | IMAGETRANSFORM2D clampOutput enabled Filtering can introduce negative values and send values above 1.0. When clampOutput is enabled, Katana clamps the RGB channels low at 0 and the alpha channel between 1 and 0 after the image is filtered. This is recommended for transforms on color/alpha images. When clampOutput is disabled, no clamping is done and values below 0 and above 1 are allowed.
4 NODES I-K | IMAGEUNDER shutter globals.compDefaults. Sets the open and close time of the shutter motionBlur.shutter.i0, when motion blurring, relative to the current frame. Changing the second number is the globals.compDefaults. primary way to control the amount of motion motionBlur.shutter.i1 blur applied. For example, a value of 0.5 corresponds to half a frame. Increasing the value produces more blur, and decreasing the value less. numSamples globals.compDefaults.
4 NODES I-K | IMAGEUNDER Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the merge is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the merge is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEUNDER Control (UI) operation (continued) Default Value Function The available operations (based on the Porter & Duff paper) are: • ImageAtop - Fb+B(1-f). This shows the shape of the background, with the foreground covering the background where the images overlap. • ImageAverage - (F+B)/2. This produces the average of the two images. The result is darker than the original images, but accentuates highlights. • ImageDifference - abs(F-B).
4 NODES I-K | IMAGEUNDER Control (UI) Default Value operation (continued) Function • ImageMin - min(F,B). This takes the minimum values of both images. • ImageMinus - B-F. This subtracts the foreground from the background. For subtracting the background from the foreground instead, see ImageFrom. • ImageMultiply - FB. This multiplies the values of the foreground by the values of the background.
4 NODES I-K | IMAGEUNPREMULTIPLY Control (UI) Default Value Function displayWindow Background The frame size to output in the event that the fg and bg inputs are different sizes: • Background - output the frame size of the bg input. • Foreground - output the frame size of the fg input. • Union - output a combination of the bg and fg inputs' frame sizes. • Intersection - output an intersection of the bg and fg inputs' frame sizes. This restricts the output to the area where the two frame sizes overlap.
4 NODES I-K | IMAGEWHITE Control (UI) Default Value Function channel A The channel from the out_mask input to use as a mask: • R - use the red channel as the mask. • G - use the green channel as the mask. • B - use the blue channel as the mask. • A - use the alpha channel as the mask. By default, the unpremultiplication is limited to the non-black areas of the mask. invert disabled Inverts the use of the mask channel so that the unpremultiplication is limited to the non-white areas of the mask.
4 NODES I-K | IMAGEWHITE Control (UI) Default Value Function bottom 0 Lets you offset the text frame by this number of pixels from the bottom. width globals.width The width of the text frame in pixels. The default setting, globals.width, resizes the text frame to the width of the resolution indicated on the Project Settings tab. Note: You can only edit this field when the initial resolution is modified. height globals.height The height of the text frame in pixels. The default setting, globals.
4 NODES I-K | IMAGEWRITE Control (UI) Default Value Function alpha 1 Sets the alpha value of the pixels. hue 0 Sets the hue of the pixels. saturation 0 Sets the saturation of the pixels. value 1 Sets the value of the pixels. alpha 1 Sets the alpha value of the pixels. color > HSV ImageWrite ImageWrite writes its incoming image to a file on disk. The ImageWrite node, unless defaults are overridden, converts images from Katana's linear colorspace to the colorspace named in the filename.
4 NODES I-K | IMAGEWRITE Control (UI) Default Value Function globals.inTime Sets the frame to render when singleFrame is singleFrame: enabled frame enabled. inputs [identifier] none Defines short input identifiers. The identifier is included in the input/output input names and is used as a prefix for the output product rep. %V is replaced with the view name. %v is replaced with the appropriate product token. Note: Input identifiers have no effect on file names, only products.
4 NODES I-K | IMAGEWRITE Control (UI) Default Value Function channels Input Selects the channels to render: • RGBA - Render the red, green, blue, and alpha channels. If any of the color channels are missing from the input, they are filled with 0 (pure black). If the alpha channel is missing, it is filled with 1 (pure white or fully opaque). • RGB - Render the red, green, and blue channels. If any of these channels are missing from the input, they are filled with 0 (pure black).
4 NODES I-K | IMAGEWRITE Control (UI) Default Value Function fileFormat exr Sets the file format to output: • auto - Katana tries to determine the output format from the file name. • exr • rla • cin • png • tif • tiff • jpg • jpeg • dpx • hist inputs > mode: file > image > rawData: disabled colorspace Inf Katana converts from linear to this colorspace when writing the file to disk. The default value, auto, means Katana tries to determine the output colorspace from the file name.
4 NODES I-K | IMAGEWRITE Control (UI) Default Value Function exrType Tiled Sets whether the exr file is written to support: • Tiled - random tile access. • Scanline - random scanline access. comments none Optional field for any comments you want to store in the output file's comment metadata field. Currently, this is only supported on the exr file format. inputs > mode: file > image > fileFormat: exr > exrType: Tiled exrTileWidth 256 Sets the tile width to use when writing to tiled exr files.
4 NODES I-K | IMAGEWRITE Control (UI) Default Value Function pngBitDepth auto Sets the bit depth of the rendered file. The default value, auto, means Katana tries to determine the bit depth from the colorspace. The other options are: • 8-bit • 16-bit inputs > mode: file > image > fileFormat: tif or tiff tifCompression LZW The tiff compression method to use: • None - No compression method is used. • LZW - The LZW compression method is used.
4 NODES I-K | IMAGEWRITE Control (UI) Default Value Function displayWindow input The frame size to write to the file: • input - Use the frame size from the input. This crops off image data outside the frame or pads the frame with black if the image bounds do not fill the frame already. • manual - Crop the output to the specified frame size, padding with black if necessary. dataWindow shrinkwrap The image area to write to the file: • shrinkwrap - Make sure the area is no larger than the frame size.
4 NODES I-K | IMAGEWRITE Control (UI) Default Value Function left 0 Overscan specifies the number of pixels to pad the render request in each direction during a disk render (including batch renders). The display window is unchanged, but this expands the data window to bottom 0 include any extra input data that has been made available by the expanded render request.
4 NODES I-K | IMAGEWRITE Control (UI) Default Value Function setActiveFrameRange disabled Sets how the active frame range for rendering is defined: When enabled, the activeFrameRange controls are displayed which define the active frame range for rendering. When disabled, Katana assumes that the active frame range is the same as the range between globals.inTime and globals.outTime.
4 NODES I-K | IMPORTOMATIC Control (UI) Default Value Function excudeFromFarmOutputGeneration disabled When enabled, this node does not appear in any generated farm file (however, the node is still renderable if called directly). Enabling this control hides the forceFarmOutputGeneration control. farmSettings > excudeFromFarmOutputGeneration: disabled forceFarmOutputGeneration disabled When enabled, this node always appears in generated farm files (regardless of whether it has any valid outputs).
4 NODES I-K | INFOCREATE • Multiple geometry entries may be selected at once, but their parameters are not displayed in the GUI. Multiple entries may be selected, moved, and regrouped at once. • If a geometry asset has version information, it is displayed in the Version column. A version can be selected by leftclicking on the triangle in the version column for a geometry listing, toggling the Show Explicit Versions button, and selecting the desired version.
4 NODES I-K | INTERACTIVERENDERFILTERS Control (UI) Default Value Function locations /root/world If leafName is not populated, info locations are created directly at the specified locations. If leafName is specified, locations named with the leafName are created as children of the specified locations. The locations array values can be modified by using the Add Locations menu options. Note: An empty or invalid location value generates a location of type error under /root.
4 NODES I-K | ISOLATE The Isolate node cannot take a collection. You can however: 1. Right-click on the collection name in the Scene Graph and select Collect and Select.... 2. From the Parameters tab of the Isolate node, select isolateLocations > Add Locations > Replace with Scene Graph Selection. Control (UI) Default Value Function isolateLocations none This is a list of locations to keep while every other location is removed by the Isolate.
4 NODES I-K | ISOLATE Control (UI) Default Value Function Enable secondary disabled When enabled, the secondary output provides a scene (inverse) output containing the Scene Graph locations which have been removed from the primary output. For example, in a scene containing the following locations: /root/world/geo /root/world/geo/box /root/world/geo/circle /root/world/lgts If /root/world/geo/box is isolated using isolateFrom /root/world/geo, the secondary output contains /root/world/geo/circle.
5 Nodes L-Q LightCreate This node is used to create a Scene Graph containing a light. LightCreate does not load the light from any file or product but instead builds an entirely novel light from the parameters you specify on this node. This node is not used generally, the Gaffer node is used instead. NOTE: LightCreate requires a light shader to function properly. LightCreate and CameraCreate are identical, except for the type of Scene GraphLocations they create, and the population of the lightList vs.
5 NODES L-Q | Control (UI) Default Value Function left -1 This set of four number parameters controls the screen window right 1 bottom -1 top 1 centerOfInterest 20 Offsets the center of interest of the light. orthographicWidth 30 Sets the orthographic projection width. includeInCameraList Yes When enabled, the light is visible in the Camera List. radius 1 Sets the light's radius. 1, 1, 1 Specifies the color of the light in the Viewer.
5 NODES L-Q | Control (UI) Default Value Function none Adds entries to the manipulators list. manipulators > Add Add Entry manipulators > manipulator0 name none preset default selected Handles • Handles • Outline • None - visible Outline • Handles • Outline • None - transform interface SRT Values Sets the transform control layout: • SRT Values - exposes the scale, rotation, and translation controls. • Transform Matrix - exposes a matrix to control transformations.
5 NODES L-Q | LIGHTLINK Control (UI) Default Value Function rotationOrder XYZ Sets the order in which rotation is applied: • XYZ • XZY • YXZ • YZX • ZXY • ZYX transform > interface: SRT Values translate 0.0, 0.0, 0.0 Controls light translation on the xyz axes. rotate 0.0, 0.0, 0.0 Controls light rotation on the xyz axes. scale 1.0, 1.0, 1.0 Controls light scale on the xyz axes. transform > interface: Transform Matrix matrix 1.0, 0.0, 0.0, 0.0, 0.
5 NODES L-Q | LIGHTLINK Control (UI) Default Value Function effect illumination Determines whether the link is acting upon the light's illumination or shadow visibility of the specified objects: • illumination • shadow visibility Shadow visibility is only currently respected by Arnold renders. action exclusive on Controls what the LightLink node's behavior: • on - turn the selected lights on for the selected objects. Does nothing else.
5 NODES L-Q | LIGHTLISTEDIT Control (UI) Default Value Function lightMode CEL Controls how you specify which lights to operate on: • CEL • Paths - included for backward compatibility. lightMode: CEL lights none When lightMode is set to CEL, this CEL statement is used to select the lights to operate on. lightMode: Paths lightPaths none When lightMode is set to Paths, this list of light path names is used as the set of lights to operate on.
5 NODES L-Q | LIVEGROUP LiveGroup The LiveGroup node is similar to the Group node except the contents are loaded from an external file. The contents of the LiveGroup can be locked (non-editable) or unlocked, and is used mainly during look development. To change the contents of a LiveGroup, you can modify the file it references or change the contents of a LiveGroup in a Katana session, then publish it back to the source file.
5 NODES L-Q | LIVEGROUPSTACK Control (UI) Default Value Function Revert N/A Reloads the LiveGroup from its current source, thus discarding any changes made while it was unlocked. Revert is only available when a source has been set. Publish... N/A Opens the Publish LiveGroup dialog for publishing the parameters and contents of the LiveGroup node as a LiveGroup source file or asset. This leaves the node in an editable state for further changes. Publish and Load...
5 NODES L-Q | LOCATIONCREATE Control (UI) Default Value Function Ignore Selected N/A Disabled for this node while it is a LiveGroupStack. View At Location N/A Sets the current view node to the selected node Delete Selected N/A Disabled for this node while it is a LiveGroupStack. N/A Disabled for this node while it is a LiveGroupStack. Cut Selected Entries N/A Disabled for this node while it is a LiveGroupStack. Copy Selected Entries N/A Copies the selected node to the clipboard.
5 NODES L-Q | LODGROUPCREATE Control (UI) Default Value Function locations /root/world Sets one or more Scene Graph path(s) to the location(s) to be created. The locations parameter options are available by clicking Add Locations. For more information on the locations widget parameters, see Common Node Widgets on page 1. attrs None Drag string or number attributes here to have them added to the Scene Graph location(s) created by this node.
5 NODES L-Q | LODSELECT Control (UI) Default Value Function Add Input N/A Menu option to add a new node input and create an additional level-of-detail location to store its scene. inputs > input0 minVisible 0 When the bounding box is transformed to screen space, if its pixel count is less than the minVisible parameter, the object is not displayed.
5 NODES L-Q | LODVALUESASSIGN • by weight - select the level-of-detail location to keep based on its info > componentLodWeight attribute. The level-of-detail location below the level-of-detail group location that is closest to the weight specified in the selectionWeight parameter is kept. Control (UI) Default Value Function CEL none Specifies the Scene Graph locations on which an operation or assignment acts. The Scene Graph locations are specified using the Collection Expression Language (CEL).
5 NODES L-Q | LODVALUESASSIGN calculation of the bounding box mapped to the screen is different. For more on how to get the most out of these parameters, please review the PRMan documentation. Each child location requires an LOD range and must be added using the ranges > Add > Add Entry menu option. Control (UI) Default Value Function CEL none Specifies Scene Graph locations on which the operation or assignment acts.
5 NODES L-Q | LOOKFILEASSIGN maxVisible 9999999999999999 When the bounding box is transformed to screen space, if its 7748809823456034029568 pixel count is less than the maxVisible parameter, the object is not displayed. LookFileAssign Assigns a LookFile to a Scene Graph location defined by a CEL statement. Control (UI) Default Value Function CEL None Specifies the Scene Graph location(s) where the LookFile is assigned.
5 NODES L-Q | LOOKFILEGLOBALSASSIGN Control (UI) Default Value Function passes None Passes are typically render passes, but could also be auxiliary baking passes for generating point clouds or brickmaps. A LookFile can have one or multiple passes. To add a pass, select Add > Add Pass Input. A new pass input is created on the node, and a pass name field is added to the pass list. To change the pass name, simply change the name text field supplied. Note: All pass names must be unique.
5 NODES L-Q | LOOKFILELIGHTANDCONSTRAINTACTIVATOR Control (UI) Default Value Function asset none The asset to assign to the LookFile. resolveImmediately No When set to Yes, LookFileResolve runs on the root of the scene as part of this node. This is useful for overriding or layering scene root attributes from published LookFile assets This option has special behavior during LookFile baking. Instead of resolving, it appends the Look to the lookfile.referencedAssets attribute.
5 NODES L-Q | LOOKFILEMANAGER Control (UI) Default Value Function Action none Searches the Scene Graph for lights and constraints brought in by LookFiles then enables or disables the results as required. LookFileManager LookFileManager decodes incoming LookFiles that have been set up in another scene. Each LookFile piece of imported geometry passed into this node must be assigned through a LookFileAssign node.
5 NODES L-Q | LOOKFILEMATERIALSOUT Control (UI) Default Value Function locationForMaterials Load at original Sets where in the Scene Graph to import the materials from: location • Load at original location - the materials maintain the same location. • Load at specified location - provides a parameter, userLocation, that acts as a namespace for the material palette.
5 NODES L-Q | LOOKFILEMULTIBAKE Control (UI) Default Value Path N/A Append Scenegraph Selection N/A Replace with Scenegraph Selection N/A Append Nodegraph Node Locations N/A Replace with Nodegraph Node N/A Function Locations Clear All N/A Find Instances Beneath Scenegraph N/A Selection... N/A saveTo Brings up a searchable list to aid in selection. N/A saveTo Browse...
5 NODES L-Q | LOOKFILEOVERRIDEENABLE LookFileOverrideEnable Control (UI) Default Value lookfile N/A Function lookfile Browse... N/A Set Node Name from N/A Path overrideWith Only this Version locationForMaterials Use asset name When locationForMaterials: User-specified userLocation N/A passName Choose Look File Pass from Location loadAsReference No LookFileResolve This node applies a specific pass from assigned LookFiles to the scene.
5 NODES L-Q | MATERIAL Material This node defines a material which is a set of shader calls and associated parameters. Materials are assigned to geometry using the MaterialAssign node. Control (UI) Default Value Function name Material Sets the node name. It's a good idea to use a meaningful name such as mtl_red.
5 NODES L-Q | MATERIAL Control (UI) Default Value Function action create new material Determines the node's behavior: create new material - creates a new Scene Graph location of type geometry material or light material beneath /root/materials/(geo|lgt) with the name specified by the name parameter. create from LookFile - creates a new Scene Graph location of type geometry material or light material from a specified LookFile with the name specified by the name parameter.
5 NODES L-Q | MATERIAL Control (UI) Default Value namespace none makeInteractive Yes Function When set to Yes, you can drag objects in the Viewer and Katana retains the information from the Viewer. Add shader N/A Click to add a render specific shader to the material. The shader available changes depending on the renderers installed.
5 NODES L-Q | MATERIALASSIGN MaterialAssign Assigns materials to geometry in the Scene Graph. Control (UI) Default Value Function CEL none Sets the CEL specification of Scene Graph locations on which the assignment will act. materialAssign none Specifies the material to assign. Typically, you'll middle-mouse drag this from under /root/materials/geo in the Scene Graph. MaterialResolve Resolves materials in the Scene Graph.
5 NODES L-Q | MERGE • Right-click in the Node Graph on the Merge node input ports to delete any unused ports. • Right-click on a node while connecting a link in the Node Graph to display a popup menu of ports to connect to; this can be easier than hunting for a specific port on a Merge. • Hit the tilde key (~) while connecting a link in the Node Graph to connect to the left most open port on the node, or add a new port if none are free.
5 NODES L-Q | NETWORKMATERIAL Control (UI) Default Value Function preserveInheritedAttributes none Displays a list of attribute names for which inheritance should be preserved when choosing between inputs of the Merge. Whenever a child location's source input differs from that of its parent, these attributes will be queried globally and applied locally the child location.
5 NODES L-Q | NETWORKMATERIAL Control (UI) Default Value arnold > bump N/A arnold > N/A Function displacement arnold > light N/A arnold > lightFilter N/A prman > surface N/A prman > N/A displacement prman > atmosphere N/A prman > interior N/A prman > exterior N/A prman > light N/A prman > coshader N/A viewer > surface N/A viewer > light N/A Material Interface or [Right-click menu] Rebuild with Current N/A State Remove Selected N/A Local Definition...
5 NODES L-Q | NETWORKMATERIALINTERFACECONTROLS NetworkMaterialInterfaceControls Control (UI) Default Value materialLocation N/A Function materialLocation Adopt Scenegraph Selection N/A Adopt Selected Nodegraph Node N/A state visibility targetType parameter targetName N/A definitionStyle operator tree definitionStyle: operator tree operators op and ops > Add contains N/A doesNotContain N/A endsWith N/A equalTo N/A greaterThan N/A greaterThanOrEqualTo N/A in N/A lessThan N/A
5 NODES L-Q | NETWORKMATERIALPARAMETEREDIT Control (UI) Default Value notEqualTo N/A notIn N/A numChildrenEqualTo N/A numChildrenGreaterThanOrEqualTo N/A regex N/A and N/A in N/A Function definitionStyle: conditional state expression expression N/A NetworkMaterialParameterEdit Control (UI) Default Value name NetworkMaterialParameterEdit action edit existing location Function action: edit existing location Material to Edit location Adopt Scenegraph N/A Selection Adopt Selected N
5 NODES L-Q | NETWORKMATERIALSPLICE Control (UI) Default Value Function location Adopt Scenegraph N/A Selection Adopt Selected N/A Nodegraph Node NetworkMaterialSplice Control (UI) Default Value name NetworkMaterialSplice action edit existing location Function action: edit existing location edit location Adopt Scenegraph N/A Selection Adopt Selected N/A Nodegraph Node action: inherit from existing material location inheritsFrom location Adopt Scenegraph N/A Selection Adopt Selected N/
5 NODES L-Q | NETWORKMATERIALSPLICE Control (UI) Default Value Function inputs > append action connect action: connect connectToNode N/A connectToPort N/A action: insert connectToNode N/A connectToPort N/A reconnectToNode N/A reconnectToPort N/A extraConnections N/A extraConnections >Add Add Entry N/A c0 > N/A connectfromNode c0 > out connectFromPort c0 > connectToNode N/A c0 > connectToPort N/A disconnections N/A disconnections >Add Add Entry N/A d0 > node N/A d0 > port
5 NODES L-Q | NONPERSISTENTSWITCH NonpersistentSwitch This node is identical to the Switch node, except that the in control is reset to 0 whenever the file is loaded (the value you set it to in your current session is never saved to the .katana file). This is useful for switches you may want to use interactively (low-quality settings, etc), that you don't want to mistakenly have set for a batch render. Using a NonpersistentSwitch ensures that batch renders always get the leftmost input to the node.
5 NODES L-Q | OCIOCOLORSPACE OCIOColorSpace This node coverts the input colorspace to another specified colorspace. Control (UI) Default Value Function inColorSpace Inf Sets the input colorspace to convert from. outColorSpace Inf Sets the output colorspace to convert to. context key1 none value1 none key2 none value2 none key3 none value3 none key4 none value4 none OCIODisplay This node is used to covert the input colorspace to display device suitable values.
5 NODES L-Q | OCIOFILETRANSFORM Control (UI) Default Value Function view Film • Film • Log • Raw exposure rgb 0 Sets the exposure level for the r, g, and b channels together. r 0 Sets the exposure level for the red channel. g 0 Sets the exposure level for the green channel. b 0 Sets the exposure level for the blue channel.
5 NODES L-Q | OCIOLOGCONVERT Control (UI) Default Value Function src none Specifies the src file path and name to use for the transform. This can be any file format that OpenColorIO supports: .3dl, .cc, .ccc, .csp, .cub, .cube, .lut (Houdini), .mga, .m3d, .spi1d, .spi3d, .spimtx, .vf cccid none When src points to a .ccc file, specify the id to lookup. OpenColorIO::Contexts (envvars) are obeyed.
5 NODES L-Q | OCIOLOOKTRANSFORM Control (UI) Default Value Function operation Lin To Log Select the operation to perform: • Log To Lin - convert from a logarithmic (Cineon) format to Katana's linear colorspace. • Lin To Log - convert from Katana's linear colorspace to a logarithmic (Cineon) format. OCIOLookTransform This node provides a way to apply per-shot color correction as specified using the OpenColorIO look mechanism.
5 NODES L-Q | OPSCRIPT Control (UI) Default Value Function resolveWithIds all When an Op has been deferred to run during op resolve you must specify the resolveID. If the resolveWithIds option is set to all, it processes all the ops set to run during op resolve. If the option is set to selected, it only processes those that have at least one resolveId that matches the values set in the specifiedResolveIds field.
5 NODES L-Q | OPSCRIPT Control (UI) Default Value Function Script N/A • Edit in ... - opens an external editor for editing the lua script. Changes are synced back into Katana on file save. Note: the external editor can be configured in the Preferences under externalTools > Editor. • lua - contains the lua script to run.
5 NODES L-Q | OPSCRIPT Control (UI) Default Value Function inputBehavior only valid Controls how input ports on the node are mapped onto the inputs of the underlying Op. This parameter is only meaningful when the node has one or more invalid input ports - a port that is not connected to an output port or is connected to an output port that doesn't provide data. When set to only valid, any valid input ports of then ode are skipped when determining which inputs to pass to the underlying Op.
5 NODES L-Q | OPSCRIPT Control (UI) Default Value Function applyWhen during op resolve Determines when the script is run: • during op resolve - the script and its arguments are added as attributes to be executed later by an OpResolve node. If the Op isn't run by an explicit OpResolve node placed in the node graph, it is automatically run at render time by the implicit resolvers. • during material resolve - the script and its arguments are added as attributes under the material.
5 NODES L-Q | OPSCRIPT Control (UI) Default Value Function resolveIds N/A Specify a space-delimited list of strings to indicate that this script should only be resolved by Op resolvers which contain at least one matching "resolveId." This is an advanced feature for greater control over order of evaluation. recursiveEnable No When applying in a non-immediate state, enabling this results in the script running at every location beneath the assigned locations.
5 NODES L-Q | OPSCRIPT Control (UI) Default Value Function executionMode: deferred, during Katana look file resolve recursiveEnable No When applying in a non-immediate state, enabling this results in the script running at every location beneath the assigned locations. In general this is more efficient than using an equivalent recursive CEL statement. You can also override the ops.*.recursiveEnable attribute anywhere deeper in the tree to exclude evaluation at those locations.
5 NODES L-Q | ORIENTCONSTRAINT OrientConstraint OrientConstraint matches the rotation (orientation) of the object in basePath to the object in targetPath. See also ParentChildConstraint below and PointConstraint on the next page. Control (UI) Default Value Function basePath none Sets the location of the object to constrain. targetPath none Sets the location of the object(s) to constrain the object in basePath to.
5 NODES L-Q | POINTCONSTRAINT PointConstraint Applies a constraint that translates the base object to a point defined by the target object(s). See also OrientConstraint on the previous page and ParentChildConstraint on the previous page. Control (UI) Default Value Function basePath None Defines the location of the object to constrain. targetPath None Defines the location of the object(s) to constrain the object in basePath to.
5 NODES L-Q | PRIMITIVECREATE PrimitiveCreate Adds a primitive geometry element to a scene such as sphere, cube, or cylinder as well as renderer procedural, rib archive, brickmap and clipping plane. Control (UI) Default Value Function name /root/world/geo/primitive Describes the Scene Graph location where the object is created. type sphere Sets the type of primitive created (plane, sphere, etc.
5 NODES L-Q | PRMANGLOBALSETTINGS Control (UI) Default Value Function rotate 0.0, 0.0, 0.0 Controls light rotation on the xyz axes. scale 1.0, 1.0, 1.0 Controls light scale on the xyz axes. interface: Transform Matrix matrix 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, Controls transformations using a matrix in place of individual 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, SRT controls. 1.0, 0.0, 0.0, 0.0, 0.0, 1.
5 NODES L-Q | PRMANGLOBALSETTINGS Control (UI) Default Value Function shutterOpening [ 0.0 1.0 ] Controls the speed of shutter opening and closing. Its two arguments, a and b, are fractions of the shutter interval specified in RiShutter. Over the first part of the shutter interval, from 0 to a, the shutter gradually admits more light; from a to b it is fully open; and from b to 1 it gradually closes. The rate of opening and closing is constant. camera imageBackground [ 0.0 0.0 0.
5 NODES L-Q | PRMANGLOBALSETTINGS Control (UI) Default Value Function shadingInterpolation constant Controls how values are interpolated across a micropolygon. If constant, the color and opacity of all the pixels inside the micropolygon are the same. If smooth, the colors and opacities are interpolated from the calculated values. Note that this must be set to smooth for use with C.entered Derivatives and Normals.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function Disables the error codes entered. For example, adding a new field, with entry R20092 suppresses any errors of type R20092. You can add multiple fields, and each field takes a single entry. levelOfDetail alternateLodCamera N/A alternateLodResolution N/A quantize rgba [ 1.0 1.0 1.0 1.0 ] z [ 1.0 1.0 1.0 1.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function Yes Sets whether or not derivatives are calculated symmetric derivatives centered with respect to the (u,v) parameterization. This setting only takes effect when smooth shading is enabled. extrapolate Yes Sets whether or not derivatives are extrapolated. This setting only takes effect when smooth shading is enabled.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function referenceCamera worldCamera This option sets which camera to use when dicing geometry. Dicing can be calculated from any camera, not just the render camera, such as when rendering a stereoscopic scene from two cameras, and using a third reference - camera to calculate dicing from.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function coordinatesystem object The coordinate system used by displacementbound.sphere. irradiance maxerror 0.5 When set to 0, irradiance is computed at every shading point, with no attempt at interpolation. Interpolation with nearby irradiance values increases with maxerror values. maxpixeldist 30 Sets the maximum pixel distance between interpolation sources.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function shadingmodel matte Specifies a simplified shading model to use when tracing photons. Valid strings are glass, water, chrome, matte, transparent, refractive:ior=... (wherein the index of refraction can be set to any number greater than or equal to 1), dielectric, point cloud:..., brickmap:..., or absorbing. "" means matte (the default). For volumes, valid strings are isotropic, rayleigh, hazymie, murkymie, henyeygreenstein:g=...
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function maxspeculardepth 2 Limits the number of specular bounces for indirect illuminance, relative to the associated primitive. To resolve the interaction between per-primitive values when different objects have different values of these attributes, the current max is passed down the ray tree, then maxspecularepth = MIN(parent.maxspeculardepth, parent.speculardepth + object.maxspeculardepth).
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function user N/A PRMan supports the use of arbitrarily defined token/value pairs for the user attribute. These token/value pairs may be arbitrarily defined and set, and then queried with the attribute shadeop or via the RxAttribute mechanism. Like other attributes, all token/value pairs associated with this attribute will be pushed and popped on the graphics stack with each RiAttributeBegin and RiAttributeEnd call.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function depthrelativeshadingrate 1 By default, shading rates are isotropic, and the shading rate in depth is the same as the shading rate perpendicular to the camera or incoming ray. The shading rate in this case is set using the ShadingRate attribute. If a depthrelativeshadingrate is specified, the ShadingRate is independently multiplied by the depthRelativeShading rate, with the product determining the shading rate used in the volumetric.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function diffusehitmode primitive When set to primitive, the Cs and Os vertex variables (or Color and Opacity attributes) associated with the hit object are used as the color and opacity of the hit point, without any further shading computation.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function relativeshadingrate 1 Sets the value of the relative shading rate equal to relativeshadingrate multiplied by any other relativeshadingrate values in the Attribute stack. It can also be passed two float values wherein the first value is the relativeshadingrate and the second is a multiplier on the shading rate in Z, for volumes, equivalent to setting the depthrelativeshadingrate attribute.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function attributecombining strict Allows relaxation of the rules governing whether or not two grids can be combined and shaded together when using the attribute() shadeop. For example, allows grids to be combined where each has a different value for an attribute queried in a shader and assigned a uniform value. Note: A subset of attributes are considered critical, and attributecombining cannot relax rules in relation to them.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function z_flip Yes Determines whether lights orient along positive or negative Z. geometricApproximation motionfactor 0 Controls the trade off between quality and rendering time, when rendering motion blurred objects whose motion in screen space is large.
5 NODES L-Q | PRMANOBJECTSETTINGS Control (UI) Default Value Function sides 2 When set to 2, subsequent surfaces are considered twosided and both the inside and the outside of the surface are visible. When set to 1, subsequent surfaces are considered one-sided and only the outside of the surface is visible. shadinginterpolation smooth Controls how values are interpolated between shading samples (usually across a polygon).
5 NODES L-Q | PRMANOUTPUTCHANNELDEFINE Control (UI) Default Value Function ribinclude N/A This is a place where you can add any arbitrary rib code to the section of the rib defined by the cel statement. If the string entered appears to be a rib file (ends with .rib), the contents of the file will be included as a rib archive. Otherwise, the text itself is entered into the rib stream.
5 NODES L-Q | PRMANSHADINGNODE Control (UI) Default Value name none type varying float params none Function PrmanShadingNode Control (UI) Default Value name none nodeType varying float Function parameters publicInterface namePrefix pagePrefix nameRegExFind nameRegExReplace nameRegExFind pageRegExReplace Prune The Prune node removes objects from a scene. Any location that matches the given CEL statement is removed from the output.
5 NODES L-Q | PRUNE • To prune out all polymesh objects, use a 'Custom' type statement that looks like this: //*{@type=="polymesh"} Change polymesh to whatever type you're interested in to remove that type. • You don't need to prune out an object to prevent it from being used in a render. The VisiblityAssign node is another way of removing objects from the render without actually removing the object from the scene.
6 Nodes R-Z ReflectionConstraint ReflectionConstraint transforms the base object to a mirrored position opposite the target plane object. Control (UI) Default Value Function basePath none Sets the object to constrain. targetPath none Sets the object(s) to constrain the object in basePath to. Rename This node is useful for renaming Scene Graph locations according to regular expression matching and substitution. Be aware that many operations are dependent on the names of Scene Graph locations.
6 NODES R-Z | RENDER Render The Render node takes a scene as input and renders images. The first input on this node is the scene to render. Additional inputs are dependency connections, which are used to track dependencies between passes when rendering on the cue. Each Render node is intended to be a single invocation of RenderMan or other renderer. The Render node is really only used to track cue settings, product names and which previously defined output passes are to be used.
6 NODES R-Z | RENDER Control (UI) Default Value Function none Manages which available outputs are active. disabled When enabled, activeFrameRange parameters are outputs outputs farmGlobalSettings setActiveFrameRange exposed to define the active frame range for rendering. When disabled, the active frame range is assumed to be the same as globals.inTime and globals.outTime. Note: The active frame range affects farm file generation and ShadowRenderAssign node assignments.
6 NODES R-Z | RENDEROUTPUTDEFINE Control (UI) Default Value Function forceFarmOutputGeneration disabled When enabled, this node always appears in a generated farm file (regardless of whether it has any valid outputs). Note: If excludeFromFarmOutputGeneration is also set, the node does not appear in the generated farm file (excludeFromFarmOutputGeneration overrides forceFarmOutputGeneration). RenderOutputDefine Specifies output of an image (color, AOV, shadow map, etc.) to a file.
6 NODES R-Z | RENDEROUTPUTDEFINE Control (UI) Default Value Function type color Specifies the type of output. • color - mostly used to render out rgb beauty files, but also can be used for rendering out z, P(point), N(normals), Ci(final shader color) passes. • shadow - renders out PRMan z and deepshad(deep shadow) files. • raw - allows you to directly specify the values for a Display line.
6 NODES R-Z | RENDEROUTPUTDEFINE Control (UI) Default Value Function exrCompression Scanline ZIP Defines the exr compression method to use. All methods are lossless (with the exception of Pixar24, which is lossless but quantisizes the pixels to 24-bit float). Wavelet is generally preferable as it offers ~2:1 compression even on grainy data. exrBitDepth 16 Sets the floating point precision of the rendered exr file: • 16 - half float. This is recommended for all color passes. • 32 - full float.
6 NODES R-Z | RENDEROUTPUTDEFINE Control (UI) Default Value Function computeStats None Allows you to compute image statistics as a post process, appending as exr metadata. Select: • None • Raw • Depth Note: In depth mode, zero values and very large values are ignored. In both modes, only the region within the dataWindow is considered.
6 NODES R-Z | RENDERSCRIPT Control (UI) Default Value Function clampOutput No When set to Yes, post-render clamp negative rgb values to 0, and clamp alpha values to 0-1. Note: clampOutout has no effect on NaN and inf values. colorConvert Yes When set to Yes, post-render convert rendered image data from linear to the output colorspace specified in the filename.
6 NODES R-Z | RENDERSCRIPT Control (UI) Default Value Function command shell Sets the outline function to generate. Default value of 'shell' expects a single commandArgument which is the shell command to run on the farm. Example: command("nodeName", "commandArg1", "commandArg2", "keywordName1" => "keywordValue1", "keywordName2" => "keywordValue2", ) commandArguments commandArguments none Array of positional arguments added to the outline function.
6 NODES R-Z | RENDERSCRIPT Control (UI) Default Value Function keywordArguments none Array of keyword arguments (name => value pairs) added to the outline function. Example: command("nodeName", "commandArg1", "commandArg2", "keywordName1" => "keywordValue1", "keywordName2" => "keywordValue2", ) pythonImports pythonImports none Array of import statements to be added to the Python farm file. Example: from outline.modules.shell import Shell or import outline.module.
6 NODES R-Z | RENDERSETTINGS Control (UI) Default Value Function 1 When setActiveFrameRange is enabled, sets the setActiveFrameRange: enabled start start of the active frame range. end 1 When setActiveFrameRange is enabled, sets the end of the active frame range. dependAll disabled When enabled, farm dependencies wait until all frames of this node are rendered before rendering themselves.
6 NODES R-Z | SCALECONSTRAINT Control (UI) Default Value Function cameraName /root/world/cam/camera Specifies the camera that the scene should be rendered through. The field contains at path to the camera's location in the Scene Graph. renderer prman Specifies the renderer to use. resolution 512x512 Sets the size of the output image. overscan 0 Pads the data window of the resulting render by the specified pixel amount on each side. The frame window is unchanged.
6 NODES R-Z | SCENEGRAPHGENERATORRESOLVE Control (UI) Default Value Function basePath None Sets the object to constrain. targetPath None Sets the object(s) to constrain the object in basePath to. ScenegraphGeneratorResolve This node resolves external procedurals specified by upstream ScenegraphGeneratorSetup nodes. ScenegraphGeneratorSetup The ScenegraphGeneratorSetup node is used to put the arguments needed for the external procedure into the Scene Graph.
6 NODES R-Z | SCREENCOORDINATECONSTRAINT NOTE: ScenegraphXML is provided as a reference example only. It is not intended for production use, and is not supported. Some asset elements that can be described within a ScenegraphXml file are: • Assembly locations • Component locations • Level-of-detail group locations • Level-of-detail locations • Other XML locations Control (UI) Default Value Function name /root/world/geo Describes where the scene is imported in the Scene Graph.
6 NODES R-Z | SHADOWBRANCH Control (UI) Default Value Function respectMotionBlur Yes When set to Yes, constraints are adjusted to allow for the target's motion within the time the shutter is open. targetBounds Box The type of bounds to use for the target object(s): • box - the screen window is constrained to fit the bounding box of the target object(s). • sphere - the screen window is constrained to fit a sphere that encloses the bounding box of the target objects(s).
6 NODES R-Z | SHADOWMANAGER Control (UI) Default Value Function defineOutputs primary shadow Acts like a render output device with override capabilities. Select: • no override • primary shadow • primary deepshad • primary shadow, secondary deepshad • primary color, secondary deepshad. shadowBranch resolution 512x512 Sets the resolution of the image(s). pixelSamples 1.0, 1.0 Sets the sub-pixel sampling rate (X x Y samples) zthreshold 0.9960, 0.
6 NODES R-Z | TEAPOTCREATE Control (UI) Default Value Function ShadowBranch N/A See ShadowBranch node information. Add light N/A [Add light object N/A [Pass Added] table] Pass list [Right-click menu] Delete N/A View From N/A Deletes selected pass from the pass list. ShadowBranch Node TeapotCreate This node creates a specific type of PrimitiveCreate node rendering a teapot instead of a sphere or cube. See also PrimitiveCreate on page 333.
6 NODES R-Z | TEAPOTCREATE Control (UI) Default Value Function transformOrder Scale Rotate Translate Sets the order in which transforms are applied: • Scale Rotate Translate • Scale Translate Rotate • Rotate Scale Translate • Rotate Translate Scale • Translate Scale Rotate • Translate Rotate Scale rotationOrder XYZ Sets the order in which rotation is applied: • XYZ • XZY • YXZ • YZX • ZXY • ZYX interface: SRT Values translate 0.0, 0.0, 0.0 Controls light translation on the xyz axes. rotate 0.
6 NODES R-Z | TELEPORT Teleport This node can be used to visually clean up a scene by hiding the lines between nodes. In order to attach more than one node to the Teleport node, click Add > Add Pass Input. Then, in the Node Graph, you can drag a line from any node to connect it. When inputs are not shown, each connected node will appear on the Teleport node as an output arrow. Control (UI) Default Value Function name output Sets the name for each input.
6 NODES R-Z | VARIABLEDELETE Control (UI) Default Value Function path /root/world/geo Sets the path to a Scene Graph location. order Scale Rot Trans Sets the order to apply the transform. rotateOrder Rx Ry Rz Sets the order of each rotation. stackOrder First Sets whether to apply before or after the transforms. translate 0.0, 0.0, 0.0 Moves the object up, down, left, right, in or out (of 3D space). rotate 0.0, 0.0, 0.0 Specifies the pivoting around the pivot (axis). scale 1.0, 1.0, 1.
6 NODES R-Z | VARIABLESET Control (UI) Default Value Function variableName var1 Specify the name of the graph state variable to which you want to match a specific pattern. pattern N/A Specify the pattern input that the graph state variable should match in order to enable the variable group. A pattern can be any input. The pattern parameter is a CEL statement widget. For more information about CEL statements, refer to Common Node Widgets on page 1.
6 NODES R-Z | VELOCITYAPPLY Control (UI) Default Value Function patterns N/A Specify the pattern input that the graph state variable should match in order to route a specific set of nodes through part of the node graph. A pattern can be any input. You can add as many ports as you'd like to patterns, as well as adding a pattern to each port by clicking on those options in the wrench dropdown menu. The patterns parameter is a CEL statement widget.
6 NODES R-Z | VIEWEROBJECTSETTINGS Control (UI) Default Value Function CEL none Collection Expression Language. Used to specify Scene Graph locations on which an operation or assignment will act. For more information, see the CEL Reference document found on the documentation HTML page (accessed through the Help > Documentation menu option). drawOptions hide No Sets whether the object should be hidden in the Viewer.
6 NODES R-Z | VISIBILITYASSIGN Control (UI) Default Value Function smoothing inherit When the objects referenced by the CEL statement are being displayed as points or lines, this parameter sets whether they should be anti-aliased. The options are: • off - no anti-aliasing. • lines - when displayed as a wireframe, the objects are antialiased. • points - when displayed using points, the objects are antialiased. • both - when displayed as a wireframe or using points, the objects are anti-aliased.
6 NODES R-Z | ZOOMTORECT Control (UI) Default Value Function CEL none Collection Expression Language. Used to specify Scene Graph locations on which an operation or assignment will act. Specifies what part of the Scene Graph to assign this attribute to. For more information, see the CEL Reference document found on the documentation HTML page (accessed through the Help > Documentation menu option). visible 1 Sets the visibility of objects in the render.
