DevCPC CLI - SDK para desarrollo en Amstrad CPC

DevCPC CLI - SDK para desarrollo en Amstrad CPC

License Platform Python ABASM Amstrad CPC 8BP

🎯 ¿Por qué DevCPC CLI?

Esta idea nace de la necesidad de poder compilar la librería 8BP para Amstrad CPC en sistemas operativos que no fueran Windows de forma nativa. Gracias al ensamblador ABASM creado por fragarco todo esto ha sido posible. A partir de ahi se han ido implementando nuevas funcionalidades para facilitar el desarrollo de proyectos en Basic y ensamblador para Amstrad CPC

� ¿Qué incluye?

Compilación automatizada

Herramientas integradas

Herramientas Opcionales

Plataformas soportadas

📦 Requisitos

‼️ Importante: Solo esta soportada la version v2.0 BETA-1 R7 (10/07/2019) de Retro Virtual Machine que es la unica que tiene las opciones de desarrollo activadas, tal y como se indica en su su Web.

Si decides utilizar la conversion de imagenes a ASM necesitaras instalar la libreria de python Pillow en tu sistema.

  1. Python 3 y Pillow 
    # Instalar Pillow
pip3 install Pillow
   
# Verificar
python3 -c "import PIL; print('Pillow OK')"

📌 Roadmap

🚀 Como Empezar

1. Instalación

Ejecuta el siguiente comando en tu terminal:

curl -fsSL https://destroyer.me/devcpc | bash

O con wget:

wget -qO- https://destroyer.me/devcpc | bash

El instalador:

Después de la instalación

Recarga tu shell:

source ~/.bashrc  # Para bash
source ~/.zshrc   # Para zsh

O simplemente abre una nueva terminal.

Verifica la instalación:

devcpc version

Actualización

Para actualizar DevCPC a la última versión:

devcpc update

O reinstala ejecutando el instalador nuevamente:

curl -fsSL https://destroyer.me/devcpc | bash

Nota: Para reinstalar, primero debes borrar la instalación existente:

rm -rf ~/.DevCPC
curl -fsSL https://destroyer.me/devcpc | bash

Instalación Manual

Si prefieres instalar manualmente:

  1. Descarga la última versión desde Releases
  2. Extrae el archivo: 
    tar -xzf DevCPC-X.Y.Z.tar.gz
  3. Ejecuta el script de instalación: 
    cd CPCDevKit
./setup.sh

2. Crear tu primer proyecto

# Crear nuevo proyecto
devcpc new mi-juego

# Ver la estructura creada
ls -la

3. Configurar el proyecto

Edita devcpc.conf según tus necesidades:

# Configuración básica
PROJECT_NAME="mi-juego"
BUILD_LEVEL=0

# Rutas (comenta las que no uses)
ASM_PATH="asm/make_all_mygame.asm"
BASIC_PATH="bas"
#RAW_PATH="raw"
#C_PATH="C"

4. Añadir tu código

