Add an Unnamed Object to RAM$objects — ram.new

Puts object into RAM$objects without assigning it a name. This is useful when iteratively creating objects that will not be referenced by name— see the Snake vignette for an example of this.

Otherwise, objects should be put in RAM$objects like so for easy reference:

RAM$objects$my_object = list(...)
print(RAM$objects$my_object)

Usage

ram.new_object(RAM, object)

Arguments

RAM: RAM object.
object: Game object; a list with properties like $x and $spritename.

Details

Convenience function for RAM$objects = c(RAM$objects, list(object)). This is because the syntax for adding a nested list to a list is c(listA, list(listB))!

Nested lists in R can be confusing, so it's better to have a function that does this automatically than to trust users to remember the correct syntax.

Examples

RAM = ram.init(rom.init(16,8))

#named object
RAM$objects$blueberry = list(x=1,y=5,sprite='blueberry',layer=4)

#unnamed object
RAM = ram.new_object(RAM, list(x=1,y=5,sprite='fruit',layer=3))

print(RAM$objects)
#> $blueberry
#> $blueberry$x
#> [1] 1
#> 
#> $blueberry$y
#> [1] 5
#> 
#> $blueberry$sprite
#> [1] "blueberry"
#> 
#> $blueberry$layer
#> [1] 4
#> 
#> 
#> [[2]]
#> [[2]]$x
#> [1] 1
#> 
#> [[2]]$y
#> [1] 5
#> 
#> [[2]]$sprite
#> [1] "fruit"
#> 
#> [[2]]$layer
#> [1] 3
#> 
#>