enu/app/scenes/world.tscn

[gd_scene load_steps=11 format=2]

[ext_resource path="res://components/MarkdownLabel.tscn" type="PackedScene" id=1]
[ext_resource path="res://scenes/env.tres" type="Environment" id=2]
[ext_resource path="res://materials/default_ground.tres" type="Material" id=3]
[ext_resource path="res://components/GroundNode.gdns" type="Script" id=4]
[ext_resource path="res://components/Player.tscn" type="PackedScene" id=6]

[sub_resource type="QuadMesh" id=3]
size = Vector2( 2, 2 )

[sub_resource type="ViewportTexture" id=5]
viewport_path = NodePath("Spatial/Viewport")

[sub_resource type="SpatialMaterial" id=4]
resource_local_to_scene = true
flags_transparent = true
flags_unshaded = true
flags_albedo_tex_force_srgb = true
albedo_texture = SubResource( 5 )

[sub_resource type="PlaneMesh" id=1]
material = ExtResource( 3 )
size = Vector2( 1000, 1000 )

[sub_resource type="ConcavePolygonShape" id=2]
margin = 0.001
data = PoolVector3Array( 500, 0, 500, -500, 0, 500, 500, 0, -500, -500, 0, 500, -500, 0, -500, 500, 0, -500 )

[node name="Level" type="Spatial"]

[node name="WorldEnvironment" type="WorldEnvironment" parent="."]
environment = ExtResource( 2 )

[node name="DirectionalLight" type="DirectionalLight" parent="WorldEnvironment"]
transform = Transform( -0.720719, -0.691799, -0.0444846, -0.669706, 0.678255, 0.302431, -0.179049, 0.247759, -0.952133, 7.77656, 18.6011, 2.38791 )
light_color = Color( 0.976471, 0.909804, 0.839216, 1 )
light_energy = 0.786
light_indirect_energy = 0.0
light_specular = 0.8
shadow_enabled = true
shadow_color = Color( 0.658824, 0.658824, 0.658824, 1 )
directional_shadow_mode = 0

[node name="Spatial" type="Spatial" parent="."]
transform = Transform( 1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 2, -1.99 )

[node name="Viewport" type="Viewport" parent="Spatial"]
size = Vector2( 1500, 1500 )
msaa = 4
fxaa = true
hdr = false
usage = 0
render_target_v_flip = true
render_target_update_mode = 3

[node name="MarkdownLabel" parent="Spatial/Viewport" instance=ExtResource( 1 )]
markdown = "# Parts of an Enu Program

