pyscratch-pysc 1.0.3__py3-none-any.whl

pyscratch/tools/sprite_preview/right_panel/ss_select_corner.py

@@ -0,0 +1,208 @@
+
+import numpy as np
+import pyscratch as pysc
+game = pysc.game
+
+
+colour = 0, 0, 0, 50
+
+cir0 = pysc.create_circle_sprite(colour, 30)
+game['c0'] = cir0
+
+cir1 = pysc.create_circle_sprite(colour, 30)
+game['c1'] = cir1
+
+# event game start: initial setting
+def on_start():
+
+    cir0.set_draggable(True)
+    cir1.set_draggable(True)
+
+    # pysc.game.bring_to_front(cir)
+    # pysc.game.bring_to_front(cir2)
+
+    cir0.x = game['ss_view_topleft'][0] + 1
+    cir0.y = game['ss_view_topleft'][1] + 1
+    
+    cir1.x = game['ss_view_buttom_right'][0]-1
+    cir1.y = game['ss_view_buttom_right'][1]-1
+
+
+    cir0.oob_limit=np.inf
+    cir1.oob_limit=np.inf
+
+game.when_game_start([cir0, cir1]).add_handler(on_start)
+
+
+
+# useful functions
+def value_if_none(v, default):
+    if v is None:
+        return default
+    return v
+
+def value_if_not(v, default):
+    if not v:
+        return default
+    return v
+
+
+
+
+# event game start: set the cutting offset and the frame size if the sprite is dragged
+def on_start2():
+    while True:
+        yield 1/30
+        ss_sprite: pysc.Sprite = game['ss_sprite']
+        if not ss_sprite: continue
+        game.bring_to_front(cir0)
+        game.bring_to_front(cir1)
+
+        mouse_down = pysc.get_mouse_presses()[0]
+        if not mouse_down: 
+            try:
+                cir0.x = game['offset_x']*ss_sprite.scale_factor + ss_sprite.rect.left
+                cir1.x = game['limit_x']*ss_sprite.scale_factor + ss_sprite.rect.left        
+
+                cir0.y = game['offset_y']*ss_sprite.scale_factor + ss_sprite.rect.top
+                cir1.y = game['limit_y']*ss_sprite.scale_factor + ss_sprite.rect.top    
+            except:
+                pass          
+            continue
+        if not (cir0.is_touching_mouse() or cir1.is_touching_mouse()): continue
+
+
+
+        # top left of the selected rect
+        cx0 = min(cir0.x, cir1.x)
+        cy0 = min(cir0.y, cir1.y)
+        
+        # bottom right of the selected rect
+        cx1 = max(cir0.x, cir1.x)
+        cy1 = max(cir0.y, cir1.y)        
+
+        # top left of the sprite sheet
+        x0, y0 = ss_sprite.rect.topleft
+
+        img_w, img_h = ss_sprite['original_width'], ss_sprite['original_height']
+
+        # scale factor
+        scale_factor = ss_sprite.scale_factor
+        
+        # RC
+        n_col = value_if_not(game['n_col'], 1)
+        n_row = value_if_not(game['n_row'], 1)
+
+        # O
+        game['offset_x'] = Ox = max(np.floor((cx0-x0)/scale_factor), 0)
+        game['offset_y'] = Oy = max(np.floor((cy0-y0)/scale_factor), 0)
+
+        # L
+        game['limit_x'] = Lx = min(np.ceil((cx1-x0)/scale_factor), img_w-1)
+        game['limit_y'] = Ly = min(np.ceil((cy1-y0)/scale_factor), img_h-1) 
+
+        # update the size
+        game['size_x'] = Lx - Ox + 1
+        game['size_y'] = Ly - Oy + 1
+
+        # pix
+        game['pixel_x'] = np.floor(game['size_x']/n_col)
+        game['pixel_y'] = np.floor(game['size_y']/n_row)
+
+
+
+
+
+pysc.game.when_game_start([cir0, cir1]).add_handler(on_start2)
+
+
+def on_offset_x_change(data):
+
+    if not (size_x := game['size_x']): return 
+    if not (offset_x := game['offset_x']): 
+        game['offset_x'] = 0
+        offset_x = 0         
+
+    ss_sprite: pysc.Sprite = game['ss_sprite']
+    if not ss_sprite: return 
+    
+    game['limit_x'] = min(size_x+offset_x-1, ss_sprite['original_width']-1)
+
+    game['size_x'] =  game['limit_x'] - offset_x + 1
+
+    cir0.x = offset_x*ss_sprite.scale_factor + ss_sprite.rect.left
+    cir1.x = game['limit_x']*ss_sprite.scale_factor + ss_sprite.rect.left
+
+    game['n_col'] = np.floor(game['size_x']/game['pixel_x'])
+
+game.when_receive_message('offset_x_change').add_handler(on_offset_x_change)
+
+def on_offset_y_change(data):
+
+    if not (size_y := game['size_y']): return 
+    if (offset_y := game['offset_y']) is None: 
+        game['offset_y'] = 0
+        offset_y = 0
+         
+    ss_sprite: pysc.Sprite = game['ss_sprite']
+    if not ss_sprite: return 
+    
+    game['limit_y'] = min(size_y+offset_y-1, ss_sprite['original_height']-1)
+
+    game['size_y'] =  game['limit_y'] - offset_y + 1
+
+    cir0.y = offset_y*ss_sprite.scale_factor + ss_sprite.rect.top
+    cir1.y = game['limit_y']*ss_sprite.scale_factor + ss_sprite.rect.top
+
+    game['n_row'] = np.floor(game['size_y']/game['pixel_y'])
+
+game.when_receive_message('offset_y_change').add_handler(on_offset_y_change)
+
+
+def on_n_row_change(data):
+    if not game['size_y']: return 
+    game['pixel_y'] = np.floor(game['size_y']/value_if_not(game['n_row'], 1))
+
+game.when_receive_message('n_row_change').add_handler(on_n_row_change)
+
+
+def on_n_col_change(data):
+    if not game['size_x']: return 
+    game['pixel_x'] = np.floor(game['size_x']/value_if_not(game['n_col'], 1))
+
+game.when_receive_message('n_col_change').add_handler(on_n_col_change)
+
+
+
+def on_pix_x_change(data):
+    if not game['size_x']: return 
+    game['n_col'] = np.floor(game['size_x']/value_if_not(game['pixel_x'], 1))
+
+
+game.when_receive_message('pixel_x_change').add_handler(on_pix_x_change)
+
+def on_pix_y_change(data):
+    if not game['size_y']: return 
+    game['n_row'] = np.floor(game['size_y']/value_if_not(game['pixel_y'], 1))
+
+
+game.when_receive_message('pixel_y_change').add_handler(on_pix_y_change)
+
+
+
+def on_scale_change(data):
+    ss_sprite: pysc.Sprite = game['ss_sprite']
+    if game['offset_x'] is None: return 
+    if game['limit_x'] is None: return 
+    if game['offset_y'] is None: return 
+    if game['limit_y'] is None: return 
+    
+
+    cir0.x = game['offset_x']*ss_sprite.scale_factor + ss_sprite.rect.left
+    cir1.x = game['limit_x']*ss_sprite.scale_factor + ss_sprite.rect.left
+
+    cir0.y = game['offset_y']*ss_sprite.scale_factor + ss_sprite.rect.top
+    cir1.y = game['limit_y']*ss_sprite.scale_factor + ss_sprite.rect.top
+
+
+game.when_receive_message('ss_sprite_scale_change').add_handler(on_pix_y_change)

