pyscratch-pysc 1.0.3__py3-none-any.whl

examples/getting-started/step 5 - local variables/main.py

@@ -0,0 +1,17 @@
+import pyscratch as pysc
+import player, enemy
+
+# backdrop
+backdrop_img = pysc.load_image('assets/my_background.jpg') # load the image(s)
+pysc.game.set_backdrops([backdrop_img]) # a list of all the backdrop images 
+pysc.game.switch_backdrop(0) # use the backdrop at index 0 
+
+
+# start the game
+screen_height = 720
+screen_width = 1280
+framerate = 60
+
+pysc.game.update_screen_mode((screen_width, screen_height))
+pysc.game.start(framerate)
+

examples/getting-started/step 5 - local variables/player.py

@@ -0,0 +1,49 @@
+import pyscratch as pysc
+
+
+player = pysc.create_single_costume_sprite("assets/player-fish.png")
+# pysc.game['player'] = player  # put player as a shared variable so other sprites can access it
+
+
+def on_game_start():
+      
+    player.set_rotation_style_left_right()
+    speed_decay = 0.9
+    speed_y = 0
+    speed_x = 0
+
+    while True:
+        max_speed = 4
+
+
+        if pysc.is_key_pressed('w'):
+            speed_y = -max_speed
+
+        elif pysc.is_key_pressed('s'):
+            speed_y = max_speed
+
+        else:
+            speed_y *= speed_decay # speed_y = speed_y * speed_decay
+
+        if pysc.is_key_pressed('a'):
+            player.direction = 180
+            speed_x = -max_speed
+            
+        elif pysc.is_key_pressed('d'):
+            player.direction = 0
+            speed_x = max_speed
+        else:
+            speed_x *= speed_decay # speed_x = speed_y * speed_decay
+
+
+        player.y += speed_y
+        player.x += speed_x
+
+        yield 1/60
+
+
+game_start_event = player.when_game_start()
+game_start_event.add_handler(on_game_start)
+
+# or shorter: player.when_game_start().add_handler(on_game_start)
+

examples/getting-started/step 6 - shared variables/enemy.py

@@ -0,0 +1,64 @@
+import pyscratch as pysc
+
+
+# create the sprite and initial settings
+#enemy = pysc.create_animated_sprite("assets/other_fishes")
+enemy = pysc.create_single_costume_sprite("assets/other_fishes/0.png")
+
+
+# Event: when game started, clone creation
+def enemy_on_game_start():
+    enemy.set_rotation_style_left_right()
+    enemy.hide() # hide the parent
+
+    # clone itself very 2 seconds
+    while True: 
+        enemy.create_clone()
+        yield 2
+
+enemy.when_game_start().add_handler(enemy_on_game_start)
+
+
+# Event: when started as clone, clone location and movement
+def on_clone(clone_sprite: pysc.Sprite): 
+
+    # random height
+    clone_sprite.y = pysc.random_number(0, 720)
+
+    # randomly either from the left or from the right
+    if pysc.random_number(0, 1) > 0.5: 
+        clone_sprite.x = 0
+        clone_sprite.direction = 0 # left to right
+    else:
+        clone_sprite.x = 1280
+        clone_sprite.direction = 180 # right to left
+
+    # random size
+    size = pysc.random_number(0.3, 2)
+    clone_sprite.set_scale(size)
+
+    # show the sprite
+    clone_sprite.show()
+
+    # movement
+    while True:
+
+        clone_sprite.direction += pysc.random_number(-2, 2)
+        clone_sprite.move_indir(2)
+
+        yield 1/60
+
+enemy.when_started_as_clone().add_handler(on_clone)
+
+
+
+# Event: when started as clone, moved by the ocean current 
+def ocean_current_movement(clone_sprite):
+    while True:
+
+        clone_sprite.x += pysc.game['current_x'] 
+        clone_sprite.y += pysc.game['current_y'] 
+
+        yield 1/60
+
+enemy.when_started_as_clone().add_handler(ocean_current_movement)

