6. Debugging

Common Errors

• NullPointerException: [ticket] does not point to any resource (negative index). The ticket is being used to interact with a resource, but never used to declare/reference a resource or the ticket is an input and was not connected to another output ticket. Note that this exact error is not guaranteed to occur if the ticket has been successfully used in passed frames.

• NullPointerException: [ticket] points to a null resource. The resource that the ticket was pointing to was culled between preparation and execution.

• IllegalStateException: [resource] was unexpectedly acquired. The resource was already completely released when something attempted to acquire it.

• RendererException: An error occurred while executing a job. An exception was thrown by a render module while the framegraph was in the execution stage. The exact exception that occurred is usually also printed.

Resource Errors

• IllegalArgumentException: Cannot allocate object to an undefined resource. The resource was set as undefined earlier in execution, and cannot accept any allocations as a result.

• NullPointerException: Resource definition cannot be null in this context. This is usually caused by attempting to use a primitive resource as a normal or temporary one.

• NullPointerException: Allocation from cache denied by resource definition. The resource view's definition did not accept an object being allocated from the cache, which always results in this error.

• IllegalStateException: [object] is not released. A user that referenced or declared a resource failed to make a corresponding release call before rendering ended.

• RendererException: An error occurred while executing a job. An exception was thrown during framegraph execution.

Resource Modification Errors

• IllegalStateException: Source resource must not be virtual to accept modification. The resource to modify has not yet been acquired, and thus there is nothing to modify.

• IllegalStateException: Target resource must be virtual to accept modification. The resource view to target modification to is already associated with a resource.

• NullPointerException: Unable to complete modification of [source resource] to [target resource]. Allocation of the resource held by the source resource view was rejected from specific allocation, usually by the target resource view's definition.