PDG_AttributeTypes.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * COMMENTS:
 */

#ifndef __PDG_ATTRIBUTE_TYPES_H__
#define __PDG_ATTRIBUTE_TYPES_H__

#include <SYS/SYS_Types.h>

/// Enumeration of possible attribute types
enum class PDG_AttributeType : uint8
{
    /// An array of `int` values
    eIntegerArray,

    /// An array of `fpreal` values
    eFloatArray,

    /// An array of `UT_StringHolder` values
    eStringArray,

    /// An array of `PDG_File` values, e.g. File info structs
    eFileArray,

    /// A single, opaque PyObject
    ePythonObject,

    /// A single PDG_ApplicationShim::Geometry instance
    eGeometry,

    /// Undefined or uninitialized attribute type
    eUndefined
};

/// Enumeration of extra attribute flags. Flags can be ORed together.
enum class PDG_AttributeFlag : uint16
{
    /// Covenience value, all flags off
    eNoFlags            = 0x0000,

    /// The attribute should not be copied onto downstream work items
    eNoCopyFlag         = 0x0001,

    /// The attribute's value should be exported to the job environment
    eEnvExportFlag      = 0x0002,

    /// The attribute is read-only and cannot be modified on this work item
    eReadOnlyFlag       = 0x0004,

    /// The attribute is for internal use, and will be accessed with other
    /// API methods. It should not be displayed in the UI
    eInternalFlag       = 0x0008,

    /// The attribute contains a operator path
    eOperatorFlag       = 0x0010,

    /// The attribute contains a path that should be transfered to
    /// remote machines when the work item cooks.
    eTransferFlag       = 0x0020,

    /// The attribute should be copied to internal dependent(s) within
    /// the node, before the dependent(s) cooks
    eDependentFlag      = 0x0040,

    /// The attribute should not cause the owner to be dirtied if it
    /// changes between cooks, e.g due to work item regeneration
    eNoDirtyFlag        = 0x0080,

    /// The attribute is not saved when the owner is serialized
    eTransientFlag      = 0x0100,

    /// The attribute is bound to a particular work item. This flag is
    /// only relevant for global/graph attributes
    eBoundFlag          = 0x0200,

    /// The attribute should be treated as an extra input. If the file
    /// changes on disk between cooks, the cache of the work items using
    /// the file is invalided.
    eInputFileFlag      = 0x0400,

    //// Covenience value, the bitwise OR of all other  flags
    eAllFlags           = 0xFFFF
};

/// Enumeration of attribute cast results
enum class PDG_AttributeCast
{
    /// No cast error occured (success)
    eSuccess,

    /// Cast failed due to a missing/undefined attribute
    eErrorMissing,

    /// Cast failed due to a type mismatch (string vs. int)
    eErrorType,

    /// Cast failed due to an index being out of bounds
    eErrorBounds,

    /// Cast failed due to an invalid tag (applies to files only)
    eErrorTag,
};

/// Enumeration of different ways that attributes can be combined
enum class PDG_AttributeMergeOp
{
    /// The attribute should be excluded as it does not match any of
    /// the patterns in the map
    eIgnore,

    /// The attribute is flattened, i.e. the first value for the attrib
    /// is used an no other values are selected.
    eFirstValue,

    /// The attribute overwrites existing values, unless the destination
    /// has its own modications
    eLastValue,

    /// The unique values for the attribute are kept,
    eUniqueValues,

    /// The attribute values are concatenated together into an array
    eAppendArray,

    /// The minimum value is kept
    eMinimum,

    /// The maximum value is kept
    eMaximum,

    /// The sum of the values is kept
    eSum,

    /// The attribute values are averaged
    eAverage,

    /// The most common value is kept
    eMode,

    /// The middle value is kept
    eMedian,

    /// The values are kept in sorted order
    eSorted,
};

/// Enumerations of errors that can occur when merging attributes
enum class PDG_AttributeMergeError
{
    /// No error occured
    eNone,

    /// Mismatch between types
    eType,

    /// Invalid merge operation for the attribute type
    eInvalidOp,

    /// Mismatch between stride lengths
    eStride,
};

/// Enumeration of types of attribute that can be queried from work items
enum class PDG_AttributeIntrinsic
{
    /// Index [numeric, string]
    eIndexAttrib,
    /// Frame [numeric, string]
    eFrameAttrib,
    /// Loop depth [numeric, string]
    eLoopDepthAttrib,
    /// Work item unique id [numeric, string]
    eIdAttrib,
    /// Input result list size [numeric, string]
    eInputSizeAttrib,
    // Output result list size [numeric, string]
    eOutputSizeAttrib,

    /// Name [string]
    eNameAttrib,
    /// Label [string]
    eLabelAttrib,
    /// Log path [string]
    eLogAttrib,

    /// Input result list [string]
    eInputAttrib,
    /// Input tag [string]
    eInputTagAttrib,

    /// Output result list [string]
    eOutputAttrib,
    /// Output tag [string]
    eOutputTagAttrib,

    /// Scheduler name [string]
    eSchedulerName,
    /// Node name [string]
    eNodeName,

    /// Custom attribute name [numeric, string]
    eCustomAttrib
};

#endif /* __PDG_ATTRIBUTE_TYPES_H__ */