examples/getting-started/step 6 - shared variables/main.py

@@ -0,0 +1,17 @@
+import pyscratch as pysc
+import player, enemy
+
+# backdrop
+backdrop_img = pysc.load_image('assets/my_background.jpg') # load the image(s)
+pysc.game.set_backdrops([backdrop_img]) # a list of all the backdrop images 
+pysc.game.switch_backdrop(0) # use the backdrop at index 0 
+
+
+# start the game
+screen_height = 720
+screen_width = 1280
+framerate = 60
+
+pysc.game.update_screen_mode((screen_width, screen_height))
+pysc.game.start(framerate)
+

examples/getting-started/step 6 - shared variables/player.py

@@ -0,0 +1,80 @@
+import pyscratch as pysc
+
+
+player = pysc.create_single_costume_sprite("assets/player-fish.png")
+# pysc.game['player'] = player  # put player as a shared variable so other sprites can access it
+
+# Event: game start, the movement of the player
+def on_game_start():
+      
+    player.set_rotation_style_left_right()
+    speed_decay = 0.9
+    speed_y = 0
+    speed_x = 0
+
+    while True:
+        max_speed = 4
+
+
+        if pysc.is_key_pressed('w'):
+            speed_y = -max_speed
+
+        elif pysc.is_key_pressed('s'):
+            speed_y = max_speed
+
+        else:
+            speed_y *= speed_decay # speed_y = speed_y * speed_decay
+
+        if pysc.is_key_pressed('a'):
+            player.direction = 180
+            speed_x = -max_speed
+            
+        elif pysc.is_key_pressed('d'):
+            player.direction = 0
+            speed_x = max_speed
+        else:
+            speed_x *= speed_decay # speed_x = speed_y * speed_decay
+
+
+        player.y += speed_y
+        player.x += speed_x
+
+        yield 1/60
+
+# or shorter: player.when_game_start().add_handler(on_game_start)
+game_start_event = player.when_game_start()
+game_start_event.add_handler(on_game_start)
+
+
+
+# Event: game start, ocean current changes
+pysc.game['current_x'] = 0
+pysc.game['current_y'] = 0
+
+def ocean_current_change():
+    # slowly change the current variables every 0.5 second
+    while True:
+        pysc.game['current_x'] += pysc.random_number(-0.1, 0.1)
+        pysc.game['current_y'] += pysc.random_number(-0.1, 0.1)
+        yield 0.5
+
+pysc.game.when_game_start().add_handler(ocean_current_change)
+
+# option 2: almost the same as above but the event will be removed when player is removed.
+# player.when_game_start().add_handler(ocean_current_change)
+
+
+
+
+# Event: game start, moved by the ocean current
+def ocean_current_movement():
+    while True:
+
+        # you can add these two lines inside the loop in the first event as well
+        # but for the code readabilty, 
+        # it can be a good idea to put it out as a separate event. 
+        player.x += pysc.game['current_x'] 
+        player.y += pysc.game['current_y'] 
+        yield 1/60
+
+player.when_game_start().add_handler(ocean_current_movement)

examples/getting-started/step 7 - Referencing other sprites/enemy.py