Enu is programmed with a language called [Nim](https://nim-lang.org). This tutorial teach some of the 
basics of Nim, as well as a few special features that are unique to Enu.

## Comments

Comments are a way to leave notes to yourself or other programmers. They can be 
used for lots of different things, but generally provide more information on how 
something works or why it was done a certain way. They can also have more 
general information, such as the author of the code and when it was written. 
They start with a `#` sign. Everything else on the line is ignored.

```nim
# Copyright Scott Wadden, 2022

var last_row = false # we only want to change colors on the last row
```

## Types

Every piece of data in Enu has a type. These are the most common:

- `bool` - a `true` or `false` value. Example: `drawing = false`

- `Number` - a number with a decimal, like `1.0`. Numbers without decimals, like 
  `1` will usually auto convert, but if something isn't working, try adding a 
  decimal. Example: `var age = 12.5`

- `Text` - Any combination of letters, numbers and punctuation, contained inside 
  double quotes. Example: `var name = \"Sackville Coding Club\"`

- `Color` - Any one of `blue`, `red`, `green`, `black`, `white`, `brown` or 
  `eraser`. Someday more colors will be available. Example `color = green`

- `Position` - The place of something in the world. Example: 
  `me.position = player.position`

- `Thing` - Anything that exists in the Enu world. This could be something you 
  build, a robot, or the player.

<div style=\"page-break-after: always;\"></div>

## Variables

A variable is used to store data. The value is usually set when it is created, 
and can be modified later. A variable must always hold the same type of data.

```nim
# ok:
var age = 12
if birthday:
  age = age + 1

if reset:
  age = 0

# not ok. Age must always be a number, not text:
var age = 12
if birthday:
  age = \"13 years old\"                          
```

Usually variables are defined with just a value, but sometimes you need to 
specify their type as well. This could be because you're not ready to give it a 
value, or because you want it to contain more than one kind of `Thing`.

For example:

```nim
# this won't work because `enemy` gets automatically set to the type of 
# `Player`, so other things won't work:
var enemy = player
enemy = me

# it will work if we do it like this, since `player` and `me` are both `Thing`
var enemy: Thing
enemy = player
enemy = me
```

<div style=\"page-break-after: always;\"></div>

Usually each variable starts with `var`, but you can also indent to define 
multiple variables with a single `var`.

```nim
var name = \"Scott\"
var age = 43
var town = \"Sackville\"

# this is exactly the same as the above

var
  name = \"Scott\"
  age = 43
  town = \"Sackville\"
```

## Special Variables

Enu has some built in variables.

- `me` - the `Thing` that we're working on in the current script.

- `speed` - a `Number` to get or set our current speed. `1.0` by default.

- `color` - the current drawing `Color`. `blue` by default.

- `scale` - a `Number` to grow or shrink a `Thing`. `1.0` by default. Be careful 
  about making this too small. You might lose the `Thing` you're working on.

- `position` - where a `Thing` is. You can use this to move something 
  immediately. `position = player.position` would teleport `me` to the player.

- `drawing` - a `bool` that indicates if commands like `forward` or `back` should 
  draw blocks. `true` by default. `drawing = false` would let you move without 
  drawing anything, which could be useful for making a hole or a new object.

- `glow` - how bright a `Thing` is. Can be used to make something flash, or to 
  highlight it.

<div style=\"page-break-after: always;\"></div>

## Blocks

Blocks start with a `:`, and are then indented by two spaces. Everything that's 
inside the block is controlled by whatever started it.

- `if` - an `if` block will only run if the statement is `true`.

```nim
var length = 0
...
if length == 0:
  glow = 1
  echo \"You need to provide a length!\"
  # both of the above only happen if `length` is 0.
```

- `times` - Make something happen more than once.

```nim
4.times:
  forward 5
  turn right
  # the above each happen 4 times (which draws a square!)

back 20
# this only happens once, since it isn't in a `times` block.

8.times(side):
  # It's also possible to see how many times we've already performed 
  # the action by passing `times` an index variable.
  # This starts from 0. in this example we're storing the counter in 
  # a variable called `side`. Because we're doing this 8 times, 
  # `side` will be set first to 0, then 1, 2, 3, 4, 5, 6, 7.
  forward 5
  if side != 4:
    turn right
  else:
    turn left

echo \"We drew a bow tie!\"
echo \"This will only be printed once because it isn't in a times block\"
```
  
"

[node name="MeshInstance" type="MeshInstance" parent="Spatial"]
transform = Transform( 0.95, 0, 0, 0, 0.95, 0, 0, 0, 0.95, 0, 0, 0 )
mesh = SubResource( 3 )
material/0 = SubResource( 4 )

[node name="Ground" type="MeshInstance" parent="."]
mesh = SubResource( 1 )
script = ExtResource( 4 )

[node name="StaticBody" type="StaticBody" parent="Ground"]
collision_layer = 524288
collision_mask = 0
script = ExtResource( 4 )

[node name="CollisionShape" type="CollisionShape" parent="Ground/StaticBody"]
shape = SubResource( 2 )

[node name="Player" parent="." instance=ExtResource( 6 )]
transform = Transform( 1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 1, 0 )
collision_layer = 2147483648
collision_mask = 524295

[node name="data" type="Spatial" parent="."]