# Copiar tus archivos ASM
cp /ruta/a/tus/archivos/*.asm ASM/

# Copiar archivos BASIC
cp /ruta/a/tus/archivos/*.bas bas/

5. Compilar

# Compilar todo
devcpc build

# Ver el resultado
ls -la dist/

6. Ejecutar (opcional)

# Configurar emulador en devcpc.conf
# RVM_PATH="/ruta/a/RetroVirtualMachine"
# CPC_MODEL=464
# RUN_FILE="8BP0.BIN"

# Ejecutar
devcpc run

📚 Comandos Disponibles

devcpc new <nombre>

Crea un nuevo proyecto con estructura completa.

devcpc new mi-super-juego

Crea:

devcpc build

Compila el proyecto completo.

devcpc build

Proceso:

  1. ✅ Convierte sprites PNG a ASM (si SPRITES_PATH está definido)
  2. ✅ Convierte pantallas PNG a SCN (si LOADER_SCREEN está definido)
  3. ✅ Compila código ASM con ABASM (si ASM_PATH está definido)
  4. ✅ Verifica límites de gráficos (_END_GRAPH < 42040)
  5. ✅ Crea imagen DSK
  6. ✅ Añade binario ASM al DSK (8BP0.bin, 8BP1.bin, etc.)
  7. ✅ Añade pantallas SCN al DSK (si LOADER_SCREEN está definido)
  8. ✅ Compila código C con SDCC (si C_PATH está definido)
  9. ✅ Verifica límites de memoria C (< 23999)
  10. ✅ Añade archivos BASIC al DSK (si BASIC_PATH está definido)
  11. ✅ Añade archivos RAW al DSK (si RAW_PATH está definido)
  12. ✅ Muestra contenido del DSK
  13. ✅ Crea cinta CDT (si CDT y CDT_FILES están configurados)
  14. ✅ Muestra catálogo del CDT

Ejemplo de salida:

═══════════════════════════════════════
  Compilar Proyecto: mi-juego
═══════════════════════════════════════

ℹ Build Level: 0 (Todas las funcionalidades)
ℹ Memoria BASIC: MEMORY 23599

✓ Compilación exitosa
✓ Límite de gráficos respetado (< 42040)
✓ DSK creado
✓ 1 archivo(s) BASIC añadidos

Contenido del DSK:
0: 8BP0    .BIN  [ st: 0 extend: 0 data pages: 128 ]
1: LOADER  .BAS  [ st: 0 extend: 0 data pages: 3 ]

✓ Proyecto compilado exitosamente

devcpc clean

Limpia archivos generados.

devcpc clean

Elimina:

devcpc info

Muestra la configuración del proyecto.

devcpc info

Muestra:

Ejemplo:

═══════════════════════════════════════
  Configuración del Proyecto
═══════════════════════════════════════

Proyecto:        mi-juego
Build Level:     0

Rutas configuradas:
  ✓ ASM:    ASM
  ✓ BASIC:  bas

Directorios:
  Objetos:  obj
  Salida:   dist
  DSK:      mi-juego.dsk

devcpc validate

Valida el proyecto antes de compilar.

devcpc validate

Verifica:

Ejemplo:

═══════════════════════════════════════
  Validar Proyecto: mi-juego
═══════════════════════════════════════

→ Validando configuración...
✓ PROJECT_NAME: mi-juego
✓ BUILD_LEVEL: 0 (Todas las funcionalidades)

→ Validando rutas...
✓ ASM_PATH: ASM
✓   make_all_mygame.asm encontrado
✓ BASIC_PATH: bas (2 archivo(s) .bas)

→ Validando herramientas...
✓ Python 3 instalado

═══════════════════════════════════════
  Resumen de Validación
═══════════════════════════════════════

✓ Proyecto válido - Sin errores ni advertencias

devcpc run

Ejecuta el proyecto en RetroVirtualMachine (DSK o CDT).

devcpc run           # Usa RUN_MODE del config (auto por defecto)
devcpc run --dsk     # Fuerza ejecución desde DSK (disco)
devcpc run --cdt     # Fuerza ejecución desde CDT (cinta)

Requisitos:

Características:

‼️ Importante: Para poder probar sobre el Emulador RetroVirtualMachine, es necesario tener instalada la version v2.0 BETA-1 R7 10/07/2019 Que tal y como informa su desarrollador en la Web es la que tiene habilitada la funcionalidad para desarrollo.

devcpc help

Muestra ayuda general.

devcpc help

devcpc version

Muestra la versión instalada y verifica si hay actualizaciones disponibles.

devcpc version

Salida:

DevCPC CLI v1.0.1

⚠ Nueva versión disponible: v1.0.2 (actual: v1.0.1)
Actualizar: curl -fsSL https://destroyer.me/devcpc | bash

devcpc update

Actualiza DevCPC a la última versión disponible.

devcpc update

Proceso:

  1. ✅ Verifica la versión actual
  2. ✅ Consulta la última versión en GitHub Releases
  3. ✅ Descarga el archivo tar.gz de la release
  4. ✅ Extrae y reemplaza los archivos en ~/.DevCPC
  5. ✅ Preserva tu configuración y proyectos
  6. ✅ Actualiza automáticamente

Ejemplo de salida:

ℹ DevCPC CLI v1.0.1

ℹ Verificando actualizaciones...
✓ Última versión disponible: v1.0.2

⚠ Nueva versión disponible: v1.0.2

¿Deseas actualizar a v1.0.2? [S/n]: s

ℹ Iniciando actualización...
ℹ Descargando DevCPC v1.0.2...
✓ Descarga completada
ℹ Extrayendo archivos...
ℹ Actualizando archivos en ~/.DevCPC...

✓ DevCPC actualizado exitosamente a v1.0.2

ℹ Verifica la instalación con: devcpc version

Nota: Si ya tienes la última versión instalada, el comando te lo indicará:

devcpc update
✓ Ya tienes la última versión instalada

⚙️ Configuración (devcpc.conf)

Configuración básica

# Nombre del proyecto (usado para el DSK)
PROJECT_NAME="MI_JUEGO"

# Nivel de compilación (0-4)
BUILD_LEVEL=0

Niveles de compilación 8BP

Nivel Descripción MEMORY Comandos Tamaño
0 Todas las funcionalidades 23599 |LAYOUT, |COLAY, |MAP2SP, |UMA, |3D 19120 bytes
1 Juegos de laberintos 24999 |LAYOUT, |COLAY 17620 bytes
2 Juegos con scroll 24799 |MAP2SP, |UMA 17820 bytes
3 Juegos pseudo-3D 23999 |3D 18620 bytes
4 Sin scroll/layout 25299 Básicos 17320 bytes

Rutas opcionales

# Código ensamblador 8BP
ASM_PATH="asm/make_all_mygame.asm"

# Archivos BASIC (se añaden al DSK automáticamente)
BASIC_PATH="bas"

# Archivos RAW (se añaden sin encabezado AMSDOS)
RAW_PATH="raw"

# Código C (se compila con SDCC)
C_PATH="C"
C_SOURCE="main.c"
C_CODE_LOC=20000

# Conversión de gráficos
SPRITES_PATH="assets/sprites"      # Sprites PNG → ASM
LOADER_SCREEN="assets/screen"      # Pantallas PNG → SCN
MODE=0                             # Modo CPC (0, 1 o 2)

Nota:

Directorios de salida

# Archivos intermedios (bin, lst, map, ihx)
OBJ_DIR="obj"

# DSK final
DIST_DIR="dist"

# Nombre del DSK
DSK="${PROJECT_NAME}.dsk"

# Nombre del CDT (cinta - opcional)
CDT="${PROJECT_NAME}.cdt"

# Archivos a incluir en la cinta (orden importa)
CDT_FILES="loader.bas 8BP0.bin main.bin"

Nota sobre CDT:

Emulador (opcional)

# macOS
RVM_PATH="/Applications/Retro Virtual Machine 2.app/Contents/MacOS/Retro Virtual Machine 2"

# Linux
#RVM_PATH="/usr/local/bin/RetroVirtualMachine"

# Windows WSL
#RVM_PATH="/mnt/c/Program Files/RetroVirtualMachine/RetroVirtualMachine.exe"

# Modelo de CPC
CPC_MODEL=464

# Archivo a ejecutar automáticamente (solo para DSK)
RUN_FILE="8BP0.BIN"

# Modo de ejecución: "auto", "dsk" o "cdt"
RUN_MODE="auto"

Modos de ejecución (RUN_MODE):

Modo Descripción Uso
auto Detecta automáticamente Si CDT existe y está configurado → CDT, sino → DSK
dsk Siempre usa DSK Monta disco y ejecuta RUN_FILE
cdt Siempre usa CDT Monta cinta con auto-play

Override desde CLI:

devcpc run --dsk    # Ignora RUN_MODE, siempre DSK
devcpc run --cdt    # Ignora RUN_MODE, siempre CDT

📁 Estructura de Proyecto

Proyecto típico

mi-juego/
├── devcpc.conf          # Configuración del proyecto
├── README.md            # Documentación
├── .gitignore          # Git ignore
│
├── ASM/                # Código ensamblador 8BP (ASM_PATH)
│   ├── make_all_mygame.asm    # Archivo principal
│   ├── images_mygame.asm      # Gráficos
│   ├── music_mygame.asm       # Música
│   └── sprites.asm            # Sprites generados (si usas SPRITES_PATH)
│
├── bas/                # Archivos BASIC (BASIC_PATH)
│   ├── loader.bas      # Cargador
│   └── menu.bas        # Menú
│
├── assets/             # Recursos del proyecto
│   ├── sprites/        # Sprites PNG (SPRITES_PATH por defecto)
│   │   ├── player.png
│   │   ├── enemies/
│   │   └── tiles/
│   └── screen/         # Pantallas PNG (LOADER_SCREEN por defecto)
│       ├── title.png       # 160x200 (Modo 0)
│       └── loading.png
│
├── raw/                # Archivos RAW (RAW_PATH) - opcional
│   └── data.bin        # Datos sin encabezado AMSDOS
│
├── C/                  # Código C (C_PATH) - opcional
│   ├── main.c          # Código principal
│   ├── 8BP_wrapper/    # Wrapper para 8BP
│   └── mini_BASIC/     # Mini BASIC
│
├── obj/                # Generado: archivos intermedios
│   ├── 8BP0.bin        # Binario compilado
│   ├── *.lst           # Listados
│   ├── *.map           # Mapas de memoria
│   ├── *.scn           # Pantallas SCN (si LOADER_SCREEN está configurado)
│   ├── *.scn.info      # Info de paleta de pantallas
│   └── *.ihx           # Intel HEX (C)
│
└── dist/               # Generado: DSK y CDT finales
    ├── mi-juego.dsk    # Imagen DSK (disco)
    └── mi-juego.cdt    # Imagen CDT (cinta) - opcional

Variables de configuración

Variable Descripción Ejemplo Requerido
PROJECT_NAME Nombre del proyecto "MI_JUEGO" ✅ Sí
BUILD_LEVEL Nivel de compilación (0-4) 0 ✅ Sí (8BP)
ASM_PATH Archivo ASM 8BP "asm/make_all_mygame.asm" ❌ Opcional
BASIC_PATH Ruta a archivos BASIC "bas" ❌ Opcional
RAW_PATH Ruta a archivos RAW "raw" ❌ Opcional
C_PATH Ruta a código C "C" ❌ Opcional
C_SOURCE Archivo C principal "main.c" ❌ Si C_PATH
C_CODE_LOC Dirección de carga C 20000 ❌ Si C_PATH
LOADADDR Dirección carga ASM 0x1200 ❌ ASM sin 8BP
SOURCE Archivo fuente ASM "main" ❌ ASM sin 8BP
TARGET Binario ASM "program" ❌ ASM sin 8BP
OBJ_DIR Directorio objetos "obj" ❌ Opcional
DIST_DIR Directorio salida "dist" ❌ Opcional
DSK Nombre del DSK "${PROJECT_NAME}.dsk" ❌ Opcional
CDT Nombre del CDT (cinta) "${PROJECT_NAME}.cdt" ❌ Opcional
CDT_FILES Archivos en la cinta "loader.bas 8BP0.bin" ❌ Si CDT
RVM_PATH Ruta al emulador "/path/to/RVM" ❌ Opcional
CPC_MODEL Modelo de CPC 464 ❌ Opcional
RUN_FILE Archivo a ejecutar (DSK) "8BP0.BIN" ❌ Opcional
RUN_MODE Modo ejecución (auto/dsk/cdt) "auto" ❌ Opcional
SPRITES_PATH Ruta a PNG sprites "assets/sprites" ❌ Opcional
SPRITES_OUT_FILE Archivo ASM de salida "sprites.asm" ❌ Opcional
SPRITES_TOLERANCE Tolerancia RGB sprites 8 ❌ Opcional
SPRITES_TRANSPARENT_INK INK transparente (0-26) "" ❌ Opcional
LOADER_SCREEN Ruta a PNG pantallas "assets/screen" ❌ Opcional
MODE Modo CPC (0, 1 o 2) 0 ❌ Opcional

💾 Creación de Cintas CDT

DevCPC puede generar archivos CDT (cintas) además de DSK, permitiendo ejecutar tus juegos desde cinta en emuladores o hardware real.

¿Qué es un CDT?

CDT (Cass Data Tape) es el formato estándar para cintas de Amstrad CPC. A diferencia del DSK que almacena archivos en disco, el CDT graba los datos secuencialmente como en una cinta real.

Configuración Básica

# En devcpc.conf

# Activar generación de CDT
CDT="${PROJECT_NAME}.cdt"

# Lista de archivos en orden de carga
CDT_FILES="loader.bas 8BP0.bin main.bin"

⚠️ Orden Importante

El orden en CDT_FILES es crítico - los archivos se grabarán y cargarán en ese orden secuencial:

# ✅ Correcto: loader primero, luego binarios
CDT_FILES="loader.bas 8BP0.bin game.bin"

# ❌ Incorrecto: intentará cargar binarios antes del loader
CDT_FILES="game.bin 8BP0.bin loader.bas"

Tipos de Archivos Soportados

Tipo Extensión Descripción Uso en CPC
BASIC .bas Programas BASIC tokenizados RUN"
Binario .bin Código máquina con cabecera RUN"ARCHIVO"
Pantalla .scn Pantallas 16KB en &C000 RUN"SCREEN"
RAW .txt, etc Datos sin cabecera AMSDOS Lectura directa

Proceso de Generación

Durante devcpc build, si CDT está configurado:

  1. Lee ${PROJECT_NAME}.map: Obtiene tipo, load address y execute address de cada archivo
  2. Valida archivos: Verifica que todos los archivos en CDT_FILES existen
  3. Crea CDT vacío: Inicializa el archivo de cinta
  4. Añade archivos en orden: Graba cada archivo secuencialmente
    • BASIC/ASCII: Usa --put-ascii con nombre en MAYÚSCULAS
    • BIN/SCN: Usa --put-bin con load/execute addresses
    • RAW: Usa --put-raw sin cabecera
  5. Muestra catálogo: Lista bloques y estructura de la cinta

Ejemplo de Salida

═══════════════════════════════════════
  Crear Cinta CDT
═══════════════════════════════════════

ℹ CDT: my_game.cdt
ℹ Archivos: loader.bas 8BP0.bin ciclo.bin

→ Creando CDT vacío...
✓ CDT creado: dist/my_game.cdt

→ Añadiendo loader.bas al CDT...
ℹ   Tipo: BASIC
ℹ   Name: LOADER
✓ loader.bas añadido

→ Añadiendo 8BP0.bin al CDT...
ℹ   Tipo: BINARIO
ℹ   Load: 0x5C30
ℹ   Exec: 0x5C30
ℹ   Name: 8BP0
✓ 8BP0.bin añadido

→ Añadiendo ciclo.bin al CDT...
ℹ   Tipo: BINARIO
ℹ   Load: 0x4E20
ℹ   Exec: 0x4E20
ℹ   Name: CICLO
✓ ciclo.bin añadido

✓ 3 archivo(s) añadido(s) al CDT

Ejecutar CDT

# Ejecución automática (usa RUN_MODE del config)
devcpc run

# Forzar CDT
devcpc run --cdt

# Forzar DSK
devcpc run --dsk

Diferencias de ejecución:

Medio Comando CPC Ventajas Desventajas
DSK RUN"FILE" Acceso aleatorio, rápido Requiere unidad de disco
CDT RUN" Sin disco, más “retro” Carga secuencial, más lento

Modelos con disco (664/6128):

Ejemplo Completo

# devcpc.conf
PROJECT_NAME="space_invaders"
BUILD_LEVEL=0

# Generar DSK y CDT
DSK="${PROJECT_NAME}.dsk"
CDT="${PROJECT_NAME}.cdt"

# Orden de carga en cinta
CDT_FILES="intro.bas title.scn loader.bas 8BP0.bin game.bin"

# Ejecutar en cinta por defecto
RUN_MODE="cdt"

# Compilar y ejecutar
devcpc build && devcpc run

Resultado:

🎨 Conversión de Gráficos PNG a ASM

DevCPC incluye una herramienta automática para convertir tus sprites PNG a formato ASM compatible con Amstrad CPC.

Configuración

# En devcpc.conf

# Ruta donde están tus PNG (búsqueda recursiva)
SPRITES_PATH="assets/sprites"

# Modo CPC (0=16 colores, 1=4 colores, 2=2 colores)
MODE=0

# Archivo ASM de salida (puede incluir ruta)
SPRITES_OUT_FILE="ASM/sprites.asm"

# Tolerancia RGB (0=exacto, 8=recomendado, -1=automático)
SPRITES_TOLERANCE=8

# INK para píxeles transparentes (opcional, 0-26)
SPRITES_TRANSPARENT_INK=""

Modos CPC

Modo Colores Píxeles/byte Bits/píxel Resolución
0 16 2 4 160x200
1 4 4 2 320x200
2 2 8 1 640x200

Paleta de Colores CPC

La herramienta convierte automáticamente los colores RGB de tus PNG a los 27 INKs del Amstrad CPC:

INK 0  = Negro (0,0,0)
INK 1  = Azul oscuro (0,0,128)
INK 2  = Azul (0,0,255)
INK 3  = Rojo oscuro (128,0,0)
INK 4  = Magenta oscuro (128,0,128)
INK 5  = Magenta (128,0,255)
INK 6  = Rojo (255,0,0)
INK 7  = Rosa (255,0,128)
INK 8  = Rosa claro (255,0,255)
INK 9  = Verde oscuro (0,128,0)
INK 10 = Cian oscuro (0,128,128)
INK 11 = Cian (0,128,255)
INK 12 = Amarillo oscuro (128,128,0)
INK 13 = Gris (128,128,128)
INK 14 = Azul pastel (128,128,255)
INK 15 = Naranja (255,128,0)
INK 16 = Rosa pastel (255,128,128)
INK 17 = Lila (255,128,255)
INK 18 = Verde (0,255,0)
INK 19 = Verde agua (0,255,128)
INK 20 = Cian claro (0,255,255)
INK 21 = Amarillo verdoso (128,255,0)
INK 22 = Verde pastel (128,255,128)
INK 23 = Cian pastel (128,255,255)
INK 24 = Amarillo (255,255,0)
INK 25 = Amarillo pastel (255,255,128)
INK 26 = Blanco (255,255,255)

Estructura de Carpetas

mi-juego/
├── assets/                # Recursos del proyecto
│   └── sprites/           # Tus PNG originales
│       ├── player.png
│       ├── enemies/
│       │   ├── enemy1.png
│       │   └── enemy2.png
│       └── tiles/
│           ├── tile1.png
│           └── tile2.png
│
└── ASM/
    └── sprites.asm        # Generado automáticamente

Uso

# 1. Coloca tus PNG en la carpeta assets/sprites/
# 2. Configura SPRITES_PATH en devcpc.conf
SPRITES_PATH="assets/sprites"
# 3. Compila normalmente
devcpc build

La conversión se ejecuta automáticamente antes de compilar el ASM.

Formato del ASM Generado

; MODE 0

PLAYER
;------ BEGIN IMAGE --------
  db 2 ; ancho en bytes
  db 16 ; alto
  db 0, 0
  db 0, 0
  db 85, 85
  ; ... más bytes
;------ END IMAGE --------
  ; Paleta (PEN -> INK) detectada en el PNG
  ; INK 0,0
  ; INK 1,24
  ; INK 2,6

ENEMY1
;------ BEGIN IMAGE --------
  db 2 ; ancho en bytes
  db 16 ; alto
  ; ... bytes
;------ END IMAGE --------
  ; INK 0,0
  ; INK 1,2

Requisitos de los PNG

  1. Ancho: Debe ser múltiplo de:
    • Modo 0: múltiplo de 2 píxeles
    • Modo 1: múltiplo de 4 píxeles
    • Modo 2: múltiplo de 8 píxeles
  2. Colores: Máximo:
    • Modo 0: 16 colores
    • Modo 1: 4 colores
    • Modo 2: 2 colores
  3. Paleta: Usa colores de la paleta CPC (o cercanos con tolerancia)

Tolerancia RGB

La tolerancia define cuánto puede diferir un color del PNG de la paleta CPC:

# Exacto (solo colores CPC exactos)
SPRITES_TOLERANCE=0

# Recomendado (permite pequeñas variaciones)
SPRITES_TOLERANCE=8

# Automático (siempre encuentra el color más cercano)
SPRITES_TOLERANCE=-1

Transparencia

Puedes definir un INK para píxeles transparentes (alpha=0):

# Píxeles transparentes = INK 0 (negro)
SPRITES_TRANSPARENT_INK=0

Ejemplo Completo

# 1. Crear proyecto
devcpc new mi-juego
cd mi-juego

# 2. Copiar tus PNG a la carpeta de sprites
cp /ruta/a/sprites/*.png assets/sprites/

# 3. Configurar devcpc.conf
SPRITES_PATH="assets/sprites"
MODE=0
SPRITES_OUT_FILE="ASM/sprites.asm"
SPRITES_TOLERANCE=8

# 4. Compilar
devcpc build

Salida:

═══════════════════════════════════════
  Convertir Sprites PNG a ASM
═══════════════════════════════════════

ℹ Ruta sprites:    assets/sprites
ℹ Modo CPC:        0
ℹ Archivo salida:  ASM/sprites.asm
ℹ Tolerancia RGB:  8

ℹ Ejecutando png2asm.py...

OK: ASM/sprites.asm
PNGs encontrados: 3  | Convertidos OK: 3  | Errores: 0

Resumen:
PNG           Label      Size(px)  Bytes/line  Colors  Fallback  Status
player.png    player     16x16     2           4       no        OK
enemy1.png    enemy1     16x16     2           3       no        OK
tile1.png     tile1      8x8       1           2       no        OK

✓ Sprites convertidos exitosamente

Usar los Sprites en tu Código

; En tu make_all_mygame.asm
include "sprites.asm"

; Usar los sprites
ld hl, PLAYER
call |PSPRITE

ld hl, ENEMY1
call |PSPRITE

Solución de Problemas

Error: “Pillow no instalado”

pip3 install Pillow

Error: “ancho no divisible”

Error: “usa X INKs pero MODE permite Y”

Error: “Color no coincide con paleta CPC”

�️ Conversión de Pantallas de Carga PNG a SCN

DevCPC incluye conversión automática de pantallas de carga PNG a formato SCN (formato nativo del Amstrad CPC) que se añaden directamente al DSK.

¿Qué son las pantallas SCN?

Los archivos SCN son pantallas completas (160x200, 320x200 o 640x200) en formato binario del Amstrad CPC. Se cargan directamente en la memoria de vídeo (&C000) y son ideales para:

Configuración

# En devcpc.conf

# Ruta donde están los PNG de pantallas de carga (búsqueda recursiva)
LOADER_SCREEN="assets/screen"

# Modo CPC (0=16 colores, 1=4 colores, 2=2 colores)
MODE=0

Estructura de Carpetas

mi-juego/
├── assets/
│   └── screen/            # Pantallas PNG originales
│       ├── title.png      # 160x200 px (Modo 0)
│       ├── loading.png
│       └── credits.png
│
├── obj/                   # Generado automáticamente
│   ├── title.scn          # Archivo SCN
│   ├── title.scn.info     # Info de paleta
│   ├── loading.scn
│   └── loading.scn.info
│
└── dist/
    └── mi-juego.dsk       # DSK con las pantallas incluidas

Requisitos de los PNG

Resolución según modo:

Colores:

Uso

# 1. Crear carpeta y añadir tus PNG
mkdir -p assets/screen
cp /ruta/a/pantalla.png assets/screen/

# 2. Configurar devcpc.conf
LOADER_SCREEN="assets/screen"
MODE=0

# 3. Compilar
devcpc build

Salida de la Compilación

═══════════════════════════════════════
  Convertir Pantallas de Carga
═══════════════════════════════════════

ℹ Ruta:  assets/screen
ℹ Modo:  0 (160x200, 16 colores)

→ Convirtiendo title.png...
✓ title.scn generado (16384 bytes)

→ Convirtiendo loading.png...
✓ loading.scn generado (16384 bytes)

✓ 2 pantalla(s) convertida(s)

→ Añadiendo pantallas al DSK...

ℹ   title.scn
ℹ   loading.scn
✓ 2 pantalla(s) añadida(s) al DSK

Archivo .scn.info

Cada pantalla genera un archivo .info con información de la paleta:

FILE: title.scn
WIDTH: 160
HEIGHT: 200
MODE: 0
PALETTE COLORS: 8

FW              HW              RGB
0               0x14    (0, 0, 0)
24              0x0A    (255, 255, 0)
6               0x04    (255, 0, 0)
...

; ASM HW palette
db 0x14, 0x0A, 0x04, ...

' BASIC palette
INK 0,0: INK 1,24: INK 2,6: ...

// C palette
hwpal = { 0x14, 0x0A, 0x04, ... }

Esta información te ayuda a configurar la paleta correctamente cuando cargues la pantalla.

Usar Pantallas desde BASIC

10 REM Cargar pantalla de título
20 MODE 0
30 LOAD"TITLE.SCN",&C000
40 REM Configurar paleta (ver .info)
50 INK 0,0: INK 1,24: INK 2,6
60 PAUSE 100

Usar Pantallas desde ASM

; Cargar pantalla
ld hl, title_scn
ld de, &C000
ld bc, 16384
ldir

; Configurar paleta (HW)
ld bc, &7F00
ld a, 0
out (c), a
ld bc, &7F00+1
ld a, &14    ; INK 0 = Negro
out (c), a
; ... más INKs

title_scn:
incbin "title.scn"

Tamaño de Archivos SCN

Todos los modos usan el mismo tamaño porque ocupan toda la memoria de vídeo.

Ejemplo Completo

# 1. Crear proyecto
devcpc new mi-aventura
cd mi-aventura

# 2. Crear pantalla de título (160x200 px, 16 colores)
# Usa tu editor gráfico favorito (GIMP, Photoshop, etc.)
# Guarda en: assets/screen/title.png

# 3. Configurar devcpc.conf
LOADER_SCREEN="assets/screen"
MODE=0

# 4. Crear loader en BASIC
cat > bas/loader.bas << 'EOF'
10 MODE 0
20 LOAD"TITLE.SCN",&C000
30 INK 0,0: INK 1,24: INK 2,6
40 PAUSE 200
50 LOAD"8BP0.BIN"
60 CALL &6B78
EOF

# 5. Compilar
devcpc build

# 6. Ejecutar
devcpc run

Solución de Problemas

Error: “Pillow no instalado”

pip3 install Pillow

Error: “Resolución incorrecta”

Error: “Demasiados colores”

Las pantallas no se cargan correctamente

Diferencias: Pantallas vs Sprites

Característica Pantallas (SCN) Sprites (ASM)
Formato Binario (.scn) Código ASM (.asm)
Uso Pantallas completas Gráficos del juego
Tamaño 16 KB (fijo) Variable
Dirección carga &C000 (vídeo) Cualquiera
Incluido en DSK Binario compilado
Resolución Pantalla completa Libre (sprites)

�🔧 Compilación de Código C

Requisitos

  1. SDCC instalado 
    # macOS
brew install sdcc
   
# Linux
sudo apt-get install sdcc
   
# Verificar
sdcc --version
  2. Estructura de carpetas 
    C/
├── main.c
├── 8BP_wrapper/
│   └── 8BP.h
└── mini_BASIC/
    └── minibasic.h

Configuración

C_PATH="C"
C_SOURCE="main.c"
C_CODE_LOC=20000    # Dirección de carga (debe ser < 23999)

Límites de memoria

‼️ Importante: El código C no debe exceder la dirección 23999 (0x5DBF) para no destruir la librería 8BP.

Si excedes el límite:

# Usa una dirección más baja
C_CODE_LOC=19000

# Y en BASIC:
MEMORY 18999

Uso desde BASIC

10 REM Cargar 8BP con gráficos
20 MEMORY 23599
30 LOAD"8BP0.bin"
40 CALL &6B78
50 REM Cargar tu código C
60 LOAD"main.BIN",20000
70 CALL &56B0    ' Dirección de _main (ver .map)

🎮 Uso con RetroVirtualMachine

Configuración

# En devcpc.conf
RVM_PATH="/Applications/Retro Virtual Machine 2.app/Contents/MacOS/Retro Virtual Machine 2"
CPC_MODEL=464
RUN_FILE="8BP0.BIN"

Ejecutar

# Compilar y ejecutar
devcpc build && devcpc run

# Solo ejecutar (si ya compilaste)
devcpc run

Características

¿Qué es BUILD_LEVEL?

El BUILD_LEVEL determina qué funcionalidades de 8BP se incluyen:

Usa el nivel más alto posible para tener más memoria BASIC disponible.

¿Cómo sé qué BUILD_LEVEL usar?

Depende de los comandos 8BP que uses en tu juego:

¿Puedo cambiar BUILD_LEVEL después?

Sí, simplemente cambia el valor en devcpc.conf y recompila:

# Editar devcpc.conf
BUILD_LEVEL=2

# Recompilar
devcpc clean
devcpc build

¿Qué hace make_all_mygame.asm?

Es el archivo principal que incluye todos los demás archivos ASM de tu proyecto. DevCPC modifica automáticamente la variable ASSEMBLING_OPTION en este archivo según tu BUILD_LEVEL.

¿Puedo usar mi propio ensamblador?

No, DevCPC está diseñado específicamente para usar ABASM con la librería 8BP. ABASM está incluido y no necesitas instalarlo.

¿Funciona en Windows?

Sí, pero necesitas WSL (Windows Subsystem for Linux) o Git Bash. El sistema está diseñado para entornos Unix (bash).

¿Cómo actualizo DevCPC?

cd DevCPC
git pull origin main
./setup.sh

¿Dónde está la documentación de 8BP?

La documentación completa de 8BP está en el repositorio oficial de 8BP.

📖 Ejemplos Completos

Ejemplo 1: Proyecto solo ASM

# Crear proyecto
devcpc new juego-asm
cd juego-asm

# Configurar (devcpc.conf)
PROJECT_NAME="juego-asm"
BUILD_LEVEL=0
ASM_PATH="ASM"

# Copiar código
cp /ruta/a/make_all_mygame.asm ASM/

# Compilar
devcpc build

Ejemplo 2: Proyecto ASM + BASIC

# Crear proyecto
devcpc new juego-completo
cd juego-completo

# Configurar
PROJECT_NAME="juego-completo"
BUILD_LEVEL=0
ASM_PATH="ASM"
BASIC_PATH="bas"

# Copiar archivos
cp /ruta/a/*.asm ASM/
cp /ruta/a/*.bas bas/

# Compilar
devcpc build

Ejemplo 3: Proyecto con C

# Crear proyecto
devcpc new juego-c
cd juego-c

# Configurar
PROJECT_NAME="juego-c"
BUILD_LEVEL=0
ASM_PATH="ASM"
C_PATH="C"
C_SOURCE="main.c"
C_CODE_LOC=20000

# Copiar archivos
cp /ruta/a/*.asm ASM/
cp /ruta/a/main.c C/
cp -r /ruta/a/8BP_wrapper C/
cp -r /ruta/a/mini_BASIC C/

# Compilar
devcpc build

📄 Licencia

MIT License - Copyright (c) 2026 Destroyer

🙏 Agradecimientos

📚 Recursos Adicionales

Documentación de 8BP

🐞 Bugs

Si encuentras un Bug o deseas plantear alguna mejora ¡Compártelo!

📞 Contacto

© Destroyer 2026 - destroyer.dcf@gmail.com

← Index
© 2026 Destroyer </> Powered by Jekyll and The Plain theme.