@@ -0,0 +1,83 @@
+import pyscratch as pysc
+
+
+# create the sprite and initial settings
+#enemy = pysc.create_animated_sprite("assets/other_fishes")
+enemy = pysc.create_single_costume_sprite("assets/other_fishes/0.png")
+
+
+def enemy_on_game_start():
+    enemy.set_rotation_style_left_right()
+
+    # hide the parent
+    enemy.hide() 
+
+    # the clone appear in the same location as the parent very briefly
+    # when it's created before we set it to a random location. 
+    enemy.set_xy((-200, -200))  
+
+
+    # clone itself very 2 seconds
+    while True: 
+        enemy.create_clone()
+        yield 2
+
+enemy.when_game_start().add_handler(enemy_on_game_start)
+
+
+# clone movement
+#def on_clone(clone_sprite): 
+def on_clone(clone_sprite: pysc.Sprite): 
+
+
+    # random height
+    clone_sprite.y = pysc.random_number(0, 720)
+
+    # randomly either from the left or from the right
+    if pysc.random_number(0, 1) > 0.5: 
+        clone_sprite.x = 0
+        clone_sprite.direction = 0 # left to right
+    else:
+        clone_sprite.x = 1280
+        clone_sprite.direction = 180 # right to left
+
+    # random size
+    size = pysc.random_number(0.3, 2)
+    clone_sprite.set_scale(size)
+
+    # show the sprite
+    clone_sprite.show()
+    
+
+    #player = pysc.game['player']
+    player: pysc.Sprite = pysc.game['player']
+    
+    # movement
+    while True:
+
+        if clone_sprite.distance_to_sprite(player) < 200:
+            clone_sprite.point_towards_sprite(player)    
+
+        clone_sprite.direction += pysc.random_number(-2, 2)
+
+        clone_sprite.move_indir(2)
+        yield 1/60
+
+enemy.when_started_as_clone().add_handler(on_clone)
+
+
+# clone touch the player 
+#def clone_touch_the_player(clone_sprite):
+def clone_touch_the_player(clone_sprite: pysc.Sprite):
+
+    player: pysc.Sprite = pysc.game['player']
+    while True:
+        if clone_sprite.is_touching(player):
+            clone_sprite.remove()
+
+            pysc.game['health'] -= 1
+            
+
+        yield 1/pysc.game['framerate']
+    
+enemy.when_started_as_clone().add_handler(clone_touch_the_player)

examples/getting-started/step 7 - Referencing other sprites/hearts.py

@@ -0,0 +1,39 @@
+import pyscratch as pysc
+
+# create the sprites
+heart1 = pysc.create_animated_sprite("assets/hearts")
+heart2 = pysc.create_animated_sprite("assets/hearts")
+heart3 = pysc.create_animated_sprite("assets/hearts")
+
+# variable definitons should be done outside the event to guarantee the variables is defined before any event try to access it 
+pysc.game['health'] = 3
+
+def heart_display():
+
+    heart1.set_xy((100, 100))
+    heart1.set_scale(3)
+
+    heart2.set_xy((155, 100))
+    heart2.set_scale(3)
+
+    heart3.set_xy((210, 100))
+    heart3.set_scale(3)
+
+
+    while True: 
+        if pysc.game['health'] < 3:
+            heart3.set_frame(1)
+
+        if pysc.game['health'] < 2:
+            heart2.set_frame(1)
+
+        if pysc.game['health'] < 1:
+            heart1.set_frame(1)
+        
+        yield 1/pysc.game['framerate']
+    
+# ideally, you should do
+# `pysc.game.when_game_start([heart1, heart2, heart3])`, so when any of the hearts is removed, the event is removed as well. 
+# but we aren't going to remove any of the hearts, so there's no need to do so there. 
+
+pysc.game.when_game_start().add_handler(heart_display)

examples/getting-started/step 7 - Referencing other sprites/main.py

@@ -0,0 +1,23 @@
+from numpy import deg2rad
+import pyscratch as pysc
+import player, enemy, hearts
+
+# backdrop
+backdrop_img = pysc.load_image('assets/my_background.jpg') # load the image(s)
+pysc.game.set_backdrops([backdrop_img]) # a list of all the backdrop images 
+pysc.game.switch_backdrop(0) # use the backdrop at index 0 
+
+
+# start the game
+screen_height = 720
+screen_width = 1280
+framerate = 60
+
+# add these to as shared variables so other sprites might use it
+pysc.game['screen_height'] = screen_height
+pysc.game['screen_width'] = screen_width
+pysc.game['framerate'] = framerate
+
+pysc.game.update_screen_mode((screen_width, screen_height))
+pysc.game.start(framerate)
+

examples/getting-started/step 7 - Referencing other sprites/player.py

