Scenome 21.6 — 2/14/2021
Release details are described below.
Table 1.1. Description of Changes.
|Added SPA_Vendor.glsl to the GLSL includes directory. SPA_Vendor.glsl contains #define statements for the big three vendors, NVIDIA, AMD, and INTEL. You can use the #define statements to write code for specific device manufacturers, or to fence code off from specific device manufacturers.|
|Fixed a bug in the new <DataCapture> wizard. At the end, when we set the container pointers for the new <DataCapture> objects, we set the container pointers to the <VariableNode> that was in the memento state (for undo). We need to set the containers to the unedited <VariableNode> we are editing.|
|Fixed name collisions in dynamically-generated interface items for the <ShaderBufferBindNode> and <UniformBufferBindNode>. Please see TYPE_SHADER_BUFFER_BIND_NODE_SCRIPTS.SSL and TYPE_UNIFORM_BUFFER_BIND_NODE_SCRIPTS.SSL for more information.|
|Fixed a bug in macro TextureSetPixelFormat(). Previously the test for whether or not a <Texture> was internal (stores <Image> objects inside the <Texture>) or external (referring to a file on disk) was not quite precise enough.|
Table 1.2. Description of Changes.
Completed Phase 1 of the conversion to iterator-based algorithms. This included targeted refactoring of the Scenome Scripting Language codebase and testing of all affected systems.
Historically, Scenome Scripting Language was designed to be a simple way to modify a Scenome application that did not require the user to write C++ code. And we wanted to keep it very simple, focused naturally on very high-level tasks such as implementing commands or test systems. Of course that's not exactly how things turned out. Even large Scenome Scripting Language codebases compile in a matter of seconds, and incredibly fast builds turned out to be highly-desirable for developers. As the language grew, we faced increasing desire for high-performance low level operations, and the need for the language to be 'simple' became a secondary objective. From its initial start as a language for writing commands for Scenome applications, Scenome Scripting Language has become an integral part of the entire product experience.
As the Scenome Scripting Language codebase has grown, the need for performance and flexibility has also grown. Previously, algorithm support, such as for filling or copying arrays, was performed with the array algorithms data interface for the relevant type. This was done with the idea that it's important to keep the language simple and easy to learn, in keeping with the principles outlined above.
For example: <Float32ArrayAlgorithms> had data interfaces for consuming all other scalar, scalar array, vector, vector array, or matrix types, as well as algorithms such as linear interpolate and iota. Algorithms in <Float32ArrayAlgorithms> accepted <Float32Array> objects as parameters, and algorithms in <Int8ArrayAlgorithms> accepted <Int8Array> objects as parameters.
To use iterators you simply declare them with auto as shown below. Then you bind the iterator to an object using SSL::GetIterators( FirstIterator f, LastIterator l ). Note that these are forward iterators only. Backward iteration is not supported at present, but that might change in the future depending on use cases.
At first glance the iterator code looks more verbose—;and it is. However the iterator based system offers performance, flexibility, and interoperability that the old 'custom algorithm for every use case' cannot match. Here we're using the iterator position values to implement a very fine-grained copy operation. Iterator-based algorithms have a flexibility and programmability that algorithms with fixed signatures cannot hope to match.
The change to iterator-based algorithms enables numerous simplifications in Scenome Scripting Language client code. For example, the highly-desired ability to iterate over (and mutate) an <Image> object's individual values is now reality.
It's very common to work with iterators in pairs that define ranges. Note that any iterator pair passed into a function must refer to the same object. The following is not allowed:
As with their C++ counterparts, it's possible to invalidate iterators and the results can be unpredictable. If you increase the underlying allocation, your iterator range will be short compared to the underlying object, but the iterators may remain stable. If you decrease the size of the underlying object, attempting to dereference your iterators may cause the application to crash. Consider iteration invalidation as undefined behavior in Scenome Scripting Language until further guidance is issued.
In nearly all cases, performance of these algorithms vastly exceeds performance of the previous system.
Table 1.3. Description of Changes.
|<Int8Iterator> : public <TypedIterator>|
|<Int16Iterator> : public <TypedIterator>|
|<Int32Iterator> : public <TypedIterator>|
|<Int64Iterator> : public <TypedIterator>|
|<Uint8Iterator> : public <TypedIterator>|
|<Uint16Iterator> : public <TypedIterator>|
|<Uint32Iterator> : public <TypedIterator>|
|<Uint64Iterator> : public <TypedIterator>|
|<Float16Iterator> : public <TypedIterator>|
|<Float32Iterator> : public <TypedIterator>|
|<Float64Iterator> : public <TypedIterator>|
Table 1.4. Description of Changes.
|<Float32MatrixArray>||No. Probably Scenome 21.7 or Scenome 21.8.|
|<Float64MatrixArray>||No. Probably Scenome 21.7 or Scenome 21.8.|