set_null

Synopsis

flag a specified data value as NULL or not NULL in one component of a field

Input Ports

in_field	Node_Data
ui_parent	user interface parent object

Parameters

data component	UIradioBoxLabel	set component to flag as null or not null
Null Value	UIfieldTypein	value of NULL data
unset null	UItoggle	set to not null

Output Ports

out_fld	Mesh + Node_Data
out_obj	output renderable object

Description

set_null alters a field by defining a specified value as a NULL value and setting the flag that indicates the presence of NULL data to 1 ("has null data"). This is done on a per-component basis--one component may have NULL data while others do not.

set_null can also unset the flag that indicates NULL data.

Input Ports

in_field

The input must contain Node_Data.

ui_parent

A port to connect to a user interface object that contains the macro's widgets. By default, it is connected to the default user interface object in the application in which the macro is instanced. (This default connection is not drawn.)

Parameters

data component

UIradioBoxLabel. Radio buttons to pick which component will be flagged as having NULL data (or to unflag). The components can be scalar or vector. The default is the first (0th) component. If node data labels are present, they are displayed.

Null Value

UIfieldTypein. A float typein. Specifies the data value that is treated as a NULL value. The default is 0.

unset null

UItoggle. Unflag data component as having NULL data. The default is off.

Output Ports

out_fld

The output is a reference to the input field. The input field's Node_Data has been altered so that the null_flag =1 and null_value is set for the component's Data_Array. set_null is one of the few macros that actually changes its input data field.

If unset was toggled, null_flag=0.

out_obj

This is a renderable version of the output field. (The field is renderable only if it included a mesh.)

Example

Libraries.Examples.Visualization.Null_Data
examples/nulldt.v

File

v/modules.v