@@ -0,0 +1,59 @@
+import pyscratch as pysc
+
+
+player = pysc.create_single_costume_sprite("assets/player-fish.png")
+pysc.game['player'] = player  # add the player as a shared variable so other sprites can access it
+
+
+def on_game_start():
+
+    player.set_rotation_style_left_right()
+    speed_decay = 0.9
+    speed_y = 0
+    speed_x = 0
+
+    while True:
+        max_speed = 4
+
+
+        if pysc.is_key_pressed('w'):
+            speed_y = -max_speed
+
+        elif pysc.is_key_pressed('s'):
+            speed_y = max_speed
+
+        else:
+            speed_y *= speed_decay # speed_y = speed_y * speed_decay
+
+        if pysc.is_key_pressed('a'):
+            player.direction = 180
+            speed_x = -max_speed
+            
+        elif pysc.is_key_pressed('d'):
+            player.direction = 0
+            speed_x = max_speed
+        else:
+            speed_x *= speed_decay # speed_x = speed_y * speed_decay
+
+
+        player.y += speed_y
+        player.x += speed_x
+
+        yield 1/60
+
+
+game_start_event = player.when_game_start()
+game_start_event.add_handler(on_game_start)
+
+# or shorter: player.when_game_start().add_handler(on_game_start)
+
+
+def check_health():
+
+    while True:
+        if not pysc.game['health']:
+            player.remove()
+        yield 1/60
+
+
+game_start_event.add_handler(check_health)

examples/getting-started/step 8 - sprite variables/enemy.py

@@ -0,0 +1,98 @@
+import pyscratch as pysc
+
+
+# create the sprite and initial settings
+enemy = pysc.create_animated_sprite("assets/other_fishes")
+
+
+def enemy_on_game_start():
+    enemy.set_rotation_style_left_right()
+    
+    # hide the parent
+    enemy.hide() 
+    
+    # the clone appear in the same location as the parent very briefly
+    # when it's created before we set it to a random location. 
+    enemy.set_xy((-200, -200))  
+
+    # clone itself very 2 seconds
+    while True: 
+        enemy.create_clone()
+        yield 2
+
+enemy.when_game_start().add_handler(enemy_on_game_start)
+
+
+# clone movement
+#def on_clone(clone_sprite): 
+def on_clone(clone_sprite: pysc.Sprite): 
+
+
+    # random height
+    clone_sprite.y = pysc.random_number(0, 720)
+
+    # randomly either from the left or from the right
+    if pysc.random_number(0, 1) > 0.5: 
+        clone_sprite.x = 0
+        clone_sprite.direction = 0 # left to right
+    else:
+        clone_sprite.x = 1280
+        clone_sprite.direction = 180 # right to left
+
+    # random size
+    size = pysc.random_number(0.3, 2)
+    clone_sprite.set_scale(size)
+    clone_sprite['size'] = size
+
+    # show the sprite
+    clone_sprite.show()
+    
+
+    #player = pysc.game['player']
+    player: pysc.Sprite = pysc.game['player']
+    
+    # movement
+    while True:
+
+
+        if player.sprite_data['size'] > size:
+            clone_sprite.set_frame(1)
+        else:
+            clone_sprite.set_frame(0)
+
+            
+        if clone_sprite.distance_to_sprite(player) < 200:
+            clone_sprite.point_towards_sprite(player)
+
+            if player['size'] > size:
+                clone_sprite.direction += 180
+
+        
+
+        clone_sprite.direction += pysc.random_number(-2, 2)
+
+        clone_sprite.move_indir(2/size)
+        yield 1/60
+
+enemy.when_started_as_clone().add_handler(on_clone)
+
+
+# clone touch the player 
+#def clone_touch_the_player(clone_sprite):
+def clone_touch_the_player(clone_sprite: pysc.Sprite):
+
+    player: pysc.Sprite = pysc.game['player']
+    while True:
+        if clone_sprite.is_touching(player):
+            clone_sprite.remove()
+
+            if player['size'] > clone_sprite['size']:
+                player['size'] += 0.2
+            else:
+                player['size'] -= 0.2
+                pysc.game['health'] -= 1
+            
+
+        yield 1/pysc.game['framerate']
+    
+enemy.when_started_as_clone().add_handler(clone_touch_the_player)