pyscratch/tools/sprite_preview/settings.py

@@ -0,0 +1,14 @@
+import pygame
+
+SCREEN_HEIGHT = 720
+SCREEN_WIDTH = 1280
+DEFAULT_FONT24 = pygame.font.SysFont(None, 24)
+DEFAULT_FONT48 = pygame.font.SysFont(None, 24)
+
+LEFT_PANEL_WIDTH = 120
+RIGHT_PANEL_WIDTH = 600
+
+BOTTOM_RIGHT_PANEL_HEIGHT = 200
+PANEL_MARGIN = 10
+
+

pyscratch/tools/sprite_preview/utils/input_box.py

@@ -0,0 +1,235 @@
+from calendar import Day
+import pyscratch as pysc
+from settings import *
+
+w, h = 120, 40
+selected_colour = (255, 255, 255)
+deselected_colour = (127, 127, 127)
+
+
+def FloatInputBoxVerticallyLabel(data_key, message_on_change="", default_value=""):
+    label = pysc.create_rect_sprite(deselected_colour, w, h)
+    label.write_text(data_key, DEFAULT_FONT24, offset=(w/2, h/2))
+
+    selected_sur = pysc.create_rect(selected_colour, w, h)
+    deselected_sur = pysc.create_rect(deselected_colour, w, h)
+    pysc.game.shared_data[data_key] = None
+    text_box = pysc.Sprite({'selected':[selected_sur], 'deselected':[deselected_sur]}, 'deselected')
+    label.lock_to(text_box, (0,0), reset_xy=True)
+    label.y = -h
+
+    # def on_click():
+    #     text_box.set_animation('selected')
+    #     text_box.sprite_data['selected'] = True
+
+    # text_box.when_this_sprite_clicked().add_handler(on_click)
+    text_box['selected'] = False
+    text_box['text'] = default_value
+    try:
+        pysc.game.shared_data[data_key] = float(text_box.sprite_data['text'])
+    except:
+        pysc.game.shared_data[data_key] = None    
+
+    text_box.write_text(text_box['text'], DEFAULT_FONT24, colour=(255,255,255), offset=(w/2, h/2))
+    def on_any_key_press(key:str, updown):
+        if updown == 'up': return
+        if not text_box.sprite_data['selected']: return
+        if text_box['just_selected']: 
+            text_box['just_selected'] = False
+            text_box['text'] = ''
+
+        if key.isdigit() or key == '.':
+            text_box.sprite_data['text'] += key
+
+        if key == 'backspace' and len(text_box.sprite_data['text']):
+            text_box.sprite_data['text'] = text_box.sprite_data['text'][:-1]
+
+        try:
+            pysc.game.shared_data[data_key] = float(text_box.sprite_data['text'])
+        except:
+            pysc.game.shared_data[data_key] = None
+        
+        text_box.write_text(text_box.sprite_data['text'], DEFAULT_FONT24, colour=(0,0,0), offset=(w/2, h/2))
+
+        if message_on_change:
+            pysc.game.broadcast_message(message_on_change, pysc.game.shared_data[data_key])
+            
+    text_box.when_any_key_pressed().add_handler(on_any_key_press)
+
+    def on_any_mouse_click(pos, button, updown):
+        if not text_box.is_touching_mouse():
+            #print(button)
+            #print(pos)
+            text_box.sprite_data['selected'] = False
+            text_box['just_selected'] = False
+            text_box.set_animation('deselected')
+            text_box.write_text(text_box.sprite_data['text'], DEFAULT_FONT24, colour=(255,255,255), offset=(w/2, h/2))
+
+        else:
+            text_box.sprite_data['selected'] = True
+            text_box['just_selected'] = True
+            text_box.set_animation('selected')
+            text_box.write_text(text_box['text'], DEFAULT_FONT24, colour=(0,0,0), offset=(w/2, h/2))
+    pysc.game.when_mouse_click([text_box]).add_handler(on_any_mouse_click)
+
+    return text_box
+
+
+def FloatInputBoxHoriLabel(data_key, message_on_change="", default_value="", label_width=80):
+    wl = label_width
+    label = pysc.create_rect_sprite(deselected_colour, wl, h)
+    label.write_text(data_key, DEFAULT_FONT24, offset=(wl/2, h/2))
+
+    selected_sur = pysc.create_rect(selected_colour, w, h)
+    deselected_sur = pysc.create_rect(deselected_colour, w, h)
+    pysc.game.shared_data[data_key] = None
+    text_box = pysc.Sprite({'selected':[selected_sur], 'deselected':[deselected_sur]}, 'deselected')
+    label.lock_to(text_box, (0,0), reset_xy=True)
+    label.x = -w/2-wl/2
+
+
+    # def on_click():
+    #     text_box.set_animation('selected')
+    #     text_box.sprite_data['selected'] = True
+
+    # text_box.when_this_sprite_clicked().add_handler(on_click)
+    text_box['selected'] = False
+    text_box['text'] = default_value
+    try:
+        pysc.game.shared_data[data_key] = float(text_box.sprite_data['text'])
+    except:
+        pysc.game.shared_data[data_key] = None    
+
+    text_box.write_text(text_box['text'], DEFAULT_FONT24, colour=(255,255,255), offset=(w/2, h/2))
+    def on_any_key_press(key:str, updown):
+        if updown == 'up': return
+        if not text_box.sprite_data['selected']: return
+        if text_box['just_selected']: 
+            text_box['just_selected'] = False
+            text_box['text'] = ''
+
+        if key.isdigit() or key == '.':
+            text_box.sprite_data['text'] += key
+
+        if key == 'backspace' and len(text_box.sprite_data['text']):
+            text_box.sprite_data['text'] = text_box.sprite_data['text'][:-1]
+
+        try:
+            pysc.game.shared_data[data_key] = float(text_box.sprite_data['text'])
+        except:
+            pysc.game.shared_data[data_key] = None
+        
+        text_box.write_text(text_box.sprite_data['text'], DEFAULT_FONT24, colour=(0,0,0), offset=(w/2, h/2))
+
+        if message_on_change:
+            pysc.game.broadcast_message(message_on_change, pysc.game.shared_data[data_key])
+            
+    text_box.when_any_key_pressed().add_handler(on_any_key_press)
+
+    def on_any_mouse_click(pos, button, updown):
+        if not text_box.is_touching_mouse():
+            #print(button)
+            #print(pos)
+            text_box.sprite_data['selected'] = False
+            text_box['just_selected'] = False
+            text_box.set_animation('deselected')
+            text_box.write_text(text_box.sprite_data['text'], DEFAULT_FONT24, colour=(255,255,255), offset=(w/2, h/2))
+
+        else:
+            text_box.sprite_data['selected'] = True
+            text_box['just_selected'] = True
+            text_box.set_animation('selected')
+            text_box.write_text(text_box['text'], DEFAULT_FONT24, colour=(0,0,0), offset=(w/2, h/2))
+    pysc.game.when_mouse_click([text_box]).add_handler(on_any_mouse_click)
+
+    return text_box
+
+
+def IntegerInputBox(data_key, message_on_change="", default_value="", label_width=60):
+    wl = label_width
+    label = pysc.create_rect_sprite(deselected_colour, wl, h)
+    label.write_text(data_key, DEFAULT_FONT24, offset=(wl/2, h/2))
+
+    selected_sur = pysc.create_rect(selected_colour, w, h)
+    deselected_sur = pysc.create_rect(deselected_colour, w, h)
+    pysc.game.shared_data[data_key] = None
+    text_box = pysc.Sprite({'selected':[selected_sur], 'deselected':[deselected_sur]}, 'deselected')
+    label.lock_to(text_box, (0,0), reset_xy=True)
+    label.x = -w/2-wl/2
+
+    # def on_click():
+    #     text_box.set_animation('selected')
+    #     text_box.sprite_data['selected'] = True
+
+    # text_box.when_this_sprite_clicked().add_handler(on_click)
+    text_box.sprite_data['selected'] = False
+    text_box.sprite_data['text'] = default_value
+    text_box.write_text(text_box['text'], DEFAULT_FONT24, colour=(255,255,255), offset=(w/2, h/2))
+    def on_any_key_press(key:str, updown):
+        if updown == 'up': return
+        if not text_box.sprite_data['selected']: return
+        if text_box['just_selected']: 
+            text_box['just_selected'] = False
+            text_box['text'] = ''
+
+        if key.isdigit():
+            text_box.sprite_data['text'] += key
+
+        if key == 'backspace' and len(text_box.sprite_data['text']):
+            text_box.sprite_data['text'] = text_box.sprite_data['text'][:-1]
+
+        # try:
+        #     pysc.game.shared_data[data_key] = int(text_box.sprite_data['text'])
+        # except:
+        #     pysc.game.shared_data[data_key] = None
+        
+        text_box.write_text(text_box.sprite_data['text'], DEFAULT_FONT24, colour=(0,0,0), offset=(w/2, h/2))
+
+        
+        
+    text_box.when_any_key_pressed().add_handler(on_any_key_press)
+
+    def on_any_mouse_click(pos, button, updown):
+        if not text_box.is_touching_mouse():
+            #print(button)
+            #print(pos)
+            if text_box['selected']:
+                try:
+                    pysc.game.shared_data[data_key] = int(text_box.sprite_data['text'])
+                except:
+                    pysc.game.shared_data[data_key] = None
+                if message_on_change:
+                    pysc.game.broadcast_message(message_on_change, pysc.game.shared_data[data_key])
+            text_box['selected'] = False
+            text_box['just_selected'] = False
+            text_box.set_animation('deselected')
+            text_box.write_text(text_box['text'], DEFAULT_FONT24, colour=(255,255,255), offset=(w/2, h/2))
+
+        else:
+            text_box['selected'] = True
+            text_box['just_selected'] = True
+            text_box.set_animation('selected')
+            text_box.write_text(text_box['text'], DEFAULT_FONT24, colour=(0,0,0), offset=(w/2, h/2))
+    pysc.game.when_mouse_click([text_box]).add_handler(on_any_mouse_click)
+
+
+    def update_value_on_change():
+        while True:
+            yield 1/30
+
+            
+
+            if text_box.animation_name == "selected":
+                continue
+
+            try: 
+                text_box['text'] = str(round(pysc.game[data_key]))
+            except:
+                text_box['text'] = ""
+
+            text_box.write_text(text_box['text'], DEFAULT_FONT24, colour=(255,255,255), offset=(w/2, h/2))
+
+
+    text_box.when_game_start().add_handler(update_value_on_change)
+
+    return text_box

