Memory Banks Operator v1.0
Overview
It has two usages: one is to perform operations like concat, intersection, etc. on two memory banks, called general operation; the other is to initialize multiple memory banks at once, called batch initialization.
General Operation
Specify two memory banks by set their IDs at the left and right port, then set the bottom port to different voltages to perform different operations, and the result will be output to the memory bank with the ID specified at the top port.
You must specify the correct memory bank ID at the top, left and right port; otherwise no operation will be performed. Only one exception is that if the bottom input is 1, the right memory bank ID can be unavailable.
Besides copy operation, the height of result memory bank will be set to 1 and width to data count, so it's recommended to output to a List Memory Bank, that you can adjust width after initialization.
Ports Definition
Top Output
| Function |
|---|
Result Memory Bank ID (Any Type) |
Right Input
| Function |
|---|
Right Memory Bank ID |
Bottom Input
| Function |
|---|
Synchronous Operations, details are in the table below. |
Left Input
| Function |
|---|
Left Memory Bank ID |
Back Input
| Function |
|---|
Parameter of Synchronous Operations |
Synchronous Operations
| Voltage | Operation | Description |
|---|---|---|
| 0 or Others | None | Only if the voltage of the bottom port changes, the operation will be executed. |
| 1 | Concat /Copy | Concat left and right memory banks, the left memory bank data comes first, the right memory bank data comes last. If the right memory bank ID is unavailable, it will be treated as copying the left memory bank data. Copy operation requires that the left memory bank and the output memory bank are the same type (whether volatile or not does not affect). |
| 2 | Insert | Insert right memory bank data into left memory bank data. The data will be inserted at the position specified by the back port (index starts from 0). If the index is greater than the data count of the left memory bank, it will be inserted at the middle with 0. |
| 3 | Overwrite | Overwrite right memory bank data into left memory bank data. The data will be overwrite at the position specified by the back port (index starts from 0). If the index is greater than the data count of the left memory bank, it will be inserted at the middle with 0. |
| 4 | Intersect | The data in left memory bank data, equals to the data in right memory bank data, will be kept, otherwise will be removed. |
| 5 | Intersect (Duplicate Removal) | Same as above, but will also remove duplicates. |
| 6 | Except | The data in left memory bank data, equals to the data in right memory bank data, will be removed, otherwise will be kept. |
| 7 | Except (Duplicate Removal) | Same as above, but will also remove duplicates. |
📝 The Position of Insert/Overwrite
If you want to insert data into the 5th and 6th data, the back input should be 5; to insert data before the 1st data, then the back input should be 0.
If you want to overwrite data from the 5th data, the back input should be 4; to overwrite data from the 1st data, then the back input should be 0.
Batch Initialization
Specify a memory bank as the template by set its ID at the left port, and a memory bank to store the result by set its ID at the top port. Set range and other parameters at the right port and back port.
When the bottom input changes to 256 V (0x100), the Memory Banks Operator will try to initialize in batch.
The memory banks in the range must be the same type as the template.
Ports Definition
Top Output
| Function |
|---|
Result Memory Bank ID (Any Type, Required) |
Right Input
| Start & End | Function | Description |
|---|---|---|
| 1 ~ 8 | X Range | For each 1 increase of this, the end position moves west by 1 block. |
| 9 ~ 16 | Y Range | For each 1 increase of this, the end position moves up by 1 block. |
| 17 ~ 24 | Z Range | For each 1 increase of this, the end position moves north by 1 block. |
| 25 | X Range Sign | If this is 1, the end position moves east but not west. |
| 26 | Y Range Sign | If this is 1, the end position moves down but not up. |
| 27 | Z Range Sign | If this is 1, the end position moves south but not north. |
| 28 ~ 32 | Empty | No effect. |
Bottom Input
| Function |
|---|
When this changes to 256 V (0x100), the Memory Banks Operator will try to initialize. |
Left Input
| Function |
|---|
Template Memory Bank ID |
Back Input
| Start & End | Function | Description |
|---|---|---|
| 1 ~ 8 | X Offset | For each 1 increase of this, the start position moves west by 1 block. |
| 9 ~ 16 | Y Offset | For each 1 increase of this, the start position moves up by 1 block. |
| 17 ~ 24 | Z Offset | For each 1 increase of this, the start position moves north by 1 block. |
| 25 | X Offset Sign | If this is 1, the start position moves east but not west. |
| 26 | Y Offset Sign | If this is 1, the start position moves down but not up. |
| 27 | Z Offset Sign | If this is 1, the start position moves south but not north. |
| 28 | Don't Output Result | If this is 1, the result will not be output to the result memory bank |
| 29 | Whether Overwrite | If this is 1, it will overwrite the memory banks that already have data. |
| 30 ~ 32 | Empty | No effect. |