examples/getting-started/step 8 - sprite variables/hearts.py

@@ -0,0 +1,39 @@
+import pyscratch as pysc
+
+# create the sprites
+heart1 = pysc.create_animated_sprite("assets/hearts")
+heart2 = pysc.create_animated_sprite("assets/hearts")
+heart3 = pysc.create_animated_sprite("assets/hearts")
+
+# variable definitons should be done outside the event to guarantee the variables is defined before any event try to access it 
+pysc.game['health'] = 3
+
+def heart_display():
+
+    heart1.set_xy((100, 100))
+    heart1.set_scale(3)
+
+    heart2.set_xy((155, 100))
+    heart2.set_scale(3)
+
+    heart3.set_xy((210, 100))
+    heart3.set_scale(3)
+
+
+    while True: 
+        if pysc.game['health'] < 3:
+            heart3.set_frame(1)
+
+        if pysc.game['health'] < 2:
+            heart2.set_frame(1)
+
+        if pysc.game['health'] < 1:
+            heart1.set_frame(1)
+        
+        yield 1/pysc.game['framerate']
+    
+# ideally, you should do
+# `pysc.game.when_game_start([heart1, heart2, heart3])`, so when any of the hearts is removed, the event is removed as well. 
+# but we aren't going to remove any of the hearts, so there's no need to do so there. 
+
+pysc.game.when_game_start().add_handler(heart_display)

examples/getting-started/step 8 - sprite variables/main.py

@@ -0,0 +1,22 @@
+import pyscratch as pysc
+import player, enemy, hearts
+
+# backdrop
+backdrop_img = pysc.load_image('assets/my_background.jpg') # load the image(s)
+pysc.game.set_backdrops([backdrop_img]) # a list of all the backdrop images 
+pysc.game.switch_backdrop(0) # use the backdrop at index 0 
+
+
+# start the game
+screen_height = 720
+screen_width = 1280
+framerate = 60
+
+# add these to as shared variables so other sprites might use it
+pysc.game['screen_height'] = screen_height
+pysc.game['screen_width'] = screen_width
+pysc.game['framerate'] = framerate
+
+pysc.game.update_screen_mode((screen_width, screen_height))
+pysc.game.start(framerate)
+

examples/getting-started/step 8 - sprite variables/player.py

@@ -0,0 +1,63 @@
+import pyscratch as pysc
+
+
+player = pysc.create_single_costume_sprite("assets/player-fish.png")
+pysc.game['player'] = player  # add the player as a shared variable so other sprites can access it
+
+player['size'] = 1  
+
+def on_game_start():
+
+    player.set_rotation_style_left_right()
+    speed_decay = 0.9
+    speed_y = 0
+    speed_x = 0
+
+    while True:
+
+        player.set_scale(player['size'])
+
+        max_speed = 4/player['size']
+
+
+        if pysc.is_key_pressed('w'):
+            speed_y = -max_speed
+
+        elif pysc.is_key_pressed('s'):
+            speed_y = max_speed
+
+        else:
+            speed_y *= speed_decay # speed_y = speed_y * speed_decay
+
+        if pysc.is_key_pressed('a'):
+            player.direction = 180
+            speed_x = -max_speed
+            
+        elif pysc.is_key_pressed('d'):
+            player.direction = 0
+            speed_x = max_speed
+        else:
+            speed_x *= speed_decay # speed_x = speed_y * speed_decay
+
+
+        player.y += speed_y
+        player.x += speed_x
+
+        yield 1/60
+
+
+game_start_event = player.when_game_start()
+game_start_event.add_handler(on_game_start)
+
+# or shorter: player.when_game_start().add_handler(on_game_start)
+
+
+def check_health():
+
+    while True:
+        if not pysc.game['health']:
+            player.remove()
+        yield 1/60
+
+
+game_start_event.add_handler(check_health)