pyscratch/tools/sprite_preview/utils/render_wrapped_file_name.py

@@ -0,0 +1,86 @@
+
+
+import pygame
+
+
+def render_wrapped_file_name(text, max_chars, font, color=(255, 255, 255), bg_color=None, max_lines=None):
+    """
+    THIS FUNCTION IS WRITTEN BY AN AI
+
+    Renders a file name like a file explorer: wrapping intelligently while preserving the extension.
+
+    :param text: The file name string to render.
+    :param max_chars: Maximum number of characters per line (approximate width).
+    :param font: Pygame font object to render with.
+    :param color: Text color (default white).
+    :param bg_color: Background color (default None = transparent).
+    :param max_lines: Optional maximum number of lines to render. Extra text will be truncated with '...'.
+    :return: A Pygame surface with the rendered multiline text.
+    """
+    def split_file_name(text):
+        if '.' in text and not text.startswith('.') and text.rfind('.') > 0:
+            idx = text.rfind('.')
+            return text[:idx], text[idx+1:]
+        else:
+            return text, ''
+
+    def wrap_lines(base, ext, max_chars, max_lines=None):
+        words = base.split(' ')
+        lines = []
+        current_line = ''
+
+        for word in words:
+            test_line = (current_line + ' ' + word).strip()
+            if len(test_line) <= max_chars:
+                current_line = test_line
+            else:
+                if current_line:
+                    lines.append(current_line)
+                    if max_lines and len(lines) == max_lines:
+                        return lines[:-1] + [truncate_with_ellipsis(current_line, max_chars)]
+                # Break long word
+                while len(word) > max_chars:
+                    lines.append(word[:max_chars])
+                    word = word[max_chars:]
+                    if max_lines and len(lines) == max_lines:
+                        return lines[:-1] + [truncate_with_ellipsis(lines[-1], max_chars)]
+                current_line = word
+
+        if current_line:
+            lines.append(current_line)
+            if max_lines and len(lines) > max_lines:
+                lines = lines[:max_lines]
+                lines[-1] = truncate_with_ellipsis(lines[-1], max_chars)
+
+        # Add extension
+        if ext:
+            if len(lines[-1] + '.' + ext) <= max_chars:
+                lines[-1] += '.' + ext
+            elif not max_lines or len(lines) < max_lines:
+                lines.append('.' + ext)
+            else:
+                lines[-1] = truncate_with_ellipsis(lines[-1], max_chars)
+
+        return lines
+
+    def truncate_with_ellipsis(line, max_chars):
+        return line[:max(0, max_chars - 3)] + '...'
+
+    # Prepare
+    base, ext = split_file_name(text)
+    lines = wrap_lines(base, ext, max_chars, max_lines)
+
+    # Render
+    line_height = font.get_linesize()
+    surface_height = line_height * len(lines)
+    surface_width = max(font.size(line)[0] for line in lines)
+
+    rendered_surface = pygame.Surface((surface_width, surface_height), pygame.SRCALPHA)
+    if bg_color:
+        rendered_surface.fill(bg_color)
+
+    for i, line in enumerate(lines):
+        text_surface = font.render(line, True, color)
+        rendered_surface.blit(text_surface, (0, i * line_height))
+
+    return rendered_surface

pyscratch_pysc-1.0.3.dist-info/METADATA

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: pyscratch-pysc
+Version: 1.0.3
+Summary: A Python game development framework designed to provide an easy transitioning from Scratch to Python
+Author-email: Daniel Ka-Wa Chan <kwdaniel525@protonmail.com>
+License: MIT
+Project-URL: Homepage, https://kwdchan.github.io/pyscratch/
+Project-URL: Repository, https://github.com/kwdChan/pyscratch
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pymunk<7
+Requires-Dist: pygame<3
+Requires-Dist: numpy<3
+Requires-Dist: typing_extensions
+Requires-Dist: pillow<12
+
+# PyScratch 
+For more information, see: https://kwdchan.github.io/pyscratch/
+
+
+
+
+
+
+## Change History
+
+### 07 Sep 2025
+**v1.0.3**  
+Added undeclared dependency: Pillow   
+Specified the versions of the dependencies
+
+### Jul 2025
+**v1.0.0**  
+The first version