For molecular modelers working with SAMSON, efficiently managing and filtering molecular data can profoundly impact workflow and outcomes. A key capability within SAMSON’s Node Specification Language (NSL) is the use of light attributes. These attributes enable users to target and manipulate light nodes in their systems with precision, opening the door to streamlined modeling tasks. In this post, we’ll delve into light attributes, what they do, and how they can be used effectively in molecular modeling workflows.
What Are Light Attributes?
Light attributes are defined in the light attribute space (short name: li), specifically targeting nodes that represent lights. They allow modelers to filter and manipulate light-related properties, saving time and effort when working in complex systems. These attributes are particularly handy for those who frequently adjust lighting settings or need insights into how lighting is applied in their molecular scenes. Let’s break down their functionalities:
The Key Attributes and Their Uses
Here is a quick reference table for light attributes:
| Attribute Name | Short Name | Possible Values | Examples |
|---|---|---|---|
| hidden | h |
true, false |
li.h, not li.h |
| name | n |
Strings in quotes | li.n "A", li.n "L*" |
| selected | true, false |
li.selected, not li.selected |
|
| selectionFlag | sf |
true, false |
li.sf false, li.sf |
| visibilityFlag | vf |
true, false |
li.vf false, li.vf |
| visible | v |
true, false |
li.v, not li.v |
Each of these attributes can be used to refine how light nodes are selected and managed.
Practical Use Cases
- Adjusting Visibility: Use the
li.vorli.vfattributes to show or hide light nodes in your scene. For example, applyingli.vf falsehelps in isolating specific elements by hiding unnecessary light nodes. - Targeting by Name: The
li.nattribute is a great way to identify lights by their names. For instance,li.n "L*"will target all light nodes with names beginning with ‘L’. This capability is particularly useful when dealing with scenes containing numerous lights. - Managing Selections: With
li.selectedorli.sf, you can control which lights are part of your active selection, improving your ability to manipulate only the elements you need.
Inherited Functionality
Most light attributes inherit their behavior from the node attribute space. For example, hidden, visible, and selectionFlag retain their meanings when applied to light nodes, but their short names may differ.
Understanding these attributes can streamline your modeling workflows, especially when creating or analyzing complex scenes. Whether you need to isolate specific lighting effects, adjust visibility, or manage selections, these tools bring precision to your projects.
To dive deeper into light attributes, visit the original documentation: https://documentation.samson-connect.net/users/latest/nsl/light/.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. You can get SAMSON at https://www.samson-connect.net.