Enum LevelsError

Outcome for owned-result Levels processing.

enum LevelsError : ubyte { ... }

.init is notAttempted: default-initialized statuses NEVER mean success. A call succeeds ONLY when it returns none. No public method returns notAttempted. Callers MUST inspect the returned status, not infer success from the current value of their destination owner. resultExceedsBudget means the new float pixel payload alone would exceed the caller limit. allocationFailure includes detected length/stride overflow, malloc failure or failed raster import. Ordinary runtime allocation exceptions and OOM errors are not caught.

Enum members

NameDescription
allocationFailure Result size cannot be represented, malloc/adoption/import failed, or the internally constructed result layout was unusable.
invalidChannelSelection Selected-channel count differs from the source channel count.
invalidMask Explicit editing mask is missing or has the wrong size/plane count.
invalidParameters Levels thresholds, gamma, or output domain are invalid.
invalidRegion Requested nonempty ROI is outside the source.
invalidSource Borrowed source is empty or structurally invalid.
none Full, successful publication of the independently owned result.
notAttempted Default status, not returned by the operation.
resultExceedsBudget The new float pixel payload exceeds maxResultBytes.
sampleFailure A validated source/output sample read or write failed.